@stigmer/cli 3.0.8

package/resources/run/stream.js

@@ -0,0 +1,80 @@
+// Renderer dispatch for a created execution (Go's streamAgentExecution in
+// run_stream.go). One of three paths is selected from the output mode and TTY:
+//
+//   --json            → headless NDJSON differ (stdout), Go's run --json taxonomy
+//   inline + TTY      → in-process Ink (SessionView), lazily imported
+//   inline + non-TTY  → headless plaintext differ (piped stdout)
+//
+// All three converge on the same epilogue (final Get + usage summary). The
+// headless paths share one driver (runHeadlessStream) over the SDK's
+// agentExecution.subscribe / submitApproval; the differ + renderers are the
+// CLI-local port of Go's streamToEvents + handleJSONEvent.
+import { create } from "@bufbuild/protobuf";
+import { SubmitApprovalInputSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { runEpilogue } from "./epilogue.js";
+import { renderSessionHeader } from "./header.js";
+import { runHeadlessStream } from "../stream/headless.js";
+import { NdjsonRenderer } from "../stream/render-ndjson.js";
+import { PlaintextRenderer } from "../stream/render-plaintext.js";
+import { isInkSupported } from "../stream/tty.js";
+/**
+ * Stream the execution to a terminal phase, then run the epilogue. Returns the
+ * authoritative final execution (for artifact download).
+ */
+export async function streamAgentExecution(deps) {
+    if (deps.outputMode === "json") {
+        renderSessionHeader(process.stderr, deps.header);
+        const result = await runHeadless(deps, jsonRenderer(deps));
+        return runEpilogue(deps.client, deps.sessionId, deps.executionId, result);
+    }
+    if (isInkSupported(process.stdout)) {
+        await runInk(deps);
+        // Ink owns the live view; the epilogue still prints the exit summary.
+        return runEpilogue(deps.client, deps.sessionId, deps.executionId, { phase: "", error: "" });
+    }
+    renderSessionHeader(process.stderr, deps.header);
+    const result = await runHeadless(deps, plaintextRenderer());
+    return runEpilogue(deps.client, deps.sessionId, deps.executionId, result);
+}
+function jsonRenderer(deps) {
+    return new NdjsonRenderer({ data: process.stdout, status: process.stderr, defaultAction: deps.defaultAction });
+}
+function plaintextRenderer() {
+    return new PlaintextRenderer({ data: process.stdout, status: process.stderr });
+}
+// Drive a headless renderer over the SDK stream, with Ctrl-C wired to abort the
+// subscription cleanly (Go cancels the stream context on signal; the driver
+// treats an aborted signal as a clean exit and the epilogue prints the phase).
+async function runHeadless(deps, renderer) {
+    const controller = new AbortController();
+    const onSignal = () => controller.abort();
+    process.once("SIGINT", onSignal);
+    process.once("SIGTERM", onSignal);
+    try {
+        return await runHeadlessStream({
+            subscribe: (signal) => deps.client.agentExecution.subscribe(deps.executionId, signal),
+            submitApproval: async (toolCallId, action) => {
+                await deps.client.agentExecution.submitApproval(create(SubmitApprovalInputSchema, { agentExecutionId: deps.executionId, toolCallId, action }));
+            },
+            renderer,
+            sessionId: deps.sessionId,
+            signal: controller.signal,
+        });
+    }
+    finally {
+        process.removeListener("SIGINT", onSignal);
+        process.removeListener("SIGTERM", onSignal);
+    }
+}
+// Lazily import the Ink renderer so React/Ink load only on the interactive path
+// (DD-001 boundary — non-streaming commands and --help never pay for them).
+async function runInk(deps) {
+    const { runInkSession } = await import("../stream/ink.js");
+    await runInkSession({
+        client: deps.client,
+        sessionId: deps.sessionId,
+        org: deps.org,
+        mode: deps.mode === "plan" ? "plan" : "agent",
+    });
+}
+//# sourceMappingURL=stream.js.map

package/resources/run/stream.js.map

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

package/resources/run/workflow-stream.d.ts

@@ -0,0 +1,25 @@
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import type { WorkflowExecution } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/api_pb";
+import type { Stigmer } from "@stigmer/sdk";
+/** Output mode for the run stream: human (inline) lines or NDJSON. */
+export type RunOutputMode = "inline" | "json";
+export interface WorkflowStreamDeps {
+    readonly client: Stigmer;
+    readonly executionId: string;
+    readonly outputMode: RunOutputMode;
+    /** Approval policy: APPROVE_ALL when --auto-approve, else --approve-default (or UNSPECIFIED). */
+    readonly defaultAction: ApprovalAction;
+}
+/** Output sinks; defaults to stdout (events) + stderr (notices/summary). */
+export interface WorkflowStreamStreams {
+    data(line: string): void;
+    status(line: string): void;
+    readonly colorize: boolean;
+}
+/**
+ * Stream a workflow execution to a terminal state, then print a summary. Returns
+ * the authoritative final execution (a final Get), mirroring the agent path's
+ * return for symmetry. Ctrl-C aborts the subscription cleanly.
+ */
+export declare function streamWorkflowExecution(deps: WorkflowStreamDeps, streams?: WorkflowStreamStreams): Promise<WorkflowExecution>;
+//# sourceMappingURL=workflow-stream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-stream.d.ts","sourceRoot":"","sources":["../../../src/resources/run/workflow-stream.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,cAAc,EAAE,MAAM,8DAA8D,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,gEAAgE,CAAC;AAOtH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAS5C,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,iGAAiG;IACjG,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;CACxC;AAED,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,qBAAwC,GAChD,OAAO,CAAC,iBAAiB,CAAC,CAyB5B"}

package/resources/run/workflow-stream.js

@@ -0,0 +1,152 @@
+// Live `run workflow` streaming over the canonical WorkflowExecutionEvent stream.
+//
+// Unlike the agent path (which has only status snapshots and so must diff them —
+// see resources/stream/headless.ts), WorkflowExecution exposes subscribeEvents:
+// an incremental, sequenced, persisted event stream with explicit terminal
+// markers. A live run view *is* a timeline view, so we consume that stream
+// directly and render through the shared workflow event renderer (B1). This is
+// why `run workflow`, `execution logs`, and the web execution viewer all speak
+// the same event vocabulary — the server's — instead of a CLI-private one.
+//
+// Mirrors the *behavior* of Go's streamWorkflowExecution (run_stream.go): render
+// progress, resolve bubbled tool approvals via the run's approval policy, stop on
+// a terminal state, then print a completion summary. It diverges deliberately on
+// the source primitive (events, not snapshots) and on approvals: per the shipped
+// decision, workflows have no inline raw-mode prompter, so an approval is either
+// resolved by the configured policy (--approve-default / --auto-approve) or left
+// for the user to resolve out-of-band via `stigmer execution approve`.
+import { create } from "@bufbuild/protobuf";
+import { ApprovalAction } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ExecutionPhase, WorkflowTaskStatus } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/enum_pb";
+import { SubmitWorkflowApprovalInputSchema, SubscribeEventsRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { shouldColorize, styler } from "../../output/style.js";
+import { calculateDuration } from "../execution-format.js";
+import { formatWorkflowPhase } from "../execution.js";
+import { APPROVAL_RETRY_BASE_DELAY_MS, APPROVAL_RETRY_MAX_ATTEMPTS, retryWithBackoff } from "../stream/submit.js";
+import { toWorkflowEventView } from "../stream/workflow-event-view.js";
+import { renderWorkflowEventPlaintext } from "../stream/workflow-render-plaintext.js";
+import { workflowEventToNdjson } from "../stream/workflow-render-ndjson.js";
+/**
+ * Stream a workflow execution to a terminal state, then print a summary. Returns
+ * the authoritative final execution (a final Get), mirroring the agent path's
+ * return for symmetry. Ctrl-C aborts the subscription cleanly.
+ */
+export async function streamWorkflowExecution(deps, streams = defaultStreams()) {
+    const controller = new AbortController();
+    const onSignal = () => controller.abort();
+    process.once("SIGINT", onSignal);
+    process.once("SIGTERM", onSignal);
+    const resolved = new Set();
+    try {
+        const stream = deps.client.workflowExecution.subscribeEvents(create(SubscribeEventsRequestSchema, { executionId: deps.executionId }), controller.signal);
+        for await (const event of stream) {
+            renderEvent(event, deps.outputMode, streams);
+            await maybeResolveApproval(event, deps, streams, resolved, controller.signal);
+            if (toWorkflowEventView(event).terminal)
+                break;
+        }
+    }
+    catch (error) {
+        if (!controller.signal.aborted)
+            throw error;
+    }
+    finally {
+        process.removeListener("SIGINT", onSignal);
+        process.removeListener("SIGTERM", onSignal);
+    }
+    return runWorkflowEpilogue(deps.client, deps.executionId, streams);
+}
+function renderEvent(event, mode, streams) {
+    if (mode === "json") {
+        streams.data(`${JSON.stringify(workflowEventToNdjson(event))}\n`);
+        return;
+    }
+    renderWorkflowEventPlaintext(event, { write: streams.data }, streams.colorize);
+}
+// Resolve a bubbled tool approval. With a policy, submit it (retrying transient
+// failures); without one, print the manual escape hatch and leave it for the user.
+// Each tool_call_id is handled once (mirrors Go's promptedToolCallIDs guard).
+async function maybeResolveApproval(event, deps, streams, resolved, signal) {
+    if (event.payload.case !== "approvalRequested")
+        return;
+    const toolCallId = event.payload.value.toolCallId;
+    if (toolCallId === "" || resolved.has(toolCallId))
+        return;
+    resolved.add(toolCallId);
+    const escapeHatch = `stigmer execution approve ${deps.executionId} --tool-call ${toolCallId} --action approve`;
+    if (deps.defaultAction === ApprovalAction.UNSPECIFIED) {
+        streams.status(`  ⏳ Approval required for ${toolCallId}. Resolve it with:`);
+        streams.status(`     ${escapeHatch}`);
+        return;
+    }
+    await retryWithBackoff(signal, APPROVAL_RETRY_MAX_ATTEMPTS, APPROVAL_RETRY_BASE_DELAY_MS, async () => {
+        await deps.client.workflowExecution.submitApproval(create(SubmitWorkflowApprovalInputSchema, {
+            executionId: deps.executionId,
+            toolCallId,
+            action: deps.defaultAction,
+        }));
+    });
+    streams.status(`  ✓ Approval auto-resolved (${approvalLabel(deps.defaultAction)}) for ${toolCallId}`);
+}
+// Final Get + a compact completion summary (port of Go's
+// displayWorkflowExecutionComplete, without the panel chrome — to stderr so
+// piped event output on stdout stays clean).
+async function runWorkflowEpilogue(client, executionId, streams) {
+    const exec = await client.workflowExecution.get(executionId);
+    const style = styler(streams.colorize);
+    const status = exec.status;
+    const phase = status?.phase ?? ExecutionPhase.EXECUTION_PHASE_UNSPECIFIED;
+    streams.status("");
+    streams.status(summaryHeadline(phase, status?.error ?? "", style));
+    const duration = calculateDuration(status?.startedAt ?? "", status?.completedAt ?? "");
+    if (duration !== "-")
+        streams.status(`  Duration:  ${duration}`);
+    const tasks = status?.tasks ?? [];
+    const counts = countTasks(tasks);
+    streams.status(`  Tasks:     ${tasks.length} total`);
+    if (counts.completed > 0)
+        streams.status(`             ${counts.completed} completed`);
+    if (counts.failed > 0)
+        streams.status(`             ${counts.failed} failed`);
+    if (counts.skipped > 0)
+        streams.status(`             ${counts.skipped} skipped`);
+    return exec;
+}
+function summaryHeadline(phase, error, style) {
+    switch (phase) {
+        case ExecutionPhase.EXECUTION_COMPLETED:
+            return style.green("✓ Workflow completed");
+        case ExecutionPhase.EXECUTION_FAILED:
+            return style.red(`✗ Workflow failed${error !== "" ? `: ${error}` : ""}`);
+        case ExecutionPhase.EXECUTION_CANCELLED:
+            return style.yellow("Workflow cancelled");
+        case ExecutionPhase.EXECUTION_TERMINATED:
+            return style.yellow("Workflow terminated");
+        default:
+            return style.yellow(`Workflow exited (${formatWorkflowPhase(phase)})`);
+    }
+}
+// Tally terminal task outcomes. Mirrors Go's countWorkflowTasks.
+function countTasks(tasks) {
+    const counts = { completed: 0, failed: 0, skipped: 0 };
+    for (const task of tasks) {
+        if (task.status === WorkflowTaskStatus.WORKFLOW_TASK_COMPLETED)
+            counts.completed++;
+        else if (task.status === WorkflowTaskStatus.WORKFLOW_TASK_FAILED)
+            counts.failed++;
+        else if (task.status === WorkflowTaskStatus.WORKFLOW_TASK_SKIPPED)
+            counts.skipped++;
+    }
+    return counts;
+}
+function approvalLabel(action) {
+    return (ApprovalAction[action] ?? "unspecified").toLowerCase();
+}
+function defaultStreams() {
+    return {
+        data: (line) => void process.stdout.write(line),
+        status: (line) => void process.stderr.write(`${line}\n`),
+        colorize: shouldColorize(process.stderr),
+    };
+}
+//# sourceMappingURL=workflow-stream.js.map

package/resources/run/workflow-stream.js.map

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

package/resources/run/workspace.d.ts

@@ -0,0 +1,17 @@
+import { type WorkspaceEntry } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+/**
+ * Convert `--workspace`/`--branch`/`--commit` flags into WorkspaceEntry protos.
+ * Returns an empty list when no workspace is requested. Mirrors Go's
+ * parseWorkspaceEntries, including the single-git-workspace rule for
+ * branch/commit and duplicate-name detection.
+ */
+export declare function parseWorkspaceEntries(workspaces: readonly string[], branch: string, commit: string): WorkspaceEntry[];
+/**
+ * The absolute paths of any local (non-git) workspace roots. Attachment
+ * processing uses these to decide whether a file is workspace-relative (no
+ * upload) versus an upload. Mirrors Go's localWorkspaceRoots.
+ */
+export declare function localWorkspaceRoots(entries: readonly WorkspaceEntry[]): string[];
+/** The derived display names of the workspace entries, for the session header. */
+export declare function workspaceNames(entries: readonly WorkspaceEntry[]): string[];
+//# sourceMappingURL=workspace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/resources/run/workspace.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EAIpB,MAAM,4DAA4D,CAAC;AAGpE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,cAAc,EAAE,CA4BlB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,EAAE,CAQhF;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,EAAE,CAE3E"}

package/resources/run/workspace.js

@@ -0,0 +1,147 @@
+// Workspace flag parsing for agent execution.
+//
+// Ports the Go CLI's run_workspace.go: turns repeatable `--workspace` values
+// (plus `--branch`/`--commit`) into WorkspaceEntry protos. A workspace is either
+// an HTTPS git repo (branch/commit allowed) or a local directory (branch/commit
+// rejected). SSH git URLs are rejected with HTTPS guidance, and `--branch`/
+// `--commit` only apply to a single git workspace.
+import { statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, isAbsolute, resolve } from "node:path";
+import { create } from "@bufbuild/protobuf";
+import { GitRepoSourceSchema, LocalPathSourceSchema, WorkspaceEntrySchema, WorkspaceSourceSchema, } from "@stigmer/protos/ai/stigmer/agentic/session/v1/workspace_pb";
+import { UsageError } from "../../errors/index.js";
+/**
+ * Convert `--workspace`/`--branch`/`--commit` flags into WorkspaceEntry protos.
+ * Returns an empty list when no workspace is requested. Mirrors Go's
+ * parseWorkspaceEntries, including the single-git-workspace rule for
+ * branch/commit and duplicate-name detection.
+ */
+export function parseWorkspaceEntries(workspaces, branch, commit) {
+    if (workspaces.length === 0) {
+        if (branch !== "" || commit !== "") {
+            throw new UsageError("--branch and --commit require --workspace");
+        }
+        return [];
+    }
+    if (workspaces.length > 1 && (branch !== "" || commit !== "")) {
+        throw new UsageError("--branch and --commit are only valid with a single git workspace");
+    }
+    const entries = [];
+    const seenNames = new Map(); // derived name -> original value
+    for (const ws of workspaces) {
+        const source = parseWorkspaceSource(ws, branch, commit);
+        const name = deriveEntryName(ws);
+        const prev = seenNames.get(name);
+        if (prev !== undefined) {
+            throw new UsageError(`duplicate workspace name "${name}" derived from both "${prev}" and "${ws}"; ` +
+                "use distinct directory names or repository URLs");
+        }
+        seenNames.set(name, ws);
+        entries.push(create(WorkspaceEntrySchema, { name, source }));
+    }
+    return entries;
+}
+/**
+ * The absolute paths of any local (non-git) workspace roots. Attachment
+ * processing uses these to decide whether a file is workspace-relative (no
+ * upload) versus an upload. Mirrors Go's localWorkspaceRoots.
+ */
+export function localWorkspaceRoots(entries) {
+    const roots = [];
+    for (const entry of entries) {
+        if (entry.source?.source.case === "localPath") {
+            roots.push(entry.source.source.value.path);
+        }
+    }
+    return roots;
+}
+/** The derived display names of the workspace entries, for the session header. */
+export function workspaceNames(entries) {
+    return entries.map((entry) => entry.name);
+}
+// Mirrors Go's parseWorkspaceSource: variant selection (git vs local) plus the
+// branch/commit applicability rules and SSH rejection.
+function parseWorkspaceSource(workspace, branch, commit) {
+    if (isSshGitUrl(workspace)) {
+        throw new UsageError(`SSH git URLs are not supported: ${workspace}\n\n` +
+            "Use HTTPS instead: https://github.com/org/repo");
+    }
+    if (isGitUrl(workspace)) {
+        return create(WorkspaceSourceSchema, {
+            source: { case: "gitRepo", value: create(GitRepoSourceSchema, { url: workspace, branch, commit }) },
+        });
+    }
+    if (branch !== "" || commit !== "") {
+        throw new UsageError("--branch and --commit are only valid with git workspace URLs (https://...)");
+    }
+    return parseLocalWorkspace(workspace);
+}
+// Resolve a local path, verify it is an existing directory, and wrap it as a
+// LocalPathSource. Mirrors Go's parseLocalWorkspace.
+function parseLocalWorkspace(path) {
+    const resolved = resolveLocalPath(path);
+    let isDir;
+    try {
+        isDir = statSync(resolved).isDirectory();
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            throw new UsageError(`workspace path does not exist: ${resolved}`);
+        throw new UsageError(`cannot access workspace path ${resolved}: ${e.message}`);
+    }
+    if (!isDir)
+        throw new UsageError(`workspace path is not a directory: ${resolved}`);
+    return create(WorkspaceSourceSchema, {
+        source: { case: "localPath", value: create(LocalPathSourceSchema, { path: resolved }) },
+    });
+}
+// A short identity for the entry: the repo name for git URLs, the directory
+// basename for local paths. Mirrors Go's deriveEntryName.
+function deriveEntryName(workspace) {
+    if (isGitUrl(workspace))
+        return deriveGitRepoName(workspace);
+    return deriveLocalDirName(workspace);
+}
+// Last non-empty URL path segment, sans ".git". Mirrors Go's deriveGitRepoName.
+function deriveGitRepoName(rawUrl) {
+    let path;
+    try {
+        path = new URL(rawUrl).pathname;
+    }
+    catch {
+        throw new UsageError(`cannot parse git URL for name derivation: ${rawUrl}`);
+    }
+    path = path.replace(/\/+$/, "").replace(/\.git$/, "");
+    const segments = path.split("/");
+    for (let i = segments.length - 1; i >= 0; i--) {
+        if (segments[i] !== "")
+            return segments[i];
+    }
+    throw new UsageError(`cannot derive workspace name from URL: ${rawUrl}`);
+}
+// Directory basename of the resolved absolute path. Mirrors Go's
+// deriveLocalDirName — "." resolves to the CWD basename, not ".".
+function deriveLocalDirName(path) {
+    const resolved = resolveLocalPath(path);
+    const name = basename(resolved);
+    if (name === "." || name === "/" || name === "") {
+        throw new UsageError(`cannot derive workspace name from path: ${path}`);
+    }
+    return name;
+}
+// Expand a leading "~/" and make the path absolute. Mirrors Go's resolveLocalPath.
+function resolveLocalPath(path) {
+    let p = path;
+    if (p.startsWith("~/"))
+        p = resolve(homedir(), p.slice(2));
+    return isAbsolute(p) ? p : resolve(p);
+}
+function isGitUrl(s) {
+    return s.startsWith("https://") || s.startsWith("http://");
+}
+function isSshGitUrl(s) {
+    return s.startsWith("git@");
+}
+//# sourceMappingURL=workspace.js.map

package/resources/run/workspace.js.map

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

package/resources/search.d.ts

@@ -0,0 +1,22 @@
+import type { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import type { Stigmer } from "@stigmer/sdk";
+import type { OutputFormat } from "../output/index.js";
+export interface SearchParams {
+    /** Organization scope. Empty searches across all accessible orgs (incl. public). */
+    readonly org: string;
+    /** Exclude public/platform resources, restricting to the caller's own. */
+    readonly excludePublic: boolean;
+    /** 1-indexed page number. */
+    readonly page: number;
+    /** Results per page. */
+    readonly pageSize: number;
+}
+export interface SearchOutcome {
+    /** Rendered entries (table grid, or protojson array for json/yaml). */
+    readonly rendered: string;
+    readonly page: number;
+    readonly totalPages: number;
+    readonly totalCount: number;
+}
+export declare function searchResources(client: Stigmer, kind: ApiResourceKind, query: string, params: SearchParams, format: OutputFormat): Promise<SearchOutcome>;
+//# sourceMappingURL=search.d.ts.map

package/resources/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AAE3H,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,WAAW,YAAY;IAC3B,oFAAoF;IACpF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CAexB"}

package/resources/search.js

@@ -0,0 +1,23 @@
+// `search` dispatch: a relevance-ranked, cross-resource text query over the
+// unified SearchService. Only agents and workflows are search-indexed (matching
+// the Go CLI). Results render identically to `list` (the shared SEARCH_TABLE),
+// with a pagination footer the command appends for human output.
+import { SearchResultSchema } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import { SEARCH_TABLE } from "./list.js";
+import { renderCollection } from "./render.js";
+export async function searchResources(client, kind, query, params, format) {
+    const response = await client.search.query({
+        kinds: [kind],
+        query,
+        org: params.org,
+        excludePublic: params.excludePublic,
+        page: { num: params.page, size: params.pageSize },
+    });
+    return {
+        rendered: renderCollection(SearchResultSchema, response.entries, format, SEARCH_TABLE),
+        page: params.page,
+        totalPages: response.totalPages,
+        totalCount: response.totalCount,
+    };
+}
+//# sourceMappingURL=search.js.map

package/resources/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,+EAA+E;AAC/E,iEAAiE;AAGjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAGhF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAqB/C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAe,EACf,IAAqB,EACrB,KAAa,EACb,MAAoB,EACpB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QACzC,KAAK,EAAE,CAAC,IAAI,CAAC;QACb,KAAK;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;KAClD,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,gBAAgB,CAAC,kBAAkB,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC;QACtF,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,CAAC;AACJ,CAAC"}

package/resources/session.d.ts

@@ -0,0 +1,19 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import type { Stigmer } from "@stigmer/sdk";
+import type { OutputFormat } from "../output/index.js";
+import type { ResourceResult } from "./get-bindings.js";
+/** Fetch a single session by ID (Go's session.GetFromBackend). */
+export declare function getSessionById(client: Stigmer, sessionId: string): Promise<Session>;
+/**
+ * List a session's executions, newest-first (the backend's order, matching Go's
+ * execution.ListBySession). Returns the raw entries for resume to inspect.
+ */
+export declare function listExecutionsBySession(client: Stigmer, sessionId: string): Promise<AgentExecution[]>;
+/** True for the `session`/`sessions` type-alias family. */
+export declare function isSessionAlias(type: string): boolean;
+/** List sessions for the current context, paginated by `limit`. */
+export declare function listSessions(client: Stigmer, limit: number): Promise<ResourceResult>;
+/** Render a session list (json/yaml = full envelope; table = grid). */
+export declare function renderSessionList(result: ResourceResult, format: OutputFormat): string;
+//# sourceMappingURL=session.d.ts.map

package/resources/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/resources/session.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAElG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAEpF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOxD,kEAAkE;AAClE,wBAAsB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzF;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAK3G;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,mEAAmE;AACnE,wBAAsB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAG1F;AAaD,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAEtF"}

package/resources/session.js

@@ -0,0 +1,51 @@
+// `list sessions` support. Sessions, like executions, are runtime resources that
+// bypass the resource registry: there is no `get`/`create`/`delete session` in
+// the unified verbs, only a list. This module owns the alias predicate and the
+// list fetch so the command layer stays declarative.
+import { create } from "@bufbuild/protobuf";
+import { ListAgentExecutionsBySessionRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { ListSessionsRequestSchema, SessionListSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/io_pb";
+import { obj, renderListMessage, str } from "./render.js";
+// Mirrors Go's execution.MaxPageSize — fetch the whole session history in one
+// call (sessions don't accumulate enough executions to need pagination here).
+const MAX_EXECUTIONS_PAGE_SIZE = 100;
+/** Fetch a single session by ID (Go's session.GetFromBackend). */
+export async function getSessionById(client, sessionId) {
+    return client.session.get(sessionId);
+}
+/**
+ * List a session's executions, newest-first (the backend's order, matching Go's
+ * execution.ListBySession). Returns the raw entries for resume to inspect.
+ */
+export async function listExecutionsBySession(client, sessionId) {
+    const list = await client.agentExecution.listBySession(create(ListAgentExecutionsBySessionRequestSchema, { sessionId, pageSize: MAX_EXECUTIONS_PAGE_SIZE }));
+    return list.entries;
+}
+/** True for the `session`/`sessions` type-alias family. */
+export function isSessionAlias(type) {
+    const normalized = type.trim().toLowerCase();
+    return normalized === "session" || normalized === "sessions";
+}
+/** List sessions for the current context, paginated by `limit`. */
+export async function listSessions(client, limit) {
+    const message = await client.session.list(create(ListSessionsRequestSchema, { pageSize: limit }));
+    return { schema: SessionListSchema, message };
+}
+const SESSION_TABLE = {
+    resourceName: "sessions",
+    headers: ["SESSION ID", "AGENT", "SUBJECT", "CREATED"],
+    row: (json) => [
+        str(obj(json, "metadata"), "id"),
+        dash(str(obj(json, "spec"), "agent_instance_id")),
+        dash(str(obj(json, "spec"), "subject")),
+        dash(str(obj(json, "metadata"), "created_at")),
+    ],
+};
+/** Render a session list (json/yaml = full envelope; table = grid). */
+export function renderSessionList(result, format) {
+    return renderListMessage(result.schema, result.message, format, SESSION_TABLE);
+}
+function dash(value) {
+    return value === "" ? "-" : value;
+}
+//# sourceMappingURL=session.js.map

package/resources/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/resources/session.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+EAA+E;AAC/E,+EAA+E;AAC/E,qDAAqD;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,yCAAyC,EAAE,MAAM,4DAA4D,CAAC;AAEvH,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAInH,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAmB,MAAM,aAAa,CAAC;AAE3E,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAe,EAAE,SAAiB;IACrE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAAe,EAAE,SAAiB;IAC9E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,aAAa,CACpD,MAAM,CAAC,yCAAyC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,wBAAwB,EAAE,CAAC,CACrG,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,UAAU,CAAC;AAC/D,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAe,EAAE,KAAa;IAC/D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,yBAAyB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAClG,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,aAAa,GAAe;IAChC,YAAY,EAAE,UAAU;IACxB,OAAO,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;IACtD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QACb,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;KAC/C;CACF,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,MAAsB,EAAE,MAAoB;IAC5E,OAAO,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,IAAI,CAAC,KAAa;IACzB,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC"}