Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions docs/canonical-api.md
Original file line number Diff line number Diff line change
@@ -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.
>
Expand Down Expand Up @@ -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 `<TScenario, TArtifact>`. (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.
**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 `<TScenario, TArtifact>`. (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.
16 changes: 8 additions & 8 deletions package.json
Original file line number Diff line number Diff line change
@@ -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": {
Expand Down Expand Up @@ -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",
Expand All @@ -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": {
Expand Down
20 changes: 10 additions & 10 deletions pnpm-lock.yaml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading