@stigmer/runner 3.0.1

package/dist/activities/execute-deep-agent/streaming-scheduler.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Hybrid time + event threshold scheduler for streaming status updates.
+ *
+ * Addresses the limitations of naive event-count approaches:
+ * - Slow operations (30s tool): no update for 30s — user thinks stuck
+ * - Fast operations (100 events/sec): 10 updates/sec — wasteful
+ *
+ * Algorithm:
+ *   shouldSendUpdate =
+ *     (timeSinceLast >= minInterval AND eventsSinceLast >= 1)
+ *     OR (eventsSinceLast >= burstThreshold)
+ *     OR (timeSinceLast >= maxInterval)
+ *     OR firstUpdate
+ *
+ * Ported from Python StreamingUpdateScheduler.
+ */
+export declare enum UpdateReason {
+    TIME_THRESHOLD = "time_threshold",
+    BURST_PROTECTION = "burst_protection",
+    KEEPALIVE = "keepalive",
+    FIRST_UPDATE = "first_update",
+    NONE = "none"
+}
+export interface StreamingConfig {
+    /** Minimum time between updates (ms). Rate limit: max ~2 updates/second. */
+    readonly minIntervalMs: number;
+    /** Maximum time before forced update (ms). Keepalive during long tools. */
+    readonly maxIntervalMs: number;
+    /** Number of events that triggers immediate update. Burst protection. */
+    readonly burstThreshold: number;
+}
+/**
+ * Load streaming config from environment variables with validation.
+ * Invalid values fall back to defaults with a console warning.
+ */
+export declare function loadStreamingConfig(): StreamingConfig;
+export declare class StreamingUpdateScheduler {
+    readonly config: StreamingConfig;
+    private lastUpdateTime;
+    private lastUpdateEvents;
+    private lastReason;
+    private firstCheck;
+    /**
+     * @param config Scheduling parameters. Defaults to 500ms/5s/50.
+     * @param nowMs Injectable clock for testing. Defaults to performance.now().
+     */
+    constructor(config?: StreamingConfig, nowMs?: number);
+    /**
+     * Determine whether a status update should be sent now.
+     *
+     * Call after processing each event. If this returns true, send the
+     * update and then call {@link markUpdateSent}.
+     */
+    shouldSendUpdate(eventsProcessed: number, nowMs?: number): boolean;
+    /** Reset tracking state after an update was sent. */
+    markUpdateSent(eventsProcessed: number, nowMs?: number): void;
+    get updateReason(): UpdateReason;
+    timeSinceLastUpdateMs(nowMs?: number): number;
+    eventsSinceLastUpdate(eventsProcessed: number): number;
+}

package/dist/activities/execute-deep-agent/streaming-scheduler.js

@@ -0,0 +1,114 @@
+/**
+ * Hybrid time + event threshold scheduler for streaming status updates.
+ *
+ * Addresses the limitations of naive event-count approaches:
+ * - Slow operations (30s tool): no update for 30s — user thinks stuck
+ * - Fast operations (100 events/sec): 10 updates/sec — wasteful
+ *
+ * Algorithm:
+ *   shouldSendUpdate =
+ *     (timeSinceLast >= minInterval AND eventsSinceLast >= 1)
+ *     OR (eventsSinceLast >= burstThreshold)
+ *     OR (timeSinceLast >= maxInterval)
+ *     OR firstUpdate
+ *
+ * Ported from Python StreamingUpdateScheduler.
+ */
+export var UpdateReason;
+(function (UpdateReason) {
+    UpdateReason["TIME_THRESHOLD"] = "time_threshold";
+    UpdateReason["BURST_PROTECTION"] = "burst_protection";
+    UpdateReason["KEEPALIVE"] = "keepalive";
+    UpdateReason["FIRST_UPDATE"] = "first_update";
+    UpdateReason["NONE"] = "none";
+})(UpdateReason || (UpdateReason = {}));
+const DEFAULT_CONFIG = {
+    minIntervalMs: 500,
+    maxIntervalMs: 5000,
+    burstThreshold: 50,
+};
+/**
+ * Load streaming config from environment variables with validation.
+ * Invalid values fall back to defaults with a console warning.
+ */
+export function loadStreamingConfig() {
+    const minIntervalMs = parsePositiveInt(process.env.STREAMING_MIN_INTERVAL_MS, DEFAULT_CONFIG.minIntervalMs, "STREAMING_MIN_INTERVAL_MS");
+    let maxIntervalMs = parsePositiveInt(process.env.STREAMING_MAX_INTERVAL_MS, DEFAULT_CONFIG.maxIntervalMs, "STREAMING_MAX_INTERVAL_MS");
+    const burstThreshold = parsePositiveInt(process.env.STREAMING_BURST_THRESHOLD, DEFAULT_CONFIG.burstThreshold, "STREAMING_BURST_THRESHOLD");
+    if (maxIntervalMs < minIntervalMs) {
+        console.warn(`STREAMING_MAX_INTERVAL_MS (${maxIntervalMs}) < ` +
+            `STREAMING_MIN_INTERVAL_MS (${minIntervalMs}). Setting max to min value.`);
+        maxIntervalMs = minIntervalMs;
+    }
+    return { minIntervalMs, maxIntervalMs, burstThreshold };
+}
+function parsePositiveInt(raw, fallback, envName) {
+    if (!raw)
+        return fallback;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0 || !Number.isInteger(parsed)) {
+        console.warn(`Invalid ${envName}='${raw}'. Using default: ${fallback}`);
+        return fallback;
+    }
+    return parsed;
+}
+export class StreamingUpdateScheduler {
+    config;
+    lastUpdateTime;
+    lastUpdateEvents = 0;
+    lastReason = UpdateReason.NONE;
+    firstCheck = true;
+    /**
+     * @param config Scheduling parameters. Defaults to 500ms/5s/50.
+     * @param nowMs Injectable clock for testing. Defaults to performance.now().
+     */
+    constructor(config, nowMs) {
+        this.config = config ?? DEFAULT_CONFIG;
+        this.lastUpdateTime = nowMs ?? performance.now();
+    }
+    /**
+     * Determine whether a status update should be sent now.
+     *
+     * Call after processing each event. If this returns true, send the
+     * update and then call {@link markUpdateSent}.
+     */
+    shouldSendUpdate(eventsProcessed, nowMs) {
+        const now = nowMs ?? performance.now();
+        const timeSinceLastMs = now - this.lastUpdateTime;
+        const eventsSinceLast = eventsProcessed - this.lastUpdateEvents;
+        if (this.firstCheck && eventsSinceLast >= 1) {
+            this.lastReason = UpdateReason.FIRST_UPDATE;
+            return true;
+        }
+        if (timeSinceLastMs >= this.config.minIntervalMs && eventsSinceLast >= 1) {
+            this.lastReason = UpdateReason.TIME_THRESHOLD;
+            return true;
+        }
+        if (eventsSinceLast >= this.config.burstThreshold) {
+            this.lastReason = UpdateReason.BURST_PROTECTION;
+            return true;
+        }
+        if (timeSinceLastMs >= this.config.maxIntervalMs) {
+            this.lastReason = UpdateReason.KEEPALIVE;
+            return true;
+        }
+        this.lastReason = UpdateReason.NONE;
+        return false;
+    }
+    /** Reset tracking state after an update was sent. */
+    markUpdateSent(eventsProcessed, nowMs) {
+        this.lastUpdateTime = nowMs ?? performance.now();
+        this.lastUpdateEvents = eventsProcessed;
+        this.firstCheck = false;
+    }
+    get updateReason() {
+        return this.lastReason;
+    }
+    timeSinceLastUpdateMs(nowMs) {
+        return (nowMs ?? performance.now()) - this.lastUpdateTime;
+    }
+    eventsSinceLastUpdate(eventsProcessed) {
+        return eventsProcessed - this.lastUpdateEvents;
+    }
+}
+//# sourceMappingURL=streaming-scheduler.js.map

package/dist/activities/execute-deep-agent/streaming-scheduler.js.map

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

package/dist/activities/execute-deep-agent/streaming-side-effects.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Side-effect triggers for v3 streaming: artifact publish and git writeback.
+ *
+ * v3 `tool-finished` events do not carry input — unlike v2 `on_tool_end`.
+ * A ToolInputCache correlates `tool-started` input with `tool-finished`
+ * by `tool_call_id` so file paths can be extracted for publish/writeback.
+ */
+import type { V3ProtocolEvent } from "./v3-event-recorder.js";
+import type { InlinePublisher } from "./inline-publisher.js";
+import type { WriteBackCoordinator } from "./writeback-coordinator.js";
+export declare class StreamingSideEffects {
+    private readonly inputCache;
+    private readonly inlinePublisher;
+    private readonly writebackCoordinator;
+    readonly pendingPublishPromises: Promise<void>[];
+    readonly pendingWritebackPromises: Promise<void>[];
+    constructor(opts: {
+        inlinePublisher?: InlinePublisher;
+        writebackCoordinator?: WriteBackCoordinator;
+    });
+    onProtocolEvent(event: V3ProtocolEvent): void;
+}

package/dist/activities/execute-deep-agent/streaming-side-effects.js

@@ -0,0 +1,83 @@
+/**
+ * Side-effect triggers for v3 streaming: artifact publish and git writeback.
+ *
+ * v3 `tool-finished` events do not carry input — unlike v2 `on_tool_end`.
+ * A ToolInputCache correlates `tool-started` input with `tool-finished`
+ * by `tool_call_id` so file paths can be extracted for publish/writeback.
+ */
+const FILE_MODIFYING_TOOLS = new Set([
+    "write_file", "edit_file", "create_file",
+    "write", "edit", "create",
+    "str_replace_editor",
+]);
+export class StreamingSideEffects {
+    inputCache = new Map();
+    inlinePublisher;
+    writebackCoordinator;
+    pendingPublishPromises = [];
+    pendingWritebackPromises = [];
+    constructor(opts) {
+        this.inlinePublisher = opts.inlinePublisher;
+        this.writebackCoordinator = opts.writebackCoordinator;
+    }
+    onProtocolEvent(event) {
+        if (event.method !== "tools")
+            return;
+        if (!this.inlinePublisher && !this.writebackCoordinator)
+            return;
+        const data = event.params.data;
+        if (!data)
+            return;
+        const eventType = (data.event ?? data.type);
+        const callId = (data.tool_call_id ?? data.toolCallId);
+        if (!callId)
+            return;
+        if (eventType === "tool-started") {
+            const toolName = (data.tool_name ?? data.toolName ?? data.name ?? "");
+            const rawInput = data.input;
+            let input = {};
+            if (typeof rawInput === "string") {
+                try {
+                    input = JSON.parse(rawInput);
+                }
+                catch { /* leave empty */ }
+            }
+            else if (rawInput && typeof rawInput === "object" && !Array.isArray(rawInput)) {
+                input = rawInput;
+            }
+            this.inputCache.set(callId, { toolName, input });
+            return;
+        }
+        if (eventType === "tool-finished") {
+            const cached = this.inputCache.get(callId);
+            this.inputCache.delete(callId);
+            if (!cached)
+                return;
+            if (!FILE_MODIFYING_TOOLS.has(cached.toolName))
+                return;
+            const filePath = extractFilePath(cached.input);
+            if (!filePath)
+                return;
+            if (this.inlinePublisher) {
+                this.pendingPublishPromises.push(this.inlinePublisher.publish(filePath));
+            }
+            if (this.writebackCoordinator) {
+                this.pendingWritebackPromises.push(this.writebackCoordinator.onFileModified(filePath));
+            }
+        }
+    }
+}
+function extractFilePath(input) {
+    if (typeof input.path === "string")
+        return input.path;
+    if (typeof input.file_path === "string")
+        return input.file_path;
+    if (typeof input.filePath === "string")
+        return input.filePath;
+    if (typeof input.filename === "string")
+        return input.filename;
+    if (typeof input.file === "string")
+        return input.file;
+    return null;
+}
+//# sourceMappingURL=streaming-side-effects.js.map

package/dist/activities/execute-deep-agent/streaming-side-effects.js.map

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

package/dist/activities/execute-deep-agent/streaming-terminal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared terminal state handlers for both v2 and v3 streaming loops.
+ *
+ * Extracted so pause, stop, and recursion-limit handling is identical
+ * between both paths — no silent semantic divergence.
+ */
+import type { ExecutionStatusWriter } from "./execution-status-writer.js";
+import type { StreamResult } from "./streaming.js";
+export declare function handlePause(writer: ExecutionStatusWriter, eventsProcessed: number, pendingPublishPromises: readonly Promise<void>[], pendingWritebackPromises: readonly Promise<void>[]): StreamResult;
+export declare function handleStop(writer: ExecutionStatusWriter, eventsProcessed: number, pendingPublishPromises: readonly Promise<void>[], pendingWritebackPromises: readonly Promise<void>[]): StreamResult;
+export declare function handleRecursionLimit(writer: ExecutionStatusWriter, eventsProcessed: number, pendingPublishPromises: readonly Promise<void>[], pendingWritebackPromises: readonly Promise<void>[]): StreamResult;
+export declare function isGraphRecursionError(err: unknown): boolean;

package/dist/activities/execute-deep-agent/streaming-terminal.js

@@ -0,0 +1,71 @@
+/**
+ * Shared terminal state handlers for both v2 and v3 streaming loops.
+ *
+ * Extracted so pause, stop, and recursion-limit handling is identical
+ * between both paths — no silent semantic divergence.
+ */
+import { create } from "@bufbuild/protobuf";
+import { AgentMessageSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { ExecutionPhase, MessageType } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { slimStatus, utcTimestamp } from "../../shared/status.js";
+export function handlePause(writer, eventsProcessed, pendingPublishPromises, pendingWritebackPromises) {
+    const status = writer.currentStatus;
+    status.phase = ExecutionPhase.EXECUTION_PAUSED;
+    status.messages.push(create(AgentMessageSchema, {
+        type: MessageType.MESSAGE_SYSTEM,
+        content: "Execution paused by user. Use resume to continue from this checkpoint.",
+        timestamp: utcTimestamp(),
+    }));
+    return {
+        eventsProcessed,
+        terminalStatus: slimStatus(status),
+        pendingPublishPromises,
+        pendingWritebackPromises,
+    };
+}
+export function handleStop(writer, eventsProcessed, pendingPublishPromises, pendingWritebackPromises) {
+    const status = writer.currentStatus;
+    status.phase = ExecutionPhase.EXECUTION_COMPLETED;
+    status.completedAt = utcTimestamp();
+    status.messages.push(create(AgentMessageSchema, {
+        type: MessageType.MESSAGE_SYSTEM,
+        content: "Execution stopped by the platform.",
+        timestamp: utcTimestamp(),
+    }));
+    return {
+        eventsProcessed,
+        terminalStatus: slimStatus(status),
+        pendingPublishPromises,
+        pendingWritebackPromises,
+    };
+}
+export function handleRecursionLimit(writer, eventsProcessed, pendingPublishPromises, pendingWritebackPromises) {
+    const status = writer.currentStatus;
+    status.phase = ExecutionPhase.EXECUTION_TERMINATED;
+    status.completedAt = utcTimestamp();
+    status.error =
+        `Agent reached the tool-call limit after processing ${eventsProcessed} events. ` +
+            `Send another message to continue.`;
+    status.messages.push(create(AgentMessageSchema, {
+        type: MessageType.MESSAGE_SYSTEM,
+        content: "The agent reached the tool-call limit for this message. " +
+            "Work completed so far has been saved. " +
+            "Send another message to continue where the agent left off.",
+        timestamp: utcTimestamp(),
+    }));
+    return {
+        eventsProcessed,
+        terminalStatus: slimStatus(status),
+        pendingPublishPromises,
+        pendingWritebackPromises,
+    };
+}
+export function isGraphRecursionError(err) {
+    if (err instanceof Error) {
+        return err.constructor.name === "GraphRecursionError" ||
+            err.message.includes("GraphRecursionError") ||
+            err.message.includes("Recursion limit");
+    }
+    return false;
+}
+//# sourceMappingURL=streaming-terminal.js.map

package/dist/activities/execute-deep-agent/streaming-terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-terminal.js","sourceRoot":"","sources":["../../../src/activities/execute-deep-agent/streaming-terminal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iEAAiE,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,8DAA8D,CAAC;AAG3G,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,UAAU,WAAW,CACzB,MAA6B,EAC7B,eAAuB,EACvB,sBAAgD,EAChD,wBAAkD;IAElD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,gBAAgB,CAAC;IAC/C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAC9C,IAAI,EAAE,WAAW,CAAC,cAAc;QAChC,OAAO,EAAE,wEAAwE;QACjF,SAAS,EAAE,YAAY,EAAE;KAC1B,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,eAAe;QACf,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC;QAClC,sBAAsB;QACtB,wBAAwB;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,MAA6B,EAC7B,eAAuB,EACvB,sBAAgD,EAChD,wBAAkD;IAElD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,mBAAmB,CAAC;IAClD,MAAM,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC;IACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAC9C,IAAI,EAAE,WAAW,CAAC,cAAc;QAChC,OAAO,EAAE,oCAAoC;QAC7C,SAAS,EAAE,YAAY,EAAE;KAC1B,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,eAAe;QACf,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC;QAClC,sBAAsB;QACtB,wBAAwB;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAA6B,EAC7B,eAAuB,EACvB,sBAAgD,EAChD,wBAAkD;IAElD,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,oBAAoB,CAAC;IACnD,MAAM,CAAC,WAAW,GAAG,YAAY,EAAE,CAAC;IACpC,MAAM,CAAC,KAAK;QACV,sDAAsD,eAAe,WAAW;YAChF,mCAAmC,CAAC;IACtC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE;QAC9C,IAAI,EAAE,WAAW,CAAC,cAAc;QAChC,OAAO,EACL,0DAA0D;YAC1D,wCAAwC;YACxC,4DAA4D;QAC9D,SAAS,EAAE,YAAY,EAAE;KAC1B,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,eAAe;QACf,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC;QAClC,sBAAsB;QACtB,wBAAwB;KACzB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,qBAAqB;YACnD,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;YAC3C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * V3 streaming execution loop for ExecuteDeepAgent.
+ *
+ * Feature-flagged path activated by LANGGRAPH_STREAM_EVENTS_VERSION=v3.
+ * Calls the v3 streamEvents API (two-arg, returns Promise<GraphRunStream>),
+ * iterates raw ProtocolEvents, feeds them through the V3ProtocolNormalizer
+ * and V3StatusBuilder, persists status on schedule, and handles terminal
+ * conditions (STOP, pause, recursion limit) identically to v2.
+ *
+ * Phase 2: full orchestration parity with streamExecutionV2.
+ */
+import type { StreamDependencies, StreamResult } from "./streaming.js";
+export declare function streamExecutionV3(deps: StreamDependencies): Promise<StreamResult>;

package/dist/activities/execute-deep-agent/streaming-v3.js

@@ -0,0 +1,170 @@
+/**
+ * V3 streaming execution loop for ExecuteDeepAgent.
+ *
+ * Feature-flagged path activated by LANGGRAPH_STREAM_EVENTS_VERSION=v3.
+ * Calls the v3 streamEvents API (two-arg, returns Promise<GraphRunStream>),
+ * iterates raw ProtocolEvents, feeds them through the V3ProtocolNormalizer
+ * and V3StatusBuilder, persists status on schedule, and handles terminal
+ * conditions (STOP, pause, recursion limit) identically to v2.
+ *
+ * Phase 2: full orchestration parity with streamExecutionV2.
+ */
+import { StallTimeoutError } from "./streaming.js";
+import { ExecutionControlSignal, ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { createV3EventRecorder } from "./v3-event-recorder.js";
+import { normalize } from "./v3-protocol-normalizer.js";
+import { V3StatusBuilder } from "./v3-status-builder.js";
+import { StreamingUpdateScheduler } from "./streaming-scheduler.js";
+import { persistWithRetry } from "../../shared/grpc-retry.js";
+import { slimStatus } from "../../shared/status.js";
+import { StreamingSideEffects } from "./streaming-side-effects.js";
+import { handlePause, handleStop, handleRecursionLimit, isGraphRecursionError, } from "./streaming-terminal.js";
+const DEFAULT_STALL_TIMEOUT_MS = 120_000;
+const HEARTBEAT_INTERVAL_MS = 2_000;
+const RUN_OUTPUT_TIMEOUT_MS = 30_000;
+export async function streamExecutionV3(deps) {
+    const { agentGraph, langgraphInput, langgraphConfig, executionId, client, initialStatus, streamingConfig, retryOptions, stallTimeoutMs = DEFAULT_STALL_TIMEOUT_MS, heartbeatFn, isCancelledFn, gracefulStop, inlinePublisher, writebackCoordinator, approvalProvider, } = deps;
+    const statusBuilder = new V3StatusBuilder(executionId, initialStatus);
+    if (approvalProvider) {
+        statusBuilder.setApprovalProvider(approvalProvider);
+    }
+    const scheduler = new StreamingUpdateScheduler(streamingConfig);
+    const recorder = createV3EventRecorder(executionId, process.env.V3_EVENT_RECORD_DIR);
+    const abortController = new AbortController();
+    const sideEffects = new StreamingSideEffects({
+        inlinePublisher,
+        writebackCoordinator,
+    });
+    // Pre-loop heartbeat to cover the initial await
+    sendHeartbeat(heartbeatFn, executionId, 0, statusBuilder);
+    const run = await agentGraph.streamEvents(langgraphInput, {
+        ...langgraphConfig,
+        version: "v3",
+        signal: abortController.signal,
+    });
+    let eventsProcessed = 0;
+    let lastActivityAt = performance.now();
+    const heartbeatTimer = setInterval(() => {
+        sendHeartbeat(heartbeatFn, executionId, eventsProcessed, statusBuilder);
+    }, HEARTBEAT_INTERVAL_MS);
+    try {
+        for await (const event of run) {
+            if (isCancelledFn?.()) {
+                abortController.abort("Cancelled by platform");
+                statusBuilder.cancelSubAgents();
+                return handlePause(statusBuilder, eventsProcessed, sideEffects.pendingPublishPromises, sideEffects.pendingWritebackPromises);
+            }
+            lastActivityAt = performance.now();
+            recorder?.record(event, eventsProcessed);
+            for (const normalized of normalize(event)) {
+                statusBuilder.processEvent(normalized);
+            }
+            sideEffects.onProtocolEvent(event);
+            eventsProcessed++;
+            const shouldPersist = statusBuilder.forceNextUpdate ||
+                scheduler.shouldSendUpdate(eventsProcessed);
+            if (shouldPersist) {
+                if (statusBuilder.forceNextUpdate) {
+                    statusBuilder.clearForceFlag();
+                }
+                statusBuilder.syncSubAgentExecutions();
+                const signal = await persistWithRetry(client, executionId, statusBuilder.currentStatus, retryOptions);
+                scheduler.markUpdateSent(eventsProcessed);
+                if (signal === ExecutionControlSignal.STOP) {
+                    console.warn(`[streaming-v3] STOP signal received for execution ${executionId}`);
+                    if (gracefulStop) {
+                        gracefulStop.activate("Platform STOP signal");
+                    }
+                    else {
+                        return handleStop(statusBuilder, eventsProcessed, sideEffects.pendingPublishPromises, sideEffects.pendingWritebackPromises);
+                    }
+                }
+            }
+            checkStallTimeout(lastActivityAt, stallTimeoutMs, executionId);
+        }
+    }
+    catch (err) {
+        if (isGraphRecursionError(err)) {
+            await recorder?.flush();
+            return handleRecursionLimit(statusBuilder, eventsProcessed, sideEffects.pendingPublishPromises, sideEffects.pendingWritebackPromises);
+        }
+        throw err;
+    }
+    finally {
+        clearInterval(heartbeatTimer);
+    }
+    await recorder?.flush();
+    if (eventsProcessed === 0) {
+        throw new Error("Stream completed without processing any events. " +
+            "This may indicate a configuration error or v3 API incompatibility.");
+    }
+    statusBuilder.syncSubAgentExecutions();
+    if (initialStatus.phase === ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL) {
+        console.log(`[streaming-v3] execution=${executionId} stream ended with WAITING_FOR_APPROVAL. ` +
+            `Not setting COMPLETED. pending_approvals computed server-side.`);
+        return {
+            eventsProcessed,
+            terminalStatus: slimStatus(initialStatus),
+            pendingPublishPromises: sideEffects.pendingPublishPromises,
+            pendingWritebackPromises: sideEffects.pendingWritebackPromises,
+        };
+    }
+    console.log(`[streaming-v3] execution=${executionId} stream finished — ` +
+        `processed ${eventsProcessed} events`);
+    const runOutput = await extractRunOutput(run, executionId);
+    return {
+        eventsProcessed,
+        runOutput,
+        pendingPublishPromises: sideEffects.pendingPublishPromises,
+        pendingWritebackPromises: sideEffects.pendingWritebackPromises,
+    };
+}
+// ── Run Output Extraction ────────────────────────────────────────────
+async function extractRunOutput(run, executionId) {
+    try {
+        const finalState = await Promise.race([
+            run.output,
+            timeoutPromise(RUN_OUTPUT_TIMEOUT_MS),
+        ]);
+        if (finalState === TIMEOUT_SENTINEL) {
+            console.warn(`[streaming-v3] execution=${executionId} — run.output did not resolve ` +
+                `within ${RUN_OUTPUT_TIMEOUT_MS}ms. Proceeding without final state.`);
+            return undefined;
+        }
+        const output = finalState;
+        console.log(`[streaming-v3] execution=${executionId} — run.output resolved. ` +
+            `Keys: [${Object.keys(output ?? {}).join(", ")}]. ` +
+            `hasStructuredResponse=${output?.structuredResponse !== undefined}`);
+        return output;
+    }
+    catch (err) {
+        console.warn(`[streaming-v3] execution=${executionId} — run.output rejected: ${err}`);
+        return undefined;
+    }
+}
+const TIMEOUT_SENTINEL = Symbol("timeout");
+function timeoutPromise(ms) {
+    return new Promise((resolve) => setTimeout(() => resolve(TIMEOUT_SENTINEL), ms));
+}
+// ── Helpers ──────────────────────────────────────────────────────────
+function sendHeartbeat(fn, executionId, eventsProcessed, sb) {
+    if (!fn)
+        return;
+    try {
+        fn({
+            executionId,
+            eventsProcessed,
+            messages: sb.currentStatus.messages.length,
+            phase: sb.currentStatus.phase,
+        });
+    }
+    catch { /* swallow */ }
+}
+function checkStallTimeout(lastActivityAt, stallTimeoutMs, executionId) {
+    const elapsed = performance.now() - lastActivityAt;
+    if (elapsed > stallTimeoutMs) {
+        throw new StallTimeoutError(`Agent stream stalled: no events received for ${Math.round(elapsed / 1000)}s ` +
+            `for execution ${executionId}`);
+    }
+}
+//# sourceMappingURL=streaming-v3.js.map

package/dist/activities/execute-deep-agent/streaming-v3.js.map

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

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

@@ -0,0 +1,66 @@
+/**
+ * Streaming execution loop for ExecuteDeepAgent.
+ *
+ * Replaces the Phase 3a invoke() approach with streamEvents() v2
+ * consumption. Feeds events to the StatusBuilder, persists status
+ * via the scheduler + retry executor, handles terminal conditions
+ * (STOP signal, stall, recursion limit, cancellation).
+ *
+ * Phase 3b-iii: inline artifact publish and incremental git writeback
+ * on file-modifying tool completions (write, edit, create).
+ */
+import type { AgentExecutionStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { type StreamEvent, type ApprovalPolicyProvider } from "./status-builder.js";
+import { type StreamingConfig } from "./streaming-scheduler.js";
+import { type RetryOptions } from "../../shared/grpc-retry.js";
+import type { StigmerClient } from "../../client/stigmer-client.js";
+import type { GracefulStopMiddleware } from "../../middleware/index.js";
+import type { InlinePublisher } from "./inline-publisher.js";
+import type { WriteBackCoordinator } from "./writeback-coordinator.js";
+export interface StreamDependencies {
+    readonly agentGraph: {
+        streamEvents(input: Record<string, unknown>, config: Record<string, unknown>, options: {
+            version: string;
+        }): AsyncIterable<StreamEvent>;
+    };
+    readonly langgraphInput: Record<string, unknown>;
+    readonly langgraphConfig: Record<string, unknown>;
+    readonly executionId: string;
+    readonly client: StigmerClient;
+    readonly initialStatus: AgentExecutionStatus;
+    readonly streamingConfig?: StreamingConfig;
+    readonly retryOptions?: RetryOptions;
+    readonly stallTimeoutMs?: number;
+    /** Temporal heartbeat. Injected so the loop is testable without Temporal. */
+    readonly heartbeatFn?: (details: Record<string, unknown>) => void;
+    /** Temporal cancellation check. */
+    readonly isCancelledFn?: () => boolean;
+    /** GracefulStopMiddleware instance for platform STOP signal handling. */
+    readonly gracefulStop?: GracefulStopMiddleware;
+    /** Inline artifact publisher for file-modifying tool completions. */
+    readonly inlinePublisher?: InlinePublisher;
+    /** Incremental git write-back coordinator. */
+    readonly writebackCoordinator?: WriteBackCoordinator;
+    /** Approval policy provider for StatusBuilder tool-call phase tracking. */
+    readonly approvalProvider?: ApprovalPolicyProvider;
+    /** Streaming protocol version. Defaults to "v2" if unset. */
+    readonly streamVersion?: "v2" | "v3";
+}
+export interface StreamResult {
+    readonly eventsProcessed: number;
+    readonly terminalStatus?: unknown;
+    readonly pendingPublishPromises: readonly Promise<void>[];
+    readonly pendingWritebackPromises: readonly Promise<void>[];
+    /** v3 only: the final state from run.output (includes structuredResponse if present). */
+    readonly runOutput?: Record<string, unknown>;
+}
+/**
+ * Run the streaming loop: consume streamEvents, map to proto via
+ * StatusBuilder, persist on schedule, and handle terminal conditions.
+ *
+ * Routes to v3 when deps.streamVersion === "v3".
+ */
+export declare function streamExecution(deps: StreamDependencies): Promise<StreamResult>;
+export declare class StallTimeoutError extends Error {
+    constructor(message: string);
+}