@stigmer/cli 3.0.8

package/resources/stream/convert.js

@@ -0,0 +1,178 @@
+// Proto → domain converters for the snapshot differ.
+//
+// Ports the Go CLI's run_stream_convert.go + run_display_tools.go + the error
+// sanitizer in run_display.go. These are pure mappings from generated proto
+// types to the differ's render-agnostic event payloads (events.ts), keeping the
+// enum/string translation in exactly one place.
+import { ExecutionPhase, SubAgentStatus, SummarizationSource, ToolCallStatus, TodoStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/** Convert a proto ToolCall to render info. Mirrors Go's convertToolCall. */
+export function convertToolCall(tc) {
+    return {
+        id: tc.id,
+        name: tc.name,
+        status: mapToolCallStatus(tc.status),
+        args: tc.args,
+        result: tc.result,
+        error: tc.error,
+        durationMs: computeDurationMs(tc.startedAt, tc.completedAt),
+    };
+}
+/** Convert a slice of proto ToolCalls. Mirrors Go's convertToolCalls. */
+export function convertToolCalls(toolCalls) {
+    return toolCalls.map(convertToolCall);
+}
+/** Flatten every tool call embedded in a message list. Mirrors Go's collectToolCallsFromMessages. */
+export function collectToolCallsFromMessages(messages) {
+    const result = [];
+    for (const msg of messages)
+        result.push(...msg.toolCalls);
+    return result;
+}
+/** Find a tool call by ID, searching root then sub-agent messages. Mirrors Go's findToolCallByID. */
+export function findToolCallById(toolCalls, subAgents, id) {
+    for (const tc of toolCalls) {
+        if (tc.id === id)
+            return tc;
+    }
+    for (const sa of subAgents) {
+        for (const msg of sa.messages) {
+            for (const tc of msg.toolCalls) {
+                if (tc.id === id)
+                    return tc;
+            }
+        }
+    }
+    return undefined;
+}
+/** Convert the proto todo map to render items. Mirrors Go's convertProtoTodos. */
+export function convertProtoTodos(todos) {
+    return Object.values(todos).map((item) => ({
+        id: item.id,
+        content: item.content,
+        status: mapTodoStatus(item.status),
+    }));
+}
+/** Map an ExecutionPhase to its differ string. Mirrors Go's mapPhaseToString. */
+export function mapPhaseToString(phase) {
+    switch (phase) {
+        case ExecutionPhase.EXECUTION_PENDING:
+            return "pending";
+        case ExecutionPhase.EXECUTION_IN_PROGRESS:
+            return "in_progress";
+        case ExecutionPhase.EXECUTION_COMPLETED:
+            return "completed";
+        case ExecutionPhase.EXECUTION_FAILED:
+            return "failed";
+        case ExecutionPhase.EXECUTION_CANCELLED:
+            return "cancelled";
+        case ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL:
+            return "waiting_for_approval";
+        case ExecutionPhase.EXECUTION_TERMINATED:
+            return "terminated";
+        default:
+            return "unknown";
+    }
+}
+/** Map a ToolCallStatus to its differ string. Mirrors Go's mapToolCallStatus. */
+export function mapToolCallStatus(status) {
+    switch (status) {
+        case ToolCallStatus.TOOL_CALL_PENDING:
+            return "pending";
+        case ToolCallStatus.TOOL_CALL_RUNNING:
+            return "running";
+        case ToolCallStatus.TOOL_CALL_COMPLETED:
+            return "completed";
+        case ToolCallStatus.TOOL_CALL_FAILED:
+            return "failed";
+        case ToolCallStatus.TOOL_CALL_WAITING_APPROVAL:
+            return "waiting_approval";
+        case ToolCallStatus.TOOL_CALL_SKIPPED:
+            return "skipped";
+        default:
+            return "unknown";
+    }
+}
+/** Map a TodoStatus to its differ string (UNSPECIFIED→pending). Mirrors Go's mapTodoStatus. */
+export function mapTodoStatus(status) {
+    switch (status) {
+        case TodoStatus.TODO_PENDING:
+            return "pending";
+        case TodoStatus.TODO_IN_PROGRESS:
+            return "in_progress";
+        case TodoStatus.TODO_COMPLETED:
+            return "completed";
+        case TodoStatus.TODO_CANCELLED:
+            return "cancelled";
+        default:
+            return "pending";
+    }
+}
+/** Map a SummarizationSource to its differ string. Mirrors Go's mapSummarizationSource. */
+export function mapSummarizationSource(source) {
+    switch (source) {
+        case SummarizationSource.graph_start:
+            return "graph_start";
+        case SummarizationSource.mid_execution:
+            return "mid_execution";
+        default:
+            return "unknown";
+    }
+}
+/** The protojson enum name for a sub-agent status (matches Go's status.String()). */
+export function subAgentStatusName(status) {
+    return SubAgentStatus[status] ?? "SUB_AGENT_STATUS_UNSPECIFIED";
+}
+/** True for tool statuses that mean the tool is no longer executing. Mirrors Go's isTerminalToolStatus. */
+export function isTerminalToolStatus(status) {
+    return status === "completed" || status === "failed" || status === "skipped";
+}
+/** True for terminal agent phases. Mirrors Go's isTerminalAgentPhase. */
+export function isTerminalAgentPhase(phase) {
+    return (phase === ExecutionPhase.EXECUTION_COMPLETED ||
+        phase === ExecutionPhase.EXECUTION_FAILED ||
+        phase === ExecutionPhase.EXECUTION_CANCELLED ||
+        phase === ExecutionPhase.EXECUTION_TERMINATED);
+}
+/** True for terminal sub-agent statuses. Mirrors Go's isTerminalSubAgentStatus. */
+export function isTerminalSubAgentStatus(status) {
+    return (status === SubAgentStatus.SUB_AGENT_COMPLETED ||
+        status === SubAgentStatus.SUB_AGENT_FAILED ||
+        status === SubAgentStatus.SUB_AGENT_CANCELLED);
+}
+// Raw HTTP/API error response pattern that leaks internals. Mirrors Go's rawAPIErrorPattern.
+const RAW_API_ERROR = /Error code: \d+ - [{'"]/;
+const RAW_EXCEPTION_PATTERNS = ["invalid_request_error", "request_id", "'type': 'error'", '"type": "error"'];
+/** Rewrite raw API/exception errors into clean text. Mirrors Go's sanitizeSystemContent. */
+export function sanitizeSystemContent(content) {
+    if (!isRawErrorContent(content))
+        return content;
+    const idx = content.indexOf("Error code:");
+    if (idx > 0) {
+        const prefix = content.slice(0, idx).trim().replace(/[:\-\s]+$/, "");
+        if (prefix !== "")
+            return `${prefix} (internal error — check execution logs for details)`;
+    }
+    return "Agent execution encountered an internal error. Check execution logs for details.";
+}
+/** True when the system message looks like an approval-received acknowledgement. Mirrors Go's isApprovalNoiseMessage. */
+export function isApprovalNoiseMessage(content) {
+    return content.includes("Approval received");
+}
+function isRawErrorContent(content) {
+    if (RAW_API_ERROR.test(content))
+        return true;
+    return RAW_EXCEPTION_PATTERNS.some((p) => content.includes(p));
+}
+// Elapsed ms between two RFC3339 timestamps, or 0 when either is missing,
+// unparseable, or negative. Mirrors Go's computeToolCallDuration.
+function computeDurationMs(startedAt, completedAt) {
+    if (startedAt === "" || completedAt === "")
+        return 0;
+    const start = Date.parse(startedAt);
+    const end = Date.parse(completedAt);
+    if (Number.isNaN(start) || Number.isNaN(end))
+        return 0;
+    const d = end - start;
+    return d < 0 ? 0 : d;
+}
+//# sourceMappingURL=convert.js.map

package/resources/stream/convert.js.map

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

package/resources/stream/diff.d.ts

@@ -0,0 +1,29 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import type { StreamEvent } from "./events.js";
+/**
+ * Stateful differ. Construct one per execution stream, then call {@link next}
+ * for every snapshot in arrival order. Once a terminal `done` is emitted, later
+ * calls return nothing.
+ */
+export declare class SnapshotDiffer {
+    private displayedCount;
+    private inStream;
+    private humanMessageEmitted;
+    private lastPhase;
+    private seenSummarizationCount;
+    private finished;
+    private readonly promptedIds;
+    private readonly topTools;
+    private readonly subAgentTracking;
+    private readonly todos;
+    /** Project one snapshot into its events, advancing all internal state. */
+    next(execution: AgentExecution): StreamEvent[];
+    private emitHumanMessage;
+    private emitMessageEvents;
+    private emitCompleteMessage;
+    private isTrackedToolMessage;
+    private emitContextCompaction;
+    private emitPhaseChange;
+    private emitApprovals;
+}
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/diff.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAqBlG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,SAAS,CAA8D;IAC/E,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA0B;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,0EAA0E;IAC1E,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,WAAW,EAAE;IA8C9C,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,iBAAiB;IAoCzB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,qBAAqB;IAqB7B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,aAAa;CA4BtB"}

package/resources/stream/diff.js

@@ -0,0 +1,214 @@
+// The snapshot→event differ: the headless analog of Go's streamToEvents
+// (run_stream_events.go:203-468).
+//
+// Go's version owns a gRPC loop and blocks on an approval channel. This is a
+// pure, stateful transformer instead: feed it each AgentExecution snapshot and
+// it returns the discrete events for that snapshot, holding all cross-snapshot
+// state (message cursor, tool/sub-agent/todo trackers, prompted-approval dedup).
+// Approval *submission* is the renderer's job — the differ only emits
+// ApprovalNeededEvent. The step numbering and ordering below mirror the Go body
+// exactly, because the resulting event sequence is a wire-parity contract.
+import { ExecutionPhase, MessageType } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { buildApprovalNeeded, buildPendingApprovalFromToolCall, findAllUnpromptedApprovals, hasUsableApproval, } from "./approval-detect.js";
+import { collectToolCallsFromMessages, convertToolCalls, findToolCallById, isApprovalNoiseMessage, isTerminalAgentPhase, mapPhaseToString, mapSummarizationSource, sanitizeSystemContent, } from "./convert.js";
+import { SubAgentTracking } from "./subagent.js";
+import { TodoDiffer } from "./todo.js";
+import { buildToolEventMap, toolEventId, ToolStateTracker } from "./tool-state.js";
+/**
+ * Stateful differ. Construct one per execution stream, then call {@link next}
+ * for every snapshot in arrival order. Once a terminal `done` is emitted, later
+ * calls return nothing.
+ */
+export class SnapshotDiffer {
+    displayedCount = 0;
+    inStream = false;
+    humanMessageEmitted = false;
+    lastPhase = ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+    seenSummarizationCount = 0;
+    finished = false;
+    promptedIds = new Set();
+    topTools = new ToolStateTracker();
+    subAgentTracking = new SubAgentTracking();
+    todos = new TodoDiffer();
+    /** Project one snapshot into its events, advancing all internal state. */
+    next(execution) {
+        if (this.finished)
+            return [];
+        const out = [];
+        const status = execution.status;
+        const messages = status?.messages ?? [];
+        const subAgents = status?.subAgentExecutions ?? [];
+        const phase = status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+        this.emitHumanMessage(out, execution);
+        // Step 1: track tool transitions, then interleave message + tool events.
+        const rootToolCalls = collectToolCallsFromMessages(messages);
+        const toolEvents = this.topTools.track(rootToolCalls, "");
+        const pendingTools = buildToolEventMap(toolEvents);
+        this.emitMessageEvents(out, messages, pendingTools);
+        // Step 1c: orphan tool events (no matching MESSAGE_TOOL this snapshot).
+        for (const ev of toolEvents) {
+            if (pendingTools.has(toolEventId(ev)))
+                out.push(ev);
+        }
+        // Step 1d–1f: sub-agents, todos, context compaction.
+        if (subAgents.length > 0)
+            out.push(...this.subAgentTracking.emit(subAgents));
+        const todos = status?.todos ?? {};
+        if (Object.keys(todos).length > 0 || this.todos.hasPrev) {
+            out.push(...this.todos.diff(todos));
+        }
+        this.emitContextCompaction(out, execution);
+        // Step 2: phase change (with approval cycle-reset) before approval handling.
+        this.emitPhaseChange(out, phase);
+        // Step 3 + 3b: approval detection (pending_approvals, then status scan).
+        this.emitApprovals(out, status?.pendingApprovals ?? [], rootToolCalls, subAgents, phase);
+        // Step 5: terminal → done.
+        if (isTerminalAgentPhase(phase)) {
+            this.finished = true;
+            out.push({ kind: "done", phase: mapPhaseToString(phase), error: status?.error ?? "" });
+        }
+        return out;
+    }
+    // Step 0: emit the user's input message once, suppressing the "execute"
+    // placeholder. Mirrors streamToEvents Step 0.
+    emitHumanMessage(out, execution) {
+        if (this.humanMessageEmitted)
+            return;
+        const msg = execution.spec?.message ?? "";
+        if (msg !== "" && msg !== "execute") {
+            out.push({ kind: "humanMessage", content: msg });
+            this.humanMessageEmitted = true;
+        }
+    }
+    // Steps 1b: convert new messages to events, interleaving matched tool events
+    // at their chronological position. Mirrors Go's emitMessageEvents.
+    emitMessageEvents(out, messages, pending) {
+        // Phase 1: an in-progress streaming AI message.
+        if (this.inStream && this.displayedCount < messages.length) {
+            const msg = messages[this.displayedCount];
+            if (msg.isStreaming) {
+                out.push({ kind: "aiStreamDelta", content: msg.content, subAgentId: "" });
+                return;
+            }
+            out.push({ kind: "aiStreamEnd", content: msg.content, toolCalls: convertToolCalls(msg.toolCalls), subAgentId: "" });
+            this.displayedCount++;
+            this.inStream = false;
+        }
+        // Phase 2: complete messages, detecting a new streaming start.
+        while (this.displayedCount < messages.length) {
+            const msg = messages[this.displayedCount];
+            if (msg.isStreaming && msg.type === MessageType.MESSAGE_AI) {
+                out.push({ kind: "aiStreamStart", content: msg.content, subAgentId: "" });
+                this.inStream = true;
+                return;
+            }
+            if (msg.type === MessageType.MESSAGE_HUMAN) {
+                this.displayedCount++;
+                continue;
+            }
+            if (this.isTrackedToolMessage(msg)) {
+                emitMatchedToolEvents(out, msg, pending);
+                this.displayedCount++;
+                continue;
+            }
+            this.emitCompleteMessage(out, msg);
+            this.displayedCount++;
+        }
+    }
+    // Emit one complete (non-streaming) message by type. Mirrors Go's emitCompleteMessage.
+    emitCompleteMessage(out, msg) {
+        switch (msg.type) {
+            case MessageType.MESSAGE_HUMAN:
+                out.push({ kind: "humanMessage", content: msg.content });
+                return;
+            case MessageType.MESSAGE_AI:
+                out.push({ kind: "aiMessage", content: msg.content, toolCalls: convertToolCalls(msg.toolCalls), subAgentId: "" });
+                return;
+            case MessageType.MESSAGE_TOOL:
+                out.push({ kind: "toolResult", content: msg.content, toolCalls: convertToolCalls(msg.toolCalls) });
+                return;
+            case MessageType.MESSAGE_SYSTEM:
+                if (isApprovalNoiseMessage(msg.content))
+                    return;
+                out.push({ kind: "systemMessage", content: sanitizeSystemContent(msg.content) });
+                return;
+            default:
+                out.push({ kind: "systemMessage", content: `Unknown message: ${msg.content}` });
+        }
+    }
+    // True for a MESSAGE_TOOL whose tool call the top-level tracker already owns.
+    // Mirrors Go's isTrackedToolMessage.
+    isTrackedToolMessage(msg) {
+        if (msg.type !== MessageType.MESSAGE_TOOL)
+            return false;
+        return msg.toolCalls.some((tc) => tc.id !== "" && this.topTools.has(tc.id));
+    }
+    // Step 1f: emit a ContextCompactedEvent per new summarization event. Mirrors
+    // the count-based tracking in streamToEvents.
+    emitContextCompaction(out, execution) {
+        const events = execution.status?.contextInfo?.summarizationEvents ?? [];
+        for (let i = this.seenSummarizationCount; i < events.length; i++) {
+            const se = events[i];
+            out.push({
+                kind: "contextCompacted",
+                source: mapSummarizationSource(se.source),
+                tokensBefore: se.tokensBefore,
+                tokensAfter: se.tokensAfter,
+                compressionRatio: se.compressionRatio,
+                durationMs: se.durationMs,
+                messagesBefore: se.messagesBefore,
+                messagesAfter: se.messagesAfter,
+            });
+        }
+        this.seenSummarizationCount = events.length;
+    }
+    // Step 2: phase change, resetting the prompted set on an approval cycle
+    // (IN_PROGRESS→WAITING_FOR_APPROVAL) so a re-entered gate re-prompts instead
+    // of deadlocking. Mirrors streamToEvents Step 2.
+    emitPhaseChange(out, phase) {
+        if (phase === this.lastPhase)
+            return;
+        if (phase === ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL &&
+            this.lastPhase === ExecutionPhase.EXECUTION_IN_PROGRESS) {
+            this.promptedIds.clear();
+        }
+        out.push({ kind: "phaseChange", phase: mapPhaseToString(phase), previous: mapPhaseToString(this.lastPhase) });
+        this.lastPhase = phase;
+    }
+    // Steps 3 + 3b: emit ApprovalNeededEvent for each unprompted pending approval,
+    // then fall back to a tool-status scan when pending_approvals is degraded.
+    emitApprovals(out, pendingApprovals, rootToolCalls, subAgents, phase) {
+        for (const pa of pendingApprovals) {
+            const key = pa.toolCallId;
+            if (key === "" || this.promptedIds.has(key))
+                continue;
+            const tc = findToolCallById(rootToolCalls, subAgents, pa.toolCallId);
+            out.push(buildApprovalNeeded(tc, pa));
+            this.promptedIds.add(key);
+        }
+        if (!hasUsableApproval(pendingApprovals, this.promptedIds) &&
+            phase === ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL) {
+            for (const u of findAllUnpromptedApprovals(rootToolCalls, subAgents, this.promptedIds)) {
+                const pa = buildPendingApprovalFromToolCall(u.toolCall);
+                pa.fromSubAgent = u.fromSubAgent;
+                pa.subAgentName = u.subAgentName;
+                out.push(buildApprovalNeeded(u.toolCall, pa));
+                this.promptedIds.add(pa.toolCallId);
+            }
+        }
+    }
+}
+// Emit tool events whose IDs match the MESSAGE_TOOL's embedded tool calls at the
+// current position, consuming them from `pending`. Mirrors Go's emitMatchedToolEvents.
+function emitMatchedToolEvents(out, msg, pending) {
+    for (const tc of msg.toolCalls) {
+        if (tc.id === "")
+            continue;
+        const ev = pending.get(tc.id);
+        if (ev !== undefined) {
+            out.push(ev);
+            pending.delete(tc.id);
+        }
+    }
+}
+//# sourceMappingURL=diff.js.map

package/resources/stream/diff.js.map

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

package/resources/stream/events.d.ts

@@ -0,0 +1,137 @@
+import type { JsonObject } from "@bufbuild/protobuf";
+/** A tool call projected for rendering. Mirrors toolrender.ToolCallInfo. */
+export interface ToolCallInfo {
+    readonly id: string;
+    readonly name: string;
+    /** Mapped status: pending|running|completed|failed|waiting_approval|skipped|unknown. */
+    readonly status: string;
+    readonly args?: JsonObject;
+    readonly result: string;
+    readonly error: string;
+    /** Elapsed time in ms from started_at→completed_at, or 0 when unknown. */
+    readonly durationMs: number;
+}
+/** A todo item projected for rendering. Mirrors executiontui.TodoItem. */
+export interface TodoItemView {
+    readonly id: string;
+    readonly content: string;
+    /** Mapped status: pending|in_progress|completed|cancelled. */
+    readonly status: string;
+}
+export interface AIMessageEvent {
+    readonly kind: "aiMessage";
+    readonly content: string;
+    readonly toolCalls: readonly ToolCallInfo[];
+    readonly subAgentId: string;
+}
+export interface AIStreamStartEvent {
+    readonly kind: "aiStreamStart";
+    readonly content: string;
+    readonly subAgentId: string;
+}
+export interface AIStreamDeltaEvent {
+    readonly kind: "aiStreamDelta";
+    readonly content: string;
+    readonly subAgentId: string;
+}
+export interface AIStreamEndEvent {
+    readonly kind: "aiStreamEnd";
+    readonly content: string;
+    readonly toolCalls: readonly ToolCallInfo[];
+    readonly subAgentId: string;
+}
+export interface HumanMessageEvent {
+    readonly kind: "humanMessage";
+    readonly content: string;
+}
+export interface ToolResultEvent {
+    readonly kind: "toolResult";
+    readonly content: string;
+    readonly toolCalls: readonly ToolCallInfo[];
+}
+export interface ToolRunningEvent {
+    readonly kind: "toolRunning";
+    readonly toolCallId: string;
+    readonly toolCall: ToolCallInfo;
+    readonly subAgentId: string;
+}
+export interface ToolCompletedEvent {
+    readonly kind: "toolCompleted";
+    readonly toolCallId: string;
+    readonly toolCall: ToolCallInfo;
+    readonly subAgentId: string;
+}
+export interface ToolWaitingApprovalEvent {
+    readonly kind: "toolWaitingApproval";
+    readonly toolCallId: string;
+    readonly toolCall: ToolCallInfo;
+    readonly subAgentId: string;
+}
+export interface ToolStreamDeltaEvent {
+    readonly kind: "toolStreamDelta";
+    readonly toolCallId: string;
+    readonly toolCall: ToolCallInfo;
+    readonly content: string;
+    readonly subAgentId: string;
+}
+export interface SystemMessageEvent {
+    readonly kind: "systemMessage";
+    readonly content: string;
+}
+export interface PhaseChangeEvent {
+    readonly kind: "phaseChange";
+    readonly phase: string;
+    readonly previous: string;
+}
+export interface ApprovalNeededEvent {
+    readonly kind: "approvalNeeded";
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly argsPreview: string;
+    readonly message: string;
+    readonly fromSubAgent: boolean;
+    readonly subAgentName: string;
+}
+export interface TodoUpdateEvent {
+    readonly kind: "todoUpdate";
+    readonly todos: readonly TodoItemView[];
+}
+export interface ContextCompactedEvent {
+    readonly kind: "contextCompacted";
+    readonly source: string;
+    readonly tokensBefore: number;
+    readonly tokensAfter: number;
+    readonly compressionRatio: number;
+    readonly durationMs: number;
+    readonly messagesBefore: number;
+    readonly messagesAfter: number;
+}
+export interface SubAgentStartedEvent {
+    readonly kind: "subAgentStarted";
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly input: string;
+}
+export interface SubAgentCompletedEvent {
+    readonly kind: "subAgentCompleted";
+    readonly id: string;
+    /** Protojson enum string for the sub-agent's terminal status. */
+    readonly status: string;
+    readonly toolCount: number;
+    readonly output: string;
+}
+export interface DoneEvent {
+    readonly kind: "done";
+    readonly phase: string;
+    readonly error: string;
+}
+export interface StreamErrorEvent {
+    readonly kind: "streamError";
+    readonly error: string;
+}
+/** The sealed union of every differ event. */
+export type StreamEvent = AIMessageEvent | AIStreamStartEvent | AIStreamDeltaEvent | AIStreamEndEvent | HumanMessageEvent | ToolResultEvent | ToolRunningEvent | ToolCompletedEvent | ToolWaitingApprovalEvent | ToolStreamDeltaEvent | SystemMessageEvent | PhaseChangeEvent | ApprovalNeededEvent | TodoUpdateEvent | ContextCompactedEvent | SubAgentStartedEvent | SubAgentCompletedEvent | DoneEvent | StreamErrorEvent;
+/** True for the two events that end a stream. */
+export declare function isTerminalEvent(event: StreamEvent): boolean;
+//# sourceMappingURL=events.d.ts.map

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

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

package/resources/stream/events.js

@@ -0,0 +1,15 @@
+// The sealed event model for the headless snapshot differ.
+//
+// Mirrors Go's pkg/executiontui.Event family (events.go). The differ projects
+// each AgentExecution snapshot into a sequence of these discrete events; the
+// NDJSON and plaintext renderers consume them. The Ink TTY path does NOT use
+// this model — it renders from full snapshots via @stigmer/react.
+//
+// `kind` is the discriminant. The NDJSON renderer maps each kind to Go's exact
+// wire taxonomy (run_stream_json.go), so kinds are deliberately 1:1 with the Go
+// event types rather than the wire strings.
+/** True for the two events that end a stream. */
+export function isTerminalEvent(event) {
+    return event.kind === "done" || event.kind === "streamError";
+}
+//# sourceMappingURL=events.js.map

package/resources/stream/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/resources/stream/events.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,kEAAkE;AAClE,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,4CAA4C;AAoL5C,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC;AAC/D,CAAC"}

package/resources/stream/headless.d.ts

@@ -0,0 +1,38 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import type { ApprovalNeededEvent, StreamEvent } from "./events.js";
+/**
+ * A headless renderer: turns each differ event into output and decides how to
+ * resolve approvals. Both methods are synchronous — submission is the driver's
+ * job. Implemented by NdjsonRenderer and PlaintextRenderer.
+ */
+export interface HeadlessRenderer {
+    /** Render one event to the renderer's sinks. */
+    render(event: StreamEvent): void;
+    /** Choose the approval action for an emitted ApprovalNeededEvent (may warn). */
+    resolveApproval(event: ApprovalNeededEvent): ApprovalAction;
+}
+/** The terminal outcome of a headless stream. */
+export interface HeadlessResult {
+    readonly phase: string;
+    readonly error: string;
+}
+/** Dependencies for {@link runHeadlessStream}. */
+export interface HeadlessStreamDeps {
+    /** The execution snapshot source (the SDK's agentExecution.subscribe). */
+    readonly subscribe: (signal: AbortSignal) => AsyncIterable<AgentExecution>;
+    /** Submit one approval decision. The caller binds the execution + RPC. */
+    readonly submitApproval: (toolCallId: string, action: ApprovalAction) => Promise<void>;
+    readonly renderer: HeadlessRenderer;
+    readonly sessionId: string;
+    readonly signal: AbortSignal;
+}
+/**
+ * Drive the stream to a terminal phase and return the outcome. Aborting (Ctrl-C)
+ * resolves cleanly with an empty result; a dropped stream renders a stream_error
+ * and returns its message.
+ */
+export declare function runHeadlessStream(deps: HeadlessStreamDeps): Promise<HeadlessResult>;
+/** Re-export so command wiring can reference the enum without a deep import. */
+export { ApprovalAction };
+//# sourceMappingURL=headless.d.ts.map