@stigmer/cli 3.0.8

package/resources/execution-format.d.ts

@@ -0,0 +1,12 @@
+import { WorkflowTaskType } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+/**
+ * Human duration between two ISO 8601 timestamps. Mirrors Go's calculateDuration:
+ * "-" when either bound is missing/unparseable, "<n>s" under a minute,
+ * "<m>m <s>s" under an hour, "<h>h <m>m" otherwise.
+ */
+export declare function calculateDuration(start: string, end: string): string;
+/** Truncate to `maxLen`, appending "..." when cut. Mirrors Go's display.TruncateWithEllipsis. */
+export declare function truncateWithEllipsis(value: string, maxLen: number): string;
+/** Short workflow task-type label. Mirrors Go's formatWorkflowTaskType. */
+export declare function formatWorkflowTaskType(type: WorkflowTaskType): string;
+//# sourceMappingURL=execution-format.d.ts.map

package/resources/execution-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-format.d.ts","sourceRoot":"","sources":["../../src/resources/execution-format.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iEAAiE,CAAC;AAEnG;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI1E;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAmBrE"}

package/resources/execution-format.js

@@ -0,0 +1,56 @@
+// Shared, presentation-only formatters for execution output.
+//
+// These mirror helpers in Go's pkg/display + internal/cli/execution (duration
+// math, ellipsis truncation, workflow task-type labels). They live here, away
+// from any RPC code, so both `execution trace` and the `run workflow` epilogue
+// format durations and task types identically without duplicating the logic.
+import { WorkflowTaskType } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+/**
+ * Human duration between two ISO 8601 timestamps. Mirrors Go's calculateDuration:
+ * "-" when either bound is missing/unparseable, "<n>s" under a minute,
+ * "<m>m <s>s" under an hour, "<h>h <m>m" otherwise.
+ */
+export function calculateDuration(start, end) {
+    if (start === "" || end === "")
+        return "-";
+    const startMs = Date.parse(start);
+    const endMs = Date.parse(end);
+    if (Number.isNaN(startMs) || Number.isNaN(endMs))
+        return "-";
+    const totalSeconds = Math.floor((endMs - startMs) / 1000);
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    if (totalSeconds < 3600)
+        return `${Math.floor(totalSeconds / 60)}m ${totalSeconds % 60}s`;
+    return `${Math.floor(totalSeconds / 3600)}h ${Math.floor((totalSeconds % 3600) / 60)}m`;
+}
+/** Truncate to `maxLen`, appending "..." when cut. Mirrors Go's display.TruncateWithEllipsis. */
+export function truncateWithEllipsis(value, maxLen) {
+    if (value.length <= maxLen)
+        return value;
+    if (maxLen <= 3)
+        return value.slice(0, maxLen);
+    return `${value.slice(0, maxLen - 3)}...`;
+}
+/** Short workflow task-type label. Mirrors Go's formatWorkflowTaskType. */
+export function formatWorkflowTaskType(type) {
+    switch (type) {
+        case WorkflowTaskType.WORKFLOW_TASK_AGENT_INVOCATION:
+            return "agent";
+        case WorkflowTaskType.WORKFLOW_TASK_APPROVAL:
+            return "approval";
+        case WorkflowTaskType.WORKFLOW_TASK_API_CALL:
+            return "api_call";
+        case WorkflowTaskType.WORKFLOW_TASK_CONDITIONAL:
+            return "condition";
+        case WorkflowTaskType.WORKFLOW_TASK_PARALLEL:
+            return "parallel";
+        case WorkflowTaskType.WORKFLOW_TASK_TRANSFORM:
+            return "transform";
+        case WorkflowTaskType.WORKFLOW_TASK_CUSTOM:
+            return "custom";
+        default:
+            return "unknown";
+    }
+}
+//# sourceMappingURL=execution-format.js.map

package/resources/execution-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-format.js","sourceRoot":"","sources":["../../src/resources/execution-format.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iEAAiE,CAAC;AAEnG;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,GAAW;IAC1D,IAAI,KAAK,KAAK,EAAE,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE7D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,IAAI,YAAY,GAAG,EAAE;QAAE,OAAO,GAAG,YAAY,GAAG,CAAC;IACjD,IAAI,YAAY,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC,KAAK,YAAY,GAAG,EAAE,GAAG,CAAC;IAC1F,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;AAC1F,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,MAAc;IAChE,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IACzC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB,CAAC,8BAA8B;YAClD,OAAO,OAAO,CAAC;QACjB,KAAK,gBAAgB,CAAC,sBAAsB;YAC1C,OAAO,UAAU,CAAC;QACpB,KAAK,gBAAgB,CAAC,sBAAsB;YAC1C,OAAO,UAAU,CAAC;QACpB,KAAK,gBAAgB,CAAC,yBAAyB;YAC7C,OAAO,WAAW,CAAC;QACrB,KAAK,gBAAgB,CAAC,sBAAsB;YAC1C,OAAO,UAAU,CAAC;QACpB,KAAK,gBAAgB,CAAC,uBAAuB;YAC3C,OAAO,WAAW,CAAC;QACrB,KAAK,gBAAgB,CAAC,oBAAoB;YACxC,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/resources/execution-logs.d.ts

@@ -0,0 +1,16 @@
+import type { Stigmer } from "@stigmer/sdk";
+import { type LineSink } from "./stream/workflow-render-plaintext.js";
+export interface LogsOptions {
+    readonly executionId: string;
+    readonly follow: boolean;
+    /** Workflow-only: filter events by task name. */
+    readonly task?: string;
+}
+/** A line sink + a signal that the caller can abort (SIGINT). */
+export interface LogsStreams {
+    readonly out: LineSink;
+    readonly colorize: boolean;
+}
+/** Stream or print logs for an execution. `signal` aborts a follow cleanly. */
+export declare function streamExecutionLogs(client: Stigmer, opts: LogsOptions, signal: AbortSignal, streams?: LogsStreams): Promise<void>;
+//# sourceMappingURL=execution-logs.d.ts.map

package/resources/execution-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-logs.d.ts","sourceRoot":"","sources":["../../src/resources/execution-logs.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,KAAK,QAAQ,EAAgC,MAAM,uCAAuC,CAAC;AAKpG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,+EAA+E;AAC/E,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,WAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/resources/execution-logs.js

@@ -0,0 +1,132 @@
+// `execution logs` — event/message stream for an execution (agent or workflow).
+//
+// Mirrors Go's execution.WorkflowLogs + AgentLogs (logs_workflow.go /
+// logs_agent.go). The two execution families consume different primitives, and
+// that asymmetry is intentional:
+//
+//   - Workflows have a canonical, sequenced event log. Non-follow reads it via
+//     getEventLog (paginated); follow tails it via subscribeEvents. Both render
+//     through the shared workflow event renderer, so `logs` and `run workflow`
+//     speak the same vocabulary.
+//   - Agents have no event stream — only status snapshots (subscribe). So agent
+//     follow diffs the message list across snapshots (lastMsgCount) and stops on
+//     a terminal phase, exactly as Go does; non-follow prints the message list
+//     from a single Get.
+//
+// Ctrl-C ends a follow cleanly: the SIGINT aborts the subscription and we treat
+// the abort as a normal exit (no stack trace).
+import { create } from "@bufbuild/protobuf";
+import { ExecutionPhase, MessageType } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { GetEventLogRequestSchema, SubscribeEventsRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { shouldColorize, styler } from "../output/style.js";
+import { formatAgentPhase, isTerminalAgentPhase, resolveExecutionType } from "./execution.js";
+import { renderWorkflowEventPlaintext } from "./stream/workflow-render-plaintext.js";
+const EVENT_LOG_PAGE_SIZE = 50;
+const MAX_AGENT_MESSAGE_LEN = 200;
+/** Stream or print logs for an execution. `signal` aborts a follow cleanly. */
+export async function streamExecutionLogs(client, opts, signal, streams = defaultStreams()) {
+    const type = resolveExecutionType(opts.executionId);
+    if (type === "workflow") {
+        await (opts.follow ? followWorkflowLogs(client, opts, signal, streams) : printWorkflowLog(client, opts, streams));
+        return;
+    }
+    await (opts.follow ? followAgentLogs(client, opts, signal, streams) : printAgentMessages(client, opts, streams));
+}
+async function printWorkflowLog(client, opts, streams) {
+    const resp = await client.workflowExecution.getEventLog(create(GetEventLogRequestSchema, {
+        executionId: opts.executionId,
+        pageSize: EVENT_LOG_PAGE_SIZE,
+        ...(opts.task ? { taskName: opts.task } : {}),
+    }));
+    if (resp.events.length === 0) {
+        streams.out.write("No events recorded for this execution.\n");
+        return;
+    }
+    for (const event of resp.events)
+        renderWorkflowEventPlaintext(event, streams.out, streams.colorize);
+    if (resp.hasMore) {
+        streams.out.write(`\n... more events available (showing first ${resp.events.length})\n`);
+    }
+}
+async function followWorkflowLogs(client, opts, signal, streams) {
+    const stream = client.workflowExecution.subscribeEvents(create(SubscribeEventsRequestSchema, { executionId: opts.executionId }), signal);
+    try {
+        for await (const event of stream) {
+            // Client-side task filter, matching Go's streamWorkflowEvents.
+            if (opts.task !== undefined && opts.task !== "" && event.taskName !== opts.task)
+                continue;
+            renderWorkflowEventPlaintext(event, streams.out, streams.colorize);
+        }
+        streams.out.write("\n--- stream ended ---\n");
+    }
+    catch (error) {
+        if (signal.aborted)
+            return;
+        throw error;
+    }
+}
+async function printAgentMessages(client, opts, streams) {
+    const exec = await client.agentExecution.get(opts.executionId);
+    const messages = exec.status?.messages ?? [];
+    if (messages.length === 0) {
+        streams.out.write("No messages recorded for this execution.\n");
+        return;
+    }
+    for (const message of messages)
+        renderAgentMessage(message, streams);
+}
+async function followAgentLogs(client, opts, signal, streams) {
+    let lastMsgCount = 0;
+    try {
+        for await (const exec of client.agentExecution.subscribe(opts.executionId, signal)) {
+            const messages = exec.status?.messages ?? [];
+            for (let i = lastMsgCount; i < messages.length; i++)
+                renderAgentMessage(messages[i], streams);
+            lastMsgCount = messages.length;
+            const phase = exec.status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+            if (isTerminalAgentPhase(phase)) {
+                const style = styler(streams.colorize);
+                streams.out.write(`\n${style.dim("[end]")} execution ${formatAgentPhase(phase)}\n`);
+                return;
+            }
+        }
+        streams.out.write("\n--- stream ended ---\n");
+    }
+    catch (error) {
+        if (signal.aborted)
+            return;
+        throw error;
+    }
+}
+// Port of Go's renderAgentMessage: a colored type label + truncated content.
+function renderAgentMessage(message, streams) {
+    const style = styler(streams.colorize);
+    const { label, tint } = agentMessageLabel(message.type, style);
+    const content = truncate(message.content, MAX_AGENT_MESSAGE_LEN);
+    streams.out.write(`[${tint(label)}] ${content}\n`);
+}
+function agentMessageLabel(type, style) {
+    switch (type) {
+        case MessageType.MESSAGE_HUMAN:
+            return { label: "human", tint: style.cyan };
+        case MessageType.MESSAGE_AI:
+            return { label: "ai", tint: style.green };
+        case MessageType.MESSAGE_TOOL:
+            return { label: "tool", tint: style.cyan };
+        case MessageType.MESSAGE_SYSTEM:
+            return { label: "system", tint: style.yellow };
+        default:
+            return { label: "unknown", tint: style.dim };
+    }
+}
+// Mirrors Go's 200-char content cap (197 + "...").
+function truncate(value, maxLen) {
+    return value.length > maxLen ? `${value.slice(0, maxLen - 3)}...` : value;
+}
+function defaultStreams() {
+    return {
+        out: { write: (line) => void process.stdout.write(line) },
+        colorize: shouldColorize(process.stdout),
+    };
+}
+//# sourceMappingURL=execution-logs.js.map

package/resources/execution-logs.js.map

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

package/resources/execution-trace.d.ts

@@ -0,0 +1,10 @@
+import type { Stigmer } from "@stigmer/sdk";
+/** Output format for trace: a compact structure table, or the full proto envelope. */
+export type TraceFormat = "table" | "yaml" | "json";
+export interface TraceStreams {
+    write(text: string): void;
+    readonly colorize: boolean;
+}
+/** Fetch and render an execution's structure. */
+export declare function traceExecution(client: Stigmer, executionId: string, format: TraceFormat, streams?: TraceStreams): Promise<void>;
+//# sourceMappingURL=execution-trace.d.ts.map

package/resources/execution-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-trace.d.ts","sourceRoot":"","sources":["../../src/resources/execution-trace.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,iDAAiD;AACjD,wBAAsB,cAAc,CAClC,MAAM,EAAE,OAAO,EACf,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,YAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/resources/execution-trace.js

@@ -0,0 +1,125 @@
+// `execution trace` — task/tool structure and timing for an execution.
+//
+// Mirrors Go's execution.Trace (trace.go + trace_workflow.go + trace_agent.go):
+// auto-detect the type, and for table output render a compact structure view —
+// workflow task rows (status icon, name, duration, type, error) or the agent's
+// tool-call timeline. For yaml/json, defer to the standard proto renderers so
+// `trace -o json` and `get -o json` produce the identical envelope.
+import { MessageType } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { AgentExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { WorkflowExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import { WorkflowTaskStatus } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { renderProtoJson, renderProtoYaml } from "../output/index.js";
+import { shouldColorize, styler } from "../output/style.js";
+import { calculateDuration, formatWorkflowTaskType, truncateWithEllipsis } from "./execution-format.js";
+import { formatAgentPhase, formatWorkflowPhase, resolveExecutionType } from "./execution.js";
+/** Fetch and render an execution's structure. */
+export async function traceExecution(client, executionId, format, streams = defaultStreams()) {
+    if (resolveExecutionType(executionId) === "workflow") {
+        const exec = await client.workflowExecution.get(executionId);
+        if (format === "yaml") {
+            streams.write(renderProtoYaml(WorkflowExecutionSchema, exec));
+            return;
+        }
+        if (format === "json") {
+            streams.write(renderProtoJson(WorkflowExecutionSchema, exec));
+            return;
+        }
+        renderWorkflowTrace(exec, streams);
+        return;
+    }
+    const exec = await client.agentExecution.get(executionId);
+    if (format === "yaml") {
+        streams.write(renderProtoYaml(AgentExecutionSchema, exec));
+        return;
+    }
+    if (format === "json") {
+        streams.write(renderProtoJson(AgentExecutionSchema, exec));
+        return;
+    }
+    renderAgentTrace(exec, streams);
+}
+function renderWorkflowTrace(exec, streams) {
+    const style = styler(streams.colorize);
+    const name = exec.metadata?.name || exec.metadata?.id || "";
+    const phase = formatWorkflowPhase(exec.status?.phase ?? 0);
+    const duration = calculateDuration(exec.status?.startedAt ?? "", exec.status?.completedAt ?? "");
+    streams.write(`\nWorkflow: ${name} (${phase}, ${duration})\n\n`);
+    const tasks = exec.status?.tasks ?? [];
+    if (tasks.length === 0) {
+        streams.write("  (no tasks recorded)\n\n");
+        return;
+    }
+    for (const task of tasks)
+        renderWorkflowTraceTask(task, style, streams);
+    streams.write("\n");
+}
+function renderWorkflowTraceTask(task, style, streams) {
+    const icon = workflowTaskStatusIcon(task.status, style);
+    const taskName = task.taskName || task.taskId;
+    const duration = calculateDuration(task.startedAt, task.completedAt);
+    const taskType = style.dim(formatWorkflowTaskType(task.taskType));
+    streams.write(`  ${icon} ${pad(truncateWithEllipsis(taskName, 25), 25)}  ${pad(duration, 8)}  ${taskType}\n`);
+    if (task.error !== "") {
+        streams.write(`       ${style.red(truncateWithEllipsis(task.error, 70))}\n`);
+    }
+}
+function workflowTaskStatusIcon(status, style) {
+    switch (status) {
+        case WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED:
+            return style.green("[done]");
+        case WorkflowTaskStatus.WORKFLOW_TASK_IN_PROGRESS:
+            return style.cyan("[run ]");
+        case WorkflowTaskStatus.WORKFLOW_TASK_PENDING:
+            return style.dim("[    ]");
+        case WorkflowTaskStatus.WORKFLOW_TASK_FAILED:
+            return style.red("[fail]");
+        case WorkflowTaskStatus.WORKFLOW_TASK_SKIPPED:
+            return style.dim("[skip]");
+        case WorkflowTaskStatus.WORKFLOW_TASK_WAITING_APPROVAL:
+            return style.yellow("[wait]");
+        default:
+            return "[ ?? ]";
+    }
+}
+function renderAgentTrace(exec, streams) {
+    const style = styler(streams.colorize);
+    const name = exec.metadata?.name || exec.metadata?.id || "";
+    const phase = formatAgentPhase(exec.status?.phase ?? 0);
+    const duration = calculateDuration(exec.status?.startedAt ?? "", exec.status?.completedAt ?? "");
+    streams.write(`\nAgent: ${name} (${phase}, ${duration})\n\n`);
+    const messages = exec.status?.messages ?? [];
+    if (messages.length === 0) {
+        streams.write("  (no messages recorded)\n\n");
+        return;
+    }
+    const toolCalls = extractToolCallSummaries(exec);
+    if (toolCalls.length === 0) {
+        streams.write(`  ${messages.length} message(s), no tool calls\n\n`);
+        return;
+    }
+    for (const call of toolCalls) {
+        streams.write(`  ${style.green("[done]")} ${pad(truncateWithEllipsis(call.name, 25), 25)}  ${style.dim(truncateWithEllipsis(call.summary, 40))}\n`);
+    }
+    streams.write("\n");
+}
+// Mirrors Go's extractToolCallSummary: tool calls on AI messages, with results
+// truncated to 40 chars.
+function extractToolCallSummaries(exec) {
+    const calls = [];
+    for (const message of exec.status?.messages ?? []) {
+        if (message.type !== MessageType.MESSAGE_AI)
+            continue;
+        for (const tc of message.toolCalls) {
+            calls.push({ name: tc.name || "tool_call", summary: truncateWithEllipsis(tc.result, 40) });
+        }
+    }
+    return calls;
+}
+function pad(value, width) {
+    return value.length >= width ? value : value + " ".repeat(width - value.length);
+}
+function defaultStreams() {
+    return { write: (text) => void process.stdout.write(text), colorize: shouldColorize(process.stdout) };
+}
+//# sourceMappingURL=execution-trace.js.map

package/resources/execution-trace.js.map

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

package/resources/execution.d.ts

@@ -0,0 +1,59 @@
+import { type AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { ExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ExecutionPhase as WorkflowExecutionPhase } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import type { Stigmer } from "@stigmer/sdk";
+import type { OutputFormat } from "../output/index.js";
+import type { ResourceResult } from "./get-bindings.js";
+/** True if `ref` is an agent-execution ID (`aex_…` or `aex-…`, case-sensitive). */
+export declare function isAgentExecutionId(ref: string): boolean;
+/** True if `ref` is a workflow-execution ID (`wex_…` or `wex-…`, case-sensitive). */
+export declare function isWorkflowExecutionId(ref: string): boolean;
+/** True when an agent phase is terminal (no further transitions). Mirrors Go's isTerminalAgentPhase. */
+export declare function isTerminalAgentPhase(phase: ExecutionPhase): boolean;
+export interface CancelExecutionResult {
+    readonly execution: AgentExecution;
+    /** True when the execution was already terminal, so no cancel was issued. */
+    readonly wasAlreadyTerminal: boolean;
+}
+/**
+ * Cancel an agent execution, surfacing whether it was already in a terminal
+ * state. Mirrors Go's execution.CancelWithResult: Get first to read the phase,
+ * short-circuit if terminal, otherwise issue the cancel. Keeping the Get means
+ * the success/already-terminal distinction is decided client-side from
+ * authoritative state rather than from the cancel RPC's response alone.
+ */
+export declare function cancelAgentExecution(client: Stigmer, id: string): Promise<CancelExecutionResult>;
+/**
+ * True for the `execution` type-alias family. Executions bypass the resource
+ * registry (they're addressed by `aex_`/`wex_` ID, not slug), so callers route
+ * on this predicate before the registry lookup — mirroring Go's command layer.
+ */
+export declare function isExecutionAlias(type: string): boolean;
+/** Agent (`aex_`) vs workflow (`wex_`) execution — the two controller families. */
+export type ExecutionType = "agent" | "workflow";
+/**
+ * Resolve an execution ID to its type by prefix. Mirrors Go's
+ * execution.ResolveType, including the multi-line guidance on an unrecognized
+ * format. Surfaced as a usage error (bad user input).
+ */
+export declare function resolveExecutionType(id: string): ExecutionType;
+/** Fetch a single execution (agent or workflow) by ID, with its schema. */
+export declare function getExecution(client: Stigmer, id: string): Promise<ResourceResult>;
+/** List agent executions for the current context, paginated by `limit`. */
+export declare function listAgentExecutions(client: Stigmer, limit: number): Promise<ResourceResult>;
+/** List workflow executions for the current context, paginated by `limit`. */
+export declare function listWorkflowExecutions(client: Stigmer, limit: number): Promise<ResourceResult>;
+/** Render an execution list (json/yaml = full envelope; table = grid). */
+export declare function renderExecutionList(result: ResourceResult, format: OutputFormat, type: ExecutionType): string;
+/** Human-readable agent-execution phase, matching Go's execution.FormatPhase. */
+export declare function formatAgentPhase(phase: ExecutionPhase): string;
+/**
+ * Human-readable workflow-execution phase, matching Go's
+ * execution.FormatWorkflowPhase. Workflow phases live in a *different* proto
+ * package than agent phases (the enum values differ — workflow TERMINATED is 6,
+ * agent TERMINATED is 8), so this is a deliberately separate mapping rather than
+ * a shared one. Workflows have no WAITING_FOR_APPROVAL phase (approval is a task
+ * status, not an execution phase).
+ */
+export declare function formatWorkflowPhase(phase: WorkflowExecutionPhase): string;
+//# sourceMappingURL=execution.d.ts.map

package/resources/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/resources/execution.ts"],"names":[],"mappings":"AAaA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,6DAA6D,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAO9F,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,iEAAiE,CAAC;AAK3H,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1D;AAkBD,wGAAwG;AACxG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAEnE;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAQtG;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAS9D;AAED,2EAA2E;AAC3E,wBAAsB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAKvF;AAED,2EAA2E;AAC3E,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAGjG;AAED,8EAA8E;AAC9E,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAGpG;AAwBD,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAG7G;AAaD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAqB9D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAmBzE"}