npm - @orchagent/cli - Versions diffs - 0.2.22 → 0.2.24 - Mend

@orchagent/cli 0.2.22 → 0.2.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

package/README.md +2 -2
package/dist/commands/call.js +4 -0
package/dist/commands/docs.js +34 -0
package/dist/commands/doctor.js +1 -1
package/dist/commands/github.js +2 -2
package/dist/commands/index.js +2 -0
package/dist/commands/keys.js +2 -2
package/dist/commands/login.js +1 -1
package/dist/commands/publish.js +164 -37
package/dist/commands/run.js +29 -5
package/dist/commands/search.js +2 -8
package/dist/commands/skill.js +6 -0
package/dist/commands/status.js +19 -2
package/dist/index.js +7 -2
package/dist/lib/api.js +13 -0
package/dist/lib/browser-auth.js +2 -2
package/dist/lib/bundle.js +2 -2
package/dist/lib/doctor/checks/connectivity.js +1 -1
package/dist/lib/doctor/checks/llm.js +11 -0
package/dist/lib/doctor/output.js +1 -1
package/package.json +3 -3

package/README.md CHANGED Viewed

@@ -1,6 +1,6 @@
-# OrchAgent CLI
+# orchagent CLI
-Minimal CLI for interacting with the OrchAgent platform.
+Minimal CLI for interacting with the orchagent platform.
 ## Commands

package/dist/commands/call.js CHANGED Viewed

@@ -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 ADDED Viewed

@@ -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/doctor.js CHANGED Viewed

@@ -6,7 +6,7 @@ const output_1 = require("../lib/output");
 function registerDoctorCommand(program) {
     program
         .command('doctor')
-        .description('Diagnose setup issues with OrchAgent CLI')
+        .description('Diagnose setup issues with orchagent CLI')
         .option('-v, --verbose', 'Show detailed output for each check')
         .option('--json', 'Output results as JSON')
         .action(async (options) => {

package/dist/commands/github.js CHANGED Viewed

@@ -55,7 +55,7 @@ function successHtml() {
 <html>
 <head>
   <meta charset="utf-8">
-  <title>OrchAgent CLI - GitHub Connected</title>
+  <title>orchagent CLI - GitHub Connected</title>
   <style>
     body {
       font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
@@ -114,7 +114,7 @@ function errorHtml(message) {
 <html>
 <head>
   <meta charset="utf-8">
-  <title>OrchAgent CLI - GitHub Connection Error</title>
+  <title>orchagent CLI - GitHub Connection Error</title>
   <style>
     body {
       font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;

package/dist/commands/index.js CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/login.js CHANGED Viewed

@@ -23,7 +23,7 @@ async function promptForKey() {
 function registerLoginCommand(program) {
     program
         .command('login')
-        .description('Authenticate with OrchAgent via browser or API key')
+        .description('Authenticate with orchagent via browser or API key')
         .option('--key <key>', 'API key (for CI/CD, non-interactive)')
         .option('--port <port>', `Localhost port for browser callback (default: ${DEFAULT_AUTH_PORT})`, String(DEFAULT_AUTH_PORT))
         .action(async (options) => {

package/dist/commands/publish.js CHANGED Viewed

@@ -13,6 +13,36 @@ const api_1 = require("../lib/api");
 const errors_1 = require("../lib/errors");
 const analytics_1 = require("../lib/analytics");
 const bundle_1 = require("../lib/bundle");
+/**
+ * Handle security flagged error response (422 with error: 'content_flagged')
+ * Returns true if the error was handled, false otherwise
+ */
+function handleSecurityFlaggedError(err) {
+    if (!(err instanceof api_1.ApiError) || err.status !== 422) {
+        return false;
+    }
+    const payload = err.payload;
+    if (payload?.error !== 'content_flagged') {
+        return false;
+    }
+    process.stderr.write('\n');
+    process.stderr.write('Error: Skill flagged for security review\n\n');
+    if (payload.concerns && payload.concerns.length > 0) {
+        process.stderr.write('Concerns found:\n');
+        for (const concern of payload.concerns) {
+            const severityLabel = concern.severity.toUpperCase();
+            const fileInfo = concern.file_path ? ` in ${concern.file_path}` : '';
+            process.stderr.write(`  [${severityLabel}] ${concern.category}${fileInfo}\n`);
+            process.stderr.write(`    "${concern.description}"\n\n`);
+        }
+    }
+    if (payload.summary) {
+        process.stderr.write(`Summary: ${payload.summary}\n\n`);
+    }
+    process.stderr.write('Please review and remove suspicious patterns before publishing.\n');
+    process.stderr.write('If you believe this is a false positive, contact support@orchagent.com\n');
+    return true;
+}
 /**
  * Check if orchagent-sdk is listed in requirements.txt or pyproject.toml
  */
@@ -60,6 +90,65 @@ async function parseSkillMd(filePath) {
         return null;
     }
 }
+/**
+ * Binary file extensions to skip when collecting skill files (SC-05)
+ */
+const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.ico', '.webp', '.bmp', '.tiff',
+    '.pdf', '.zip', '.tar', '.gz', '.7z', '.rar',
+    '.exe', '.dll', '.so', '.dylib', '.bin',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf',
+    '.mp3', '.mp4', '.wav', '.avi', '.mov', '.mkv',
+    '.pyc', '.pyo', '.class', '.o', '.obj',
+]);
+/**
+ * Collect all text files in the skill directory for SC-05 multi-file support
+ */
+async function collectSkillFiles(skillDir, maxFiles = 20, maxTotalSize = 500_000) {
+    const files = [];
+    let totalSize = 0;
+    async function walkDir(dir, relativePath = '') {
+        if (files.length >= maxFiles || totalSize >= maxTotalSize)
+            return;
+        const entries = await promises_1.default.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (files.length >= maxFiles || totalSize >= maxTotalSize)
+                break;
+            const fullPath = path_1.default.join(dir, entry.name);
+            const relPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+            // Skip hidden files and common non-content directories
+            if (entry.name.startsWith('.') || entry.name === 'node_modules' || entry.name === '__pycache__') {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await walkDir(fullPath, relPath);
+            }
+            else if (entry.isFile()) {
+                // Skip binary files
+                const ext = path_1.default.extname(entry.name).toLowerCase();
+                if (BINARY_EXTENSIONS.has(ext))
+                    continue;
+                try {
+                    const stat = await promises_1.default.stat(fullPath);
+                    if (totalSize + stat.size > maxTotalSize)
+                        continue;
+                    const content = await promises_1.default.readFile(fullPath, 'utf-8');
+                    files.push({
+                        path: relPath,
+                        content,
+                        size: stat.size,
+                    });
+                    totalSize += stat.size;
+                }
+                catch {
+                    // Skip files that can't be read (binary, permissions, etc.)
+                }
+            }
+        }
+    }
+    await walkDir(skillDir);
+    return files;
+}
 function registerPublishCommand(program) {
     program
         .command('publish')
@@ -86,10 +175,14 @@ function registerPublishCommand(program) {
         if (skillData) {
             // Publish as a skill (server auto-assigns version)
             const org = await (0, api_1.getOrg)(config);
+            // SC-05: Collect all files in the skill directory for multi-file support
+            const skillFiles = await collectSkillFiles(cwd);
+            const hasMultipleFiles = skillFiles.length > 1;
             // Handle dry-run for skills
             if (options.dryRun) {
                 const preview = await (0, api_1.previewAgentVersion)(config, skillData.frontmatter.name);
                 const skillBodyBytes = Buffer.byteLength(skillData.body, 'utf-8');
+                const totalFilesSize = skillFiles.reduce((sum, f) => sum + f.size, 0);
                 const versionInfo = preview.existing_versions.length > 0
                     ? `${preview.next_version} (new version, ${preview.existing_versions[preview.existing_versions.length - 1]} exists)`
                     : `${preview.next_version} (first version)`;
@@ -97,6 +190,9 @@ function registerPublishCommand(program) {
                 process.stderr.write('Validating...\n');
                 process.stderr.write(`  ✓ SKILL.md found and valid\n`);
                 process.stderr.write(`  ✓ Skill prompt (${skillBodyBytes.toLocaleString()} bytes)\n`);
+                if (hasMultipleFiles) {
+                    process.stderr.write(`  ✓ Skill files: ${skillFiles.length} files (${(totalFilesSize / 1024).toFixed(1)} KB)\n`);
+                }
                 process.stderr.write(`  ✓ Authentication valid (org: ${org.slug})\n`);
                 process.stderr.write('\nSkill Preview:\n');
                 process.stderr.write(`  Name:        ${skillData.frontmatter.name}\n`);
@@ -104,25 +200,47 @@ function registerPublishCommand(program) {
                 process.stderr.write(`  Version:     ${versionInfo}\n`);
                 process.stderr.write(`  Visibility:  ${options.public ? 'public' : 'private'}\n`);
                 process.stderr.write(`  Providers:   any\n`);
+                if (hasMultipleFiles) {
+                    process.stderr.write(`  Files:       ${skillFiles.length} files\n`);
+                    for (const f of skillFiles.slice(0, 5)) {
+                        process.stderr.write(`               - ${f.path}\n`);
+                    }
+                    if (skillFiles.length > 5) {
+                        process.stderr.write(`               ... and ${skillFiles.length - 5} more\n`);
+                    }
+                }
                 process.stderr.write(`\nWould publish: ${preview.org_slug}/${skillData.frontmatter.name}@${preview.next_version}\n`);
                 process.stderr.write(`API endpoint: POST ${config.apiUrl}/${preview.org_slug}/${skillData.frontmatter.name}/${preview.next_version}/run\n\n`);
                 process.stderr.write('No changes made (dry run)\n');
                 return;
             }
-            const skillResult = await (0, api_1.createAgent)(config, {
-                name: skillData.frontmatter.name,
-                type: 'skill',
-                description: skillData.frontmatter.description,
-                prompt: skillData.body,
-                is_public: options.public ? true : false,
-                supported_providers: ['any'],
-                default_skills: skillsFromFlag,
-                skills_locked: options.skillsLocked || undefined,
-            });
-            const skillVersion = skillResult.agent?.version || 'v1';
-            await (0, analytics_1.track)('cli_publish', { agent_type: 'skill' });
-            process.stdout.write(`\nPublished skill: ${org.slug}/${skillData.frontmatter.name}@${skillVersion}\n`);
-            process.stdout.write(`Public: ${options.public ? 'yes' : 'no'}\n`);
+            try {
+                const skillResult = await (0, api_1.createAgent)(config, {
+                    name: skillData.frontmatter.name,
+                    type: 'skill',
+                    description: skillData.frontmatter.description,
+                    prompt: skillData.body,
+                    is_public: options.public ? true : false,
+                    supported_providers: ['any'],
+                    default_skills: skillsFromFlag,
+                    skills_locked: options.skillsLocked || undefined,
+                    // SC-05: Include all skill files for UI preview
+                    skill_files: hasMultipleFiles ? skillFiles : undefined,
+                });
+                const skillVersion = skillResult.agent?.version || 'v1';
+                await (0, analytics_1.track)('cli_publish', { agent_type: 'skill', multi_file: hasMultipleFiles });
+                process.stdout.write(`\nPublished skill: ${org.slug}/${skillData.frontmatter.name}@${skillVersion}\n`);
+                if (hasMultipleFiles) {
+                    process.stdout.write(`Files: ${skillFiles.length} files included\n`);
+                }
+                process.stdout.write(`Public: ${options.public ? 'yes' : 'no'}\n`);
+            }
+            catch (err) {
+                if (handleSecurityFlaggedError(err)) {
+                    process.exit(1);
+                }
+                throw err;
+            }
             return;
         }
         // Read manifest
@@ -290,29 +408,38 @@ function registerPublishCommand(program) {
             return;
         }
         // Create the agent (server auto-assigns version)
-        const result = await (0, api_1.createAgent)(config, {
-            name: manifest.name,
-            type: manifest.type,
-            description: manifest.description,
-            prompt,
-            url: agentUrl,
-            input_schema: inputSchema,
-            output_schema: outputSchema,
-            tags: manifest.tags,
-            is_public: options.public ? true : false,
-            supported_providers: supportedProviders,
-            default_models: manifest.default_models,
-            // Local run fields for code agents
-            source_url: manifest.source_url,
-            pip_package: manifest.pip_package,
-            run_command: manifest.run_command,
-            // SDK compatibility flag
-            sdk_compatible: sdkCompatible || undefined,
-            // Orchestration manifest (includes dependencies)
-            manifest: manifest.manifest,
-            default_skills: skillsFromFlag || manifest.default_skills,
-            skills_locked: manifest.skills_locked || options.skillsLocked || undefined,
-        });
+        let result;
+        try {
+            result = await (0, api_1.createAgent)(config, {
+                name: manifest.name,
+                type: manifest.type,
+                description: manifest.description,
+                prompt,
+                url: agentUrl,
+                input_schema: inputSchema,
+                output_schema: outputSchema,
+                tags: manifest.tags,
+                is_public: options.public ? true : false,
+                supported_providers: supportedProviders,
+                default_models: manifest.default_models,
+                // Local run fields for code agents
+                source_url: manifest.source_url,
+                pip_package: manifest.pip_package,
+                run_command: manifest.run_command,
+                // SDK compatibility flag
+                sdk_compatible: sdkCompatible || undefined,
+                // Orchestration manifest (includes dependencies)
+                manifest: manifest.manifest,
+                default_skills: skillsFromFlag || manifest.default_skills,
+                skills_locked: manifest.skills_locked || options.skillsLocked || undefined,
+            });
+        }
+        catch (err) {
+            if (handleSecurityFlaggedError(err)) {
+                process.exit(1);
+            }
+            throw err;
+        }
         const assignedVersion = result.agent?.version || 'v1';
         const agentId = result.agent?.id;
         // Upload code bundle if this is a hosted code agent

package/dist/commands/run.js CHANGED Viewed

@@ -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,11 +234,19 @@ 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;
@@ -663,12 +672,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 +692,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 +843,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 CHANGED Viewed

@@ -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) {

package/dist/commands/skill.js CHANGED Viewed

@@ -11,6 +11,7 @@ const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const errors_1 = require("../lib/errors");
 const analytics_1 = require("../lib/analytics");
+const package_json_1 = __importDefault(require("../../package.json"));
 const DEFAULT_VERSION = 'v1';
 /**
  * AI tool skill directories.
@@ -220,6 +221,11 @@ ${skillData.prompt}
             skill: `${org}/${parsed.skill}`,
             global: Boolean(options.global),
         });
+        // Report authenticated install to backend (fire-and-forget)
+        // This tracks unique installers for manipulation-resistant metrics
+        if (resolved.apiKey) {
+            (0, api_1.reportInstall)(resolved, org, parsed.skill, parsed.version, package_json_1.default.version).catch(() => { });
+        }
         process.stdout.write(`Installed ${org}/${parsed.skill}@${parsed.version}\n`);
         process.stdout.write(`\nAvailable for:\n`);
         for (const tool of installed) {

package/dist/commands/status.js CHANGED Viewed

@@ -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';
@@ -51,7 +52,7 @@ function formatLatency(latencyMs) {
 }
 function printHumanStatus(data) {
     const overallStatus = getOverallStatus(data.services);
-    process.stdout.write(`\nOrchAgent Status: ${overallStatus}\n\n`);
+    process.stdout.write(`\norchagent Status: ${overallStatus}\n\n`);
     for (const service of data.services) {
         const icon = getStatusIcon(service.status);
         const label = getStatusLabel(service.status);
@@ -64,7 +65,7 @@ function printHumanStatus(data) {
 function registerStatusCommand(program) {
     program
         .command('status')
-        .description('Check OrchAgent service status')
+        .description('Check orchagent service status')
         .option('--json', 'Output raw JSON')
         .action(async (options) => {
         try {
@@ -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 CHANGED Viewed

@@ -53,13 +53,18 @@ const package_json_1 = __importDefault(require("../package.json"));
 const program = new commander_1.Command();
 program
     .name('orchagent')
-    .description('OrchAgent CLI')
+    .description('orchagent CLI')
     .version(package_json_1.default.version)
     .addHelpText('after', `
 Quick Reference:
   run   Download and run an agent locally (your machine)
-  call  Execute an agent on OrchAgent servers (requires login)
+  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/api.js CHANGED Viewed

@@ -56,6 +56,7 @@ exports.downloadCodeBundleAuthenticated = downloadCodeBundleAuthenticated;
 exports.checkAgentDelete = checkAgentDelete;
 exports.deleteAgent = deleteAgent;
 exports.previewAgentVersion = previewAgentVersion;
+exports.reportInstall = reportInstall;
 const errors_1 = require("./errors");
 const DEFAULT_TIMEOUT_MS = 15000;
 async function safeFetch(url, options) {
@@ -301,3 +302,15 @@ async function deleteAgent(config, agentId, confirmationName) {
 async function previewAgentVersion(config, agentName) {
     return request(config, 'GET', `/agents/preview?name=${encodeURIComponent(agentName)}`);
 }
+/**
+ * Report a skill installation to the backend.
+ * Only tracks authenticated installs (requires API key).
+ * Fire-and-forget - errors are silently ignored.
+ */
+async function reportInstall(config, org, skill, version, cliVersion) {
+    if (!config.apiKey)
+        return;
+    await request(config, 'POST', `/agents/${org}/${skill}/${version}/install`, {
+        headers: { 'X-CLI-Version': cliVersion },
+    });
+}

package/dist/lib/browser-auth.js CHANGED Viewed

@@ -160,7 +160,7 @@ function successHtml() {
 <html>
 <head>
   <meta charset="utf-8">
-  <title>OrchAgent CLI - Authentication Successful</title>
+  <title>orchagent CLI - Authentication Successful</title>
   <style>
     body {
       font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
@@ -219,7 +219,7 @@ function errorHtml(message) {
 <html>
 <head>
   <meta charset="utf-8">
-  <title>OrchAgent CLI - Authentication Error</title>
+  <title>orchagent CLI - Authentication Error</title>
   <style>
     body {
       font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;

package/dist/lib/bundle.js CHANGED Viewed

@@ -2,7 +2,7 @@
 /**
  * Code bundling utilities for hosted code agents.
  *
- * Creates zip bundles from project directories for upload to OrchAgent.
+ * Creates zip bundles from project directories for upload to orchagent.
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
@@ -91,7 +91,7 @@ const DEFAULT_EXCLUDES = [
     'pytest.ini',
     '.coveragerc',
     'coverage/**',
-    // OrchAgent
+    // orchagent
     'orchagent.json',
     'bundle.zip',
     '*.zip',

package/dist/lib/doctor/checks/connectivity.js CHANGED Viewed

@@ -24,7 +24,7 @@ async function checkGatewayHealth() {
                     name: 'gateway_reachable',
                     status: 'error',
                     message: `Gateway returned ${response.status}`,
-                    fix: 'Check if OrchAgent API is operational at https://status.orchagent.io',
+                    fix: 'Check if orchagent API is operational at https://status.orchagent.io',
                     details: {
                         url: healthUrl,
                         status: response.status,

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

@@ -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/dist/lib/doctor/output.js CHANGED Viewed

@@ -58,7 +58,7 @@ function groupByCategory(results) {
 function printHumanOutput(results, summary, verbose) {
     // Header
     process.stdout.write('\n');
-    process.stdout.write(chalk_1.default.bold('OrchAgent Doctor\n'));
+    process.stdout.write(chalk_1.default.bold('orchagent Doctor\n'));
     process.stdout.write('================\n\n');
     // Group and print results
     const groups = groupByCategory(results);

package/package.json CHANGED Viewed

@@ -1,9 +1,9 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.2.22",
-  "description": "Command-line interface for the OrchAgent AI agent marketplace",
+  "version": "0.2.24",
+  "description": "Command-line interface for the orchagent AI agent marketplace",
   "license": "MIT",
-  "author": "OrchAgent <hello@orchagent.io>",
+  "author": "orchagent <hello@orchagent.io>",
   "homepage": "https://orchagent.io",
   "repository": {
     "type": "git",