@orchagent/cli 0.2.12 → 0.2.14

package/dist/commands/call.js

@@ -90,7 +90,7 @@ async function resolveJsonBody(input) {
         return JSON.stringify(JSON.parse(raw));
     }
     catch {
-        throw new errors_1.CliError('Invalid JSON input. Provide a valid JSON string or @file.');
+        throw (0, errors_1.jsonInputError)('data');
     }
 }
 function registerCallCommand(program) {
@@ -156,12 +156,11 @@ Note: Use 'call' for server-side execution (requires login), 'run' for local exe
                 llmProvider = detected.provider;
             }
         }
-        // Add LLM key to headers
-        if (llmKey) {
-            headers['X-LLM-API-Key'] = llmKey;
-            if (llmProvider) {
-                headers['X-LLM-Provider'] = llmProvider;
-            }
+        // LLM credentials will be added to request body (not headers) for security
+        // Headers can be logged by proxies/load balancers, body is not logged by default
+        let llmCredentials;
+        if (llmKey && llmProvider) {
+            llmCredentials = { api_key: llmKey, provider: llmProvider };
         }
         else if (agentMeta.type === 'prompt') {
             // Warn if no key found for prompt-based agent
@@ -189,16 +188,44 @@ Note: Use 'call' for server-side execution (requires login), 'run' for local exe
             if (filePaths.length > 0 || options.metadata) {
                 throw new errors_1.CliError('Cannot use --data with file uploads or --metadata.');
             }
-            body = await resolveJsonBody(options.data);
+            // Parse JSON and inject llm_credentials if available
+            const resolvedBody = await resolveJsonBody(options.data);
+            if (llmCredentials) {
+                const bodyObj = JSON.parse(resolvedBody);
+                bodyObj.llm_credentials = llmCredentials;
+                body = JSON.stringify(bodyObj);
+            }
+            else {
+                body = resolvedBody;
+            }
+            headers['Content-Type'] = 'application/json';
+        }
+        else if (filePaths.length > 0 || options.metadata) {
+            // Handle multipart file uploads
+            // Inject llm_credentials into metadata if available
+            let metadata = options.metadata;
+            if (llmCredentials) {
+                const metaObj = metadata ? JSON.parse(metadata) : {};
+                metaObj.llm_credentials = llmCredentials;
+                metadata = JSON.stringify(metaObj);
+            }
+            const multipart = await buildMultipartBody(filePaths, metadata);
+            body = multipart.body;
+            sourceLabel = multipart.sourceLabel;
+        }
+        else if (llmCredentials) {
+            // No data or files, but we have LLM credentials - send as JSON body
+            body = JSON.stringify({ llm_credentials: llmCredentials });
             headers['Content-Type'] = 'application/json';
         }
         else {
-            const multipart = await buildMultipartBody(filePaths.length ? filePaths : undefined, options.metadata);
+            // No data, files, or credentials - check for stdin
+            const multipart = await buildMultipartBody(undefined, options.metadata);
             body = multipart.body;
             sourceLabel = multipart.sourceLabel;
         }
         const url = `${resolved.apiUrl.replace(/\/$/, '')}/${org}/${parsed.agent}/${parsed.version}/${endpoint}`;
-        const response = await fetch(url, {
+        const response = await (0, api_1.safeFetch)(url, {
             method: 'POST',
             headers,
             body,

package/dist/commands/delete.js

@@ -29,6 +29,7 @@ function registerDeleteCommand(program) {
         .description('Delete an agent')
         .option('--version <version>', 'Specific version to delete (default: latest)')
         .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Show what would be deleted without making changes')
         .action(async (agentName, options) => {
         const config = await (0, config_1.getResolvedConfig)();
         if (!config.apiKey) {
@@ -61,6 +62,17 @@ function registerDeleteCommand(program) {
             process.stdout.write(`${chalk_1.default.bold('Stars:')} ${deleteCheck.stars_count}  ${chalk_1.default.bold('Forks:')} ${deleteCheck.fork_count}\n`);
         }
         process.stdout.write('\n');
+        // Handle dry-run
+        if (options.dryRun) {
+            process.stdout.write('\nDRY RUN - No changes will be made\n\n');
+            process.stdout.write(`Would delete: ${agent.name}@${agent.version}\n`);
+            if (deleteCheck.stars_count > 0 || deleteCheck.fork_count > 0) {
+                process.stdout.write(chalk_1.default.yellow('Warning: This agent has stars or forks\n'));
+            }
+            process.stdout.write(chalk_1.default.gray('\nData would be retained for 30 days before permanent deletion.\n'));
+            process.stdout.write('\nNo changes made (dry run)\n');
+            return;
+        }
         // Handle confirmation
         if (!options.yes) {
             if (deleteCheck.requires_confirmation) {

package/dist/commands/doctor.js

@@ -18,9 +18,8 @@ function registerDoctorCommand(program) {
         else {
             (0, doctor_1.printHumanOutput)(results, summary, options.verbose ?? false);
         }
-        // Exit with code 1 if any errors or warnings (enables scripting)
-        const hasIssues = summary.errors > 0 || summary.warnings > 0;
-        if (hasIssues) {
+        // Exit with code 1 only if there are errors (not warnings)
+        if (summary.errors > 0) {
             process.exit(1);
         }
     });

package/dist/commands/index.js

@@ -10,7 +10,6 @@ const whoami_1 = require("./whoami");
 const star_1 = require("./star");
 const fork_1 = require("./fork");
 const search_1 = require("./search");
-const llm_config_1 = require("./llm-config");
 const keys_1 = require("./keys");
 const run_1 = require("./run");
 const info_1 = require("./info");
@@ -18,6 +17,7 @@ const skill_1 = require("./skill");
 const delete_1 = require("./delete");
 const github_1 = require("./github");
 const doctor_1 = require("./doctor");
+const status_1 = require("./status");
 function registerCommands(program) {
     (0, login_1.registerLoginCommand)(program);
     (0, whoami_1.registerWhoamiCommand)(program);
@@ -30,10 +30,10 @@ function registerCommands(program) {
     (0, search_1.registerSearchCommand)(program);
     (0, star_1.registerStarCommand)(program);
     (0, fork_1.registerForkCommand)(program);
-    (0, llm_config_1.registerLlmConfigCommand)(program);
     (0, keys_1.registerKeysCommand)(program);
     (0, skill_1.registerSkillCommand)(program);
     (0, delete_1.registerDeleteCommand)(program);
     (0, github_1.registerGitHubCommand)(program);
     (0, doctor_1.registerDoctorCommand)(program);
+    (0, status_1.registerStatusCommand)(program);
 }

package/dist/commands/publish.js

@@ -68,6 +68,7 @@ function registerPublishCommand(program) {
         .option('--public', 'Make agent public (default: true)', true)
         .option('--private', 'Make agent private')
         .option('--profile <name>', 'Use API key from named profile')
+        .option('--dry-run', 'Show what would be published without making changes')
         .action(async (options) => {
         const config = await (0, config_1.getResolvedConfig)({}, options.profile);
         const cwd = process.cwd();
@@ -77,6 +78,29 @@ function registerPublishCommand(program) {
         if (skillData) {
             // Publish as a skill (server auto-assigns version)
             const org = await (0, api_1.getOrg)(config);
+            // 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 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)`;
+                process.stderr.write('\nDRY RUN - No changes will be made\n\n');
+                process.stderr.write('Validating...\n');
+                process.stderr.write(`  ✓ SKILL.md found and valid\n`);
+                process.stderr.write(`  ✓ Skill prompt (${skillBodyBytes.toLocaleString()} bytes)\n`);
+                process.stderr.write(`  ✓ Authentication valid (org: ${org.slug})\n`);
+                process.stderr.write('\nSkill Preview:\n');
+                process.stderr.write(`  Name:        ${skillData.frontmatter.name}\n`);
+                process.stderr.write(`  Type:        skill\n`);
+                process.stderr.write(`  Version:     ${versionInfo}\n`);
+                process.stderr.write(`  Visibility:  ${options.private ? 'private' : 'public'}\n`);
+                process.stderr.write(`  Providers:   any\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',
@@ -118,7 +142,9 @@ function registerPublishCommand(program) {
             catch (err) {
                 if (err.code === 'ENOENT') {
                     const agentTypeName = manifest.type === 'skill' ? 'skill' : 'prompt-based agent';
-                    throw new errors_1.CliError(`No prompt.md found for ${agentTypeName}`);
+                    throw new errors_1.CliError(`No prompt.md found for ${agentTypeName}.\n\n` +
+                        'Create a prompt.md file in the current directory with your prompt template.\n' +
+                        'See: https://orchagent.io/docs/publishing');
                 }
                 throw err;
             }
@@ -164,10 +190,68 @@ function registerPublishCommand(program) {
         let sdkCompatible = false;
         if (manifest.type === 'code') {
             sdkCompatible = await detectSdkCompatible(cwd);
-            if (sdkCompatible) {
+            if (sdkCompatible && !options.dryRun) {
                 process.stdout.write(`SDK detected - agent will be marked as Local Ready\n`);
             }
         }
+        // Handle dry-run for agents
+        if (options.dryRun) {
+            const preview = await (0, api_1.previewAgentVersion)(config, manifest.name);
+            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)`;
+            process.stderr.write('\nDRY RUN - No changes will be made\n\n');
+            process.stderr.write('Validating...\n');
+            process.stderr.write(`  ✓ orchagent.json found and valid\n`);
+            if (manifest.type === 'prompt') {
+                // Prompt agent validations
+                const promptBytes = prompt ? Buffer.byteLength(prompt, 'utf-8') : 0;
+                process.stderr.write(`  ✓ prompt.md found (${promptBytes.toLocaleString()} bytes)\n`);
+                if (inputSchema || outputSchema) {
+                    const schemaTypes = [inputSchema ? 'input' : null, outputSchema ? 'output' : null].filter(Boolean).join(' + ');
+                    process.stderr.write(`  ✓ schema.json found (${schemaTypes} schemas)\n`);
+                }
+            }
+            else if (manifest.type === 'code') {
+                // Code agent validations
+                const entrypoint = manifest.entrypoint || await (0, bundle_1.detectEntrypoint)(cwd);
+                process.stderr.write(`  ✓ Entrypoint: ${entrypoint}\n`);
+                if (sdkCompatible) {
+                    process.stderr.write(`  ✓ SDK detected (orchagent-sdk in requirements.txt)\n`);
+                }
+            }
+            process.stderr.write(`  ✓ Authentication valid (org: ${org.slug})\n`);
+            // For code agents with bundles, show bundle preview
+            if (shouldUploadBundle) {
+                const bundlePreview = await (0, bundle_1.previewBundle)(cwd, {
+                    entrypoint: manifest.entrypoint,
+                    exclude: manifest.bundle?.exclude,
+                    include: manifest.bundle?.include,
+                });
+                process.stderr.write(`\nBundle Preview:\n`);
+                process.stderr.write(`  Files:       ${bundlePreview.fileCount} files\n`);
+                process.stderr.write(`  Size:        ${(bundlePreview.totalSizeBytes / 1024).toFixed(1)} KB\n`);
+                process.stderr.write(`  Entrypoint:  ${bundlePreview.entrypoint}\n`);
+            }
+            process.stderr.write('\nAgent Preview:\n');
+            process.stderr.write(`  Name:        ${manifest.name}\n`);
+            process.stderr.write(`  Type:        ${manifest.type}${shouldUploadBundle ? ' (hosted)' : ''}\n`);
+            process.stderr.write(`  Version:     ${versionInfo}\n`);
+            process.stderr.write(`  Visibility:  ${options.private ? 'private' : 'public'}\n`);
+            process.stderr.write(`  Providers:   ${supportedProviders.join(', ')}\n`);
+            process.stderr.write(`\nWould publish: ${preview.org_slug}/${manifest.name}@${preview.next_version}\n`);
+            if (shouldUploadBundle) {
+                const bundlePreview = await (0, bundle_1.previewBundle)(cwd, {
+                    entrypoint: manifest.entrypoint,
+                    exclude: manifest.bundle?.exclude,
+                    include: manifest.bundle?.include,
+                });
+                process.stderr.write(`Would upload bundle: ${(bundlePreview.totalSizeBytes / 1024).toFixed(1)} KB\n`);
+            }
+            process.stderr.write(`API endpoint: POST ${config.apiUrl}/${preview.org_slug}/${manifest.name}/${preview.next_version}/run\n\n`);
+            process.stderr.write('No changes made (dry run)\n');
+            return;
+        }
         // Create the agent (server auto-assigns version)
         const result = await (0, api_1.createAgent)(config, {
             name: manifest.name,

package/dist/commands/run.js

@@ -339,7 +339,12 @@ async function installCodeAgent(agentData) {
     process.stderr.write(`Installing ${installSource}...\n`);
     const { code } = await runCommand('python3', ['-m', 'pip', 'install', '--quiet', installSource]);
     if (code !== 0) {
-        throw new errors_1.CliError(`Failed to install agent. Exit code: ${code}`);
+        throw new errors_1.CliError(`Failed to install agent (exit code ${code}).\n\n` +
+            'Troubleshooting:\n' +
+            '  - Check Python is installed: python3 --version\n' +
+            '  - Check pip is available: pip --version\n' +
+            '  - Check network connectivity\n' +
+            '  - Try installing manually: pip install <package>');
     }
     process.stderr.write(`Installation complete.\n`);
 }
@@ -446,7 +451,7 @@ async function executeBundleAgent(config, org, agentName, version, agentData, ar
                 inputJson = JSON.stringify(parsed);
             }
             catch {
-                throw new errors_1.CliError('Invalid JSON in --input option');
+                throw (0, errors_1.jsonInputError)('input');
             }
         }
         else if (args.length > 0) {

package/dist/commands/skill.js

@@ -79,18 +79,19 @@ async function downloadSkillWithFallback(config, org, skill, version) {
     if (matching.length === 0) {
         throw new api_1.ApiError(`Skill '${org}/${skill}@${version}' not found`, 404);
     }
-    let targetAgent = matching[0];
-    if (version !== 'v1' && version !== 'latest') {
+    let targetAgent;
+    if (version === 'latest') {
+        // For 'latest', get most recently created
+        targetAgent = matching.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime())[0];
+    }
+    else {
+        // For any explicit version (v1, v2, etc.), find exact match
         const found = matching.find(a => a.version === version);
         if (!found) {
             throw new api_1.ApiError(`Skill '${org}/${skill}@${version}' not found`, 404);
         }
         targetAgent = found;
     }
-    else {
-        // Get most recent
-        targetAgent = matching.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime())[0];
-    }
     // Verify it's a skill type
     if (targetAgent.type !== 'skill') {
         throw new errors_1.CliError(`${org}/${skill} is not a skill (type: ${targetAgent.type || 'prompt'})`);
@@ -159,6 +160,7 @@ Instructions and guidance for AI agents...
         .command('install <skill>')
         .description('Install skill to local AI tool directories (Claude Code, Cursor, etc.)')
         .option('--global', 'Install to home directory (default: current directory)')
+        .option('--dry-run', 'Show what would be installed without making changes')
         .action(async (skillRef, options) => {
         const resolved = await (0, config_1.getResolvedConfig)();
         const parsed = parseSkillRef(skillRef);
@@ -169,7 +171,9 @@ Instructions and guidance for AI agents...
         // Download skill (tries public first, falls back to authenticated for private)
         const skillData = await downloadSkillWithFallback(resolved, org, parsed.skill, parsed.version);
         if (!skillData.prompt) {
-            throw new errors_1.CliError('Skill has no content');
+            throw new errors_1.CliError('Skill has no content.\n\n' +
+                'The skill exists but has an empty prompt. This may be a publishing issue.\n' +
+                'Try re-publishing the skill or contact the skill author.');
         }
         // Determine base directory (home or current)
         const baseDir = options.global ? os_1.default.homedir() : process.cwd();
@@ -182,6 +186,18 @@ ${skillData.description || ''}
 
 ${skillData.prompt}
 `;
+        // Dry run - show what would be installed
+        if (options.dryRun) {
+            process.stdout.write(`Would install ${org}/${parsed.skill}@${parsed.version}\n\n`);
+            process.stdout.write(`Target directories:\n`);
+            for (const tool of AI_TOOL_SKILL_DIRS) {
+                const skillDir = path_1.default.join(baseDir, tool.path);
+                const skillFile = path_1.default.join(skillDir, `${parsed.skill}.md`);
+                process.stdout.write(`  - ${tool.name}: ${skillFile}\n`);
+            }
+            process.stdout.write(`\nNo changes made (dry run)\n`);
+            return;
+        }
         // Install to all AI tool directories
         const installed = [];
         for (const tool of AI_TOOL_SKILL_DIRS) {

package/dist/commands/status.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStatusCommand = registerStatusCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const output_1 = require("../lib/output");
+const STATUS_URL = 'https://api.orchagent.io/health/detailed';
+const STATUS_PAGE_URL = 'https://status.orchagent.io';
+function getStatusIcon(status) {
+    switch (status) {
+        case 'operational':
+            return chalk_1.default.green('\u2713');
+        case 'degraded':
+            return chalk_1.default.yellow('\u26a0');
+        case 'outage':
+            return chalk_1.default.red('\u2717');
+        default:
+            return chalk_1.default.gray('?');
+    }
+}
+function getStatusLabel(status) {
+    switch (status) {
+        case 'operational':
+            return chalk_1.default.green('Operational');
+        case 'degraded':
+            return chalk_1.default.yellow('Degraded');
+        case 'outage':
+            return chalk_1.default.red('Outage');
+        default:
+            return chalk_1.default.gray('Unknown');
+    }
+}
+function getOverallStatus(services) {
+    const hasOutage = services.some((s) => s.status === 'outage');
+    const hasDegraded = services.some((s) => s.status === 'degraded');
+    if (hasOutage) {
+        return chalk_1.default.red('Service Outage');
+    }
+    if (hasDegraded) {
+        return chalk_1.default.yellow('Partial Outage');
+    }
+    return chalk_1.default.green('All Systems Operational');
+}
+function formatLatency(latencyMs) {
+    if (latencyMs === undefined) {
+        return '';
+    }
+    return chalk_1.default.gray(` (${latencyMs}ms)`);
+}
+function printHumanStatus(data) {
+    const overallStatus = getOverallStatus(data.services);
+    process.stdout.write(`\nOrchAgent Status: ${overallStatus}\n\n`);
+    for (const service of data.services) {
+        const icon = getStatusIcon(service.status);
+        const label = getStatusLabel(service.status);
+        const latency = formatLatency(service.latency_ms);
+        const paddedName = service.name.padEnd(18);
+        process.stdout.write(`  ${paddedName} ${icon} ${label}${latency}\n`);
+    }
+    process.stdout.write(`\nView details: ${chalk_1.default.cyan(STATUS_PAGE_URL)}\n`);
+}
+function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Check OrchAgent service status')
+        .option('--json', 'Output raw JSON')
+        .action(async (options) => {
+        try {
+            const response = await fetch(STATUS_URL, {
+                headers: {
+                    Accept: 'application/json',
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const data = (await response.json());
+            // Handle missing or malformed services array
+            if (!data.services || !Array.isArray(data.services)) {
+                data.services = [];
+            }
+            if (options.json) {
+                (0, output_1.printJson)(data);
+                return;
+            }
+            printHumanStatus(data);
+        }
+        catch (err) {
+            if (options.json) {
+                (0, output_1.printJson)({ error: 'Unable to fetch status', details: String(err) });
+                process.exit(1);
+            }
+            process.stderr.write(chalk_1.default.red('\nUnable to fetch status\n\n') +
+                chalk_1.default.gray(`Error: ${err instanceof Error ? err.message : String(err)}\n\n`) +
+                `Check ${chalk_1.default.cyan(STATUS_PAGE_URL)} for current status.\n`);
+            process.exit(1);
+        }
+    });
+}

package/dist/lib/api.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiError = void 0;
+exports.safeFetch = safeFetch;
 exports.request = request;
 exports.publicRequest = publicRequest;
 exports.getOrg = getOrg;
@@ -54,6 +55,24 @@ exports.getAgentWithFallback = getAgentWithFallback;
 exports.downloadCodeBundleAuthenticated = downloadCodeBundleAuthenticated;
 exports.checkAgentDelete = checkAgentDelete;
 exports.deleteAgent = deleteAgent;
+exports.previewAgentVersion = previewAgentVersion;
+const errors_1 = require("./errors");
+const DEFAULT_TIMEOUT_MS = 15000;
+async function safeFetch(url, options) {
+    try {
+        return await fetch(url, {
+            ...options,
+            signal: AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+        });
+    }
+    catch (err) {
+        if (err instanceof Error && (err.name === 'AbortError' || err.name === 'TimeoutError')) {
+            throw new errors_1.NetworkError(url, err);
+        }
+        // Network errors (ECONNREFUSED, DNS failure, etc.)
+        throw new errors_1.NetworkError(url, err instanceof Error ? err : undefined);
+    }
+}
 class ApiError extends Error {
     status;
     payload;
@@ -88,7 +107,7 @@ async function request(config, method, path, options = {}) {
     if (!config.apiKey) {
         throw new ApiError('Missing API key. Run `orchagent login` first.', 401);
     }
-    const response = await fetch(buildUrl(config.apiUrl, path), {
+    const response = await safeFetch(buildUrl(config.apiUrl, path), {
         method,
         headers: {
             Authorization: `Bearer ${config.apiKey}`,
@@ -102,7 +121,7 @@ async function request(config, method, path, options = {}) {
     return (await response.json());
 }
 async function publicRequest(config, path) {
-    const response = await fetch(buildUrl(config.apiUrl, path));
+    const response = await safeFetch(buildUrl(config.apiUrl, path));
     if (!response.ok) {
         throw await parseError(response);
     }
@@ -161,7 +180,7 @@ async function fetchLlmKeys(config) {
  * Download a code bundle for local execution.
  */
 async function downloadCodeBundle(config, org, agent, version) {
-    const response = await fetch(`${config.apiUrl.replace(/\/$/, '')}/public/agents/${org}/${agent}/${version}/bundle`);
+    const response = await safeFetch(`${config.apiUrl.replace(/\/$/, '')}/public/agents/${org}/${agent}/${version}/bundle`);
     if (!response.ok) {
         throw await parseError(response);
     }
@@ -189,7 +208,7 @@ async function uploadCodeBundle(config, agentId, bundlePath, entrypoint) {
     if (entrypoint) {
         headers['x-entrypoint'] = entrypoint;
     }
-    const response = await fetch(`${config.apiUrl.replace(/\/$/, '')}/agents/${agentId}/upload`, {
+    const response = await safeFetch(`${config.apiUrl.replace(/\/$/, '')}/agents/${agentId}/upload`, {
         method: 'POST',
         headers,
         body: formData,
@@ -243,7 +262,7 @@ async function downloadCodeBundleAuthenticated(config, agentId) {
     if (!config.apiKey) {
         throw new ApiError('Missing API key for authenticated bundle download', 401);
     }
-    const response = await fetch(`${config.apiUrl.replace(/\/$/, '')}/agents/${agentId}/bundle`, {
+    const response = await safeFetch(`${config.apiUrl.replace(/\/$/, '')}/agents/${agentId}/bundle`, {
         headers: {
             Authorization: `Bearer ${config.apiKey}`,
         },
@@ -276,3 +295,9 @@ async function deleteAgent(config, agentId, confirmationName) {
     const params = confirmationName ? `?confirmation_name=${encodeURIComponent(confirmationName)}` : '';
     return request(config, 'DELETE', `/agents/${agentId}${params}`);
 }
+/**
+ * Preview the next version number for an agent.
+ */
+async function previewAgentVersion(config, agentName) {
+    return request(config, 'GET', `/agents/preview?name=${encodeURIComponent(agentName)}`);
+}

package/dist/lib/bundle.js

@@ -10,11 +10,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCodeBundle = createCodeBundle;
 exports.detectEntrypoint = detectEntrypoint;
+exports.previewBundle = previewBundle;
 exports.validateBundle = validateBundle;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const archiver_1 = __importDefault(require("archiver"));
 const fs_1 = require("fs");
+const glob_1 = require("glob");
 /** Default patterns to exclude from bundles */
 const DEFAULT_EXCLUDES = [
     // Python
@@ -184,6 +186,52 @@ async function detectEntrypoint(projectDir) {
     }
     return null;
 }
+/**
+ * Preview what would be bundled without creating the actual bundle.
+ *
+ * @param sourceDir - The directory to analyze
+ * @param options - Bundle options
+ * @returns Preview information about the bundle
+ */
+async function previewBundle(sourceDir, options = {}) {
+    const excludePatterns = [...DEFAULT_EXCLUDES, ...(options.exclude || [])];
+    // Verify source directory exists
+    const stat = await promises_1.default.stat(sourceDir);
+    if (!stat.isDirectory()) {
+        throw new Error(`Source path is not a directory: ${sourceDir}`);
+    }
+    // Detect or use provided entrypoint
+    let entrypoint = options.entrypoint;
+    if (!entrypoint) {
+        const detected = await detectEntrypoint(sourceDir);
+        entrypoint = detected || 'main.py';
+    }
+    // Find all files that would be included (matching createCodeBundle's glob pattern)
+    const files = await (0, glob_1.glob)('**/*', {
+        cwd: sourceDir,
+        ignore: excludePatterns,
+        dot: false,
+        nodir: true,
+    });
+    // Calculate total size by reading file stats
+    let totalSizeBytes = 0;
+    for (const file of files) {
+        const filePath = path_1.default.join(sourceDir, file);
+        try {
+            const fileStat = await promises_1.default.stat(filePath);
+            totalSizeBytes += fileStat.size;
+        }
+        catch {
+            // Skip files that can't be stat'd (e.g., broken symlinks)
+        }
+    }
+    return {
+        fileCount: files.length,
+        totalSizeBytes,
+        entrypoint,
+        excludePatterns,
+    };
+}
 /**
  * Validate a bundle before upload.
  *

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

@@ -34,7 +34,7 @@ async function checkServerLlmKeys() {
                 name: 'server_llm_keys',
                 status: 'warning',
                 message: 'No LLM keys configured on server',
-                fix: 'Run `orch llm-config` or add keys at orchagent.io/settings',
+                fix: 'Run `orch keys add <provider>` or add keys at orchagent.io/settings',
                 details: { count: 0, providers: [] },
             };
         }
@@ -101,8 +101,17 @@ async function checkLocalLlmEnvVars() {
 }
 /**
  * Run all LLM configuration checks.
+ * If server keys are configured, local keys warning becomes informational.
  */
 async function runLlmChecks() {
-    const results = await Promise.all([checkServerLlmKeys(), checkLocalLlmEnvVars()]);
-    return results;
+    const serverResult = await checkServerLlmKeys();
+    const localResult = await checkLocalLlmEnvVars();
+    // If server keys are configured, downgrade local keys warning to info
+    // Users who only use server-side calls don't need local keys
+    if (serverResult.status === 'success' && localResult.status === 'warning') {
+        localResult.status = 'info';
+        localResult.message = 'No local LLM API keys (using server keys)';
+        localResult.fix = undefined;
+    }
+    return [serverResult, localResult];
 }

package/dist/lib/doctor/output.js

@@ -11,6 +11,7 @@ const SYMBOLS = {
     success: chalk_1.default.green('\u2713'), // checkmark
     warning: chalk_1.default.yellow('\u26a0'), // warning sign
     error: chalk_1.default.red('\u2717'), // X mark
+    info: chalk_1.default.blue('\u2139'), // info sign
 };
 // Category display names
 const CATEGORY_NAMES = {
@@ -65,10 +66,10 @@ function printHumanOutput(results, summary, verbose) {
         const displayName = CATEGORY_NAMES[category] || category;
         process.stdout.write(chalk_1.default.bold(`${displayName}\n`));
         for (const check of checks) {
-            const symbol = SYMBOLS[check.status];
+            const symbol = SYMBOLS[check.status] || SYMBOLS.info;
             process.stdout.write(`  ${symbol} ${check.message}\n`);
-            // Show fix suggestion for warnings/errors
-            if (check.fix && check.status !== 'success') {
+            // Show fix suggestion for warnings/errors (not for success/info)
+            if (check.fix && (check.status === 'warning' || check.status === 'error')) {
                 process.stdout.write(chalk_1.default.dim(`    \u2192 ${check.fix}\n`));
             }
             // Show details in verbose mode

package/dist/lib/doctor/runner.js

@@ -58,10 +58,11 @@ async function runAllChecks() {
 }
 /**
  * Calculate summary statistics from check results.
+ * 'info' status counts as passed (informational, not a problem).
  */
 function calculateSummary(results) {
     return {
-        passed: results.filter((r) => r.status === 'success').length,
+        passed: results.filter((r) => r.status === 'success' || r.status === 'info').length,
         warnings: results.filter((r) => r.status === 'warning').length,
         errors: results.filter((r) => r.status === 'error').length,
     };

package/dist/lib/errors.js

@@ -33,13 +33,15 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CliError = void 0;
+exports.NetworkError = exports.ExitCodes = exports.CliError = void 0;
 exports.formatError = formatError;
 exports.exitWithError = exitWithError;
+exports.jsonInputError = jsonInputError;
 const Sentry = __importStar(require("@sentry/node"));
 const analytics_1 = require("./analytics");
 class CliError extends Error {
     exitCode;
+    cause;
     constructor(message, exitCode = 1) {
         super(message);
         this.exitCode = exitCode;
@@ -73,3 +75,41 @@ async function exitWithError(err) {
     }
     process.exit(1);
 }
+exports.ExitCodes = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    AUTH_ERROR: 2,
+    PERMISSION_DENIED: 3,
+    NOT_FOUND: 4,
+    INVALID_INPUT: 5,
+    RATE_LIMITED: 6,
+    TIMEOUT: 7,
+    SERVER_ERROR: 8,
+    NETWORK_ERROR: 9,
+};
+class NetworkError extends CliError {
+    constructor(url, cause) {
+        const host = new URL(url).host;
+        super(`Unable to connect to ${host}\n\n` +
+            'Possible causes:\n' +
+            '  - Network connectivity issues\n' +
+            '  - Service temporarily unavailable\n' +
+            '  - Firewall or proxy blocking the request\n\n' +
+            'Check status at: https://status.orchagent.io', exports.ExitCodes.NETWORK_ERROR);
+        this.cause = cause;
+    }
+}
+exports.NetworkError = NetworkError;
+function jsonInputError(flag) {
+    return new CliError(`Invalid JSON in --${flag} option.\n\n` +
+        'Common causes:\n' +
+        '  - Shell special characters (!, $, `) need escaping\n' +
+        '  - Missing or mismatched quotes\n\n' +
+        'Shell-specific tips:\n' +
+        '  - Bash/Zsh: Use single quotes: --data \'{"key": "value"}\'\n' +
+        '  - PowerShell: Use double quotes and escape: --data "{\\"key\\": \\"value\\"}"\n' +
+        '  - Any shell: Use a file: --data @input.json\n\n' +
+        'Alternatives:\n' +
+        `  - Use a file:  --${flag} @input.json\n` +
+        `  - Use stdin:   echo '{"key":"value"}' | orch call agent --${flag} @-`, exports.ExitCodes.INVALID_INPUT);
+}

package/package.json

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