@stigmer/cli 3.0.8

package/resources/stream/subagent.d.ts

@@ -0,0 +1,12 @@
+import type { SubAgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/subagent_pb";
+import type { StreamEvent } from "./events.js";
+/**
+ * Tracks every sub-agent across snapshots, emitting started/message/tool/
+ * completed events. Holds one cursor per sub-agent ID, persisting across calls.
+ */
+export declare class SubAgentTracking {
+    private readonly cursors;
+    /** Process all sub-agent executions in a snapshot. Mirrors Go's emitSubAgentEvents. */
+    emit(subAgents: readonly SubAgentExecution[]): StreamEvent[];
+}
+//# sourceMappingURL=subagent.d.ts.map

package/resources/stream/subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/subagent.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kEAAkE,CAAC;AAO1G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW/C;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAE7D,uFAAuF;IACvF,IAAI,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,GAAG,WAAW,EAAE;CA+B7D"}

package/resources/stream/subagent.js

@@ -0,0 +1,76 @@
+// Sub-agent activity tracking for the snapshot differ.
+//
+// Ports the Go CLI's run_stream_subagent.go. Each sub-agent execution has its
+// own message cursor and tool-state tracker (its data arrays grow independently
+// of the top-level status), so this module keeps a per-sub-agent tracker keyed
+// by sub-agent ID and emits started/message/tool/completed events with the
+// sub-agent ID set for nested rendering.
+import { MessageType } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { collectToolCallsFromMessages, isTerminalSubAgentStatus, subAgentStatusName, } from "./convert.js";
+import { ToolStateTracker } from "./tool-state.js";
+/**
+ * Tracks every sub-agent across snapshots, emitting started/message/tool/
+ * completed events. Holds one cursor per sub-agent ID, persisting across calls.
+ */
+export class SubAgentTracking {
+    cursors = new Map();
+    /** Process all sub-agent executions in a snapshot. Mirrors Go's emitSubAgentEvents. */
+    emit(subAgents) {
+        const out = [];
+        for (const sa of subAgents) {
+            if (sa.id === "")
+                continue;
+            let cursor = this.cursors.get(sa.id);
+            if (cursor === undefined) {
+                cursor = { displayedMsgCount: 0, inStream: false, tools: new ToolStateTracker(), completed: false };
+                this.cursors.set(sa.id, cursor);
+                out.push({ kind: "subAgentStarted", id: sa.id, name: sa.name, description: sa.subject, input: sa.input });
+            }
+            const toolEvents = cursor.tools.track(collectToolCallsFromMessages(sa.messages), sa.id);
+            emitSubAgentMessages(out, sa.id, sa.messages, cursor);
+            out.push(...toolEvents);
+            if (!cursor.completed && isTerminalSubAgentStatus(sa.status)) {
+                cursor.completed = true;
+                out.push({
+                    kind: "subAgentCompleted",
+                    id: sa.id,
+                    status: subAgentStatusName(sa.status),
+                    toolCount: collectToolCallsFromMessages(sa.messages).length,
+                    output: sa.output,
+                });
+            }
+        }
+        return out;
+    }
+}
+// Emit new sub-agent messages, streaming AI messages incrementally. Tool results
+// are owned by the tool-state tracker, so MESSAGE_TOOL entries are skipped, and
+// AI tool-call lists are omitted to avoid duplicating the stateful tool blocks.
+// Mirrors Go's emitSubAgentMessageEvents.
+function emitSubAgentMessages(out, subAgentId, messages, cursor) {
+    // Phase 1: an in-progress streaming AI message.
+    if (cursor.inStream && cursor.displayedMsgCount < messages.length) {
+        const msg = messages[cursor.displayedMsgCount];
+        if (msg.isStreaming) {
+            out.push({ kind: "aiStreamDelta", content: msg.content, subAgentId });
+            return;
+        }
+        out.push({ kind: "aiStreamEnd", content: msg.content, toolCalls: [], subAgentId });
+        cursor.displayedMsgCount++;
+        cursor.inStream = false;
+    }
+    // Phase 2: complete messages, detecting a new streaming start.
+    while (cursor.displayedMsgCount < messages.length) {
+        const msg = messages[cursor.displayedMsgCount];
+        if (msg.isStreaming && msg.type === MessageType.MESSAGE_AI) {
+            out.push({ kind: "aiStreamStart", content: msg.content, subAgentId });
+            cursor.inStream = true;
+            return;
+        }
+        if (msg.type === MessageType.MESSAGE_AI && msg.content !== "") {
+            out.push({ kind: "aiMessage", content: msg.content, toolCalls: [], subAgentId });
+        }
+        cursor.displayedMsgCount++;
+    }
+}
+//# sourceMappingURL=subagent.js.map

package/resources/stream/subagent.js.map

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

package/resources/stream/submit.d.ts

@@ -0,0 +1,20 @@
+export declare const APPROVAL_RETRY_MAX_ATTEMPTS = 3;
+export declare const APPROVAL_RETRY_BASE_DELAY_MS = 1000;
+/**
+ * Retry `fn` up to `maxAttempts` times with doubling backoff, stopping early on
+ * success, a non-retryable error, or abort. Mirrors Go's retryWithBackoff. The
+ * delay between attempts is abort-aware. Rejects with the last error on failure.
+ */
+export declare function retryWithBackoff(signal: AbortSignal, maxAttempts: number, baseDelayMs: number, fn: () => Promise<void>): Promise<void>;
+/**
+ * True when an approval-submit error is transient and worth retrying. Mirrors
+ * Go's isRetryableSubmitError, including the "no pending approvals" special
+ * case. Non-RPC errors default to retryable (typically transient I/O).
+ */
+export declare function isRetryableSubmitError(err: unknown): boolean;
+/**
+ * Translate a dropped Subscribe stream error into a user-facing message with a
+ * resume hint. Mirrors Go's classifyStreamError.
+ */
+export declare function classifyStreamError(err: unknown, sessionId: string): string;
+//# sourceMappingURL=submit.d.ts.map

package/resources/stream/submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/submit.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAIjD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACtB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuB3E"}

package/resources/stream/submit.js

@@ -0,0 +1,125 @@
+// Approval-submission resilience for the headless stream driver.
+//
+// Ports the retry/backoff machinery from Go's run_stream_events.go:21-191:
+// approval submits race a transient DB-consistency window ("no pending
+// approvals") and ordinary network blips, so they retry with exponential
+// backoff. Also ports classifyStreamError (:53-82) — the user-facing message
+// for a dropped Subscribe stream, with a resume hint.
+import { Code, ConnectError } from "@connectrpc/connect";
+import { StigmerError } from "@stigmer/sdk";
+export const APPROVAL_RETRY_MAX_ATTEMPTS = 3;
+export const APPROVAL_RETRY_BASE_DELAY_MS = 1000;
+const MAX_CHAIN_DEPTH = 20;
+/**
+ * Retry `fn` up to `maxAttempts` times with doubling backoff, stopping early on
+ * success, a non-retryable error, or abort. Mirrors Go's retryWithBackoff. The
+ * delay between attempts is abort-aware. Rejects with the last error on failure.
+ */
+export async function retryWithBackoff(signal, maxAttempts, baseDelayMs, fn) {
+    let lastErr;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        if (signal.aborted)
+            throw new DOMException("Aborted", "AbortError");
+        try {
+            await fn();
+            return;
+        }
+        catch (err) {
+            lastErr = err;
+            if (!isRetryableSubmitError(err))
+                throw err;
+            if (attempt < maxAttempts - 1) {
+                await abortableDelay(baseDelayMs * 2 ** attempt, signal);
+            }
+        }
+    }
+    throw lastErr;
+}
+/**
+ * True when an approval-submit error is transient and worth retrying. Mirrors
+ * Go's isRetryableSubmitError, including the "no pending approvals" special
+ * case. Non-RPC errors default to retryable (typically transient I/O).
+ */
+export function isRetryableSubmitError(err) {
+    const coded = extractCoded(err);
+    if (coded === undefined)
+        return true;
+    switch (coded.code) {
+        case Code.Unavailable:
+        case Code.DeadlineExceeded:
+        case Code.ResourceExhausted:
+        case Code.Aborted:
+        case Code.Internal:
+        case Code.Unknown:
+            return true;
+        case Code.FailedPrecondition:
+            return coded.message.includes("no pending approvals");
+        default:
+            return false;
+    }
+}
+/**
+ * Translate a dropped Subscribe stream error into a user-facing message with a
+ * resume hint. Mirrors Go's classifyStreamError.
+ */
+export function classifyStreamError(err, sessionId) {
+    let message;
+    const coded = extractCoded(err);
+    if (coded === undefined) {
+        message = `Unexpected stream error: ${messageOf(err)}`;
+    }
+    else {
+        switch (coded.code) {
+            case Code.Unavailable:
+                message = "Connection to server lost.";
+                break;
+            case Code.Canceled:
+                message = "Server cancelled the stream.";
+                break;
+            case Code.DeadlineExceeded:
+                message = "Server response timed out.";
+                break;
+            default:
+                message = `Stream error (${Code[coded.code] ?? "Unknown"}): ${coded.message}`;
+        }
+    }
+    if (sessionId !== "")
+        message += `\nRe-attach to this session: stigmer resume ${sessionId}`;
+    return message;
+}
+// Walk the cause chain for the first SDK/Connect coded error. Mirrors the
+// Unwrap walk in errors/classify.ts.
+function extractCoded(err) {
+    let depth = 0;
+    for (let current = err; current != null && depth < MAX_CHAIN_DEPTH; current = causeOf(current), depth++) {
+        if (current instanceof StigmerError)
+            return { code: current.connectCode, message: current.message };
+        if (current instanceof ConnectError)
+            return { code: current.code, message: current.rawMessage };
+    }
+    return undefined;
+}
+function causeOf(value) {
+    return value !== null && typeof value === "object" ? value.cause : undefined;
+}
+function messageOf(value) {
+    if (value instanceof Error)
+        return value.message;
+    if (typeof value === "string")
+        return value;
+    return String(value);
+}
+function abortableDelay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new DOMException("Aborted", "AbortError"));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=submit.js.map

package/resources/stream/submit.js.map

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

package/resources/stream/todo.d.ts

@@ -0,0 +1,11 @@
+import type { TodoItem } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/todo_pb";
+import type { StreamEvent } from "./events.js";
+/** Stateful todo differ: holds the last fingerprint snapshot across calls. */
+export declare class TodoDiffer {
+    private prev;
+    /** True once any todo has been recorded, until the list is emptied. Mirrors Go's `len(prevTodos) > 0` guard. */
+    get hasPrev(): boolean;
+    /** Diff the current todo map and return a TodoUpdateEvent when it changed. */
+    diff(todos: Record<string, TodoItem>): StreamEvent[];
+}
+//# sourceMappingURL=todo.d.ts.map

package/resources/stream/todo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/todo.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8DAA8D,CAAC;AAE7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,8EAA8E;AAC9E,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAkC;IAE9C,gHAAgH;IAChH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,8EAA8E;IAC9E,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,WAAW,EAAE;CAMrD"}

package/resources/stream/todo.js

@@ -0,0 +1,44 @@
+// Todo-list change detection for the snapshot differ.
+//
+// Ports the Go CLI's emitTodoEvents + fingerprint helpers
+// (run_stream_events.go:786-847). Each snapshot carries the full todo map; this
+// differ compares a lightweight {content,status} fingerprint per item and emits
+// a single TodoUpdateEvent (with the full list) whenever anything is added,
+// removed, or changed.
+import { convertProtoTodos, mapTodoStatus } from "./convert.js";
+/** Stateful todo differ: holds the last fingerprint snapshot across calls. */
+export class TodoDiffer {
+    prev = new Map();
+    /** True once any todo has been recorded, until the list is emptied. Mirrors Go's `len(prevTodos) > 0` guard. */
+    get hasPrev() {
+        return this.prev.size > 0;
+    }
+    /** Diff the current todo map and return a TodoUpdateEvent when it changed. */
+    diff(todos) {
+        const current = buildFingerprints(todos);
+        if (!changed(this.prev, current))
+            return [];
+        this.prev = current;
+        return [{ kind: "todoUpdate", todos: convertProtoTodos(todos) }];
+    }
+}
+function buildFingerprints(todos) {
+    const fp = new Map();
+    for (const [id, item] of Object.entries(todos)) {
+        fp.set(id, { content: item.content, status: mapTodoStatus(item.status) });
+    }
+    return fp;
+}
+// True if the maps differ in size or any key's value. Detects add/remove/edit.
+// Mirrors Go's todoFingerprintsChanged.
+function changed(prev, current) {
+    if (prev.size !== current.size)
+        return true;
+    for (const [k, v] of current) {
+        const p = prev.get(k);
+        if (p === undefined || p.content !== v.content || p.status !== v.status)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=todo.js.map

package/resources/stream/todo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.js","sourceRoot":"","sources":["../../../src/resources/stream/todo.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,0DAA0D;AAC1D,gFAAgF;AAChF,gFAAgF;AAChF,4EAA4E;AAC5E,uBAAuB;AAGvB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQhE,8EAA8E;AAC9E,MAAM,OAAO,UAAU;IACb,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE9C,gHAAgH;IAChH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,8EAA8E;IAC9E,IAAI,CAAC,KAA+B;QAClC,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,KAA+B;IACxD,MAAM,EAAE,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1C,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,+EAA+E;AAC/E,wCAAwC;AACxC,SAAS,OAAO,CAAC,IAA8B,EAAE,OAAiC;IAChF,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/resources/stream/tool-state.d.ts

@@ -0,0 +1,31 @@
+import type { ToolCall } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import type { StreamEvent } from "./events.js";
+/**
+ * Stateful tracker that converts successive tool-call snapshots into discrete
+ * lifecycle events. The state (last status + last streamed result per tool ID)
+ * persists across calls, so only genuine transitions produce events.
+ */
+export declare class ToolStateTracker {
+    private readonly states;
+    private readonly results;
+    /**
+     * Diff `toolCalls` against tracked state and return the resulting events.
+     * `subAgentId` scopes the events for nested rendering ("" for top-level).
+     * Mirrors Go's trackToolCallStates branch-for-branch.
+     */
+    track(toolCalls: readonly ToolCall[], subAgentId: string): StreamEvent[];
+    /**
+     * True if `id` has a tracked state, i.e. a stateful block already exists for
+     * it. Used to suppress a duplicate ToolResultEvent for a MESSAGE_TOOL the
+     * tracker already owns. Mirrors the membership check in Go's isTrackedToolMessage.
+     */
+    has(id: string): boolean;
+    private running;
+    private waiting;
+    private completed;
+}
+/** The tool-call ID carried by a tool-lifecycle event, or "" otherwise. Mirrors Go's toolEventID. */
+export declare function toolEventId(event: StreamEvent): string;
+/** Index tool events by tool-call ID for chronological interleaving. Mirrors Go's buildToolEventMap. */
+export declare function buildToolEventMap(events: readonly StreamEvent[]): Map<string, StreamEvent>;
+//# sourceMappingURL=tool-state.d.ts.map

package/resources/stream/tool-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-state.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/tool-state.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iEAAiE,CAAC;AAEhG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE;IAqExE;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;CAGlB;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAUtD;AAED,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAO1F"}

package/resources/stream/tool-state.js

@@ -0,0 +1,126 @@
+// Tool-call state-transition tracking for the snapshot differ.
+//
+// Ports the Go CLI's trackToolCallStates (run_stream_events.go:597-695). Each
+// snapshot carries the full tool-call list; this tracker diffs it against the
+// last-known per-tool status/result to emit only the *transitions* (running,
+// completed, waiting-approval, streaming delta). One tracker instance per scope:
+// the top-level execution gets one, each sub-agent gets its own (matching Go's
+// per-sub-agent tracker maps).
+import { convertToolCall, isTerminalToolStatus, mapToolCallStatus } from "./convert.js";
+/**
+ * Stateful tracker that converts successive tool-call snapshots into discrete
+ * lifecycle events. The state (last status + last streamed result per tool ID)
+ * persists across calls, so only genuine transitions produce events.
+ */
+export class ToolStateTracker {
+    // toolCallID -> last known status string.
+    states = new Map();
+    // toolCallID -> last known result content, for streaming-delta detection.
+    results = new Map();
+    /**
+     * Diff `toolCalls` against tracked state and return the resulting events.
+     * `subAgentId` scopes the events for nested rendering ("" for top-level).
+     * Mirrors Go's trackToolCallStates branch-for-branch.
+     */
+    track(toolCalls, subAgentId) {
+        const pending = [];
+        for (const tc of toolCalls) {
+            if (tc.id === "")
+                continue;
+            const current = mapToolCallStatus(tc.status);
+            const seen = this.states.has(tc.id);
+            const prev = this.states.get(tc.id);
+            // First sight, already running: open a running block.
+            if (!seen && current === "running") {
+                pending.push(this.running(tc, subAgentId));
+                this.states.set(tc.id, current);
+                this.results.set(tc.id, tc.result);
+                continue;
+            }
+            // First sight, awaiting approval: open a waiting block.
+            if (!seen && current === "waiting_approval") {
+                pending.push(this.waiting(tc, subAgentId));
+                this.states.set(tc.id, current);
+                continue;
+            }
+            // First sight, already terminal (e.g. re-attach): synthesize completion so
+            // the block exists — otherwise its MESSAGE_TOOL is suppressed and it vanishes.
+            if (!seen && isTerminalToolStatus(current)) {
+                pending.push(this.completed(tc, subAgentId));
+                this.states.set(tc.id, current);
+                continue;
+            }
+            // running/waiting -> terminal: close the block.
+            if (seen && (prev === "running" || prev === "waiting_approval") && isTerminalToolStatus(current)) {
+                pending.push(this.completed(tc, subAgentId));
+                this.states.set(tc.id, current);
+                this.results.delete(tc.id);
+                continue;
+            }
+            // Any other status change: open running/waiting as appropriate.
+            if (current !== prev) {
+                if (current === "running") {
+                    pending.push(this.running(tc, subAgentId));
+                    this.results.set(tc.id, tc.result);
+                }
+                else if (current === "waiting_approval") {
+                    pending.push(this.waiting(tc, subAgentId));
+                }
+                this.states.set(tc.id, current);
+                continue;
+            }
+            // Streaming content changed on a running tool: emit a delta.
+            if (current === "running" && tc.isStreaming && tc.result !== this.results.get(tc.id)) {
+                pending.push({
+                    kind: "toolStreamDelta",
+                    toolCallId: tc.id,
+                    toolCall: convertToolCall(tc),
+                    content: tc.result,
+                    subAgentId,
+                });
+                this.results.set(tc.id, tc.result);
+            }
+        }
+        return pending;
+    }
+    /**
+     * True if `id` has a tracked state, i.e. a stateful block already exists for
+     * it. Used to suppress a duplicate ToolResultEvent for a MESSAGE_TOOL the
+     * tracker already owns. Mirrors the membership check in Go's isTrackedToolMessage.
+     */
+    has(id) {
+        return this.states.has(id);
+    }
+    running(tc, subAgentId) {
+        return { kind: "toolRunning", toolCallId: tc.id, toolCall: convertToolCall(tc), subAgentId };
+    }
+    waiting(tc, subAgentId) {
+        return { kind: "toolWaitingApproval", toolCallId: tc.id, toolCall: convertToolCall(tc), subAgentId };
+    }
+    completed(tc, subAgentId) {
+        return { kind: "toolCompleted", toolCallId: tc.id, toolCall: convertToolCall(tc), subAgentId };
+    }
+}
+/** The tool-call ID carried by a tool-lifecycle event, or "" otherwise. Mirrors Go's toolEventID. */
+export function toolEventId(event) {
+    switch (event.kind) {
+        case "toolRunning":
+        case "toolCompleted":
+        case "toolWaitingApproval":
+        case "toolStreamDelta":
+            return event.toolCallId;
+        default:
+            return "";
+    }
+}
+/** Index tool events by tool-call ID for chronological interleaving. Mirrors Go's buildToolEventMap. */
+export function buildToolEventMap(events) {
+    const m = new Map();
+    for (const ev of events) {
+        const id = toolEventId(ev);
+        if (id !== "")
+            m.set(id, ev);
+    }
+    return m;
+}
+//# sourceMappingURL=tool-state.js.map

package/resources/stream/tool-state.js.map

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

package/resources/stream/tty.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Whether the terminal can host the interactive Ink renderer: stdout must be a
+ * TTY and TERM must not be "dumb". When false, the command uses plaintext.
+ */
+export declare function isInkSupported(stream?: {
+    isTTY?: boolean;
+}): boolean;
+//# sourceMappingURL=tty.d.ts.map

package/resources/stream/tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/tty.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAmB,GAAG,OAAO,CAGpF"}

package/resources/stream/tty.js

@@ -0,0 +1,15 @@
+// Terminal-capability gate for renderer selection.
+//
+// Deliberately free of any React/Ink imports so the command can decide whether
+// to take the interactive path *before* paying the dynamic-import cost of
+// ink.tsx (DD-001 lazy boundary). Mirrors Go's termctl.IsSupported.
+/**
+ * Whether the terminal can host the interactive Ink renderer: stdout must be a
+ * TTY and TERM must not be "dumb". When false, the command uses plaintext.
+ */
+export function isInkSupported(stream = process.stdout) {
+    if (stream.isTTY !== true)
+        return false;
+    return process.env.TERM !== "dumb";
+}
+//# sourceMappingURL=tty.js.map

package/resources/stream/tty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.js","sourceRoot":"","sources":["../../../src/resources/stream/tty.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,oEAAoE;AAEpE;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAA8B,OAAO,CAAC,MAAM;IACzE,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AACrC,CAAC"}

package/resources/stream/workflow-event-view.d.ts

@@ -0,0 +1,21 @@
+import { type WorkflowExecutionEvent, WorkflowEventType } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/event_pb";
+/** Color intent for an event line; the renderer maps this to ANSI (or nothing). */
+export type EventTone = "success" | "error" | "warning" | "info" | "muted";
+/** A renderer-agnostic view of one workflow event. */
+export interface WorkflowEventView {
+    /** HH:MM:SS slice of occurred_at, or "--------" when absent. */
+    readonly time: string;
+    /** Leading glyph (▶ ✓ ✗ → …); empty for the generic fallback line. */
+    readonly glyph: string;
+    /** Tone applied to the glyph. */
+    readonly tone: EventTone;
+    /** Human sentence describing the event. */
+    readonly text: string;
+    /** True when this event marks a terminal execution phase. */
+    readonly terminal: boolean;
+}
+/** Canonical WorkflowEventType name (e.g. "execution_started") for NDJSON `type`. */
+export declare function workflowEventTypeName(type: WorkflowEventType): string;
+/** Map a workflow event to its display view. Switches on the typed oneof payload. */
+export declare function toWorkflowEventView(event: WorkflowExecutionEvent): WorkflowEventView;
+//# sourceMappingURL=workflow-event-view.d.ts.map

package/resources/stream/workflow-event-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-event-view.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/workflow-event-view.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,KAAK,sBAAsB,EAC3B,iBAAiB,EAClB,MAAM,kEAAkE,CAAC;AAE1E,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3E,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAErE;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAwDpF"}