tubeless 0.3.7 → 0.3.9

package/dist/agent/agent-session.d.ts

@@ -0,0 +1,31 @@
+import type { Pipeline, PipelineContext, PipelineRun, PipelineRunControls } from "../core/pipeline-types.js";
+/** Conversation hooks a session supplies to its own compiled copy of a model-backed agent. */
+export interface SessionHooks {
+    /** The committed conversation that seeds a fresh run. */
+    seed(): unknown;
+    /** Record the latest owned conversation, including a finish decision's. */
+    observe(conversation: unknown): void;
+}
+type SessionAgent = Pipeline<object, unknown, "agent", "agent", string>;
+/** Let `createAgentSession` recompile this model-backed agent with session hooks. */
+export declare function registerSessionAgent(agent: object, build: (hooks: SessionHooks) => SessionAgent): void;
+/** Sequential runs of one model-backed agent that continue a single conversation. */
+export interface AgentSession<Input extends object, Result> {
+    /** Run one prompt; the conversation advances only when the run completes and finalizes. */
+    run(input: Input, controls?: PipelineRunControls<"agent", "agent">, context?: Partial<PipelineContext>): Promise<PipelineRun<Result>>;
+    /** Run one prompt and return its result, or throw the run's execution error. */
+    runOrThrow(input: Input, controls?: PipelineRunControls<"agent", "agent">, context?: Partial<PipelineContext>): Promise<Result>;
+    /** Provider-owned plain data to persist; null before the first completed run or after clear(). */
+    readonly conversation: unknown;
+    /** Start the next run with a fresh conversation. */
+    clear(): void;
+}
+/**
+ * Continue one conversation across sequential runs of a `defineAgent` agent, such as chat
+ * prompts. Failed and cancelled runs keep the previous conversation. Pass a persisted
+ * `conversation` to resume from storage; it must come from the same model provider.
+ */
+export declare function createAgentSession<Input extends object, Result>(agent: Pipeline<Input, Result, "agent", "agent", string>, options?: {
+    readonly conversation?: unknown;
+}): AgentSession<Input, Result>;
+export {};

package/dist/agent/agent-session.js

@@ -0,0 +1,67 @@
+import { PipelineExecutionError } from "../core/pipeline-execution-error.js";
+import { agentError, ownState } from "./agent-state.js";
+const builders = new WeakMap();
+/** Let `createAgentSession` recompile this model-backed agent with session hooks. */
+export function registerSessionAgent(agent, build) {
+    builders.set(agent, build);
+}
+/**
+ * Continue one conversation across sequential runs of a `defineAgent` agent, such as chat
+ * prompts. Failed and cancelled runs keep the previous conversation. Pass a persisted
+ * `conversation` to resume from storage; it must come from the same model provider.
+ */
+export function createAgentSession(agent, options = {}) {
+    const build = builders.get(agent);
+    if (!build)
+        throw agentError("TUBELESS_AGENT_INVALID_DEFINITION", "createAgentSession requires an agent from defineAgent");
+    let committed = ownState(options.conversation ?? null);
+    // Track observation separately: a provider may legitimately return an undefined conversation.
+    let latest;
+    let observed = false;
+    let running = false;
+    // clear() during a run discards that run's conversation instead of reviving it later.
+    let generation = 0;
+    // SAFETY: the builder recompiles the same definition, so its options and result types match.
+    const compiled = build({
+        seed: () => committed,
+        observe: (conversation) => {
+            latest = ownState(conversation);
+            observed = true;
+        },
+    });
+    const run = async (input, controls, context) => {
+        if (running)
+            throw agentError("TUBELESS_AGENT_SESSION_BUSY", "Agent session is already running");
+        running = true;
+        latest = undefined;
+        observed = false;
+        const started = generation;
+        try {
+            const result = await compiled.run(input, controls, context);
+            if (result.status === "completed" && result.finalized && observed && generation === started)
+                committed = latest ?? null;
+            return result;
+        }
+        finally {
+            running = false;
+        }
+    };
+    return Object.freeze({
+        run,
+        async runOrThrow(input, controls, context) {
+            const result = await run(input, controls, context);
+            if (result.status !== "completed")
+                throw new PipelineExecutionError(result);
+            // SAFETY: a completed run always carries its result value, as in Pipeline.runOrThrow.
+            return result.value;
+        },
+        get conversation() {
+            return committed;
+        },
+        clear() {
+            committed = null;
+            generation++;
+        },
+    });
+}
+//# sourceMappingURL=agent-session.js.map

package/dist/agent/agent-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.js","sourceRoot":"","sources":["../../src/agent/agent-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAO7E,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAWxD,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAiD,CAAC;AAE9E,qFAAqF;AACrF,MAAM,UAAU,oBAAoB,CAClC,KAAa,EACb,KAA4C;IAE5C,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC;AAsBD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAwD,EACxD,OAAO,GAAwC,EAAE;IAEjD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK;QACR,MAAM,UAAU,CACd,mCAAmC,EACnC,uDAAuD,CACxD,CAAC;IACJ,IAAI,SAAS,GAAY,QAAQ,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC;IAChE,8FAA8F;IAC9F,IAAI,MAAe,CAAC;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,sFAAsF;IACtF,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,6FAA6F;IAC7F,MAAM,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS;QACrB,OAAO,EAAE,CAAC,YAAY,EAAE,EAAE;YACxB,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;YAChC,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;KACF,CAAiE,CAAC;IACnE,MAAM,GAAG,GAAuC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QACjF,IAAI,OAAO;YACT,MAAM,UAAU,CAAC,6BAA6B,EAAE,kCAAkC,CAAC,CAAC;QACtF,OAAO,GAAG,IAAI,CAAC;QACf,MAAM,GAAG,SAAS,CAAC;QACnB,QAAQ,GAAG,KAAK,CAAC;QACjB,MAAM,OAAO,GAAG,UAAU,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,SAAS,IAAI,QAAQ,IAAI,UAAU,KAAK,OAAO;gBACzF,SAAS,GAAG,MAAM,IAAI,IAAI,CAAC;YAC7B,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG;QACH,KAAK,CAAC,UAAU,CACd,KAAY,EACZ,QAAgD,EAChD,OAAkC;YAElC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAC5E,sFAAsF;YACtF,OAAO,MAAM,CAAC,KAAe,CAAC;QAChC,CAAC;QACD,IAAI,YAAY;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK;YACH,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,EAAE,CAAC;QACf,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { PipelineExecutionError } from \"../core/pipeline-execution-error.js\";\nimport type {\n  Pipeline,\n  PipelineContext,\n  PipelineRun,\n  PipelineRunControls,\n} from \"../core/pipeline-types.js\";\nimport { agentError, ownState } from \"./agent-state.js\";\n\n/** Conversation hooks a session supplies to its own compiled copy of a model-backed agent. */\nexport interface SessionHooks {\n  /** The committed conversation that seeds a fresh run. */\n  seed(): unknown;\n  /** Record the latest owned conversation, including a finish decision's. */\n  observe(conversation: unknown): void;\n}\n\ntype SessionAgent = Pipeline<object, unknown, \"agent\", \"agent\", string>;\nconst builders = new WeakMap<object, (hooks: SessionHooks) => SessionAgent>();\n\n/** Let `createAgentSession` recompile this model-backed agent with session hooks. */\nexport function registerSessionAgent(\n  agent: object,\n  build: (hooks: SessionHooks) => SessionAgent\n): void {\n  builders.set(agent, build);\n}\n\n/** Sequential runs of one model-backed agent that continue a single conversation. */\nexport interface AgentSession<Input extends object, Result> {\n  /** Run one prompt; the conversation advances only when the run completes and finalizes. */\n  run(\n    input: Input,\n    controls?: PipelineRunControls<\"agent\", \"agent\">,\n    context?: Partial<PipelineContext>\n  ): Promise<PipelineRun<Result>>;\n  /** Run one prompt and return its result, or throw the run's execution error. */\n  runOrThrow(\n    input: Input,\n    controls?: PipelineRunControls<\"agent\", \"agent\">,\n    context?: Partial<PipelineContext>\n  ): Promise<Result>;\n  /** Provider-owned plain data to persist; null before the first completed run or after clear(). */\n  readonly conversation: unknown;\n  /** Start the next run with a fresh conversation. */\n  clear(): void;\n}\n\n/**\n * Continue one conversation across sequential runs of a `defineAgent` agent, such as chat\n * prompts. Failed and cancelled runs keep the previous conversation. Pass a persisted\n * `conversation` to resume from storage; it must come from the same model provider.\n */\nexport function createAgentSession<Input extends object, Result>(\n  agent: Pipeline<Input, Result, \"agent\", \"agent\", string>,\n  options: { readonly conversation?: unknown } = {}\n): AgentSession<Input, Result> {\n  const build = builders.get(agent);\n  if (!build)\n    throw agentError(\n      \"TUBELESS_AGENT_INVALID_DEFINITION\",\n      \"createAgentSession requires an agent from defineAgent\"\n    );\n  let committed: unknown = ownState(options.conversation ?? null);\n  // Track observation separately: a provider may legitimately return an undefined conversation.\n  let latest: unknown;\n  let observed = false;\n  let running = false;\n  // clear() during a run discards that run's conversation instead of reviving it later.\n  let generation = 0;\n  // SAFETY: the builder recompiles the same definition, so its options and result types match.\n  const compiled = build({\n    seed: () => committed,\n    observe: (conversation) => {\n      latest = ownState(conversation);\n      observed = true;\n    },\n  }) as unknown as Pipeline<Input, Result, \"agent\", \"agent\", string>;\n  const run: AgentSession<Input, Result>[\"run\"] = async (input, controls, context) => {\n    if (running)\n      throw agentError(\"TUBELESS_AGENT_SESSION_BUSY\", \"Agent session is already running\");\n    running = true;\n    latest = undefined;\n    observed = false;\n    const started = generation;\n    try {\n      const result = await compiled.run(input, controls, context);\n      if (result.status === \"completed\" && result.finalized && observed && generation === started)\n        committed = latest ?? null;\n      return result;\n    } finally {\n      running = false;\n    }\n  };\n  return Object.freeze({\n    run,\n    async runOrThrow(\n      input: Input,\n      controls?: PipelineRunControls<\"agent\", \"agent\">,\n      context?: Partial<PipelineContext>\n    ) {\n      const result = await run(input, controls, context);\n      if (result.status !== \"completed\") throw new PipelineExecutionError(result);\n      // SAFETY: a completed run always carries its result value, as in Pipeline.runOrThrow.\n      return result.value as Result;\n    },\n    get conversation() {\n      return committed;\n    },\n    clear() {\n      committed = null;\n      generation++;\n    },\n  });\n}\n"]}

package/dist/agent/agent-types.d.ts

@@ -2,6 +2,7 @@ import type { PipelineStepContext, StandardSchemaV1 } from "../core/pipeline-typ
 import type { AgentEnvironment, AgentEnvironmentProvider } from "./environment.js";
 import type { AgentDurability, AgentExecutionIdentity } from "./checkpoint-types.js";
 import type { DefaultAgentTools } from "./default-tools.js";
+import type { CodemodeExecutor } from "./codemode-executor.js";
 export type Awaitable<T> = T | Promise<T>;
 export type Input<S extends StandardSchemaV1> = NonNullable<S["~standard"]["types"]>["input"];
 export type Output<S extends StandardSchemaV1> = NonNullable<S["~standard"]["types"]>["output"];
@@ -18,7 +19,9 @@ export interface AgentTool<Arguments, Result> {
     };
 }
 export type Tools = Readonly<Record<string, AgentTool<unknown, unknown>>>;
-type RegisteredTools<Custom extends Tools> = Omit<DefaultAgentTools, keyof Custom> & Custom;
+/** A standard workspace tool an agent's setup may select. */
+export type DefaultAgentToolName = keyof DefaultAgentTools;
+type RegisteredTools<Custom extends Tools, Defaults extends DefaultAgentToolName> = Omit<Pick<DefaultAgentTools, Defaults>, keyof Custom> & Custom;
 type ToolCall<Registry extends Tools> = {
     [Name in keyof Registry & string]: {
         readonly id: string;
@@ -26,8 +29,31 @@ type ToolCall<Registry extends Tools> = {
         readonly input: Registry[Name][typeof capabilityTypes]["input"];
     };
 }[keyof Registry & string];
-/** One built-in or custom call with raw model arguments; custom names replace defaults. */
-export type AgentCall<Registry extends Tools = {}> = ToolCall<RegisteredTools<Registry>>;
+/** A code-mode script's JSON return value and bounded console lines. */
+export interface CodemodeResult {
+    readonly result: unknown;
+    readonly logs: readonly string[];
+    readonly logsTruncated: boolean;
+}
+/** Code-mode settings; the executor defaults to a Node worker thread. */
+export interface CodemodeOptions {
+    /** Where scripts run, such as `createWorkerLoaderCodemodeExecutor` on Cloudflare. */
+    readonly executor?: CodemodeExecutor;
+}
+/** `true` or options enable code mode; `false` or omission advertises the registry. */
+export type CodemodeSetting = boolean | CodemodeOptions;
+type CodemodeEnabled<Setting extends CodemodeSetting> = Setting extends false ? false : true;
+/** The only capability a code-mode agent advertises; its scripts reach the registry. */
+type CodemodeTools = {
+    readonly codemode: AgentTool<{
+        readonly code: string;
+    }, CodemodeResult>;
+};
+/**
+ * One selected default or custom call with raw model arguments; custom names replace
+ * defaults. With code mode, the only callable tool is `codemode`.
+ */
+export type AgentCall<Registry extends Tools = {}, Codemode extends boolean = false, Defaults extends DefaultAgentToolName = DefaultAgentToolName> = Codemode extends true ? ToolCall<CodemodeTools> : ToolCall<RegisteredTools<Registry, Defaults>>;
 type ToolOutcome<Registry extends Tools> = {
     [Name in keyof Registry & string]: {
         readonly id: string;
@@ -43,12 +69,15 @@ type ToolOutcome<Registry extends Tools> = {
         };
     });
 }[keyof Registry & string];
-/** Input-order result or deliberately recoverable handler failure, including default tools. */
-export type AgentOutcome<Registry extends Tools = {}> = ToolOutcome<RegisteredTools<Registry>>;
+/** Input-order result or deliberately recoverable handler failure, including selected defaults. */
+export type AgentOutcome<Registry extends Tools = {}, Codemode extends boolean = false, Defaults extends DefaultAgentToolName = DefaultAgentToolName> = Codemode extends true ? ToolOutcome<CodemodeTools> : ToolOutcome<RegisteredTools<Registry, Defaults>>;
 /** A nonempty batch of independent calls, or the raw input to the final-result schema. */
-export type AgentDecision<Registry extends Tools, Result> = {
+export type AgentDecision<Registry extends Tools, Result, Codemode extends boolean = false, Defaults extends DefaultAgentToolName = DefaultAgentToolName> = {
     readonly kind: "continue";
-    readonly calls: readonly [AgentCall<Registry>, ...AgentCall<Registry>[]];
+    readonly calls: readonly [
+        AgentCall<Registry, Codemode, Defaults>,
+        ...AgentCall<Registry, Codemode, Defaults>[]
+    ];
     readonly result?: never;
 } | {
     readonly kind: "finish";
@@ -86,7 +115,7 @@ export interface AgentDecisionContext<Options extends object> extends PipelineSt
     }[];
     readonly resultJsonSchema: Readonly<Record<string, unknown>>;
 }
-export interface AgentDefinition<Id extends string, Options extends StandardSchemaV1<object, object>, Result extends StandardSchemaV1, State, Registry extends Tools> {
+export interface AgentDefinition<Id extends string, Options extends StandardSchemaV1<object, object>, Result extends StandardSchemaV1, State, Registry extends Tools, Codemode extends CodemodeSetting = false, Defaults extends DefaultAgentToolName = DefaultAgentToolName> {
     readonly id: Id;
     readonly name?: string;
     readonly description?: string;
@@ -95,8 +124,19 @@ export interface AgentDefinition<Id extends string, Options extends StandardSche
     readonly inputSchema: Options;
     readonly resultSchema: Result;
     readonly resultJsonSchema?: Readonly<Record<string, unknown>>;
-    /** Extend the standard tools; a custom tool with the same name replaces that default. */
+    /** Extend the selected standard tools; a custom tool with the same name replaces that default. */
     readonly tools?: Registry;
+    /**
+     * Standard workspace tools this agent may use. Defaults to all of read, write, edit, bash,
+     * list and search; `[]` grants none, so only custom tools remain.
+     */
+    readonly defaultTools?: readonly Defaults[];
+    /**
+     * Advertise one `codemode` tool instead of the registry. Its JavaScript scripts call every
+     * registered tool; decisions and outcomes then name only `codemode`. Pass `{ executor }` to
+     * run scripts somewhere other than a Node worker thread. Defaults to false.
+     */
+    readonly codemode?: Codemode;
     readonly limits?: AgentLimits;
     /** Workspace capabilities; descendants inherit them unless explicitly replaced. */
     readonly environment?: AgentEnvironmentProvider;
@@ -104,7 +144,7 @@ export interface AgentDefinition<Id extends string, Options extends StandardSche
     readonly durability?: AgentDurability<Output<Options>>;
     initialState(options: Output<Options>): State;
     decide(state: AgentState<NoInfer<State>>, context: AgentDecisionContext<Output<Options>>): Awaitable<unknown>;
-    reduce?(state: AgentState<NoInfer<State>>, outcomes: readonly AgentOutcome<Registry>[]): NoInfer<State>;
+    reduce?(state: AgentState<NoInfer<State>>, outcomes: readonly AgentOutcome<Registry, CodemodeEnabled<Codemode>, Defaults>[]): NoInfer<State>;
     dryRun?(state: AgentState<NoInfer<State>>, context: AgentDecisionContext<Output<Options>>): Awaitable<unknown>;
 }
 export {};

package/dist/agent/agent-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-types.js","sourceRoot":"","sources":["../../src/agent/agent-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { PipelineStepContext, StandardSchemaV1 } from \"../core/pipeline-types.js\";\nimport type { AgentEnvironment, AgentEnvironmentProvider } from \"./environment.js\";\nimport type { AgentDurability, AgentExecutionIdentity } from \"./checkpoint-types.js\";\nimport type { DefaultAgentTools } from \"./default-tools.js\";\n\nexport type Awaitable<T> = T | Promise<T>;\nexport type Input<S extends StandardSchemaV1> = NonNullable<S[\"~standard\"][\"types\"]>[\"input\"];\nexport type Output<S extends StandardSchemaV1> = NonNullable<S[\"~standard\"][\"types\"]>[\"output\"];\n/** Deeply read-only view of the owned plain-data state supplied to agent callbacks. */\nexport type AgentState<T> = { readonly [K in keyof T]: AgentState<T[K]> };\ndeclare const capabilityTypes: unique symbol;\n\n/** Opaque capability created by defineTool or pipelineTool; model decisions contain data only. */\nexport interface AgentTool<Arguments, Result> {\n  readonly [capabilityTypes]: { readonly input: Arguments; readonly output: Result };\n}\n\nexport type Tools = Readonly<Record<string, AgentTool<unknown, unknown>>>;\ntype RegisteredTools<Custom extends Tools> = Omit<DefaultAgentTools, keyof Custom> & Custom;\n\ntype ToolCall<Registry extends Tools> = {\n  [Name in keyof Registry & string]: {\n    readonly id: string;\n    readonly tool: Name;\n    readonly input: Registry[Name][typeof capabilityTypes][\"input\"];\n  };\n}[keyof Registry & string];\n\n/** One built-in or custom call with raw model arguments; custom names replace defaults. */\nexport type AgentCall<Registry extends Tools = {}> = ToolCall<RegisteredTools<Registry>>;\n\ntype ToolOutcome<Registry extends Tools> = {\n  [Name in keyof Registry & string]: {\n    readonly id: string;\n    readonly tool: Name;\n  } & (\n    | {\n        readonly ok: true;\n        readonly value: Registry[Name][typeof capabilityTypes][\"output\"];\n      }\n    | { readonly ok: false; readonly error: { readonly code: string; readonly message: string } }\n  );\n}[keyof Registry & string];\n\n/** Input-order result or deliberately recoverable handler failure, including default tools. */\nexport type AgentOutcome<Registry extends Tools = {}> = ToolOutcome<RegisteredTools<Registry>>;\n\n/** A nonempty batch of independent calls, or the raw input to the final-result schema. */\nexport type AgentDecision<Registry extends Tools, Result> =\n  | {\n      readonly kind: \"continue\";\n      readonly calls: readonly [AgentCall<Registry>, ...AgentCall<Registry>[]];\n      readonly result?: never;\n    }\n  | { readonly kind: \"finish\"; readonly result: Result; readonly calls?: never };\n\n/** Finite limits for this agent and its descendants; child limits may only tighten them. */\nexport interface AgentLimits {\n  /** Decision callbacks, including finish. Defaults to 20. */\n  readonly maxTurns?: number;\n  /** Admitted subtree calls, including calls stopped before dispatch. Defaults to 100. */\n  readonly maxCalls?: number;\n  /** Subtree decision callback admissions. Defaults to 100; provider retries are application-owned. */\n  readonly maxDecisions?: number;\n  /** Pipeline-tool delegation edges below this agent. Defaults to 4; zero allows leaf tools only. */\n  readonly maxDepth?: number;\n  /** Active decision callbacks and leaf handlers across the subtree. Defaults to 1. */\n  readonly maxConcurrency?: number;\n}\n\n/** Step services and the workspace capability available to a registered tool. */\nexport interface AgentToolContext extends PipelineStepContext<{}> {\n  readonly environment: AgentEnvironment;\n  readonly execution?: AgentExecutionIdentity;\n}\n\n/** Model-facing descriptors and ordinary step services, without executable tools. */\nexport interface AgentDecisionContext<Options extends object> extends PipelineStepContext<Options> {\n  readonly environment: AgentEnvironment;\n  readonly execution?: AgentExecutionIdentity;\n  readonly turn: number;\n  readonly stateVersion: number;\n  readonly capabilities: readonly {\n    readonly name: string;\n    readonly description: string;\n    readonly inputJsonSchema: Readonly<Record<string, unknown>>;\n  }[];\n  readonly resultJsonSchema: Readonly<Record<string, unknown>>;\n}\n\nexport interface AgentDefinition<\n  Id extends string,\n  Options extends StandardSchemaV1<object, object>,\n  Result extends StandardSchemaV1,\n  State,\n  Registry extends Tools,\n> {\n  readonly id: Id;\n  readonly name?: string;\n  readonly description?: string;\n  /** Semantic revision; required when this agent uses or inherits durable recovery. */\n  readonly implementationVersion?: string;\n  readonly inputSchema: Options;\n  readonly resultSchema: Result;\n  readonly resultJsonSchema?: Readonly<Record<string, unknown>>;\n  /** Extend the standard tools; a custom tool with the same name replaces that default. */\n  readonly tools?: Registry;\n  readonly limits?: AgentLimits;\n  /** Workspace capabilities; descendants inherit them unless explicitly replaced. */\n  readonly environment?: AgentEnvironmentProvider;\n  /** Acknowledged recovery checkpoints; requires an explicit implementationVersion. */\n  readonly durability?: AgentDurability<Output<Options>>;\n  initialState(options: Output<Options>): State;\n  decide(\n    state: AgentState<NoInfer<State>>,\n    context: AgentDecisionContext<Output<Options>>\n  ): Awaitable<unknown>;\n  reduce?(\n    state: AgentState<NoInfer<State>>,\n    outcomes: readonly AgentOutcome<Registry>[]\n  ): NoInfer<State>;\n  dryRun?(\n    state: AgentState<NoInfer<State>>,\n    context: AgentDecisionContext<Output<Options>>\n  ): Awaitable<unknown>;\n}\n"]}
+{"version":3,"file":"agent-types.js","sourceRoot":"","sources":["../../src/agent/agent-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { PipelineStepContext, StandardSchemaV1 } from \"../core/pipeline-types.js\";\nimport type { AgentEnvironment, AgentEnvironmentProvider } from \"./environment.js\";\nimport type { AgentDurability, AgentExecutionIdentity } from \"./checkpoint-types.js\";\nimport type { DefaultAgentTools } from \"./default-tools.js\";\nimport type { CodemodeExecutor } from \"./codemode-executor.js\";\n\nexport type Awaitable<T> = T | Promise<T>;\nexport type Input<S extends StandardSchemaV1> = NonNullable<S[\"~standard\"][\"types\"]>[\"input\"];\nexport type Output<S extends StandardSchemaV1> = NonNullable<S[\"~standard\"][\"types\"]>[\"output\"];\n/** Deeply read-only view of the owned plain-data state supplied to agent callbacks. */\nexport type AgentState<T> = { readonly [K in keyof T]: AgentState<T[K]> };\ndeclare const capabilityTypes: unique symbol;\n\n/** Opaque capability created by defineTool or pipelineTool; model decisions contain data only. */\nexport interface AgentTool<Arguments, Result> {\n  readonly [capabilityTypes]: { readonly input: Arguments; readonly output: Result };\n}\n\nexport type Tools = Readonly<Record<string, AgentTool<unknown, unknown>>>;\n/** A standard workspace tool an agent's setup may select. */\nexport type DefaultAgentToolName = keyof DefaultAgentTools;\ntype RegisteredTools<Custom extends Tools, Defaults extends DefaultAgentToolName> = Omit<\n  Pick<DefaultAgentTools, Defaults>,\n  keyof Custom\n> &\n  Custom;\n\ntype ToolCall<Registry extends Tools> = {\n  [Name in keyof Registry & string]: {\n    readonly id: string;\n    readonly tool: Name;\n    readonly input: Registry[Name][typeof capabilityTypes][\"input\"];\n  };\n}[keyof Registry & string];\n\n/** A code-mode script's JSON return value and bounded console lines. */\nexport interface CodemodeResult {\n  readonly result: unknown;\n  readonly logs: readonly string[];\n  readonly logsTruncated: boolean;\n}\n\n/** Code-mode settings; the executor defaults to a Node worker thread. */\nexport interface CodemodeOptions {\n  /** Where scripts run, such as `createWorkerLoaderCodemodeExecutor` on Cloudflare. */\n  readonly executor?: CodemodeExecutor;\n}\n\n/** `true` or options enable code mode; `false` or omission advertises the registry. */\nexport type CodemodeSetting = boolean | CodemodeOptions;\ntype CodemodeEnabled<Setting extends CodemodeSetting> = Setting extends false ? false : true;\n\n/** The only capability a code-mode agent advertises; its scripts reach the registry. */\ntype CodemodeTools = {\n  readonly codemode: AgentTool<{ readonly code: string }, CodemodeResult>;\n};\n\n/**\n * One selected default or custom call with raw model arguments; custom names replace\n * defaults. With code mode, the only callable tool is `codemode`.\n */\nexport type AgentCall<\n  Registry extends Tools = {},\n  Codemode extends boolean = false,\n  Defaults extends DefaultAgentToolName = DefaultAgentToolName,\n> = Codemode extends true ? ToolCall<CodemodeTools> : ToolCall<RegisteredTools<Registry, Defaults>>;\n\ntype ToolOutcome<Registry extends Tools> = {\n  [Name in keyof Registry & string]: {\n    readonly id: string;\n    readonly tool: Name;\n  } & (\n    | {\n        readonly ok: true;\n        readonly value: Registry[Name][typeof capabilityTypes][\"output\"];\n      }\n    | { readonly ok: false; readonly error: { readonly code: string; readonly message: string } }\n  );\n}[keyof Registry & string];\n\n/** Input-order result or deliberately recoverable handler failure, including selected defaults. */\nexport type AgentOutcome<\n  Registry extends Tools = {},\n  Codemode extends boolean = false,\n  Defaults extends DefaultAgentToolName = DefaultAgentToolName,\n> = Codemode extends true\n  ? ToolOutcome<CodemodeTools>\n  : ToolOutcome<RegisteredTools<Registry, Defaults>>;\n\n/** A nonempty batch of independent calls, or the raw input to the final-result schema. */\nexport type AgentDecision<\n  Registry extends Tools,\n  Result,\n  Codemode extends boolean = false,\n  Defaults extends DefaultAgentToolName = DefaultAgentToolName,\n> =\n  | {\n      readonly kind: \"continue\";\n      readonly calls: readonly [\n        AgentCall<Registry, Codemode, Defaults>,\n        ...AgentCall<Registry, Codemode, Defaults>[],\n      ];\n      readonly result?: never;\n    }\n  | { readonly kind: \"finish\"; readonly result: Result; readonly calls?: never };\n\n/** Finite limits for this agent and its descendants; child limits may only tighten them. */\nexport interface AgentLimits {\n  /** Decision callbacks, including finish. Defaults to 20. */\n  readonly maxTurns?: number;\n  /** Admitted subtree calls, including calls stopped before dispatch. Defaults to 100. */\n  readonly maxCalls?: number;\n  /** Subtree decision callback admissions. Defaults to 100; provider retries are application-owned. */\n  readonly maxDecisions?: number;\n  /** Pipeline-tool delegation edges below this agent. Defaults to 4; zero allows leaf tools only. */\n  readonly maxDepth?: number;\n  /** Active decision callbacks and leaf handlers across the subtree. Defaults to 1. */\n  readonly maxConcurrency?: number;\n}\n\n/** Step services and the workspace capability available to a registered tool. */\nexport interface AgentToolContext extends PipelineStepContext<{}> {\n  readonly environment: AgentEnvironment;\n  readonly execution?: AgentExecutionIdentity;\n}\n\n/** Model-facing descriptors and ordinary step services, without executable tools. */\nexport interface AgentDecisionContext<Options extends object> extends PipelineStepContext<Options> {\n  readonly environment: AgentEnvironment;\n  readonly execution?: AgentExecutionIdentity;\n  readonly turn: number;\n  readonly stateVersion: number;\n  readonly capabilities: readonly {\n    readonly name: string;\n    readonly description: string;\n    readonly inputJsonSchema: Readonly<Record<string, unknown>>;\n  }[];\n  readonly resultJsonSchema: Readonly<Record<string, unknown>>;\n}\n\nexport interface AgentDefinition<\n  Id extends string,\n  Options extends StandardSchemaV1<object, object>,\n  Result extends StandardSchemaV1,\n  State,\n  Registry extends Tools,\n  Codemode extends CodemodeSetting = false,\n  Defaults extends DefaultAgentToolName = DefaultAgentToolName,\n> {\n  readonly id: Id;\n  readonly name?: string;\n  readonly description?: string;\n  /** Semantic revision; required when this agent uses or inherits durable recovery. */\n  readonly implementationVersion?: string;\n  readonly inputSchema: Options;\n  readonly resultSchema: Result;\n  readonly resultJsonSchema?: Readonly<Record<string, unknown>>;\n  /** Extend the selected standard tools; a custom tool with the same name replaces that default. */\n  readonly tools?: Registry;\n  /**\n   * Standard workspace tools this agent may use. Defaults to all of read, write, edit, bash,\n   * list and search; `[]` grants none, so only custom tools remain.\n   */\n  readonly defaultTools?: readonly Defaults[];\n  /**\n   * Advertise one `codemode` tool instead of the registry. Its JavaScript scripts call every\n   * registered tool; decisions and outcomes then name only `codemode`. Pass `{ executor }` to\n   * run scripts somewhere other than a Node worker thread. Defaults to false.\n   */\n  readonly codemode?: Codemode;\n  readonly limits?: AgentLimits;\n  /** Workspace capabilities; descendants inherit them unless explicitly replaced. */\n  readonly environment?: AgentEnvironmentProvider;\n  /** Acknowledged recovery checkpoints; requires an explicit implementationVersion. */\n  readonly durability?: AgentDurability<Output<Options>>;\n  initialState(options: Output<Options>): State;\n  decide(\n    state: AgentState<NoInfer<State>>,\n    context: AgentDecisionContext<Output<Options>>\n  ): Awaitable<unknown>;\n  reduce?(\n    state: AgentState<NoInfer<State>>,\n    outcomes: readonly AgentOutcome<Registry, CodemodeEnabled<Codemode>, Defaults>[]\n  ): NoInfer<State>;\n  dryRun?(\n    state: AgentState<NoInfer<State>>,\n    context: AgentDecisionContext<Output<Options>>\n  ): Awaitable<unknown>;\n}\n"]}

package/dist/agent/agent.d.ts

@@ -1,17 +1,19 @@
 import type { StandardSchemaV1 } from "../core/pipeline-types.js";
-import type { AgentDefinition, Tools } from "./agent-types.js";
+import type { AgentDefinition, CodemodeSetting, DefaultAgentToolName, Tools } from "./agent-types.js";
 export { pipelineTool } from "./pipeline-tool.js";
 export { defineTool, ToolError } from "./tools.js";
 export type { DefaultAgentTools } from "./default-tools.js";
-export type { AgentCall, AgentDecision, AgentDecisionContext, AgentLimits, AgentOutcome, AgentState, AgentTool, AgentToolContext, } from "./agent-types.js";
+export type { AgentCall, AgentDecision, AgentDecisionContext, AgentLimits, AgentOutcome, AgentState, AgentTool, AgentToolContext, CodemodeOptions, CodemodeResult, CodemodeSetting, DefaultAgentToolName, } from "./agent-types.js";
+export type { CodemodeExecution, CodemodeExecutionResult, CodemodeExecutor, CodemodeReply, } from "./codemode-executor.js";
 export type { AgentEnvironment, AgentEnvironmentContext, AgentEnvironmentProvider, AgentProjectInstruction, } from "./environment.js";
 export { createMemoryAgentCheckpointStore } from "./memory-checkpoint-store.js";
 export { plainAgentCheckpointCodec } from "./checkpoint-codec.js";
 export type { AgentCheckpointLease, AgentCheckpointStore, AgentCheckpointCodec, AgentDurability, AgentExecutionIdentity, } from "./checkpoint-types.js";
-export { defineModelAgent } from "./model-agent.js";
-export type { AgentModel, AgentModelRequest, AgentModelResponse } from "./model-types.js";
+export { defineAgent } from "./model-agent.js";
+export { createAgentSession, type AgentSession } from "./agent-session.js";
+export type { AgentModel, AgentModelDescriptors, AgentModelRequest, AgentModelResponse, } from "./model-types.js";
 /** Build a bounded in-process agent as an ordinary pipeline with one target, agent. */
-export declare function defineAgent<const Id extends string, const Options extends StandardSchemaV1<object, object>, const Result extends StandardSchemaV1, State, const Registry extends Tools = {}>(definition: AgentDefinition<Id, Options, Result, State, Registry>): import("../core/pipeline-types.js").Pipeline<import("./agent-types.js").Input<Options>, import("./agent-types.js").Output<Result>, "agent", "agent", Id> & {
+export declare function defineAgentLoop<const Id extends string, const Options extends StandardSchemaV1<object, object>, const Result extends StandardSchemaV1, State, const Registry extends Tools = {}, const Codemode extends CodemodeSetting = false, const Defaults extends DefaultAgentToolName = DefaultAgentToolName>(definition: AgentDefinition<Id, Options, Result, State, Registry, Codemode, Defaults>): import("../core/pipeline-types.js").Pipeline<import("./agent-types.js").Input<Options>, import("./agent-types.js").Output<Result>, "agent", "agent", Id> & {
     readonly optionsSchema: Options;
     readonly definition: import("../core/pipeline-types.js").PipelineDefinitionSnapshot;
 };

package/dist/agent/agent.js

@@ -4,9 +4,10 @@ export { pipelineTool } from "./pipeline-tool.js";
 export { defineTool, ToolError } from "./tools.js";
 export { createMemoryAgentCheckpointStore } from "./memory-checkpoint-store.js";
 export { plainAgentCheckpointCodec } from "./checkpoint-codec.js";
-export { defineModelAgent } from "./model-agent.js";
+export { defineAgent } from "./model-agent.js";
+export { createAgentSession } from "./agent-session.js";
 /** Build a bounded in-process agent as an ordinary pipeline with one target, agent. */
-export function defineAgent(definition) {
+export function defineAgentLoop(definition) {
     const { decide, dryRun } = definition;
     if (typeof decide !== "function" || (dryRun !== undefined && typeof dryRun !== "function"))
         throw agentError("TUBELESS_AGENT_INVALID_DEFINITION", "Agent requires callable decide/dryRun callbacks");

package/dist/agent/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAoBnD,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AASlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAMzB,UAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACtC,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC;QACxF,MAAM,UAAU,CACd,mCAAmC,EACnC,iDAAiD,CAClD,CAAC;IACJ,OAAO,YAAY,CAAuC;QACxD,GAAG,UAAU;QACb,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;QACrF,MAAM,EACJ,MAAM,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;KAC5F,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { StandardSchemaV1 } from \"../core/pipeline-types.js\";\nimport type { AgentDefinition, Tools } from \"./agent-types.js\";\nimport { agentError } from \"./agent-state.js\";\nimport { compileAgent } from \"./compile-agent.js\";\n\nexport { pipelineTool } from \"./pipeline-tool.js\";\nexport { defineTool, ToolError } from \"./tools.js\";\nexport type { DefaultAgentTools } from \"./default-tools.js\";\nexport type {\n  AgentCall,\n  AgentDecision,\n  AgentDecisionContext,\n  AgentLimits,\n  AgentOutcome,\n  AgentState,\n  AgentTool,\n  AgentToolContext,\n} from \"./agent-types.js\";\n\nexport type {\n  AgentEnvironment,\n  AgentEnvironmentContext,\n  AgentEnvironmentProvider,\n  AgentProjectInstruction,\n} from \"./environment.js\";\n\nexport { createMemoryAgentCheckpointStore } from \"./memory-checkpoint-store.js\";\nexport { plainAgentCheckpointCodec } from \"./checkpoint-codec.js\";\nexport type {\n  AgentCheckpointLease,\n  AgentCheckpointStore,\n  AgentCheckpointCodec,\n  AgentDurability,\n  AgentExecutionIdentity,\n} from \"./checkpoint-types.js\";\n\nexport { defineModelAgent } from \"./model-agent.js\";\nexport type { AgentModel, AgentModelRequest, AgentModelResponse } from \"./model-types.js\";\n\n/** Build a bounded in-process agent as an ordinary pipeline with one target, agent. */\nexport function defineAgent<\n  const Id extends string,\n  const Options extends StandardSchemaV1<object, object>,\n  const Result extends StandardSchemaV1,\n  State,\n  const Registry extends Tools = {},\n>(definition: AgentDefinition<Id, Options, Result, State, Registry>) {\n  const { decide, dryRun } = definition;\n  if (typeof decide !== \"function\" || (dryRun !== undefined && typeof dryRun !== \"function\"))\n    throw agentError(\n      \"TUBELESS_AGENT_INVALID_DEFINITION\",\n      \"Agent requires callable decide/dryRun callbacks\"\n    );\n  return compileAgent<Id, Options, Result, State, Registry>({\n    ...definition,\n    decide: async (state, context) => ({ decision: await decide(state, context), state }),\n    dryRun:\n      dryRun && (async (state, context) => ({ decision: await dryRun(state, context), state })),\n  });\n}\n"]}
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8BnD,OAAO,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AASlE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAQ3E,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAQ7B,UAAqF;IACrF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IACtC,IAAI,OAAO,MAAM,KAAK,UAAU,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,UAAU,CAAC;QACxF,MAAM,UAAU,CACd,mCAAmC,EACnC,iDAAiD,CAClD,CAAC;IACJ,OAAO,YAAY,CAA2D;QAC5E,GAAG,UAAU;QACb,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;QACrF,MAAM,EACJ,MAAM,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;KAC5F,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { StandardSchemaV1 } from \"../core/pipeline-types.js\";\nimport type {\n  AgentDefinition,\n  CodemodeSetting,\n  DefaultAgentToolName,\n  Tools,\n} from \"./agent-types.js\";\nimport { agentError } from \"./agent-state.js\";\nimport { compileAgent } from \"./compile-agent.js\";\n\nexport { pipelineTool } from \"./pipeline-tool.js\";\nexport { defineTool, ToolError } from \"./tools.js\";\nexport type { DefaultAgentTools } from \"./default-tools.js\";\nexport type {\n  AgentCall,\n  AgentDecision,\n  AgentDecisionContext,\n  AgentLimits,\n  AgentOutcome,\n  AgentState,\n  AgentTool,\n  AgentToolContext,\n  CodemodeOptions,\n  CodemodeResult,\n  CodemodeSetting,\n  DefaultAgentToolName,\n} from \"./agent-types.js\";\nexport type {\n  CodemodeExecution,\n  CodemodeExecutionResult,\n  CodemodeExecutor,\n  CodemodeReply,\n} from \"./codemode-executor.js\";\n\nexport type {\n  AgentEnvironment,\n  AgentEnvironmentContext,\n  AgentEnvironmentProvider,\n  AgentProjectInstruction,\n} from \"./environment.js\";\n\nexport { createMemoryAgentCheckpointStore } from \"./memory-checkpoint-store.js\";\nexport { plainAgentCheckpointCodec } from \"./checkpoint-codec.js\";\nexport type {\n  AgentCheckpointLease,\n  AgentCheckpointStore,\n  AgentCheckpointCodec,\n  AgentDurability,\n  AgentExecutionIdentity,\n} from \"./checkpoint-types.js\";\n\nexport { defineAgent } from \"./model-agent.js\";\nexport { createAgentSession, type AgentSession } from \"./agent-session.js\";\nexport type {\n  AgentModel,\n  AgentModelDescriptors,\n  AgentModelRequest,\n  AgentModelResponse,\n} from \"./model-types.js\";\n\n/** Build a bounded in-process agent as an ordinary pipeline with one target, agent. */\nexport function defineAgentLoop<\n  const Id extends string,\n  const Options extends StandardSchemaV1<object, object>,\n  const Result extends StandardSchemaV1,\n  State,\n  const Registry extends Tools = {},\n  const Codemode extends CodemodeSetting = false,\n  const Defaults extends DefaultAgentToolName = DefaultAgentToolName,\n>(definition: AgentDefinition<Id, Options, Result, State, Registry, Codemode, Defaults>) {\n  const { decide, dryRun } = definition;\n  if (typeof decide !== \"function\" || (dryRun !== undefined && typeof dryRun !== \"function\"))\n    throw agentError(\n      \"TUBELESS_AGENT_INVALID_DEFINITION\",\n      \"Agent requires callable decide/dryRun callbacks\"\n    );\n  return compileAgent<Id, Options, Result, State, Registry, Codemode, Defaults>({\n    ...definition,\n    decide: async (state, context) => ({ decision: await decide(state, context), state }),\n    dryRun:\n      dryRun && (async (state, context) => ({ decision: await dryRun(state, context), state })),\n  });\n}\n"]}

package/dist/agent/anthropic.js

@@ -32,17 +32,14 @@ export function anthropicModel(options = {}) {
         throw new Error("Invalid Anthropic model configuration");
     if (baseUrl !== undefined)
         providerBaseUrl("Anthropic", baseUrl);
-    return async (request, context) => {
+    const decide = async (request, context) => {
         const selectedModel = (model ?? process.env.ANTHROPIC_MODEL)?.trim() || "claude-opus-5-5";
         const timeout = AbortSignal.timeout(timeoutMs);
         const signal = context.signal ? AbortSignal.any([context.signal, timeout]) : timeout;
         const base = providerBaseUrl("Anthropic", baseUrl ?? (process.env.ANTHROPIC_BASE_URL?.trim() || DEFAULT_BASE_URL));
         throwIfAborted(signal, "Anthropic decision");
         // Validate descriptors before either compaction or a decision can perform I/O.
-        const tools = [
-            ...context.capabilities.map((tool) => anthropicTool(tool.name, tool.description, "input", tool.inputJsonSchema, strict)),
-            anthropicTool("_finish", "Finish with the final answer.", "result", context.resultJsonSchema, strict),
-        ];
+        const tools = anthropicTools(context, strict);
         if (request.conversation !== null &&
             (!Array.isArray(request.conversation) || !request.conversation.every(record)))
             throw new Error("Invalid Anthropic conversation state");
@@ -155,6 +152,20 @@ export function anthropicModel(options = {}) {
             messages = [...messages, { role: "user", content: TOOL_RULE }];
         }
     };
+    return Object.assign(decide, {
+        checkDescriptors: (descriptors) => void anthropicTools(descriptors, strict),
+    });
+}
+// Strict mode accepts at most this many strict tools per request, including _finish.
+const MAX_STRICT_TOOLS = 20;
+/** Messages API tools for these descriptors, plus the adapter-only `_finish` tool. */
+function anthropicTools({ capabilities, resultJsonSchema }, strict) {
+    if (strict && capabilities.length + 1 > MAX_STRICT_TOOLS)
+        throw new Error(`Anthropic strict mode allows at most ${MAX_STRICT_TOOLS} tools per request, including _finish; this agent has ${capabilities.length + 1}. Set strict: false, or advertise fewer tools with defaultTools, allowlists or codemode`);
+    return [
+        ...capabilities.map((tool) => anthropicTool(tool.name, tool.description, "input", tool.inputJsonSchema, strict)),
+        anthropicTool("_finish", "Finish with the final answer.", "result", resultJsonSchema, strict),
+    ];
 }
 /** Pair each pending `_finish` call with a tool_result so the next user prompt is valid. */
 function closeFinishedTools(messages) {

package/dist/agent/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/agent/anthropic.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentModel } from \"./model-types.js\";\nimport {\n  anthropicDecision,\n  anthropicMessage,\n  anthropicTool,\n  carriesCompaction,\n  COMPACTION_BETA,\n} from \"./anthropic-protocol.js\";\nimport { MAX_REQUEST_BYTES, providerBaseUrl, providerRequest } from \"./provider-http.js\";\nimport { record } from \"./provider-schema.js\";\nimport { boundedToolOutputs } from \"./provider-tool-outputs.js\";\nimport { throwIfAborted } from \"../utilities/abort.js\";\n\n/** Messages API transport settings; credentials are resolved only when a decision executes. */\nexport interface AnthropicModelOptions {\n  /** Defaults to ANTHROPIC_MODEL or claude-opus-5-5. Must support tool use. */\n  readonly model?: string;\n  /**\n   * Sent as x-api-key. Without an explicit apiKey or authToken, ANTHROPIC_API_KEY is\n   * used at execution time, then ANTHROPIC_AUTH_TOKEN.\n   */\n  readonly apiKey?: string;\n  /** Sent as Authorization: Bearer, for compatible servers and gateways that expect it. */\n  readonly authToken?: string;\n  /**\n   * API root without the version path. Defaults to ANTHROPIC_BASE_URL or\n   * https://api.anthropic.com; set it for any server that implements the Messages API.\n   */\n  readonly baseUrl?: string;\n  /** Sent as output_config.effort. Omitted by default; null also omits it. */\n  readonly reasoningEffort?: \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\" | null;\n  /** Output cap for each request, including thinking; defaults to 32000 tokens. */\n  readonly maxTokens?: number;\n  /**\n   * Send tools with strict: true (default). Unsupported constraints move into descriptions;\n   * the harness still validates every argument. Disable for servers without strict tool use.\n   */\n  readonly strict?: boolean;\n  /** Send top-level cache_control (default). Disable for servers that reject it. */\n  readonly promptCaching?: boolean;\n  /**\n   * Compact above this history size (default 65536 bytes), or when the complete decision\n   * exceeds the request limit. null never requests on-demand compaction.\n   */\n  readonly compactAfterBytes?: number | null;\n  /** Combined deadline for compaction and decision requests; defaults to 600000 ms. */\n  readonly timeoutMs?: number;\n}\n\nconst DEFAULT_BASE_URL = \"https://api.anthropic.com\";\nconst EFFORTS = [\"low\", \"medium\", \"high\", \"xhigh\", \"max\"];\nconst TOOL_RULE =\n  \"Respond only by calling tools. Call _finish alone with the final answer. Never mix _finish with tool calls.\";\nconst SUMMARY_INSTRUCTIONS =\n  \"Summarize this agent conversation so the agent can continue the task. Preserve the task, decisions, file paths, commands run, verified results, failures, and remaining work. Do not call tools; respond with the summary text only.\";\n// `{\"role\":\"user\",\"content\":[]}` plus a separator, rounded up.\nconst RESULT_MESSAGE_BYTES = 64;\n\n/** Create a dependency-free Anthropic Messages model with native history and on-demand compaction. */\nexport function anthropicModel(options: AnthropicModelOptions = {}): AgentModel {\n  const {\n    model,\n    apiKey,\n    authToken,\n    baseUrl,\n    reasoningEffort = null,\n    maxTokens = 32_000,\n    strict = true,\n    promptCaching = true,\n    compactAfterBytes = 65_536,\n    timeoutMs = 600_000,\n  } = options;\n  if (\n    (compactAfterBytes !== null &&\n      (!Number.isSafeInteger(compactAfterBytes) ||\n        compactAfterBytes < 1 ||\n        compactAfterBytes >= MAX_REQUEST_BYTES)) ||\n    !Number.isSafeInteger(maxTokens) ||\n    maxTokens < 1 ||\n    !Number.isSafeInteger(timeoutMs) ||\n    timeoutMs < 1 ||\n    timeoutMs > 2_147_483_647 ||\n    typeof strict !== \"boolean\" ||\n    typeof promptCaching !== \"boolean\" ||\n    (apiKey !== undefined && authToken !== undefined) ||\n    (authToken !== undefined && (typeof authToken !== \"string\" || !authToken.trim())) ||\n    (model !== undefined && (typeof model !== \"string\" || !model.trim())) ||\n    (apiKey !== undefined && (typeof apiKey !== \"string\" || !apiKey.trim())) ||\n    (baseUrl !== undefined && typeof baseUrl !== \"string\") ||\n    (reasoningEffort !== null && !EFFORTS.includes(reasoningEffort))\n  )\n    throw new Error(\"Invalid Anthropic model configuration\");\n  if (baseUrl !== undefined) providerBaseUrl(\"Anthropic\", baseUrl);\n  return async (request, context) => {\n    const selectedModel = (model ?? process.env.ANTHROPIC_MODEL)?.trim() || \"claude-opus-5-5\";\n    const timeout = AbortSignal.timeout(timeoutMs);\n    const signal = context.signal ? AbortSignal.any([context.signal, timeout]) : timeout;\n    const base = providerBaseUrl(\n      \"Anthropic\",\n      baseUrl ?? (process.env.ANTHROPIC_BASE_URL?.trim() || DEFAULT_BASE_URL)\n    );\n    throwIfAborted(signal, \"Anthropic decision\");\n    // Validate descriptors before either compaction or a decision can perform I/O.\n    const tools = [\n      ...context.capabilities.map((tool) =>\n        anthropicTool(tool.name, tool.description, \"input\", tool.inputJsonSchema, strict)\n      ),\n      anthropicTool(\n        \"_finish\",\n        \"Finish with the final answer.\",\n        \"result\",\n        context.resultJsonSchema,\n        strict\n      ),\n    ];\n    if (\n      request.conversation !== null &&\n      (!Array.isArray(request.conversation) || !request.conversation.every(record))\n    )\n      throw new Error(\"Invalid Anthropic conversation state\");\n    // A restored session starts a new prompt with no tool outcomes. Close _finish\n    // before appending that prompt; the Messages API rejects a second user message.\n    const newPrompt = context.turn === 1 && request.outcomes.length === 0;\n    let messages: unknown[] =\n      request.conversation === null\n        ? []\n        : newPrompt\n          ? closeFinishedTools(request.conversation)\n          : [...request.conversation];\n    const withPrompt = (history: readonly unknown[]) =>\n      newPrompt ? appendUserText(history, request.task) : [...history];\n    const send = (endpointLabel: string, payload: { messages: unknown[] }, beta: boolean) =>\n      providerRequest(\n        \"Anthropic\",\n        endpointLabel,\n        `${base}/v1/messages`,\n        {\n          ...credentials(apiKey, authToken),\n          \"anthropic-version\": \"2023-06-01\",\n          ...(beta || carriesCompaction(payload.messages)\n            ? { \"anthropic-beta\": COMPACTION_BETA }\n            : {}),\n        },\n        payload,\n        signal\n      );\n    const system = `${request.instructions}\\n\\n${TOOL_RULE}`;\n    // Summaries read the same system prompt and tools as the conversation.\n    const compactRequest = {\n      model: selectedModel,\n      max_tokens: maxTokens,\n      system,\n      tools,\n      compaction: { type: \"summarize\", instructions: SUMMARY_INSTRUCTIONS },\n      messages,\n    };\n    const decisionRequest = {\n      model: selectedModel,\n      max_tokens: maxTokens,\n      ...(reasoningEffort === null ? {} : { output_config: { effort: reasoningEffort } }),\n      ...(promptCaching ? { cache_control: { type: \"ephemeral\" } } : {}),\n      system,\n      tools,\n      // Current models reject forced tool choice; the system rule and retry below steer instead.\n      tool_choice: { type: \"auto\" },\n      messages,\n    };\n    const results = (availableBytes: number) =>\n      request.outcomes.length === 0\n        ? []\n        : [\n            {\n              role: \"user\",\n              content: boundedToolOutputs(\n                \"Anthropic\",\n                request.outcomes,\n                availableBytes - RESULT_MESSAGE_BYTES,\n                (outcome, output) => ({\n                  type: \"tool_result\",\n                  tool_use_id: outcome.id,\n                  content: output,\n                  ...(outcome.ok ? {} : { is_error: true }),\n                })\n              ),\n            },\n          ];\n    const history = [...messages, ...results(MAX_REQUEST_BYTES)];\n    const completed = withPrompt(history);\n    const shouldCompact =\n      compactAfterBytes !== null &&\n      (request.outcomes.length > 0 || (newPrompt && request.conversation !== null)) &&\n      (Buffer.byteLength(JSON.stringify(completed)) > compactAfterBytes ||\n        Buffer.byteLength(JSON.stringify({ ...decisionRequest, messages: completed })) >\n          MAX_REQUEST_BYTES);\n    // Compaction covers completed history only. The new prompt stays verbatim.\n    const nextRequest = shouldCompact ? compactRequest : decisionRequest;\n    const payload = shouldCompact ? history : completed;\n    const fits =\n      Buffer.byteLength(JSON.stringify({ ...nextRequest, messages: payload })) <= MAX_REQUEST_BYTES;\n    messages = fits\n      ? payload\n      : [\n          ...messages,\n          ...results(MAX_REQUEST_BYTES - Buffer.byteLength(JSON.stringify(nextRequest))),\n        ];\n    if (shouldCompact) {\n      const summary = anthropicMessage(\n        await send(\"compaction\", { ...compactRequest, messages }, true)\n      );\n      const [block] = summary.content;\n      if (\n        summary.stopReason === \"compaction\" &&\n        summary.content.length === 1 &&\n        block?.type === \"compaction\" &&\n        typeof block.content === \"string\" &&\n        typeof block.signature === \"string\"\n      ) {\n        // The returned assistant message replaces every message it covered, unchanged.\n        // The summarized history ended with tool results, so a user turn must follow it.\n        messages = [\n          { role: \"assistant\", content: [block] },\n          { role: \"user\", content: \"Continue the task from this summary.\" },\n        ];\n        context.log.log(\"Compacted agent conversation\");\n      } else {\n        context.log.log(`Anthropic compaction returned no summary (${summary.stopReason})`);\n      }\n    }\n    if (newPrompt && (shouldCompact || !fits)) messages = withPrompt(messages);\n    for (let attempt = 0; ; attempt++) {\n      const response = anthropicMessage(\n        await send(\"messages\", { ...decisionRequest, messages }, false)\n      );\n      if (response.stopReason === \"max_tokens\")\n        throw new Error(\"Anthropic response reached max_tokens; raise maxTokens\");\n      if (response.stopReason === \"refusal\") throw new Error(\"Anthropic refused the request\");\n      if (response.stopReason !== \"tool_use\" && response.stopReason !== \"end_turn\")\n        throw new Error(`Anthropic stopped unexpectedly (${response.stopReason})`);\n      if (response.content.length === 0) throw new Error(\"Anthropic returned empty content\");\n      // Keep every block, including thinking and signatures, exactly as returned.\n      messages = [...messages, { role: \"assistant\", content: response.content }];\n      const decision = anthropicDecision(response.content);\n      if (decision) return { decision, conversation: messages };\n      if (attempt > 0) throw new Error(\"Anthropic returned no tool calls\");\n      messages = [...messages, { role: \"user\", content: TOOL_RULE }];\n    }\n  };\n}\n\n/** Pair each pending `_finish` call with a tool_result so the next user prompt is valid. */\nfunction closeFinishedTools(messages: readonly unknown[]): unknown[] {\n  const last = messages.at(-1);\n  if (!record(last) || last.role !== \"assistant\" || !Array.isArray(last.content))\n    return [...messages];\n  const uses = last.content.filter((block) => record(block) && block.type === \"tool_use\");\n  if (uses.length === 0) return [...messages];\n  if (uses.some((block) => block.name !== \"_finish\"))\n    throw new Error(\"Anthropic conversation has unfinished tool calls\");\n  return [\n    ...messages,\n    {\n      role: \"user\",\n      content: uses.map((block) => ({\n        type: \"tool_result\",\n        tool_use_id: block.id,\n        content: JSON.stringify(\n          record(block.input) && Object.hasOwn(block.input, \"result\")\n            ? block.input.result\n            : block.input\n        ),\n      })),\n    },\n  ];\n}\n\n/** Add a user prompt, extending a trailing user message so roles keep alternating. */\nfunction appendUserText(messages: readonly unknown[], text: string): unknown[] {\n  const last = messages.at(-1);\n  if (record(last) && last.role === \"user\") {\n    const content = Array.isArray(last.content)\n      ? [...last.content, { type: \"text\", text }]\n      : [\n          { type: \"text\", text: last.content },\n          { type: \"text\", text },\n        ];\n    return [...messages.slice(0, -1), { role: \"user\", content }];\n  }\n  return [...messages, { role: \"user\", content: text }];\n}\n\nfunction credentials(\n  apiKey: string | undefined,\n  authToken: string | undefined\n): Record<string, string> {\n  if (authToken !== undefined) return { Authorization: `Bearer ${authToken.trim()}` };\n  const key = (apiKey ?? process.env.ANTHROPIC_API_KEY)?.trim();\n  if (key) return { \"x-api-key\": key };\n  const token = process.env.ANTHROPIC_AUTH_TOKEN?.trim();\n  if (token) return { Authorization: `Bearer ${token}` };\n  throw new Error(\"ANTHROPIC_API_KEY or ANTHROPIC_AUTH_TOKEN is required for live model execution\");\n}\n"]}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/agent/anthropic.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentModel, AgentModelDescriptors } from \"./model-types.js\";\nimport {\n  anthropicDecision,\n  anthropicMessage,\n  anthropicTool,\n  carriesCompaction,\n  COMPACTION_BETA,\n} from \"./anthropic-protocol.js\";\nimport { MAX_REQUEST_BYTES, providerBaseUrl, providerRequest } from \"./provider-http.js\";\nimport { record } from \"./provider-schema.js\";\nimport { boundedToolOutputs } from \"./provider-tool-outputs.js\";\nimport { throwIfAborted } from \"../utilities/abort.js\";\n\n/** Messages API transport settings; credentials are resolved only when a decision executes. */\nexport interface AnthropicModelOptions {\n  /** Defaults to ANTHROPIC_MODEL or claude-opus-5-5. Must support tool use. */\n  readonly model?: string;\n  /**\n   * Sent as x-api-key. Without an explicit apiKey or authToken, ANTHROPIC_API_KEY is\n   * used at execution time, then ANTHROPIC_AUTH_TOKEN.\n   */\n  readonly apiKey?: string;\n  /** Sent as Authorization: Bearer, for compatible servers and gateways that expect it. */\n  readonly authToken?: string;\n  /**\n   * API root without the version path. Defaults to ANTHROPIC_BASE_URL or\n   * https://api.anthropic.com; set it for any server that implements the Messages API.\n   */\n  readonly baseUrl?: string;\n  /** Sent as output_config.effort. Omitted by default; null also omits it. */\n  readonly reasoningEffort?: \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\" | null;\n  /** Output cap for each request, including thinking; defaults to 32000 tokens. */\n  readonly maxTokens?: number;\n  /**\n   * Send tools with strict: true (default). Unsupported constraints move into descriptions;\n   * the harness still validates every argument. Disable for servers without strict tool use.\n   */\n  readonly strict?: boolean;\n  /** Send top-level cache_control (default). Disable for servers that reject it. */\n  readonly promptCaching?: boolean;\n  /**\n   * Compact above this history size (default 65536 bytes), or when the complete decision\n   * exceeds the request limit. null never requests on-demand compaction.\n   */\n  readonly compactAfterBytes?: number | null;\n  /** Combined deadline for compaction and decision requests; defaults to 600000 ms. */\n  readonly timeoutMs?: number;\n}\n\nconst DEFAULT_BASE_URL = \"https://api.anthropic.com\";\nconst EFFORTS = [\"low\", \"medium\", \"high\", \"xhigh\", \"max\"];\nconst TOOL_RULE =\n  \"Respond only by calling tools. Call _finish alone with the final answer. Never mix _finish with tool calls.\";\nconst SUMMARY_INSTRUCTIONS =\n  \"Summarize this agent conversation so the agent can continue the task. Preserve the task, decisions, file paths, commands run, verified results, failures, and remaining work. Do not call tools; respond with the summary text only.\";\n// `{\"role\":\"user\",\"content\":[]}` plus a separator, rounded up.\nconst RESULT_MESSAGE_BYTES = 64;\n\n/** Create a dependency-free Anthropic Messages model with native history and on-demand compaction. */\nexport function anthropicModel(options: AnthropicModelOptions = {}): AgentModel {\n  const {\n    model,\n    apiKey,\n    authToken,\n    baseUrl,\n    reasoningEffort = null,\n    maxTokens = 32_000,\n    strict = true,\n    promptCaching = true,\n    compactAfterBytes = 65_536,\n    timeoutMs = 600_000,\n  } = options;\n  if (\n    (compactAfterBytes !== null &&\n      (!Number.isSafeInteger(compactAfterBytes) ||\n        compactAfterBytes < 1 ||\n        compactAfterBytes >= MAX_REQUEST_BYTES)) ||\n    !Number.isSafeInteger(maxTokens) ||\n    maxTokens < 1 ||\n    !Number.isSafeInteger(timeoutMs) ||\n    timeoutMs < 1 ||\n    timeoutMs > 2_147_483_647 ||\n    typeof strict !== \"boolean\" ||\n    typeof promptCaching !== \"boolean\" ||\n    (apiKey !== undefined && authToken !== undefined) ||\n    (authToken !== undefined && (typeof authToken !== \"string\" || !authToken.trim())) ||\n    (model !== undefined && (typeof model !== \"string\" || !model.trim())) ||\n    (apiKey !== undefined && (typeof apiKey !== \"string\" || !apiKey.trim())) ||\n    (baseUrl !== undefined && typeof baseUrl !== \"string\") ||\n    (reasoningEffort !== null && !EFFORTS.includes(reasoningEffort))\n  )\n    throw new Error(\"Invalid Anthropic model configuration\");\n  if (baseUrl !== undefined) providerBaseUrl(\"Anthropic\", baseUrl);\n  const decide: AgentModel = async (request, context) => {\n    const selectedModel = (model ?? process.env.ANTHROPIC_MODEL)?.trim() || \"claude-opus-5-5\";\n    const timeout = AbortSignal.timeout(timeoutMs);\n    const signal = context.signal ? AbortSignal.any([context.signal, timeout]) : timeout;\n    const base = providerBaseUrl(\n      \"Anthropic\",\n      baseUrl ?? (process.env.ANTHROPIC_BASE_URL?.trim() || DEFAULT_BASE_URL)\n    );\n    throwIfAborted(signal, \"Anthropic decision\");\n    // Validate descriptors before either compaction or a decision can perform I/O.\n    const tools = anthropicTools(context, strict);\n    if (\n      request.conversation !== null &&\n      (!Array.isArray(request.conversation) || !request.conversation.every(record))\n    )\n      throw new Error(\"Invalid Anthropic conversation state\");\n    // A restored session starts a new prompt with no tool outcomes. Close _finish\n    // before appending that prompt; the Messages API rejects a second user message.\n    const newPrompt = context.turn === 1 && request.outcomes.length === 0;\n    let messages: unknown[] =\n      request.conversation === null\n        ? []\n        : newPrompt\n          ? closeFinishedTools(request.conversation)\n          : [...request.conversation];\n    const withPrompt = (history: readonly unknown[]) =>\n      newPrompt ? appendUserText(history, request.task) : [...history];\n    const send = (endpointLabel: string, payload: { messages: unknown[] }, beta: boolean) =>\n      providerRequest(\n        \"Anthropic\",\n        endpointLabel,\n        `${base}/v1/messages`,\n        {\n          ...credentials(apiKey, authToken),\n          \"anthropic-version\": \"2023-06-01\",\n          ...(beta || carriesCompaction(payload.messages)\n            ? { \"anthropic-beta\": COMPACTION_BETA }\n            : {}),\n        },\n        payload,\n        signal\n      );\n    const system = `${request.instructions}\\n\\n${TOOL_RULE}`;\n    // Summaries read the same system prompt and tools as the conversation.\n    const compactRequest = {\n      model: selectedModel,\n      max_tokens: maxTokens,\n      system,\n      tools,\n      compaction: { type: \"summarize\", instructions: SUMMARY_INSTRUCTIONS },\n      messages,\n    };\n    const decisionRequest = {\n      model: selectedModel,\n      max_tokens: maxTokens,\n      ...(reasoningEffort === null ? {} : { output_config: { effort: reasoningEffort } }),\n      ...(promptCaching ? { cache_control: { type: \"ephemeral\" } } : {}),\n      system,\n      tools,\n      // Current models reject forced tool choice; the system rule and retry below steer instead.\n      tool_choice: { type: \"auto\" },\n      messages,\n    };\n    const results = (availableBytes: number) =>\n      request.outcomes.length === 0\n        ? []\n        : [\n            {\n              role: \"user\",\n              content: boundedToolOutputs(\n                \"Anthropic\",\n                request.outcomes,\n                availableBytes - RESULT_MESSAGE_BYTES,\n                (outcome, output) => ({\n                  type: \"tool_result\",\n                  tool_use_id: outcome.id,\n                  content: output,\n                  ...(outcome.ok ? {} : { is_error: true }),\n                })\n              ),\n            },\n          ];\n    const history = [...messages, ...results(MAX_REQUEST_BYTES)];\n    const completed = withPrompt(history);\n    const shouldCompact =\n      compactAfterBytes !== null &&\n      (request.outcomes.length > 0 || (newPrompt && request.conversation !== null)) &&\n      (Buffer.byteLength(JSON.stringify(completed)) > compactAfterBytes ||\n        Buffer.byteLength(JSON.stringify({ ...decisionRequest, messages: completed })) >\n          MAX_REQUEST_BYTES);\n    // Compaction covers completed history only. The new prompt stays verbatim.\n    const nextRequest = shouldCompact ? compactRequest : decisionRequest;\n    const payload = shouldCompact ? history : completed;\n    const fits =\n      Buffer.byteLength(JSON.stringify({ ...nextRequest, messages: payload })) <= MAX_REQUEST_BYTES;\n    messages = fits\n      ? payload\n      : [\n          ...messages,\n          ...results(MAX_REQUEST_BYTES - Buffer.byteLength(JSON.stringify(nextRequest))),\n        ];\n    if (shouldCompact) {\n      const summary = anthropicMessage(\n        await send(\"compaction\", { ...compactRequest, messages }, true)\n      );\n      const [block] = summary.content;\n      if (\n        summary.stopReason === \"compaction\" &&\n        summary.content.length === 1 &&\n        block?.type === \"compaction\" &&\n        typeof block.content === \"string\" &&\n        typeof block.signature === \"string\"\n      ) {\n        // The returned assistant message replaces every message it covered, unchanged.\n        // The summarized history ended with tool results, so a user turn must follow it.\n        messages = [\n          { role: \"assistant\", content: [block] },\n          { role: \"user\", content: \"Continue the task from this summary.\" },\n        ];\n        context.log.log(\"Compacted agent conversation\");\n      } else {\n        context.log.log(`Anthropic compaction returned no summary (${summary.stopReason})`);\n      }\n    }\n    if (newPrompt && (shouldCompact || !fits)) messages = withPrompt(messages);\n    for (let attempt = 0; ; attempt++) {\n      const response = anthropicMessage(\n        await send(\"messages\", { ...decisionRequest, messages }, false)\n      );\n      if (response.stopReason === \"max_tokens\")\n        throw new Error(\"Anthropic response reached max_tokens; raise maxTokens\");\n      if (response.stopReason === \"refusal\") throw new Error(\"Anthropic refused the request\");\n      if (response.stopReason !== \"tool_use\" && response.stopReason !== \"end_turn\")\n        throw new Error(`Anthropic stopped unexpectedly (${response.stopReason})`);\n      if (response.content.length === 0) throw new Error(\"Anthropic returned empty content\");\n      // Keep every block, including thinking and signatures, exactly as returned.\n      messages = [...messages, { role: \"assistant\", content: response.content }];\n      const decision = anthropicDecision(response.content);\n      if (decision) return { decision, conversation: messages };\n      if (attempt > 0) throw new Error(\"Anthropic returned no tool calls\");\n      messages = [...messages, { role: \"user\", content: TOOL_RULE }];\n    }\n  };\n  return Object.assign(decide, {\n    checkDescriptors: (descriptors: AgentModelDescriptors) =>\n      void anthropicTools(descriptors, strict),\n  });\n}\n\n// Strict mode accepts at most this many strict tools per request, including _finish.\nconst MAX_STRICT_TOOLS = 20;\n\n/** Messages API tools for these descriptors, plus the adapter-only `_finish` tool. */\nfunction anthropicTools(\n  { capabilities, resultJsonSchema }: AgentModelDescriptors,\n  strict: boolean\n) {\n  if (strict && capabilities.length + 1 > MAX_STRICT_TOOLS)\n    throw new Error(\n      `Anthropic strict mode allows at most ${MAX_STRICT_TOOLS} tools per request, including _finish; this agent has ${capabilities.length + 1}. Set strict: false, or advertise fewer tools with defaultTools, allowlists or codemode`\n    );\n  return [\n    ...capabilities.map((tool) =>\n      anthropicTool(tool.name, tool.description, \"input\", tool.inputJsonSchema, strict)\n    ),\n    anthropicTool(\"_finish\", \"Finish with the final answer.\", \"result\", resultJsonSchema, strict),\n  ];\n}\n\n/** Pair each pending `_finish` call with a tool_result so the next user prompt is valid. */\nfunction closeFinishedTools(messages: readonly unknown[]): unknown[] {\n  const last = messages.at(-1);\n  if (!record(last) || last.role !== \"assistant\" || !Array.isArray(last.content))\n    return [...messages];\n  const uses = last.content.filter((block) => record(block) && block.type === \"tool_use\");\n  if (uses.length === 0) return [...messages];\n  if (uses.some((block) => block.name !== \"_finish\"))\n    throw new Error(\"Anthropic conversation has unfinished tool calls\");\n  return [\n    ...messages,\n    {\n      role: \"user\",\n      content: uses.map((block) => ({\n        type: \"tool_result\",\n        tool_use_id: block.id,\n        content: JSON.stringify(\n          record(block.input) && Object.hasOwn(block.input, \"result\")\n            ? block.input.result\n            : block.input\n        ),\n      })),\n    },\n  ];\n}\n\n/** Add a user prompt, extending a trailing user message so roles keep alternating. */\nfunction appendUserText(messages: readonly unknown[], text: string): unknown[] {\n  const last = messages.at(-1);\n  if (record(last) && last.role === \"user\") {\n    const content = Array.isArray(last.content)\n      ? [...last.content, { type: \"text\", text }]\n      : [\n          { type: \"text\", text: last.content },\n          { type: \"text\", text },\n        ];\n    return [...messages.slice(0, -1), { role: \"user\", content }];\n  }\n  return [...messages, { role: \"user\", content: text }];\n}\n\nfunction credentials(\n  apiKey: string | undefined,\n  authToken: string | undefined\n): Record<string, string> {\n  if (authToken !== undefined) return { Authorization: `Bearer ${authToken.trim()}` };\n  const key = (apiKey ?? process.env.ANTHROPIC_API_KEY)?.trim();\n  if (key) return { \"x-api-key\": key };\n  const token = process.env.ANTHROPIC_AUTH_TOKEN?.trim();\n  if (token) return { Authorization: `Bearer ${token}` };\n  throw new Error(\"ANTHROPIC_API_KEY or ANTHROPIC_AUTH_TOKEN is required for live model execution\");\n}\n"]}

package/dist/agent/checkpoint-format.d.ts

@@ -59,6 +59,9 @@ export type SavedAgent = AgentSnapshot & ({
 } | {
     phase: "completed";
     result: unknown;
+    completedState?: {
+        state: unknown;
+    };
     decision?: never;
     failure?: never;
 } | {

package/dist/agent/checkpoint-format.js

@@ -62,6 +62,10 @@ function checkAgent(agent) {
         throw new Error("Invalid saved agent execution");
     if (agent.phase === "completed" && !Object.hasOwn(agent, "result"))
         throw new Error("Missing saved agent result");
+    if (agent.phase === "completed" &&
+        agent.completedState !== undefined &&
+        (!record(agent.completedState) || !Object.hasOwn(agent.completedState, "state")))
+        throw new Error("Invalid saved completed state");
     if (agent.phase === "failed" && !failure(agent.failure))
         throw new Error("Invalid saved agent failure");
     if (agent.phase === "calls") {

package/dist/agent/checkpoint-format.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint-format.js","sourceRoot":"","sources":["../../src/agent/checkpoint-format.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentLimits, AgentOutcome, Tools } from \"./agent-types.js\";\n\nexport interface StoredBudget {\n  depth: number;\n  limits: Required<AgentLimits>;\n  maxCalls: number;\n  maxDecisions: number;\n}\nexport type CallOutcome = AgentOutcome<Tools>;\nexport type SavedCall = {\n  id: string;\n  tool: string;\n  replay: \"safe\" | \"unsafe\";\n} & (\n  | { kind: \"handler\"; input: unknown; validatedOptions?: never }\n  | { kind: \"pipeline\"; input: object; validatedOptions: object }\n) &\n  (\n    | { status: \"pending\" | \"running\"; outcome?: never }\n    | { status: \"completed\"; outcome: CallOutcome }\n  );\nexport interface SavedDecision {\n  state: unknown;\n  calls: SavedCall[];\n  admitted: boolean;\n}\ninterface AgentSnapshot {\n  metadata: {\n    definition: string;\n    implementationVersion?: string;\n    options: object;\n    environment: string;\n    cwd: string;\n    cache: \"use\" | \"recompute\" | \"bypass\";\n  };\n  execution: { state: unknown; turn: number; stateVersion: number; calls: number };\n}\nexport type SavedAgent = AgentSnapshot &\n  (\n    | { phase: \"decide\"; decision?: never; result?: never; failure?: never }\n    | { phase: \"calls\"; decision: SavedDecision; result?: never; failure?: never }\n    | { phase: \"completed\"; result: unknown; decision?: never; failure?: never }\n    | {\n        phase: \"failed\";\n        failure: { code: string; message: string };\n        decision?: never;\n        result?: never;\n      }\n  );\nexport interface Checkpoint {\n  version: 1;\n  agents: Record<string, SavedAgent>;\n  budgets: Record<string, StoredBudget>;\n}\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null)\n  );\n}\nfunction natural(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\nfunction options(value: unknown): value is object {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\nfunction failure(value: unknown): boolean {\n  return record(value) && typeof value.code === \"string\" && typeof value.message === \"string\";\n}\n\nfunction checkCall(call: unknown, admitted: boolean, ids: Set<string>): void {\n  if (\n    !record(call) ||\n    typeof call.id !== \"string\" ||\n    !call.id.trim() ||\n    call.id.length > 256 ||\n    ids.has(call.id) ||\n    typeof call.tool !== \"string\" ||\n    !/^[A-Za-z][A-Za-z0-9_-]{0,127}$/.test(call.tool) ||\n    ![\"handler\", \"pipeline\"].includes(String(call.kind)) ||\n    ![\"safe\", \"unsafe\"].includes(String(call.replay)) ||\n    ![\"pending\", \"running\", \"completed\"].includes(String(call.status)) ||\n    !Object.hasOwn(call, \"input\")\n  )\n    throw new Error(\"Invalid saved call\");\n  ids.add(call.id);\n  if (call.kind === \"pipeline\" && (!options(call.input) || !options(call.validatedOptions)))\n    throw new Error(\"Invalid saved pipeline options\");\n  if (!admitted && call.status !== \"pending\") throw new Error(\"Unadmitted call has started\");\n  if (call.status === \"completed\") {\n    const outcome = call.outcome;\n    if (\n      !record(outcome) ||\n      outcome.id !== call.id ||\n      outcome.tool !== call.tool ||\n      typeof outcome.ok !== \"boolean\" ||\n      (outcome.ok ? !Object.hasOwn(outcome, \"value\") : !failure(outcome.error))\n    )\n      throw new Error(\"Invalid saved call outcome\");\n  }\n}\n\nfunction checkAgent(agent: unknown): void {\n  if (!record(agent) || !record(agent.metadata) || !record(agent.execution))\n    throw new Error(\"Invalid saved agent\");\n  const { metadata, execution } = agent;\n  if (\n    typeof metadata.definition !== \"string\" ||\n    typeof metadata.environment !== \"string\" ||\n    typeof metadata.cwd !== \"string\" ||\n    !options(metadata.options) ||\n    (metadata.implementationVersion !== undefined &&\n      typeof metadata.implementationVersion !== \"string\") ||\n    ![\"use\", \"recompute\", \"bypass\"].includes(String(metadata.cache))\n  )\n    throw new Error(\"Invalid saved agent metadata\");\n  if (\n    !Object.hasOwn(execution, \"state\") ||\n    !natural(execution.turn) ||\n    execution.turn < 1 ||\n    !natural(execution.stateVersion) ||\n    !natural(execution.calls) ||\n    ![\"decide\", \"calls\", \"completed\", \"failed\"].includes(String(agent.phase))\n  )\n    throw new Error(\"Invalid saved agent execution\");\n  if (agent.phase === \"completed\" && !Object.hasOwn(agent, \"result\"))\n    throw new Error(\"Missing saved agent result\");\n  if (agent.phase === \"failed\" && !failure(agent.failure))\n    throw new Error(\"Invalid saved agent failure\");\n  if (agent.phase === \"calls\") {\n    const decision = agent.decision;\n    if (\n      !record(decision) ||\n      !Object.hasOwn(decision, \"state\") ||\n      !Array.isArray(decision.calls) ||\n      decision.calls.length === 0 ||\n      typeof decision.admitted !== \"boolean\"\n    )\n      throw new Error(\"Invalid saved call batch\");\n    const ids = new Set<string>();\n    for (const call of decision.calls) checkCall(call, decision.admitted, ids);\n  }\n}\n\nfunction checkBudget(budget: unknown): void {\n  if (\n    !record(budget) ||\n    !natural(budget.depth) ||\n    !natural(budget.maxCalls) ||\n    !natural(budget.maxDecisions) ||\n    !record(budget.limits)\n  )\n    throw new Error(\"Invalid saved agent budget\");\n  for (const name of [\n    \"maxTurns\",\n    \"maxCalls\",\n    \"maxDecisions\",\n    \"maxDepth\",\n    \"maxConcurrency\",\n  ] as const) {\n    const bound = budget.limits[name];\n    if (!natural(bound) || (![\"maxCalls\", \"maxDepth\"].includes(name) && bound === 0))\n      throw new Error(\"Invalid saved agent limits\");\n  }\n  if (\n    budget.maxCalls > Number(budget.limits.maxCalls) ||\n    budget.maxDecisions > Number(budget.limits.maxDecisions)\n  )\n    throw new Error(\"Saved agent budget exceeds its limits\");\n}\n\n/** Validate receipts and counters before treating decoded storage as prepared work. */\nexport function checkedCheckpoint(value: unknown): Checkpoint {\n  if (!record(value) || value.version !== 1 || !record(value.agents) || !record(value.budgets))\n    throw new Error(\"Invalid agent checkpoint envelope\");\n  for (const [key, agent] of Object.entries(value.agents)) {\n    checkAgent(agent);\n    if (!Object.hasOwn(value.budgets, key)) throw new Error(\"Missing saved agent budget\");\n  }\n  for (const budget of Object.values(value.budgets)) checkBudget(budget);\n  // SAFETY: metadata, execution counters, call receipts and budget contracts were checked above.\n  return value as unknown as Checkpoint;\n}\n"]}
+{"version":3,"file":"checkpoint-format.js","sourceRoot":"","sources":["../../src/agent/checkpoint-format.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentLimits, AgentOutcome, Tools } from \"./agent-types.js\";\n\nexport interface StoredBudget {\n  depth: number;\n  limits: Required<AgentLimits>;\n  maxCalls: number;\n  maxDecisions: number;\n}\nexport type CallOutcome = AgentOutcome<Tools>;\nexport type SavedCall = {\n  id: string;\n  tool: string;\n  replay: \"safe\" | \"unsafe\";\n} & (\n  | { kind: \"handler\"; input: unknown; validatedOptions?: never }\n  | { kind: \"pipeline\"; input: object; validatedOptions: object }\n) &\n  (\n    | { status: \"pending\" | \"running\"; outcome?: never }\n    | { status: \"completed\"; outcome: CallOutcome }\n  );\nexport interface SavedDecision {\n  state: unknown;\n  calls: SavedCall[];\n  admitted: boolean;\n}\ninterface AgentSnapshot {\n  metadata: {\n    definition: string;\n    implementationVersion?: string;\n    options: object;\n    environment: string;\n    cwd: string;\n    cache: \"use\" | \"recompute\" | \"bypass\";\n  };\n  execution: { state: unknown; turn: number; stateVersion: number; calls: number };\n}\nexport type SavedAgent = AgentSnapshot &\n  (\n    | { phase: \"decide\"; decision?: never; result?: never; failure?: never }\n    | { phase: \"calls\"; decision: SavedDecision; result?: never; failure?: never }\n    | {\n        phase: \"completed\";\n        result: unknown;\n        completedState?: { state: unknown };\n        decision?: never;\n        failure?: never;\n      }\n    | {\n        phase: \"failed\";\n        failure: { code: string; message: string };\n        decision?: never;\n        result?: never;\n      }\n  );\nexport interface Checkpoint {\n  version: 1;\n  agents: Record<string, SavedAgent>;\n  budgets: Record<string, StoredBudget>;\n}\n\nfunction record(value: unknown): value is Record<string, unknown> {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    !Array.isArray(value) &&\n    (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null)\n  );\n}\nfunction natural(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\nfunction options(value: unknown): value is object {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\nfunction failure(value: unknown): boolean {\n  return record(value) && typeof value.code === \"string\" && typeof value.message === \"string\";\n}\n\nfunction checkCall(call: unknown, admitted: boolean, ids: Set<string>): void {\n  if (\n    !record(call) ||\n    typeof call.id !== \"string\" ||\n    !call.id.trim() ||\n    call.id.length > 256 ||\n    ids.has(call.id) ||\n    typeof call.tool !== \"string\" ||\n    !/^[A-Za-z][A-Za-z0-9_-]{0,127}$/.test(call.tool) ||\n    ![\"handler\", \"pipeline\"].includes(String(call.kind)) ||\n    ![\"safe\", \"unsafe\"].includes(String(call.replay)) ||\n    ![\"pending\", \"running\", \"completed\"].includes(String(call.status)) ||\n    !Object.hasOwn(call, \"input\")\n  )\n    throw new Error(\"Invalid saved call\");\n  ids.add(call.id);\n  if (call.kind === \"pipeline\" && (!options(call.input) || !options(call.validatedOptions)))\n    throw new Error(\"Invalid saved pipeline options\");\n  if (!admitted && call.status !== \"pending\") throw new Error(\"Unadmitted call has started\");\n  if (call.status === \"completed\") {\n    const outcome = call.outcome;\n    if (\n      !record(outcome) ||\n      outcome.id !== call.id ||\n      outcome.tool !== call.tool ||\n      typeof outcome.ok !== \"boolean\" ||\n      (outcome.ok ? !Object.hasOwn(outcome, \"value\") : !failure(outcome.error))\n    )\n      throw new Error(\"Invalid saved call outcome\");\n  }\n}\n\nfunction checkAgent(agent: unknown): void {\n  if (!record(agent) || !record(agent.metadata) || !record(agent.execution))\n    throw new Error(\"Invalid saved agent\");\n  const { metadata, execution } = agent;\n  if (\n    typeof metadata.definition !== \"string\" ||\n    typeof metadata.environment !== \"string\" ||\n    typeof metadata.cwd !== \"string\" ||\n    !options(metadata.options) ||\n    (metadata.implementationVersion !== undefined &&\n      typeof metadata.implementationVersion !== \"string\") ||\n    ![\"use\", \"recompute\", \"bypass\"].includes(String(metadata.cache))\n  )\n    throw new Error(\"Invalid saved agent metadata\");\n  if (\n    !Object.hasOwn(execution, \"state\") ||\n    !natural(execution.turn) ||\n    execution.turn < 1 ||\n    !natural(execution.stateVersion) ||\n    !natural(execution.calls) ||\n    ![\"decide\", \"calls\", \"completed\", \"failed\"].includes(String(agent.phase))\n  )\n    throw new Error(\"Invalid saved agent execution\");\n  if (agent.phase === \"completed\" && !Object.hasOwn(agent, \"result\"))\n    throw new Error(\"Missing saved agent result\");\n  if (\n    agent.phase === \"completed\" &&\n    agent.completedState !== undefined &&\n    (!record(agent.completedState) || !Object.hasOwn(agent.completedState, \"state\"))\n  )\n    throw new Error(\"Invalid saved completed state\");\n  if (agent.phase === \"failed\" && !failure(agent.failure))\n    throw new Error(\"Invalid saved agent failure\");\n  if (agent.phase === \"calls\") {\n    const decision = agent.decision;\n    if (\n      !record(decision) ||\n      !Object.hasOwn(decision, \"state\") ||\n      !Array.isArray(decision.calls) ||\n      decision.calls.length === 0 ||\n      typeof decision.admitted !== \"boolean\"\n    )\n      throw new Error(\"Invalid saved call batch\");\n    const ids = new Set<string>();\n    for (const call of decision.calls) checkCall(call, decision.admitted, ids);\n  }\n}\n\nfunction checkBudget(budget: unknown): void {\n  if (\n    !record(budget) ||\n    !natural(budget.depth) ||\n    !natural(budget.maxCalls) ||\n    !natural(budget.maxDecisions) ||\n    !record(budget.limits)\n  )\n    throw new Error(\"Invalid saved agent budget\");\n  for (const name of [\n    \"maxTurns\",\n    \"maxCalls\",\n    \"maxDecisions\",\n    \"maxDepth\",\n    \"maxConcurrency\",\n  ] as const) {\n    const bound = budget.limits[name];\n    if (!natural(bound) || (![\"maxCalls\", \"maxDepth\"].includes(name) && bound === 0))\n      throw new Error(\"Invalid saved agent limits\");\n  }\n  if (\n    budget.maxCalls > Number(budget.limits.maxCalls) ||\n    budget.maxDecisions > Number(budget.limits.maxDecisions)\n  )\n    throw new Error(\"Saved agent budget exceeds its limits\");\n}\n\n/** Validate receipts and counters before treating decoded storage as prepared work. */\nexport function checkedCheckpoint(value: unknown): Checkpoint {\n  if (!record(value) || value.version !== 1 || !record(value.agents) || !record(value.budgets))\n    throw new Error(\"Invalid agent checkpoint envelope\");\n  for (const [key, agent] of Object.entries(value.agents)) {\n    checkAgent(agent);\n    if (!Object.hasOwn(value.budgets, key)) throw new Error(\"Missing saved agent budget\");\n  }\n  for (const budget of Object.values(value.budgets)) checkBudget(budget);\n  // SAFETY: metadata, execution counters, call receipts and budget contracts were checked above.\n  return value as unknown as Checkpoint;\n}\n"]}

package/dist/agent/checkpoint-session.d.ts

@@ -31,7 +31,9 @@ export declare class AgentCheckpointSession {
     completeCall(key: string, id: string, outcome: CallOutcome): Promise<void>;
     private changeCall;
     advance(key: string, execution: SavedAgent["execution"]): Promise<void>;
-    finish(key: string, result: unknown): Promise<void>;
+    finish(key: string, result: unknown, completedState: {
+        state: unknown;
+    }): Promise<void>;
     fail(key: string, error: unknown, signal?: AbortSignal): Promise<void>;
     private update;
     close(): Promise<void>;

package/dist/agent/checkpoint-session.js

@@ -164,7 +164,7 @@ export class AgentCheckpointSession {
             checkpoint.agents[key] = { metadata: saved.metadata, execution, phase: "decide" };
         });
     }
-    finish(key, result) {
+    finish(key, result, completedState) {
         return this.update((checkpoint) => {
             const saved = checkpoint.agents[key];
             if (!saved || saved.phase !== "decide")
@@ -174,6 +174,7 @@ export class AgentCheckpointSession {
                 execution: saved.execution,
                 phase: "completed",
                 result,
+                completedState,
             };
         });
     }