@stigmer/runner 0.1.0-dev.20261017020314.g644422724c27

package/dist/activities/execute-deep-agent/turn-setup.js.map

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

package/dist/activities/execute-deep-agent/turn-stream.d.ts

@@ -0,0 +1,105 @@
+/**
+ * The native deep-agent harness's stream phase — the single per-event
+ * consumption loop that turns a live LangGraph v3 event stream into the
+ * streamed transcript and the one fact that decides how
+ * the turn goes on (the graph paused at a gate).
+ *
+ * What the loop asks of the runtime, through the sink (`harness/types.ts`):
+ * `recordActivity()` per event (with the tool name on a tool start), so the
+ * runtime's stall watchdog measures the engine; `reportUsage()` per
+ * `message_finish`, a sub-agent's included (`usageOf`, translator.ts), priced
+ * here at the registry's rates for the model the
+ * turn runs on (`shared/model-pricing.ts`), so the runtime accounts and
+ * enforces the cost cap and writes `streamingUsage`; `requestPersist()`
+ * where a discrete change or the streaming cadence says so
+ * (`shared/persist-decision.ts` over the builder's one dirty flag), AWAITED,
+ * so a platform STOP the runtime reads from that write aborts the signal
+ * before the next event is pulled; and `stopSignal`, checked at every event
+ * boundary and listened to inside the pull, where a stop cancels the graph
+ * run — the same act for every cause of stopping (the runtime knows why;
+ * this loop never does). An error the aborted run throws is the abort itself
+ * and settles `interrupted`, never `failed`.
+ *
+ * WHEN the run is aborted: on the arrival of the next
+ * event — the graph's own step boundary — or after {@link STOP_GRACE_MS} if
+ * no event arrives. A LangGraph run aborted while a step is in flight leaves
+ * `@langchain/core` with an orphaned rejection (`AsyncGeneratorWithSetup`
+ * races its first pull against the signal eagerly, and an abort mid-step
+ * rejects a promise nothing awaits), which surfaces as a process-level
+ * `unhandledRejection` — logged by `main.ts`, but noise the runner must not
+ * produce on every pause. Aborting as an event arrives is clean, and it is
+ * exactly when the orchestrator's loop aborted; so the loop never aborts
+ * right after a persist, even one that answered STOP — it lets the next
+ * event arrive and stops there. A live engine yields an event well inside
+ * the grace; a wedged engine (the runtime's stall watchdog is the caller
+ * here) is forced, and that one orphan is the price of unblocking it — the
+ * contract's bound on settling `interrupted` is what wins.
+ *
+ * Until #1096 this loop (`streaming-v3.ts`) armed its own 120 s stall
+ * check, pulsed the Temporal heartbeat every 2 s, read STOP from its own
+ * persist and activated a graceful-stop middleware on it, told a pause from
+ * the activity's cancellation signal, and wrote PAUSED, COMPLETED and
+ * TERMINATED itself; every one of those is the runtime's now, and the loop
+ * reports only `completed`, `awaiting_approval` or `interrupted`. The
+ * graph's recursion limit propagates as its own error for `turn.ts` to
+ * classify (`tool_call_limit`), and an empty stream is an error the same
+ * way (`failed` on the `internal` surface).
+ */
+import type { TurnInput, TurnSink } from "../../harness/types.js";
+import { InlinePublisher } from "./inline-publisher.js";
+import { StreamingSideEffects } from "./streaming-side-effects.js";
+import { type V3ProtocolEvent } from "./v3-event-recorder.js";
+import { DeepAgentTranslator } from "./translator.js";
+import type { DeepAgentEngine, DeepAgentGraphInput, DeepAgentWorkspace } from "./turn-setup.js";
+/**
+ * The subset of the v3 `GraphRunStream` this loop consumes. Kept structural
+ * so the loop is unit-testable with a scripted stream — no live graph.
+ */
+export interface StreamableRun extends AsyncIterable<V3ProtocolEvent> {
+    readonly output: Promise<unknown>;
+}
+/**
+ * Why the turn's stream ended. `completed` and `awaiting_approval` proceed to
+ * the settle; `interrupted` is the runtime's stop, and the adapter settles
+ * `interrupted` (the runtime classifies the cause from its own evidence).
+ */
+export type DeepAgentStreamReason = "completed" | "awaiting_approval" | "interrupted";
+export interface DeepAgentStreamResult {
+    readonly reason: DeepAgentStreamReason;
+    readonly eventsProcessed: number;
+    /** The graph's final state (`structuredResponse` rides it); absent unless the stream completed and the output resolved in time. */
+    readonly runOutput: Record<string, unknown> | undefined;
+}
+/**
+ * This harness's transcript writers for one turn: the translator that turns
+ * the engine's events into canonical ones (over the gate's posture, so every
+ * tool start carries its attribution and gate answer), and the publisher
+ * that registers artifacts on the runtime's builder (`sink.transcript`, so
+ * a published artifact still dirties the next persist) and checks the rows
+ * already on `sink.status` before uploading, so an earlier turn's unchanged
+ * file is not sent again; and the side effects that fire the publisher
+ * mid-turn and hold its in-flight uploads until they are drained. The
+ * builder itself is the runtime's, one per turn, and is read from the sink
+ * where it is needed. Built by the adapter's turn once and shared by the
+ * stream, the settle and the turn's `finally`, which drains the publishes
+ * on every exit (`streaming-side-effects.ts`).
+ */
+export interface DeepAgentTranscript {
+    readonly translator: DeepAgentTranslator;
+    readonly publisher: InlinePublisher;
+    readonly sideEffects: StreamingSideEffects;
+}
+export declare function createDeepAgentTranscript(input: TurnInput, sink: TurnSink, engine: DeepAgentEngine, workspace: DeepAgentWorkspace): DeepAgentTranscript;
+export interface DeepAgentStreamDeps {
+    readonly input: TurnInput;
+    readonly sink: TurnSink;
+    readonly engine: DeepAgentEngine;
+    readonly graphInput: DeepAgentGraphInput;
+    readonly transcript: DeepAgentTranscript;
+}
+/**
+ * Start the graph run and consume it to the end, folding every event into
+ * the transcript. Returns why it ended; throws only what `turn.ts`
+ * classifies (the recursion limit, an empty stream, an engine error).
+ */
+export declare function consumeDeepAgentStream(deps: DeepAgentStreamDeps): Promise<DeepAgentStreamResult>;

package/dist/activities/execute-deep-agent/turn-stream.js

@@ -0,0 +1,236 @@
+/**
+ * The native deep-agent harness's stream phase — the single per-event
+ * consumption loop that turns a live LangGraph v3 event stream into the
+ * streamed transcript and the one fact that decides how
+ * the turn goes on (the graph paused at a gate).
+ *
+ * What the loop asks of the runtime, through the sink (`harness/types.ts`):
+ * `recordActivity()` per event (with the tool name on a tool start), so the
+ * runtime's stall watchdog measures the engine; `reportUsage()` per
+ * `message_finish`, a sub-agent's included (`usageOf`, translator.ts), priced
+ * here at the registry's rates for the model the
+ * turn runs on (`shared/model-pricing.ts`), so the runtime accounts and
+ * enforces the cost cap and writes `streamingUsage`; `requestPersist()`
+ * where a discrete change or the streaming cadence says so
+ * (`shared/persist-decision.ts` over the builder's one dirty flag), AWAITED,
+ * so a platform STOP the runtime reads from that write aborts the signal
+ * before the next event is pulled; and `stopSignal`, checked at every event
+ * boundary and listened to inside the pull, where a stop cancels the graph
+ * run — the same act for every cause of stopping (the runtime knows why;
+ * this loop never does). An error the aborted run throws is the abort itself
+ * and settles `interrupted`, never `failed`.
+ *
+ * WHEN the run is aborted: on the arrival of the next
+ * event — the graph's own step boundary — or after {@link STOP_GRACE_MS} if
+ * no event arrives. A LangGraph run aborted while a step is in flight leaves
+ * `@langchain/core` with an orphaned rejection (`AsyncGeneratorWithSetup`
+ * races its first pull against the signal eagerly, and an abort mid-step
+ * rejects a promise nothing awaits), which surfaces as a process-level
+ * `unhandledRejection` — logged by `main.ts`, but noise the runner must not
+ * produce on every pause. Aborting as an event arrives is clean, and it is
+ * exactly when the orchestrator's loop aborted; so the loop never aborts
+ * right after a persist, even one that answered STOP — it lets the next
+ * event arrive and stops there. A live engine yields an event well inside
+ * the grace; a wedged engine (the runtime's stall watchdog is the caller
+ * here) is forced, and that one orphan is the price of unblocking it — the
+ * contract's bound on settling `interrupted` is what wins.
+ *
+ * Until #1096 this loop (`streaming-v3.ts`) armed its own 120 s stall
+ * check, pulsed the Temporal heartbeat every 2 s, read STOP from its own
+ * persist and activated a graceful-stop middleware on it, told a pause from
+ * the activity's cancellation signal, and wrote PAUSED, COMPLETED and
+ * TERMINATED itself; every one of those is the runtime's now, and the loop
+ * reports only `completed`, `awaiting_approval` or `interrupted`. The
+ * graph's recursion limit propagates as its own error for `turn.ts` to
+ * classify (`tool_call_limit`), and an empty stream is an error the same
+ * way (`failed` on the `internal` surface).
+ */
+import { shouldPersistStreamingStatus } from "../../shared/persist-decision.js";
+import { StreamingUpdateScheduler, loadStreamingConfig } from "../../shared/streaming-scheduler.js";
+import { computeTurnCost } from "../../shared/model-pricing.js";
+import { TimeoutError, withTimeout } from "../../shared/with-timeout.js";
+import { InlinePublisher } from "./inline-publisher.js";
+import { StreamingSideEffects } from "./streaming-side-effects.js";
+import { createV3EventRecorder } from "./v3-event-recorder.js";
+import { DeepAgentTranslator, usageOf } from "./translator.js";
+/**
+ * How long the loop waits for `run.output` after the stream ended before
+ * proceeding without the final state (the structured response rides it).
+ */
+const RUN_OUTPUT_TIMEOUT_MS = 30_000;
+/**
+ * How long a stop waits for the next event before the run is aborted
+ * mid-step (see the header). Well inside the contract kit's settle bound and
+ * far above any token cadence a live model has.
+ */
+const STOP_GRACE_MS = 1_000;
+export function createDeepAgentTranscript(input, sink, engine, workspace) {
+    const translator = new DeepAgentTranslator(engine.gate);
+    const publisher = new InlinePublisher({
+        workspaceBackend: workspace.backend,
+        artifactStorage: input.artifactStorage,
+        artifacts: sink.transcript,
+        record: sink.status,
+        executionId: input.executionId,
+    });
+    return { translator, publisher, sideEffects: new StreamingSideEffects({ inlinePublisher: publisher }) };
+}
+/**
+ * Price one `message-finish`'s usage at the engine's rates and report it to
+ * the sink, which accounts, enforces the cost cap and writes `streamingUsage`
+ * (one writer of the summary). LangChain's `input_tokens` already INCLUDES the cache buckets
+ * (the Anthropic adapter folds them in; the cost advisory reads them the same
+ * way), so the counts are reported as delivered and the price is computed
+ * over the disjoint buckets. A sub-agent on its own model is priced at the
+ * parent's rate, as the in-graph cost cap always did (per-sub-agent pricing
+ * is #1121).
+ */
+function reportUsage(sink, engine, usage) {
+    const inputTokens = usage.input_tokens ?? 0;
+    const outputTokens = usage.output_tokens ?? 0;
+    const cacheReadTokens = usage.input_token_details?.cache_read ?? 0;
+    const cacheWriteTokens = usage.input_token_details?.cache_creation ?? 0;
+    const uncachedInput = Math.max(inputTokens - cacheReadTokens - cacheWriteTokens, 0);
+    sink.reportUsage({
+        inputTokens,
+        outputTokens,
+        cacheReadTokens,
+        cacheWriteTokens,
+        estimatedCostUsd: computeTurnCost(engine.pricing, uncachedInput, outputTokens, cacheWriteTokens, cacheReadTokens),
+        model: engine.modelName,
+    });
+}
+/**
+ * Start the graph run and consume it to the end, folding every event into
+ * the transcript. Returns why it ended; throws only what `turn.ts`
+ * classifies (the recursion limit, an empty stream, an engine error).
+ */
+export async function consumeDeepAgentStream(deps) {
+    const { input, sink, engine, graphInput, transcript } = deps;
+    const { executionId } = input;
+    const { translator, sideEffects } = transcript;
+    const builder = sink.transcript;
+    const scheduler = new StreamingUpdateScheduler(loadStreamingConfig());
+    const recorder = createV3EventRecorder(executionId, process.env.V3_EVENT_RECORD_DIR);
+    const abortController = new AbortController();
+    let forceAbort;
+    const abortRun = () => {
+        if (forceAbort !== undefined)
+            clearTimeout(forceAbort);
+        forceAbort = undefined;
+        abortController.abort("stopped by the runtime");
+    };
+    const onStop = () => {
+        forceAbort = setTimeout(abortRun, STOP_GRACE_MS);
+    };
+    sink.stopSignal.addEventListener("abort", onStop, { once: true });
+    let eventsProcessed = 0;
+    /** The stop, taken at a boundary: abort the run now and settle. */
+    const interrupted = () => {
+        abortRun();
+        return { reason: "interrupted", eventsProcessed, runOutput: undefined };
+    };
+    try {
+        if (sink.stopSignal.aborted)
+            return interrupted();
+        const run = (await engine.graph.streamEvents(graphInput.kind === "resume" ? graphInput.command : graphInput.input, { ...engine.langgraphConfig, version: "v3", signal: abortController.signal }));
+        sink.recordActivity();
+        // An aborted run rejects `run.output` with the abort error; an
+        // interrupted turn never awaits it (there is no final state to read), so
+        // the rejection is claimed here or it surfaces as unhandled. A completed
+        // turn still awaits the same promise below and reads its value.
+        run.output.catch(() => undefined);
+        try {
+            for await (const event of run) {
+                if (sink.stopSignal.aborted)
+                    return interrupted();
+                recorder?.record(event, eventsProcessed);
+                let detail;
+                for (const normalized of translator.translate(event)) {
+                    builder.apply(normalized);
+                    sideEffects.onEvent(normalized);
+                    if (normalized.kind === "tool_started")
+                        detail = normalized.name;
+                }
+                const usage = usageOf(event);
+                if (usage)
+                    reportUsage(sink, engine, usage);
+                eventsProcessed++;
+                sink.recordActivity(detail);
+                const persist = shouldPersistStreamingStatus(builder.dirty, scheduler, eventsProcessed);
+                if (!persist)
+                    continue;
+                // Cleared as the write is requested, not after it lands: a change
+                // that folds while the write is in flight must dirty the next one.
+                builder.markPersisted();
+                // The runtime attaches the mid-run file-change progress on this write
+                // (the chokepoint's step 2), as it does on every write. Awaited so a platform STOP the runtime reads from this write has
+                // aborted the signal by the time the next event arrives — where the
+                // stop is taken (see the header on why not here).
+                await sink.requestPersist();
+                scheduler.markUpdateSent(eventsProcessed);
+            }
+        }
+        catch (err) {
+            // The aborted run throws its own abort out of the pull; that is the
+            // stop the runtime asked for, not a failure.
+            if (sink.stopSignal.aborted)
+                return interrupted();
+            throw err;
+        }
+        if (eventsProcessed === 0) {
+            throw new Error("Stream completed without processing any events. " +
+                "This may indicate a configuration error or v3 API incompatibility.");
+        }
+        if (builder.awaitingApproval) {
+            console.log(`[turn-stream] execution=${executionId} stream ended at a gate; awaiting approval`);
+            return { reason: "awaiting_approval", eventsProcessed, runOutput: undefined };
+        }
+        console.log(`[turn-stream] execution=${executionId} stream finished — processed ${eventsProcessed} events`);
+        const runOutput = await extractRunOutput(run, executionId);
+        sink.recordActivity();
+        return { reason: "completed", eventsProcessed, runOutput };
+    }
+    finally {
+        sink.stopSignal.removeEventListener("abort", onStop);
+        if (forceAbort !== undefined)
+            clearTimeout(forceAbort);
+        await recorder?.flush();
+    }
+}
+/**
+ * The graph's final state, bounded: `run.output` normally resolves the
+ * moment the stream ends, but a state that never settles must not hold the
+ * turn (the structured response is recoverable from the final text; the
+ * runtime's epilogue does that).
+ *
+ * Bounded through the shared `withTimeout`, never a hand-rolled
+ * `Promise.race` against a bare `setTimeout`: a race leaves its losing timer
+ * armed, and a referenced timer holds the Node event loop open. The
+ * orchestrator's copy of this wait left a 30 s timer behind every completed
+ * execution, so a runner asked to exit right after one idled for the full
+ * Kubernetes termination grace (stigmer#1008, fixed on the orchestrator in
+ * stigmer#1092 while this adapter was on its branch; this copy had cleared
+ * its timer in a `finally` from the start, and took the shared shape at the
+ * merge so there is one way to bound a wait). `withTimeout` clears the timer
+ * on whichever side settles first; `turn-stream.test.ts` pins that nothing
+ * stays armed on either side.
+ */
+async function extractRunOutput(run, executionId) {
+    try {
+        const finalState = await withTimeout(RUN_OUTPUT_TIMEOUT_MS, `run.output did not resolve within ${RUN_OUTPUT_TIMEOUT_MS}ms`, () => run.output);
+        const output = finalState;
+        console.log(`[turn-stream] execution=${executionId} — run.output resolved. ` +
+            `Keys: [${Object.keys(output ?? {}).join(", ")}]. hasStructuredResponse=${output?.structuredResponse !== undefined}`);
+        return output;
+    }
+    catch (err) {
+        if (err instanceof TimeoutError) {
+            console.warn(`[turn-stream] execution=${executionId} — ${err.message}. Proceeding without final state.`);
+            return undefined;
+        }
+        console.warn(`[turn-stream] execution=${executionId} — run.output rejected: ${err}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=turn-stream.js.map

package/dist/activities/execute-deep-agent/turn-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-stream.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/turn-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,OAAO,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAwB,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAuB,MAAM,iBAAiB,CAAC;AAWpF;;;GAGG;AACH,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAErC;;;;GAIG;AACH,MAAM,aAAa,GAAG,KAAK,CAAC;AAoC5B,MAAM,UAAU,yBAAyB,CACvC,KAAgB,EAChB,IAAc,EACd,MAAuB,EACvB,SAA6B;IAE7B,MAAM,UAAU,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC;QACpC,gBAAgB,EAAE,SAAS,CAAC,OAAO;QACnC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,SAAS,EAAE,IAAI,CAAC,UAAU;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC;IACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,oBAAoB,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AAC1G,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,WAAW,CAAC,IAAc,EAAE,MAAuB,EAAE,KAAqB;IACjF,MAAM,WAAW,GAAG,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,mBAAmB,EAAE,UAAU,IAAI,CAAC,CAAC;IACnE,MAAM,gBAAgB,GAAG,KAAK,CAAC,mBAAmB,EAAE,cAAc,IAAI,CAAC,CAAC;IACxE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,eAAe,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACpF,IAAI,CAAC,WAAW,CAAC;QACf,WAAW;QACX,YAAY;QACZ,eAAe;QACf,gBAAgB;QAChB,gBAAgB,EAAE,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,CAAC;QACjH,KAAK,EAAE,MAAM,CAAC,SAAS;KACxB,CAAC,CAAC;AACL,CAAC;AAUD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAyB;IACpE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC7D,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAC9B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC;IAEhC,MAAM,SAAS,GAAG,IAAI,wBAAwB,CAAC,mBAAmB,EAAE,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACrF,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,IAAI,UAAqD,CAAC;IAC1D,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,UAAU,KAAK,SAAS;YAAE,YAAY,CAAC,UAAU,CAAC,CAAC;QACvD,UAAU,GAAG,SAAS,CAAC;QACvB,eAAe,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAClD,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACnD,CAAC,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAElE,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,mEAAmE;IACnE,MAAM,WAAW,GAAG,GAA0B,EAAE;QAC9C,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAC1E,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO,WAAW,EAAE,CAAC;QAElD,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAC1C,UAAU,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,EACpE,EAAE,GAAG,MAAM,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,CAC7E,CAAkB,CAAC;QACpB,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,+DAA+D;QAC/D,yEAAyE;QACzE,yEAAyE;QACzE,gEAAgE;QAChE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAElC,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO;oBAAE,OAAO,WAAW,EAAE,CAAC;gBAElD,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;gBACzC,IAAI,MAA0B,CAAC;gBAC/B,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrD,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;oBAC1B,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAChC,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc;wBAAE,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;gBACnE,CAAC;gBACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,KAAK;oBAAE,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;gBAC5C,eAAe,EAAE,CAAC;gBAClB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;gBAE5B,MAAM,OAAO,GAAG,4BAA4B,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;gBACxF,IAAI,CAAC,OAAO;oBAAE,SAAS;gBACvB,kEAAkE;gBAClE,mEAAmE;gBACnE,OAAO,CAAC,aAAa,EAAE,CAAC;gBACxB,sEAAsE;gBACtE,yHAAyH;gBACzH,oEAAoE;gBACpE,kDAAkD;gBAClD,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC5B,SAAS,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oEAAoE;YACpE,6CAA6C;YAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO,WAAW,EAAE,CAAC;YAClD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,kDAAkD;gBAClD,oEAAoE,CACrE,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,4CAA4C,CAAC,CAAC;YAChG,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAChF,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,gCAAgC,eAAe,SAAS,CAAC,CAAC;QAC5G,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;IAC7D,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,UAAU,KAAK,SAAS;YAAE,YAAY,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,UAAU,gBAAgB,CAAC,GAAkB,EAAE,WAAmB;IACrE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,WAAW,CAClC,qBAAqB,EACrB,qCAAqC,qBAAqB,IAAI,EAC9D,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CACjB,CAAC;QACF,MAAM,MAAM,GAAG,UAAqC,CAAC;QACrD,OAAO,CAAC,GAAG,CACT,2BAA2B,WAAW,0BAA0B;YAChE,UAAU,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,4BAA4B,MAAM,EAAE,kBAAkB,KAAK,SAAS,EAAE,CACrH,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,YAAY,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,2BAA2B,WAAW,MAAM,GAAG,CAAC,OAAO,mCAAmC,CAAC,CAAC;YACzG,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,2BAA2B,WAAW,2BAA2B,GAAG,EAAE,CAAC,CAAC;QACrF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * One native deep-agent engine turn — the LangGraph slice of the harness,
+ * behind the turn runtime's contract (`harness/types.ts`).
+ *
+ * `runDeepAgentTurn` is what `adapter.ts`'s `runTurn` delegates to: the
+ * setup over the runtime's record (`turn-setup.ts`), the stream over the
+ * sink (`turn-stream.ts`), the settle (`turn-settle.ts`), and its own
+ * teardown — the MCP connection and the checkpoint saver. Everything else
+ * about a turn is the runtime's (`harness/run-turn.ts`): the resolution
+ * phases, the workspace lock and the `.stigmer` link, the persist
+ * chokepoint, the watchdog, the heartbeat, the cost cap, the interruption
+ * table, the completion epilogue, the SKIP/REJECT settlement.
+ *
+ * This module is where `deepagents` and `@langchain/*` enter the adapter's
+ * graph (through `turn-setup.ts` and its siblings), which is WHY it is a
+ * separate module from `adapter.ts` and is loaded there with a dynamic
+ * import inside `boot`: the harness table's static graph must stay SDK-free
+ * so a worker that does not serve this harness never pays for LangChain
+ * (`harness-adapters.ts`). Nothing outside `adapter.ts` imports this module.
+ *
+ * Never throws out of `runDeepAgentTurn`: the graph exhausting its recursion
+ * limit is the `tool_call_limit` outcome (the platform's budget, not a
+ * failure; the runtime writes TERMINATED with the cross-repo prefix); a
+ * tool list that names nothing the turn has (`ToolListResolutionError`) or
+ * a hook that cannot run as written (`HookSetupError`) is `failed` on the
+ * `actionable` surface with the error's own sentence, since the fix is the
+ * agent's author's, not the runner's; any other exception — a provider error unwrapped from LangChain's middleware
+ * wrapper, an MCP connect failure, an empty stream — is `failed` on the
+ * `internal` surface with `describeExecutionError`'s sentence as
+ * `status.error` whole, and it returns only after the inline publishes the
+ * turn already fired have landed on the status (the drain in the `finally`),
+ * so an artifact the agent wrote before the throw is on the terminal status
+ * the runtime then persists (stigmer#1116). Never branches on why `stopSignal`
+ * aborted, never writes a phase or a terminal copy, never imports
+ * `@temporalio/*` (`__tests__/adapter-is-temporal-free.test.ts`).
+ *
+ * Engine disposition: nothing is parked between turns. The sqlite saver is
+ * opened and closed per turn (it holds an OS handle); the MCP subprocesses
+ * are connected and closed per turn. Both are closed on EVERY exit path in
+ * the `finally`, before the runtime removes the link and releases the lock.
+ *
+ * Extracted from `index.ts` `createDeepAgentActivities` in #1096; the
+ * hermetic goldens under `__tests__/hermetic/` pin the result byte for
+ * byte, with that move's deliberate alignments quoted in their headers.
+ */
+import type { TurnInput, TurnOutcome, TurnSink } from "../../harness/types.js";
+import { type DeepAgentAdapterConfig } from "./turn-setup.js";
+export declare function runDeepAgentTurn(input: TurnInput, sink: TurnSink, config: DeepAgentAdapterConfig): Promise<TurnOutcome>;

package/dist/activities/execute-deep-agent/turn.js

@@ -0,0 +1,136 @@
+/**
+ * One native deep-agent engine turn — the LangGraph slice of the harness,
+ * behind the turn runtime's contract (`harness/types.ts`).
+ *
+ * `runDeepAgentTurn` is what `adapter.ts`'s `runTurn` delegates to: the
+ * setup over the runtime's record (`turn-setup.ts`), the stream over the
+ * sink (`turn-stream.ts`), the settle (`turn-settle.ts`), and its own
+ * teardown — the MCP connection and the checkpoint saver. Everything else
+ * about a turn is the runtime's (`harness/run-turn.ts`): the resolution
+ * phases, the workspace lock and the `.stigmer` link, the persist
+ * chokepoint, the watchdog, the heartbeat, the cost cap, the interruption
+ * table, the completion epilogue, the SKIP/REJECT settlement.
+ *
+ * This module is where `deepagents` and `@langchain/*` enter the adapter's
+ * graph (through `turn-setup.ts` and its siblings), which is WHY it is a
+ * separate module from `adapter.ts` and is loaded there with a dynamic
+ * import inside `boot`: the harness table's static graph must stay SDK-free
+ * so a worker that does not serve this harness never pays for LangChain
+ * (`harness-adapters.ts`). Nothing outside `adapter.ts` imports this module.
+ *
+ * Never throws out of `runDeepAgentTurn`: the graph exhausting its recursion
+ * limit is the `tool_call_limit` outcome (the platform's budget, not a
+ * failure; the runtime writes TERMINATED with the cross-repo prefix); a
+ * tool list that names nothing the turn has (`ToolListResolutionError`) or
+ * a hook that cannot run as written (`HookSetupError`) is `failed` on the
+ * `actionable` surface with the error's own sentence, since the fix is the
+ * agent's author's, not the runner's; any other exception — a provider error unwrapped from LangChain's middleware
+ * wrapper, an MCP connect failure, an empty stream — is `failed` on the
+ * `internal` surface with `describeExecutionError`'s sentence as
+ * `status.error` whole, and it returns only after the inline publishes the
+ * turn already fired have landed on the status (the drain in the `finally`),
+ * so an artifact the agent wrote before the throw is on the terminal status
+ * the runtime then persists (stigmer#1116). Never branches on why `stopSignal`
+ * aborted, never writes a phase or a terminal copy, never imports
+ * `@temporalio/*` (`__tests__/adapter-is-temporal-free.test.ts`).
+ *
+ * Engine disposition: nothing is parked between turns. The sqlite saver is
+ * opened and closed per turn (it holds an OS handle); the MCP subprocesses
+ * are connected and closed per turn. Both are closed on EVERY exit path in
+ * the `finally`, before the runtime removes the link and releases the lock.
+ *
+ * Extracted from `index.ts` `createDeepAgentActivities` in #1096; the
+ * hermetic goldens under `__tests__/hermetic/` pin the result byte for
+ * byte, with that move's deliberate alignments quoted in their headers.
+ */
+import { tryInferProvider } from "../../shared/llm-proxy.js";
+import { describeExecutionError } from "../../shared/model-error.js";
+import { isToolCallBudgetStop } from "../../shared/tool-rounds.js";
+import { ToolListResolutionError } from "../../shared/tool-lists.js";
+import { HookSetupError } from "./hooks-setup.js";
+import { buildDeepAgentWorkspace, buildEngine, composeGraphInput, connectTools, openCheckpointer, readGateState, resolveModelName, } from "./turn-setup.js";
+import { consumeDeepAgentStream, createDeepAgentTranscript } from "./turn-stream.js";
+import { settleDeepAgentTurn } from "./turn-settle.js";
+export async function runDeepAgentTurn(input, sink, config) {
+    if (sink.stopSignal.aborted)
+        return { kind: "interrupted" };
+    let checkpointer;
+    let connection;
+    let modelName;
+    let transcript;
+    try {
+        modelName = await resolveModelName(input);
+        checkpointer = await openCheckpointer(input, sink, config);
+        const workspace = buildDeepAgentWorkspace(input);
+        // What this engine observes touching CAS-owned paths — the one capture
+        // fact the runtime cannot read from the tree (`harness/capture.ts`).
+        sink.bindCasObservations(() => workspace.casObserver.snapshot());
+        const tools = await connectTools(input, sink);
+        connection = tools.connection;
+        if (sink.stopSignal.aborted)
+            return { kind: "interrupted" };
+        const gate = readGateState(input, tools);
+        const engine = await buildEngine(input, sink, config, { modelName, checkpointer, workspace, tools, gate });
+        if (sink.stopSignal.aborted)
+            return { kind: "interrupted" };
+        const graphInput = await composeGraphInput(input, engine);
+        sink.recordActivity();
+        transcript = createDeepAgentTranscript(input, sink, engine, workspace);
+        const stream = await consumeDeepAgentStream({ input, sink, engine, graphInput, transcript });
+        return await settleDeepAgentTurn({ input, sink, engine, transcript, stream });
+    }
+    catch (err) {
+        return classifyThrown(err, input, config, modelName);
+    }
+    finally {
+        // First, on every exit: the runtime persists the terminal status as soon
+        // as this returns, so an upload still in flight must land before then.
+        // A settled turn already drained in its settle; this is then a no-op.
+        await transcript?.sideEffects.drainPublishes();
+        await closeQuietly(input.executionId, "MCP connection", () => connection?.client.close());
+        // Only the durable sqlite saver holds an OS handle (an open DB file);
+        // memory/http savers have no close(), so this is duck-typed.
+        const closable = checkpointer;
+        await closeQuietly(input.executionId, "checkpointer", () => closable?.close?.());
+    }
+}
+/**
+ * An exception that escaped the turn, classified. The tool-call budget's stop
+ * (the execution budget's round limit, or its recursion-limit backstop;
+ * `shared/tool-rounds.ts`) is the budget's own signal, not an error:
+ * the work is checkpointed and the conversation continues on the next
+ * message. A tool list that resolves to nothing refuses the turn with its
+ * own sentence, naming the agent or sub-agent and its entries, and so does
+ * a hook that cannot run as written (`hooks-setup.ts`). Anything else
+ * is described by `describeExecutionError` (a model error arrives
+ * MiddlewareError-wrapped with raw provider prose and is unwrapped to its
+ * stable platform code; non-model errors keep the root error's identity) on
+ * the `internal` surface: the runner or its transport broke.
+ */
+function classifyThrown(err, input, config, modelName) {
+    if (isToolCallBudgetStop(err)) {
+        console.log(`ExecuteDeepAgent reached the tool-call limit: execution=${input.executionId}`);
+        return { kind: "tool_call_limit" };
+    }
+    if (err instanceof ToolListResolutionError || err instanceof HookSetupError) {
+        console.warn(`ExecuteDeepAgent refused the turn: execution=${input.executionId}, ${err.message}`);
+        return { kind: "failed", surface: "actionable", message: err.message, cause: err };
+    }
+    const { errorType, errorMessage } = describeExecutionError(err, {
+        proxyMode: !!config.proxyEndpoint,
+        modelId: modelName,
+        provider: modelName ? (tryInferProvider(modelName) ?? undefined) : undefined,
+    });
+    console.error(`ExecuteDeepAgent failed: execution=${input.executionId}, [${errorType}] ${errorMessage}`);
+    return { kind: "failed", surface: "internal", message: `[${errorType}] ${errorMessage}`, cause: err };
+}
+/** Best-effort teardown: a failed close is logged and never masks the turn's outcome. */
+async function closeQuietly(executionId, what, close) {
+    try {
+        await close();
+    }
+    catch (err) {
+        console.warn(`ExecuteDeepAgent ${what} cleanup failed (non-fatal): execution=${executionId}, error=${err}`);
+    }
+}
+//# sourceMappingURL=turn.js.map

package/dist/activities/execute-deep-agent/turn.js.map

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

package/dist/activities/execute-deep-agent/v3-event-recorder.d.ts

@@ -0,0 +1,32 @@
+/**
+ * V3 event recorder for capturing raw LangGraph v3 ProtocolEvents.
+ *
+ * Activated by the V3_EVENT_RECORD_DIR environment variable. When set,
+ * the adapter's stream loop (`turn-stream.ts`) records every raw protocol
+ * event and flushes them atomically to a JSON file after the stream
+ * completes — the native twin of `execute-cursor/cursor-event-recorder.ts`.
+ *
+ * Development infrastructure: the captured events are the ground truth the
+ * v3 fixtures (`__test-utils__/v3-event-fixtures.ts`) and the builder's
+ * tests were shaped from, and the way a new provider's event shape is read.
+ */
+export interface V3EventRecorder {
+    record(event: V3ProtocolEvent, seq: number): void;
+    flush(): Promise<void>;
+}
+export interface V3ProtocolEvent {
+    readonly type: string;
+    readonly seq: number;
+    readonly method: string;
+    readonly params: {
+        readonly namespace: string[];
+        readonly timestamp: number;
+        readonly node?: string;
+        readonly data: unknown;
+    };
+}
+/**
+ * Create a recorder if V3_EVENT_RECORD_DIR is set, otherwise return undefined.
+ * The caller does `recorder?.record(event, seq)` — zero overhead when off.
+ */
+export declare function createV3EventRecorder(executionId: string, recordDir: string | undefined): V3EventRecorder | undefined;