@stigmer/runner 3.0.1

package/dist/activities/execute-deep-agent/v3-status-builder.js

@@ -0,0 +1,394 @@
+/**
+ * V3StatusBuilder — consumes StigmerRunEvents from the V3ProtocolNormalizer
+ * and progressively builds the AgentExecutionStatus proto.
+ *
+ * Implements the same behavioral contract as the v2 StatusBuilder for all
+ * 8 golden scenarios, using v3 event semantics (tool_call_id keying,
+ * content-block-level deltas, explicit tool lifecycle).
+ *
+ * Usage is accumulated on message_finish only (standalone usage events are
+ * no-ops) to prevent double-counting — v3 emits both for the same turn.
+ */
+import { create } from "@bufbuild/protobuf";
+import { AgentMessageSchema, ToolCallSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { ExecutionPhase, MessageType, ToolCallStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { resolveApprovalMessage as resolveApprovalMsg } from "../../shared/approval-policy.js";
+import { classifyTool } from "../../shared/tool-kind.js";
+import { ExecutionState } from "./execution-state.js";
+import { utcTimestamp } from "../../shared/status.js";
+import { namespaceDepth } from "./v3-events.js";
+import { UsageAccumulator, extractToolResultV3, sanitizeArgsPreview, MAX_TOOL_RESULT_CHARS, } from "./status-builder-shared.js";
+import { SubAgentTracker } from "./subagent-tracker.js";
+export class V3StatusBuilder {
+    executionId;
+    state;
+    _forceNextUpdate = false;
+    approvalProvider = null;
+    usageAccumulator;
+    subAgentTracker;
+    /** Progressive tool call arg accumulation keyed by callId. */
+    toolArgBuffers = new Map();
+    constructor(executionId, initialStatus) {
+        this.executionId = executionId;
+        this.state = new ExecutionState(initialStatus);
+        initialStatus.phase = ExecutionPhase.EXECUTION_IN_PROGRESS;
+        if (!initialStatus.startedAt) {
+            initialStatus.startedAt = utcTimestamp();
+        }
+        this.usageAccumulator = new UsageAccumulator();
+        this.subAgentTracker = new SubAgentTracker();
+    }
+    setApprovalProvider(provider) {
+        this.approvalProvider = provider;
+    }
+    get currentStatus() {
+        return this.state.proto;
+    }
+    get forceNextUpdate() {
+        return this._forceNextUpdate;
+    }
+    clearForceFlag() {
+        this._forceNextUpdate = false;
+    }
+    processEvent(event) {
+        try {
+            // Sub-agent routing: detect "task" tool starts at depth 0 (root) or depth 1
+            // (inside LangGraph tools-node). In real runtime, task tool-started arrives
+            // at depth 1 with namespace like "tools:<pregelTaskUuid>".
+            if (event.kind === "tool_started" && event.name === "task" && namespaceDepth(event.namespace) <= 1) {
+                const routingPrefix = event.namespace || `tools:${event.callId}`;
+                this.subAgentTracker.onTaskToolStarted(event.callId, event.input, routingPrefix);
+                this.handleToolStarted(event.callId, event.name, event.input, event.namespace);
+                this._forceNextUpdate = true;
+                return;
+            }
+            if (event.kind === "tool_finished" && this.isTrackedTaskTool(event.callId)) {
+                this.subAgentTracker.onTaskToolFinished(event.callId, event.output);
+                this.handleToolFinished(event.callId, event.output);
+                this._forceNextUpdate = true;
+                return;
+            }
+            if (event.kind === "tool_error" && this.isTrackedTaskTool(event.callId)) {
+                this.subAgentTracker.onTaskToolError(event.callId, event.message);
+                this.handleToolError(event.callId, event.message);
+                this._forceNextUpdate = true;
+                return;
+            }
+            if (this.subAgentTracker.isSubAgentNamespace(event.namespace)) {
+                this.subAgentTracker.routeEvent(event);
+                return;
+            }
+            // Parent event routing (unchanged for non-sub-agent events)
+            switch (event.kind) {
+                case "message_start":
+                    this.handleMessageStart(event.runId, event.namespace);
+                    break;
+                case "text_delta":
+                    this.appendTextContent(event.runId, event.namespace, event.text);
+                    break;
+                case "reasoning_delta":
+                    this.appendThinkingContent(event.runId, event.namespace, event.text);
+                    break;
+                case "tool_call_arg_delta":
+                    this.handleToolCallArgDelta(event.callId, event.argsChunk);
+                    break;
+                case "message_finish":
+                    this.handleMessageFinish(event.runId, event.namespace, event.usage);
+                    break;
+                case "tool_started":
+                    this.handleToolStarted(event.callId, event.name, event.input, event.namespace);
+                    break;
+                case "tool_finished":
+                    this.handleToolFinished(event.callId, event.output);
+                    break;
+                case "tool_error":
+                    this.handleToolError(event.callId, event.message);
+                    break;
+                case "tool_output_delta":
+                    this.handleToolOutputDelta(event.callId, event.delta);
+                    break;
+                case "usage":
+                case "lifecycle":
+                case "provider":
+                    break;
+            }
+        }
+        catch (err) {
+            console.error(`[V3StatusBuilder] Event handler error: execution=${this.executionId} ` +
+                `kind=${event.kind} seq=${event.seq}: ${err}`);
+        }
+    }
+    // ── Artifact & WriteBack ───────────────────────────────────────────
+    addArtifact(artifact) {
+        const artifacts = this.state.proto.artifacts;
+        const idx = artifacts.findIndex(a => a.sandboxPath === artifact.sandboxPath);
+        if (idx >= 0) {
+            if (artifacts[idx].contentHash !== artifact.contentHash) {
+                artifacts[idx] = artifact;
+                this._forceNextUpdate = true;
+            }
+            return;
+        }
+        artifacts.push(artifact);
+        this._forceNextUpdate = true;
+    }
+    addWriteBack(wb) {
+        const backs = this.state.proto.workspaceWriteBacks;
+        const idx = backs.findIndex(b => b.workspaceEntryName === wb.workspaceEntryName);
+        if (idx >= 0) {
+            backs[idx] = wb;
+        }
+        else {
+            backs.push(wb);
+        }
+        this._forceNextUpdate = true;
+    }
+    // ── Message Handlers ───────────────────────────────────────────────
+    handleMessageStart(runId, namespace) {
+        // Record the runId for turn-boundary detection but do NOT create
+        // the AI message yet. The message is created lazily on the first
+        // text_delta, preserving the v2 ordering (THINKING before AI text
+        // when both appear in the same turn).
+        const lastRunId = this.state.lastLlmRunId.get(namespace);
+        if (lastRunId && lastRunId !== runId) {
+            const existingMsg = this.state.currentAiMessage.get(namespace);
+            if (existingMsg) {
+                existingMsg.isStreaming = false;
+            }
+        }
+        this.state.lastLlmRunId.set(namespace, runId);
+    }
+    handleMessageFinish(runId, _namespace, usage) {
+        const msg = this.state.messagesByRun.get(runId);
+        if (msg) {
+            msg.isStreaming = false;
+        }
+        if (usage) {
+            this.accumulateV3Usage(usage);
+        }
+    }
+    appendTextContent(runId, namespace, text) {
+        const msg = this.ensureAiMessage(runId, namespace, MessageType.MESSAGE_AI);
+        msg.content += text;
+        msg.isStreaming = true;
+    }
+    appendThinkingContent(runId, namespace, text) {
+        const thinkingKey = `thinking:${namespace}`;
+        const existingMsg = this.state.messagesByRun.get(thinkingKey);
+        if (existingMsg && existingMsg.type === MessageType.MESSAGE_THINKING) {
+            existingMsg.content += text;
+            existingMsg.isStreaming = true;
+            return;
+        }
+        const msg = create(AgentMessageSchema, {
+            type: MessageType.MESSAGE_THINKING,
+            content: text,
+            timestamp: utcTimestamp(),
+            isStreaming: true,
+        });
+        this.state.proto.messages.push(msg);
+        this.state.messagesByRun.set(thinkingKey, msg);
+    }
+    // ── Tool Handlers ──────────────────────────────────────────────────
+    handleToolStarted(callId, name, input, namespace) {
+        const agentNs = this.resolveAgentNamespace(namespace);
+        const parentMsg = this.state.currentAiMessage.get(agentNs)
+            ?? this.ensureAiMessageForToolCall(agentNs);
+        if (!parentMsg)
+            return;
+        const approvalReq = this.checkApprovalRequirement(name, input);
+        const tc = create(ToolCallSchema, {
+            id: callId,
+            name,
+            status: approvalReq.requiresApproval
+                ? ToolCallStatus.TOOL_CALL_WAITING_APPROVAL
+                : ToolCallStatus.TOOL_CALL_RUNNING,
+            startedAt: utcTimestamp(),
+        });
+        if (Object.keys(input).length > 0) {
+            tc.args = input;
+        }
+        if (approvalReq.serverSlug) {
+            tc.mcpServerSlug = approvalReq.serverSlug;
+        }
+        // Classify after mcpServerSlug is set so MCP tools resolve correctly.
+        tc.toolKind = classifyTool(tc.name, tc.mcpServerSlug);
+        if (approvalReq.requiresApproval) {
+            tc.requiresApproval = true;
+            tc.approvalMessage = approvalReq.message;
+            tc.approvalRequestedAt = utcTimestamp();
+            const argsPreview = sanitizeArgsPreview(input);
+            if (argsPreview) {
+                tc.argsPreview = argsPreview;
+            }
+            this.state.proto.phase = ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL;
+        }
+        parentMsg.toolCalls.push(tc);
+        this.state.toolCalls.set(callId, tc);
+        this.state.toolStartTimes.set(callId, performance.now());
+        this._forceNextUpdate = true;
+    }
+    handleToolFinished(callId, output) {
+        const tc = this.state.toolCalls.get(callId);
+        if (!tc)
+            return;
+        const result = extractToolResultV3(output);
+        tc.status = ToolCallStatus.TOOL_CALL_COMPLETED;
+        tc.result = result.length > MAX_TOOL_RESULT_CHARS
+            ? result.slice(0, MAX_TOOL_RESULT_CHARS) + `\n[truncated: ${result.length} chars total]`
+            : result;
+        tc.completedAt = utcTimestamp();
+        tc.isStreaming = false;
+        this.state.toolStartTimes.delete(callId);
+        this.toolArgBuffers.delete(callId);
+        this._forceNextUpdate = true;
+    }
+    handleToolError(callId, message) {
+        const tc = this.state.toolCalls.get(callId);
+        if (!tc)
+            return;
+        tc.status = ToolCallStatus.TOOL_CALL_FAILED;
+        tc.error = message;
+        tc.completedAt = utcTimestamp();
+        tc.isStreaming = false;
+        this.state.toolStartTimes.delete(callId);
+        this.toolArgBuffers.delete(callId);
+        this._forceNextUpdate = true;
+    }
+    handleToolCallArgDelta(callId, argsChunk) {
+        const tc = this.state.toolCalls.get(callId);
+        if (!tc)
+            return;
+        const buffer = (this.toolArgBuffers.get(callId) ?? "") + argsChunk;
+        this.toolArgBuffers.set(callId, buffer);
+        try {
+            tc.args = JSON.parse(buffer);
+        }
+        catch {
+            // Partial JSON — will parse on next chunk or tool-finished
+        }
+    }
+    handleToolOutputDelta(callId, delta) {
+        const tc = this.state.toolCalls.get(callId);
+        if (!tc)
+            return;
+        tc.result = (tc.result ?? "") + delta;
+    }
+    // ── Namespace Resolution ────────────────────────────────────────
+    /**
+     * v3 tool events carry namespace like "tools:toolu_abc" or
+     * "subagent:worker-1|tools:toolu_abc". Strip tools:* segments
+     * to get the agent namespace for AI message lookup.
+     */
+    resolveAgentNamespace(ns) {
+        if (!ns)
+            return "";
+        const parts = ns.split("|").filter(p => !p.startsWith("tools:"));
+        return parts.join("|");
+    }
+    // ── Approval ──────────────────────────────────────────────────────
+    checkApprovalRequirement(toolName, args) {
+        if (!this.approvalProvider) {
+            return { requiresApproval: false, message: "", serverSlug: "" };
+        }
+        const serverSlug = this.approvalProvider.toolServerMap.get(toolName) ?? "";
+        if (this.approvalProvider.autoApproveAll) {
+            return { requiresApproval: false, message: "", serverSlug };
+        }
+        if (serverSlug) {
+            const key = `${serverSlug}/${toolName}`;
+            const policy = this.approvalProvider.policies.get(key);
+            if (policy?.requiresApproval) {
+                return {
+                    requiresApproval: true,
+                    message: resolveApprovalMsg(policy.approvalMessage, toolName, args),
+                    serverSlug,
+                };
+            }
+            return { requiresApproval: false, message: "", serverSlug };
+        }
+        return { requiresApproval: false, message: "", serverSlug: "" };
+    }
+    // ── Content Helpers ───────────────────────────────────────────────
+    ensureAiMessage(runId, namespace, type) {
+        const existingByRun = this.state.messagesByRun.get(runId);
+        if (existingByRun)
+            return existingByRun;
+        const lastRunId = this.state.lastLlmRunId.get(namespace);
+        if (lastRunId && lastRunId !== runId) {
+            const existingMsg = this.state.currentAiMessage.get(namespace);
+            if (existingMsg) {
+                existingMsg.isStreaming = false;
+            }
+        }
+        const msg = create(AgentMessageSchema, {
+            type,
+            content: "",
+            timestamp: utcTimestamp(),
+            isStreaming: true,
+        });
+        this.state.proto.messages.push(msg);
+        this.state.messagesByRun.set(runId, msg);
+        this.state.currentAiMessage.set(namespace, msg);
+        this.state.lastLlmRunId.set(namespace, runId);
+        return msg;
+    }
+    ensureAiMessageForToolCall(namespace) {
+        const lastRunId = this.state.lastLlmRunId.get(namespace);
+        if (lastRunId) {
+            const existing = this.state.messagesByRun.get(lastRunId);
+            if (existing) {
+                this.state.currentAiMessage.set(namespace, existing);
+                return existing;
+            }
+        }
+        const msg = create(AgentMessageSchema, {
+            type: MessageType.MESSAGE_AI,
+            content: "",
+            timestamp: utcTimestamp(),
+            isStreaming: false,
+        });
+        this.state.proto.messages.push(msg);
+        this.state.currentAiMessage.set(namespace, msg);
+        return msg;
+    }
+    // ── Usage ──────────────────────────────────────────────────────────
+    accumulateV3Usage(usage) {
+        const meta = {
+            input_tokens: usage.input_tokens,
+            output_tokens: usage.output_tokens,
+        };
+        if (usage.input_token_details) {
+            meta.cache_read_input_tokens = usage.input_token_details.cache_read;
+            meta.cache_creation_input_tokens = usage.input_token_details.cache_creation;
+        }
+        this.usageAccumulator.accumulate(meta);
+        this.state.proto.streamingUsage = this.usageAccumulator.toProto();
+    }
+    // ── Sub-Agent Integration ──────────────────────────────────────────
+    /**
+     * Check if a tool_call_id belongs to a tracked "task" tool invocation.
+     * Used to route tool_finished/tool_error events to both parent and tracker.
+     */
+    isTrackedTaskTool(callId) {
+        const tc = this.state.toolCalls.get(callId);
+        return tc?.name === "task";
+    }
+    /**
+     * Sync sub-agent executions into the proto for persistence.
+     * Called by the streaming orchestrator before each persist.
+     */
+    syncSubAgentExecutions() {
+        if (this.subAgentTracker.hasExecutions()) {
+            this.state.proto.subAgentExecutions = this.subAgentTracker.getExecutions();
+        }
+    }
+    /**
+     * Cancel all in-progress sub-agents (called on parent cancellation).
+     */
+    cancelSubAgents() {
+        this.subAgentTracker.cancelAll();
+        this.syncSubAgentExecutions();
+    }
+}
+//# sourceMappingURL=v3-status-builder.js.map

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

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

package/dist/activities/execute-deep-agent/writeback-coordinator.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Incremental git write-back coordinator for workspace entries.
+ *
+ * During agent execution, each file-modifying tool call triggers an
+ * incremental commit-and-push cycle for the affected git workspace.
+ * The first cycle creates the branch and PR; subsequent cycles add
+ * commits to the same branch — the PR updates automatically on GitHub.
+ *
+ * DD-5: Incremental writeback, not batch.
+ *
+ * Lifecycle:
+ *   1. Created after workspace provisioning in index.ts.
+ *   2. `onFileModified(path)` called from streaming on each write/edit tool end.
+ *   3. `finalize()` called from post-stream as a safety net.
+ *
+ * Concurrency: one mutex per workspace entry serializes git operations.
+ */
+import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+import type { WorkspaceBackend, ProvisionResult } from "../../shared/workspace/types.js";
+import type { ExecutionStatusWriter } from "./execution-status-writer.js";
+export declare class WriteBackCoordinator {
+    private readonly statusWriter;
+    private readonly executionId;
+    private readonly workspaceBackend;
+    private readonly shortId;
+    private readonly branchName;
+    private readonly eligible;
+    private readonly state;
+    private readonly locks;
+    constructor(opts: {
+        statusWriter: ExecutionStatusWriter;
+        executionId: string;
+        provisionResults: readonly ProvisionResult[];
+        workspaceEntries: readonly WorkspaceEntry[];
+        workspaceBackend: WorkspaceBackend;
+    });
+    get hasEligibleEntries(): boolean;
+    /**
+     * Called after a file-modifying tool completes. Resolves the path to
+     * a workspace entry and runs an incremental commit/push cycle.
+     * Fire-and-forget: errors are logged, never thrown.
+     */
+    onFileModified(path: string): Promise<void>;
+    /**
+     * Post-execution safety net. Checks every eligible workspace entry
+     * for remaining uncommitted changes and commits/pushes them.
+     */
+    finalize(): Promise<void>;
+    private initEligibleEntries;
+    private resolveEntry;
+    private incrementalWriteBack;
+    private hasChanges;
+    private createBranch;
+    private commitAndPush;
+    private createPr;
+    private updateStatus;
+    private withLock;
+}
+/**
+ * Extract GitHub owner and repo from a clone URL.
+ * Supports HTTPS (with or without .git) and SSH formats.
+ */
+export declare function parseGithubRepo(repoUrl: string): {
+    owner: string;
+    repo: string;
+};
+/**
+ * Extract a GitHub token from an HTTPS clone URL that has credentials embedded.
+ * Format: https://{token}@github.com/...
+ */
+export declare function extractGithubToken(repoUrl: string): string;