anchor-ai-sdk 0.1.4 → 0.1.6

package/README.md

@@ -9,7 +9,7 @@
 
 <p align="center">
   <strong>Loop-first, sandbox-first agent harness SDK.</strong><br />
-  Give it a task and a machine — it reasons, runs tools, checks its own work, and keeps the receipts.
+  Give it a task and a machine; it reasons, runs tools, checks its own work, and keeps the receipts.
 </p>
 
 <p align="center">
@@ -29,7 +29,7 @@ trust. Anchor ships the hard parts.
   `AgentResult.evidence`; `run_tests` stamps the tree hash it ran against and
   `latestEvidenceForTree` ties a green run to the *exact* bytes (fail-closed
   when the tree can't be inspected). The engine carries evidence and never
-  reads success out of a confident sentence — what to gate on it is your
+  reads success out of a confident sentence; what to gate on it is your
   policy, not a hidden wall.
 - **Durable by construction.** Conversation, workspace, and the agent's own
   notes survive folds, restarts, and budget deaths; the SDK ships the
@@ -43,16 +43,16 @@ trust. Anchor ships the hard parts.
 
 | | |
 | --- | --- |
-| **Agent loop with dials** | Budgets (steps / tokens / USD), repeated-call detection, silent-tool advisories — guardrails on by default, each with an off switch. Phases describe the approach — never a second gated execution engine. |
+| **Agent loop with dials** | Budgets (steps / tokens / USD), repeated-call detection, silent-tool and verbose-turn advisories, a per-call output cap (16k, nudge at 8k; a capped prose turn continues once instead of ending), and assistant-text elision (20k replay, 12k head-only when capped, spilled and pointed at); guardrails on by default, each with an off switch. Phases describe the approach, never a second gated execution engine. |
 | **Streaming by default** | One wire path: every model call streams. Text and reasoning deltas, tool calls, compaction, checkpoints, and finishes all arrive as typed events. |
 | **Durable memory** | `ThreadStore` carries conversation across runs; compaction is derived from the model's *real* context window; reasoning is journaled but never re-sent. |
 | **Notes & spill storage** | A reserved `.anchor/notes.md` (git-excluded, checkpoint-carried) is the agent's durable memory across folds; oversized tool output spills to sandbox files and stays addressable instead of vanishing. |
-| **Revival** | A dying run leaves a handoff (`request_revival`); `planRevival` + `ThreadBudget` decide how to fund the next run — **same task, phase, and budget** — and when the thread's caps are spent, a human gets the note, quoting the agent's own words on what remains. |
+| **Revival** | A dying run leaves a handoff (`request_revival`); `planRevival` + `ThreadBudget` decide how to fund the next run; **same task, phase, and budget**, and when the thread's caps are spent, a human gets the note, quoting the agent's own words on what remains. |
 | **Snapshots & resume** | A pluggable snapshot hook (git-backed by default, push optional), phase-boundary pauses, heartbeats and cross-process cancel polling owned by the engine. |
-| **Traces you can replay** | One fanout: one sequence number, redaction applied before *every* sink — NDJSON file, database rows, and a live projector share the same ordering. |
-| **Sandbox plugins** | One `SandboxProvider` contract: Heyo microVMs, Docker, local. Capabilities are promises — the conformance suite holds adapters to them. Store-backed sessions give adopt-and-fallback continuity for free. |
+| **Traces you can replay** | One fanout: one sequence number, redaction applied before *every* sink; NDJSON file, database rows, and a live projector share the same ordering. |
+| **Sandbox plugins** | One `SandboxProvider` contract: Heyo microVMs, Docker, local. Capabilities are promises; the conformance suite holds adapters to them. Store-backed sessions give adopt-and-fallback continuity for free. |
 | **Typed handoffs** | `finish({ handoff })` is shaped by *your* JSON schema; the engine declares the parameter, carries the object, and never interprets it. |
-| **Priced & windowed models** | `llmFromCatalog` reads live prices and the genuine context window from the provider catalog — budgets and compaction configure themselves correctly. |
+| **Priced & windowed models** | `llmFromCatalog` reads live prices and the genuine context window from the provider catalog; budgets and compaction configure themselves correctly. |
 
 ## Ten lines to a working agent
 
@@ -98,7 +98,7 @@ try {
 }
 ```
 
-Runnable versions of both snippets live in [`examples/`](https://github.com/hrithikkoduri/anchor-ai-sdk/tree/main/examples) — including
+Runnable versions of both snippets live in [`examples/`](https://github.com/hrithikkoduri/anchor-ai-sdk/tree/main/examples), including
 a non-coding agent (its own strategy and tool, no sandbox).
 
 ## Providers
@@ -107,31 +107,37 @@ a non-coding agent (its own strategy and tool, no sandbox).
 | --- | --- | --- |
 | `anchor-ai-sdk/sandbox/heyo` | Heyo Cloud microVMs (Firecracker) | production path; conformance + live tests |
 | `anchor-ai-sdk/sandbox/docker` | containers on the local daemon | conformance-tested in CI |
+| `anchor-ai-sdk/sandbox/e2b` | E2B cloud sandboxes (remote) | conformance-tested live (`base` template); opt-in in CI |
 | `anchor-ai-sdk/sandbox/local` | this host, **no isolation** | dev / CI only |
-| — | E2B, Daytona | planned |
+| n/a | Daytona | planned |
+
+E2B boots a **template**, not an arbitrary Docker image at create time: pass
+`template` (or let `SandboxSpec.image` name one) and build it with the tools
+the task needs. Pause/resume powers retain/adopt, and native sandbox forking
+powers `fork()`.
 
 A backend is "done" when `runSandboxConformance(provider)` from
-`anchor-ai-sdk/testing` passes — exec fidelity, kill deadlines, env secrets,
+`anchor-ai-sdk/testing` passes: exec fidelity, kill deadlines, env secrets,
 checkpoints, retain/adopt, git identity, pushes, and `fork` where declared.
 See [`src/sandbox/README.md`](https://github.com/hrithikkoduri/anchor-ai-sdk/blob/main/src/sandbox/README.md) for the provider guide.
 
 ## Proof, not promises
 
 - **Tests:** the engine, tools, trace layer, and every provider scenario run
-  in CI — local conformance always, Docker conformance on a purpose-built
+  in CI: local conformance always, Docker conformance on a purpose-built
   image. Live microVM conformance is opt-in with your own Heyo credentials
   (the suite skips without them).
-- **Genericity guards:** executable rules keep the package consumer-neutral —
+- **Genericity guards:** executable rules keep the package consumer-neutral:
   no product nouns, no env reads, SDKs behind subpaths. They run in the same
   suite as everything else.
-- **Evaluation:** Anchor vs mini-swe-agent on SWE-bench Lite — same
-  container, same model, same official grader — resolved the same 7/10 at
+- **Evaluation:** Anchor vs mini-swe-agent on SWE-bench Lite (same
+  container, same model, same official grader), resolved the same 7/10 at
   roughly **one-third of the cost**
   ([`evals/benchmarks/swe-bench/results/comparison.md`](https://github.com/hrithikkoduri/anchor-ai-sdk/blob/main/evals/benchmarks/swe-bench/results/comparison.md)).
 
 ## Status
 
-**Early alpha (0.x).** The API will move before 1.0 — pin exact versions. The
+**Early alpha (0.x).** The API will move before 1.0, so pin exact versions. The
 [`DECISIONS.md`](https://github.com/hrithikkoduri/anchor-ai-sdk/blob/main/DECISIONS.md) is the engineering log: every API has a written
 reason, and the reasons moved with the code when this repo was extracted from
 its monorepo.

package/dist/agents/coding/index.d.ts

@@ -8,9 +8,14 @@ export { codingPhases } from "./phases.js";
  * The coding agent — strategy + toolbox. Pass `testCommand` when the repo's
  * canonical suite is known (CLI or repo config); otherwise run_tests detects
  * one; either way run_tests tags the run as the repo's full-suite evidence.
+ *
+ * `maxOutputTokens` overrides the engine's per-call cap for this bundle (see
+ * #75). Left unset, the engine default governs; an explicit
+ * `EngineOptions.maxOutputTokens` still wins.
  */
 export declare function createCodingAgent(opts?: {
     testCommand?: string;
+    maxOutputTokens?: number | false;
 }): Agent;
 /** The zero-config coding agent — detection instead of a configured suite. */
 export declare const codingAgent: Agent;

package/dist/agents/coding/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/coding/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,KAAK,CAM5E;AAED,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,KAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/coding/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAAO,GACpE,KAAK,CASP;AAED,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,KAA2B,CAAC"}

package/dist/agents/coding/index.js

@@ -8,12 +8,19 @@ export { codingPhases } from "./phases.js";
  * The coding agent — strategy + toolbox. Pass `testCommand` when the repo's
  * canonical suite is known (CLI or repo config); otherwise run_tests detects
  * one; either way run_tests tags the run as the repo's full-suite evidence.
+ *
+ * `maxOutputTokens` overrides the engine's per-call cap for this bundle (see
+ * #75). Left unset, the engine default governs; an explicit
+ * `EngineOptions.maxOutputTokens` still wins.
  */
 export function createCodingAgent(opts = {}) {
     return {
         name: "coding",
         strategy: codingStrategy,
         tools: createCodingTools(opts),
+        ...(opts.maxOutputTokens !== undefined
+            ? { maxOutputTokens: opts.maxOutputTokens }
+            : {}),
     };
 }
 /** The zero-config coding agent — detection instead of a configured suite. */

package/dist/agents/coding/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/coding/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAI,GAA6B,EAAE;IACnE,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAU,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/coding/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAe,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAI,GAA+D,EAAE;IAErE,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;YAC3C,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAU,iBAAiB,EAAE,CAAC"}

package/dist/agents/coding/prompts/index.js

@@ -28,7 +28,7 @@ export function buildCodingPrompt(options = {}) {
         {
             title: "Approach phases",
             body: [
-                "These describe your approach, not prerequisites. Choose the phases that fit, skip or revisit them when appropriate, and conclude from any phase. When your work shifts between kinds of activity — investigating, changing code, verifying, answering — call set_phase once to record the new phase; it labels your approach (it never authorizes or blocks anything) and keeps the thread's timeline honest.",
+                "These describe your approach, not prerequisites. Choose the phases that fit, skip or revisit them when appropriate, and conclude from any phase. When your work shifts between kinds of activity — investigating, changing code, verifying, answering — call set_phase to record the new phase and keep the thread's timeline honest.",
                 ...phases.map((phase) => `- ${phase.id}: ${phase.goal}${phase.guidance ? ` ${phase.guidance}` : ""}`),
             ].join("\n"),
         },

package/dist/agents/coding/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/coding/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AActD;+EAC+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAwB,EAAE;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC;IAC9C,OAAO;QACL,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS,EAAE;QAC5D,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE;QAC7C,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ,EAAE;QACzD;YACE,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,OAAO,CAAC,cAAc,IAAI,cAAc;SAC/C;QACD;YACE,KAAK,EAAE,yBAAyB;YAChC,IAAI,EAAE,OAAO,CAAC,YAAY,IAAI,YAAY;SAC3C;QACD;YACE,KAAK,EAAE,eAAe;YACtB,IAAI,EACF,0FAA0F;gBAC1F,sFAAsF;gBACtF,sEAAsE;gBACtE,2FAA2F;SAC9F;QACD;YACE,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE;gBACJ,+YAA+Y;gBAC/Y,GAAG,MAAM,CAAC,GAAG,CACX,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9E;aACF,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;QACD,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC;QACrC;YACE,KAAK,EAAE,2CAA2C;YAClD,IAAI,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SAC5B;QACD;YACE,KAAK,EAAE,sDAAsD;YAC7D,IAAI,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SAC5B;KACF;SACE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;SACvD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/coding/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AActD;+EAC+E;AAC/E,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAAwB,EAAE;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC;IAC9C,OAAO;QACL,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS,EAAE;QAC5D,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE;QAC7C,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ,EAAE;QACzD;YACE,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,OAAO,CAAC,cAAc,IAAI,cAAc;SAC/C;QACD;YACE,KAAK,EAAE,yBAAyB;YAChC,IAAI,EAAE,OAAO,CAAC,YAAY,IAAI,YAAY;SAC3C;QACD;YACE,KAAK,EAAE,eAAe;YACtB,IAAI,EACF,0FAA0F;gBAC1F,sFAAsF;gBACtF,sEAAsE;gBACtE,2FAA2F;SAC9F;QACD;YACE,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE;gBACJ,uUAAuU;gBACvU,GAAG,MAAM,CAAC,GAAG,CACX,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9E;aACF,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;QACD,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC;QACrC;YACE,KAAK,EAAE,2CAA2C;YAClD,IAAI,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SAC5B;QACD;YACE,KAAK,EAAE,sDAAsD;YAC7D,IAAI,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;SAC5B;KACF;SACE,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SACxC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;SACvD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/agents/types.d.ts

@@ -19,5 +19,10 @@ export interface Agent {
     strategy: AgentStrategy;
     /** Capabilities the run may call — a curated subset of the tool registry. */
     tools: Tool[];
+    /**
+     * Per-call output cap this bundle suggests (see `EngineOptions.maxOutputTokens`).
+     * An explicit engine option wins; absent, the engine default applies.
+     */
+    maxOutputTokens?: number | false;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/agents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,WAAW,KAAK;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,QAAQ,EAAE,aAAa,CAAC;IACxB,6EAA6E;IAC7E,KAAK,EAAE,IAAI,EAAE,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,WAAW,KAAK;IACpB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,QAAQ,EAAE,aAAa,CAAC;IACxB,6EAA6E;IAC7E,KAAK,EAAE,IAAI,EAAE,CAAC;IACd;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAClC"}

package/dist/engine/budgets.d.ts

@@ -13,6 +13,16 @@ export interface BudgetLimits {
     maxUsd: number;
 }
 export declare const DEFAULT_BUDGET_LIMITS: BudgetLimits;
+/**
+ * Per-call cap on one model response — reasoning, text and tool calls
+ * together. The per-run budgets below only notice an overspend *after* the
+ * call returns, so a single degenerate generation can burn minutes and tens
+ * of thousands of tokens before anything reacts. This bounds one call.
+ *
+ * 16k leaves ample room for normal work (typical turns here run ~1k) while
+ * cutting off a runaway. A capped response ends with finishReason "length".
+ */
+export declare const DEFAULT_MAX_OUTPUT_TOKENS = 16000;
 export interface BudgetExceeded {
     kind: "steps" | "tokens" | "usd";
     detail: string;

package/dist/engine/budgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/engine/budgets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,YAAY,SAAK;IACjB,gBAAgB,SAAK;IACrB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,SAAK;IACZ,UAAU,UAAQ;IAElB,YAAY,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,EAE7C;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAS5B;IAED,WAAW,IAAI,MAAM,CAEpB;IAED,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAc7C;CACF"}
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/engine/budgets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,YAAY,SAAK;IACjB,gBAAgB,SAAK;IACrB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,OAAO,SAAK;IACZ,UAAU,UAAQ;IAElB,YAAY,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,EAE7C;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAS5B;IAED,WAAW,IAAI,MAAM,CAEpB;IAED,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAc7C;CACF"}

package/dist/engine/budgets.js

@@ -1,8 +1,18 @@
 export const DEFAULT_BUDGET_LIMITS = {
     maxSteps: 40,
-    maxTokens: 1_500_000,
+    maxTokens: 3_000_000,
     maxUsd: 5,
 };
+/**
+ * Per-call cap on one model response — reasoning, text and tool calls
+ * together. The per-run budgets below only notice an overspend *after* the
+ * call returns, so a single degenerate generation can burn minutes and tens
+ * of thousands of tokens before anything reacts. This bounds one call.
+ *
+ * 16k leaves ample room for normal work (typical turns here run ~1k) while
+ * cutting off a runaway. A capped response ends with finishReason "length".
+ */
+export const DEFAULT_MAX_OUTPUT_TOKENS = 16_000;
 export class BudgetTracker {
     limits;
     promptTokens = 0;

package/dist/engine/budgets.js.map

@@ -1 +1 @@
-{"version":3,"file":"budgets.js","sourceRoot":"","sources":["../../src/engine/budgets.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,CAAC;CACV,CAAC;AAOF,MAAM,OAAO,aAAa;IACf,MAAM,CAAe;IAC9B,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,CAAC,CAAC;IACrB,eAAe,CAAqB;IACpC,OAAO,GAAG,CAAC,CAAC;IACZ,UAAU,GAAG,IAAI,CAAC;IAElB,YAAY,MAAM,GAA0B,EAAE;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,qBAAqB,EAAE,GAAG,MAAM,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,KAAe;QACpB,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,CAAC;QAChD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;YAAE,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;QACpH,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED,6EAA6E;IAC7E,QAAQ,CAAC,KAAa;QACpB,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,0BAA0B,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,SAAS,EAAE,CAAC;QACrG,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,2BAA2B,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,UAAU;aACzF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC;QACjH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"budgets.js","sourceRoot":"","sources":["../../src/engine/budgets.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,CAAC;CACV,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAOhD,MAAM,OAAO,aAAa;IACf,MAAM,CAAe;IAC9B,YAAY,GAAG,CAAC,CAAC;IACjB,gBAAgB,GAAG,CAAC,CAAC;IACrB,eAAe,CAAqB;IACpC,OAAO,GAAG,CAAC,CAAC;IACZ,UAAU,GAAG,IAAI,CAAC;IAElB,YAAY,MAAM,GAA0B,EAAE;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,qBAAqB,EAAE,GAAG,MAAM,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,KAAe;QACpB,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC,gBAAgB,CAAC;QAChD,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;YAAE,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;QACpH,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACnD,CAAC;IAED,6EAA6E;IAC7E,QAAQ,CAAC,KAAa;QACpB,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,0BAA0B,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,SAAS,EAAE,CAAC;QACrG,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,2BAA2B,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,UAAU;aACzF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC;QACjH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/engine/elision.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Assistant-text elision — the history boundary for the model's own words.
+ *
+ * Tool output has had a boundary since the spill work: `truncate.ts` keeps a
+ * head and a tail, and saves the full text so the clipped middle stays
+ * addressable. The assistant's own replies had none, so one runaway turn
+ * (108,578 chars in the GLM run behind #75) was replayed verbatim on every
+ * later call: the model re-reading its own essay, and paying for it each
+ * time. At ~27k tokens a replay across ~29 remaining calls, that single turn
+ * supplied roughly half the run's billed tokens.
+ *
+ * Same shape here, with three differences:
+ *
+ *   1. It bounds the MODEL'S VIEW, not the stored transcript. The loop keeps
+ *      `messages` intact (persistence, replay, audit) and sends this
+ *      projection to the provider.
+ *   2. A capped turn (finishReason "length") keeps only its head. Its tail is
+ *      mid-token by construction, so the intent at the start is the only
+ *      signal worth replaying.
+ *   3. The full reply is spilled to scratch and pointed at, so the omission is
+ *      recoverable rather than final (#77).
+ */
+import { type Sandbox } from "../sandbox/types.js";
+/** Replay budget for one assistant reply, in chars (≈ 5k tokens at 4 chars/token). */
+export declare const DEFAULT_MAX_ASSISTANT_CHARS = 20000;
+/**
+ * A capped turn is incomplete: its tail stops mid-token, so only its head is
+ * worth replaying. This is the dial for that tighter budget — deliberately
+ * below `DEFAULT_MAX_ASSISTANT_CHARS`. 12k CHARS, not tokens: about 3k tokens,
+ * a fraction of a capped turn, so a chopped essay is not replayed in full.
+ */
+export declare const DEFAULT_TRUNCATED_REPLY_CHARS = 12000;
+export interface ElidedReply {
+    text: string;
+    omittedChars: number;
+}
+export interface ElideOptions {
+    /** Keep a tail. False for a capped turn, whose tail is mid-token. */
+    tail?: boolean;
+    /** Appended to the marker — e.g. where the full reply was spilled. */
+    note?: string;
+}
+/**
+ * Head + marker + tail, sized to `budget`. Under budget → the text unchanged.
+ * The split mirrors tool output (60/40): openings carry intent, endings carry
+ * the conclusion, and the middle of a ramble is repetition.
+ */
+export declare function elideReply(text: string, budget: number, opts?: ElideOptions): ElidedReply;
+/**
+ * Best-effort: save the full reply to the sandbox's scratch dir and return its
+ * path, so an elided middle can be read back. Any failure returns undefined
+ * and leaves the caller with plain elision — never breaks the turn.
+ */
+export declare function spillReply(sandbox: Sandbox | undefined, text: string): Promise<string | undefined>;
+//# sourceMappingURL=elision.d.ts.map

package/dist/engine/elision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elision.d.ts","sourceRoot":"","sources":["../../src/engine/elision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAO,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAExD,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAKpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,YAAiB,GACtB,WAAW,CAgBb;AAID;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}

package/dist/engine/elision.js

@@ -0,0 +1,78 @@
+/**
+ * Assistant-text elision — the history boundary for the model's own words.
+ *
+ * Tool output has had a boundary since the spill work: `truncate.ts` keeps a
+ * head and a tail, and saves the full text so the clipped middle stays
+ * addressable. The assistant's own replies had none, so one runaway turn
+ * (108,578 chars in the GLM run behind #75) was replayed verbatim on every
+ * later call: the model re-reading its own essay, and paying for it each
+ * time. At ~27k tokens a replay across ~29 remaining calls, that single turn
+ * supplied roughly half the run's billed tokens.
+ *
+ * Same shape here, with three differences:
+ *
+ *   1. It bounds the MODEL'S VIEW, not the stored transcript. The loop keeps
+ *      `messages` intact (persistence, replay, audit) and sends this
+ *      projection to the provider.
+ *   2. A capped turn (finishReason "length") keeps only its head. Its tail is
+ *      mid-token by construction, so the intent at the start is the only
+ *      signal worth replaying.
+ *   3. The full reply is spilled to scratch and pointed at, so the omission is
+ *      recoverable rather than final (#77).
+ */
+import { shq } from "../sandbox/types.js";
+/** Replay budget for one assistant reply, in chars (≈ 5k tokens at 4 chars/token). */
+export const DEFAULT_MAX_ASSISTANT_CHARS = 20_000;
+/**
+ * A capped turn is incomplete: its tail stops mid-token, so only its head is
+ * worth replaying. This is the dial for that tighter budget — deliberately
+ * below `DEFAULT_MAX_ASSISTANT_CHARS`. 12k CHARS, not tokens: about 3k tokens,
+ * a fraction of a capped turn, so a chopped essay is not replayed in full.
+ */
+export const DEFAULT_TRUNCATED_REPLY_CHARS = 12_000;
+/** Absurd payloads are not worth a write; elide without a pointer. */
+const SPILL_MAX_CHARS = 4_000_000;
+/**
+ * Head + marker + tail, sized to `budget`. Under budget → the text unchanged.
+ * The split mirrors tool output (60/40): openings carry intent, endings carry
+ * the conclusion, and the middle of a ramble is repetition.
+ */
+export function elideReply(text, budget, opts = {}) {
+    if (text.length <= budget)
+        return { text, omittedChars: 0 };
+    const keepTail = opts.tail ?? true;
+    const headChars = keepTail ? Math.floor(budget * 0.6) : budget;
+    const tailChars = keepTail ? budget - headChars : 0;
+    const omittedChars = text.length - headChars - tailChars;
+    const marker = `\n[... ${omittedChars} chars of this reply were omitted from the replayed history` +
+        `${opts.note ? `; ${opts.note}` : ""} ...]\n`;
+    return {
+        text: text.slice(0, headChars) +
+            marker +
+            (tailChars > 0 ? text.slice(text.length - tailChars) : ""),
+        omittedChars,
+    };
+}
+let spillSeq = 0;
+/**
+ * Best-effort: save the full reply to the sandbox's scratch dir and return its
+ * path, so an elided middle can be read back. Any failure returns undefined
+ * and leaves the caller with plain elision — never breaks the turn.
+ */
+export async function spillReply(sandbox, text) {
+    if (!sandbox || text.length > SPILL_MAX_CHARS)
+        return undefined;
+    const file = `${sandbox.scratch}/out/reply-${Date.now().toString(36)}${(spillSeq++).toString(36)}.txt`;
+    const dir = file.slice(0, file.lastIndexOf("/"));
+    try {
+        const b64 = Buffer.from(text, "utf8").toString("base64");
+        const write = await sandbox.exec(`mkdir -p ${shq(dir)} && printf %s ${shq(b64)} | base64 -d > ${shq(file)}`, { timeoutSecs: 120 });
+        if (write.exitCode !== 0)
+            return undefined;
+    }
+    catch {
+        return undefined;
+    }
+    return file;
+}
+//# sourceMappingURL=elision.js.map

package/dist/engine/elision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elision.js","sourceRoot":"","sources":["../../src/engine/elision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,GAAG,EAAgB,MAAM,qBAAqB,CAAC;AAExD,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AAEpD,sEAAsE;AACtE,MAAM,eAAe,GAAG,SAAS,CAAC;AAclC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,MAAc,EACd,IAAI,GAAiB,EAAE;IAEvB,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IACnC,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACzD,MAAM,MAAM,GACV,UAAU,YAAY,6DAA6D;QACnF,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC;IAChD,OAAO;QACL,IAAI,EACF,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;YACxB,MAAM;YACN,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,YAAY;KACb,CAAC;AACJ,CAAC;AAED,IAAI,QAAQ,GAAG,CAAC,CAAC;AAEjB;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAA4B,EAC5B,IAAY;IAEZ,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,cAAc,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC;IACvG,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAC9B,YAAY,GAAG,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,GAAG,CAAC,kBAAkB,GAAG,CAAC,IAAI,CAAC,EAAE,EAC1E,EAAE,WAAW,EAAE,GAAG,EAAE,CACrB,CAAC;QACF,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/events.d.ts

@@ -46,6 +46,10 @@ export type AgentEvent = {
     toolCallsCount: number;
     usage: LLMUsage;
     latencyMs: number;
+    /** Model id the provider said it served, when the response carried one. */
+    model?: string;
+    /** Upstream name, when a gateway reported one. */
+    provider?: string;
 } | {
     type: "tool_call";
     phase: string;
@@ -85,7 +89,7 @@ export type AgentEvent = {
     /** Non-blocking runtime guidance (e.g. the materialization advisory).
      * Advisory events never gate actions or end runs. */
     type: "advisory";
-    kind: "materialization_nudge" | "budget_warning" | "snapshot_failed";
+    kind: "materialization_nudge" | "budget_warning" | "snapshot_failed" | "output_truncated" | "output_cap_continue" | "verbose_turn" | "assistant_text_elided" | "prose_checkpoint" | "repeated_call" | "empty_turn";
     detail: string;
 } | {
     /** The dying run's handoff: what it still needs, for a consumer that may

package/dist/engine/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/engine/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/engine/events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE7D,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GACvD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,oGAAoG;IACpG,GAAG,CAAC,EAAE,SAAS,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;CAC3D,GACD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7C;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GACD;IACE;;gDAE4C;IAC5C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EACA,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE;yDACqD;IACrD,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EACA,uBAAuB,GACvB,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,qBAAqB,GACrB,cAAc,GACd,uBAAuB,GACvB,kBAAkB,GAClB,eAAe,GACf,YAAY,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE;yEACqE;IACrE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;CACzB,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;CACjB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EACF,UAAU,GACV,WAAW,GACX,iBAAiB,GACjB,SAAS,GACT,OAAO,GACP,QAAQ,GACR,WAAW,CAAC;IAChB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC"}

package/dist/engine/loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/engine/loop.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAqwBtB"}
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/engine/loop.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,WAAW,EAEZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,aAAa,EACb,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAy/BtB"}