@stigmer/runner 3.0.1

package/dist/activities/execute-cursor/cursor-event-recorder.js

@@ -0,0 +1,66 @@
+/**
+ * Cursor SDK event recorder for capturing raw SDKMessage events.
+ *
+ * Activated by the CURSOR_EVENT_RECORD_DIR environment variable. When set,
+ * the Cursor streaming loop records every SDKMessage and flushes them
+ * atomically to a JSONL file after the stream completes.
+ *
+ * This is development infrastructure for validating the agent_id-based
+ * sub-agent routing hypothesis. The captured events reveal whether
+ * sub-agent events carry distinct agent_id values and whether they
+ * flow through the parent's run.stream() at all.
+ *
+ * Mirrors the native harness's v3-event-recorder.ts / V3_EVENT_RECORD_DIR.
+ */
+import { writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Create a recorder if CURSOR_EVENT_RECORD_DIR is set, otherwise undefined.
+ * The caller does `recorder?.record(event, seq)` — zero overhead when off.
+ */
+export function createCursorEventRecorder(executionId) {
+    const recordDir = process.env.CURSOR_EVENT_RECORD_DIR;
+    if (!recordDir)
+        return undefined;
+    return new FileCursorEventRecorder(executionId, recordDir);
+}
+class FileCursorEventRecorder {
+    executionId;
+    outputDir;
+    lines = [];
+    constructor(executionId, outputDir) {
+        this.executionId = executionId;
+        this.outputDir = outputDir;
+    }
+    record(event, seq) {
+        const entry = {
+            seq,
+            capturedAt: new Date().toISOString(),
+            type: event.type,
+            agent_id: event.agent_id,
+            run_id: event.run_id,
+            event: safeClone(event),
+        };
+        this.lines.push(JSON.stringify(entry));
+    }
+    async flush() {
+        if (this.lines.length === 0)
+            return;
+        await mkdir(this.outputDir, { recursive: true });
+        const filePath = join(this.outputDir, `${this.executionId}.cursor-events.jsonl`);
+        await writeFile(filePath, this.lines.join("\n") + "\n");
+        console.log(`CursorEventRecorder: flushed ${this.lines.length} events to ${filePath}`);
+    }
+}
+function safeClone(obj) {
+    try {
+        return JSON.parse(JSON.stringify(obj));
+    }
+    catch {
+        if (obj && typeof obj === "object") {
+            return { _serializationError: true, keys: Object.keys(obj) };
+        }
+        return { _serializationError: true };
+    }
+}
+//# sourceMappingURL=cursor-event-recorder.js.map

package/dist/activities/execute-cursor/cursor-event-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-event-recorder.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/cursor-event-recorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,WAAmB;IAEnB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACtD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,IAAI,uBAAuB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,uBAAuB;IAIR;IACA;IAJF,KAAK,GAAa,EAAE,CAAC;IAEtC,YACmB,WAAmB,EACnB,SAAiB;QADjB,gBAAW,GAAX,WAAW,CAAQ;QACnB,cAAS,GAAT,SAAS,CAAQ;IACjC,CAAC;IAEJ,MAAM,CAAC,KAAiB,EAAE,GAAW;QACnC,MAAM,KAAK,GAAG;YACZ,GAAG;YACH,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;SACxB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEpC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,IAAI,CACnB,IAAI,CAAC,SAAS,EACd,GAAG,IAAI,CAAC,WAAW,sBAAsB,CAC1C,CAAC;QAEF,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CACT,gCAAgC,IAAI,CAAC,KAAK,CAAC,MAAM,cAAc,QAAQ,EAAE,CAC1E,CAAC;IACJ,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Cursor mode determination for sessions using HARNESS_CURSOR.
+ *
+ * Cloud Cursor agents are DISABLED platform-wide right now, so every session
+ * — including git-backed ones — runs as a LOCAL Cursor agent.
+ *
+ * Why cloud is disabled: Cursor cloud agents clone repositories via Cursor's
+ * own GitHub App connection and accept no per-request git credential. Stigmer
+ * collects the user's git credentials but has no way to hand them to Cursor's
+ * cloud clone, so git-backed cloud sessions fail for user repos. Until that
+ * credential story is resolved, Stigmer provisions the workspace itself
+ * (including git clones, using the user's GITHUB_TOKEN) and runs a local
+ * Cursor agent against it.
+ */
+import { CursorMode } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+/**
+ * Determine the CursorMode for a session.
+ *
+ * Always returns LOCAL while cloud Cursor agents are disabled (see the
+ * file-level note). The parameters are retained so the previous
+ * workspace/flag-based mode-selection logic (preserved in git history) can be
+ * restored when cloud is re-enabled.
+ */
+export declare function determineCursorMode(_workspaceEntries: WorkspaceEntry[], _cloudModeEnabled: boolean): CursorMode;
+/**
+ * Type guard that returns true when the mode is CLOUD.
+ *
+ * Treats UNSPECIFIED as LOCAL for backward compatibility with sessions
+ * created before the cursor_mode field existed.
+ */
+export declare function isCloudMode(mode: CursorMode): boolean;

package/dist/activities/execute-cursor/cursor-mode.js

@@ -0,0 +1,36 @@
+/**
+ * Cursor mode determination for sessions using HARNESS_CURSOR.
+ *
+ * Cloud Cursor agents are DISABLED platform-wide right now, so every session
+ * — including git-backed ones — runs as a LOCAL Cursor agent.
+ *
+ * Why cloud is disabled: Cursor cloud agents clone repositories via Cursor's
+ * own GitHub App connection and accept no per-request git credential. Stigmer
+ * collects the user's git credentials but has no way to hand them to Cursor's
+ * cloud clone, so git-backed cloud sessions fail for user repos. Until that
+ * credential story is resolved, Stigmer provisions the workspace itself
+ * (including git clones, using the user's GITHUB_TOKEN) and runs a local
+ * Cursor agent against it.
+ */
+import { CursorMode } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
+/**
+ * Determine the CursorMode for a session.
+ *
+ * Always returns LOCAL while cloud Cursor agents are disabled (see the
+ * file-level note). The parameters are retained so the previous
+ * workspace/flag-based mode-selection logic (preserved in git history) can be
+ * restored when cloud is re-enabled.
+ */
+export function determineCursorMode(_workspaceEntries, _cloudModeEnabled) {
+    return CursorMode.LOCAL;
+}
+/**
+ * Type guard that returns true when the mode is CLOUD.
+ *
+ * Treats UNSPECIFIED as LOCAL for backward compatibility with sessions
+ * created before the cursor_mode field existed.
+ */
+export function isCloudMode(mode) {
+    return mode === CursorMode.CLOUD;
+}
+//# sourceMappingURL=cursor-mode.js.map

package/dist/activities/execute-cursor/cursor-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-mode.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/cursor-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uDAAuD,CAAC;AAGnF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,iBAAmC,EACnC,iBAA0B;IAE1B,OAAO,UAAU,CAAC,KAAK,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,OAAO,IAAI,KAAK,UAAU,CAAC,KAAK,CAAC;AACnC,CAAC"}

package/dist/activities/execute-cursor/delta-enricher.d.ts

@@ -0,0 +1,87 @@
+/**
+ * DeltaEnricher processes Cursor SDK InteractionUpdate events to provide
+ * real-time enrichments that the stream channel alone cannot deliver.
+ *
+ * The Cursor SDK provides two concurrent event channels:
+ *   - run.stream() (SDKMessage) — coarse-grained, post-hoc events
+ *   - onDelta (InteractionUpdate) — fine-grained, real-time deltas
+ *
+ * The stream channel remains the source of truth for message construction.
+ * The delta channel provides supplementary real-time signals:
+ *   - shell-output-delta: live stdout/stderr from running shell commands
+ *   - tool-call-started/completed: precise lifecycle timestamps
+ *   - thinking-completed: accurate thinking duration from the SDK
+ *
+ * Concurrency model: Node.js is single-threaded. The onDelta callback fires
+ * between iterations of the for-await stream loop (during event loop yields).
+ * The enricher buffers data internally; the stream loop calls
+ * applyEnrichments() on each iteration to flush buffered state onto the
+ * message array. No locks needed — access is always sequential.
+ *
+ * Design invariant: The enricher never creates messages or tool calls.
+ * It only mutates existing ones that the MessageAccumulator has created.
+ * If a delta arrives before its corresponding stream event (e.g.,
+ * shell-output-delta before tool_call running), the data is buffered
+ * and applied retroactively on the next applyEnrichments() call that
+ * finds the matching ToolCall.
+ */
+import type { AgentMessage } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { InteractionUpdate } from "@cursor/sdk";
+export declare class DeltaEnricher {
+    private shellOutputByCallId;
+    private timingByCallId;
+    private thinkingDurationMs;
+    private _isDirty;
+    private lastPersistTime;
+    private lastShellCallId;
+    /**
+     * Minimum interval between persist-triggering dirty flags (milliseconds).
+     * Prevents excessive backend writes during rapid shell output bursts.
+     * Matches the Python agent-runner's update_scheduler interval.
+     */
+    static readonly PERSIST_DEBOUNCE_MS = 500;
+    /**
+     * Process a single InteractionUpdate from the onDelta callback.
+     * Buffers enrichment data for later application by applyEnrichments().
+     *
+     * Called from the onDelta callback (between stream loop iterations).
+     */
+    processDelta(update: InteractionUpdate): void;
+    /**
+     * Apply all buffered enrichments to the current message array.
+     * Called from the stream loop after each processEvent() iteration.
+     *
+     * Returns true if any enrichments were applied (messages were mutated).
+     */
+    applyEnrichments(messages: AgentMessage[]): boolean;
+    /**
+     * Whether the enricher has pending data that warrants an immediate persist.
+     * Only returns true when meaningful UI-visible data has arrived AND the
+     * debounce interval has elapsed since the last persist.
+     */
+    get isDirty(): boolean;
+    /**
+     * Acknowledge that a persist has occurred. Resets the dirty flag and
+     * records the persist timestamp for debounce calculations.
+     */
+    markPersisted(): void;
+    /**
+     * Finalize streaming state and reconcile tool call statuses.
+     *
+     * Called after the stream loop ends (alongside accumulator.finalize()).
+     * Two passes:
+     *   1. Clear `isStreaming` on all tool calls (existing behavior).
+     *   2. Reconciliation sweep: any tool call still RUNNING with evidence
+     *      of completion (completedAt set or result non-empty) is promoted
+     *      to COMPLETED. This is the catch-all safety net — when the stream
+     *      ends, no tool call should remain in a non-terminal status.
+     */
+    finalize(messages: AgentMessage[]): void;
+    private handleShellOutputDelta;
+    private handleToolCallStarted;
+    private handleToolCallCompleted;
+    private getOrCreateTiming;
+    private applyShellOutput;
+    private applyTiming;
+    private applyThinkingDuration;
+}

package/dist/activities/execute-cursor/delta-enricher.js

@@ -0,0 +1,265 @@
+/**
+ * DeltaEnricher processes Cursor SDK InteractionUpdate events to provide
+ * real-time enrichments that the stream channel alone cannot deliver.
+ *
+ * The Cursor SDK provides two concurrent event channels:
+ *   - run.stream() (SDKMessage) — coarse-grained, post-hoc events
+ *   - onDelta (InteractionUpdate) — fine-grained, real-time deltas
+ *
+ * The stream channel remains the source of truth for message construction.
+ * The delta channel provides supplementary real-time signals:
+ *   - shell-output-delta: live stdout/stderr from running shell commands
+ *   - tool-call-started/completed: precise lifecycle timestamps
+ *   - thinking-completed: accurate thinking duration from the SDK
+ *
+ * Concurrency model: Node.js is single-threaded. The onDelta callback fires
+ * between iterations of the for-await stream loop (during event loop yields).
+ * The enricher buffers data internally; the stream loop calls
+ * applyEnrichments() on each iteration to flush buffered state onto the
+ * message array. No locks needed — access is always sequential.
+ *
+ * Design invariant: The enricher never creates messages or tool calls.
+ * It only mutates existing ones that the MessageAccumulator has created.
+ * If a delta arrives before its corresponding stream event (e.g.,
+ * shell-output-delta before tool_call running), the data is buffered
+ * and applied retroactively on the next applyEnrichments() call that
+ * finds the matching ToolCall.
+ */
+import { ToolCallStatus, ToolCallStreamingSource } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { utcTimestamp } from "./message-translator.js";
+export class DeltaEnricher {
+    shellOutputByCallId = new Map();
+    timingByCallId = new Map();
+    thinkingDurationMs;
+    _isDirty = false;
+    lastPersistTime = 0;
+    lastShellCallId;
+    /**
+     * Minimum interval between persist-triggering dirty flags (milliseconds).
+     * Prevents excessive backend writes during rapid shell output bursts.
+     * Matches the Python agent-runner's update_scheduler interval.
+     */
+    static PERSIST_DEBOUNCE_MS = 500;
+    /**
+     * Process a single InteractionUpdate from the onDelta callback.
+     * Buffers enrichment data for later application by applyEnrichments().
+     *
+     * Called from the onDelta callback (between stream loop iterations).
+     */
+    processDelta(update) {
+        switch (update.type) {
+            case "shell-output-delta":
+                this.handleShellOutputDelta(update);
+                break;
+            case "tool-call-started":
+                this.handleToolCallStarted(update);
+                break;
+            case "tool-call-completed":
+                this.handleToolCallCompleted(update);
+                break;
+            case "thinking-completed":
+                this.thinkingDurationMs = update.thinkingDurationMs;
+                break;
+        }
+    }
+    /**
+     * Apply all buffered enrichments to the current message array.
+     * Called from the stream loop after each processEvent() iteration.
+     *
+     * Returns true if any enrichments were applied (messages were mutated).
+     */
+    applyEnrichments(messages) {
+        let applied = false;
+        if (this.shellOutputByCallId.size > 0) {
+            applied = this.applyShellOutput(messages) || applied;
+        }
+        if (this.timingByCallId.size > 0) {
+            applied = this.applyTiming(messages) || applied;
+        }
+        if (this.thinkingDurationMs !== undefined) {
+            applied = this.applyThinkingDuration(messages) || applied;
+        }
+        return applied;
+    }
+    /**
+     * Whether the enricher has pending data that warrants an immediate persist.
+     * Only returns true when meaningful UI-visible data has arrived AND the
+     * debounce interval has elapsed since the last persist.
+     */
+    get isDirty() {
+        if (!this._isDirty)
+            return false;
+        const now = Date.now();
+        return (now - this.lastPersistTime) >= DeltaEnricher.PERSIST_DEBOUNCE_MS;
+    }
+    /**
+     * Acknowledge that a persist has occurred. Resets the dirty flag and
+     * records the persist timestamp for debounce calculations.
+     */
+    markPersisted() {
+        this._isDirty = false;
+        this.lastPersistTime = Date.now();
+    }
+    /**
+     * Finalize streaming state and reconcile tool call statuses.
+     *
+     * Called after the stream loop ends (alongside accumulator.finalize()).
+     * Two passes:
+     *   1. Clear `isStreaming` on all tool calls (existing behavior).
+     *   2. Reconciliation sweep: any tool call still RUNNING with evidence
+     *      of completion (completedAt set or result non-empty) is promoted
+     *      to COMPLETED. This is the catch-all safety net — when the stream
+     *      ends, no tool call should remain in a non-terminal status.
+     */
+    finalize(messages) {
+        for (const msg of messages) {
+            for (const tc of msg.toolCalls) {
+                if (tc.isStreaming) {
+                    tc.isStreaming = false;
+                    tc.streamingSource = ToolCallStreamingSource.UNSPECIFIED;
+                }
+                if (tc.status === ToolCallStatus.TOOL_CALL_RUNNING && (tc.completedAt || tc.result)) {
+                    tc.status = ToolCallStatus.TOOL_CALL_COMPLETED;
+                    if (!tc.completedAt) {
+                        tc.completedAt = utcTimestamp();
+                    }
+                    console.log(`DeltaEnricher finalize reconciliation: promoted tool call ` +
+                        `${tc.id} (${tc.name}) from RUNNING to COMPLETED`);
+                }
+            }
+        }
+    }
+    handleShellOutputDelta(update) {
+        const event = update.event;
+        const text = extractShellOutputText(event);
+        if (!text)
+            return;
+        const callId = extractCallIdFromShellEvent(event) ?? this.lastShellCallId;
+        if (!callId)
+            return;
+        let buffer = this.shellOutputByCallId.get(callId);
+        if (!buffer) {
+            buffer = { chunks: [], totalLength: 0 };
+            this.shellOutputByCallId.set(callId, buffer);
+        }
+        buffer.chunks.push(text);
+        buffer.totalLength += text.length;
+        this._isDirty = true;
+    }
+    handleToolCallStarted(update) {
+        const timing = this.getOrCreateTiming(update.callId);
+        timing.startedAt = utcTimestamp();
+        if (update.toolCall.type === "shell") {
+            this.lastShellCallId = update.callId;
+        }
+    }
+    handleToolCallCompleted(update) {
+        const timing = this.getOrCreateTiming(update.callId);
+        timing.completedAt = utcTimestamp();
+    }
+    getOrCreateTiming(callId) {
+        let timing = this.timingByCallId.get(callId);
+        if (!timing) {
+            timing = {};
+            this.timingByCallId.set(callId, timing);
+        }
+        return timing;
+    }
+    applyShellOutput(messages) {
+        let applied = false;
+        for (const [callId, buffer] of this.shellOutputByCallId) {
+            const tc = findToolCallById(messages, callId);
+            if (!tc)
+                continue;
+            const content = buffer.chunks.join("");
+            tc.result = content;
+            tc.isStreaming = true;
+            tc.streamingSource = ToolCallStreamingSource.OUTPUT;
+            buffer.chunks = [content];
+            applied = true;
+        }
+        return applied;
+    }
+    applyTiming(messages) {
+        let applied = false;
+        for (const [callId, timing] of this.timingByCallId) {
+            const tc = findToolCallById(messages, callId);
+            if (!tc)
+                continue;
+            if (timing.startedAt && !tc.startedAt) {
+                tc.startedAt = timing.startedAt;
+                applied = true;
+            }
+            if (timing.completedAt && !tc.completedAt) {
+                tc.completedAt = timing.completedAt;
+                applied = true;
+            }
+            // Promote status when the delta channel reports completion but
+            // the stream channel has not yet delivered the status update.
+            // Only promotes RUNNING -> COMPLETED; never overwrites terminal
+            // states (FAILED, SKIPPED) that carry richer semantics.
+            if (timing.completedAt && tc.status === ToolCallStatus.TOOL_CALL_RUNNING) {
+                tc.status = ToolCallStatus.TOOL_CALL_COMPLETED;
+                applied = true;
+            }
+            this.timingByCallId.delete(callId);
+        }
+        return applied;
+    }
+    applyThinkingDuration(_messages) {
+        // Log thinking duration for observability. No proto field exists for this;
+        // adding one is a future enhancement (requires proto + UI changes).
+        if (this.thinkingDurationMs !== undefined) {
+            console.log(`DeltaEnricher: thinking completed in ${this.thinkingDurationMs}ms`);
+            this.thinkingDurationMs = undefined;
+            return true;
+        }
+        return false;
+    }
+}
+function findToolCallById(messages, callId) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        for (const tc of messages[i].toolCalls) {
+            if (tc.id === callId)
+                return tc;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract displayable text from a shell-output-delta event payload.
+ *
+ * The Cursor SDK's shell-output-delta event carries a generic
+ * Record<string, unknown>. Based on observed payloads, the structure is:
+ *   { type: "stdout" | "stderr", data: string }
+ * or sometimes:
+ *   { output: string }
+ *
+ * This function handles both shapes defensively.
+ */
+function extractShellOutputText(event) {
+    if (typeof event.data === "string")
+        return event.data;
+    if (typeof event.output === "string")
+        return event.output;
+    if (typeof event.text === "string")
+        return event.text;
+    return "";
+}
+/**
+ * Extract the tool call ID from a shell-output-delta event payload.
+ *
+ * The event may carry callId directly, or we may need to match by
+ * context. Based on observed payloads:
+ *   { callId: string, type: "stdout", data: string }
+ */
+function extractCallIdFromShellEvent(event) {
+    if (typeof event.callId === "string")
+        return event.callId;
+    if (typeof event.call_id === "string")
+        return event.call_id;
+    if (typeof event.id === "string")
+        return event.id;
+    return undefined;
+}
+//# sourceMappingURL=delta-enricher.js.map

package/dist/activities/execute-cursor/delta-enricher.js.map

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

package/dist/activities/execute-cursor/env-resolver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resolve execution environment variables from the ExecutionContext.
+ *
+ * Mirrors the Python agent-runner's environment.py: fetches the merged,
+ * decrypted env vars from the backend so MCP servers receive credentials
+ * (e.g. API keys for HTTP headers, secrets for stdio subprocesses).
+ */
+import type { StigmerClient } from "../../client/stigmer-client.js";
+export interface EnvResult {
+    envVars: Record<string, string>;
+    secretKeys: Set<string>;
+}
+/**
+ * Fetch and extract env vars from the ExecutionContext for a given execution.
+ *
+ * Returns an empty env if no ExecutionContext exists (e.g. executions
+ * without any configured secrets or env vars).
+ */
+export declare function resolveExecutionEnv(client: StigmerClient, executionId: string): Promise<EnvResult>;

package/dist/activities/execute-cursor/env-resolver.js

@@ -0,0 +1,47 @@
+/**
+ * Resolve execution environment variables from the ExecutionContext.
+ *
+ * Mirrors the Python agent-runner's environment.py: fetches the merged,
+ * decrypted env vars from the backend so MCP servers receive credentials
+ * (e.g. API keys for HTTP headers, secrets for stdio subprocesses).
+ */
+/**
+ * Fetch and extract env vars from the ExecutionContext for a given execution.
+ *
+ * Returns an empty env if no ExecutionContext exists (e.g. executions
+ * without any configured secrets or env vars).
+ */
+export async function resolveExecutionEnv(client, executionId) {
+    let execCtx;
+    try {
+        execCtx = await client.getExecutionContextByExecutionId(executionId);
+    }
+    catch (err) {
+        const code = err?.code;
+        // NOT_FOUND (5) is expected for executions without env vars
+        if (code === 5) {
+            console.log(`No ExecutionContext found for execution ${executionId} — ` +
+                `proceeding with empty environment.`);
+            return { envVars: {}, secretKeys: new Set() };
+        }
+        throw err;
+    }
+    const envVars = {};
+    const secretKeys = new Set();
+    const data = execCtx.spec?.data;
+    if (data) {
+        for (const [key, execValue] of Object.entries(data)) {
+            envVars[key] = execValue.value;
+            if (execValue.isSecret) {
+                secretKeys.add(key);
+            }
+        }
+    }
+    console.log(`Resolved environment from ExecutionContext: ` +
+        `context_id=${execCtx.metadata?.id}, ` +
+        `env_count=${Object.keys(envVars).length}, ` +
+        `secret_count=${secretKeys.size}, ` +
+        `keys=[${Object.keys(envVars).sort().join(", ")}]`);
+    return { envVars, secretKeys };
+}
+//# sourceMappingURL=env-resolver.js.map

package/dist/activities/execute-cursor/env-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-resolver.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/env-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAqB,EACrB,WAAmB;IAEnB,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAAyB,EAAE,IAAI,CAAC;QAC9C,4DAA4D;QAC5D,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,2CAA2C,WAAW,KAAK;gBACzD,oCAAoC,CACvC,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;QAChD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;IAEhC,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC;YAC/B,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CACT,8CAA8C;QAC5C,cAAc,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI;QACtC,aAAa,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI;QAC5C,gBAAgB,UAAU,CAAC,IAAI,IAAI;QACnC,SAAS,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACrD,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC"}

package/dist/activities/execute-cursor/error-classifier.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Classifies Cursor SDK errors into actionable categories.
+ *
+ * Used after run.wait() returns status: "error" to:
+ * 1. Determine whether the poisoned-handle retry should fire
+ * 2. Prefix status.error with a human-readable category
+ * 3. Surface isRetryable for future workflow-level retry decisions
+ *
+ * Error detail can come from several sources (in priority order):
+ * - A thrown CursorSdkError's structured fields (highest fidelity)
+ * - run.wait().result (SDK-provided string, often bare/generic)
+ * - SDKStatusMessage with status "ERROR" from the stream
+ * - ConnectError captured from process unhandledRejection
+ * - Text extracted from the failing run.conversation() turn
+ *
+ * Execution context (isResumedHandle) is applied as a post-classification
+ * override: when no source can positively identify the error category and
+ * the agent was obtained via resume, the error is upgraded to "agent-stale"
+ * so that poisoned-handle recovery fires.
+ */
+import type { CapturedRejection } from "./rejection-capture.js";
+export type ErrorCategory = "auth" | "rate-limit" | "network" | "agent-stale" | "model" | "unknown";
+export interface ClassifiedError {
+    category: ErrorCategory;
+    message: string;
+    retryable: boolean;
+    source: "sdk" | "stream" | "rejection" | "conversation" | "fallback";
+}
+/**
+ * Structured fields lifted from a thrown CursorSdkError (errors.d.ts:
+ * { code, status, isRetryable, cause, endpoint, requestId, operation }).
+ * Only the fields used for classification are retained.
+ */
+export interface SdkErrorFields {
+    code?: string;
+    status?: number;
+    message?: string;
+}
+interface SynthesizeErrorOpts {
+    /** Structured fields from a thrown CursorSdkError — highest-fidelity source. */
+    sdkError?: SdkErrorFields;
+    sdkResultFields: string | undefined;
+    streamErrorMessage: string | undefined;
+    capturedRejection: CapturedRejection | undefined;
+    /** Text extracted from the failing run.conversation() turn, if any. */
+    conversationErrorText?: string;
+    isResumedHandle: boolean;
+    fallbackContext: {
+        model: string;
+        mode: string;
+        agentId: string;
+    };
+    /** Duration of the SDK run in ms — used for transport timeout heuristic. */
+    durationMs?: number;
+    /** Number of messages received from the stream (0 = no response at all). */
+    messageCount?: number;
+}
+/**
+ * Synthesize a classified error from up to three sources, then apply
+ * execution context.
+ *
+ * Two-step process:
+ * 1. Classify from the best available source (SDK > stream > rejection > fallback).
+ * 2. Apply execution context: on resumed handles, "unknown" from any source
+ *    is upgraded to "agent-stale" so poisoned-handle recovery can fire.
+ *
+ * The override only applies to "unknown" — specific diagnoses (auth,
+ * rate-limit, network, model) are never overridden, even on resumed handles.
+ */
+export declare function synthesizeError(opts: SynthesizeErrorOpts): ClassifiedError;
+export declare function formatClassifiedError(err: ClassifiedError): string;
+export declare function shouldRetryWithFreshAgent(err: ClassifiedError): boolean;
+export {};