@orchagent/cli 0.3.28 → 0.3.31

package/dist/commands/agents.js

@@ -1,20 +1,97 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAgentsCommand = registerAgentsCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const output_1 = require("../lib/output");
+const pricing_1 = require("../lib/pricing");
 function registerAgentsCommand(program) {
     program
         .command('agents')
-        .description('(Deprecated) Use "orchagent search" instead')
+        .description('List your published agents')
         .option('--filter <text>', 'Filter by name')
         .option('--json', 'Output raw JSON')
-        .action(async () => {
-        process.stdout.write('The "agents" command has been replaced by "search".\n\n' +
-            'Usage:\n' +
-            '  orchagent search <query>       Search agents by keyword\n' +
-            '  orchagent search --popular     Top agents by stars\n' +
-            '  orchagent search --recent      Most recently published\n' +
-            '  orchagent search --type agents Filter to agents only\n\n' +
-            'Browse all agents at: https://orchagent.io/explore\n');
-        process.exit(0);
+        .action(async (options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        const agents = await (0, api_1.listMyAgents)(config);
+        // Apply filter if provided
+        const filteredAgents = options.filter
+            ? agents.filter(a => a.name.toLowerCase().includes(options.filter.toLowerCase()))
+            : agents;
+        if (options.json) {
+            (0, output_1.printJson)(filteredAgents);
+            return;
+        }
+        if (filteredAgents.length === 0) {
+            process.stdout.write(options.filter
+                ? `No agents found matching "${options.filter}"\n`
+                : 'No agents published yet.\n\nPublish an agent: orch publish\n');
+            return;
+        }
+        // Print table with pricing
+        const Table = (await Promise.resolve().then(() => __importStar(require('cli-table3')))).default;
+        const table = new Table({
+            head: [
+                chalk_1.default.bold('Agent'),
+                chalk_1.default.bold('Version'),
+                chalk_1.default.bold('Type'),
+                chalk_1.default.bold('Stars'),
+                chalk_1.default.bold('Price'),
+                chalk_1.default.bold('Description'),
+            ],
+        });
+        filteredAgents.forEach((agent) => {
+            const name = agent.name;
+            const version = agent.version;
+            const type = agent.type || 'code';
+            const stars = agent.stars_count ?? 0;
+            const price = (0, pricing_1.formatPrice)(agent);
+            const coloredPrice = (0, pricing_1.isPaidAgent)(agent) ? chalk_1.default.yellow(price) : chalk_1.default.green(price);
+            const desc = agent.description
+                ? agent.description.length > 30
+                    ? agent.description.slice(0, 27) + '...'
+                    : agent.description
+                : '-';
+            table.push([name, version, type, stars.toString(), coloredPrice, desc]);
+        });
+        process.stdout.write(`${table.toString()}\n`);
+        process.stdout.write(`\nTotal: ${filteredAgents.length} agent${filteredAgents.length === 1 ? '' : 's'}\n`);
     });
 }

package/dist/commands/billing.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerBillingCommand = registerBillingCommand;
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const chalk_1 = __importDefault(require("chalk"));
+const open_1 = __importDefault(require("open"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const errors_1 = require("../lib/errors");
+const output_1 = require("../lib/output");
+function registerBillingCommand(program) {
+    const billing = program
+        .command('billing')
+        .description('Manage prepaid credits for calling paid agents');
+    // orch billing balance
+    billing
+        .command('balance')
+        .description('Show your credit balance and recent transactions')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        const resolved = await (0, config_1.getResolvedConfig)();
+        const data = await (0, api_1.getCreditsBalance)(resolved);
+        if (options.json) {
+            (0, output_1.printJson)(data);
+            return;
+        }
+        // Show balance
+        const balance = data.balance_cents / 100;
+        process.stdout.write(chalk_1.default.bold(`\nBalance: ${chalk_1.default.green(`$${balance.toFixed(2)} USD`)}\n\n`));
+        // Show recent transactions
+        if (data.recent_transactions && data.recent_transactions.length > 0) {
+            process.stdout.write(chalk_1.default.bold('Recent Transactions:\n'));
+            const table = new cli_table3_1.default({
+                head: [
+                    chalk_1.default.bold('Date'),
+                    chalk_1.default.bold('Type'),
+                    chalk_1.default.bold('Amount'),
+                    chalk_1.default.bold('Balance'),
+                ],
+            });
+            data.recent_transactions.forEach((tx) => {
+                const date = new Date(tx.created_at).toLocaleDateString();
+                const amount = (tx.amount_cents / 100).toFixed(2);
+                const balance = (tx.balance_after_cents / 100).toFixed(2);
+                const amountColor = tx.amount_cents >= 0 ? chalk_1.default.green : chalk_1.default.red;
+                table.push([date, tx.transaction_type, amountColor(`$${amount}`), `$${balance}`]);
+            });
+            process.stdout.write(`${table.toString()}\n\n`);
+        }
+        else {
+            process.stdout.write('No recent transactions\n\n');
+        }
+        process.stdout.write(chalk_1.default.gray('Add credits: orch billing add 5\n'));
+    });
+    // orch billing add <amount>
+    billing
+        .command('add [amount]')
+        .description('Add credits via Stripe checkout (minimum $5.00 USD)')
+        .action(async (amount) => {
+        const resolved = await (0, config_1.getResolvedConfig)();
+        // Parse and validate amount
+        let amountNum;
+        if (!amount) {
+            amountNum = 5.00; // Default to $5
+        }
+        else {
+            amountNum = parseFloat(amount);
+            if (isNaN(amountNum) || amountNum < 5.00) {
+                throw new errors_1.CliError('Amount must be at least $5.00 USD', errors_1.ExitCodes.INVALID_INPUT);
+            }
+        }
+        const amountCents = Math.round(amountNum * 100);
+        // Create checkout session
+        const checkout = await (0, api_1.createCreditCheckout)(resolved, amountCents);
+        // Open in browser
+        process.stdout.write(`\nOpening checkout page...\n`);
+        process.stdout.write(`Amount: $${amountNum.toFixed(2)} USD\n\n`);
+        await (0, open_1.default)(checkout.checkout_url);
+        process.stdout.write(chalk_1.default.gray(`If browser doesn't open, visit:\n${checkout.checkout_url}\n`));
+    });
+    // orch billing history (alias)
+    billing
+        .command('history')
+        .description('Show transaction history (alias for balance)')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        // Just call balance command
+        const resolved = await (0, config_1.getResolvedConfig)();
+        const data = await (0, api_1.getCreditsBalance)(resolved);
+        if (options.json) {
+            (0, output_1.printJson)(data);
+            return;
+        }
+        // Simplified view - just show transactions
+        if (data.recent_transactions && data.recent_transactions.length > 0) {
+            const table = new cli_table3_1.default({
+                head: [
+                    chalk_1.default.bold('Date'),
+                    chalk_1.default.bold('Type'),
+                    chalk_1.default.bold('Amount'),
+                    chalk_1.default.bold('Balance'),
+                ],
+            });
+            data.recent_transactions.forEach((tx) => {
+                const date = new Date(tx.created_at).toLocaleDateString();
+                const amount = (tx.amount_cents / 100).toFixed(2);
+                const balance = (tx.balance_after_cents / 100).toFixed(2);
+                const amountColor = tx.amount_cents >= 0 ? chalk_1.default.green : chalk_1.default.red;
+                table.push([date, tx.transaction_type, amountColor(`$${amount}`), `$${balance}`]);
+            });
+            process.stdout.write(`\n${table.toString()}\n\n`);
+        }
+        else {
+            process.stdout.write('\nNo transactions found\n\n');
+        }
+        const balance = data.balance_cents / 100;
+        process.stdout.write(chalk_1.default.gray(`Current balance: $${balance.toFixed(2)} USD\n`));
+    });
+}

package/dist/commands/call.js

@@ -13,6 +13,7 @@ const output_1 = require("../lib/output");
 const spinner_1 = require("../lib/spinner");
 const llm_1 = require("../lib/llm");
 const analytics_1 = require("../lib/analytics");
+const pricing_1 = require("../lib/pricing");
 const DEFAULT_VERSION = 'latest';
 // Keys that might indicate local file path references in JSON payloads
 const LOCAL_PATH_KEYS = ['path', 'directory', 'file', 'filepath', 'dir', 'folder', 'local'];
@@ -132,7 +133,7 @@ async function resolveJsonBody(input) {
 function registerCallCommand(program) {
     program
         .command('call <agent> [file]')
-        .description('Call an agent endpoint')
+        .description('Call an agent on the server (may incur charges for paid agents)')
         .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)')
@@ -160,6 +161,13 @@ Important: Remote agents cannot access your local filesystem. If your --data pay
 contains keys like 'path', 'directory', 'file', etc., those values will be interpreted
 by the server, not your local machine. To send local files, use the positional file
 argument or --file option instead.
+
+Paid Agents:
+  Paid agents charge per call and deduct from your prepaid credits.
+  Check your balance: orch billing balance
+  Add credits: orch billing add 5
+
+  Same-author calls are FREE - you won't be charged for calling your own agents.
 `)
         .action(async (agentRef, file, options) => {
         // Merge --input alias into --data
@@ -176,6 +184,64 @@ argument or --file option instead.
             throw new errors_1.CliError('Missing org. Use org/agent or set default org.');
         }
         const agentMeta = await (0, api_1.getAgentWithFallback)(resolved, org, parsed.agent, parsed.version);
+        // Part 1: Pre-call balance check for paid agents
+        let pricingInfo;
+        if ((0, pricing_1.isPaidAgent)(agentMeta)) {
+            // Detect ownership: compare agent's org with caller's org
+            let isOwner = false;
+            try {
+                const callerOrg = await (0, api_1.getOrg)(resolved);
+                // Use org_id when available (preferred), org_slug as fallback
+                const agentOrgId = agentMeta.org_id;
+                const agentOrgSlug = agentMeta.org_slug;
+                if (agentOrgId && callerOrg.id === agentOrgId) {
+                    isOwner = true;
+                }
+                else if (agentOrgSlug && callerOrg.slug === agentOrgSlug) {
+                    isOwner = true;
+                }
+            }
+            catch {
+                // If we can't determine ownership, treat as non-owner (fail-safe)
+                isOwner = false;
+            }
+            if (isOwner) {
+                // Owner: show free message, no balance check needed
+                process.stderr.write(`Cost: FREE (author)\n\n`);
+            }
+            else {
+                // Non-owner: check balance
+                const price = agentMeta.price_per_call_cents;
+                pricingInfo = { price_cents: price ?? null };
+                if (!price || price <= 0) {
+                    // Price missing or invalid - warn but proceed (server will enforce)
+                    process.stderr.write(`Warning: Pricing data unavailable. The server will verify payment.\n\n`);
+                }
+                else {
+                    // Valid price - check balance
+                    try {
+                        const balanceData = await (0, api_1.getCreditsBalance)(resolved);
+                        const balance = balanceData.balance_cents;
+                        if (balance < price) {
+                            // Insufficient balance
+                            process.stderr.write(`Insufficient credits:\n` +
+                                `  Balance:  $${(balance / 100).toFixed(2)}\n` +
+                                `  Required: $${(price / 100).toFixed(2)}\n\n` +
+                                `Add credits:\n` +
+                                `  orch billing add 5\n` +
+                                `  orch billing balance  # check current balance\n`);
+                            process.exit(errors_1.ExitCodes.PERMISSION_DENIED);
+                        }
+                        // Sufficient balance - show cost preview
+                        process.stderr.write(`Cost: $${(price / 100).toFixed(2)}/call\n\n`);
+                    }
+                    catch (err) {
+                        // Balance check failed - warn but proceed (server will enforce)
+                        process.stderr.write(`Warning: Could not verify balance. The server will check payment.\n\n`);
+                    }
+                }
+            }
+        }
         const endpoint = options.endpoint?.trim() || agentMeta.default_endpoint || 'analyze';
         const headers = {
             Authorization: `Bearer ${resolved.apiKey}`,
@@ -341,6 +407,20 @@ argument or --file option instead.
             const errorCode = typeof payload === 'object' && payload
                 ? payload.error?.code
                 : undefined;
+            // Part 2: Handle 402 Payment Required
+            if (response.status === 402 || errorCode === 'INSUFFICIENT_CREDITS') {
+                spinner.fail('Insufficient credits');
+                let errorMessage = 'Insufficient credits to call this agent.\n\n';
+                // Use pricing info from pre-call check if available
+                if (pricingInfo?.price_cents) {
+                    errorMessage += `This agent costs $${(pricingInfo.price_cents / 100).toFixed(2)} per call.\n\n`;
+                }
+                errorMessage +=
+                    'Add credits:\n' +
+                        '  orch billing add 5\n' +
+                        '  orch billing balance  # check current balance\n';
+                throw new errors_1.CliError(errorMessage, errors_1.ExitCodes.PERMISSION_DENIED);
+            }
             if (errorCode === 'LLM_KEY_REQUIRED') {
                 spinner.fail('LLM key required');
                 throw new errors_1.CliError('This public agent requires you to provide an LLM key.\n' +
@@ -356,6 +436,10 @@ argument or --file option instead.
             throw new errors_1.CliError(message);
         }
         spinner.succeed(`Called ${org}/${parsed.agent}@${parsed.version}`);
+        // After successful call, if it was a paid agent, show cost
+        if ((0, pricing_1.isPaidAgent)(agentMeta) && pricingInfo?.price_cents && pricingInfo.price_cents > 0) {
+            process.stderr.write(`\nCost: $${(pricingInfo.price_cents / 100).toFixed(2)} USD\n`);
+        }
         // Track successful call
         const inputType = filePaths.length > 0
             ? 'file'

package/dist/commands/index.js

@@ -28,6 +28,10 @@ const update_1 = require("./update");
 const env_1 = require("./env");
 const list_1 = require("./list");
 const test_1 = require("./test");
+const security_1 = require("./security");
+const billing_1 = require("./billing");
+const seller_1 = require("./seller");
+const pricing_1 = require("./pricing");
 function registerCommands(program) {
     (0, login_1.registerLoginCommand)(program);
     (0, whoami_1.registerWhoamiCommand)(program);
@@ -56,4 +60,8 @@ function registerCommands(program) {
     (0, env_1.registerEnvCommand)(program);
     (0, list_1.registerListCommand)(program);
     (0, test_1.registerTestCommand)(program);
+    (0, security_1.registerSecurityCommand)(program);
+    (0, billing_1.registerBillingCommand)(program);
+    (0, seller_1.registerSellerCommand)(program);
+    (0, pricing_1.registerPricingCommand)(program);
 }

package/dist/commands/info.js

@@ -1,9 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerInfoCommand = registerInfoCommand;
+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 pricing_1 = require("../lib/pricing");
 function formatSchema(schema, indent = '  ') {
     const lines = [];
     const props = schema.properties || {};
@@ -45,11 +50,48 @@ async function fetchReadme(url) {
     }
 }
 async function downloadAgentWithFallback(config, org, agent, version) {
-    // Try public endpoint first
+    // First fetch public metadata to get pricing fields
+    let publicMeta = null;
     try {
-        return await (0, api_1.publicRequest)(config, `/public/agents/${org}/${agent}/${version}/download`);
+        publicMeta = await (0, api_1.getPublicAgent)(config, org, agent, version);
     }
     catch (err) {
+        // If public metadata not found, continue to try download
+        if (!(err instanceof api_1.ApiError) || err.status !== 404) {
+            // Some other error, rethrow
+            throw err;
+        }
+    }
+    // Try public download endpoint
+    try {
+        const downloadData = await (0, api_1.publicRequest)(config, `/public/agents/${org}/${agent}/${version}/download`);
+        // Merge pricing fields from publicMeta if not present
+        if (publicMeta && !downloadData.pricing_mode) {
+            downloadData.pricing_mode = publicMeta.pricing_mode;
+            downloadData.price_per_call_cents = publicMeta.price_per_call_cents;
+        }
+        return downloadData;
+    }
+    catch (err) {
+        // Handle 403 PAID_AGENT_SERVER_ONLY error
+        if (err instanceof api_1.ApiError && err.status === 403) {
+            const payload = err.payload;
+            if (payload?.error?.code === 'PAID_AGENT_SERVER_ONLY') {
+                // For non-owners, use public metadata
+                if (publicMeta) {
+                    return {
+                        type: publicMeta.type,
+                        name: publicMeta.name,
+                        version: publicMeta.version,
+                        description: publicMeta.description,
+                        supported_providers: publicMeta.supported_providers || ['any'],
+                        source_url: publicMeta.source_url,
+                        pricing_mode: publicMeta.pricing_mode,
+                        price_per_call_cents: publicMeta.price_per_call_cents,
+                    };
+                }
+            }
+        }
         if (!(err instanceof api_1.ApiError) || err.status !== 404)
             throw err;
     }
@@ -93,12 +135,14 @@ async function downloadAgentWithFallback(config, org, agent, version) {
         run_command: targetAgent.run_command,
         url: targetAgent.url,
         sdk_compatible: false,
+        pricing_mode: targetAgent.pricing_mode,
+        price_per_call_cents: targetAgent.price_per_call_cents,
     };
 }
 function registerInfoCommand(program) {
     program
         .command('info <agent>')
-        .description('Show agent information and README')
+        .description('Show agent details including pricing, inputs, and outputs')
         .option('--json', 'Output as JSON')
         .action(async (agentArg, options) => {
         const config = await (0, config_1.getResolvedConfig)();
@@ -123,6 +167,15 @@ function registerInfoCommand(program) {
         }
         process.stdout.write(`Type: ${agentData.type}\n`);
         process.stdout.write(`Providers: ${agentData.supported_providers.join(', ')}\n`);
+        // Display pricing information
+        const priceStr = (0, pricing_1.formatPrice)(agentData);
+        const color = (0, pricing_1.isPaidAgent)(agentData) ? chalk_1.default.yellow : chalk_1.default.green;
+        process.stdout.write(`Price: ${color(priceStr)}\n`);
+        // If paid, show server-only message for non-owners
+        if ((0, pricing_1.isPaidAgent)(agentData)) {
+            process.stdout.write(chalk_1.default.gray('Note: Paid agents run on server only (use orch call)\n'));
+            process.stdout.write(chalk_1.default.gray('      Owners can still download for development/testing\n'));
+        }
         if (agentData.type === 'code') {
             // Don't show internal routing URLs - they confuse users
             if (agentData.url && !agentData.url.includes('.internal')) {

package/dist/commands/install.js

@@ -14,6 +14,7 @@ const analytics_1 = require("../lib/analytics");
 const adapters_1 = require("../adapters");
 const installed_1 = require("../lib/installed");
 const agents_md_utils_1 = require("../lib/agents-md-utils");
+const pricing_1 = require("../lib/pricing");
 const DEFAULT_VERSION = 'latest';
 function parseAgentRef(value) {
     const [ref, versionPart] = value.split('@');
@@ -28,16 +29,70 @@ function parseAgentRef(value) {
     throw new errors_1.CliError('Invalid agent reference. Use org/agent or agent format.');
 }
 async function downloadAgentWithFallback(config, org, name, version) {
-    // Try public endpoint first
+    // Fetch public metadata first to check if paid
+    let publicMeta;
     try {
-        const agent = await (0, api_1.publicRequest)(config, `/public/agents/${org}/${name}/${version}`);
-        return { ...agent, org_slug: org };
+        publicMeta = await (0, api_1.getPublicAgent)(config, org, name, version);
     }
     catch (err) {
-        if (!(err instanceof api_1.ApiError) || err.status !== 404)
+        // If 404, might be private agent - will handle below
+        if (err instanceof api_1.ApiError && err.status === 404) {
+            publicMeta = null;
+        }
+        else {
             throw err;
+        }
+    }
+    // Check if paid agent
+    if (publicMeta && (0, pricing_1.isPaidAgent)(publicMeta)) {
+        // Paid agent - check if owner
+        if (config.apiKey) {
+            const callerOrg = await (0, api_1.getOrg)(config);
+            const isOwner = (publicMeta.org_id && callerOrg.id === publicMeta.org_id) ||
+                (publicMeta.org_slug && callerOrg.slug === publicMeta.org_slug);
+            if (isOwner) {
+                // Owner - fetch from authenticated endpoint with full prompt
+                const myAgents = await (0, api_1.listMyAgents)(config);
+                const matching = myAgents.filter(a => a.name === name);
+                if (matching.length > 0) {
+                    let targetAgent;
+                    if (version === 'latest') {
+                        targetAgent = matching.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime())[0];
+                    }
+                    else {
+                        const found = matching.find(a => a.version === version);
+                        if (!found) {
+                            throw new api_1.ApiError(`Agent '${org}/${name}@${version}' not found`, 404);
+                        }
+                        targetAgent = found;
+                    }
+                    // Fetch full agent data with prompt from authenticated endpoint
+                    const agentData = await (0, api_1.request)(config, 'GET', `/agents/${targetAgent.id}`);
+                    return { ...agentData, org_slug: org };
+                }
+            }
+            else {
+                // Non-owner - block with helpful message
+                const price = (0, pricing_1.formatPrice)(publicMeta);
+                throw new errors_1.CliError(`This agent is paid (${price}) and runs on server only.\n\n` +
+                    `Use: orch call ${org}/${name}@${version} --input '{...}'`);
+            }
+        }
+        else {
+            // Not authenticated - block
+            const price = (0, pricing_1.formatPrice)(publicMeta);
+            throw new errors_1.CliError(`This agent is paid (${price}) and runs on server only.\n\n` +
+                `Use: orch call ${org}/${name}@${version} --input '{...}'`);
+        }
+    }
+    // Free agent - proceed normally with public data
+    if (publicMeta) {
+        // Cast PublicAgent to Agent for use as CanonicalAgent
+        // publicRequest already returns full agent data for free agents
+        const agent = await (0, api_1.publicRequest)(config, `/public/agents/${org}/${name}/${version}`);
+        return { ...agent, org_slug: org };
     }
-    // Fallback to authenticated endpoint for private agents
+    // No public metadata found - fallback to authenticated endpoint for private agents
     if (!config.apiKey) {
         throw new api_1.ApiError(`Agent '${org}/${name}@${version}' not found`, 404);
     }
@@ -71,6 +126,10 @@ function registerInstallCommand(program) {
         .option('--scope <scope>', 'Install scope: user (home dir) or project (current dir)', 'user')
         .option('--dry-run', 'Show what would be installed without making changes')
         .option('--json', 'Output result as JSON (for automation/tooling)')
+        .addHelpText('after', `
+Note: Paid agents cannot be installed locally - they run on server only.
+      Use 'orch call' to execute paid agents.
+`)
         .action(async (agentArg, options) => {
         const jsonMode = options.json === true;
         const log = (msg) => { if (!jsonMode)

package/dist/commands/pricing.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPricingCommand = registerPricingCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const errors_1 = require("../lib/errors");
+function registerPricingCommand(program) {
+    program
+        .command('pricing <agent> <mode>')
+        .description('Set pricing for your agent (free or per-call in USD)')
+        .action(async (agentRef, mode) => {
+        const resolved = await (0, config_1.getResolvedConfig)();
+        // Parse agent reference
+        const [orgOrAgent, maybeName] = agentRef.split('/');
+        let org;
+        let agentName;
+        if (maybeName) {
+            // Format: org/agent
+            org = orgOrAgent;
+            agentName = maybeName;
+        }
+        else {
+            // Format: agent (use default org)
+            const userOrg = await (0, api_1.getOrg)(resolved);
+            org = userOrg.slug;
+            agentName = orgOrAgent;
+        }
+        // Look up agent ID
+        const myAgents = await (0, api_1.listMyAgents)(resolved);
+        const agent = myAgents.find(a => a.org_slug === org && a.name === agentName);
+        if (!agent) {
+            throw new errors_1.CliError(`Agent '${org}/${agentName}' not found in your agents.\n\n` +
+                `List your agents: orch agents`, errors_1.ExitCodes.NOT_FOUND);
+        }
+        // Parse pricing mode
+        let pricingMode;
+        let pricePerCallCents;
+        if (mode === 'free' || mode === '0') {
+            pricingMode = 'free';
+            pricePerCallCents = undefined;
+        }
+        else {
+            // Parse as dollar amount
+            const priceFloat = parseFloat(mode);
+            if (isNaN(priceFloat)) {
+                throw new errors_1.CliError(`Invalid pricing mode: ${mode}\n\n` +
+                    `Use "free" or a dollar amount (e.g., "0.50" for $0.50 USD)`, errors_1.ExitCodes.INVALID_INPUT);
+            }
+            if (priceFloat < 0.01) {
+                throw new errors_1.CliError('Price must be at least $0.01 USD', errors_1.ExitCodes.INVALID_INPUT);
+            }
+            pricingMode = 'per_call';
+            pricePerCallCents = Math.round(priceFloat * 100);
+        }
+        // Set pricing
+        await (0, api_1.setAgentPricing)(resolved, agent.id, pricingMode, pricePerCallCents);
+        // Show confirmation
+        process.stdout.write(chalk_1.default.green('✓ Pricing updated\n'));
+        process.stdout.write(`Agent: ${org}/${agentName}\n`);
+        if (pricingMode === 'free') {
+            process.stdout.write(`Mode: FREE\n`);
+        }
+        else {
+            process.stdout.write(`Mode: Pay per call\n`);
+            process.stdout.write(`Price: $${(pricePerCallCents / 100).toFixed(2)} USD per call\n`);
+        }
+    });
+}