@stigmer/runner 3.14.0 → 3.15.0

package/dist/{activities/execute-cursor → shared}/exact-apply.js

@@ -48,10 +48,10 @@
  */
 import { isAbsolute, relative, resolve } from "node:path";
 import { ApprovalAction, ToolCallStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
-import { ELISION_MARKER } from "../../shared/status-offload.js";
-import { extractFilePath, extractWriteContent } from "../../shared/file-tools.js";
-import { resolveWorkspacePath } from "../../shared/file-change.js";
-import { utcTimestamp } from "../../shared/status.js";
+import { ELISION_MARKER } from "./status-offload.js";
+import { extractFilePath, extractWriteContent } from "./file-tools.js";
+import { resolveWorkspacePath } from "./file-change.js";
+import { utcTimestamp } from "./status.js";
 /**
  * Apply every APPROVED whole-file write in `messages` to disk with its EXACT
  * approved bytes, marking each applied tool call COMPLETED in place.
@@ -113,7 +113,7 @@ export async function applyApprovedWholeFileWrites(opts) {
                 tc.completedAt = utcTimestamp();
             tc.error = "";
             applied.add(tc.id);
-            console.log(`ExecuteCursor exact-apply: wrote approved bytes to ${target} ` +
+            console.log(`[exact-apply] wrote approved bytes to ${target} ` +
                 `(tool=${tc.id}); no resource grant issued, so a further change ` +
                 `re-gates. execution=${opts.executionId}`);
         }
@@ -198,7 +198,7 @@ function isWithinWorkspace(absTarget, workspaceDirs) {
     });
 }
 function logSkip(executionId, tc, reason) {
-    console.log(`ExecuteCursor exact-apply skipped (falling back to grant+reinvocation): ` +
+    console.log(`[exact-apply] skipped (falling back to grant+reinvocation): ` +
         `tool=${tc.id} reason="${reason}" execution=${executionId}`);
 }
 //# sourceMappingURL=exact-apply.js.map

package/dist/shared/exact-apply.js.map

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

package/dist/shared/execution-context.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The execution-scoped context — "this async work belongs to execution X" —
+ * as an `AsyncLocalStorage` the turn runtime enters once around the WHOLE
+ * activity, and the transport layer reads per request.
+ *
+ * Why it is the runtime's and not a harness's: every proxy-bound request the
+ * runner makes carries `x-stigmer-execution-id` from this store (the Cursor
+ * fetch and HTTP/2 interceptors stamp it; `rejection-capture.ts` correlates
+ * unhandled rejections by it), and a large share of those requests are made
+ * OUTSIDE any engine stretch — attachment downloads and status offload
+ * through the artifact proxy, the memory selection, the structured-output
+ * extraction and the plan-artifact publish in the epilogue, and in a cloud
+ * sandbox the control-plane writes themselves. Under `maxConcurrentActivities
+ * > 1` the fallback (a module-level id, `fetch-interceptor.ts`
+ * `setInterceptorExecutionId`) is whichever turn set it last; this store is
+ * what makes concurrent turns not overwrite each other's headers.
+ *
+ * Moved from `activities/execute-cursor/fetch-interceptor.ts` (S2 M3,
+ * Q-M3-12) so `harness/run-turn.ts` can enter it without importing the
+ * adapter; the interceptors import it from here. No harness enters it: the
+ * contract lists it among the things deliberately NOT on `TurnSink`.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+export interface ExecutionContextStore {
+    readonly executionId: string;
+}
+/** The store, for readers that stamp or correlate by execution id. */
+export declare function getExecutionContext(): AsyncLocalStorage<ExecutionContextStore>;
+/**
+ * Run an async function with execution-scoped context. The executionId is
+ * propagated through the async call chain via AsyncLocalStorage, ensuring
+ * concurrent activities on the same runner process don't overwrite each
+ * other's proxy headers.
+ */
+export declare function runWithExecutionContext<T>(executionId: string, fn: () => Promise<T>): Promise<T>;

package/dist/shared/execution-context.js

@@ -0,0 +1,38 @@
+/**
+ * The execution-scoped context — "this async work belongs to execution X" —
+ * as an `AsyncLocalStorage` the turn runtime enters once around the WHOLE
+ * activity, and the transport layer reads per request.
+ *
+ * Why it is the runtime's and not a harness's: every proxy-bound request the
+ * runner makes carries `x-stigmer-execution-id` from this store (the Cursor
+ * fetch and HTTP/2 interceptors stamp it; `rejection-capture.ts` correlates
+ * unhandled rejections by it), and a large share of those requests are made
+ * OUTSIDE any engine stretch — attachment downloads and status offload
+ * through the artifact proxy, the memory selection, the structured-output
+ * extraction and the plan-artifact publish in the epilogue, and in a cloud
+ * sandbox the control-plane writes themselves. Under `maxConcurrentActivities
+ * > 1` the fallback (a module-level id, `fetch-interceptor.ts`
+ * `setInterceptorExecutionId`) is whichever turn set it last; this store is
+ * what makes concurrent turns not overwrite each other's headers.
+ *
+ * Moved from `activities/execute-cursor/fetch-interceptor.ts` (S2 M3,
+ * Q-M3-12) so `harness/run-turn.ts` can enter it without importing the
+ * adapter; the interceptors import it from here. No harness enters it: the
+ * contract lists it among the things deliberately NOT on `TurnSink`.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+const executionContext = new AsyncLocalStorage();
+/** The store, for readers that stamp or correlate by execution id. */
+export function getExecutionContext() {
+    return executionContext;
+}
+/**
+ * Run an async function with execution-scoped context. The executionId is
+ * propagated through the async call chain via AsyncLocalStorage, ensuring
+ * concurrent activities on the same runner process don't overwrite each
+ * other's proxy headers.
+ */
+export function runWithExecutionContext(executionId, fn) {
+    return executionContext.run({ executionId }, fn);
+}
+//# sourceMappingURL=execution-context.js.map

package/dist/shared/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/shared/execution-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrD,MAAM,gBAAgB,GAAG,IAAI,iBAAiB,EAAyB,CAAC;AAExE,sEAAsE;AACtE,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAI,WAAmB,EAAE,EAAoB;IAClF,OAAO,gBAAgB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/{activities/execute-cursor → shared}/extract-structured-output.d.ts

@@ -1,5 +1,8 @@
 /**
- * Tier-2 structured-output extraction for the Cursor harness.
+ * Tier-2 structured-output extraction for a harness turn.
+ *
+ * Harness-agnostic: the Cursor activity is today's only caller and the turn
+ * runtime takes it over in S2 M3 (the native harness has no tier 2 today).
  *
  * When tier-1 text extraction (shared/extract-json.ts) cannot find JSON in
  * the agent's free-text response, this tier asks an economy-tier LLM to
@@ -12,7 +15,7 @@
  * lazily at the call site, mirroring its tier-1 import, which is what
  * bundle-slim's deferred evaluation preserves.
  */
-import type { Config } from "../../config.js";
+import type { Config } from "../config.js";
 /**
  * Extract structured data from an agent's free-text response using an
  * economy-tier LLM with withStructuredOutput (function-calling).

package/dist/{activities/execute-cursor → shared}/extract-structured-output.js

@@ -1,5 +1,8 @@
 /**
- * Tier-2 structured-output extraction for the Cursor harness.
+ * Tier-2 structured-output extraction for a harness turn.
+ *
+ * Harness-agnostic: the Cursor activity is today's only caller and the turn
+ * runtime takes it over in S2 M3 (the native harness has no tier 2 today).
  *
  * When tier-1 text extraction (shared/extract-json.ts) cannot find JSON in
  * the agent's free-text response, this tier asks an economy-tier LLM to
@@ -12,11 +15,11 @@
  * lazily at the call site, mirroring its tier-1 import, which is what
  * bundle-slim's deferred evaluation preserves.
  */
-import { getEconomyModel } from "../../shared/model-registry.js";
-import { buildChatModel } from "../../shared/model-client.js";
-import { checkDirectCredentials } from "../../shared/llm-backend.js";
-import { tryInferProvider } from "../../shared/llm-proxy.js";
-import { jsonSchemaToZod } from "../../shared/json-schema-to-zod.js";
+import { getEconomyModel } from "./model-registry.js";
+import { buildChatModel } from "./model-client.js";
+import { checkDirectCredentials } from "./llm-backend.js";
+import { tryInferProvider } from "./llm-proxy.js";
+import { jsonSchemaToZod } from "./json-schema-to-zod.js";
 /**
  * Extract structured data from an agent's free-text response using an
  * economy-tier LLM with withStructuredOutput (function-calling).

package/dist/shared/extract-structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-structured-output.js","sourceRoot":"","sources":["../../src/shared/extract-structured-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,aAAqB,EACrB,MAA+B,EAC/B,MAAc,EACd,YAAoB;IAEpB,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,YAAY,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,SAAS,CAAC;IAExD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAC5E,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,0CAA0C,QAAQ,SAAS;gBAC3D,IAAI,eAAe,iCAAiC,OAAO,EAAE,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,cAAc,CAAC;QAC1C,SAAS,EAAE,eAAe;QAC1B,aAAa;QACb,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,SAAS;QAC9C,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC;QACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,sGAAsG,EAAE;QACnI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE;KACzC,CAAC,CAAC;IAEH,OAAO,MAAM,IAAI,IAAI,CAAC;AACxB,CAAC"}

package/dist/shared/filereview/capture.d.ts

@@ -40,7 +40,7 @@ import { type BlobReader, type CasPathCapture } from "./cas-substrate.js";
  * no capture substrate and falls back to the deny-gate: the agent still runs, but
  * file writes gate pre-execution instead of flowing. In the Cursor harness that
  * fallback is also the ONLY branch that arms the resume-time exact-apply guarantee
- * (see execute-cursor/exact-apply.ts); the deep-agent harness re-applies an
+ * (see shared/exact-apply.ts); the deep-agent harness re-applies an
  * approved write via LangGraph checkpoint replay and needs no exact-apply. Keeping
  * this the single, named, truth-table-tested decision pins exactly when the
  * no-storage deny-gate engages in either harness.

package/dist/shared/filereview/capture.js

@@ -42,7 +42,7 @@ import { isSecretLikePath } from "./secret-paths.js";
  * no capture substrate and falls back to the deny-gate: the agent still runs, but
  * file writes gate pre-execution instead of flowing. In the Cursor harness that
  * fallback is also the ONLY branch that arms the resume-time exact-apply guarantee
- * (see execute-cursor/exact-apply.ts); the deep-agent harness re-applies an
+ * (see shared/exact-apply.ts); the deep-agent harness re-applies an
  * approved write via LangGraph checkpoint replay and needs no exact-apply. Keeping
  * this the single, named, truth-table-tested decision pins exactly when the
  * no-storage deny-gate engages in either harness.

package/dist/shared/heartbeat.d.ts

@@ -3,20 +3,22 @@
  *
  * Provides a periodic heartbeat loop that activities can start for
  * long-running operations. The loop sends heartbeat details at a
- * configurable interval and stops when cancelled or when the
- * returned abort function is called.
+ * configurable interval and stops when the returned handle is stopped.
  *
- * Heartbeats serve two purposes:
- * 1. Prevent Temporal from timing out the activity (heartbeatTimeout)
- * 2. Detect parent workflow cancellation (CancelledFailure from heartbeat)
+ * Heartbeats keep Temporal from timing the activity out
+ * (`heartbeatTimeout`) and are how an activity RECEIVES cancellation: the
+ * server piggybacks a cancel request on a heartbeat response, and the SDK
+ * then aborts `Context.current().cancellationSignal`. `Context.heartbeat()`
+ * itself never throws for cancellation (it enqueues to the worker's
+ * heartbeat subject — `@temporalio/activity/lib/index.js`
+ * `Context.heartbeat`, `@temporalio/worker/lib/worker.js` the heartbeat
+ * callback; the SDK's own doc: "Cancellation is not propagated from this
+ * function"). Until S2 M3 this handle carried two flags for a throw that
+ * cannot happen; a turn reads its interruption from the signal's reason
+ * instead (`worker-shutdown.ts` `classifyTurnInterruption`).
  */
 export interface HeartbeatHandle {
     stop(): void;
-    readonly cancelled: boolean;
-    readonly workerShutdown: boolean;
 }
-export interface HeartbeatOptions {
-    shutdownSignal?: AbortSignal;
-}
-export declare function startHeartbeat(intervalMs: number, getDetails?: () => Record<string, unknown>, options?: HeartbeatOptions): HeartbeatHandle;
+export declare function startHeartbeat(intervalMs: number, getDetails?: () => Record<string, unknown>): HeartbeatHandle;
 export declare function checkCancellation(): void;

package/dist/shared/heartbeat.js

@@ -3,48 +3,33 @@
  *
  * Provides a periodic heartbeat loop that activities can start for
  * long-running operations. The loop sends heartbeat details at a
- * configurable interval and stops when cancelled or when the
- * returned abort function is called.
+ * configurable interval and stops when the returned handle is stopped.
  *
- * Heartbeats serve two purposes:
- * 1. Prevent Temporal from timing out the activity (heartbeatTimeout)
- * 2. Detect parent workflow cancellation (CancelledFailure from heartbeat)
+ * Heartbeats keep Temporal from timing the activity out
+ * (`heartbeatTimeout`) and are how an activity RECEIVES cancellation: the
+ * server piggybacks a cancel request on a heartbeat response, and the SDK
+ * then aborts `Context.current().cancellationSignal`. `Context.heartbeat()`
+ * itself never throws for cancellation (it enqueues to the worker's
+ * heartbeat subject — `@temporalio/activity/lib/index.js`
+ * `Context.heartbeat`, `@temporalio/worker/lib/worker.js` the heartbeat
+ * callback; the SDK's own doc: "Cancellation is not propagated from this
+ * function"). Until S2 M3 this handle carried two flags for a throw that
+ * cannot happen; a turn reads its interruption from the signal's reason
+ * instead (`worker-shutdown.ts` `classifyTurnInterruption`).
  */
 import { Context, CancelledFailure } from "@temporalio/activity";
-export function startHeartbeat(intervalMs, getDetails, options) {
+export function startHeartbeat(intervalMs, getDetails) {
     let stopped = false;
-    let wasCancelled = false;
-    let wasWorkerShutdown = false;
     const timer = setInterval(() => {
         if (stopped)
             return;
-        try {
-            Context.current().heartbeat(getDetails?.());
-        }
-        catch (err) {
-            if (err instanceof CancelledFailure) {
-                if (options?.shutdownSignal?.aborted) {
-                    wasWorkerShutdown = true;
-                }
-                else {
-                    wasCancelled = true;
-                }
-                stopped = true;
-                clearInterval(timer);
-            }
-        }
+        Context.current().heartbeat(getDetails?.());
     }, intervalMs);
     return {
         stop() {
             stopped = true;
             clearInterval(timer);
         },
-        get cancelled() {
-            return wasCancelled;
-        },
-        get workerShutdown() {
-            return wasWorkerShutdown;
-        },
     };
 }
 export function checkCancellation() {

package/dist/shared/heartbeat.js.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/shared/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAYjE,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,UAA0C,EAC1C,OAA0B;IAE1B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,iBAAiB,GAAG,KAAK,CAAC;IAE9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,OAAO;YAAE,OAAO;QACpB,IAAI,CAAC;YACH,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;gBACpC,IAAI,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;oBACrC,iBAAiB,GAAG,IAAI,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,YAAY,GAAG,IAAI,CAAC;gBACtB,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;gBACf,aAAa,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC,EAAE,UAAU,CAAC,CAAC;IAEf,OAAO;QACL,IAAI;YACF,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,SAAS;YACX,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,IAAI,cAAc;YAChB,OAAO,iBAAiB,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/shared/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAMjE,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,UAA0C;IAE1C,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,IAAI,OAAO;YAAE,OAAO;QACpB,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC,EAAE,UAAU,CAAC,CAAC;IAEf,OAAO;QACL,IAAI;YACF,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/{activities/execute-cursor → shared}/persist-decision.d.ts

@@ -1,5 +1,8 @@
 /**
- * Streaming persist decision for the Cursor harness.
+ * Streaming persist decision for a harness turn.
+ *
+ * Harness-agnostic: the Cursor stream loop is today's only caller, the turn
+ * runtime takes it over in S2 M3, and S3 retires the native twin below.
  *
  * Mirrors the native deep-agent harness (execute-deep-agent/streaming.ts):
  * `shouldPersist = forceFlush || scheduler.shouldSendUpdate(eventCount)`.
@@ -9,7 +12,7 @@
  * Extracted as a single pure function so the stream loop and its unit tests
  * exercise the same implementation and cannot drift.
  */
-import type { StreamingUpdateScheduler } from "../../shared/streaming-scheduler.js";
+import type { StreamingUpdateScheduler } from "./streaming-scheduler.js";
 /**
  * Force-flush signals — discrete, user-visible state changes that must reach the
  * live stream immediately, independent of the scheduler's time cadence.

package/dist/{activities/execute-cursor → shared}/persist-decision.js

@@ -1,5 +1,8 @@
 /**
- * Streaming persist decision for the Cursor harness.
+ * Streaming persist decision for a harness turn.
+ *
+ * Harness-agnostic: the Cursor stream loop is today's only caller, the turn
+ * runtime takes it over in S2 M3, and S3 retires the native twin below.
  *
  * Mirrors the native deep-agent harness (execute-deep-agent/streaming.ts):
  * `shouldPersist = forceFlush || scheduler.shouldSendUpdate(eventCount)`.

package/dist/shared/persist-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-decision.js","sourceRoot":"","sources":["../../src/shared/persist-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAA0B,EAC1B,SAAmC,EACnC,UAAkB,EAClB,KAAc;IAEd,MAAM,UAAU,GACd,OAAO,CAAC,kBAAkB,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC;IAC3E,OAAO,UAAU,IAAI,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC"}

package/dist/{activities/execute-cursor → shared}/skill-resolver.d.ts

@@ -5,9 +5,17 @@
  * - Mounts each skill via the shared skill-mount mechanics (SKILL.md +
  *   extracted artifact, hash-keyed cache — see shared/skill-mount.ts)
  * - Uses a platform-managed directory outside the workspace
- * - Ensures the workspace `.stigmer` symlink (see stigmer-link.ts)
+ * - Ensures the workspace `.stigmer` symlink (see workspace/stigmer-link.ts)
  * - Returns metadata for prompt injection
  *
+ * A turn-runtime phase (`harness/turn-context.ts` `mountSkills`): it reads
+ * the control plane, which only the runtime holds, and writes under the
+ * platform dir the runtime owns; the harness renders the returned metadata
+ * into its prompt in its own placement. Moved from
+ * `activities/execute-cursor/` at S2 M3b; the native harness's twin
+ * (`skill-writer.ts` `fetchSkillsByRefs` + `mountSkills`) is what S3
+ * reconciles it with.
+ *
  * The mount is cached by the skill's content-addressed version hash
  * (stigmer/stigmer#672): metadata is fetched on every execution (that keeps
  * latest-version freshness), but the artifact download and file rewrite are
@@ -16,9 +24,14 @@
  * message after the first pays a metadata read instead of a full artifact
  * transfer.
  */
-import type { StigmerClient } from "../../client/stigmer-client.js";
+import type { StigmerClient } from "../client/stigmer-client.js";
 import type { ApiResourceReference } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
-import type { SkillMetadata } from "./prompt-builder.js";
+/** One mounted skill as a prompt renders it: its name, its description, and the workspace-relative path of its SKILL.md. */
+export interface SkillMetadata {
+    name: string;
+    description: string;
+    path: string;
+}
 export interface SkillResolverOptions {
     sessionId: string;
     primaryWorkspaceDir: string;

package/dist/{activities/execute-cursor → shared}/skill-resolver.js

@@ -5,9 +5,17 @@
  * - Mounts each skill via the shared skill-mount mechanics (SKILL.md +
  *   extracted artifact, hash-keyed cache — see shared/skill-mount.ts)
  * - Uses a platform-managed directory outside the workspace
- * - Ensures the workspace `.stigmer` symlink (see stigmer-link.ts)
+ * - Ensures the workspace `.stigmer` symlink (see workspace/stigmer-link.ts)
  * - Returns metadata for prompt injection
  *
+ * A turn-runtime phase (`harness/turn-context.ts` `mountSkills`): it reads
+ * the control plane, which only the runtime holds, and writes under the
+ * platform dir the runtime owns; the harness renders the returned metadata
+ * into its prompt in its own placement. Moved from
+ * `activities/execute-cursor/` at S2 M3b; the native harness's twin
+ * (`skill-writer.ts` `fetchSkillsByRefs` + `mountSkills`) is what S3
+ * reconciles it with.
+ *
  * The mount is cached by the skill's content-addressed version hash
  * (stigmer/stigmer#672): metadata is fetched on every execution (that keeps
  * latest-version freshness), but the artifact download and file rewrite are
@@ -18,9 +26,9 @@
  */
 import { mkdir } from "node:fs/promises";
 import { join } from "node:path";
-import { getPlatformDir } from "../../shared/workspace/platform-dir.js";
-import { SKILLS_SUBDIR, mountIsFresh, downloadArtifact, writeSkillMount, } from "../../shared/skill-mount.js";
-import { ensureStigmerSymlink, STIGMER_LOCAL_STATE_DIR } from "../../shared/workspace/stigmer-link.js";
+import { getPlatformDir } from "./workspace/platform-dir.js";
+import { SKILLS_SUBDIR, mountIsFresh, downloadArtifact, writeSkillMount, } from "./skill-mount.js";
+import { ensureStigmerSymlink, STIGMER_LOCAL_STATE_DIR } from "./workspace/stigmer-link.js";
 /**
  * Resolve skill references into written SKILL.md files and prompt metadata.
  *

package/dist/shared/skill-resolver.js.map

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

package/dist/shared/subagent-rows.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Terminal transitions on the sub-agent rows of an execution status,
+ * operating on the proto array itself.
+ *
+ * One function today: marking every non-terminal sub-agent CANCELLED when a
+ * turn ends without them (a pause, a shutdown, a stall, a cost cap, an
+ * infrastructure cancel), so the final snapshot has no permanent IN_PROGRESS
+ * "zombie" delegation. Harness-agnostic (a `SubAgentExecution` is the
+ * platform's row, not an engine's), read by the turn runtime's terminal
+ * table and the Cursor accumulator's own finalize alike.
+ *
+ * Moved from `activities/execute-cursor/message-translator.ts` at S2 M3 so
+ * the runtime's catch can reach it; the body is unchanged.
+ */
+import type { SubAgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/subagent_pb";
+/**
+ * Transition any non-terminal sub-agent (IN_PROGRESS or PENDING) in the given
+ * proto array to CANCELLED with a completion timestamp, in place. Returns
+ * true if any sub-agent changed.
+ */
+export declare function cancelInProgressSubAgentProtos(subAgents: SubAgentExecution[]): boolean;

package/dist/shared/subagent-rows.js

@@ -0,0 +1,34 @@
+/**
+ * Terminal transitions on the sub-agent rows of an execution status,
+ * operating on the proto array itself.
+ *
+ * One function today: marking every non-terminal sub-agent CANCELLED when a
+ * turn ends without them (a pause, a shutdown, a stall, a cost cap, an
+ * infrastructure cancel), so the final snapshot has no permanent IN_PROGRESS
+ * "zombie" delegation. Harness-agnostic (a `SubAgentExecution` is the
+ * platform's row, not an engine's), read by the turn runtime's terminal
+ * table and the Cursor accumulator's own finalize alike.
+ *
+ * Moved from `activities/execute-cursor/message-translator.ts` at S2 M3 so
+ * the runtime's catch can reach it; the body is unchanged.
+ */
+import { SubAgentStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { utcTimestamp } from "./status.js";
+/**
+ * Transition any non-terminal sub-agent (IN_PROGRESS or PENDING) in the given
+ * proto array to CANCELLED with a completion timestamp, in place. Returns
+ * true if any sub-agent changed.
+ */
+export function cancelInProgressSubAgentProtos(subAgents) {
+    let changed = false;
+    for (const sub of subAgents) {
+        if (sub.status === SubAgentStatus.SUB_AGENT_IN_PROGRESS ||
+            sub.status === SubAgentStatus.SUB_AGENT_PENDING) {
+            sub.status = SubAgentStatus.SUB_AGENT_CANCELLED;
+            sub.completedAt = utcTimestamp();
+            changed = true;
+        }
+    }
+    return changed;
+}
+//# sourceMappingURL=subagent-rows.js.map

package/dist/shared/subagent-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-rows.js","sourceRoot":"","sources":["../../src/shared/subagent-rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAAC,SAA8B;IAC3E,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IACE,GAAG,CAAC,MAAM,KAAK,cAAc,CAAC,qBAAqB;YACnD,GAAG,CAAC,MAAM,KAAK,cAAc,CAAC,iBAAiB,EAC/C,CAAC;YACD,GAAG,CAAC,MAAM,GAAG,cAAc,CAAC,mBAAmB,CAAC;YAChD,GAAG,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC;YACjC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/shared/worker-shutdown.d.ts

@@ -40,28 +40,55 @@ export declare function getShutdownSignalForQueue(taskQueue: string): AbortSigna
 export declare function signalWorkerShutdown(taskQueue: string): void;
 /** Drop the registration once the queue's worker is fully torn down. */
 export declare function unregisterWorkerShutdownSignal(taskQueue: string): void;
-/** The evidence a turn's post-stream classification weighs (see below). */
+/**
+ * Why Temporal cancelled the activity, as the SDK states it: the message of
+ * the `CancelledFailure` it aborted `Context.current().cancellationSignal`
+ * with (`@temporalio/activity`'s module header lists them — `CANCELLED` for a
+ * workflow-requested cancel, `TIMED_OUT` when a heartbeat or other timeout
+ * fired server-side, `NOT_FOUND` when the run closed, `WORKER_SHUTDOWN`,
+ * `HEARTBEAT_DETAILS_CONVERSION_FAILED`, `PAUSED`). `undefined` when no
+ * cancellation was delivered.
+ */
+export type CancellationReason = string | undefined;
+/** The reason a cancellation signal carries, or `undefined` when it has not aborted. */
+export declare function cancellationReasonOf(signal: AbortSignal): CancellationReason;
+/** The evidence a turn's interruption classification weighs (see below). */
 export interface TurnInterruptionEvidence {
-    /** The periodic heartbeat threw CancelledFailure with no shutdown signal. */
-    heartbeatCancelled: boolean;
-    /** The periodic heartbeat threw CancelledFailure with the signal aborted. */
-    heartbeatWorkerShutdown: boolean;
-    /** Temporal delivered cancellation to the activity. */
-    cancellationSignalAborted: boolean;
+    /** The delivered cancellation's reason; `undefined` when none was delivered. */
+    readonly cancellationReason: CancellationReason;
     /** This queue's worker-shutdown signal is aborted. */
-    shutdownSignalAborted: boolean;
+    readonly shutdownSignalAborted: boolean;
 }
 /**
- * Classify how (whether) a turn's stream was interrupted, from the evidence
- * available after the stream ends. Pure so the decision table is directly
- * testable — the activities feed it their heartbeat flags and signals.
+ * How Temporal's cancellation reads to the turn:
+ *  - `worker-shutdown`: the runner is draining (the queue's signal, or the
+ *    SDK's own `WORKER_SHUTDOWN`); FAILED with the shutdown copy, thrown.
+ *  - `pause`: the workflow asked (`CANCELLED`, the Pause RPC's path);
+ *    PAUSED, thrown.
+ *  - `infrastructure`: the platform cancelled for its own reason (a heartbeat
+ *    timeout, a closed run); FAILED with the unresponsive copy, thrown.
+ *  - `none`: nothing was delivered.
+ */
+export type TurnInterruption = "worker-shutdown" | "pause" | "infrastructure" | "none";
+/**
+ * Classify how (whether) Temporal interrupted the turn, from the two live
+ * facts: the reason on the cancellation signal and the queue's shutdown
+ * signal. Pure so the decision table is directly testable.
  *
  * The load-bearing rule is the grace-window guard (#776): an aborted
  * shutdown signal ALONE is "none", because a run that completes normally
  * inside the drain grace window reaches the classification with the signal
- * already aborted and nothing actually interrupted. Shutdown requires
- * interruption evidence (a heartbeat CancelledFailure or a delivered
- * cancellation) alongside the signal; a heartbeat cancellation with no
- * shutdown signal is the orchestrator's pause.
+ * already aborted and nothing actually interrupted. Shutdown requires a
+ * delivered cancellation alongside the signal.
+ *
+ * Until S2 M3 the evidence also carried two flags from the periodic
+ * heartbeat ("it threw `CancelledFailure`"), and a delivered cancellation
+ * without them read as "none". `Context.heartbeat()` never throws in the
+ * Temporal TypeScript SDK (it enqueues to the worker's heartbeat subject;
+ * `@temporalio/activity/lib/index.js` `Context.heartbeat`,
+ * `@temporalio/worker/lib/worker.js` the heartbeat callback), so the flags
+ * were never set and a pause was in fact recognised by the stream loop's
+ * own cancellation check. The reason the SDK puts on the signal is the
+ * direct identity that inference stood in for.
  */
-export declare function classifyTurnInterruption(evidence: TurnInterruptionEvidence): "worker-shutdown" | "pause" | "none";
+export declare function classifyTurnInterruption(evidence: TurnInterruptionEvidence): TurnInterruption;

package/dist/shared/worker-shutdown.js

@@ -51,29 +51,44 @@ export function signalWorkerShutdown(taskQueue) {
 export function unregisterWorkerShutdownSignal(taskQueue) {
     registry.delete(taskQueue);
 }
+/** The reason a cancellation signal carries, or `undefined` when it has not aborted. */
+export function cancellationReasonOf(signal) {
+    if (!signal.aborted)
+        return undefined;
+    const reason = signal.reason;
+    if (reason instanceof Error)
+        return reason.message;
+    return typeof reason === "string" ? reason : "CANCELLED";
+}
 /**
- * Classify how (whether) a turn's stream was interrupted, from the evidence
- * available after the stream ends. Pure so the decision table is directly
- * testable — the activities feed it their heartbeat flags and signals.
+ * Classify how (whether) Temporal interrupted the turn, from the two live
+ * facts: the reason on the cancellation signal and the queue's shutdown
+ * signal. Pure so the decision table is directly testable.
  *
  * The load-bearing rule is the grace-window guard (#776): an aborted
  * shutdown signal ALONE is "none", because a run that completes normally
  * inside the drain grace window reaches the classification with the signal
- * already aborted and nothing actually interrupted. Shutdown requires
- * interruption evidence (a heartbeat CancelledFailure or a delivered
- * cancellation) alongside the signal; a heartbeat cancellation with no
- * shutdown signal is the orchestrator's pause.
+ * already aborted and nothing actually interrupted. Shutdown requires a
+ * delivered cancellation alongside the signal.
+ *
+ * Until S2 M3 the evidence also carried two flags from the periodic
+ * heartbeat ("it threw `CancelledFailure`"), and a delivered cancellation
+ * without them read as "none". `Context.heartbeat()` never throws in the
+ * Temporal TypeScript SDK (it enqueues to the worker's heartbeat subject;
+ * `@temporalio/activity/lib/index.js` `Context.heartbeat`,
+ * `@temporalio/worker/lib/worker.js` the heartbeat callback), so the flags
+ * were never set and a pause was in fact recognised by the stream loop's
+ * own cancellation check. The reason the SDK puts on the signal is the
+ * direct identity that inference stood in for.
  */
 export function classifyTurnInterruption(evidence) {
-    const interrupted = evidence.heartbeatCancelled ||
-        evidence.heartbeatWorkerShutdown ||
-        evidence.cancellationSignalAborted;
-    if (!interrupted) {
+    const { cancellationReason, shutdownSignalAborted } = evidence;
+    if (cancellationReason === undefined) {
         return "none";
     }
-    if (evidence.heartbeatWorkerShutdown || evidence.shutdownSignalAborted) {
+    if (shutdownSignalAborted || cancellationReason === "WORKER_SHUTDOWN") {
         return "worker-shutdown";
     }
-    return evidence.heartbeatCancelled ? "pause" : "none";
+    return cancellationReason === "CANCELLED" ? "pause" : "infrastructure";
 }
 //# sourceMappingURL=worker-shutdown.js.map

package/dist/shared/worker-shutdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-shutdown.js","sourceRoot":"","sources":["../../src/shared/worker-shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAC5D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,8BAA8B,CAAC,SAAiB;IAC9D,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAcD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAkC;IAElC,MAAM,WAAW,GACf,QAAQ,CAAC,kBAAkB;QAC3B,QAAQ,CAAC,uBAAuB;QAChC,QAAQ,CAAC,yBAAyB,CAAC;IACrC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,QAAQ,CAAC,uBAAuB,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC;QACvE,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC"}
+{"version":3,"file":"worker-shutdown.js","sourceRoot":"","sources":["../../src/shared/worker-shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,SAAiB;IAC5D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACpC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,8BAA8B,CAAC,SAAiB;IAC9D,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAaD,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAAC,MAAmB;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,CAAC;IACtC,IAAI,MAAM,YAAY,KAAK;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC;IACnD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;AAC3D,CAAC;AAsBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAkC;IACzE,MAAM,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,GAAG,QAAQ,CAAC;IAC/D,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,qBAAqB,IAAI,kBAAkB,KAAK,iBAAiB,EAAE,CAAC;QACtE,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,kBAAkB,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACzE,CAAC"}