anchor-ai-sdk 0.1.7 → 0.1.8

package/README.md

@@ -77,11 +77,47 @@ No sandbox is needed for this chat example. Model calls may incur cost.
 pass its returned `compaction` settings to the engine as shown. Catalog lookup is
 best-effort; configure overrides and fallbacks for endpoints without this metadata.
 
+## Task verification
+
+For tasks that need evidence before completion, enable the opt-in verifier:
+
+```ts
+const result = await runAgent(
+  { task: "Investigate where auth is refreshed" },
+  {
+    llm,
+    sandbox,
+    thread: { store, id: threadId },
+    verifier: true,
+  },
+);
+```
+
+The SDK owns the ledger, intent routing, evidence capture, and phase/finish
+checks. The consumer supplies only the normal `ThreadStore` (the ledger is an
+optional field on `StoredThread`) and the model. Greetings and other chat turns
+create no ledger and make no verifier call. A separate cheap verifier model is
+optional:
+
+```ts
+verifier: {
+  llm: cheapLlm,
+  gates: ["phase", "finish"],
+  allowWaived: true,
+}
+```
+
+`finish` is rejected while a required ledger item is open or lacks linked
+evidence; the agent loops with the missing-evidence feedback. Compiler and
+verifier token usage is counted against the run budget.
+
 ## One sandbox interface
 
 **Configure the provider once. Keep the agent-facing machine interface the same.**
 The same layer works with the built-in coding tools, custom agents, or direct
-`sandbox.exec()` calls without an agent.
+`sandbox.exec()` calls without an agent. For long-lived consumers — LSPs, REPLs,
+dev servers, watchers — `sandbox.openProcess()` is the optional persistent
+stdin/stdout primitive; check `provider.capabilities.processStream` first.
 
 | Provider | Import | Boot configuration |
 | --- | --- | --- |
@@ -193,16 +229,26 @@ try {
 }
 ```
 
-Provider boot settings and optional capabilities differ. Retention needs a cleanup
-policy; remote machines and model calls can cost money. Private HTTPS repositories
+Provider boot settings and optional capabilities differ. Per-sandbox
+`spec.image` is supported by Docker and E2B (as a template name), and by Heyo
+for artifact refs; Local rejects it. Providers that can build/publish expose
+`imagePublisher`, also available as `anchor image publish`.
+Retention needs a cleanup policy; remote machines and model calls can cost money. Private HTTPS repositories
 can use `spec.git.token`, a caller-supplied credential callback.
 
 The latest Docker adapter also supports `spec.egress: "none"`: it disconnects
 container networks after `start()` setup. Other adapters reject that setting.
 This is not a claim that all providers offer equivalent isolation.
 
+Providers that can build images expose the common `imagePublisher` contract and
+the `anchor image publish` command, so Docker, E2B, and Heyo each use their own
+native registry while the caller keeps one shape. `anchor image publish --help`
+shows the flags. Per-provider instructions are in
+[docs/sandbox-image-publishing.md](docs/sandbox-image-publishing.md).
+
 **[Configuration examples](https://anchor-sdk.dev/docs.html#machine)** ·
-**[Provider contract and image guide](https://github.com/hrithikkoduri/anchor-ai-sdk/blob/main/src/sandbox/README.md)**
+**[Provider contract and image guide](https://github.com/hrithikkoduri/anchor-ai-sdk/blob/main/src/sandbox/README.md)** ·
+**[Optional LSP tools](docs/lsp.md)**
 
 ## Make the agent yours
 
@@ -278,11 +324,13 @@ Validate inputs and enforce permissions in your implementation.
 | Capability | Your controls |
 | --- | --- |
 | **Budgets and correction** | Step/token/known-dollar budgets, repeated-call detection, silent-tool and visible-verbosity nudges, prose checkpoints, and per-call output requests. |
+| **Reasoning budget** | Per-run `reasoningEffort` (`minimal`–`xhigh`) or an agent-bundle default, sent in the provider's native shape (`reasoning.effort` on OpenRouter, `reasoning_effort` on OpenAI). |
 | **Context and memory** | Catalog-derived or explicit compaction, supplied thread stores, agent-authored notes, and best-effort output spill. |
 | **Revival and resume** | Opt-in budget warnings, `request_revival`, `planRevival`, and `ThreadBudget`. Your app persists state and decides whether to fund or enqueue another run. |
 | **Snapshots and lifecycle** | Git-backed or custom snapshot hooks, optional push, phase-boundary pauses, heartbeats, and cancellation. |
 | **Streaming and traces** | Raw `onEvent` updates; sequenced, pattern-redacted `traceSinks`; NDJSON files, custom sinks, live projection, and replay. |
 | **Execution evidence** | Tool names/status/metadata plus recorded test-command outcomes and optional post-run Git freshness checks. Your app defines verification and release gates. |
+| **External effects** | Declared effects, a write-ahead operation journal, stable operation ids, reconciliation on resume, and a stop on unknown outcomes. |
 
 <details>
 <summary><strong>Example: limits, nudges, compaction, and a recorded trace</strong></summary>
@@ -331,6 +379,45 @@ are not redacted. Use distinct trace files/IDs per run in your application.
 > `latestEvidenceForTree` can compare it with the current tree, but does not prove
 > an immutable tested snapshot, require a full suite, or inspect assertions.
 
+## Recovering external writes
+
+A crash between "the target accepted the write" and "the thread saved the
+result" must not become a duplicate write. A tool that changes something outside
+the workspace declares an effect; the engine then records the intent before the
+call and settles it after:
+
+```js
+const createIssue = defineTool({ name: "create_issue", /* ... */ }, async (input, ctx) => {
+  const issue = await github.createIssue(input, {
+    idempotencyKey: ctx.operationId, // stable across retries
+  });
+  await ctx.acknowledge?.({ issue: issue.number });
+  return { ok: true, content: `Created #${issue.number}` };
+}, {
+  effect: {
+    async reconcile({ operationId }) {
+      const found = await github.findByKey(operationId);
+      return found
+        ? { status: "applied", result: { ok: true, content: found.url } }
+        : { status: "unknown" };
+    },
+  },
+});
+
+await runAgent(task, {
+  llm, agent, sandbox,
+  operations: { store }, // a durable table in production
+});
+```
+
+On resume, a pending operation is reconciled, never replayed. An unknowable
+outcome ends the run with `reason: "recovery_required"` and
+`AgentResult.pendingOperations`. `MemoryOperationStore` is for tests; production
+needs a durable table with a unique `operation_id`. The target's participation
+(an idempotency key or a status lookup) is what turns this into
+effectively-once; without it, the harness surfaces the ambiguity instead of
+guessing.
+
 ## Test the machine contract
 
 `runSandboxConformance(provider)` from `anchor-ai-sdk/testing` exercises the

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

@@ -16,6 +16,7 @@ export { codingPhases } from "./phases.js";
 export declare function createCodingAgent(opts?: {
     testCommand?: string;
     maxOutputTokens?: number | false;
+    reasoningEffort?: Agent["reasoningEffort"];
 }): 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;;;;;;;;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"}
+{"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;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACjC,eAAe,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;CACvC,GACL,KAAK,CAYP;AAED,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,KAA2B,CAAC"}

package/dist/agents/coding/index.js

@@ -21,6 +21,9 @@ export function createCodingAgent(opts = {}) {
         ...(opts.maxOutputTokens !== undefined
             ? { maxOutputTokens: opts.maxOutputTokens }
             : {}),
+        ...(opts.reasoningEffort !== undefined
+            ? { reasoningEffort: opts.reasoningEffort }
+            : {}),
     };
 }
 /** 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;;;;;;;;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"}
+{"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,GAIA,EAAE;IAEN,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;QACP,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/index.d.ts

@@ -7,4 +7,5 @@
 export * from "./types.js";
 export * from "./coding/index.js";
 export * from "./chat/index.js";
+export * from "./terminal/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/agents/index.js

@@ -7,4 +7,5 @@
 export * from "./types.js";
 export * from "./coding/index.js";
 export * from "./chat/index.js";
+export * from "./terminal/index.js";
 //# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { Agent } from "../types.js";
+export { terminalStrategy } from "./strategy.js";
+export { terminalPhases } from "./phases.js";
+export { buildTerminalPrompt } from "./prompt.js";
+export declare function createTerminalAgent(opts?: {
+    maxOutputTokens?: number | false;
+    reasoningEffort?: Agent["reasoningEffort"];
+}): Agent;
+export declare const terminalAgent: Agent;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IACxC,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACjC,eAAe,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;CACvC,GAAG,KAAK,CAYb;AAED,eAAO,MAAM,aAAa,EAAE,KAA6B,CAAC"}

package/dist/agents/terminal/index.js

@@ -0,0 +1,20 @@
+import { createCodingTools } from "../coding/tools.js";
+import { terminalStrategy } from "./strategy.js";
+export { terminalStrategy } from "./strategy.js";
+export { terminalPhases } from "./phases.js";
+export { buildTerminalPrompt } from "./prompt.js";
+export function createTerminalAgent(opts = {}) {
+    return {
+        name: "terminal",
+        strategy: terminalStrategy,
+        tools: createCodingTools(),
+        ...(opts.maxOutputTokens !== undefined
+            ? { maxOutputTokens: opts.maxOutputTokens }
+            : {}),
+        ...(opts.reasoningEffort !== undefined
+            ? { reasoningEffort: opts.reasoningEffort }
+            : {}),
+    };
+}
+export const terminalAgent = createTerminalAgent();
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/terminal/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,UAAU,mBAAmB,CAAC,IAAI,GAGpC,EAAE;IACJ,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,gBAAgB;QAC1B,KAAK,EAAE,iBAAiB,EAAE;QAC1B,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE;YAC3C,CAAC,CAAC,EAAE,CAAC;QACP,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,MAAM,CAAC,MAAM,aAAa,GAAU,mBAAmB,EAAE,CAAC"}

package/dist/agents/terminal/phases.d.ts

@@ -0,0 +1,4 @@
+import type { StrategyPhase } from "../../engine/strategy.js";
+/** Terminal work: inspect the machine, act, prove, report. No repo assumption. */
+export declare const terminalPhases: StrategyPhase[];
+//# sourceMappingURL=phases.d.ts.map

package/dist/agents/terminal/phases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.d.ts","sourceRoot":"","sources":["../../../src/agents/terminal/phases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,kFAAkF;AAClF,eAAO,MAAM,cAAc,EAAE,aAAa,EA+BzC,CAAC"}

package/dist/agents/terminal/phases.js

@@ -0,0 +1,29 @@
+/** Terminal work: inspect the machine, act, prove, report. No repo assumption. */
+export const terminalPhases = [
+    {
+        id: "inspect",
+        goal: "Establish the machine state, task artifacts, and available tooling.",
+        guidance: "Use the shell. Check the working directory, installed runtimes, task files, and any verifier/tests. Do not assume a git repository, /testbed, or a project test command.",
+    },
+    {
+        id: "plan",
+        goal: "Choose the shortest reliable path to the task's own success condition.",
+        guidance: "Name the concrete commands, installs, edits, and checks. Prefer the task's own verifier over generic repo tests.",
+    },
+    {
+        id: "act",
+        goal: "Execute the task with terminal-native steps.",
+        guidance: "Run commands, install missing tools, modify files, and adjust when output changes the picture. Keep the workspace clean of scratch artifacts.",
+    },
+    {
+        id: "verify",
+        goal: "Run the task's verifier and inspect its actual output.",
+        guidance: "The task's test/verifier is the source of truth. Re-run after the final change. Report missing or flaky checks honestly.",
+    },
+    {
+        id: "respond",
+        goal: "Deliver the outcome with the commands and evidence that prove it.",
+        guidance: "State what changed and what was actually verified. Do not claim a pass you did not observe.",
+    },
+];
+//# sourceMappingURL=phases.js.map

package/dist/agents/terminal/phases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phases.js","sourceRoot":"","sources":["../../../src/agents/terminal/phases.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,qEAAqE;QAC3E,QAAQ,EACN,0KAA0K;KAC7K;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,wEAAwE;QAC9E,QAAQ,EACN,kHAAkH;KACrH;IACD;QACE,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,8CAA8C;QACpD,QAAQ,EACN,+IAA+I;KAClJ;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,wDAAwD;QAC9D,QAAQ,EACN,0HAA0H;KAC7H;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,mEAAmE;QACzE,QAAQ,EACN,6FAA6F;KAChG;CACF,CAAC"}

package/dist/agents/terminal/prompt.d.ts

@@ -0,0 +1,13 @@
+import type { StrategyPhase } from "../../engine/strategy.js";
+export interface TerminalPromptOptions {
+    phases?: StrategyPhase[];
+    context?: string;
+    summary?: string;
+}
+/**
+ * Terminal-native prompt. Deliberately does not tell the model to inspect a
+ * git diff, run a repository test suite, or trust a provisioned conda env.
+ * Terminal-Bench tasks are stateful shell problems with their own verifier.
+ */
+export declare function buildTerminalPrompt(options?: TerminalPromptOptions): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/agents/terminal/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/agents/terminal/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CA4B/E"}

package/dist/agents/terminal/prompt.js

@@ -0,0 +1,33 @@
+import { terminalPhases } from "./phases.js";
+/**
+ * Terminal-native prompt. Deliberately does not tell the model to inspect a
+ * git diff, run a repository test suite, or trust a provisioned conda env.
+ * Terminal-Bench tasks are stateful shell problems with their own verifier.
+ */
+export function buildTerminalPrompt(options = {}) {
+    const phases = options.phases ?? terminalPhases;
+    return [
+        "# Character",
+        "You are a capable terminal operator. You work directly on the machine: inspect it, install what is missing, change what is needed, and prove the result with the task's own verifier.",
+        "# Operating rules",
+        [
+            "- The shell is your primary tool. Use it to inspect the real state; do not assume a repository layout, a git diff, or a pre-provisioned Python environment.",
+            "- The task instruction and its verifier are the contract. If the task supplies tests, run them and read the actual output.",
+            "- Install missing tools only when needed, with the system package manager or the language's package manager.",
+            "- Keep the final state focused: no unrelated edits, no scratch files left behind unless the task requires them.",
+            "- Never claim a command or test passed unless you observed its exit code/output. Report flaky or unavailable checks honestly.",
+        ].join("\n"),
+        "# Approach phases",
+        [
+            "These describe an approach, not a prerequisite itinerary. Skip or revisit phases as the actual environment requires.",
+            ...phases.map((phase) => `- ${phase.id}: ${phase.goal}${phase.guidance ? ` ${phase.guidance}` : ""}`),
+        ].join("\n"),
+        options.context ? `# Environment observations\n${options.context}` : "",
+        options.summary
+            ? `# Earlier thread context (may describe obsolete plans)\n${options.summary}`
+            : "",
+    ]
+        .filter((part) => part.trim())
+        .join("\n\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/agents/terminal/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/agents/terminal/prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ7C;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAO,GAA0B,EAAE;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC;IAChD,OAAO;QACL,aAAa;QACb,uLAAuL;QACvL,mBAAmB;QACnB;YACE,6JAA6J;YAC7J,4HAA4H;YAC5H,8GAA8G;YAC9G,iHAAiH;YACjH,+HAA+H;SAChI,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,mBAAmB;QACnB;YACE,sHAAsH;YACtH,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;SACF,CAAC,IAAI,CAAC,IAAI,CAAC;QACZ,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;QACvE,OAAO,CAAC,OAAO;YACb,CAAC,CAAC,2DAA2D,OAAO,CAAC,OAAO,EAAE;YAC9E,CAAC,CAAC,EAAE;KACP;SACE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC7B,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/agents/terminal/strategy.d.ts

@@ -0,0 +1,3 @@
+import type { AgentStrategy } from "../../engine/strategy.js";
+export declare const terminalStrategy: AgentStrategy;
+//# sourceMappingURL=strategy.d.ts.map

package/dist/agents/terminal/strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../src/agents/terminal/strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAI9D,eAAO,MAAM,gBAAgB,EAAE,aAQ9B,CAAC"}

package/dist/agents/terminal/strategy.js

@@ -0,0 +1,12 @@
+import { terminalPhases } from "./phases.js";
+import { buildTerminalPrompt } from "./prompt.js";
+export const terminalStrategy = {
+    name: "terminal",
+    phases: terminalPhases,
+    requiresSandbox: true,
+    requiredTools: ["bash", "read_file", "edit_file"],
+    systemPrompt({ context, summary }) {
+        return buildTerminalPrompt({ context, summary });
+    },
+};
+//# sourceMappingURL=strategy.js.map

package/dist/agents/terminal/strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy.js","sourceRoot":"","sources":["../../../src/agents/terminal/strategy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,cAAc;IACtB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC;IACjD,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE;QAC/B,OAAO,mBAAmB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;CACF,CAAC"}

package/dist/agents/types.d.ts

@@ -11,6 +11,7 @@
  * per-field. Custom agents are just objects built from the same primitives.
  */
 import type { AgentStrategy } from "../engine/strategy.js";
+import type { ReasoningEffort } from "../llm/types.js";
 import type { Tool } from "../tools/types.js";
 export interface Agent {
     /** Short display name ("coding", "chat") — logs, dashboards, traces. */
@@ -24,5 +25,10 @@ export interface Agent {
      * An explicit engine option wins; absent, the engine default applies.
      */
     maxOutputTokens?: number | false;
+    /**
+     * Reasoning budget this bundle suggests. An explicit
+     * `EngineOptions.reasoningEffort` wins; absent, the provider default applies.
+     */
+    reasoningEffort?: ReasoningEffort;
 }
 //# 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;IACd;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAClC"}
+{"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,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,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;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+const PUBLISHERS = ["docker", "e2b", "heyo"];
+const PROVIDERS = ["docker", "e2b", "heyo", "daytona", "local"];
+function usage() {
+    return `usage:
+  anchor image publish --provider <docker|e2b|heyo> --name <tag>
+    (--dockerfile <path> [--context <dir>] | --from-image <image> | --rootfs <path>)
+    [--build-arg KEY=VALUE]... [--no-push] [--public] [--json]
+
+  anchor <provider> image publish ...   # provider-first alias
+
+Providers:
+  docker  build/tag and push a container image
+  e2b     build/publish an E2B template (from a Dockerfile or image)
+  heyo    push a rootfs or Dockerfile manifest with heyctl
+
+Credentials:
+  Docker  uses the Docker CLI's existing login
+  E2B     E2B_API_KEY (and optional E2B_DOMAIN)
+  Heyo    heyctl's saved login (optional HEYCTL_BIN, HEYO_IMAGE_STORE)
+`;
+}
+function isProvider(value) {
+    return !!value && PROVIDERS.includes(value);
+}
+function parse(argv) {
+    const out = {
+        buildArgs: {},
+        push: true,
+        public: false,
+        json: false,
+        help: false,
+    };
+    let args = [...argv];
+    if (args[0] === "image" && args[1] === "publish") {
+        args = args.slice(2);
+    }
+    else if (isProvider(args[0]) && args[1] === "image" && args[2] === "publish") {
+        out.provider = args[0];
+        args = args.slice(3);
+    }
+    else if (isProvider(args[0]) && args[1] === "publish" && args[2] === "image") {
+        out.provider = args[0];
+        args = args.slice(3);
+    }
+    else if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+        out.help = true;
+        return out;
+    }
+    else {
+        throw new Error(`unknown command\n\n${usage()}`);
+    }
+    let fromImage;
+    let rootfs;
+    let dockerfile;
+    let context;
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        const value = () => {
+            const v = args[i + 1];
+            if (!v)
+                throw new Error(`missing value for ${arg}`);
+            i += 1;
+            return v;
+        };
+        if (arg === "--help" || arg === "-h")
+            out.help = true;
+        else if (arg === "--json")
+            out.json = true;
+        else if (arg === "--no-push")
+            out.push = false;
+        else if (arg === "--public")
+            out.public = true;
+        else if (arg === "--provider")
+            out.provider = value();
+        else if (arg === "--name")
+            out.name = value();
+        else if (arg === "--from-image")
+            fromImage = value();
+        else if (arg === "--rootfs")
+            rootfs = value();
+        else if (arg === "--dockerfile")
+            dockerfile = value();
+        else if (arg === "--context")
+            context = value();
+        else if (arg === "--build-arg") {
+            const pair = value();
+            const equals = pair.indexOf("=");
+            if (equals <= 0)
+                throw new Error(`--build-arg needs KEY=VALUE, got ${pair}`);
+            out.buildArgs[pair.slice(0, equals)] = pair.slice(equals + 1);
+        }
+        else {
+            throw new Error(`unknown option ${arg}\n\n${usage()}`);
+        }
+    }
+    if (out.help)
+        return out;
+    const sources = [
+        fromImage ? { kind: "image", image: fromImage } : undefined,
+        rootfs ? { kind: "rootfs", path: rootfs } : undefined,
+        dockerfile ? { kind: "dockerfile", path: dockerfile } : undefined,
+    ].filter((source) => source !== undefined);
+    if (sources.length !== 1) {
+        throw new Error(`choose exactly one of --dockerfile, --from-image, or --rootfs\n\n${usage()}`);
+    }
+    if (context && !dockerfile) {
+        throw new Error("--context requires --dockerfile");
+    }
+    if (dockerfile)
+        out.source = { kind: "dockerfile", path: dockerfile, ...(context ? { context } : {}) };
+    else if (rootfs)
+        out.source = { kind: "rootfs", path: rootfs };
+    else
+        out.source = { kind: "image", image: fromImage };
+    return out;
+}
+async function loadPublisher(provider) {
+    if (provider === "docker") {
+        const { dockerImagePublisher } = await import("./sandbox/docker/image.js");
+        return dockerImagePublisher({
+            dockerBin: process.env.ANCHOR_DOCKER_BIN ?? process.env.DOCKER_BIN,
+        });
+    }
+    if (provider === "e2b") {
+        const { e2bImagePublisher } = await import("./sandbox/e2b/image.js");
+        const cpu = process.env.E2B_CPU_COUNT;
+        const memory = process.env.E2B_MEMORY_MB;
+        return e2bImagePublisher({
+            apiKey: process.env.E2B_API_KEY,
+            domain: process.env.E2B_DOMAIN,
+            ...(cpu ? { cpuCount: Number(cpu) } : {}),
+            ...(memory ? { memoryMB: Number(memory) } : {}),
+        });
+    }
+    if (provider === "heyo") {
+        const { heyoImagePublisher } = await import("./sandbox/heyo/image.js");
+        return heyoImagePublisher({
+            heyctlBin: process.env.HEYCTL_BIN,
+            imageStore: process.env.HEYO_IMAGE_STORE,
+        });
+    }
+    throw new Error(`provider "${provider}" has no image publisher (supported: ${PUBLISHERS.join(", ")})`);
+}
+function printResult(result) {
+    console.log(`published ${result.kind} via ${result.provider}: ${result.ref}`);
+    if (result.target === "sandbox-spec") {
+        console.log(`use at sandbox init: { image: ${JSON.stringify(result.ref)} }`);
+    }
+    else {
+        console.log(`use in provider config: ${JSON.stringify(result.providerConfig, null, 2)}`);
+    }
+}
+async function main() {
+    const parsed = parse(process.argv.slice(2));
+    if (parsed.help) {
+        process.stdout.write(usage());
+        return;
+    }
+    if (!parsed.provider)
+        throw new Error(`--provider is required\n\n${usage()}`);
+    if (!parsed.name)
+        throw new Error(`--name is required\n\n${usage()}`);
+    if (!parsed.source) {
+        throw new Error(`one of --dockerfile, --from-image, or --rootfs is required\n\n${usage()}`);
+    }
+    const publisher = await loadPublisher(parsed.provider);
+    const request = {
+        name: parsed.name,
+        source: parsed.source,
+        buildArgs: parsed.buildArgs,
+        push: parsed.push,
+        public: parsed.public,
+    };
+    const result = await publisher.publish(request, {
+        log: (line) => process.stderr.write(line),
+    });
+    if (parsed.json)
+        console.log(JSON.stringify(result, null, 2));
+    else
+        printResult(result);
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/engine/budgets.d.ts

@@ -32,6 +32,7 @@ export declare class BudgetTracker {
     promptTokens: number;
     completionTokens: number;
     reasoningTokens: number | undefined;
+    cachedTokens: number;
     costUsd: number;
     costsKnown: boolean;
     constructor(limits?: Partial<BudgetLimits>);

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;;;;;;;;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"}
+{"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,YAAY,SAAK;IACjB,OAAO,SAAK;IACZ,UAAU,UAAQ;IAElB,YAAY,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM,EAE7C;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAU5B;IAED,WAAW,IAAI,MAAM,CAEpB;IAED,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAc7C;CACF"}

package/dist/engine/budgets.js

@@ -18,6 +18,7 @@ export class BudgetTracker {
     promptTokens = 0;
     completionTokens = 0;
     reasoningTokens;
+    cachedTokens = 0;
     costUsd = 0;
     costsKnown = true;
     constructor(limits = {}) {
@@ -28,6 +29,8 @@ export class BudgetTracker {
         this.completionTokens += usage.completionTokens;
         if (usage.reasoningTokens !== undefined)
             this.reasoningTokens = (this.reasoningTokens ?? 0) + usage.reasoningTokens;
+        if (usage.cachedTokens !== undefined)
+            this.cachedTokens += usage.cachedTokens;
         if (usage.costUsd !== undefined) {
             this.costUsd += usage.costUsd;
         }