@orchagent/cli 0.2.23 → 0.2.25

package/dist/commands/call.js

@@ -100,6 +100,7 @@ function registerCallCommand(program) {
         .option('--endpoint <endpoint>', 'Override agent endpoint')
         .option('--tenant <tenant>', 'Tenant identifier for multi-tenant callers')
         .option('--data <json>', 'JSON payload (string or @file, @- for stdin)')
+        .option('--input <json>', 'Alias for --data')
         .option('--key <key>', 'LLM API key (overrides env vars)')
         .option('--provider <provider>', 'LLM provider (openai, anthropic, gemini)')
         .option('--json', 'Output raw JSON')
@@ -119,6 +120,9 @@ Examples:
 Note: Use 'call' for server-side execution (requires login), 'run' for local execution.
 `)
         .action(async (agentRef, file, options) => {
+        // Merge --input alias into --data
+        const dataValue = options.data || options.input;
+        options.data = dataValue;
         const resolved = await (0, config_1.getResolvedConfig)();
         if (!resolved.apiKey) {
             throw new errors_1.CliError('Missing API key. Run `orchagent login` first.');

package/dist/commands/docs.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDocsCommand = registerDocsCommand;
+const open_1 = __importDefault(require("open"));
+const DOCS_BASE = 'https://docs.orchagent.io';
+const DOCS_ROUTES = {
+    '': '/',
+    'cli': '/using-agents/cli-commands',
+    'agents': '/building-agents/agent-types',
+    'skills': '/building-agents/orchestration',
+    'sdk': '/building-agents/sdk',
+    'api': '/api-reference/overview',
+    'quickstart': '/quickstart',
+};
+function registerDocsCommand(program) {
+    program
+        .command('docs')
+        .description('Open documentation in browser')
+        .argument('[topic]', 'Topic: cli, agents, skills, sdk, api, quickstart')
+        .action(async (topic) => {
+        if (topic && !(topic in DOCS_ROUTES)) {
+            const validTopics = Object.keys(DOCS_ROUTES).filter(k => k).join(', ');
+            process.stderr.write(`Unknown topic "${topic}". Valid topics: ${validTopics}\n`);
+            process.stderr.write('Opening docs homepage instead.\n\n');
+        }
+        const route = DOCS_ROUTES[topic ?? ''] ?? '/';
+        const url = `${DOCS_BASE}${route}`;
+        process.stdout.write(`Opening ${url}\n`);
+        await (0, open_1.default)(url);
+    });
+}

package/dist/commands/index.js

@@ -20,6 +20,7 @@ const doctor_1 = require("./doctor");
 const status_1 = require("./status");
 const workspace_1 = require("./workspace");
 const tree_1 = require("./tree");
+const docs_1 = require("./docs");
 function registerCommands(program) {
     (0, login_1.registerLoginCommand)(program);
     (0, whoami_1.registerWhoamiCommand)(program);
@@ -40,4 +41,5 @@ function registerCommands(program) {
     (0, status_1.registerStatusCommand)(program);
     (0, workspace_1.registerWorkspaceCommand)(program);
     (0, tree_1.registerTreeCommand)(program);
+    (0, docs_1.registerDocsCommand)(program);
 }

package/dist/commands/keys.js

@@ -38,7 +38,7 @@ const readline = __importStar(require("readline"));
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const errors_1 = require("../lib/errors");
-const VALID_PROVIDERS = ['openai', 'anthropic', 'gemini'];
+const VALID_PROVIDERS = ['openai', 'anthropic', 'gemini', 'ollama'];
 async function promptForKey(provider) {
     // Use hidden input to avoid exposing keys in terminal history/logs
     return new Promise((resolve, reject) => {
@@ -113,7 +113,7 @@ async function listKeys(config) {
     if (keys.length === 0) {
         process.stdout.write('No LLM keys configured.\n');
         process.stdout.write('\nAdd a key with: orchagent keys add <provider>\n');
-        process.stdout.write('Providers: openai, anthropic, gemini\n');
+        process.stdout.write('Providers: openai, anthropic, gemini, ollama\n');
         return;
     }
     process.stdout.write('Configured LLM keys:\n\n');

package/dist/commands/run.js

@@ -176,6 +176,7 @@ async function promptUserForDeps(depStatuses) {
         process.stderr.write(`  [2] Download ${downloadableCount} available deps, run locally\n`);
     }
     process.stderr.write('  [3] Cancel\n\n');
+    process.stderr.write('Tip: Use --with-deps to skip this prompt in scripts.\n\n');
     return new Promise((resolve) => {
         rl.question('Choose [1/2/3]: ', (answer) => {
             rl.close();
@@ -233,16 +234,26 @@ async function downloadDependenciesRecursively(config, depStatuses, visited = ne
         }
     }
 }
-async function executePromptLocally(agentData, inputData, skillPrompts = [], config) {
-    const detected = await (0, llm_1.detectLlmKey)(agentData.supported_providers, config);
+async function executePromptLocally(agentData, inputData, skillPrompts = [], config, providerOverride) {
+    // If provider override specified, validate and use only that provider
+    if (providerOverride) {
+        (0, llm_1.validateProvider)(providerOverride);
+    }
+    // Determine which providers to check for keys
+    const providersToCheck = providerOverride
+        ? [providerOverride]
+        : agentData.supported_providers;
+    const detected = await (0, llm_1.detectLlmKey)(providersToCheck, config);
     if (!detected) {
-        const providers = agentData.supported_providers.join(', ');
-        throw new errors_1.CliError(`No LLM key found. This agent requires: ${providers}\n` +
+        const providers = providersToCheck.join(', ');
+        throw new errors_1.CliError(`No LLM key found for: ${providers}\n` +
             `Set an environment variable (e.g., OPENAI_API_KEY) or configure in web dashboard`);
     }
     const { provider, key, model: serverModel } = detected;
     // Priority: server config model > agent default model > hardcoded default
     const model = serverModel || agentData.default_models?.[provider] || (0, llm_1.getDefaultModel)(provider);
+    // Show which provider is being used (helpful for debugging rate limits)
+    process.stderr.write(`Running with ${provider} (${model})...\n`);
     // Combine skill prompts with agent prompt (skills first, then agent)
     let basePrompt = agentData.prompt || '';
     if (skillPrompts.length > 0) {
@@ -663,12 +674,16 @@ function registerRunCommand(program) {
         .description('Download and run an agent locally')
         .option('--local', 'Run locally using local LLM keys (default for run command)')
         .option('--input <json>', 'JSON input data')
+        .option('--data <json>', 'Alias for --input')
         .option('--download-only', 'Just download the agent, do not execute')
         .option('--with-deps', 'Automatically download all dependencies (skip prompt)')
         .option('--json', 'Output raw JSON')
         .option('--skills <skills>', 'Add skills (comma-separated)')
         .option('--skills-only <skills>', 'Use only these skills')
         .option('--no-skills', 'Ignore default skills')
+        .option('--here', 'Shorthand for --input \'{"path": "."}\'')
+        .option('--path <dir>', 'Shorthand for --input \'{"path": "<dir>"}\'')
+        .option('--provider <name>', 'LLM provider to use (openai, anthropic, gemini, ollama)')
         .addHelpText('after', `
 Examples:
   orch run orchagent/leak-finder --input '{"path": "."}'
@@ -679,6 +694,17 @@ Examples:
 Note: Use 'run' for local execution, 'call' for server-side execution.
 `)
         .action(async (agentRef, args, options) => {
+        // Merge --data alias into --input
+        if (options.data && !options.input) {
+            options.input = options.data;
+        }
+        // Handle --here and --path shortcuts
+        if (options.here) {
+            options.input = JSON.stringify({ path: process.cwd() });
+        }
+        else if (options.path) {
+            options.input = JSON.stringify({ path: options.path });
+        }
         const resolved = await (0, config_1.getResolvedConfig)();
         const parsed = parseAgentRef(agentRef);
         const org = parsed.org ?? resolved.defaultOrg;
@@ -819,7 +845,7 @@ Note: Use 'run' for local execution, 'call' for server-side execution.
         }
         // Execute locally
         process.stderr.write(`Executing locally...\n\n`);
-        const result = await executePromptLocally(agentData, inputData, skillPrompts, resolved);
+        const result = await executePromptLocally(agentData, inputData, skillPrompts, resolved, options.provider);
         if (options.json) {
             (0, output_1.printJson)(result);
         }

package/dist/commands/search.js

@@ -5,7 +5,6 @@ const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const output_1 = require("../lib/output");
 const analytics_1 = require("../lib/analytics");
-const errors_1 = require("../lib/errors");
 const DEFAULT_LIMIT = 20;
 function registerSearchCommand(program) {
     program
@@ -20,14 +19,9 @@ function registerSearchCommand(program) {
         .action(async (query, options) => {
         const config = await (0, config_1.getResolvedConfig)();
         const limit = parseInt(options.limit, 10) || DEFAULT_LIMIT;
-        // Require query OR --popular/--recent
+        // Default to popular when no args
         if (!query && !options.popular && !options.recent) {
-            throw new errors_1.CliError('Search requires a query or flag.\n\n' +
-                'Usage:\n' +
-                '  orchagent search <query>     Search by keyword\n' +
-                '  orchagent search --popular   Top agents by stars\n' +
-                '  orchagent search --recent    Most recently published\n\n' +
-                'Browse all agents at: https://orchagent.io/explore');
+            options.popular = true;
         }
         let agents;
         if (query) {
@@ -67,5 +61,6 @@ function registerSearchCommand(program) {
         if (agents.length === limit) {
             process.stdout.write(`\nShowing top ${limit} results. Use --limit <n> for more.\n`);
         }
+        process.stdout.write('\nTip: Run "orchagent info <agent>" to see input schema and details.\n');
     });
 }

package/dist/commands/status.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerStatusCommand = registerStatusCommand;
 const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
 const output_1 = require("../lib/output");
 const STATUS_URL = 'https://api.orchagent.io/health/detailed';
 const STATUS_PAGE_URL = 'https://status.orchagent.io';
@@ -86,6 +87,22 @@ function registerStatusCommand(program) {
                 return;
             }
             printHumanStatus(data);
+            // Also verify actual API connectivity
+            const config = await (0, config_1.getResolvedConfig)();
+            const apiUrl = `${config.apiUrl.replace(/\/$/, '')}/health`;
+            try {
+                const apiResponse = await fetch(apiUrl, {
+                    signal: AbortSignal.timeout(5000),
+                });
+                if (!apiResponse.ok) {
+                    process.stderr.write('\n' + chalk_1.default.yellow('⚠️  Status page shows operational, but API returned error.') + '\n');
+                    process.stderr.write('   Run "orchagent doctor" for detailed diagnostics.\n');
+                }
+            }
+            catch {
+                process.stderr.write('\n' + chalk_1.default.yellow('⚠️  Status page shows operational, but could not reach API.') + '\n');
+                process.stderr.write('   Run "orchagent doctor" for detailed diagnostics.\n');
+            }
         }
         catch (err) {
             if (options.json) {

package/dist/index.js

@@ -60,6 +60,11 @@ Quick Reference:
   run   Download and run an agent locally (your machine)
   call  Execute an agent on orchagent servers (requires login)
   info  Show agent details and input/output schemas
+
+Documentation: https://docs.orchagent.io
+  orchagent docs         Open docs in browser
+  orchagent docs cli     CLI command reference
+  orchagent docs agents  Building agents guide
 `);
 (0, commands_1.registerCommands)(program);
 program

package/dist/lib/doctor/checks/llm.js

@@ -39,6 +39,17 @@ async function checkServerLlmKeys() {
             };
         }
         const providers = keys.map((k) => k.provider);
+        // Warn if only one provider configured (no fallback for rate limits)
+        if (keys.length === 1) {
+            return {
+                category: 'llm',
+                name: 'server_llm_keys',
+                status: 'warning',
+                message: `Only 1 LLM provider configured (${providers[0]}). Consider adding a backup for rate limit fallback.`,
+                fix: 'Run: orchagent keys add <provider>',
+                details: { count: keys.length, providers },
+            };
+        }
         return {
             category: 'llm',
             name: 'server_llm_keys',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "description": "Command-line interface for the orchagent AI agent marketplace",
   "license": "MIT",
   "author": "orchagent <hello@orchagent.io>",