@stigmer/runner 3.15.0 → 3.15.2-dev.20260913223433

package/dist/activities/execute-deep-agent/__test-utils__/scripted-model.d.ts

@@ -3,45 +3,191 @@
  * parent-checkpoint interrupt reader.
  *
  * These two helpers are what every "drive a real deepagents/LangGraph graph
- * through the approval gate" test needs, and they were previously copy-pasted
- * inline. They are shared by:
- * - `__tests__/subagent-approval-propagation.test.ts` (sub-agent interrupt
- *   propagation against the real runtime), and
- * - `__test-utils__/gateway-substrate.ts` (the deep-agent adapter for the
- *   gateway Contract Test Kit).
+ * through the approval gate" test needs. They are shared by the graph-level
+ * tests (`__tests__/subagent-approval-propagation.test.ts`,
+ * `shell-execute-gate.test.ts`, …), the gateway Contract Test Kit adapter
+ * (`gateway-substrate.ts`), and the hermetic activity driver
+ * (`hermetic-deep-agent.ts`), which runs the REAL `ExecuteDeepAgent` activity
+ * with this model as the only LLM. Keeping one copy means a change to how the
+ * runner reads pending interrupts (or how a scripted run is driven) updates
+ * every consumer at once.
  *
- * Keeping one copy means a change to how the runner reads pending interrupts (or
- * how a scripted run is driven) updates every consumer at once.
+ * The one rule the model keeps: it is a PURE FUNCTION of (bound tools,
+ * transcript). A script is a sequence of turns per role, and the turn to play
+ * is chosen by how many tool rounds the transcript already holds (AI messages
+ * carrying `tool_calls`), never by a call counter. That is what lets one
+ * script serve both checkpointers the runner ships: under `memory` a HITL
+ * reinvocation REPLAYS the graph from the first message (the saver is
+ * recreated empty per invocation), so the same transcript indices produce the
+ * same proposals; under `sqlite` the graph RESUMES after the interrupt and the
+ * next call sees one more completed round. A call-counted script would emit
+ * the wrong turn on replay.
+ *
+ * A script may also be a {@link TurnPlayer}: a function of the whole
+ * transcript that returns the one turn to play now. The same rule, with the
+ * indexing left to the caller — for a consumer whose plan is not "turn k on
+ * round k" but "the first step the conversation does not yet show" (the
+ * harness contract kit's native subject, whose one execution spans many
+ * kit turns on one sqlite thread, S3 M3).
+ *
+ * A turn may END the model call instead of finishing the message
+ * ({@link TurnEnding}): `fail` throws after its chunks (a provider error
+ * mid-stream); `hang` parks on the call's abort signal after its chunks and
+ * throws the abort when it fires (a provider stream that stalls and is then
+ * cancelled). A hang never parks on a timer: `@langchain/core` hands the
+ * graph run's signal to `_streamResponseChunks` as `options.signal`
+ * (`_separateRunnableConfigFromCallOptionsCompat`), and LangGraph threads
+ * its composite abort signal into every task's config, so the runtime's one
+ * stop is what unparks it. The `onPark` hook is how a test learns the engine
+ * is silent before it stops the turn from the outside.
+ *
+ * The model STREAMS. With LangGraph's v3 messages handler attached, LangChain
+ * Core streams a model internally when it implements `_streamResponseChunks`
+ * and otherwise falls back to a synthesized final-message event sequence
+ * (`@langchain/langgraph` `pregel/messages-v2.js` `emitFinalMessage`). The
+ * fallback spreads a `tool_call` block's `args` OBJECT into the
+ * `tool_call_chunk` fields the runner's normalizer reads as a JSON STRING
+ * (`v3-protocol-normalizer.ts` `argsChunk`), which no real provider does.
+ * Streaming keeps the double on the production event path: `@langchain/core`
+ * `language_models/compat.js` `convertChunksToEvents` turns the chunks below
+ * into `message-start`, per-block `content-block-start` / `-delta` /
+ * `-finish`, and `message-finish` with usage — the same events `ChatAnthropic`
+ * produces. The chunk shapes are chosen from that converter: a string chunk
+ * opens block 0 and emits a text delta in one step; an array-content part
+ * opens its block with NO delta on first sight, so a reasoning block is sent
+ * as an empty opener followed by the text; a `tool_call_chunk` always emits a
+ * delta carrying the accumulated JSON args; `usage_metadata` rides the LAST
+ * chunk so it lands on `message-finish` (the one place the runner reads it),
+ * not on `message-start`.
  */
 import { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { BaseChatModelCallOptions } from "@langchain/core/language_models/chat_models";
+import type { CallbackManagerForLLMRun } from "@langchain/core/callbacks/manager";
 import { type BaseMessage } from "@langchain/core/messages";
-import type { ChatResult } from "@langchain/core/outputs";
-/** A single tool call the scripted model proposes on a non-terminal turn. */
+import { ChatGenerationChunk, type ChatResult } from "@langchain/core/outputs";
+/** A single tool call the scripted model proposes on a turn. */
 export interface ScriptedToolCall {
     name: string;
     args: Record<string, unknown>;
     id: string;
 }
 /**
- * What the scripted model does for a given role: propose `toolCalls` while no
- * tool result is pending, then emit the `done` text once a tool result returns.
+ * Token usage a turn reports; fixed round numbers keep `streamingUsage`
+ * legible in a golden. The cache buckets ride `input_token_details` the way
+ * the Anthropic adapter reports them (`cache_read`, `cache_creation`);
+ * `inputTokens` is the total the provider states, cache included.
+ */
+export interface ScriptedUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens?: number;
+    readonly cacheWriteTokens?: number;
+}
+/**
+ * How a turn ends the model call instead of finishing its message.
+ *  - `fail`: throw `error` after the turn's chunks — a provider error
+ *    mid-stream; the graph propagates it and the adapter classifies it.
+ *  - `hang`: after the turn's chunks, park on the call's abort signal and
+ *    throw the abort when it fires — a stalled provider stream, cancelled by
+ *    the run's one stop. Refused (thrown, diagnosing) when the call carries
+ *    no signal: a hang outside an abortable run would park forever.
+ */
+export type TurnEnding = {
+    readonly kind: "fail";
+    readonly error: Error;
+} | {
+    readonly kind: "hang";
+};
+/**
+ * One assistant turn, rendered in the standard content-block shape a
+ * streaming provider produces: an optional leading reasoning block, an
+ * optional text block, and one `tool_call` per entry of `toolCalls` (which is
+ * also what the graph executes). A turn with neither text nor tool calls is
+ * an empty assistant message — legal, and what a script that has said all it
+ * has to say looks like. A turn with `ends` never finishes its message: its
+ * chunks are streamed, then the ending takes the call.
+ */
+export interface ScriptedTurn {
+    readonly reasoning?: string;
+    readonly text?: string;
+    readonly toolCalls?: readonly ScriptedToolCall[];
+    readonly usage?: ScriptedUsage;
+    readonly ends?: TurnEnding;
+}
+/**
+ * A role's script: `turns[k]` is played when the transcript already holds `k`
+ * completed tool rounds. Running past the end throws (a script that runs out
+ * is a test bug) unless `repeatLast` is set, in which case the final turn
+ * plays again — the shape of a model that keeps calling a tool until the
+ * graph's recursion limit stops it.
+ */
+export interface RoleScript {
+    readonly turns: readonly ScriptedTurn[];
+    readonly repeatLast?: boolean;
+}
+/**
+ * The two-turn sugar most graph-level tests use: propose `toolCalls` on the
+ * first round, then say `done` on every round after. Exactly
+ * `{ turns: [{ toolCalls }, { text: done }], repeatLast: true }`.
  */
 export interface ScriptStep {
     toolCalls: ScriptedToolCall[];
     done: string;
 }
 /**
- * Picks the {@link ScriptStep} for the currently-bound tool set. A single-agent
- * test ignores the argument; a parent/sub-agent test keys the role on a tool
- * unique to one role (e.g. the sub-agent's gated tool), because `createDeepAgent`
- * injects the `task` tool into both the parent and its sub-agents.
+ * What a selector can tell one role from another by. `createDeepAgent` gives
+ * a declared sub-agent the SAME tool set as its parent (`task` included), so
+ * tool names alone cannot separate them; the system prompt can — it carries
+ * the role's own instructions.
  */
-export type ScriptSelector = (boundToolNames: string[]) => ScriptStep;
+export interface ScriptRoleContext {
+    /** The transcript's leading system message, or "" when there is none. */
+    readonly systemPrompt: string;
+}
+/**
+ * A script as a function of the whole transcript: called on every model turn
+ * with the messages the model was asked with, returns the turn to play. The
+ * round-indexed `RoleScript` is the common case; this is for a plan whose
+ * progress is read off the conversation itself (see the header).
+ */
+export type TurnPlayer = (transcript: readonly BaseMessage[]) => ScriptedTurn;
+/** The three shapes a selector may answer with. */
+export type Script = ScriptStep | RoleScript | TurnPlayer;
 /**
- * A deterministic two-turn chat model: on the first turn it proposes the
- * selected role's tool calls; once a tool result comes back it returns the
- * role's terminating text. No LLM, no network — the role is keyed on the bound
- * tool names so the same model instance drives a parent and its sub-agents.
+ * Picks the script for the role being asked. A single-agent test ignores both
+ * arguments; a parent/sub-agent test keys the role on a tool unique to one
+ * role when there is one (a custom counting tool), or on the role's
+ * instructions in `context.systemPrompt` when both roles bind the same tools
+ * (the hermetic delegation arm). Called at `_generate` time, never at bind
+ * time, so a role that is compiled but never invoked (the default
+ * general-purpose sub-agent) needs no script.
+ */
+export type ScriptSelector = (boundToolNames: string[], context: ScriptRoleContext) => Script;
+/** What the driver learns before a turn is rendered: which role, which round. */
+export interface ScriptedTurnInfo {
+    readonly boundToolNames: readonly string[];
+    readonly round: number;
+}
+export interface ScriptedModelOptions {
+    /**
+     * Called once per model turn, before it is rendered. The hermetic driver
+     * ticks its clock here and runs a scenario's scheduled effect (a user pause,
+     * a worker shutdown) — from a model turn, never from a timer, so the
+     * interruption lands at the same instant every run.
+     */
+    readonly onTurn?: (info: ScriptedTurnInfo) => void | Promise<void>;
+    /**
+     * Called the moment a `hang` turn parks on its abort signal — the engine
+     * is silent from here until the signal fires. A test that must stop the
+     * turn from the outside (the contract kit's `whenHanging`) listens here,
+     * so the stop lands in the hang and never in the adapter's setup.
+     */
+    readonly onPark?: () => void;
+}
+/**
+ * A deterministic chat model driven by a per-role script. No LLM, no network.
+ * The role is keyed on the bound tool names so the same instance drives a
+ * parent and its sub-agents.
  */
 export declare class ScriptedModel extends BaseChatModel {
     toolNames: string[];
@@ -54,11 +200,29 @@ export declare class ScriptedModel extends BaseChatModel {
      */
     readonly boundTools: unknown[];
     private readonly select;
-    constructor(select: ScriptSelector, boundTools?: unknown[]);
+    private readonly options;
+    constructor(select: ScriptSelector, boundTools?: unknown[], options?: ScriptedModelOptions);
     _llmType(): string;
     bindTools(tools: unknown[]): this;
-    _generate(messages: BaseMessage[]): Promise<ChatResult>;
+    /** The turn for this transcript, after the driver hook has run. */
+    private turnFor;
+    /**
+     * The non-streaming path (`invoke` outside a graph — the runtime's tier-2
+     * structured-output extractor is the one caller): the SAME chunks the
+     * streaming path yields, merged, which is the `AIMessageChunk` a streaming
+     * provider's `invoke` returns. `@langchain/core`'s base `withStructuredOutput`
+     * pipeline reads exactly that shape (`AIMessageChunk.isInstance`, then
+     * `tool_calls`); a plain `AIMessage` here would fail it with "Input is not
+     * an AIMessageChunk" where the real provider succeeds. An ending turn ends
+     * this call the same way it ends the stream.
+     */
+    _generate(messages: BaseMessage[], options: this["ParsedCallOptions"]): Promise<ChatResult>;
+    _streamResponseChunks(messages: BaseMessage[], options: this["ParsedCallOptions"] & BaseChatModelCallOptions, _runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatGenerationChunk>;
+    /** Never returns: throws the ending's error, or parks on the signal and throws its abort. */
+    private takeEnding;
 }
+/** Tool rounds the transcript already holds: AI messages that proposed at least one tool call. */
+export declare function completedToolRounds(messages: readonly BaseMessage[]): number;
 /** A pending approval interrupt surfaced at the parent checkpoint. */
 export interface PendingInterrupt {
     taskId: string;

package/dist/activities/execute-deep-agent/__test-utils__/scripted-model.js

@@ -3,23 +3,70 @@
  * parent-checkpoint interrupt reader.
  *
  * These two helpers are what every "drive a real deepagents/LangGraph graph
- * through the approval gate" test needs, and they were previously copy-pasted
- * inline. They are shared by:
- * - `__tests__/subagent-approval-propagation.test.ts` (sub-agent interrupt
- *   propagation against the real runtime), and
- * - `__test-utils__/gateway-substrate.ts` (the deep-agent adapter for the
- *   gateway Contract Test Kit).
+ * through the approval gate" test needs. They are shared by the graph-level
+ * tests (`__tests__/subagent-approval-propagation.test.ts`,
+ * `shell-execute-gate.test.ts`, …), the gateway Contract Test Kit adapter
+ * (`gateway-substrate.ts`), and the hermetic activity driver
+ * (`hermetic-deep-agent.ts`), which runs the REAL `ExecuteDeepAgent` activity
+ * with this model as the only LLM. Keeping one copy means a change to how the
+ * runner reads pending interrupts (or how a scripted run is driven) updates
+ * every consumer at once.
  *
- * Keeping one copy means a change to how the runner reads pending interrupts (or
- * how a scripted run is driven) updates every consumer at once.
+ * The one rule the model keeps: it is a PURE FUNCTION of (bound tools,
+ * transcript). A script is a sequence of turns per role, and the turn to play
+ * is chosen by how many tool rounds the transcript already holds (AI messages
+ * carrying `tool_calls`), never by a call counter. That is what lets one
+ * script serve both checkpointers the runner ships: under `memory` a HITL
+ * reinvocation REPLAYS the graph from the first message (the saver is
+ * recreated empty per invocation), so the same transcript indices produce the
+ * same proposals; under `sqlite` the graph RESUMES after the interrupt and the
+ * next call sees one more completed round. A call-counted script would emit
+ * the wrong turn on replay.
+ *
+ * A script may also be a {@link TurnPlayer}: a function of the whole
+ * transcript that returns the one turn to play now. The same rule, with the
+ * indexing left to the caller — for a consumer whose plan is not "turn k on
+ * round k" but "the first step the conversation does not yet show" (the
+ * harness contract kit's native subject, whose one execution spans many
+ * kit turns on one sqlite thread, S3 M3).
+ *
+ * A turn may END the model call instead of finishing the message
+ * ({@link TurnEnding}): `fail` throws after its chunks (a provider error
+ * mid-stream); `hang` parks on the call's abort signal after its chunks and
+ * throws the abort when it fires (a provider stream that stalls and is then
+ * cancelled). A hang never parks on a timer: `@langchain/core` hands the
+ * graph run's signal to `_streamResponseChunks` as `options.signal`
+ * (`_separateRunnableConfigFromCallOptionsCompat`), and LangGraph threads
+ * its composite abort signal into every task's config, so the runtime's one
+ * stop is what unparks it. The `onPark` hook is how a test learns the engine
+ * is silent before it stops the turn from the outside.
+ *
+ * The model STREAMS. With LangGraph's v3 messages handler attached, LangChain
+ * Core streams a model internally when it implements `_streamResponseChunks`
+ * and otherwise falls back to a synthesized final-message event sequence
+ * (`@langchain/langgraph` `pregel/messages-v2.js` `emitFinalMessage`). The
+ * fallback spreads a `tool_call` block's `args` OBJECT into the
+ * `tool_call_chunk` fields the runner's normalizer reads as a JSON STRING
+ * (`v3-protocol-normalizer.ts` `argsChunk`), which no real provider does.
+ * Streaming keeps the double on the production event path: `@langchain/core`
+ * `language_models/compat.js` `convertChunksToEvents` turns the chunks below
+ * into `message-start`, per-block `content-block-start` / `-delta` /
+ * `-finish`, and `message-finish` with usage — the same events `ChatAnthropic`
+ * produces. The chunk shapes are chosen from that converter: a string chunk
+ * opens block 0 and emits a text delta in one step; an array-content part
+ * opens its block with NO delta on first sight, so a reasoning block is sent
+ * as an empty opener followed by the text; a `tool_call_chunk` always emits a
+ * delta carrying the accumulated JSON args; `usage_metadata` rides the LAST
+ * chunk so it lands on `message-finish` (the one place the runner reads it),
+ * not on `message-start`.
  */
 import { BaseChatModel } from "@langchain/core/language_models/chat_models";
-import { AIMessage, ToolMessage } from "@langchain/core/messages";
+import { AIMessageChunk, isAIMessage, isSystemMessage, } from "@langchain/core/messages";
+import { ChatGenerationChunk } from "@langchain/core/outputs";
 /**
- * A deterministic two-turn chat model: on the first turn it proposes the
- * selected role's tool calls; once a tool result comes back it returns the
- * role's terminating text. No LLM, no network — the role is keyed on the bound
- * tool names so the same model instance drives a parent and its sub-agents.
+ * A deterministic chat model driven by a per-role script. No LLM, no network.
+ * The role is keyed on the bound tool names so the same instance drives a
+ * parent and its sub-agents.
  */
 export class ScriptedModel extends BaseChatModel {
     toolNames = [];
@@ -32,33 +79,197 @@ export class ScriptedModel extends BaseChatModel {
      */
     boundTools;
     select;
-    constructor(select, boundTools = []) {
+    options;
+    constructor(select, boundTools = [], options = {}) {
         super({});
         this.select = select;
         this.boundTools = boundTools;
+        this.options = options;
     }
     _llmType() {
         return "scripted";
     }
     bindTools(tools) {
-        const next = new ScriptedModel(this.select, this.boundTools);
-        next.toolNames = tools.map((t) => t?.name ?? "");
+        const next = new ScriptedModel(this.select, this.boundTools, this.options);
+        next.toolNames = tools.map(boundToolName);
         this.boundTools.length = 0;
         this.boundTools.push(...tools);
         return next;
     }
-    async _generate(messages) {
-        const step = this.select(this.toolNames);
-        const lastIsToolResult = messages[messages.length - 1] instanceof ToolMessage;
-        const message = lastIsToolResult
-            ? new AIMessage({ content: step.done })
-            : new AIMessage({
-                content: "",
-                tool_calls: step.toolCalls.map((tc) => ({ ...tc, type: "tool_call" })),
-            });
-        const text = typeof message.content === "string" ? message.content : "";
-        return { generations: [{ message, text }] };
+    /** The turn for this transcript, after the driver hook has run. */
+    async turnFor(messages) {
+        const round = completedToolRounds(messages);
+        await this.options.onTurn?.({ boundToolNames: this.toolNames, round });
+        const context = { systemPrompt: systemPromptOf(messages) };
+        return resolveTurn(this.select(this.toolNames, context), { round, transcript: messages, toolNames: this.toolNames });
+    }
+    /**
+     * The non-streaming path (`invoke` outside a graph — the runtime's tier-2
+     * structured-output extractor is the one caller): the SAME chunks the
+     * streaming path yields, merged, which is the `AIMessageChunk` a streaming
+     * provider's `invoke` returns. `@langchain/core`'s base `withStructuredOutput`
+     * pipeline reads exactly that shape (`AIMessageChunk.isInstance`, then
+     * `tool_calls`); a plain `AIMessage` here would fail it with "Input is not
+     * an AIMessageChunk" where the real provider succeeds. An ending turn ends
+     * this call the same way it ends the stream.
+     */
+    async _generate(messages, options) {
+        const turn = await this.turnFor(messages);
+        if (turn.ends)
+            await this.takeEnding(turn.ends, options.signal);
+        const message = renderTurnChunks(turn).reduce((merged, chunk) => merged.concat(chunk));
+        return { generations: [{ message, text: turn.text ?? "" }] };
+    }
+    async *_streamResponseChunks(messages, options, _runManager) {
+        const turn = await this.turnFor(messages);
+        for (const chunk of renderTurnChunks(turn)) {
+            yield new ChatGenerationChunk({ message: chunk, text: typeof chunk.content === "string" ? chunk.content : "" });
+        }
+        if (turn.ends)
+            await this.takeEnding(turn.ends, options.signal);
+    }
+    /** Never returns: throws the ending's error, or parks on the signal and throws its abort. */
+    async takeEnding(ending, signal) {
+        switch (ending.kind) {
+            case "fail":
+                throw ending.error;
+            case "hang": {
+                if (!signal) {
+                    throw new Error("ScriptedModel: a `hang` turn parks on the call's abort signal and this call carried none; " +
+                        "a hang is only meaningful inside a run that can be aborted");
+                }
+                this.options.onPark?.();
+                if (!signal.aborted) {
+                    await new Promise((resolve) => signal.addEventListener("abort", () => resolve(), { once: true }));
+                }
+                throw abortErrorOf(signal);
+            }
+            default: {
+                const exhaustive = ending;
+                throw new Error(`ScriptedModel: unknown turn ending ${String(exhaustive)}`);
+            }
+        }
+    }
+}
+/** What a provider SDK throws when its in-flight request is aborted: the signal's own reason, or an `AbortError` naming it. */
+function abortErrorOf(signal) {
+    if (signal.reason instanceof Error)
+        return signal.reason;
+    const err = new Error(`ScriptedModel: the hang was aborted (${String(signal.reason)})`);
+    err.name = "AbortError";
+    return err;
+}
+// ---------------------------------------------------------------------------
+// Script resolution
+// ---------------------------------------------------------------------------
+/**
+ * The name a bound tool answers to: a LangChain tool's `name`, or an
+ * OpenAI-style function definition's `function.name` (how langchain binds the
+ * structured-output schema tool of `toolStrategy`). A real provider client
+ * accepts both shapes; so does this double.
+ */
+function boundToolName(tool) {
+    const t = tool;
+    if (typeof t?.name === "string")
+        return t.name;
+    if (typeof t?.function?.name === "string")
+        return t.function.name;
+    return "";
+}
+function systemPromptOf(messages) {
+    const system = messages.find((m) => isSystemMessage(m));
+    if (!system)
+        return "";
+    return typeof system.content === "string" ? system.content : system.text;
+}
+function normalizeScript(script) {
+    if ("done" in script) {
+        return { turns: [{ toolCalls: script.toolCalls }, { text: script.done }], repeatLast: true };
+    }
+    return script;
+}
+/** Tool rounds the transcript already holds: AI messages that proposed at least one tool call. */
+export function completedToolRounds(messages) {
+    let rounds = 0;
+    for (const m of messages) {
+        if (isAIMessage(m) && (m.tool_calls?.length ?? 0) > 0)
+            rounds += 1;
+    }
+    return rounds;
+}
+function resolveTurn(script, request) {
+    if (typeof script === "function")
+        return script(request.transcript);
+    const role = normalizeScript(script);
+    const { round, toolNames } = request;
+    if (round < role.turns.length)
+        return role.turns[round];
+    if (role.repeatLast && role.turns.length > 0)
+        return role.turns[role.turns.length - 1];
+    throw new Error(`ScriptedModel: the script for role [${toolNames.join(", ")}] has ${role.turns.length} turn(s) ` +
+        `but the transcript already holds ${round} completed tool round(s); ` +
+        "add a turn or set repeatLast.");
+}
+// ---------------------------------------------------------------------------
+// Rendering: the chunk sequence (stream), merged into one message for invoke
+// ---------------------------------------------------------------------------
+function usageMetadataOf(usage) {
+    if (!usage)
+        return undefined;
+    const hasCacheBuckets = usage.cacheReadTokens !== undefined || usage.cacheWriteTokens !== undefined;
+    return {
+        input_tokens: usage.inputTokens,
+        output_tokens: usage.outputTokens,
+        total_tokens: usage.inputTokens + usage.outputTokens,
+        ...(hasCacheBuckets
+            ? { input_token_details: { cache_read: usage.cacheReadTokens ?? 0, cache_creation: usage.cacheWriteTokens ?? 0 } }
+            : {}),
+    };
+}
+function reasoningBlock(reasoning, index) {
+    return { type: "reasoning", reasoning, ...(index !== undefined ? { index } : {}) };
+}
+function textBlock(text, index) {
+    return { type: "text", text, ...(index !== undefined ? { index } : {}) };
+}
+/**
+ * The chunk sequence `convertChunksToEvents` turns into the production event
+ * stream (see the header). An ending turn gets NO closing chunk: its message
+ * never finishes — the ending takes the call after these chunks.
+ */
+function renderTurnChunks(turn) {
+    const chunks = [];
+    let nextIndex = 0;
+    if (turn.reasoning) {
+        const index = nextIndex++;
+        chunks.push(new AIMessageChunk({ content: [reasoningBlock("", index)] }));
+        chunks.push(new AIMessageChunk({ content: [reasoningBlock(turn.reasoning, index)] }));
+    }
+    if (turn.text) {
+        if (turn.reasoning) {
+            const index = nextIndex++;
+            chunks.push(new AIMessageChunk({ content: [textBlock("", index)] }));
+            chunks.push(new AIMessageChunk({ content: [textBlock(turn.text, index)] }));
+        }
+        else {
+            nextIndex++;
+            chunks.push(new AIMessageChunk({ content: turn.text }));
+        }
+    }
+    for (const tc of turn.toolCalls ?? []) {
+        const index = nextIndex++;
+        chunks.push(new AIMessageChunk({
+            content: "",
+            tool_call_chunks: [{ type: "tool_call_chunk", id: tc.id, name: tc.name, args: JSON.stringify(tc.args), index }],
+        }));
     }
+    if (turn.ends)
+        return chunks;
+    const usage = usageMetadataOf(turn.usage);
+    // The closing chunk: carries usage onto message-finish, and guarantees at
+    // least one chunk so an empty turn is still a message.
+    chunks.push(new AIMessageChunk({ content: "", ...(usage ? { usage_metadata: usage } : {}) }));
+    return chunks;
 }
 /**
  * Read the pending approval interrupts from a graph state, exactly as the

package/dist/activities/execute-deep-agent/__test-utils__/scripted-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"scripted-model.js","sourceRoot":"","sources":["../../../../src/activities/execute-deep-agent/__test-utils__/scripted-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scripted-model.js","sourceRoot":"","sources":["../../../../src/activities/execute-deep-agent/__test-utils__/scripted-model.ts"],"names":[],"mappings":"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"}

package/dist/activities/execute-deep-agent/adapter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The native deep-agent harness as a `HarnessAdapter` — the worker- and
+ * session-lifetime half of its LangGraph slice, behind the turn runtime's
+ * contract (`harness/types.ts`). One engine turn is `turn.ts`'s
+ * `runDeepAgentTurn`; this module boots and delegates.
+ *
+ * What this adapter owns: the deepagents harness profiles (worker lifetime,
+ * registered once before the first `createDeepAgent`), and one engine turn
+ * (`runTurn`, through `turn.ts`). Everything else about a turn is the
+ * runtime's (`harness/run-turn.ts`).
+ *
+ * THIS MODULE'S STATIC GRAPH IS SDK-FREE, ON PURPOSE. The composition roots
+ * import the harness table (`src/harness-adapters.ts`) BEFORE they boot it,
+ * and that table's static graph must stay connect- and SDK-free (the Cursor
+ * adapter's boot patches `node:http2` before anything dials the control
+ * plane). So `deepagents` and `@langchain/*` — this harness's whole engine —
+ * are loaded with a dynamic import INSIDE `boot`, after the profiles are
+ * registered; a worker that does not serve this harness never pays for
+ * LangChain. `__tests__/adapter-graph-is-sdk-free.test.ts` pins it.
+ *
+ * Nothing is parked per session, and the header says so where the contract
+ * asks: the sqlite saver is opened and closed per turn and the MCP
+ * subprocesses are connected and closed per turn (`turn.ts`), so
+ * `shutdown` and `releaseSession` resolve as no-ops.
+ *
+ * What this adapter never does: throw out of `runTurn` (an engine failure is
+ * `failed` on the `internal` surface; the recursion limit is
+ * `tool_call_limit`; a `CancelledFailure` never exists here), branch on why
+ * `stopSignal` aborted, write a phase or a terminal copy, bind a state id
+ * (the thread id is the runtime's, `deterministic`), or import
+ * `@temporalio/*` (`__tests__/adapter-is-temporal-free.test.ts`).
+ *
+ * Extracted from `index.ts` `createDeepAgentActivities` at S3 M2a on the
+ * Cursor adapter's layout (`execute-cursor/adapter.ts`).
+ */
+import type { Config } from "../../config.js";
+import type { HarnessAdapter } from "../../harness/types.js";
+import type { DeepAgentAdapterConfig } from "./turn-setup.js";
+/** The config slice this adapter reads per turn, taken at `boot`; a whole `Config` satisfies it. */
+export declare function resolveDeepAgentConfig(config: Config): DeepAgentAdapterConfig;
+export declare function createDeepAgentAdapter(): HarnessAdapter;