@stigmer/cli 3.0.8

package/commands/push.js

@@ -0,0 +1,150 @@
+// `stigmer push <type> [path]` — package and upload an artifact to the registry.
+// Only skills are pushable today. Two source modes: a local directory (default,
+// git provenance auto-detected) or a remote repo via --git-url (cloned to a
+// temp dir, then pushed). Heavy modules are lazy-imported so `--help` stays fast.
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
+import { UsageError } from "../errors/index.js";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { defaultRegistry, Verb } from "../registry/index.js";
+import { globalOrg } from "./shared.js";
+const collect = (value, previous) => [...previous, value];
+export function registerPush(program) {
+    program
+        .command("push <type> [path]")
+        .description("push an artifact to the registry (supported types: skill)")
+        .option("--tag <tag>", "version tag for the artifact", "latest")
+        .option("-m, --message <message>", "version message describing what changed")
+        .option("--dry-run", "validate without pushing")
+        .option("--git-url <url>", "push from a remote git repository URL")
+        .option("--git-ref <ref>", "git reference (tag, branch, or commit SHA) for remote push")
+        .option("--subdir <dir>", "subdirectory within the git repository containing the artifact")
+        .option("--ignore <pattern>", "additional pattern to ignore (repeatable)", collect, [])
+        .option("--include <pattern>", "pattern to force-include (repeatable)", collect, [])
+        .option("--no-gitignore", "don't respect .gitignore patterns")
+        .option("--verbose", "show detailed output including ignore decisions")
+        .action((type, path, options, command) => runPush(type, path, options, command));
+}
+async function runPush(type, path, options, command) {
+    const info = defaultRegistry().getByAlias(type);
+    if (info === undefined) {
+        throw new UsageError(`unknown resource type: ${type}\n\nAvailable types: skill`);
+    }
+    if (!info.supportedVerbs.has(Verb.Push)) {
+        throw new UsageError(`${info.displayName} does not support 'push'`);
+    }
+    if (info.kind !== ApiResourceKind.skill) {
+        throw new UsageError(`push not implemented for ${info.displayName}`);
+    }
+    const [{ connectBackend }, skill] = await Promise.all([import("../backend.js"), import("../resources/skill.js")]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    const org = resolveOrganization(client.config, globalOrg(command));
+    const ignoreOptions = {
+        respectGitignore: options.gitignore !== false,
+        extraIgnore: options.ignore ?? [],
+        extraInclude: options.include ?? [],
+    };
+    const decisionSink = options.verbose === true ? (line) => process.stderr.write(`${line}\n`) : undefined;
+    const tag = options.tag ?? "latest";
+    const message = options.message ?? "";
+    if (options.gitUrl !== undefined && options.gitUrl !== "") {
+        await pushRemote(client.stigmer, skill, { org, tag, message, ignoreOptions, decisionSink, options });
+        return;
+    }
+    const directory = path !== undefined && path !== "" ? path : process.cwd();
+    if (!skill.hasSkillFile(directory)) {
+        throw new UsageError(`SKILL.md not found in ${directory}\n\nA skill directory must contain a SKILL.md file defining the skill interface`);
+    }
+    // Validate metadata early so dry-run and real pushes fail the same way.
+    skill.parseSkillMetadata(directory);
+    if (options.dryRun === true) {
+        process.stdout.write(renderDryRun(directory, skill.analyzeDryRun(directory, ignoreOptions), skill));
+        return;
+    }
+    const result = await skill.pushSkill(client.stigmer, directory, org, tag, message, ignoreOptions, decisionSink);
+    process.stdout.write(renderResult(result, skill));
+}
+async function pushRemote(client, skill, ctx) {
+    const gitUrl = ctx.options.gitUrl ?? "";
+    const gitRef = ctx.options.gitRef ?? "";
+    const subdir = ctx.options.subdir ?? "";
+    if (ctx.options.dryRun === true) {
+        process.stdout.write(renderRemoteDryRun(gitUrl, gitRef, subdir, ctx));
+        return;
+    }
+    const { cloneRepository } = await import("../resources/git.js");
+    const tempDir = mkdtempSync(join(tmpdir(), "stigmer-skill-"));
+    try {
+        cloneRepository(gitUrl, gitRef, tempDir);
+        const skillDir = subdir !== "" ? join(tempDir, subdir) : tempDir;
+        if (!skill.hasSkillFile(skillDir)) {
+            throw new UsageError(`SKILL.md not found in ${subdir !== "" ? subdir : "repository root"}\n\n` +
+                "The skill directory must contain a SKILL.md file with YAML frontmatter");
+        }
+        const result = await skill.pushSkillFromClone(client, skillDir, { gitUrl, gitRef, subdir, org: ctx.org, tag: ctx.tag, message: ctx.message, options: ctx.ignoreOptions }, ctx.decisionSink);
+        process.stdout.write(renderResult(result, skill));
+    }
+    finally {
+        rmSync(tempDir, { recursive: true, force: true });
+    }
+}
+function renderResult(result, skill) {
+    const status = result.isNewResource ? "new resource" : result.versionChanged ? "new version" : "unchanged";
+    const lines = [
+        "",
+        `Pushed skill '${result.skillName}'`,
+        `  ID:       ${result.id}`,
+        `  Slug:     ${result.slug}`,
+        `  Tag:      ${result.tag}`,
+        `  Version:  ${skill.shortHash(result.versionHash)}`,
+        `  Size:     ${skill.formatBytes(result.artifactSize)}`,
+        `  Status:   ${status}`,
+    ];
+    if (result.message !== "")
+        lines.push(`  Message:  ${result.message}`);
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+function renderDryRun(directory, analysis, skill) {
+    const { stats } = analysis;
+    const lines = [
+        "",
+        `Dry run - analyzing skill directory: ${directory}`,
+        "",
+        "Pattern sources:",
+        ...analysis.patternSources.map((s) => `  - ${s}`),
+        "",
+        `Files to include:    ${stats.filesIncluded} (${skill.formatBytes(stats.totalSize)})`,
+        `Files ignored:       ${stats.filesIgnored}`,
+        `Directories skipped: ${stats.dirsSkipped}`,
+    ];
+    if (analysis.sampleIncluded.length > 0) {
+        lines.push("", "Sample included:", ...analysis.sampleIncluded.map((f) => `  + ${f}`));
+    }
+    if (analysis.sampleIgnored.length > 0) {
+        lines.push("", "Sample ignored:", ...analysis.sampleIgnored.map((f) => `  - ${f}`));
+    }
+    lines.push("", "Run without --dry-run to push the skill artifact.", "");
+    return `${lines.join("\n")}\n`;
+}
+function renderRemoteDryRun(gitUrl, gitRef, subdir, ctx) {
+    const lines = ["", "Dry run mode - would push skill from remote git repository:", "", "Git Source:", `  URL:    ${gitUrl}`];
+    if (gitRef !== "")
+        lines.push(`  Ref:    ${gitRef}`);
+    if (subdir !== "")
+        lines.push(`  Subdir: ${subdir}`);
+    lines.push(`  Tag:    ${ctx.tag}`, "", "Ignore Configuration:");
+    lines.push(`  Gitignore:         ${ctx.ignoreOptions.respectGitignore ? "enabled" : "disabled"}`);
+    lines.push("  Security defaults: enabled");
+    lines.push("  Stigmerignore:     will load if present");
+    if (ctx.ignoreOptions.extraIgnore.length > 0)
+        lines.push(`  Extra ignore:      ${ctx.ignoreOptions.extraIgnore.join(", ")}`);
+    if (ctx.ignoreOptions.extraInclude.length > 0)
+        lines.push(`  Force include:     ${ctx.ignoreOptions.extraInclude.join(", ")}`);
+    lines.push("", "Note: Full analysis requires cloning the repository.", "Run without --dry-run to push the skill artifact.", "");
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=push.js.map

package/commands/push.js.map

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

package/commands/reset.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerReset(program: Command): void;
+//# sourceMappingURL=reset.d.ts.map

package/commands/reset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.d.ts","sourceRoot":"","sources":["../../src/commands/reset.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQpD"}

package/commands/reset.js

@@ -0,0 +1,45 @@
+// `stigmer reset` — stop the stack and wipe all persistent local state, then
+// (unless config was removed) restart fresh. Destructive, so it confirms first
+// unless `--force` is given. Configuration is preserved unless --include-config.
+import { homedir } from "node:os";
+import { CommandResult, renderResult } from "../output/index.js";
+import { addResultFlags, resultFormat } from "./shared.js";
+export function registerReset(program) {
+    const reset = program
+        .command("reset")
+        .description("stop the stack and remove all local state, then restart fresh")
+        .option("--force", "skip the confirmation prompt")
+        .option("--include-config", "also remove configuration (API keys, preferences)")
+        .action((options) => runReset(options));
+    addResultFlags(reset);
+}
+async function runReset(options) {
+    const { reset } = await import("../local/reset.js");
+    const { up } = await import("../local/daemon/launch.js");
+    const { confirm } = await import("../local/setup/prompt.js");
+    const { configDir } = await import("../local/paths.js");
+    if (options.force !== true) {
+        const scope = options.includeConfig === true ? " INCLUDING configuration (config.yaml)" : " (configuration preserved)";
+        const ok = await confirm(`This will remove all runtime data in ${configDir(homedir())}${scope}.\nContinue?`);
+        if (!ok) {
+            renderResult(CommandResult.warning("Reset cancelled"), resultFormat(options));
+            return;
+        }
+    }
+    const outcome = await reset({ includeConfig: options.includeConfig === true });
+    const result = CommandResult.success("Reset complete");
+    const removed = result.addSection("Removed");
+    if (outcome.servicesStopped)
+        removed.item("services stopped");
+    for (const path of outcome.removedPaths)
+        removed.item(path);
+    if (options.includeConfig === true) {
+        result.hint("Run 'stigmer up' to reconfigure and start fresh");
+        renderResult(result, resultFormat(options));
+        return;
+    }
+    renderResult(result, resultFormat(options));
+    process.stderr.write("\nRestarting Stigmer local stack…\n");
+    await up({}, homedir());
+}
+//# sourceMappingURL=reset.js.map

package/commands/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../src/commands/reset.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,iFAAiF;AAGjF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,aAAa,EAAoB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3D,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,+DAA+D,CAAC;SAC5E,MAAM,CAAC,SAAS,EAAE,8BAA8B,CAAC;SACjD,MAAM,CAAC,kBAAkB,EAAE,mDAAmD,CAAC;SAC/E,MAAM,CAAC,CAAC,OAAmB,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,cAAc,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,OAAmB;IACzC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACpD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACzD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAC7D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAExD,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,4BAA4B,CAAC;QACvH,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,wCAAwC,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;QAC7G,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9E,OAAO;QACT,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,eAAe;QAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,YAAY;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5D,IAAI,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC/D,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IAE5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC1B,CAAC"}

package/commands/resume.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerResume(program: Command): void;
+//# sourceMappingURL=resume.d.ts.map

package/commands/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../src/commands/resume.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUrD"}

package/commands/resume.js

@@ -0,0 +1,87 @@
+// `stigmer resume [session-id-or-text]` — re-open an existing session. Thin
+// handler: classify the argument (Go's executeResumeSmart), then delegate to the
+// resume orchestrator. Resource IDs that aren't sessions are redirected to `run`;
+// text/0-arg would open the session picker (a separate, not-yet-wired task).
+import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
+import { UsageError } from "../errors/index.js";
+import { interactiveBrowseEnabled } from "../resources/picker/tty.js";
+import { globalOrg } from "./shared.js";
+export function registerResume(program) {
+    program
+        .command("resume [reference]")
+        .description("resume an existing session by ID")
+        .option("-v, --verbose", "show all execution events")
+        .option("--mode <mode>", 'follow-up interaction mode: "agent" (default) or "plan" (read-only)')
+        .option("--json", "stream events as newline-delimited JSON")
+        .action((reference, options, command) => runResume(reference, options, command));
+}
+async function runResume(reference, options, command) {
+    const { validateMode } = await import("../resources/run/prepare.js");
+    // Call through a plain signature: TS forbids assertion functions reached via a
+    // destructured dynamic-import binding (TS2775); we only need the throw-on-invalid
+    // side effect here, not the narrowing.
+    validateMode(options.mode ?? "");
+    const { connectBackend } = await import("../backend.js");
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    const org = resolveOrganization(client.config, globalOrg(command));
+    if (org === "") {
+        throw new UsageError("organization not set\n\nSet it with:\n  stigmer config context set --org <org>\n  stigmer resume --org <org> ...");
+    }
+    const outputMode = options.json === true ? "json" : "inline";
+    const mode = (options.mode ?? "");
+    if (reference === undefined) {
+        if (interactiveBrowseEnabled(outputMode)) {
+            await browseAndResumeSession("", client, org, mode, outputMode);
+            return;
+        }
+        throw browseUnavailableError();
+    }
+    const { isSessionId, isAgentId, isWorkflowId, hasResourceIdPrefix, validateResourceId } = await import("../resources/reference.js");
+    // Agent/workflow IDs belong to `run`.
+    if (isAgentId(reference) || isWorkflowId(reference)) {
+        throw new UsageError(`Resource IDs like "${reference}" are not sessions\n\nTo run a resource:\n  stigmer run ${reference}`);
+    }
+    if (isSessionId(reference)) {
+        if (validateResourceId(reference) !== null) {
+            throw new UsageError(`Incomplete session ID: ${reference}\n\nProvide the full session ID (e.g. ses_01abc123xyz456789012345678)`);
+        }
+        const { openSession } = await import("../resources/run/resume.js");
+        await openSession({ client, sessionId: reference, org, mode, outputMode });
+        return;
+    }
+    // Any other resource-ID prefix is not a session.
+    if (hasResourceIdPrefix(reference)) {
+        throw new UsageError(`Resource IDs like "${reference}" are not sessions\n\n` +
+            "To resume a session, provide a session ID (ses_…) or search text:\n" +
+            "  stigmer resume <session-id>");
+    }
+    // Bare text → interactive session picker (pre-filtered by the text) on a TTY;
+    // otherwise actionable guidance.
+    if (interactiveBrowseEnabled(outputMode)) {
+        await browseAndResumeSession(reference, client, org, mode, outputMode);
+        return;
+    }
+    throw browseUnavailableError(reference);
+}
+// Mount the session picker; on selection, re-open the chosen session through the
+// existing resume orchestrator. Cancel (Esc/Ctrl+C → undefined) returns cleanly
+// so the command exits 0. Loaded lazily to honor the DD-001 boundary.
+async function browseAndResumeSession(initialQuery, client, org, mode, outputMode) {
+    const { pickSession } = await import("../resources/picker/ink.js");
+    const selected = await pickSession({ client: client.stigmer, initialQuery });
+    if (selected === undefined)
+        return;
+    const sessionId = selected.metadata?.id ?? "";
+    if (sessionId === "")
+        return;
+    const { openSession } = await import("../resources/run/resume.js");
+    await openSession({ client, sessionId, org, mode, outputMode });
+}
+function browseUnavailableError(query) {
+    const head = query === undefined || query === ""
+        ? "Interactive session browsing requires an interactive terminal"
+        : `Searching sessions for "${query}" requires an interactive terminal`;
+    return new UsageError(`${head}\n\nSpecify a full session ID:\n  stigmer resume <session-id>`);
+}
+//# sourceMappingURL=resume.js.map

package/commands/resume.js.map

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

package/commands/run.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerRun(program: Command): void;
+//# sourceMappingURL=run.d.ts.map

package/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUlD"}

package/commands/run.js

@@ -0,0 +1,193 @@
+// `stigmer run [agent-ref | <type> <reference>]` — execute an agent (or create a
+// workflow execution) and stream it. Thin handler: parse flags, resolve the
+// reference (smart 0/1/2-arg dispatch mirroring Go's run.go + run_picker.go),
+// then delegate to the shared run stack. Heavy modules (backend client, Ink,
+// the differ) load lazily inside the action so `--help` stays fast (DD-001).
+import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
+import { UsageError } from "../errors/index.js";
+import { interactiveBrowseEnabled } from "../resources/picker/tty.js";
+import { addAgentExecFlags } from "./agent-exec-flags.js";
+import { globalOrg } from "./shared.js";
+export function registerRun(program) {
+    const run = program
+        .command("run [type] [reference]")
+        .description("execute an agent or workflow by reference");
+    addAgentExecFlags(run)
+        .option("--json", "stream events as newline-delimited JSON")
+        .option("--download <dir>", "download artifacts to directory when complete")
+        .action((type, reference, options, command) => runRun(type, reference, options, command));
+}
+async function runRun(type, reference, options, command) {
+    const { connectBackend } = await import("../backend.js");
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    const org = resolveOrganization(client.config, globalOrg(command));
+    if (org === "") {
+        throw new UsageError("organization not set\n\n" +
+            "Set it with one of:\n" +
+            "  stigmer config context set --org <org>\n" +
+            "  stigmer run --org <org> ...");
+    }
+    const outputMode = options.json === true ? "json" : "inline";
+    // 0 args → interactive agent picker on a TTY; otherwise actionable guidance.
+    if (type === undefined) {
+        if (interactiveBrowseEnabled(outputMode)) {
+            await browseAndRunAgent("", options, org, outputMode, client);
+            return;
+        }
+        throw browseUnavailableError("");
+    }
+    // 1 arg → smart resolution; 2 args → explicit "<type> <reference>".
+    if (reference === undefined) {
+        await runSmart(type, options, org, outputMode, client);
+        return;
+    }
+    await runExplicit(type, reference, options, org, outputMode, client);
+}
+// stigmer run <value>: classify the single argument and dispatch (Go's
+// executeRunSmart). Session IDs belong to `resume`; complete agent IDs resolve
+// directly; other resource IDs require the explicit two-arg form; bare text is
+// resolved as an agent slug.
+async function runSmart(value, options, org, outputMode, client) {
+    const { isSessionId, hasResourceIdPrefix, isAgentId, validateResourceId } = await import("../resources/reference.js");
+    if (isSessionId(value)) {
+        throw new UsageError(`Session IDs are handled by the resume command\n\nTo resume a session:\n  stigmer resume ${value}`);
+    }
+    if (hasResourceIdPrefix(value)) {
+        if (isAgentId(value)) {
+            if (validateResourceId(value) !== null) {
+                throw new UsageError(`Incomplete agent ID: ${value}\n\nProvide the full agent ID (e.g. agt_01abc123xyz456789012345678)`);
+            }
+            await runAgent(value, options, org, outputMode, client);
+            return;
+        }
+        throw new UsageError(`Cannot run resource ID "${value}" directly with the short form\n\nUse the explicit form:\n  stigmer run <type> <id>`);
+    }
+    // Bare text: try to resolve as an agent reference; on failure, fall back to
+    // the interactive picker (pre-filled with the typed text) on a TTY, otherwise
+    // guide the user.
+    const { resolveAgentRef } = await import("../resources/run/resolve.js");
+    let agent;
+    try {
+        agent = await resolveAgentRef(client.stigmer, value, org);
+    }
+    catch {
+        if (interactiveBrowseEnabled(outputMode)) {
+            await browseAndRunAgent(value, options, org, outputMode, client);
+            return;
+        }
+        throw browseUnavailableError(value);
+    }
+    await runResolvedAgent(agent, options, org, outputMode, client);
+}
+// stigmer run <type> <reference>: explicit form (Go's executeRun + routeRun).
+async function runExplicit(type, reference, options, org, outputMode, client) {
+    const { defaultRegistry, Verb } = await import("../registry/index.js");
+    const { ApiResourceKind } = await import("@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb");
+    const info = defaultRegistry().getByAlias(type);
+    if (info === undefined) {
+        throw new UsageError(`unknown resource type: ${type}\n\nAvailable types: agent, workflow`);
+    }
+    if (!info.supportedVerbs.has(Verb.Run)) {
+        throw new UsageError(`${info.displayName} does not support 'run'`);
+    }
+    if (info.kind === ApiResourceKind.workflow) {
+        await runWorkflow(reference, options, org, outputMode, client);
+        return;
+    }
+    const { resolveAgentRef } = await import("../resources/run/resolve.js");
+    const agent = await resolveAgentRef(client.stigmer, reference, org);
+    await runResolvedAgent(agent, options, org, outputMode, client);
+}
+// Resolve a complete agent ID, then run.
+async function runAgent(agentId, options, org, outputMode, client) {
+    const { resolveAgentRef } = await import("../resources/run/resolve.js");
+    const agent = await resolveAgentRef(client.stigmer, agentId, org);
+    await runResolvedAgent(agent, options, org, outputMode, client);
+}
+async function runResolvedAgent(agent, options, org, outputMode, client) {
+    const { prepareAgentExec } = await import("../resources/run/prepare.js");
+    const { executeResolvedAgent } = await import("../resources/run/agent-exec.js");
+    const { toAgentExecFlags } = await import("./agent-exec-flags.js");
+    const prepared = await prepareAgentExec(toAgentExecFlags(options), client.stigmer, org, stderrProgress());
+    await executeResolvedAgent({
+        agent,
+        prepared,
+        org,
+        downloadDir: options.download ?? "",
+        outputMode,
+        client,
+    });
+}
+// Workflow path: create the execution, then either detach (print IDs + return,
+// Go parity) or stream it live over the canonical event stream. Mirrors Go's
+// routeRun workflow branch's guards. `--json` now produces a real NDJSON event
+// stream (fix for D-WF-1: Go silently ignored run workflow --json).
+async function runWorkflow(reference, options, org, outputMode, client) {
+    if (options.workspace.length > 0) {
+        throw new UsageError("--workspace is not supported for workflows (workspace is an agent-level concept)");
+    }
+    const [{ resolveWorkflowRef }, { createWorkflowExecution }, { loadAndMergeEnv }, { parseApprovalAction }] = await Promise.all([
+        import("../resources/run/resolve.js"),
+        import("../resources/run/create.js"),
+        import("../resources/run/env.js"),
+        import("../resources/run/prepare.js"),
+    ]);
+    const workflow = await resolveWorkflowRef(client.stigmer, reference, org);
+    const runtimeEnv = loadAndMergeEnv({
+        envFlags: options.env,
+        secretFlags: options.secret,
+        envFiles: options.envFile,
+        secretFiles: options.secretFile,
+    });
+    if (runtimeEnv.STIGMER_ORG_ID === undefined && org !== "") {
+        runtimeEnv.STIGMER_ORG_ID = { value: org, isSecret: false };
+    }
+    const execution = await createWorkflowExecution(client.controller.bind(client), {
+        workflowId: workflow.metadata?.id ?? "",
+        orgId: org,
+        message: options.message ?? "",
+        runtimeEnv,
+    });
+    const id = execution.metadata?.id ?? "";
+    if (options.detach === true) {
+        process.stdout.write(`Workflow execution created: ${id}\n`);
+        process.stdout.write(`Track it with: stigmer execution logs ${id} --follow\n`);
+        return;
+    }
+    const { ApprovalAction } = await import("@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb");
+    const { streamWorkflowExecution } = await import("../resources/run/workflow-stream.js");
+    await streamWorkflowExecution({
+        client: client.stigmer,
+        executionId: id,
+        outputMode,
+        defaultAction: options.autoApprove === true ? ApprovalAction.APPROVE_ALL : parseApprovalAction(options.approveDefault ?? ""),
+    });
+}
+function stderrProgress() {
+    if (process.stderr.isTTY !== true)
+        return () => { };
+    return (line) => void process.stderr.write(`${line}\n`);
+}
+// Mount the agent picker; on selection, run the chosen agent through the
+// existing resolved-agent stack. Cancel (Esc/Ctrl+C → undefined) returns
+// cleanly so the command exits 0. Loaded lazily to honor the DD-001 boundary.
+async function browseAndRunAgent(initialQuery, options, org, outputMode, client) {
+    const { pickAgent } = await import("../resources/picker/ink.js");
+    const selected = await pickAgent({ client: client.stigmer, org, initialQuery });
+    if (selected === undefined)
+        return;
+    await runAgent(selected.id, options, org, outputMode, client);
+}
+// Off a TTY (pipes, CI, --json), the interactive picker can't run, so 0-arg and
+// unresolved references produce actionable guidance instead of a browse UI.
+function browseUnavailableError(query) {
+    const head = query === ""
+        ? "Interactive agent browsing requires an interactive terminal"
+        : `No agent found for "${query}"`;
+    return new UsageError(`${head}\n\n` +
+        "Specify a full agent reference:\n" +
+        "  stigmer run <org/slug>\n" +
+        "  stigmer run <agent-id>");
+}
+//# sourceMappingURL=run.js.map

package/commands/run.js.map

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

package/commands/search.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerSearch(program: Command): void;
+//# sourceMappingURL=search.d.ts.map

package/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWrD"}

package/commands/search.js

@@ -0,0 +1,73 @@
+// `stigmer search <type> <query>` — relevance-ranked text search over agents and
+// workflows. Thin handler: validate type/verb/flags, delegate to the resource
+// layer, then append the pagination footer for human output.
+import { ensureAuthenticated } from "../config/index.js";
+import { UsageError } from "../errors/index.js";
+import { defaultRegistry, Verb } from "../registry/index.js";
+import { addReadFlags, globalOrg, readFormat } from "./shared.js";
+const DEFAULT_PAGE = 1;
+const DEFAULT_PAGE_SIZE = 20;
+const MAX_PAGE_SIZE = 100;
+export function registerSearch(program) {
+    const search = program
+        .command("search <type> <query>")
+        .description("search resources by text query (supported types: agent, workflow)")
+        .option("--exclude-public", "exclude public/platform resources")
+        .option("--page <n>", "page number (1-indexed)", String(DEFAULT_PAGE))
+        .option("--page-size <n>", "results per page (max 100)", String(DEFAULT_PAGE_SIZE))
+        .action((type, query, options, command) => runSearch(type, query, options, command));
+    addReadFlags(search);
+}
+async function runSearch(type, query, options, command) {
+    const info = defaultRegistry().getByAlias(type);
+    if (info === undefined) {
+        throw new UsageError(`unknown resource type: ${type}\n\nAvailable types: agent, workflow`);
+    }
+    if (!info.supportedVerbs.has(Verb.Search)) {
+        throw new UsageError(`${info.displayName} does not support 'search'`);
+    }
+    if (query.trim() === "") {
+        throw new UsageError("search query is required");
+    }
+    const page = parsePositive(options.page, DEFAULT_PAGE, "--page");
+    const pageSize = parsePositive(options.pageSize, DEFAULT_PAGE_SIZE, "--page-size");
+    if (pageSize > MAX_PAGE_SIZE) {
+        throw new UsageError(`--page-size cannot exceed ${MAX_PAGE_SIZE}`);
+    }
+    const [{ connectBackend }, { searchResources }] = await Promise.all([
+        import("../backend.js"),
+        import("../resources/search.js"),
+    ]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    // Search defaults to all accessible orgs; only an explicit --org scopes it
+    // (mirrors the Go CLI, which leaves the org empty unless overridden).
+    const org = globalOrg(command) ?? "";
+    const format = readFormat(options);
+    const outcome = await searchResources(client.stigmer, info.kind, query, {
+        org,
+        excludePublic: options.excludePublic === true,
+        page,
+        pageSize,
+    }, format);
+    process.stdout.write(outcome.rendered);
+    // Pagination footer is human-only: appending it to json/yaml would corrupt
+    // the machine-readable payload (a latent wart in the Go CLI we don't copy).
+    if (format !== "json" && format !== "yaml" && outcome.totalPages > 1) {
+        process.stdout.write(`\nPage ${outcome.page} of ${outcome.totalPages} (total: ${outcome.totalCount})\n`);
+        if (outcome.page < outcome.totalPages) {
+            process.stdout.write(`Use --page ${outcome.page + 1} to see more results\n`);
+        }
+    }
+}
+function parsePositive(raw, fallback, flag) {
+    if (raw === undefined || raw === "")
+        return fallback;
+    if (!/^\d+$/.test(raw))
+        throw new UsageError(`invalid ${flag} value "${raw}"`);
+    const value = Number.parseInt(raw, 10);
+    if (value < 1)
+        throw new UsageError(`${flag} must be at least 1`);
+    return value;
+}
+//# sourceMappingURL=search.js.map