@stigmer/runner 3.14.0 → 3.15.0

package/dist/activities/execute-cursor/turn-stream.d.ts

@@ -1,35 +1,42 @@
 /**
  * The Cursor harness's stream phase — the single per-event consumption loop that
  * turns a live Cursor SDK run into the streamed transcript, mid-run progress, and
- * the flags that decide how the turn ends.
+ * the one flag that decides how the turn goes on (the first-denial stop).
  *
- * Extracted from the activity entry point (index.ts) so that BOTH the primary
- * turn and the two recovery retries (poisoned-handle / transport-timeout) drive
- * the exact same code. The retries previously re-implemented a stripped "bare"
+ * Extracted from the activity entry point so that BOTH the primary turn and
+ * the two recovery retries (poisoned-handle / transport-timeout) drive the
+ * exact same code. The retries previously re-implemented a stripped "bare"
  * loop that dropped live persist, DD-32/DD-33 mid-run progress, sub-agent
- * tracking, the first-denial early stop, and correct pause/stall handling — so a
+ * tracking, the first-denial early stop, and correct pause handling — so a
  * retry froze the UI and mis-handled a mid-retry pause. One loop removes that
  * drift by construction.
  *
- * This mirrors the deep-agent harness's `streamExecution` seam
- * (execute-deep-agent/streaming.ts): injected `heartbeat`/`isCancelled` so it
- * runs without Temporal, a structural `StreamableRun` so it runs without the live
- * SDK, and a result (the terminal reason) instead of internal terminal mapping.
- * The one deliberate difference: this consumer REPORTS why the stream ended and
- * leaves the terminal MAPPING to the activity, because Cursor's mapping is
- * entangled with worker-shutdown-vs-pause disambiguation, the turn boundary,
- * structured output, and recovery retries — all of which must stay in index.ts.
+ * What the loop asks of the runtime, through the sink (`harness/types.ts`):
+ * `recordActivity()` per event (with the tool name) and per delta, so the
+ * runtime's stall watchdog measures the engine; `reportUsage()` per
+ * `turn-ended` delta, priced here at the requested variant's rates
+ * (`usage-pricing.ts`), so the runtime accounts and enforces the cost cap;
+ * `requestPersist()` where a discrete change or the streaming cadence says
+ * so (`shared/persist-decision.ts` over this loop's own dirty flags), 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 an abort cancels the SDK
+ * run — the one way a wedged stream is unblocked, and the same act for every
+ * cause of stopping (the runtime knows why; this loop never does).
+ *
+ * Until S2 M3 this loop armed its own stall watchdog, enforced the cost cap,
+ * read STOP from its own persist, and told a pause from the activity's
+ * cancellation signal; every one of those is the runtime's now, and the loop
+ * reports only `completed`, `first-denial` or `interrupted`.
  */
-import type { AgentExecutionStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
-import { ExecutionControlSignal } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
 import type { SDKMessage, InteractionUpdate } from "@cursor/sdk";
-import { StallTimeoutError, type StallWatchdog } from "../../shared/stall-watchdog.js";
+import type { TurnSink } from "../../harness/types.js";
 import { type ProgressCaptureState, type ProgressSubstrate } from "../../shared/filereview/progress.js";
 import type { MessageAccumulator } from "./message-translator.js";
 import type { DeltaEnricher } from "./delta-enricher.js";
 import type { TodoTracker } from "./todo-tracker.js";
 import type { StreamingUpdateScheduler } from "../../shared/streaming-scheduler.js";
-import type { UsageAccumulator } from "./usage-accumulator.js";
+import type { CursorUsagePricer } from "./usage-pricing.js";
 import type { createCursorEventRecorder } from "./cursor-event-recorder.js";
 /**
  * The subset of the Cursor SDK `Run` the stream phase consumes. Kept structural
@@ -42,75 +49,47 @@ export interface StreamableRun {
 }
 export type CursorTurnEventRecorder = ReturnType<typeof createCursorEventRecorder>;
 /**
- * Why the turn's stream ended. The activity maps each reason to a terminal
- * outcome (see resolvePreBoundaryTerminal in index.ts): `completed` and
- * `first-denial` proceed to the turn boundary; the rest are pre-boundary
- * terminals that return or throw.
+ * Why the turn's stream ended. `completed` and `first-denial` proceed to the
+ * turn boundary; `interrupted` is the runtime's stop, and the adapter settles
+ * `interrupted` (the runtime classifies the cause from its own evidence).
  */
-export type TurnStreamReason = "completed" | "paused" | "stalled" | "first-denial" | "platform-stop" | "cost-cap";
+export type TurnStreamReason = "completed" | "first-denial" | "interrupted";
 /**
- * Single owner for every flag the turn's stream produces. Before this, these
- * eleven fields lived as scattered `let`s co-written by FOUR concurrent
- * producers — the SDK `onDelta`, the fs denial-watcher, the stall-watchdog, and
- * the loop — the classic "who writes this field?" hazard. Consolidating them into
- * one object (created once per turn, shared by every producer, the epilogue, and
- * the outer catch/finally) makes ownership explicit and lets the primary turn and
- * both recovery retries drive the identical stream code.
- *
- * Field ownership is annotated per field: exactly one primary writer, plus any
- * documented producer/consumer handshakes.
+ * The flags the turn's stream produces that outlive the loop: created once per
+ * turn and shared by the primary stream, both recovery retries, the boundary
+ * and the settle, so every reader sees ONE source of truth. Field ownership
+ * is annotated per field: exactly one primary writer.
  */
 export interface TurnStreamState {
-    /** Written by: onDelta (heartbeat cancel) + the loop's cancellation check. Read by: the loop, epilogue, outer catch. */
-    pauseDetected: boolean;
-    /** Written by: the stall-watchdog callback. Read by: the loop + epilogue. */
-    stallDetected: boolean;
-    stallError: StallTimeoutError | undefined;
-    /** Written by: the loop (on the first ledger entry). Read by: the loop, epilogue, settleRetryTurn. */
+    /** Written by: the loop (on the first ledger entry). Read by: the loop, the boundary, settleRetryTurn. */
     firstDenialDetected: boolean;
     /** Written by: the fs denial-watcher (→ true) + the loop (→ false after a read). Read by: the loop. */
     denialLedgerDirty: boolean;
     /** Written by: the loop (the first-denial run.cancel()). Read by: the turn boundary. */
     denialCancelSettled: Promise<void> | undefined;
-    /** Written by: the loop (a platform STOP signal from persist). Read by: the loop + epilogue. */
-    platformStopSignaled: boolean;
-    /** Written by: onDelta (a turn-ended usage delta pushed the estimate past max_cost_usd). Read by: the loop (cancel + break) + epilogue. */
-    costCapExceeded: boolean;
     /** Written by: the loop (a stream ERROR status event) + the retry setup (reset). Read by: error classification. */
     streamErrorMessage: string | undefined;
-    /** Written by: the loop (each tool_call). Read by: the stall-watchdog (message enrichment). */
-    lastToolName: string | undefined;
     /** Written by: the loop. Read by: the event recorder, the persist cadence, and logs. */
     eventCount: number;
     /** Written + read by: onDelta (log the first turn's context attribution exactly once). */
     firstTurnAttributionLogged: boolean;
-    /** The stall watchdog for the CURRENT stream, armed by consumeCursorTurnStream; held so onDelta can reset it and the activity's finally can stop it. */
-    stallWatchdog: StallWatchdog | undefined;
 }
 export declare function newTurnStreamState(): TurnStreamState;
 /**
  * The subset of collaborators the shared onDelta needs. Broken out from
  * CursorTurnStreamDeps because the primary send happens BEFORE the accumulator
- * exists — onDelta only touches usage, the enricher, the heartbeat, and state.
+ * exists — onDelta only touches the sink, the pricer, the enricher, and state.
  */
 export interface TurnOnDeltaDeps {
-    readonly usageAccumulator: UsageAccumulator;
+    readonly sink: TurnSink;
+    /** This harness's pricing of a `turn-ended` delta at the requested variant's rates. */
+    readonly usagePricer: CursorUsagePricer;
     readonly deltaEnricher: DeltaEnricher;
-    /** Temporal heartbeat. Injected so the callback is testable without Temporal. */
-    readonly heartbeat: () => void;
     readonly promptEstimatedTokens: number;
     readonly executionId: string;
     readonly state: TurnStreamState;
-    /**
-     * ExecutionConfig.max_cost_usd — 0/unset disables the cap. Checked by
-     * onDelta after each turn-ended usage delta lands (the only point the
-     * running estimate advances); the loop performs the actual run.cancel().
-     * See cost-guard.ts for the semantics.
-     */
-    readonly maxCostUsd: number;
 }
 export interface CursorTurnStreamDeps extends TurnOnDeltaDeps {
-    readonly status: AgentExecutionStatus;
     readonly accumulator: MessageAccumulator;
     readonly todoTracker: TodoTracker;
     readonly eventRecorder: CursorTurnEventRecorder | undefined;
@@ -120,19 +99,12 @@ export interface CursorTurnStreamDeps extends TurnOnDeltaDeps {
     readonly changeSetId: string;
     /** Session HITL dir holding the denial ledger; undefined → no gate installed → no first-denial stop. */
     readonly hitlDir: string | undefined;
-    readonly stallTimeoutMs: number;
-    /** The single size-bounded persist chokepoint. Returns the platform control signal. */
-    readonly persist: (status: AgentExecutionStatus) => Promise<ExecutionControlSignal>;
-    /** Temporal cancellation check. Injected so the loop is testable without Temporal. */
-    readonly isCancelled: () => boolean;
 }
 /**
  * Build the shared onDelta callback. The Cursor SDK's fine-grained delta channel
  * carries token usage, live shell output, and precise tool-call timings; it also
- * fires far more often than discrete stream events, so it is where the stall
- * timer is reset during a long model generation. A heartbeat CancelledFailure
- * here flags the pause so the loop and epilogue treat it as a user pause (the
- * bare retry loops swallowed this — the cause of the mid-retry mislabel).
+ * fires far more often than discrete stream events, so it is where the runtime's
+ * stall timer is reset during a long model generation.
  */
 export declare function makeCursorTurnOnDelta(deps: TurnOnDeltaDeps): (event: {
     update: InteractionUpdate;
@@ -142,9 +114,7 @@ export declare function makeCursorTurnOnDelta(deps: TurnOnDeltaDeps): (event: {
  * transcript, todos, sub-agent tracking, live persist, and DD-32/DD-33 mid-run
  * progress, and reporting WHY the stream ended.
  *
- * Arms + stops its own stall watchdog (stored on `state.stallWatchdog` so the
- * shared onDelta can reset it and the activity's finally can stop it as a
- * backstop). Mutates `deps.status` + `deps.state` in place. The caller owns the
- * post-stream finalize and the terminal mapping.
+ * Mutates `deps.sink.status` + `deps.state` in place. The caller owns the
+ * post-stream finalize and the settle.
  */
 export declare function consumeCursorTurnStream(run: StreamableRun, deps: CursorTurnStreamDeps): Promise<TurnStreamReason>;

package/dist/activities/execute-cursor/turn-stream.js

@@ -1,78 +1,64 @@
 /**
  * The Cursor harness's stream phase — the single per-event consumption loop that
  * turns a live Cursor SDK run into the streamed transcript, mid-run progress, and
- * the flags that decide how the turn ends.
+ * the one flag that decides how the turn goes on (the first-denial stop).
  *
- * Extracted from the activity entry point (index.ts) so that BOTH the primary
- * turn and the two recovery retries (poisoned-handle / transport-timeout) drive
- * the exact same code. The retries previously re-implemented a stripped "bare"
+ * Extracted from the activity entry point so that BOTH the primary turn and
+ * the two recovery retries (poisoned-handle / transport-timeout) drive the
+ * exact same code. The retries previously re-implemented a stripped "bare"
  * loop that dropped live persist, DD-32/DD-33 mid-run progress, sub-agent
- * tracking, the first-denial early stop, and correct pause/stall handling — so a
+ * tracking, the first-denial early stop, and correct pause handling — so a
  * retry froze the UI and mis-handled a mid-retry pause. One loop removes that
  * drift by construction.
  *
- * This mirrors the deep-agent harness's `streamExecution` seam
- * (execute-deep-agent/streaming.ts): injected `heartbeat`/`isCancelled` so it
- * runs without Temporal, a structural `StreamableRun` so it runs without the live
- * SDK, and a result (the terminal reason) instead of internal terminal mapping.
- * The one deliberate difference: this consumer REPORTS why the stream ended and
- * leaves the terminal MAPPING to the activity, because Cursor's mapping is
- * entangled with worker-shutdown-vs-pause disambiguation, the turn boundary,
- * structured output, and recovery retries — all of which must stay in index.ts.
+ * What the loop asks of the runtime, through the sink (`harness/types.ts`):
+ * `recordActivity()` per event (with the tool name) and per delta, so the
+ * runtime's stall watchdog measures the engine; `reportUsage()` per
+ * `turn-ended` delta, priced here at the requested variant's rates
+ * (`usage-pricing.ts`), so the runtime accounts and enforces the cost cap;
+ * `requestPersist()` where a discrete change or the streaming cadence says
+ * so (`shared/persist-decision.ts` over this loop's own dirty flags), 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 an abort cancels the SDK
+ * run — the one way a wedged stream is unblocked, and the same act for every
+ * cause of stopping (the runtime knows why; this loop never does).
+ *
+ * Until S2 M3 this loop armed its own stall watchdog, enforced the cost cap,
+ * read STOP from its own persist, and told a pause from the activity's
+ * cancellation signal; every one of those is the runtime's now, and the loop
+ * reports only `completed`, `first-denial` or `interrupted`.
  */
-import { create } from "@bufbuild/protobuf";
-import { CancelledFailure } from "@temporalio/activity";
-import { ExecutionControlSignal } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-import { StreamingUsageSummarySchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/usage_pb";
-import { startStallWatchdog, StallTimeoutError, } from "../../shared/stall-watchdog.js";
-import { shouldPersistStreamingStatus } from "./persist-decision.js";
+import { shouldPersistStreamingStatus } from "../../shared/persist-decision.js";
 import { approvalDenials, readDenialLedger } from "./approval-state.js";
 import { captureFileChangeProgress, } from "../../shared/filereview/progress.js";
-import { costCapExceeded } from "./cost-guard.js";
 export function newTurnStreamState() {
     return {
-        pauseDetected: false,
-        stallDetected: false,
-        stallError: undefined,
         firstDenialDetected: false,
         denialLedgerDirty: false,
         denialCancelSettled: undefined,
-        platformStopSignaled: false,
-        costCapExceeded: false,
         streamErrorMessage: undefined,
-        lastToolName: undefined,
         eventCount: 0,
         firstTurnAttributionLogged: false,
-        stallWatchdog: undefined,
     };
 }
 /**
  * Build the shared onDelta callback. The Cursor SDK's fine-grained delta channel
  * carries token usage, live shell output, and precise tool-call timings; it also
- * fires far more often than discrete stream events, so it is where the stall
- * timer is reset during a long model generation. A heartbeat CancelledFailure
- * here flags the pause so the loop and epilogue treat it as a user pause (the
- * bare retry loops swallowed this — the cause of the mid-retry mislabel).
+ * fires far more often than discrete stream events, so it is where the runtime's
+ * stall timer is reset during a long model generation.
  */
 export function makeCursorTurnOnDelta(deps) {
-    const { usageAccumulator, deltaEnricher, heartbeat, promptEstimatedTokens, executionId, state, maxCostUsd } = deps;
+    const { sink, usagePricer, deltaEnricher, promptEstimatedTokens, executionId, state } = deps;
     return ({ update }) => {
-        // Reset the stall timer on the delta channel too: a long model generation
-        // emits token deltas but few discrete stream events, so resetting only in the
-        // stream loop would false-positive a stall.
-        state.stallWatchdog?.recordActivity();
+        // Progress on the delta channel too: a long model generation emits token
+        // deltas but few discrete stream events, and resetting only in the stream
+        // loop would false-positive a stall.
+        sink.recordActivity();
         if (update.type === "turn-ended" && update.usage) {
-            usageAccumulator.addTurn(update.usage);
-            // max_cost_usd enforcement (cost-guard.ts): the running estimate only
-            // advances here, so this is the single check point. onDelta cannot reach
-            // the run — the loop reads the flag and performs the clean cancel.
-            if (!state.costCapExceeded
-                && costCapExceeded(maxCostUsd, usageAccumulator.snapshot().estimatedCostUsd)) {
-                state.costCapExceeded = true;
-                console.warn(`ExecuteCursor cost cap exceeded: execution=${executionId}, ` +
-                    `estimatedCostUsd=${usageAccumulator.snapshot().estimatedCostUsd.toFixed(4)}, ` +
-                    `maxCostUsd=${maxCostUsd.toFixed(2)}`);
-            }
+            // The running estimate advances only here; the runtime enforces the cap
+            // and aborts the signal, which the loop reads at the next boundary.
+            sink.reportUsage(usagePricer.price(update.usage));
             if (!state.firstTurnAttributionLogged) {
                 state.firstTurnAttributionLogged = true;
                 const sdkInputTokens = update.usage.inputTokens ?? 0;
@@ -83,16 +69,6 @@ export function makeCursorTurnOnDelta(deps) {
             }
         }
         deltaEnricher.processDelta(update);
-        try {
-            heartbeat();
-        }
-        catch (hbErr) {
-            if (hbErr instanceof CancelledFailure) {
-                state.pauseDetected = true;
-                return;
-            }
-            throw hbErr;
-        }
     };
 }
 /**
@@ -100,59 +76,38 @@ export function makeCursorTurnOnDelta(deps) {
  * transcript, todos, sub-agent tracking, live persist, and DD-32/DD-33 mid-run
  * progress, and reporting WHY the stream ended.
  *
- * Arms + stops its own stall watchdog (stored on `state.stallWatchdog` so the
- * shared onDelta can reset it and the activity's finally can stop it as a
- * backstop). Mutates `deps.status` + `deps.state` in place. The caller owns the
- * post-stream finalize and the terminal mapping.
+ * Mutates `deps.sink.status` + `deps.state` in place. The caller owns the
+ * post-stream finalize and the settle.
  */
 export async function consumeCursorTurnStream(run, deps) {
-    const { status, accumulator, todoTracker, deltaEnricher, eventRecorder, scheduler, usageAccumulator, progressSubstrate, progressState, changeSetId, hitlDir, executionId, stallTimeoutMs, persist, heartbeat, isCancelled, state, } = deps;
-    // Arm the stall watchdog now that the run exists. The activity's periodic
-    // heartbeat proves the process is alive, not that the agent is progressing: if
-    // the stream wedges (a tool call or model connection that never returns), no
-    // event/delta arrives and the turn would hang forever. On stall we end the run
-    // cleanly via the SDK's run.cancel() (guarded by supports("cancel")), which
-    // unblocks the for-await; the caller then reports EXECUTION_FAILED with a
-    // recognizable, actionable message.
-    state.stallWatchdog = startStallWatchdog(stallTimeoutMs, (idleMs) => {
-        state.stallDetected = true;
-        state.stallError = new StallTimeoutError(idleMs, state.lastToolName ? `last tool: ${state.lastToolName}` : undefined);
-        console.warn(`ExecuteCursor stall detected: execution=${executionId}, idleMs=${idleMs}, lastTool=${state.lastToolName ?? "none"}`);
+    const { sink, accumulator, todoTracker, deltaEnricher, eventRecorder, scheduler, progressSubstrate, progressState, changeSetId, hitlDir, executionId, state, } = deps;
+    const { status, stopSignal } = sink;
+    // The runtime's stop, whatever its cause, ends the run through the SDK's
+    // own cancel: that is what unblocks a wedged `for await` (a stall), and it
+    // stops the engine's tools and deltas from outliving the turn on every
+    // other cause too. Guarded by supports("cancel") as the loop's own cancels
+    // are; the teardown rejection it can cause is swallowed below.
+    const cancelOnStop = () => {
+        console.log(`ExecuteCursor stopping stream on the runtime's stop signal: execution=${executionId}`);
         if (run.supports?.("cancel")) {
             void run.cancel().catch((cancelErr) => {
-                console.warn(`ExecuteCursor run.cancel() after stall failed (non-fatal): execution=${executionId}, ` +
+                console.warn(`ExecuteCursor run.cancel() after stop failed (non-fatal): execution=${executionId}, ` +
                     `error=${cancelErr instanceof Error ? cancelErr.message : cancelErr}`);
             });
         }
-    });
+    };
+    if (stopSignal.aborted) {
+        cancelOnStop();
+        return "interrupted";
+    }
+    stopSignal.addEventListener("abort", cancelOnStop, { once: true });
     try {
         for await (const event of run.stream()) {
-            if (state.pauseDetected || isCancelled()) {
-                state.pauseDetected = true;
-                break;
-            }
-            if (state.stallDetected)
+            if (stopSignal.aborted)
                 break;
-            // Cost cap (cost-guard.ts): onDelta flagged the overrun on a turn-ended
-            // usage delta; end the run through the same clean-cancel pattern as the
-            // stall watchdog and the first-denial stop. Fire-and-forget is correct
-            // here — nothing downstream waits on this turn's agent (unlike the
-            // first-denial stop, whose ledger read needs a stopped agent).
-            if (state.costCapExceeded) {
-                console.log(`ExecuteCursor stopping stream at cost cap: execution=${executionId}`);
-                if (run.supports?.("cancel")) {
-                    void run.cancel().catch((cancelErr) => {
-                        console.warn(`ExecuteCursor run.cancel() after cost cap failed (non-fatal): execution=${executionId}, ` +
-                            `error=${cancelErr instanceof Error ? cancelErr.message : cancelErr}`);
-                    });
-                }
-                break;
-            }
-            // Progress: reset the stall timer on every stream event.
-            state.stallWatchdog.recordActivity();
-            if (event.type === "tool_call" && typeof event.name === "string") {
-                state.lastToolName = event.name;
-            }
+            // Progress: reset the runtime's stall timer on every stream event,
+            // naming the tool so a stall's copy can say `last tool: shell`.
+            sink.recordActivity(event.type === "tool_call" && typeof event.name === "string" ? event.name : undefined);
             eventRecorder?.record(event, state.eventCount);
             accumulator.processEvent(event);
             todoTracker.processEvent(event);
@@ -216,9 +171,6 @@ export async function consumeCursorTurnStream(run, deps) {
                 todosDirty: todoTracker.isDirty,
                 contentDirty: accumulator.isDirty,
             }, scheduler, state.eventCount);
-            if (usageAccumulator.hasTurns) {
-                status.streamingUsage = create(StreamingUsageSummarySchema, usageAccumulator.snapshot());
-            }
             if (shouldPersist) {
                 // Sync sub-agent executions into status before every persist so the live
                 // UI reflects delegation (including the IN_PROGRESS state) while the
@@ -236,54 +188,37 @@ export async function consumeCursorTurnStream(run, deps) {
                         state: progressState,
                     });
                 }
-                const signal = await persist(status);
+                // Awaited: the runtime reads the control plane's answer to this write,
+                // and a STOP must be seen at the next event boundary, not one event late.
+                await sink.requestPersist();
                 deltaEnricher.markPersisted();
                 todoTracker.markPersisted();
                 accumulator.markPersisted();
                 scheduler.markUpdateSent(state.eventCount);
-                heartbeat();
-                if (signal === ExecutionControlSignal.STOP) {
-                    state.platformStopSignaled = true;
-                    console.warn(`ExecuteCursor platform stop signal received: execution=${executionId}`);
-                }
-            }
-            if (state.platformStopSignaled) {
-                console.log(`ExecuteCursor stopping stream due to platform stop signal: execution=${executionId}`);
-                break;
             }
         }
     }
     catch (streamErr) {
-        // run.cancel() — from the stall watchdog, the first-denial stop, or the
-        // cost-cap stop — can make the stream iterator reject as it tears down;
-        // that is the expected teardown for all three, so swallow it and fall
-        // through. Anything else is a genuine stream failure — rethrow it to the
-        // activity's error handler.
-        if (!state.stallDetected && !state.firstDenialDetected && !state.costCapExceeded) {
+        // run.cancel() — from the runtime's stop or the first-denial stop — can
+        // make the stream iterator reject as it tears down; that is the expected
+        // teardown for both, so swallow it and fall through. Anything else is a
+        // genuine stream failure — rethrow it to the adapter's error handler.
+        if (!stopSignal.aborted && !state.firstDenialDetected) {
             throw streamErr;
         }
         console.warn(`ExecuteCursor stream ended via cancel: execution=${executionId}, ` +
-            `stall=${state.stallDetected}, firstDenial=${state.firstDenialDetected}, ` +
-            `costCap=${state.costCapExceeded}`);
+            `stopped=${stopSignal.aborted}, firstDenial=${state.firstDenialDetected}`);
     }
     finally {
-        state.stallWatchdog.stop();
+        stopSignal.removeEventListener("abort", cancelOnStop);
     }
-    // Report why the stream ended, in the same precedence the activity's epilogue
-    // applies: a stall (an EXECUTION_FAILED terminal) outranks everything; a
-    // platform stop, a cost-cap stop, and a first denial are distinct
-    // return/proceed outcomes; a pause is the fallback for a cancellation with
-    // no other cause.
-    if (state.stallDetected)
-        return "stalled";
-    if (state.platformStopSignaled)
-        return "platform-stop";
-    if (state.costCapExceeded)
-        return "cost-cap";
+    // Report why the stream ended: the runtime's stop outranks a first denial
+    // (there is no review to open on a stopped turn), a first denial outranks a
+    // natural end.
+    if (stopSignal.aborted)
+        return "interrupted";
     if (state.firstDenialDetected)
         return "first-denial";
-    if (state.pauseDetected || isCancelled())
-        return "paused";
     return "completed";
 }
 //# sourceMappingURL=turn-stream.js.map

package/dist/activities/execute-cursor/turn-stream.js.map

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

package/dist/activities/execute-cursor/turn.d.ts

@@ -0,0 +1,43 @@
+/**
+ * One Cursor engine turn — the SDK slice of the Cursor harness, behind the
+ * turn runtime's contract (`harness/types.ts`).
+ *
+ * `runCursorTurn` is what `adapter.ts`'s `runTurn` delegates to: the HITL
+ * gate, the agent (parked, created or resumed), the prompt, the stream, the
+ * turn boundary, `run.wait()` and its recovery spines, and its own teardown
+ * (the denial watcher, the gate, the OTel span, and what becomes of the agent
+ * handle). Everything else about a turn is the runtime's
+ * (`harness/run-turn.ts`): the resolution phases, the persist chokepoint, the
+ * watchdog, the cost cap, the interruption table, the completion epilogue,
+ * the lock.
+ *
+ * This module is where `@cursor/sdk` enters 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 adapter's HTTP/2 interceptor must patch `node:http2` before the SDK
+ * (and, through it, `@connectrpc/connect-node`) is first imported, and the
+ * composition roots import `adapter.ts` before they boot it. Nothing outside
+ * `adapter.ts` imports this module.
+ *
+ * Never throws out of `runCursorTurn` (an SDK failure is `failed` with the
+ * classifier's sentence; an unexpected exception is `failed` on the
+ * `internal` surface; a `CancelledFailure` never exists here), 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, one rule per outcome (Q-S2-6): the agent is PARKED
+ * for the session's next turn on every exit but a failure — `completed`,
+ * `cancelled`, `awaiting_approval` and `interrupted` alike (a wedged handle
+ * after a stall is caught by the poisoned-handle recovery on the next turn;
+ * before S2 a pause, a shutdown and a stall dropped the handle, leaking the
+ * executor lease). A `failed` turn keeps the orchestrator's three
+ * dispositions: an engine-reported failure parks (a bad key is not a bad
+ * handle), a user-actionable failure closes, an internal failure drops.
+ *
+ * Extracted from `index.ts` `executeCursorInner` at S2 M3b and moved out of
+ * `adapter.ts` at S2 M5; the seventeen hermetic goldens under `__tests__/hermetic/`
+ * pin the result byte for byte.
+ */
+import type { TurnInput, TurnOutcome, TurnSink } from "../../harness/types.js";
+import { type CursorAdapterConfig } from "./turn-setup.js";
+export declare function runCursorTurn(input: TurnInput, sink: TurnSink, config: CursorAdapterConfig): Promise<TurnOutcome>;