@orchagent/cli 0.3.89 → 0.3.91

package/dist/commands/completion.js

@@ -0,0 +1,379 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractCommands = extractCommands;
+exports.generateBash = generateBash;
+exports.generateZsh = generateZsh;
+exports.generateFish = generateFish;
+exports.generateCompletion = generateCompletion;
+exports.registerCompletionCommand = registerCompletionCommand;
+// --- Extraction ---
+function extractOptions(opts) {
+    return opts.map((o) => ({
+        long: o.long ?? null,
+        short: o.short ?? null,
+        description: o.description,
+    }));
+}
+function extractCommands(program) {
+    return program.commands
+        .filter((cmd) => cmd.name() !== 'completion')
+        .map((cmd) => ({
+        name: cmd.name(),
+        description: cmd.description(),
+        options: extractOptions(cmd.options),
+        subcommands: cmd.commands.map((sub) => ({
+            name: sub.name(),
+            description: sub.description(),
+            options: extractOptions(sub.options),
+        })),
+    }));
+}
+function extractGlobalOptions(program) {
+    return extractOptions(program.options);
+}
+// --- Helpers ---
+function longFlags(opts) {
+    return opts.filter((o) => o.long).map((o) => o.long);
+}
+/** Escape single quotes for embedding in shell strings */
+function esc(s) {
+    return s.replace(/'/g, "'\\''");
+}
+// --- Bash ---
+function generateBash(commands, globalOptions) {
+    const allNames = commands.map((c) => c.name).join(' ');
+    const globalFlags = [...longFlags(globalOptions), '--help', '--version'].join(' ');
+    // Build option-completion case arms
+    const optionArms = [];
+    for (const cmd of commands) {
+        const flags = [...longFlags(cmd.options), '--help'].join(' ');
+        if (cmd.subcommands.length > 0) {
+            const subArms = [];
+            for (const sub of cmd.subcommands) {
+                const subFlags = [...longFlags(sub.options), '--help'].join(' ');
+                subArms.push(`            ${sub.name}) opts="${subFlags}" ;;`);
+            }
+            subArms.push('            *) opts="--help" ;;');
+            optionArms.push([
+                `        ${cmd.name})`,
+                '          case "$subcmd" in',
+                ...subArms,
+                '          esac',
+                '          ;;',
+            ].join('\n'));
+        }
+        else {
+            optionArms.push(`        ${cmd.name}) opts="${flags}" ;;`);
+        }
+    }
+    // Build subcommand-completion case arms
+    const subArms = [];
+    for (const cmd of commands) {
+        if (cmd.subcommands.length > 0) {
+            const names = cmd.subcommands.map((s) => s.name).join(' ');
+            subArms.push(`    ${cmd.name}) COMPREPLY=($(compgen -W "${names}" -- "$cur")) ;;`);
+        }
+    }
+    const lines = [
+        '# orch shell completions — generated by: orch completion bash',
+        '#',
+        '# Setup (pick one):',
+        '#   eval "$(orch completion bash)"                                    # add to ~/.bashrc',
+        '#   orch completion bash > ~/.local/share/bash-completion/completions/orch  # persistent',
+        '',
+        '_orch() {',
+        '  local cur cmd subcmd i',
+        '  COMPREPLY=()',
+        '  cur="${COMP_WORDS[COMP_CWORD]}"',
+        '',
+        '  cmd=""',
+        '  subcmd=""',
+        '  for ((i=1; i < COMP_CWORD; i++)); do',
+        '    case "${COMP_WORDS[i]}" in',
+        '      -*) ;;',
+        '      *)',
+        '        if [[ -z "$cmd" ]]; then',
+        '          cmd="${COMP_WORDS[i]}"',
+        '        elif [[ -z "$subcmd" ]]; then',
+        '          subcmd="${COMP_WORDS[i]}"',
+        '        fi',
+        '        ;;',
+        '    esac',
+        '  done',
+        '',
+        '  if [[ "$cur" == -* ]]; then',
+        '    local opts=""',
+        '    if [[ -z "$cmd" ]]; then',
+        `      opts="${globalFlags}"`,
+        '    else',
+        '      case "$cmd" in',
+        ...optionArms,
+        '        *) opts="--help" ;;',
+        '      esac',
+        '    fi',
+        '    COMPREPLY=($(compgen -W "$opts" -- "$cur"))',
+        '    return 0',
+        '  fi',
+        '',
+        '  if [[ -z "$cmd" ]]; then',
+        `    COMPREPLY=($(compgen -W "${allNames}" -- "$cur"))`,
+        '    return 0',
+        '  fi',
+        '',
+        '  case "$cmd" in',
+        ...subArms,
+        '  esac',
+        '}',
+        '',
+        'complete -o default -F _orch orch',
+        'complete -o default -F _orch orchagent',
+        '',
+    ];
+    return lines.join('\n');
+}
+// --- Zsh ---
+function generateZsh(commands, globalOptions) {
+    // Build command descriptions for _describe
+    const cmdDescriptions = commands
+        .map((c) => `    '${esc(c.name)}:${esc(c.description)}'`)
+        .join('\n');
+    // Build global option specs for _arguments
+    const globalOptSpecs = [];
+    for (const opt of globalOptions) {
+        if (opt.long) {
+            globalOptSpecs.push(`    '${esc(opt.long)}[${esc(opt.description)}]'`);
+        }
+    }
+    globalOptSpecs.push("    '(--help -h)'{--help,-h}'[Show help]'");
+    globalOptSpecs.push("    '(--version -V)'{--version,-V}'[Show version]'");
+    // Build per-command argument completions
+    const commandCases = [];
+    for (const cmd of commands) {
+        if (cmd.subcommands.length > 0) {
+            // Subcommand group
+            const subDescs = cmd.subcommands
+                .map((s) => `          '${esc(s.name)}:${esc(s.description)}'`)
+                .join('\n');
+            const subArgsCases = [];
+            for (const sub of cmd.subcommands) {
+                const subOpts = [];
+                for (const opt of sub.options) {
+                    if (opt.long) {
+                        subOpts.push(`              '${esc(opt.long)}[${esc(opt.description)}]'`);
+                    }
+                }
+                subOpts.push("              '(--help -h)'{--help,-h}'[Show help]'");
+                subArgsCases.push([
+                    `            ${sub.name})`,
+                    '              _arguments \\',
+                    subOpts.join(' \\\n'),
+                    '              ;;',
+                ].join('\n'));
+            }
+            commandCases.push([
+                `        ${cmd.name})`,
+                '          local -a subcmds=(',
+                subDescs,
+                '          )',
+                '          _arguments -C \\',
+                "            '1:subcommand:->subcmd' \\",
+                "            '*::subarg:->subargs'",
+                '          case $state in',
+                '            subcmd)',
+                "              _describe -t subcommands 'subcommand' subcmds",
+                '              ;;',
+                '            subargs)',
+                '              case $line[1] in',
+                ...subArgsCases,
+                '                *)',
+                '                  _arguments \\',
+                "                    '(--help -h)'{--help,-h}'[Show help]'",
+                '                  ;;',
+                '              esac',
+                '              ;;',
+                '          esac',
+                '          ;;',
+            ].join('\n'));
+        }
+        else {
+            // Simple command
+            const cmdOpts = [];
+            for (const opt of cmd.options) {
+                if (opt.long) {
+                    cmdOpts.push(`          '${esc(opt.long)}[${esc(opt.description)}]'`);
+                }
+            }
+            cmdOpts.push("          '(--help -h)'{--help,-h}'[Show help]'");
+            commandCases.push([
+                `        ${cmd.name})`,
+                '          _arguments \\',
+                cmdOpts.join(' \\\n'),
+                '          ;;',
+            ].join('\n'));
+        }
+    }
+    const lines = [
+        '#compdef orch orchagent',
+        '#',
+        '# orch shell completions — generated by: orch completion zsh',
+        '#',
+        '# Setup (pick one):',
+        '#   eval "$(orch completion zsh)"                    # add to ~/.zshrc',
+        '#   orch completion zsh > "${fpath[1]}/_orch"        # persistent (then compinit)',
+        '',
+        '_orch() {',
+        '  local context state state_descr line',
+        '  typeset -A opt_args',
+        '',
+        '  local -a commands=(',
+        cmdDescriptions,
+        '  )',
+        '',
+        '  _arguments -C \\',
+        globalOptSpecs.join(' \\\n'),
+        " \\",
+        "    '1:command:->command' \\",
+        "    '*::arg:->args'",
+        '',
+        '  case $state in',
+        '    command)',
+        "      _describe -t commands 'orch command' commands",
+        '      ;;',
+        '    args)',
+        '      case $line[1] in',
+        ...commandCases,
+        '        *)',
+        '          _arguments \\',
+        "            '(--help -h)'{--help,-h}'[Show help]'",
+        '          ;;',
+        '      esac',
+        '      ;;',
+        '  esac',
+        '}',
+        '',
+        '_orch "$@"',
+        '',
+    ];
+    return lines.join('\n');
+}
+// --- Fish ---
+function generateFish(commands, globalOptions) {
+    const lines = [
+        '# orch shell completions — generated by: orch completion fish',
+        '#',
+        '# Setup (pick one):',
+        '#   orch completion fish | source                                          # add to config.fish',
+        '#   orch completion fish > ~/.config/fish/completions/orch.fish            # persistent',
+        '',
+        '# Disable file completions by default',
+        'complete -c orch -f',
+        'complete -c orchagent -f',
+        '',
+        '# Global options',
+    ];
+    for (const opt of globalOptions) {
+        if (opt.long) {
+            const flag = opt.long.replace(/^--/, '');
+            lines.push(`complete -c orch -l ${flag} -d '${esc(opt.description)}'`);
+            lines.push(`complete -c orchagent -l ${flag} -d '${esc(opt.description)}'`);
+        }
+    }
+    lines.push("complete -c orch -l help -d 'Show help'");
+    lines.push("complete -c orchagent -l help -d 'Show help'");
+    lines.push("complete -c orch -l version -d 'Show version'");
+    lines.push("complete -c orchagent -l version -d 'Show version'");
+    lines.push('');
+    lines.push('# Commands');
+    for (const cmd of commands) {
+        lines.push(`complete -c orch -n '__fish_use_subcommand' -a ${cmd.name} -d '${esc(cmd.description)}'`);
+        lines.push(`complete -c orchagent -n '__fish_use_subcommand' -a ${cmd.name} -d '${esc(cmd.description)}'`);
+    }
+    // Subcommands for command groups
+    const groups = commands.filter((c) => c.subcommands.length > 0);
+    if (groups.length > 0) {
+        lines.push('');
+        lines.push('# Subcommands');
+        for (const cmd of groups) {
+            const subNames = cmd.subcommands.map((s) => s.name);
+            const notSeen = subNames.join(' ');
+            for (const sub of cmd.subcommands) {
+                const cond = `__fish_seen_subcommand_from ${cmd.name}; and not __fish_seen_subcommand_from ${notSeen}`;
+                lines.push(`complete -c orch -n '${cond}' -a ${sub.name} -d '${esc(sub.description)}'`);
+                lines.push(`complete -c orchagent -n '${cond}' -a ${sub.name} -d '${esc(sub.description)}'`);
+            }
+        }
+    }
+    // Options per command
+    const commandsWithOptions = commands.filter((c) => c.options.length > 0 && c.subcommands.length === 0);
+    if (commandsWithOptions.length > 0) {
+        lines.push('');
+        lines.push('# Command options');
+        for (const cmd of commandsWithOptions) {
+            for (const opt of cmd.options) {
+                if (opt.long) {
+                    const flag = opt.long.replace(/^--/, '');
+                    lines.push(`complete -c orch -n '__fish_seen_subcommand_from ${cmd.name}' -l ${flag} -d '${esc(opt.description)}'`);
+                    lines.push(`complete -c orchagent -n '__fish_seen_subcommand_from ${cmd.name}' -l ${flag} -d '${esc(opt.description)}'`);
+                }
+            }
+        }
+    }
+    // Options for subcommand groups (on the group level)
+    const groupsWithOpts = commands.filter((c) => c.subcommands.length > 0);
+    const subOptsNeeded = groupsWithOpts.some((g) => g.subcommands.some((s) => s.options.length > 0));
+    if (subOptsNeeded) {
+        lines.push('');
+        lines.push('# Subcommand options');
+        for (const cmd of groupsWithOpts) {
+            for (const sub of cmd.subcommands) {
+                for (const opt of sub.options) {
+                    if (opt.long) {
+                        const flag = opt.long.replace(/^--/, '');
+                        lines.push(`complete -c orch -n '__fish_seen_subcommand_from ${cmd.name}; and __fish_seen_subcommand_from ${sub.name}' -l ${flag} -d '${esc(opt.description)}'`);
+                        lines.push(`complete -c orchagent -n '__fish_seen_subcommand_from ${cmd.name}; and __fish_seen_subcommand_from ${sub.name}' -l ${flag} -d '${esc(opt.description)}'`);
+                    }
+                }
+            }
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+// --- Dispatcher ---
+const SUPPORTED_SHELLS = ['bash', 'zsh', 'fish'];
+function generateCompletion(shell, program) {
+    const commands = extractCommands(program);
+    const globalOptions = extractGlobalOptions(program);
+    switch (shell) {
+        case 'bash':
+            return generateBash(commands, globalOptions);
+        case 'zsh':
+            return generateZsh(commands, globalOptions);
+        case 'fish':
+            return generateFish(commands, globalOptions);
+        default:
+            throw new Error(`Unsupported shell: ${shell}. Supported shells: ${SUPPORTED_SHELLS.join(', ')}`);
+    }
+}
+// --- Command Registration ---
+function registerCompletionCommand(program) {
+    program
+        .command('completion')
+        .argument('<shell>', `Shell type (${SUPPORTED_SHELLS.join(', ')})`)
+        .description('Generate shell completion script')
+        .addHelpText('after', `
+Examples:
+  orch completion bash    Generate bash completions
+  orch completion zsh     Generate zsh completions
+  orch completion fish    Generate fish completions
+
+Setup:
+  eval "$(orch completion bash)"                                    # bash (add to ~/.bashrc)
+  eval "$(orch completion zsh)"                                     # zsh  (add to ~/.zshrc)
+  orch completion fish | source                                     # fish (add to config.fish)
+`)
+        .action((shell) => {
+        const script = generateCompletion(shell, program);
+        process.stdout.write(script);
+    });
+}

package/dist/commands/dag.js

@@ -16,15 +16,24 @@ const spinner_1 = require("../lib/spinner");
 async function resolveWorkspaceId(config, slug) {
     const configFile = await (0, config_1.loadConfig)();
     const targetSlug = slug ?? configFile.workspace;
-    if (!targetSlug) {
-        throw new errors_1.CliError('No workspace specified. Use --workspace <slug> or run `orch workspace use <slug>` first.');
-    }
     const response = await (0, api_1.request)(config, 'GET', '/workspaces');
-    const workspace = response.workspaces.find((w) => w.slug === targetSlug);
-    if (!workspace) {
-        throw new errors_1.CliError(`Workspace '${targetSlug}' not found.`);
+    if (targetSlug) {
+        const workspace = response.workspaces.find((w) => w.slug === targetSlug);
+        if (!workspace) {
+            throw new errors_1.CliError(`Workspace '${targetSlug}' not found.`);
+        }
+        return workspace.id;
+    }
+    // No workspace specified — auto-select if user has exactly one
+    if (response.workspaces.length === 0) {
+        throw new errors_1.CliError('No workspaces found. Create one with `orch workspace create <name>`.');
+    }
+    if (response.workspaces.length === 1) {
+        return response.workspaces[0].id;
     }
-    return workspace.id;
+    const slugs = response.workspaces.map((w) => w.slug).join(', ');
+    throw new errors_1.CliError(`Multiple workspaces available: ${slugs}\n` +
+        'Specify one with --workspace <slug> or run `orch workspace use <slug>`.');
 }
 function isUuid(value) {
     return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value);

package/dist/commands/delete.js

@@ -42,21 +42,26 @@ Examples:
         if (!config.apiKey) {
             throw new errors_1.CliError('Not logged in. Run `orchagent login` first.');
         }
+        const configFile = await (0, config_1.loadConfig)();
+        const org = ref.org ?? configFile.workspace ?? config.defaultOrg;
+        if (!org) {
+            throw new errors_1.CliError('Missing org. Use org/agent format or set default org.');
+        }
         // Resolve workspace context for the target org
-        const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(config, ref.org);
+        const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(config, org);
         process.stdout.write('Finding agent...\n');
         // Find the agent by name, filtering by org if provided
         const agents = await (0, api_1.listMyAgents)(config, workspaceId);
-        const matching = agents.filter(a => a.name === ref.agent && (!a.org_slug || a.org_slug === ref.org));
+        const matching = agents.filter(a => a.name === ref.agent && (!a.org_slug || a.org_slug === org));
         if (matching.length === 0) {
-            throw new errors_1.CliError(`Agent '${ref.org}/${ref.agent}' not found`);
+            throw new errors_1.CliError(`Agent '${org}/${ref.agent}' not found`);
         }
         // Select version
         let selectedAgent;
         if (ref.version !== 'latest') {
             selectedAgent = matching.find(a => a.version === ref.version);
             if (!selectedAgent) {
-                throw new errors_1.CliError(`Version '${ref.version}' not found for agent '${ref.org}/${ref.agent}'`);
+                throw new errors_1.CliError(`Version '${ref.version}' not found for agent '${org}/${ref.agent}'`);
             }
         }
         else {

package/dist/commands/diff.js

@@ -9,6 +9,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const agent_ref_1 = require("../lib/agent-ref");
+const errors_1 = require("../lib/errors");
 const spinner_1 = require("../lib/spinner");
 // ── Helpers ────────────────────────────────────────────────────
 function extractDependencies(manifest) {
@@ -369,7 +370,8 @@ function printDiffs(refA, refB, diffs) {
 function parseSecondRef(value, firstOrg, firstName) {
     // If it contains '/', treat as full ref
     if (value.includes('/')) {
-        return (0, agent_ref_1.parseAgentRef)(value);
+        const parsed = (0, agent_ref_1.parseAgentRef)(value);
+        return { org: parsed.org ?? firstOrg, agent: parsed.agent, version: parsed.version };
     }
     // Otherwise treat as a version shorthand for the same agent
     return { org: firstOrg, agent: firstName, version: value };
@@ -382,7 +384,13 @@ function registerDiffCommand(program) {
         .option('--json', 'Output as JSON')
         .action(async (ref1Arg, ref2Arg, options) => {
         const config = await (0, config_1.getResolvedConfig)();
-        const ref1 = (0, agent_ref_1.parseAgentRef)(ref1Arg);
+        const ref1Raw = (0, agent_ref_1.parseAgentRef)(ref1Arg);
+        const configFile = await (0, config_1.loadConfig)();
+        const ref1Org = ref1Raw.org ?? configFile.workspace ?? config.defaultOrg;
+        if (!ref1Org) {
+            throw new errors_1.CliError('Missing org. Use org/agent format or set default org.');
+        }
+        const ref1 = { org: ref1Org, agent: ref1Raw.agent, version: ref1Raw.version };
         let ref2;
         if (ref2Arg) {
             ref2 = parseSecondRef(ref2Arg, ref1.org, ref1.agent);

package/dist/commands/estimate.js

@@ -35,11 +35,14 @@ function registerEstimateCommand(program) {
         .option('--json', 'Output as JSON')
         .action(async (agentArg, options) => {
         const config = await (0, config_1.getResolvedConfig)();
-        const { org, agent, version } = (0, agent_ref_1.parseAgentRef)(agentArg);
+        const parsed = (0, agent_ref_1.parseAgentRef)(agentArg);
+        const configFile = await (0, config_1.loadConfig)();
+        const org = parsed.org ?? configFile.workspace ?? config.defaultOrg;
         if (!org) {
-            process.stderr.write(chalk_1.default.red('Error: org/agent format required (e.g. myorg/my-agent)\n'));
+            process.stderr.write(chalk_1.default.red('Error: Missing org. Use org/agent format or set default org.\n'));
             process.exit(1);
         }
+        const { agent, version } = parsed;
         let data;
         try {
             data = await (0, api_1.getAgentCostEstimate)(config, org, agent, version);

package/dist/commands/fork.js

@@ -56,7 +56,13 @@ Examples:
         if (!config.apiKey) {
             throw new errors_1.CliError('Not logged in. Run `orchagent login` first.');
         }
-        const { org, agent, version } = (0, agent_ref_1.parseAgentRef)(agentRef);
+        const parsed = (0, agent_ref_1.parseAgentRef)(agentRef);
+        const configFile = await (0, config_1.loadConfig)();
+        const org = parsed.org ?? configFile.workspace ?? config.defaultOrg;
+        if (!org) {
+            throw new errors_1.CliError('Missing org. Use org/agent format or set default org.');
+        }
+        const { agent, version } = parsed;
         write('Resolving source agent...\n');
         const source = await (0, api_1.getAgentWithFallback)(config, org, agent, version);
         if (!source.id) {

package/dist/commands/index.js

@@ -42,6 +42,7 @@ const replay_1 = require("./replay");
 const trace_1 = require("./trace");
 const metrics_1 = require("./metrics");
 const dag_1 = require("./dag");
+const completion_1 = require("./completion");
 function registerCommands(program) {
     (0, login_1.registerLoginCommand)(program);
     (0, logout_1.registerLogoutCommand)(program);
@@ -84,4 +85,5 @@ function registerCommands(program) {
     (0, trace_1.registerTraceCommand)(program);
     (0, metrics_1.registerMetricsCommand)(program);
     (0, dag_1.registerDagCommand)(program);
+    (0, completion_1.registerCompletionCommand)(program);
 }

package/dist/commands/info.js

@@ -8,6 +8,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const agent_ref_1 = require("../lib/agent-ref");
+const errors_1 = require("../lib/errors");
 function formatSchema(schema, indent = '  ') {
     const lines = [];
     const props = schema.properties || {};
@@ -147,7 +148,13 @@ function registerInfoCommand(program) {
         .option('--json', 'Output as JSON')
         .action(async (agentArg, options) => {
         const config = await (0, config_1.getResolvedConfig)();
-        const { org, agent, version } = (0, agent_ref_1.parseAgentRef)(agentArg);
+        const parsed = (0, agent_ref_1.parseAgentRef)(agentArg);
+        const configFile = await (0, config_1.loadConfig)();
+        const org = parsed.org ?? configFile.workspace ?? config.defaultOrg;
+        if (!org) {
+            throw new errors_1.CliError('Missing org. Use org/agent format or set default org.');
+        }
+        const { agent, version } = parsed;
         // Resolve workspace context for the target org
         const workspaceId = await (0, api_1.resolveWorkspaceIdForOrg)(config, org);
         // Fetch agent metadata