@stigmer/cli 3.0.8

package/resources/run/epilogue.js

@@ -0,0 +1,144 @@
+// The post-stream epilogue, shared by every renderer (Go's streamAgentEpilogue +
+// run_display_summary.go). After the stream ends we fetch the authoritative final
+// execution and a usage report, then print a compact, copy-paste-friendly exit
+// summary to stderr (AI content already went to stdout). A stream that failed
+// before reaching a phase is re-raised as a CLI error.
+import { create } from "@bufbuild/protobuf";
+import { ExecutionPhase, MessageType, ToolCallStatus } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { GetExecutionUsageReportInputSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { CliExitError, ExitCode } from "../../errors/index.js";
+import { shouldColorize, styler } from "../../output/style.js";
+import { mapPhaseToString } from "../stream/convert.js";
+/**
+ * Fetch the final execution + usage and print the exit summary. Returns the
+ * final execution so the caller can act on its artifacts (e.g. --download).
+ */
+export async function runEpilogue(client, sessionId, executionId, result) {
+    // A stream error before any phase is a hard failure (Go: epilogue returns it).
+    if (result.error !== "" && result.phase === "") {
+        throw new CliExitError(result.error, ExitCode.General);
+    }
+    const exec = await client.agentExecution.get(executionId);
+    const usage = await fetchUsage(client, executionId);
+    const write = (line) => void process.stderr.write(`${line}\n`);
+    const s = styler(shouldColorize(process.stderr));
+    write("");
+    if (sessionId !== "") {
+        printSessionExit(write, s, sessionId, exec, usage);
+    }
+    else {
+        printCompletion(write, s, exec);
+    }
+    return exec;
+}
+// Best-effort usage fetch; a failure here must not fail the run (Go tolerates a
+// nil usage report and renders without the cost line).
+async function fetchUsage(client, executionId) {
+    try {
+        const report = await client.agentExecution.getExecutionUsageReport(create(GetExecutionUsageReportInputSchema, { executionId }));
+        return report.aggregate;
+    }
+    catch {
+        return undefined;
+    }
+}
+// Compact session summary + a copy-paste resume command. Mirrors Go's
+// displaySessionExitLine + sessionResumeVerb.
+function printSessionExit(write, s, sessionId, exec, usage) {
+    const phase = exec.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+    const duration = formatDuration(exec.status?.startedAt ?? "", exec.status?.completedAt ?? "");
+    const cost = usage !== undefined && usage.billableCostMicros > 0n ? formatCost(usage.billableCostMicros) : "";
+    switch (phase) {
+        case ExecutionPhase.EXECUTION_COMPLETED:
+            write(s.green(completedLine(duration, cost)));
+            break;
+        case ExecutionPhase.EXECUTION_FAILED:
+            write(s.red(`✗ Failed: ${resolveFailureError(exec)}`));
+            break;
+        case ExecutionPhase.EXECUTION_CANCELLED:
+            write(s.yellow("Cancelled"));
+            break;
+        case ExecutionPhase.EXECUTION_TERMINATED:
+            write(s.yellow(`Stopped: ${resolveFailureError(exec)}`));
+            break;
+        default:
+            write(s.yellow(`Exited (${mapPhaseToString(phase)})`));
+    }
+    write("");
+    write(`  ${resumeVerb(phase)}  stigmer resume ${sessionId}`);
+}
+// Non-session completion (rare for run; e.g. a degraded backend). Mirrors the
+// information of Go's displayAgentExecutionComplete without the panel chrome.
+function printCompletion(write, s, exec) {
+    const phase = exec.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+    if (phase === ExecutionPhase.EXECUTION_FAILED) {
+        write(s.red(`✗ Execution failed: ${resolveFailureError(exec)}`));
+        return;
+    }
+    write(s.green(`✓ Execution ${mapPhaseToString(phase)}`));
+}
+function completedLine(duration, cost) {
+    if (duration !== "" && cost !== "")
+        return `✓ Completed (${duration} · ${cost})`;
+    if (duration !== "")
+        return `✓ Completed (${duration})`;
+    return "✓ Completed";
+}
+function resumeVerb(phase) {
+    switch (phase) {
+        case ExecutionPhase.EXECUTION_COMPLETED:
+            return "To continue:";
+        case ExecutionPhase.EXECUTION_FAILED:
+            return "To retry:   ";
+        default:
+            return "To resume:  ";
+    }
+}
+// Mirrors Go's resolveFailureError: canonical error, else last system message,
+// else first failed tool call's error, else a generic pointer to the logs.
+function resolveFailureError(exec) {
+    const status = exec.status;
+    if (status === undefined)
+        return GENERIC_FAILURE;
+    if (status.error !== "")
+        return status.error;
+    for (let i = status.messages.length - 1; i >= 0; i--) {
+        const msg = status.messages[i];
+        if (msg.type === MessageType.MESSAGE_SYSTEM && msg.content !== "")
+            return msg.content;
+    }
+    for (const msg of status.messages) {
+        for (const tc of msg.toolCalls) {
+            if (tc.status === ToolCallStatus.TOOL_CALL_FAILED && tc.error !== "")
+                return tc.error;
+        }
+    }
+    return GENERIC_FAILURE;
+}
+const GENERIC_FAILURE = "Execution failed (error details unavailable — check execution logs)";
+// "1m23s"/"45s" between two RFC3339 timestamps, or "" when unknown. Mirrors Go's
+// parseDuration + Round(time.Second).
+function formatDuration(startedAt, completedAt) {
+    if (startedAt === "" || completedAt === "")
+        return "";
+    const start = Date.parse(startedAt);
+    const end = Date.parse(completedAt);
+    if (Number.isNaN(start) || Number.isNaN(end) || end < start)
+        return "";
+    const totalSeconds = Math.round((end - start) / 1000);
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return seconds === 0 ? `${minutes}m` : `${minutes}m${seconds}s`;
+}
+// USD from micros. Mirrors usage.ts's formatCost precision tiers.
+function formatCost(micros) {
+    const usd = Number(micros) / 1_000_000;
+    if (usd === 0)
+        return "$0.00";
+    if (usd < 1)
+        return `$${usd.toFixed(3)}`;
+    return `$${usd.toFixed(2)}`;
+}
+//# sourceMappingURL=epilogue.js.map

package/resources/run/epilogue.js.map

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

package/resources/run/header.d.ts

@@ -0,0 +1,23 @@
+import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+import type { RunMode } from "./prepare.js";
+export interface SessionHeaderInfo {
+    readonly agentName: string;
+    readonly sessionId: string;
+    /** Session subject; shown for resumed sessions, empty for fresh runs. */
+    readonly subject?: string;
+    readonly model: string;
+    readonly mode: RunMode;
+    readonly workspaces: readonly string[];
+}
+/**
+ * Write the session header to `out` (stderr). Empty fields are omitted, exactly
+ * like Go's formatMetadataSection. A header with no populated fields prints
+ * nothing.
+ */
+export declare function renderSessionHeader(out: {
+    write(chunk: string): unknown;
+    isTTY?: boolean;
+}, info: SessionHeaderInfo): void;
+/** Displayable names from workspace entries (Go's workspaceNames). */
+export declare function workspaceNames(entries: readonly WorkspaceEntry[]): string[];
+//# sourceMappingURL=header.d.ts.map

package/resources/run/header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.d.ts","sourceRoot":"","sources":["../../../src/resources/run/header.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AAEjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAKD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAkB1H;AAOD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,EAAE,CAE3E"}

package/resources/run/header.js

@@ -0,0 +1,51 @@
+// The session header shown before a headless stream starts (Go's
+// renderSessionHeader / sessionHeaderInfo in run_display_header.go).
+//
+// Deliberate divergence (clean over chrome): Go renders a lipgloss bordered
+// panel with a side-by-side "recent sessions" column. That panel is TTY
+// eye-candy; the interactive path here is owned by Ink's SessionView, which
+// draws its own header. The only consumers of THIS header are the headless
+// (--json / non-TTY plaintext) paths, where the output target is stderr — a
+// bordered panel there would be noise. So we emit a compact, aligned key/value
+// block carrying the same fields (Agent, Session, Model, Mode, Workspaces).
+import { shouldColorize, styler } from "../../output/style.js";
+// Fixed label column width; sized to the longest label ("Workspaces") + ": ".
+const LABEL_WIDTH = 12;
+/**
+ * Write the session header to `out` (stderr). Empty fields are omitted, exactly
+ * like Go's formatMetadataSection. A header with no populated fields prints
+ * nothing.
+ */
+export function renderSessionHeader(out, info) {
+    const s = styler(shouldColorize(out));
+    const lines = [];
+    if (info.agentName !== "")
+        lines.push(row(s, "Agent", info.agentName));
+    if (info.sessionId !== "")
+        lines.push(row(s, "Session", info.sessionId));
+    if ((info.subject ?? "") !== "")
+        lines.push(row(s, "Subject", info.subject ?? ""));
+    if (info.model !== "")
+        lines.push(row(s, "Model", info.model));
+    // Only "plan" is surfaced; "agent"/"" is the default and stays implicit.
+    if (info.mode === "plan")
+        lines.push(row(s, "Mode", "Plan (read-only)"));
+    if (info.workspaces.length > 0) {
+        lines.push(row(s, "Workspaces", info.workspaces[0]));
+        const indent = " ".repeat(LABEL_WIDTH);
+        for (const ws of info.workspaces.slice(1))
+            lines.push(`${indent}${ws}`);
+    }
+    if (lines.length === 0)
+        return;
+    out.write(`${lines.join("\n")}\n\n`);
+}
+function row(s, label, value) {
+    const padded = `${label}:`.padEnd(LABEL_WIDTH, " ");
+    return `${s.dim(padded)}${value}`;
+}
+/** Displayable names from workspace entries (Go's workspaceNames). */
+export function workspaceNames(entries) {
+    return entries.map((e) => e.name);
+}
+//# sourceMappingURL=header.js.map

package/resources/run/header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header.js","sourceRoot":"","sources":["../../../src/resources/run/header.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,4EAA4E;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAa/D,8EAA8E;AAC9E,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAuD,EAAE,IAAuB;IAClH,MAAM,CAAC,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,SAAS,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,SAAS,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACnF,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/D,yEAAyE;IACzE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACzE,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC/B,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,GAAG,CAAC,CAA4B,EAAE,KAAa,EAAE,KAAa;IACrE,MAAM,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,OAAkC;IAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/resources/run/prepare.d.ts

@@ -0,0 +1,60 @@
+import type { Attachment } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/spec_pb";
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import type { WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+import type { Stigmer } from "@stigmer/sdk";
+import { type ProgressSink } from "./attachments.js";
+import { type RuntimeEnv } from "./env.js";
+/** The interaction mode requested for the run; "" means the agent default. */
+export type RunMode = "" | "agent" | "plan";
+/** Raw agent-execution flags shared by `run` and `draft` (Go's agentExecFlags). */
+export interface AgentExecFlags {
+    readonly message: string;
+    readonly attach: readonly string[];
+    readonly approveDefault: string;
+    readonly verbose: boolean;
+    readonly detach: boolean;
+    readonly workspace: readonly string[];
+    readonly branch: string;
+    readonly commit: string;
+    readonly env: readonly string[];
+    readonly envFile: readonly string[];
+    readonly secret: readonly string[];
+    readonly secretFile: readonly string[];
+    readonly model: string;
+    readonly autoApprove: boolean;
+    readonly mode: RunMode;
+}
+/**
+ * The validated, resolved inputs ready for create + stream. Mirrors Go's
+ * preparedAgentExec, minus the client/org which the command already owns.
+ */
+export interface PreparedRun {
+    readonly defaultAction: ApprovalAction;
+    readonly workspaceEntries: WorkspaceEntry[];
+    readonly runtimeEnv: RuntimeEnv;
+    readonly attachments: Attachment[];
+    readonly workspaceFileRefs: string[];
+    readonly message: string;
+    readonly detach: boolean;
+    readonly verbose: boolean;
+    readonly model: string;
+    readonly autoApproveAll: boolean;
+    readonly mode: RunMode;
+}
+/**
+ * Validate flags and resolve all execution inputs. The `org` is used to inject
+ * STIGMER_ORG_ID and the `client` to upload non-workspace attachments.
+ */
+export declare function prepareAgentExec(flags: AgentExecFlags, client: Stigmer, org: string, progress?: ProgressSink): Promise<PreparedRun>;
+/**
+ * Parse the `--approve-default` flag to an ApprovalAction. Empty means "no
+ * default" (UNSPECIFIED). Mirrors Go's approval.ParseAction, including the
+ * approve-all aliases and case-insensitivity.
+ */
+export declare function parseApprovalAction(value: string): ApprovalAction;
+/**
+ * Validate the `--mode` flag. Empty (unset) is valid and means "use default"
+ * (agent). Mirrors Go's validateMode.
+ */
+export declare function validateMode(mode: string): asserts mode is RunMode;
+//# sourceMappingURL=prepare.d.ts.map

package/resources/run/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/resources/run/prepare.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8DAA8D,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4DAA4D,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAG5D,8EAA8E;AAC9E,MAAM,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAkBjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAIlE"}

package/resources/run/prepare.js

@@ -0,0 +1,78 @@
+// The agent-execution prelude: validate flags and resolve every input the
+// create step needs. Ports the Go CLI's prepareAgentExec (run_agent_exec.go).
+//
+// Order matters and mirrors Go: validate cheap flags first (mode, approve
+// default), then parse workspaces, then merge env, then process attachments
+// (the only step that hits the network). A failure short-circuits before any
+// upload. STIGMER_ORG_ID is injected into the runtime env when absent so agents
+// can address the caller's org without the user wiring it manually.
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { UsageError } from "../../errors/index.js";
+import { processAttachments } from "./attachments.js";
+import { loadAndMergeEnv } from "./env.js";
+import { localWorkspaceRoots, parseWorkspaceEntries } from "./workspace.js";
+/**
+ * Validate flags and resolve all execution inputs. The `org` is used to inject
+ * STIGMER_ORG_ID and the `client` to upload non-workspace attachments.
+ */
+export async function prepareAgentExec(flags, client, org, progress) {
+    const defaultAction = parseApprovalAction(flags.approveDefault);
+    validateMode(flags.mode);
+    const workspaceEntries = parseWorkspaceEntries(flags.workspace, flags.branch, flags.commit);
+    const runtimeEnv = loadAndMergeEnv({
+        envFlags: flags.env,
+        secretFlags: flags.secret,
+        envFiles: flags.envFile,
+        secretFiles: flags.secretFile,
+    });
+    if (runtimeEnv.STIGMER_ORG_ID === undefined && org !== "") {
+        runtimeEnv.STIGMER_ORG_ID = { value: org, isSecret: false };
+    }
+    const { attachments, workspaceFileRefs } = await processAttachments(client.agentExecution, flags.attach, localWorkspaceRoots(workspaceEntries), progress);
+    return {
+        defaultAction,
+        workspaceEntries,
+        runtimeEnv,
+        attachments,
+        workspaceFileRefs,
+        message: flags.message,
+        detach: flags.detach,
+        verbose: flags.verbose,
+        model: flags.model,
+        autoApproveAll: flags.autoApprove,
+        mode: flags.mode,
+    };
+}
+/**
+ * Parse the `--approve-default` flag to an ApprovalAction. Empty means "no
+ * default" (UNSPECIFIED). Mirrors Go's approval.ParseAction, including the
+ * approve-all aliases and case-insensitivity.
+ */
+export function parseApprovalAction(value) {
+    if (value.trim() === "")
+        return ApprovalAction.UNSPECIFIED;
+    switch (value.trim().toLowerCase()) {
+        case "approve":
+            return ApprovalAction.APPROVE;
+        case "skip":
+            return ApprovalAction.SKIP;
+        case "reject":
+            return ApprovalAction.REJECT;
+        case "approve-all":
+        case "approve_all":
+        case "approveall":
+            return ApprovalAction.APPROVE_ALL;
+        default:
+            throw new UsageError(`invalid --approve-default value "${value}": must be one of: approve, skip, reject, approve-all`);
+    }
+}
+/**
+ * Validate the `--mode` flag. Empty (unset) is valid and means "use default"
+ * (agent). Mirrors Go's validateMode.
+ */
+export function validateMode(mode) {
+    if (mode !== "" && mode !== "agent" && mode !== "plan") {
+        throw new UsageError(`invalid --mode value "${mode}": must be "agent" or "plan"`);
+    }
+}
+//# sourceMappingURL=prepare.js.map

package/resources/run/prepare.js.map

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

package/resources/run/resolve.d.ts

@@ -0,0 +1,8 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { Workflow } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
+import type { Stigmer } from "@stigmer/sdk";
+/** Resolve an agent by ID, org/slug, or bare slug. Throws if not found. */
+export declare function resolveAgentRef(client: Stigmer, ref: string, org: string): Promise<Agent>;
+/** Resolve a workflow by ID, org/slug, or bare slug. Throws if not found. */
+export declare function resolveWorkflowRef(client: Stigmer, ref: string, org: string): Promise<Workflow>;
+//# sourceMappingURL=resolve.d.ts.map

package/resources/run/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/resources/run/resolve.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAEtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,2EAA2E;AAC3E,wBAAsB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAI/F;AAED,6EAA6E;AAC7E,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAIrG"}

package/resources/run/resolve.js

@@ -0,0 +1,28 @@
+// Reference resolution for the run path (Go's resolveAgent / resolveWorkflow in
+// run_resolve.go). A reference is an ID (agt_…/wfl_…), an explicit org/slug, or
+// a bare slug resolved against the context org. The strict ID *classification*
+// used by smart dispatch lives in resources/reference.ts; this module just turns
+// a reference into a fetched resource.
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { defaultRegistry } from "../../registry/index.js";
+import { parseReference } from "../reference.js";
+/** Resolve an agent by ID, org/slug, or bare slug. Throws if not found. */
+export async function resolveAgentRef(client, ref, org) {
+    const parsed = parseReference(ref, org, idPrefix(ApiResourceKind.agent));
+    if (parsed.kind === "id")
+        return client.agent.get(parsed.id);
+    return client.agent.getByReference({ org: parsed.org, slug: parsed.slug });
+}
+/** Resolve a workflow by ID, org/slug, or bare slug. Throws if not found. */
+export async function resolveWorkflowRef(client, ref, org) {
+    const parsed = parseReference(ref, org, idPrefix(ApiResourceKind.workflow));
+    if (parsed.kind === "id")
+        return client.workflow.get(parsed.id);
+    return client.workflow.getByReference({ org: parsed.org, slug: parsed.slug });
+}
+// The id_prefix for a kind, via the shared registry (single source of truth).
+function idPrefix(kind) {
+    const alias = kind === ApiResourceKind.agent ? "agent" : "workflow";
+    return defaultRegistry().getByAlias(alias)?.idPrefix ?? "";
+}
+//# sourceMappingURL=resolve.js.map

package/resources/run/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/resources/run/resolve.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,uCAAuC;AAIvC,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AAEtH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAe,EAAE,GAAW,EAAE,GAAW;IAC7E,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAe,EAAE,GAAW,EAAE,GAAW;IAChF,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC5E,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,SAAS,QAAQ,CAAC,IAAqB;IACrC,MAAM,KAAK,GAAG,IAAI,KAAK,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IACpE,OAAO,eAAe,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;AAC7D,CAAC"}

package/resources/run/resume.d.ts

@@ -0,0 +1,13 @@
+import type { BackendClient } from "../../client/index.js";
+import type { RunMode } from "./prepare.js";
+import { type RunOutputMode } from "./stream.js";
+export interface OpenSessionDeps {
+    readonly client: BackendClient;
+    readonly sessionId: string;
+    readonly org: string;
+    /** Explicit --mode override; "" means infer from the latest execution. */
+    readonly mode: RunMode;
+    readonly outputMode: RunOutputMode;
+}
+export declare function openSession(deps: OpenSessionDeps): Promise<void>;
+//# sourceMappingURL=resume.d.ts.map

package/resources/run/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/resources/run/resume.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAO3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAcvE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;CACpC;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCtE"}

package/resources/run/resume.js

@@ -0,0 +1,94 @@
+// Re-opening an existing session (Go's openSession / resumeSession in
+// resume_session.go). Fetch the session + its executions, then either:
+//   - re-attach to the live stream when the latest execution is still active, or
+//   - replay the full history (snapshotToEvents) when everything has finished.
+// The TTY path defers to Ink's SessionView, which loads history and offers a
+// follow-up composer for free.
+import { ApprovalAction, ExecutionPhase, InteractionMode } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { getSessionById, listExecutionsBySession } from "../session.js";
+import { NdjsonRenderer } from "../stream/render-ndjson.js";
+import { PlaintextRenderer } from "../stream/render-plaintext.js";
+import { snapshotToEvents } from "../stream/snapshot.js";
+import { isInkSupported } from "../stream/tty.js";
+import { renderSessionHeader, workspaceNames } from "./header.js";
+import { streamAgentExecution } from "./stream.js";
+// The backend's auto-create sentinel; suppressed in the header until the async
+// title activity replaces it (Go's session.PendingSubject / ResolvedSubject).
+const PENDING_SUBJECT = "Auto-created session";
+// Phases where the latest execution is still producing output — re-attach live.
+const ACTIVE_PHASES = new Set([
+    ExecutionPhase.EXECUTION_PENDING,
+    ExecutionPhase.EXECUTION_IN_PROGRESS,
+    ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL,
+    ExecutionPhase.EXECUTION_PAUSED,
+]);
+export async function openSession(deps) {
+    const stigmer = deps.client.stigmer;
+    const session = await getSessionById(stigmer, deps.sessionId);
+    const entries = await listExecutionsBySession(stigmer, deps.sessionId);
+    if (entries.length === 0) {
+        process.stderr.write(`Session ${deps.sessionId} has no executions\n`);
+        return;
+    }
+    const latest = entries[0];
+    const phase = latest.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+    const effectiveMode = resolveResumeMode(deps.mode, latest);
+    const header = {
+        agentName: "",
+        sessionId: deps.sessionId,
+        subject: resolvedSubject(session.spec?.subject ?? ""),
+        model: "",
+        mode: effectiveMode,
+        workspaces: workspaceNames(session.spec?.workspaceEntries ?? []),
+    };
+    if (ACTIVE_PHASES.has(phase)) {
+        // Live re-attach reuses the exact run streaming stack.
+        await streamAgentExecution({
+            client: stigmer,
+            sessionId: deps.sessionId,
+            executionId: latest.metadata?.id ?? "",
+            org: deps.org,
+            mode: effectiveMode,
+            defaultAction: ApprovalAction.UNSPECIFIED,
+            outputMode: deps.outputMode,
+            header,
+        });
+        return;
+    }
+    await replaySession(deps, entries, header);
+}
+// Completed session: render the stored history. TTY → Ink (history + composer);
+// headless → snapshot events through the matching renderer.
+async function replaySession(deps, entries, header) {
+    if (deps.outputMode === "inline" && isInkSupported(process.stdout)) {
+        const { runInkSession } = await import("../stream/ink.js");
+        await runInkSession({
+            client: deps.client.stigmer,
+            sessionId: deps.sessionId,
+            org: deps.org,
+            mode: header.mode === "plan" ? "plan" : "agent",
+        });
+        return;
+    }
+    renderSessionHeader(process.stderr, header);
+    const chronological = [...entries].reverse();
+    const events = snapshotToEvents(chronological);
+    const renderer = deps.outputMode === "json"
+        ? new NdjsonRenderer({ data: process.stdout, status: process.stderr, defaultAction: ApprovalAction.UNSPECIFIED })
+        : new PlaintextRenderer({ data: process.stdout, status: process.stderr });
+    for (const event of events)
+        renderer.render(event);
+}
+// Mirrors Go's resolveResumeMode: --mode wins; else infer "plan" from the last
+// execution's InteractionMode; else default (agent).
+function resolveResumeMode(explicit, latest) {
+    if (explicit !== "")
+        return explicit;
+    if (latest.spec?.executionConfig?.interactionMode === InteractionMode.PLAN)
+        return "plan";
+    return "";
+}
+function resolvedSubject(subject) {
+    return subject === PENDING_SUBJECT ? "" : subject;
+}
+//# sourceMappingURL=resume.js.map

package/resources/run/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../src/resources/run/resume.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,uEAAuE;AACvE,iFAAiF;AACjF,+EAA+E;AAC/E,6EAA6E;AAC7E,+BAA+B;AAG/B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAC;AAE/H,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAA0B,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAC;AAEvE,+EAA+E;AAC/E,8EAA8E;AAC9E,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C,gFAAgF;AAChF,MAAM,aAAa,GAAgC,IAAI,GAAG,CAAC;IACzD,cAAc,CAAC,iBAAiB;IAChC,cAAc,CAAC,qBAAqB;IACpC,cAAc,CAAC,8BAA8B;IAC7C,cAAc,CAAC,gBAAgB;CAChC,CAAC,CAAC;AAWH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IACpC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,SAAS,sBAAsB,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,cAAc,CAAC,2BAA2B,CAAC;IACjF,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAsB;QAChC,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;QACrD,KAAK,EAAE,EAAE;QACT,IAAI,EAAE,aAAa;QACnB,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,gBAAgB,IAAI,EAAE,CAAC;KACjE,CAAC;IAEF,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,uDAAuD;QACvD,MAAM,oBAAoB,CAAC;YACzB,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,aAAa;YACnB,aAAa,EAAE,cAAc,CAAC,WAAW;YACzC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM;SACP,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,gFAAgF;AAChF,4DAA4D;AAC5D,KAAK,UAAU,aAAa,CAC1B,IAAqB,EACrB,OAAkC,EAClC,MAAyB;IAEzB,IAAI,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QAC3D,MAAM,aAAa,CAAC;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;SAChD,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,mBAAmB,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,QAAQ,GACZ,IAAI,CAAC,UAAU,KAAK,MAAM;QACxB,CAAC,CAAC,IAAI,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,CAAC,WAAW,EAAE,CAAC;QACjH,CAAC,CAAC,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,qDAAqD;AACrD,SAAS,iBAAiB,CAAC,QAAiB,EAAE,MAAsB;IAClE,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACrC,IAAI,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,eAAe,KAAK,eAAe,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC1F,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,OAAO,KAAK,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACpD,CAAC"}

package/resources/run/stream.d.ts

@@ -0,0 +1,24 @@
+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 { Stigmer } from "@stigmer/sdk";
+import { type SessionHeaderInfo } from "./header.js";
+import type { RunMode } from "./prepare.js";
+/** The user-selected output mode for a streaming command. */
+export type RunOutputMode = "inline" | "json";
+export interface StreamDeps {
+    readonly client: Stigmer;
+    readonly sessionId: string;
+    readonly executionId: string;
+    /** Org slug, for follow-up executions created from the Ink composer. */
+    readonly org: string;
+    readonly mode: RunMode;
+    readonly defaultAction: ApprovalAction;
+    readonly outputMode: RunOutputMode;
+    readonly header: SessionHeaderInfo;
+}
+/**
+ * Stream the execution to a terminal phase, then run the epilogue. Returns the
+ * authoritative final execution (for artifact download).
+ */
+export declare function streamAgentExecution(deps: StreamDeps): Promise<AgentExecution>;
+//# sourceMappingURL=stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../../src/resources/run/stream.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAE9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAgBpF"}