@stigmer/cli 3.0.8

package/resources/mcp/runtime-env.js

@@ -0,0 +1,68 @@
+// Shared MCP runtime_env construction (single source of truth).
+//
+// The Connect RPC takes a runtime_env map of resolved credential values. Both
+// the post-apply auto-discovery path (resources/apply/discovery.ts) and the
+// `connect mcp-server` command build it the same way, so the logic lives here.
+// Mirrors Go's mcpserver.buildRuntimeEnv + parseEnvOverrides (connect.go).
+//
+// Resolution order (lowest → highest priority):
+//   1. OS environment variables, for keys the server declares in spec.env
+//   2. Explicit --env KEY=VALUE overrides (override wins on collision)
+//
+// is_secret is taken from the server's declaration when the key is declared;
+// an override for an undeclared key is treated as non-secret (matches Go).
+import { create } from "@bufbuild/protobuf";
+import { ExecutionValueSchema } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/spec_pb";
+import { UsageError } from "../../errors/index.js";
+/**
+ * Parse `--env KEY=VALUE` strings into a map. Unlike Go (which silently drops
+ * malformed entries), we reject an entry without `=` so a typo surfaces as a
+ * clear usage error rather than a silently-ignored credential.
+ */
+export function parseEnvOverrides(overrides) {
+    const result = {};
+    for (const entry of overrides) {
+        const eq = entry.indexOf("=");
+        if (eq <= 0) {
+            throw new UsageError(`invalid --env value '${entry}': expected KEY=VALUE`);
+        }
+        result[entry.slice(0, eq)] = entry.slice(eq + 1);
+    }
+    return result;
+}
+/**
+ * Build the runtime_env map for the Connect RPC from the OS environment and the
+ * supplied --env overrides. Only keys with a non-empty value are emitted.
+ */
+export function buildRuntimeEnv(server, envOverrides = []) {
+    const declarations = server.spec?.env ?? {};
+    const overrides = parseEnvOverrides(envOverrides);
+    const runtime = {};
+    for (const [key, decl] of Object.entries(declarations)) {
+        const value = process.env[key];
+        if (value !== undefined && value !== "") {
+            runtime[key] = create(ExecutionValueSchema, { value, isSecret: decl.isSecret });
+        }
+    }
+    for (const [key, value] of Object.entries(overrides)) {
+        runtime[key] = create(ExecutionValueSchema, { value, isSecret: declarations[key]?.isSecret ?? false });
+    }
+    return runtime;
+}
+/**
+ * Merge `--env` overrides on top of the current process environment for a
+ * spawned stdio subprocess (override wins). Mirrors Go's mergeEnv. Returns a
+ * plain map suitable for the MCP SDK's StdioClientTransport `env` option.
+ */
+export function mergeProcessEnv(envOverrides) {
+    const merged = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined)
+            merged[key] = value;
+    }
+    for (const [key, value] of Object.entries(parseEnvOverrides(envOverrides))) {
+        merged[key] = value;
+    }
+    return merged;
+}
+//# sourceMappingURL=runtime-env.js.map

package/resources/mcp/runtime-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-env.js","sourceRoot":"","sources":["../../../src/resources/mcp/runtime-env.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,EAAE;AACF,gDAAgD;AAChD,0EAA0E;AAC1E,uEAAuE;AACvE,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAE3E,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,gEAAgE,CAAC;AAEtG,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAA4B;IAC5D,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,UAAU,CAAC,wBAAwB,KAAK,uBAAuB,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiB,EACjB,eAAkC,EAAE;IAEpC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,OAAO,GAAmC,EAAE,CAAC;IAEnD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,YAA+B;IAC7D,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/C,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/resources/picker/ink.d.ts

@@ -0,0 +1,35 @@
+import type { SearchResult } from "@stigmer/protos/ai/stigmer/search/v1/io_pb";
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import type { DeploymentMode, Stigmer } from "@stigmer/sdk";
+/** Options for {@link pickAgent}. */
+export interface PickAgentOptions {
+    /** The CLI's configured, refreshing-token client (backend.stigmer). */
+    readonly client: Stigmer;
+    /** Organization to search within. */
+    readonly org: string;
+    /** Seeds the search box with the unresolved text the user already typed. */
+    readonly initialQuery?: string;
+    /** Feature-gating mode; "cloud" unless the CLI targets a local backend. */
+    readonly deploymentMode?: DeploymentMode;
+}
+/**
+ * Render the agent picker and resolve with the chosen agent, or `undefined`
+ * when the user cancels (Esc / Ctrl+C). Never throws and never exits the
+ * process — the caller decides what to do with the selection.
+ */
+export declare function pickAgent(opts: PickAgentOptions): Promise<SearchResult | undefined>;
+/** Options for {@link pickSession}. */
+export interface PickSessionOptions {
+    /** The CLI's configured, refreshing-token client (backend.stigmer). */
+    readonly client: Stigmer;
+    /** Seeds the filter box with the text the user already typed. */
+    readonly initialQuery?: string;
+    /** Feature-gating mode; "cloud" unless the CLI targets a local backend. */
+    readonly deploymentMode?: DeploymentMode;
+}
+/**
+ * Render the session picker and resolve with the chosen session, or `undefined`
+ * when the user cancels (Esc / Ctrl+C).
+ */
+export declare function pickSession(opts: PickSessionOptions): Promise<Session | undefined>;
+//# sourceMappingURL=ink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ink.d.ts","sourceRoot":"","sources":["../../../src/resources/picker/ink.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5D,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAazF;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAYxF"}

package/resources/picker/ink.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from "ink";
+import { AgentPicker, InkStigmerProvider, SessionPicker } from "@stigmer/ink";
+/**
+ * Render the agent picker and resolve with the chosen agent, or `undefined`
+ * when the user cancels (Esc / Ctrl+C). Never throws and never exits the
+ * process — the caller decides what to do with the selection.
+ */
+export async function pickAgent(opts) {
+    return runPicker((resolve) => (_jsx(AgentPicker, { org: opts.org, initialQuery: opts.initialQuery, onSelect: (agent) => resolve(agent), onCancel: () => resolve(undefined) })), opts.client, opts.deploymentMode);
+}
+/**
+ * Render the session picker and resolve with the chosen session, or `undefined`
+ * when the user cancels (Esc / Ctrl+C).
+ */
+export async function pickSession(opts) {
+    return runPicker((resolve) => (_jsx(SessionPicker, { initialQuery: opts.initialQuery, onSelect: (session) => resolve(session), onCancel: () => resolve(undefined) })), opts.client, opts.deploymentMode);
+}
+// Shared mount loop: render the picker element (which calls `resolve` on select
+// or cancel), unmount on the first resolution, and clean up signal handlers.
+// exitOnCtrlC is false so the picker component owns Ctrl+C (→ cancel) rather
+// than Ink killing the tree out from under us.
+function runPicker(renderPicker, client, deploymentMode) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            instance.unmount();
+            resolve(value);
+        };
+        const instance = render(_jsx(InkStigmerProvider, { client: client, deploymentMode: deploymentMode ?? "cloud", children: renderPicker(finish) }), { exitOnCtrlC: false });
+        const onSignal = () => finish(undefined);
+        process.once("SIGINT", onSignal);
+        process.once("SIGTERM", onSignal);
+        void instance.waitUntilExit().finally(() => {
+            process.removeListener("SIGINT", onSignal);
+            process.removeListener("SIGTERM", onSignal);
+            // Covers an external unmount (e.g. terminal close) with no selection.
+            finish(undefined);
+        });
+    });
+}
+//# sourceMappingURL=ink.js.map

package/resources/picker/ink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ink.js","sourceRoot":"","sources":["../../../src/resources/picker/ink.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAiB9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAsB;IACpD,OAAO,SAAS,CACd,CAAC,OAAO,EAAE,EAAE,CAAC,CACX,KAAC,WAAW,IACV,GAAG,EAAE,IAAI,CAAC,GAAG,EACb,YAAY,EAAE,IAAI,CAAC,YAAY,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EACnC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,GAClC,CACH,EACD,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,cAAc,CACpB,CAAC;AACJ,CAAC;AAYD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAwB;IACxD,OAAO,SAAS,CACd,CAAC,OAAO,EAAE,EAAE,CAAC,CACX,KAAC,aAAa,IACZ,YAAY,EAAE,IAAI,CAAC,YAAY,EAC/B,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EACvC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,GAClC,CACH,EACD,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,cAAc,CACpB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,6EAA6E;AAC7E,6EAA6E;AAC7E,+CAA+C;AAC/C,SAAS,SAAS,CAChB,YAA6E,EAC7E,MAAe,EACf,cAA0C;IAE1C,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;QAC5C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,KAAoB,EAAQ,EAAE;YAC5C,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAC,kBAAkB,IAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,IAAI,OAAO,YAC1E,YAAY,CAAC,MAAM,CAAC,GACF,EACrB,EAAE,WAAW,EAAE,KAAK,EAAE,CACvB,CAAC;QAEF,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAElC,KAAK,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACzC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC3C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC5C,sEAAsE;YACtE,MAAM,CAAC,SAAS,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/resources/picker/tty.d.ts

@@ -0,0 +1,19 @@
+/** Minimal view of the process streams the gate inspects (injectable for tests). */
+export interface PickerStreams {
+    readonly stdin?: {
+        readonly isTTY?: boolean;
+    };
+    readonly stdout?: {
+        readonly isTTY?: boolean;
+    };
+}
+/**
+ * Whether the interactive picker can run: human output mode on a fully
+ * interactive terminal — stdout must be renderable (TTY, not `TERM=dumb`) and
+ * stdin must be keyboard-capable (TTY for raw-mode input).
+ *
+ * JSON mode and non-interactive shells (pipes, CI) return false so callers fall
+ * back to actionable guidance with a stable, scriptable exit code.
+ */
+export declare function interactiveBrowseEnabled(outputMode: "inline" | "json", streams?: PickerStreams): boolean;
+//# sourceMappingURL=tty.d.ts.map

package/resources/picker/tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../../src/resources/picker/tty.ts"],"names":[],"mappings":"AAOA,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,QAAQ,GAAG,MAAM,EAC7B,OAAO,GAAE,aAAuB,GAC/B,OAAO,CAKT"}

package/resources/picker/tty.js

@@ -0,0 +1,21 @@
+// Capability gate for the interactive resource pickers (`run` agent browse,
+// `resume` session browse). Deliberately free of any React/Ink imports so the
+// command can decide whether to take the interactive path *before* paying the
+// dynamic-import cost of picker/ink.tsx (DD-001 lazy boundary).
+import { isInkSupported } from "../stream/tty.js";
+/**
+ * Whether the interactive picker can run: human output mode on a fully
+ * interactive terminal — stdout must be renderable (TTY, not `TERM=dumb`) and
+ * stdin must be keyboard-capable (TTY for raw-mode input).
+ *
+ * JSON mode and non-interactive shells (pipes, CI) return false so callers fall
+ * back to actionable guidance with a stable, scriptable exit code.
+ */
+export function interactiveBrowseEnabled(outputMode, streams = process) {
+    if (outputMode !== "inline")
+        return false;
+    const stdout = streams.stdout ?? process.stdout;
+    const stdin = streams.stdin ?? process.stdin;
+    return isInkSupported(stdout) && stdin.isTTY === true;
+}
+//# sourceMappingURL=tty.js.map

package/resources/picker/tty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.js","sourceRoot":"","sources":["../../../src/resources/picker/tty.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,gEAAgE;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAQlD;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAA6B,EAC7B,UAAyB,OAAO;IAEhC,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,OAAO,cAAc,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;AACxD,CAAC"}

package/resources/reference.d.ts

@@ -0,0 +1,32 @@
+export type ParsedReference = {
+    readonly kind: "id";
+    readonly id: string;
+} | {
+    readonly kind: "ref";
+    readonly org: string;
+    readonly slug: string;
+};
+export declare function parseReference(ref: string, defaultOrg: string, idPrefix: string): ParsedReference;
+/** True if `ref` carries the agent ID prefix (`agt_…`/`agt-…`). */
+export declare function isAgentId(ref: string): boolean;
+/** True if `ref` carries the workflow ID prefix (`wfl_…`/`wfl-…`). */
+export declare function isWorkflowId(ref: string): boolean;
+/** True if `ref` carries the session ID prefix (`ses_…`/`ses-…`). */
+export declare function isSessionId(ref: string): boolean;
+/**
+ * True if `ref` starts with ANY known resource-ID prefix (length-agnostic).
+ * Mirrors Go's reference.HasResourceIDPrefix: use it to detect *intent* (the
+ * user typed something ID-shaped), then {@link validateResourceId} to enforce
+ * completeness.
+ */
+export declare function hasResourceIdPrefix(ref: string): boolean;
+/**
+ * Validate that `ref` is a syntactically complete resource ID. Returns null
+ * when valid, or a user-facing error message otherwise. Mirrors Go's
+ * reference.ValidateResourceID/ResourceIDKind: a known prefix followed by a
+ * 26-char ULID body, or a bare UUID (legacy). A matched prefix with the wrong
+ * body length is reported as "incomplete" so callers can guide the user to
+ * paste the full ID.
+ */
+export declare function validateResourceId(ref: string): string | null;
+//# sourceMappingURL=reference.d.ts.map

package/resources/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/resources/reference.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAajG;AAqCD,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAe7D"}

package/resources/reference.js

@@ -0,0 +1,128 @@
+// Parse a user-supplied resource reference into either an ID lookup or an
+// org/slug lookup, mirroring the Go CLI's parseOrgSlug + ID detection.
+//
+//   "agt_abc123"        -> by ID
+//   "my-org/my-agent"   -> by org/slug (explicit org)
+//   "my-agent"          -> by org/slug (org from --org/context)
+//
+// The kind's id_prefix disambiguates a bare token: "org" resolves "org_x" as an
+// ID but "acme" as a slug.
+//
+// The lower half of this module adds the *strict* classification the run/resume
+// resolvers need (Go's pkg/reference): prefix-by-kind detection and full ID
+// validation (prefix + 26-char ULID, or UUID). This is deliberately distinct
+// from parseReference's lenient `${prefix}_` test — `run my-agent` must not
+// treat a slug that merely starts with a known prefix as an ID.
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { KIND_META } from "../registry/index.js";
+export function parseReference(ref, defaultOrg, idPrefix) {
+    const trimmed = ref.trim();
+    const slash = trimmed.indexOf("/");
+    if (slash > 0) {
+        return { kind: "ref", org: trimmed.slice(0, slash), slug: trimmed.slice(slash + 1) };
+    }
+    if (idPrefix !== "" && trimmed.startsWith(`${idPrefix}_`)) {
+        return { kind: "id", id: trimmed };
+    }
+    return { kind: "ref", org: defaultOrg, slug: trimmed };
+}
+// Crockford base-32 ULID body length. Mirrors Go's reference.ulidLength: the
+// resolver only checks the length (not the alphabet), so a 26-char body after a
+// known prefix is accepted as a complete ID.
+const ULID_LENGTH = 26;
+// Execution-runtime prefixes that are not in KIND_META (which only carries the
+// addressable, registry-relevant kinds) but that the run resolver must still
+// recognize so it can reject them with explicit-form guidance. "wex" is the
+// workflow-execution prefix; "aex" is already in KIND_META.
+const RUNTIME_ID_PREFIXES = ["wex"];
+/** The id_prefix for a kind (from the proto kind_meta mirror), or "". */
+function idPrefixFor(kind) {
+    return KIND_META.get(kind)?.idPrefix ?? "";
+}
+// Every known resource-ID prefix, deduped. Built once from the kind_meta mirror
+// plus the runtime prefixes so there is a single source of truth shared with
+// the rest of the CLI (the registry) rather than a hand-rolled prefix list.
+const ALL_ID_PREFIXES = (() => {
+    const set = new Set(RUNTIME_ID_PREFIXES);
+    for (const meta of KIND_META.values()) {
+        if (meta.idPrefix !== "")
+            set.add(meta.idPrefix);
+    }
+    return [...set];
+})();
+// Mirrors Go's reference.isResourceIDWithKind: a kind prefix followed by either
+// separator the backend accepts ("_" canonical, "-" legacy). Case-sensitive.
+function hasKindPrefix(ref, prefix) {
+    if (prefix === "")
+        return false;
+    const trimmed = ref.trim();
+    return trimmed.startsWith(`${prefix}_`) || trimmed.startsWith(`${prefix}-`);
+}
+/** True if `ref` carries the agent ID prefix (`agt_…`/`agt-…`). */
+export function isAgentId(ref) {
+    return hasKindPrefix(ref, idPrefixFor(ApiResourceKind.agent));
+}
+/** True if `ref` carries the workflow ID prefix (`wfl_…`/`wfl-…`). */
+export function isWorkflowId(ref) {
+    return hasKindPrefix(ref, idPrefixFor(ApiResourceKind.workflow));
+}
+/** True if `ref` carries the session ID prefix (`ses_…`/`ses-…`). */
+export function isSessionId(ref) {
+    return hasKindPrefix(ref, idPrefixFor(ApiResourceKind.session));
+}
+/**
+ * True if `ref` starts with ANY known resource-ID prefix (length-agnostic).
+ * Mirrors Go's reference.HasResourceIDPrefix: use it to detect *intent* (the
+ * user typed something ID-shaped), then {@link validateResourceId} to enforce
+ * completeness.
+ */
+export function hasResourceIdPrefix(ref) {
+    if (ALL_ID_PREFIXES.some((prefix) => hasKindPrefix(ref, prefix)))
+        return true;
+    return isUuid(ref.trim());
+}
+/**
+ * Validate that `ref` is a syntactically complete resource ID. Returns null
+ * when valid, or a user-facing error message otherwise. Mirrors Go's
+ * reference.ValidateResourceID/ResourceIDKind: a known prefix followed by a
+ * 26-char ULID body, or a bare UUID (legacy). A matched prefix with the wrong
+ * body length is reported as "incomplete" so callers can guide the user to
+ * paste the full ID.
+ */
+export function validateResourceId(ref) {
+    const trimmed = ref.trim();
+    for (const prefix of ALL_ID_PREFIXES) {
+        for (const sep of ["_", "-"]) {
+            const pfx = `${prefix}${sep}`;
+            if (!trimmed.startsWith(pfx))
+                continue;
+            const body = trimmed.slice(pfx.length);
+            if (body.length !== ULID_LENGTH) {
+                return "incomplete resource ID: expected 26-character ULID after prefix";
+            }
+            return null;
+        }
+    }
+    if (isUuid(trimmed))
+        return null;
+    return "not a recognized resource ID";
+}
+// Mirrors Go's reference.isUUID: 8-4-4-4-12 hex with hyphens at fixed offsets.
+function isUuid(value) {
+    if (value.length !== 36)
+        return false;
+    if (value[8] !== "-" || value[13] !== "-" || value[18] !== "-" || value[23] !== "-") {
+        return false;
+    }
+    for (let i = 0; i < value.length; i++) {
+        if (i === 8 || i === 13 || i === 18 || i === 23)
+            continue;
+        if (!isHexDigit(value[i]))
+            return false;
+    }
+    return true;
+}
+function isHexDigit(c) {
+    return (c >= "0" && c <= "9") || (c >= "a" && c <= "f") || (c >= "A" && c <= "F");
+}
+//# sourceMappingURL=reference.js.map

package/resources/reference.js.map

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

package/resources/render.d.ts

@@ -0,0 +1,28 @@
+import type { DescMessage, JsonValue, Message } from "@bufbuild/protobuf";
+import type { OutputFormat } from "../output/index.js";
+export type JsonObject = Record<string, JsonValue>;
+/** A row extractor + headers describing a collection's table view. */
+export interface TableShape {
+    readonly resourceName: string;
+    readonly headers: readonly string[];
+    readonly row: (json: JsonObject) => readonly string[];
+}
+/** Render a single resource for a read verb (json/yaml = protojson; table = fields). */
+export declare function renderResource(schema: DescMessage, message: Message, format: OutputFormat): string;
+/** Render a collection for a read verb (json/yaml = protojson array; table = grid). */
+export declare function renderCollection(schema: DescMessage, messages: readonly Message[], format: OutputFormat, table: TableShape): string;
+/**
+ * Render a *list message* (e.g. AgentExecutionList, SessionList) for a read verb.
+ *
+ * Unlike `renderCollection`, which serializes a bare slice, this mirrors Go's
+ * `DisplayProto(list, ...)`: json/yaml emit the whole list envelope (including
+ * `total_pages`), while table projects the nested `entries` into a grid.
+ */
+export declare function renderListMessage(schema: DescMessage, message: Message, format: OutputFormat, table: TableShape): string;
+/** Read a string field from a protojson object, defaulting to "". */
+export declare function str(json: JsonObject, key: string): string;
+/** Read a nested object field from a protojson object, defaulting to {}. */
+export declare function obj(json: JsonObject, key: string): JsonObject;
+/** Boolean field from a protojson object (defaults to false). */
+export declare function bool(json: JsonObject, key: string): boolean;
+//# sourceMappingURL=render.d.ts.map

package/resources/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/resources/render.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWvD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEnD,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,MAAM,EAAE,CAAC;CACvD;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAIlG;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,UAAU,GAChB,MAAM,CAMR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,UAAU,GAChB,MAAM,CAQR;AA6BD,qEAAqE;AACrE,wBAAgB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,4EAA4E;AAC5E,wBAAgB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAE7D;AAED,iEAAiE;AACjE,wBAAgB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/resources/render.js

@@ -0,0 +1,87 @@
+// Uniform rendering for read verbs.
+//
+// All resource protos share the ApiResourceMetadata envelope, so the human
+// (table) view of a single `get` is derived generically from the protojson
+// projection — no per-kind formatter. json/yaml use the canonical protojson
+// renderers for full fidelity and Go byte-parity. Collections render via the
+// shared table renderer with a caller-supplied row extractor.
+//
+// The render boundary intentionally uses the base proto types (DescMessage /
+// Message) so generic verb dispatch can pass a (schema, message) pair without
+// threading a concrete type parameter through the registry.
+import { protoToJsonValue, renderEmpty, renderProtoJson, renderProtoListJson, renderProtoListYaml, renderProtoYaml, renderTable, } from "../output/index.js";
+/** Render a single resource for a read verb (json/yaml = protojson; table = fields). */
+export function renderResource(schema, message, format) {
+    if (format === "json")
+        return renderProtoJson(schema, message);
+    if (format === "yaml")
+        return renderProtoYaml(schema, message);
+    return renderResourceFields(protoToJsonValue(schema, message));
+}
+/** Render a collection for a read verb (json/yaml = protojson array; table = grid). */
+export function renderCollection(schema, messages, format, table) {
+    if (format === "json")
+        return renderProtoListJson(schema, messages);
+    if (format === "yaml")
+        return renderProtoListYaml(schema, messages);
+    if (messages.length === 0)
+        return renderEmpty(table.resourceName);
+    const rows = messages.map((message) => table.row(asObject(protoToJsonValue(schema, message))));
+    return `\n${renderTable(table.headers, rows)}`;
+}
+/**
+ * Render a *list message* (e.g. AgentExecutionList, SessionList) for a read verb.
+ *
+ * Unlike `renderCollection`, which serializes a bare slice, this mirrors Go's
+ * `DisplayProto(list, ...)`: json/yaml emit the whole list envelope (including
+ * `total_pages`), while table projects the nested `entries` into a grid.
+ */
+export function renderListMessage(schema, message, format, table) {
+    if (format === "json")
+        return renderProtoJson(schema, message);
+    if (format === "yaml")
+        return renderProtoYaml(schema, message);
+    const entries = protoToJsonValue(schema, message);
+    const list = asObject(entries).entries;
+    const rows = (Array.isArray(list) ? list : []).map((entry) => table.row(asObject(entry)));
+    if (rows.length === 0)
+        return renderEmpty(table.resourceName);
+    return `\n${renderTable(table.headers, rows)}`;
+}
+// Human field view of a resource's metadata envelope (+ common spec fields).
+function renderResourceFields(json) {
+    const obj = asObject(json);
+    const metadata = asObject(obj.metadata);
+    const spec = asObject(obj.spec);
+    const fields = [];
+    pushField(fields, "ID", metadata.id);
+    pushField(fields, "Name", metadata.name);
+    pushField(fields, "Slug", metadata.slug);
+    pushField(fields, "Org", metadata.org);
+    pushField(fields, "Visibility", metadata.visibility);
+    pushField(fields, "Description", spec.description);
+    const width = Math.max(0, ...fields.map(([key]) => key.length));
+    const lines = fields.map(([key, value]) => `  ${key}:${" ".repeat(width - key.length + 2)}${value}`);
+    return `\n${lines.join("\n")}\n`;
+}
+function pushField(fields, key, value) {
+    if (typeof value === "string" && value !== "")
+        fields.push([key, value]);
+}
+function asObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+/** Read a string field from a protojson object, defaulting to "". */
+export function str(json, key) {
+    const value = json[key];
+    return typeof value === "string" ? value : "";
+}
+/** Read a nested object field from a protojson object, defaulting to {}. */
+export function obj(json, key) {
+    return asObject(json[key]);
+}
+/** Boolean field from a protojson object (defaults to false). */
+export function bool(json, key) {
+    return json[key] === true;
+}
+//# sourceMappingURL=render.js.map

package/resources/render.js.map

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

package/resources/run/agent-exec.d.ts

@@ -0,0 +1,15 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+import type { BackendClient } from "../../client/index.js";
+import type { PreparedRun } from "./prepare.js";
+import { type RunOutputMode } from "./stream.js";
+export interface ResolvedAgentExecInput {
+    readonly agent: Agent;
+    readonly prepared: PreparedRun;
+    readonly org: string;
+    /** Artifact download directory; "" skips download. */
+    readonly downloadDir: string;
+    readonly outputMode: RunOutputMode;
+    readonly client: BackendClient;
+}
+export declare function executeResolvedAgent(input: ResolvedAgentExecInput): Promise<void>;
+//# sourceMappingURL=agent-exec.d.ts.map

package/resources/run/agent-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-exec.d.ts","sourceRoot":"","sources":["../../../src/resources/run/agent-exec.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAK3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EvF"}

package/resources/run/agent-exec.js

@@ -0,0 +1,81 @@
+// The "run a resolved agent" flow (Go's executeResolvedAgent in
+// run_agent_exec.go): create the workspace session if needed, create the agent
+// execution, then either detach (print header + re-attach hint) or stream and
+// optionally download artifacts. Shared by `run` and `draft`.
+import { CliExitError, ExitCode } from "../../errors/index.js";
+import { downloadExecutionArtifacts } from "../download.js";
+import { createAgentExecution, createSessionForAgent } from "./create.js";
+import { renderSessionHeader, workspaceNames } from "./header.js";
+import { streamAgentExecution } from "./stream.js";
+export async function executeResolvedAgent(input) {
+    const { prepared, org, client } = input;
+    const controller = client.controller.bind(client);
+    const progress = stderrProgress();
+    // Workspaces require a CLI-created session: the backend's auto-create flow has
+    // no workspace passthrough (Go's createSessionForAgent).
+    let sessionId = "";
+    if (prepared.workspaceEntries.length > 0) {
+        const instanceId = input.agent.status?.defaultInstanceId ?? "";
+        if (instanceId === "") {
+            throw new CliExitError("agent has no default instance — cannot create workspace session", ExitCode.General);
+        }
+        progress("Creating workspace...");
+        const session = await createSessionForAgent(controller, {
+            agentInstanceId: instanceId,
+            orgId: org,
+            workspaceEntries: prepared.workspaceEntries,
+        });
+        sessionId = session.metadata?.id ?? "";
+    }
+    progress("Creating execution...");
+    const execution = await createAgentExecution(controller, {
+        agentId: input.agent.metadata?.id,
+        sessionId: sessionId === "" ? undefined : sessionId,
+        orgId: org,
+        message: prepared.message,
+        runtimeEnv: prepared.runtimeEnv,
+        attachments: prepared.attachments,
+        workspaceFileRefs: prepared.workspaceFileRefs,
+        model: prepared.model,
+        mode: prepared.mode,
+        autoApproveAll: prepared.autoApproveAll,
+    });
+    // The backend owns the canonical session id; prefer it over the CLI-created
+    // one (they agree, but the spec value is authoritative).
+    sessionId = execution.spec?.sessionId ?? sessionId;
+    const header = {
+        agentName: input.agent.metadata?.name ?? "",
+        sessionId,
+        model: prepared.model,
+        mode: prepared.mode,
+        workspaces: workspaceNames(prepared.workspaceEntries),
+    };
+    if (prepared.detach) {
+        renderSessionHeader(process.stderr, header);
+        if (sessionId !== "") {
+            process.stderr.write(`Detached (still running) — stigmer resume ${sessionId} to re-attach\n`);
+        }
+        return;
+    }
+    const finalExec = await streamAgentExecution({
+        client: client.stigmer,
+        sessionId,
+        executionId: execution.metadata?.id ?? "",
+        org,
+        mode: prepared.mode,
+        defaultAction: prepared.defaultAction,
+        outputMode: input.outputMode,
+        header,
+    });
+    if (input.downloadDir !== "" && (finalExec.status?.artifacts.length ?? 0) > 0) {
+        await downloadExecutionArtifacts(client.stigmer, finalExec.metadata?.id ?? "", { artifactName: "", outputDir: input.downloadDir }, progress);
+    }
+}
+// Progress lines go to stderr, but only when it is a TTY — matching Go's spinner,
+// which is suppressed under pipes/CI so it never pollutes captured output.
+function stderrProgress() {
+    if (process.stderr.isTTY !== true)
+        return () => { };
+    return (line) => void process.stderr.write(`${line}\n`);
+}
+//# sourceMappingURL=agent-exec.js.map

package/resources/run/agent-exec.js.map

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