@stigmer/cli 3.0.8

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

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/headless.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQpE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,gFAAgF;IAChF,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAAC;CAC7D;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,aAAa,CAAC,cAAc,CAAC,CAAC;IAC3E,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAczF;AAyCD,gFAAgF;AAChF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/resources/stream/headless.js

@@ -0,0 +1,75 @@
+// The headless stream driver: subscribe → diff → render → resolve approvals.
+//
+// This is the single-process analog of Go's renderer goroutine + approval
+// channel (run_stream.go / run_stream_events.go). Go runs streamToEvents in one
+// goroutine and the renderer in another, exchanging approvals over channels.
+// Here it's one async loop: each snapshot is diffed, every event is rendered,
+// and an ApprovalNeededEvent is resolved by the renderer's policy and submitted
+// (with retry) before the loop blocks on the next snapshot — which is safe
+// because the backend withholds further updates until the approval lands.
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { SnapshotDiffer } from "./diff.js";
+import { APPROVAL_RETRY_BASE_DELAY_MS, APPROVAL_RETRY_MAX_ATTEMPTS, classifyStreamError, retryWithBackoff, } from "./submit.js";
+/**
+ * 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 async function runHeadlessStream(deps) {
+    const differ = new SnapshotDiffer();
+    try {
+        for await (const snapshot of deps.subscribe(deps.signal)) {
+            const terminal = await drainSnapshot(differ.next(snapshot), deps);
+            if (terminal !== undefined)
+                return terminal;
+        }
+        return { phase: "", error: "" };
+    }
+    catch (err) {
+        if (deps.signal.aborted)
+            return { phase: "", error: "" };
+        const message = classifyStreamError(err, deps.sessionId);
+        deps.renderer.render({ kind: "streamError", error: message });
+        return { phase: "", error: message };
+    }
+}
+// Render every event for one snapshot, resolving approvals as they appear.
+// Returns the terminal result when a done/stream_error event is reached.
+async function drainSnapshot(events, deps) {
+    for (const event of events) {
+        deps.renderer.render(event);
+        if (event.kind === "approvalNeeded") {
+            const failure = await resolveAndSubmit(event, deps);
+            if (failure !== undefined)
+                return failure;
+        }
+        if (event.kind === "done")
+            return { phase: event.phase, error: event.error };
+        if (event.kind === "streamError")
+            return { phase: "", error: event.error };
+    }
+    return undefined;
+}
+// Resolve an approval via the renderer's policy and submit it with retry. On
+// terminal submit failure, render a stream_error and return it (mirrors Go's
+// emitAndWaitApproval, which surfaces a StreamErrorEvent the renderer treats as
+// terminal). A successful submit returns undefined to continue the stream.
+async function resolveAndSubmit(event, deps) {
+    const action = deps.renderer.resolveApproval(event);
+    try {
+        await retryWithBackoff(deps.signal, APPROVAL_RETRY_MAX_ATTEMPTS, APPROVAL_RETRY_BASE_DELAY_MS, () => deps.submitApproval(event.toolCallId, action));
+        return undefined;
+    }
+    catch (err) {
+        if (deps.signal.aborted)
+            return { phase: "", error: "" };
+        let message = `Failed to submit approval after ${APPROVAL_RETRY_MAX_ATTEMPTS} attempts`;
+        if (deps.sessionId !== "")
+            message += `. Re-attach to retry: stigmer resume ${deps.sessionId}`;
+        deps.renderer.render({ kind: "streamError", error: message });
+        return { phase: "", error: message };
+    }
+}
+/** Re-export so command wiring can reference the enum without a deep import. */
+export { ApprovalAction };
+//# sourceMappingURL=headless.js.map

package/resources/stream/headless.js.map

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

package/resources/stream/ink.d.ts

@@ -0,0 +1,22 @@
+import { type InteractionMode } from "@stigmer/ink";
+import type { DeploymentMode, Stigmer } from "@stigmer/sdk";
+export interface InkSessionOptions {
+    /** The CLI's configured, refreshing-token client (backend.stigmer). */
+    readonly client: Stigmer;
+    readonly sessionId: string;
+    /** Org slug, for follow-up executions created from the composer. */
+    readonly org: string;
+    /** Initial interaction mode; the user can toggle with Ctrl+T. */
+    readonly mode: InteractionMode;
+    /** Feature-gating mode; "cloud" unless the CLI targets a local backend. */
+    readonly deploymentMode?: DeploymentMode;
+}
+/**
+ * Render a live session in the terminal and resolve when the user exits (Ctrl+C
+ * unmounts the app). This NEVER calls process.exit — the caller still runs its
+ * epilogue (final Get + usage). Termination signals unmount the Ink tree so the
+ * terminal is restored cleanly, but control returns here rather than killing
+ * the host process.
+ */
+export declare function runInkSession(opts: InkSessionOptions): Promise<void>;
+//# sourceMappingURL=ink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ink.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/ink.tsx"],"names":[],"mappings":"AAeA,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB1E"}

package/resources/stream/ink.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from "ink";
+import { InkStigmerProvider, SessionView } from "@stigmer/ink";
+/**
+ * Render a live session in the terminal and resolve when the user exits (Ctrl+C
+ * unmounts the app). This NEVER calls process.exit — the caller still runs its
+ * epilogue (final Get + usage). Termination signals unmount the Ink tree so the
+ * terminal is restored cleanly, but control returns here rather than killing
+ * the host process.
+ */
+export async function runInkSession(opts) {
+    const instance = render(_jsx(InkStigmerProvider, { client: opts.client, deploymentMode: opts.deploymentMode ?? "cloud", children: _jsx(SessionView, { sessionId: opts.sessionId, org: opts.org, mode: opts.mode }) }), { exitOnCtrlC: true });
+    const onSignal = () => instance.unmount();
+    process.once("SIGINT", onSignal);
+    process.once("SIGTERM", onSignal);
+    try {
+        await instance.waitUntilExit();
+    }
+    finally {
+        process.removeListener("SIGINT", onSignal);
+        process.removeListener("SIGTERM", onSignal);
+    }
+}
+//# sourceMappingURL=ink.js.map

package/resources/stream/ink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ink.js","sourceRoot":"","sources":["../../../src/resources/stream/ink.tsx"],"names":[],"mappings":";AAcA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAwB,MAAM,cAAc,CAAC;AAerF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAuB;IACzD,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAC,kBAAkB,IAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,OAAO,YACrF,KAAC,WAAW,IAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,GAAI,GACvD,EACrB,EAAE,WAAW,EAAE,IAAI,EAAE,CACtB,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC3C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/resources/stream/render-ndjson.d.ts

@@ -0,0 +1,25 @@
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import type { ApprovalNeededEvent, StreamEvent } from "./events.js";
+import type { HeadlessRenderer } from "./headless.js";
+/** A minimal output sink (process.stdout/stderr or a test buffer). */
+export interface LineWriter {
+    write(chunk: string): unknown;
+}
+export interface NdjsonRendererOptions {
+    /** NDJSON event lines (stdout). */
+    readonly data: LineWriter;
+    /** Fatal/auto-skip diagnostics (stderr). */
+    readonly status: LineWriter;
+    /** Approval default; UNSPECIFIED means auto-skip with a warning. */
+    readonly defaultAction: ApprovalAction;
+    /** Injectable clock for deterministic tests. */
+    readonly now?: () => string;
+}
+/** Writes one `{type, ts, payload}` line per event; auto-resolves approvals. */
+export declare class NdjsonRenderer implements HeadlessRenderer {
+    private readonly opts;
+    constructor(opts: NdjsonRendererOptions);
+    render(event: StreamEvent): void;
+    resolveApproval(event: ApprovalNeededEvent): ApprovalAction;
+}
+//# sourceMappingURL=render-ndjson.d.ts.map

package/resources/stream/render-ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-ndjson.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/render-ndjson.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,KAAK,EAAgB,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,gFAAgF;AAChF,qBAAa,cAAe,YAAW,gBAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,qBAAqB;IAExD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAShC,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc;CAO5D"}

package/resources/stream/render-ndjson.js

@@ -0,0 +1,156 @@
+// NDJSON headless renderer: StreamEvent → Go's run --json wire taxonomy.
+//
+// Mirrors run_stream_json.go's handleJSONEvent one case at a time — the event
+// `type` strings and payload keys are a parity contract (DD-005). The envelope
+// + payload cleaning live in output/ndjson.ts; this module only maps events to
+// `{type, payload}` and applies the headless approval policy.
+import { ndjsonEnvelope, writeNdjson } from "../../output/ndjson.js";
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+/** Writes one `{type, ts, payload}` line per event; auto-resolves approvals. */
+export class NdjsonRenderer {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    render(event) {
+        const mapped = mapToNdjson(event);
+        if (mapped !== undefined) {
+            writeNdjson(this.opts.data, ndjsonEnvelope(mapped.type, mapped.payload, this.opts.now));
+        }
+    }
+    // JSON mode has no interactive prompt: honor --approve-default, else skip with
+    // a warning to stderr. Mirrors run_stream_json.go's resolveJSONApproval.
+    resolveApproval(event) {
+        if (this.opts.defaultAction === ApprovalAction.UNSPECIFIED) {
+            this.opts.status.write(`⚠ No --approve-default set; auto-skipping approval for ${event.toolName}\n`);
+            return ApprovalAction.SKIP;
+        }
+        return this.opts.defaultAction;
+    }
+}
+// Map one event to its NDJSON type + raw payload (cleaned later). The arms are
+// 1:1 with handleJSONEvent so the wire output stays byte-faithful.
+function mapToNdjson(event) {
+    switch (event.kind) {
+        case "aiStreamStart":
+            return { type: "ai_stream_start", payload: { content: event.content, sub_agent_id: event.subAgentId } };
+        case "aiStreamDelta":
+            return { type: "ai_stream_delta", payload: { content: event.content, sub_agent_id: event.subAgentId } };
+        case "aiStreamEnd":
+            return {
+                type: "ai_stream_end",
+                payload: { content: event.content, tool_calls: toolCallsToJson(event.toolCalls), sub_agent_id: event.subAgentId },
+            };
+        case "aiMessage":
+            return {
+                type: "ai_message",
+                payload: { content: event.content, tool_calls: toolCallsToJson(event.toolCalls), sub_agent_id: event.subAgentId },
+            };
+        case "humanMessage":
+            return { type: "human_message", payload: { content: event.content } };
+        case "toolRunning":
+            return { type: "tool_running", payload: toolEventPayload(event.toolCallId, event.toolCall, event.subAgentId) };
+        case "toolCompleted":
+            return { type: "tool_completed", payload: toolEventPayload(event.toolCallId, event.toolCall, event.subAgentId) };
+        case "toolWaitingApproval":
+            return {
+                type: "tool_waiting_approval",
+                payload: toolEventPayload(event.toolCallId, event.toolCall, event.subAgentId),
+            };
+        case "toolStreamDelta":
+            return {
+                type: "tool_stream_delta",
+                payload: {
+                    tool_call_id: event.toolCallId,
+                    tool_name: event.toolCall.name,
+                    content: event.content,
+                    sub_agent_id: event.subAgentId,
+                },
+            };
+        case "systemMessage":
+            return { type: "system_message", payload: { content: event.content } };
+        case "phaseChange":
+            return { type: "phase_change", payload: { phase: event.phase, previous: event.previous } };
+        case "approvalNeeded":
+            return {
+                type: "approval_needed",
+                payload: {
+                    tool_call_id: event.toolCallId,
+                    tool_name: event.toolName,
+                    args_preview: event.argsPreview,
+                    message: event.message,
+                    from_sub_agent: event.fromSubAgent,
+                    sub_agent_name: event.subAgentName,
+                },
+            };
+        case "todoUpdate":
+            return {
+                type: "todo_update",
+                payload: { todos: event.todos.map((t) => ({ id: t.id, content: t.content, status: t.status })) },
+            };
+        case "contextCompacted":
+            return {
+                type: "context_compacted",
+                payload: {
+                    source: event.source,
+                    tokens_before: event.tokensBefore,
+                    tokens_after: event.tokensAfter,
+                    compression_ratio: event.compressionRatio,
+                    duration_ms: event.durationMs,
+                    messages_before: event.messagesBefore,
+                    messages_after: event.messagesAfter,
+                },
+            };
+        case "subAgentStarted":
+            return {
+                type: "sub_agent_started",
+                payload: { id: event.id, name: event.name, description: event.description },
+            };
+        case "subAgentCompleted":
+            return {
+                type: "sub_agent_completed",
+                payload: { id: event.id, status: event.status, tool_count: event.toolCount, output: event.output },
+            };
+        case "done":
+            return { type: "done", payload: { phase: event.phase, error: event.error } };
+        case "streamError":
+            return { type: "stream_error", payload: { error: event.error } };
+    }
+}
+// The shared payload for tool-lifecycle events. Mirrors Go's toolEventPayload:
+// args/result/error/duration are only present when meaningful. Empty strings are
+// stripped later by cleanNdjsonPayload.
+function toolEventPayload(toolCallId, tc, subAgentId) {
+    return {
+        tool_call_id: toolCallId,
+        tool_name: tc.name,
+        status: tc.status,
+        sub_agent_id: subAgentId,
+        args: tc.args,
+        result: tc.result,
+        error: tc.error,
+        duration_ms: tc.durationMs > 0 ? tc.durationMs : undefined,
+    };
+}
+// Convert a tool-call list to JSON maps, returning undefined for an empty list
+// (so the field is dropped). Inner maps keep name+status; the rest are omitted
+// when empty. Mirrors Go's toolCallsToJSON.
+function toolCallsToJson(tcs) {
+    if (tcs.length === 0)
+        return undefined;
+    return tcs.map((tc) => {
+        const m = { name: tc.name, status: tc.status };
+        if (tc.id !== "")
+            m.id = tc.id;
+        if (tc.args !== undefined)
+            m.args = tc.args;
+        if (tc.result !== "")
+            m.result = tc.result;
+        if (tc.error !== "")
+            m.error = tc.error;
+        if (tc.durationMs > 0)
+            m.duration_ms = tc.durationMs;
+        return m;
+    });
+}
+//# sourceMappingURL=render-ndjson.js.map

package/resources/stream/render-ndjson.js.map

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

package/resources/stream/render-plaintext.d.ts

@@ -0,0 +1,18 @@
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import type { ApprovalNeededEvent, StreamEvent } from "./events.js";
+import type { HeadlessRenderer } from "./headless.js";
+import type { LineWriter } from "./render-ndjson.js";
+export interface PlaintextRendererOptions {
+    /** AI text output (stdout). */
+    readonly data: LineWriter;
+    /** Tool/status/diagnostic lines (stderr). */
+    readonly status: LineWriter;
+}
+/** Renders a terse, ANSI-free transcript; auto-skips every approval. */
+export declare class PlaintextRenderer implements HeadlessRenderer {
+    private readonly opts;
+    constructor(opts: PlaintextRendererOptions);
+    render(event: StreamEvent): void;
+    resolveApproval(_event: ApprovalNeededEvent): ApprovalAction;
+}
+//# sourceMappingURL=render-plaintext.d.ts.map

package/resources/stream/render-plaintext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-plaintext.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/render-plaintext.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAID,wEAAwE;AACxE,qBAAa,iBAAkB,YAAW,gBAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAE3D,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAkDhC,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,cAAc;CAG7D"}

package/resources/stream/render-plaintext.js

@@ -0,0 +1,71 @@
+// Plaintext headless renderer for non-TTY output (piped stdout).
+//
+// Mirrors Go's streamAgentPlainText (run_stream_plaintext.go): clean AI text to
+// the data sink (stdout), terse tool/status lines to the status sink (stderr).
+// No ANSI, no frames. Approvals are auto-skipped — there is no keyboard here;
+// use --json for a machine-readable non-TTY stream. Phase/done/stream-error are
+// not rendered: the driver returns the outcome and the command surfaces it.
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+const MAX_ERROR_LEN = 100;
+/** Renders a terse, ANSI-free transcript; auto-skips every approval. */
+export class PlaintextRenderer {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    render(event) {
+        const { data, status } = this.opts;
+        switch (event.kind) {
+            case "aiStreamDelta":
+                data.write(event.content);
+                return;
+            case "aiStreamEnd":
+                data.write("\n");
+                return;
+            case "aiMessage":
+                if (event.content !== "")
+                    data.write(`${event.content}\n`);
+                return;
+            case "humanMessage":
+                status.write(`\n> ${event.content}\n\n`);
+                return;
+            case "toolRunning":
+                status.write(`  ⠋ ${event.toolCall.name}\n`);
+                return;
+            case "toolCompleted":
+                status.write(event.toolCall.error !== ""
+                    ? `  ✗ ${event.toolCall.name}: ${truncate(event.toolCall.error, MAX_ERROR_LEN)}\n`
+                    : `  ✓ ${event.toolCall.name}\n`);
+                return;
+            case "approvalNeeded":
+                status.write(`  ⚠ Approval needed: ${event.toolName} (auto-skipped in non-TTY mode)\n`);
+                return;
+            case "subAgentStarted":
+                status.write(`  ↳ Sub-agent: ${event.description !== "" ? event.description : event.name}\n`);
+                return;
+            case "subAgentCompleted":
+                status.write(`  ✓ Sub-agent completed: ${event.id}\n`);
+                return;
+            case "contextCompacted":
+                status.write(`  … Context compacted (${Math.floor(event.tokensBefore / 1000)}K → ${Math.floor(event.tokensAfter / 1000)}K tokens)\n`);
+                return;
+            case "systemMessage":
+                status.write(`[system] ${event.content}\n`);
+                return;
+            default:
+                // phaseChange, toolWaitingApproval, toolStreamDelta, todoUpdate, done,
+                // streamError: not surfaced in plaintext (parity with Go).
+                return;
+        }
+    }
+    // Non-TTY has no prompt — always skip (the render() line already noted it).
+    resolveApproval(_event) {
+        return ApprovalAction.SKIP;
+    }
+}
+// Trim and ellipsize. Mirrors Go's truncate.
+function truncate(value, maxLen) {
+    const trimmed = value.trim();
+    return trimmed.length <= maxLen ? trimmed : `${trimmed.slice(0, maxLen)}…`;
+}
+//# sourceMappingURL=render-plaintext.js.map

package/resources/stream/render-plaintext.js.map

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

package/resources/stream/snapshot.d.ts

@@ -0,0 +1,8 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import type { StreamEvent } from "./events.js";
+/**
+ * Convert stored executions (chronological, oldest first) into a flat event
+ * sequence. Only the final execution emits a `done` event.
+ */
+export declare function snapshotToEvents(executions: readonly AgentExecution[]): StreamEvent[];
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/resources/stream/snapshot.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAalG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,EAAE,CAMrF"}

package/resources/stream/snapshot.js

@@ -0,0 +1,163 @@
+// Historical replay: stored executions → the same StreamEvent sequence the live
+// differ produces. The headless analog of Go's snapshotToEvents
+// (run_stream_snapshot.go). Resume's completed-session path feeds these events
+// to the NDJSON/plaintext renderers so noise suppression, tool lifecycle badges,
+// and interleaving all apply identically to a live run.
+//
+// Unlike the live differ, there is no cross-snapshot state: each execution's
+// final state is a complete picture, so we walk messages once and emit a single
+// todo snapshot. Only the last execution emits `done` (so the Ink composer
+// activates for follow-ups; headless renderers ignore intermediate dones).
+import { MessageType } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { collectToolCallsFromMessages, convertProtoTodos, convertToolCall, isApprovalNoiseMessage, isTerminalToolStatus, mapPhaseToString, mapToolCallStatus, sanitizeSystemContent, } from "./convert.js";
+import { SubAgentTracking } from "./subagent.js";
+/**
+ * Convert stored executions (chronological, oldest first) into a flat event
+ * sequence. Only the final execution emits a `done` event.
+ */
+export function snapshotToEvents(executions) {
+    const out = [];
+    executions.forEach((exec, i) => {
+        emitSnapshotEvents(out, exec, i === executions.length - 1);
+    });
+    return out;
+}
+// Project one stored execution's final state into events. Mirrors Go's
+// emitSnapshotEvents: spec message → interleaved messages + tools → trailing
+// non-message tools → sub-agents → todos → (optional) done.
+function emitSnapshotEvents(out, exec, emitDone) {
+    const status = exec.status;
+    const messages = status?.messages ?? [];
+    const allToolCalls = collectToolCallsFromMessages(messages);
+    const toolCallById = new Map();
+    for (const tc of allToolCalls) {
+        if (tc.id !== "")
+            toolCallById.set(tc.id, tc);
+    }
+    const messageToolIds = collectMessageToolIds(messages);
+    const nonMsgToolCalls = sortByStartedAt(allToolCalls.filter((tc) => tc.id !== "" && !messageToolIds.has(tc.id)));
+    // The user's prompt for this execution (the "execute" placeholder is hidden).
+    const specMessage = exec.spec?.message ?? "";
+    if (specMessage !== "" && specMessage !== "execute") {
+        out.push({ kind: "humanMessage", content: specMessage });
+    }
+    const emitted = new Set();
+    let cursor = 0;
+    for (const msg of messages) {
+        cursor = emitInterleaved(out, nonMsgToolCalls, cursor, msg.timestamp, emitted);
+        switch (msg.type) {
+            case MessageType.MESSAGE_HUMAN:
+                break; // already emitted via spec.message
+            case MessageType.MESSAGE_TOOL:
+                emitToolMessage(out, msg, toolCallById, emitted);
+                break;
+            case MessageType.MESSAGE_AI:
+                out.push({ kind: "aiMessage", content: msg.content, toolCalls: [], subAgentId: "" });
+                break;
+            default:
+                emitOtherMessage(out, msg);
+        }
+    }
+    // Non-message tools that started after every message (or had no timestamp).
+    for (; cursor < nonMsgToolCalls.length; cursor++) {
+        const tc = nonMsgToolCalls[cursor];
+        if (!emitted.has(tc.id)) {
+            emitToolByStatus(out, tc);
+            emitted.add(tc.id);
+        }
+    }
+    const subAgents = status?.subAgentExecutions ?? [];
+    if (subAgents.length > 0)
+        out.push(...new SubAgentTracking().emit(subAgents));
+    const todos = convertProtoTodos(status?.todos ?? {});
+    if (todos.length > 0)
+        out.push({ kind: "todoUpdate", todos });
+    if (emitDone) {
+        out.push({ kind: "done", phase: mapPhaseToString(status?.phase ?? 0), error: status?.error ?? "" });
+    }
+}
+// Emit non-message tool calls whose started_at is at/before the message's
+// timestamp, advancing the cursor. Mirrors Go's emitInterleaved.
+function emitInterleaved(out, toolCalls, cursor, msgTimestamp, emitted) {
+    let i = cursor;
+    while (i < toolCalls.length) {
+        const tc = toolCalls[i];
+        if (tc.startedAt === "")
+            break; // no timestamp — defer to the end
+        if (msgTimestamp === "" || tc.startedAt > msgTimestamp)
+            break;
+        if (!emitted.has(tc.id)) {
+            emitToolByStatus(out, tc);
+            emitted.add(tc.id);
+        }
+        i++;
+    }
+    return i;
+}
+// Promote a MESSAGE_TOOL into stateful tool events using the full tool-call
+// data. Mirrors Go's emitToolMessageAsStateful (falls back to other-message
+// handling when the message carries no tool refs).
+function emitToolMessage(out, msg, toolCallById, emitted) {
+    if (msg.toolCalls.length === 0) {
+        emitOtherMessage(out, msg);
+        return;
+    }
+    for (const ref of msg.toolCalls) {
+        if (ref.id === "" || emitted.has(ref.id))
+            continue;
+        const full = toolCallById.get(ref.id) ?? ref;
+        emitToolByStatus(out, full);
+        emitted.add(full.id);
+    }
+}
+// SYSTEM (with noise suppression + sanitize) and any unexpected type. Mirrors
+// the SYSTEM/default arms of Go's emitCompleteMessage.
+function emitOtherMessage(out, msg) {
+    if (msg.type === MessageType.MESSAGE_SYSTEM) {
+        if (isApprovalNoiseMessage(msg.content))
+            return;
+        out.push({ kind: "systemMessage", content: sanitizeSystemContent(msg.content) });
+        return;
+    }
+    out.push({ kind: "systemMessage", content: `Unknown message: ${msg.content}` });
+}
+// Emit the right tool event for a tool call's final status. Mirrors Go's
+// emitToolEventByStatus.
+function emitToolByStatus(out, tc) {
+    const status = mapToolCallStatus(tc.status);
+    const toolCall = convertToolCall(tc);
+    if (isTerminalToolStatus(status)) {
+        out.push({ kind: "toolCompleted", toolCallId: tc.id, toolCall, subAgentId: "" });
+    }
+    else if (status === "waiting_approval") {
+        out.push({ kind: "toolWaitingApproval", toolCallId: tc.id, toolCall, subAgentId: "" });
+    }
+    else {
+        out.push({ kind: "toolRunning", toolCallId: tc.id, toolCall, subAgentId: "" });
+    }
+}
+// Tool-call IDs referenced by MESSAGE_TOOL entries (Go's collectMessageToolIDs).
+function collectMessageToolIds(messages) {
+    const ids = new Set();
+    for (const msg of messages) {
+        if (msg.type !== MessageType.MESSAGE_TOOL)
+            continue;
+        for (const tc of msg.toolCalls) {
+            if (tc.id !== "")
+                ids.add(tc.id);
+        }
+    }
+    return ids;
+}
+// Sort by started_at ascending; empty timestamps sort to the end. Mirrors the
+// sort.Slice predicate in emitSnapshotEvents.
+function sortByStartedAt(toolCalls) {
+    return [...toolCalls].sort((a, b) => {
+        if (a.startedAt === "")
+            return 1;
+        if (b.startedAt === "")
+            return -1;
+        return a.startedAt < b.startedAt ? -1 : a.startedAt > b.startedAt ? 1 : 0;
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/resources/stream/snapshot.js.map

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