@stigmer/runner 3.15.3-dev.20260914121148 → 3.16.0

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

@@ -1,265 +0,0 @@
-/**
- * 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

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