diff --git a/docs/canonical-api.md b/docs/canonical-api.md index 873ae89..5b90082 100644 --- a/docs/canonical-api.md +++ b/docs/canonical-api.md @@ -1,6 +1,6 @@ # `@tangle-network/agent-runtime` — Canonical API Reference -> **Version 0.65.0.** Every signature below was read from source and is cited `file:line`. `@experimental` is flagged per-entry. When a citation is to `node_modules/@tangle-network/agent-eval/...`, the symbol lives in the **substrate** and is consumed here — import it from `@tangle-network/agent-eval/contract` (or `/campaign`), not from this package. (The pinned substrate is agent-eval `>=0.93.0 <1.0.0`.) The neutral contract types (`AgentProfile`, `AgentProfileMcpServer`, `HarnessType`, `ReasoningEffort`, `Part`/`ToolPart`/`ToolState`) are owned by **`@tangle-network/agent-interface`** (peer `>=0.5.0 <1.0.0`, currently ~0.9.0) — the single source of truth, which also ships the capability layer (`harnessSupportsModel` / `reasoningEffortsFor` / `reasoningLadder`). The `/runtime` barrel re-exports `AgentProfile` for back-compat. +> **Version 0.66.0.** Every signature below was read from source and is cited `file:line`. `@experimental` is flagged per-entry. When a citation is to `node_modules/@tangle-network/agent-eval/...`, the symbol lives in the **substrate** and is consumed here — import it from `@tangle-network/agent-eval/contract` (or `/campaign`), not from this package. (The pinned substrate is agent-eval `>=0.93.0 <1.0.0`.) The neutral contract types (`AgentProfile`, `AgentProfileMcpServer`, `HarnessType`, `ReasoningEffort`, `Part`/`ToolPart`/`ToolState`) are owned by **`@tangle-network/agent-interface`** (peer `>=0.5.0 <1.0.0`, currently ~0.10.0) — the single source of truth, which also ships the capability layer (`harnessSupportsModel` / `reasoningEffortsFor` / `reasoningLadder`). The `/runtime` barrel re-exports `AgentProfile` for back-compat. > > **`./loops` and `./runtime` are the SAME barrel** — `package.json` maps both subpaths to `src/runtime/index.ts` (`./loops` is the back-compat alias). Anything below shown as `/loops` is equally importable from `/runtime`, and vice-versa. > @@ -975,4 +975,4 @@ Both implement the same "recursive agent decision" atom; both run over the one ` --- -**Accuracy note for the next agent:** every signature, export subpath, and `file:line` above was opened and confirmed against source at version 0.65.0 (agent-eval substrate `>=0.93.0`). Corrections folded in versus the prior draft: (1) the `runAgentic` **result** type `AgenticRunResult` is at `strategy.ts:509`, not `:969` (`:969` is `RunAgenticOptions`); the function is at `:985`. (2) `benjaminiHochberg` is a **substrate** (`@tangle-network/agent-eval`) export consumed in `bench/src/corpus-report.mts:40` — NOT a `bench/src/stats.mts` symbol. (3) `StrategyCtx` exposes `consult` (`strategy.ts:736`) + `listTools` (`:740`), never `rawCritique`. (4) `SelfImproveResult`/`selfImprove` are generic ``. (5) `./loops` and `./runtime` are the SAME barrel (`src/runtime/index.ts`) — `./loops` is the back-compat alias (`tsup.config.ts:11`). (6) The `ADAPTERS` key list is the real registry (`bench/src/adapters.ts:27`; `cad-design`/`cadbench`/`cadgenbench` are three distinct CAD keys, no fourth). (7) `selfImprove`/`runImprovementLoop`/`gepaDriver`/`defaultProductionGate`/`heldOutGate`/`composeGate`/`paretoSignificanceGate` are agent-eval substrate symbols re-exported through `@tangle-network/agent-eval/contract` (and `/campaign`), not local to this package. If a signature here ever disagrees with the source, the **code wins** — fix this doc in the same turn. \ No newline at end of file +**Accuracy note for the next agent:** every signature, export subpath, and `file:line` above was opened and confirmed against source at version 0.66.0 (agent-eval substrate `>=0.93.0`). Corrections folded in versus the prior draft: (1) the `runAgentic` **result** type `AgenticRunResult` is at `strategy.ts:509`, not `:969` (`:969` is `RunAgenticOptions`); the function is at `:985`. (2) `benjaminiHochberg` is a **substrate** (`@tangle-network/agent-eval`) export consumed in `bench/src/corpus-report.mts:40` — NOT a `bench/src/stats.mts` symbol. (3) `StrategyCtx` exposes `consult` (`strategy.ts:736`) + `listTools` (`:740`), never `rawCritique`. (4) `SelfImproveResult`/`selfImprove` are generic ``. (5) `./loops` and `./runtime` are the SAME barrel (`src/runtime/index.ts`) — `./loops` is the back-compat alias (`tsup.config.ts:11`). (6) The `ADAPTERS` key list is the real registry (`bench/src/adapters.ts:27`; `cad-design`/`cadbench`/`cadgenbench` are three distinct CAD keys, no fourth). (7) `selfImprove`/`runImprovementLoop`/`gepaDriver`/`defaultProductionGate`/`heldOutGate`/`composeGate`/`paretoSignificanceGate` are agent-eval substrate symbols re-exported through `@tangle-network/agent-eval/contract` (and `/campaign`), not local to this package. If a signature here ever disagrees with the source, the **code wins** — fix this doc in the same turn. \ No newline at end of file diff --git a/package.json b/package.json index a349020..fbce863 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@tangle-network/agent-runtime", - "version": "0.65.0", + "version": "0.66.0", "description": "Shared task-lifecycle skeleton for agents: a recursive loop kernel for chat turns, one-shot tasks, and multi-attempt loops, with trace capture and eval-gated self-improvement. Domain behavior lives in adapters; scoring and ship-gates in @tangle-network/agent-eval.", "homepage": "https://github.com/tangle-network/agent-runtime#readme", "repository": { @@ -106,9 +106,9 @@ }, "devDependencies": { "@biomejs/biome": "^2.4.15", - "@tangle-network/agent-eval": "^0.93.0", - "@tangle-network/agent-interface": "^0.9.0", - "@tangle-network/sandbox": "^0.8.0", + "@tangle-network/agent-eval": ">=0.93.0 <1.0.0", + "@tangle-network/agent-interface": ">=0.10.0 <1.0.0", + "@tangle-network/sandbox": ">=0.8.0 <1.0.0", "@types/node": "^25.9.3", "playwright": "^1.61.0", "tsup": "^8.0.0", @@ -132,10 +132,10 @@ "license": "MIT", "packageManager": "pnpm@10.28.0", "peerDependencies": { - "@tangle-network/agent-eval": "^0.93.0", - "@tangle-network/agent-interface": "^0.9.0", - "@tangle-network/agent-knowledge": "^1.7.0", - "@tangle-network/sandbox": "^0.8.0", + "@tangle-network/agent-eval": ">=0.93.0 <1.0.0", + "@tangle-network/agent-interface": ">=0.10.0 <1.0.0", + "@tangle-network/agent-knowledge": ">=1.7.0 <2.0.0", + "@tangle-network/sandbox": ">=0.8.0 <1.0.0", "playwright": "^1.40.0" }, "peerDependenciesMeta": { diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 6145cfc..be17e59 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -9,20 +9,20 @@ importers: .: dependencies: '@tangle-network/agent-knowledge': - specifier: ^1.7.0 + specifier: '>=1.7.0 <2.0.0' version: 1.7.0(@tangle-network/sandbox@0.8.2(viem@2.52.2(typescript@5.9.3)(zod@4.4.3)))(typescript@5.9.3) devDependencies: '@biomejs/biome': specifier: ^2.4.15 version: 2.4.15 '@tangle-network/agent-eval': - specifier: ^0.93.0 + specifier: '>=0.93.0 <1.0.0' version: 0.93.0(@tangle-network/sandbox@0.8.2(viem@2.52.2(typescript@5.9.3)(zod@4.4.3)))(typescript@5.9.3) '@tangle-network/agent-interface': - specifier: ^0.9.0 - version: 0.9.0 + specifier: '>=0.10.0 <1.0.0' + version: 0.10.0 '@tangle-network/sandbox': - specifier: ^0.8.0 + specifier: '>=0.8.0 <1.0.0' version: 0.8.2(viem@2.52.2(typescript@5.9.3)(zod@4.4.3)) '@types/node': specifier: ^25.9.3 @@ -479,12 +479,12 @@ packages: engines: {node: '>=20'} hasBin: true + '@tangle-network/agent-interface@0.10.0': + resolution: {integrity: sha512-oiREgihkeX/xcGEtFfi9AkAfU2VzuF7SSla2s0iliXPUXyHCIIx6jwzHiYdwb1ZGCfvC+T+0SWOIa6fN5u195g==} + '@tangle-network/agent-interface@0.8.0': resolution: {integrity: sha512-okz9LGKwPNKODNyT9Y7+T+sQsJ4g6oTy/hpWpxR6r2BI7pS6WqIdgCOQcx98+WtlPoibkY3ewRRAb8YJMrPHog==} - '@tangle-network/agent-interface@0.9.0': - resolution: {integrity: sha512-iwq8QsJh+EiunLQj5iyEmVFa+v/o3LarOx8qrpqIGt8H4Ga1ecU1sHTExxrgvWDCjq+j6rtOVvEm8uh6RSFcRg==} - '@tangle-network/agent-knowledge@1.7.0': resolution: {integrity: sha512-F+a21T2UMW7HVj1Dt6Sv5GqjEQXWUshsVftRpStW1t0bVG0/1aT6DeHYKok1lLmi+D8WZnC0CNXPdb+LyxC/iA==} engines: {node: '>=20'} @@ -1339,11 +1339,11 @@ snapshots: '@tangle-network/agent-integrations@0.29.0': {} - '@tangle-network/agent-interface@0.8.0': + '@tangle-network/agent-interface@0.10.0': dependencies: zod: 4.4.3 - '@tangle-network/agent-interface@0.9.0': + '@tangle-network/agent-interface@0.8.0': dependencies: zod: 4.4.3