@orchagent/cli 0.3.54 → 0.3.55

package/dist/commands/service.js

@@ -0,0 +1,401 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerServiceCommand = registerServiceCommand;
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
+const errors_1 = require("../lib/errors");
+const output_1 = require("../lib/output");
+const spinner_1 = require("../lib/spinner");
+// ============================================
+// HELPERS
+// ============================================
+async function resolveWorkspaceId(config, slug) {
+    const configFile = await (0, config_1.loadConfig)();
+    const targetSlug = slug ?? configFile.workspace;
+    if (!targetSlug) {
+        throw new errors_1.CliError('No workspace specified. Use --workspace <slug> or run `orch workspace use <slug>` first.');
+    }
+    const response = await (0, api_1.request)(config, 'GET', '/workspaces');
+    const workspace = response.workspaces.find((w) => w.slug === targetSlug);
+    if (!workspace) {
+        throw new errors_1.CliError(`Workspace '${targetSlug}' not found.`);
+    }
+    return workspace.id;
+}
+function formatDate(iso) {
+    if (!iso)
+        return '-';
+    return new Date(iso).toLocaleString();
+}
+function stateColor(state) {
+    switch (state) {
+        case 'running':
+            return chalk_1.default.green(state);
+        case 'provisioning':
+            return chalk_1.default.yellow(state);
+        case 'unhealthy':
+        case 'failed':
+            return chalk_1.default.red(state);
+        case 'deleting':
+        case 'deleted':
+            return chalk_1.default.gray(state);
+        default:
+            return state;
+    }
+}
+function healthColor(health) {
+    switch (health) {
+        case 'healthy':
+            return chalk_1.default.green(health);
+        case 'degraded':
+            return chalk_1.default.yellow(health);
+        case 'unhealthy':
+            return chalk_1.default.red(health);
+        default:
+            return chalk_1.default.gray(health);
+    }
+}
+function severityColor(severity, message) {
+    switch (severity.toUpperCase()) {
+        case 'ERROR':
+        case 'CRITICAL':
+            return chalk_1.default.red(message);
+        case 'WARNING':
+            return chalk_1.default.yellow(message);
+        case 'INFO':
+            return chalk_1.default.white(message);
+        default:
+            return chalk_1.default.gray(message);
+    }
+}
+// ============================================
+// COMMAND REGISTRATION
+// ============================================
+function registerServiceCommand(program) {
+    const service = program
+        .command('service')
+        .description('Manage always-on automation services');
+    // orch service deploy <org/agent[@version]>
+    service
+        .command('deploy <agent>')
+        .description('Deploy an always-on automation service')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--name <service-name>', 'Service name (default: agent name)')
+        .option('--min-instances <n>', 'Minimum instances (default: 1)', '1')
+        .option('--max-instances <n>', 'Maximum instances (default: 1)', '1')
+        .option('--env <KEY=VALUE>', 'Environment variable (repeatable)', collectKeyValue, {})
+        .option('--secret <NAME>', 'Workspace secret name (repeatable)', collectArray, [])
+        .option('--command <cmd>', 'Override entrypoint command')
+        .option('--arg <value>', 'Command argument (repeatable)', collectArray, [])
+        .option('--json', 'Output as JSON')
+        .action(async (agentArg, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        // Parse agent ref: org/agent[@version]
+        const parts = agentArg.split('/');
+        if (parts.length !== 2) {
+            throw new errors_1.CliError('Agent must be in format: org/agent[@version]');
+        }
+        const [, agentPart] = parts;
+        const atIndex = agentPart.indexOf('@');
+        const agentName = atIndex >= 0 ? agentPart.slice(0, atIndex) : agentPart;
+        const agentVersion = atIndex >= 0 ? agentPart.slice(atIndex + 1) : 'latest';
+        const serviceName = options.name || agentName;
+        const minInstances = parseInt(options.minInstances, 10);
+        const maxInstances = parseInt(options.maxInstances, 10);
+        if (isNaN(minInstances) || isNaN(maxInstances)) {
+            throw new errors_1.CliError('--min-instances and --max-instances must be numbers');
+        }
+        // First, resolve the agent to get agent_id
+        const spinner = (0, spinner_1.createSpinner)('Resolving agent...');
+        spinner.start();
+        let agentId;
+        try {
+            // List agents for the workspace via the correct gateway endpoint
+            const agentsList = await (0, api_1.request)(config, 'GET', `/agents?workspace_id=${workspaceId}`);
+            let match;
+            if (agentVersion === 'latest') {
+                // Filter all matching agents by name, sort by created_at desc to get newest
+                const candidates = agentsList
+                    .filter(a => a.name === agentName)
+                    .sort((a, b) => (b.created_at ?? '').localeCompare(a.created_at ?? ''));
+                match = candidates[0];
+            }
+            else {
+                match = agentsList.find(a => a.name === agentName && a.version === agentVersion);
+            }
+            if (!match) {
+                spinner.fail('Agent not found');
+                throw new errors_1.CliError(`Agent '${agentName}' (version ${agentVersion}) not found in workspace`);
+            }
+            agentId = match.id;
+            spinner.succeed('Agent resolved');
+        }
+        catch (e) {
+            if (e instanceof errors_1.CliError)
+                throw e;
+            spinner.fail('Failed to resolve agent');
+            throw e;
+        }
+        const deploySpinner = (0, spinner_1.createSpinner)('Deploying service...');
+        deploySpinner.start();
+        try {
+            const result = await (0, api_1.request)(config, 'POST', `/workspaces/${workspaceId}/services`, {
+                body: JSON.stringify({
+                    agent_id: agentId,
+                    agent_name: agentName,
+                    agent_version: agentVersion,
+                    service_name: serviceName,
+                    min_instances: minInstances,
+                    max_instances: maxInstances,
+                    command: options.command || null,
+                    args: options.arg.length > 0 ? options.arg : null,
+                    env: Object.keys(options.env).length > 0 ? options.env : null,
+                    secret_names: options.secret.length > 0 ? options.secret : null,
+                }),
+                headers: { 'Content-Type': 'application/json' },
+            });
+            deploySpinner.succeed('Service deployed');
+            if (options.json) {
+                (0, output_1.printJson)(result.service);
+                return;
+            }
+            const svc = result.service;
+            process.stdout.write(`\n${chalk_1.default.green('\u2713')} Service deployed successfully\n\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('ID:')}       ${svc.id}\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('Name:')}     ${svc.service_name}\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('Agent:')}    ${svc.agent_name}@${svc.agent_version}\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('State:')}    ${stateColor(svc.current_state)}\n`);
+            process.stdout.write(`  ${chalk_1.default.bold('URL:')}      ${svc.cloud_run_url || '-'}\n`);
+            process.stdout.write(`\n`);
+            process.stdout.write(chalk_1.default.gray(`View logs: orch service logs ${svc.id}\n`));
+        }
+        catch (e) {
+            deploySpinner.fail('Deploy failed');
+            throw e;
+        }
+    });
+    // orch service list
+    service
+        .command('list')
+        .description('List automation services in your workspace')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--status <state>', 'Filter by state')
+        .option('--json', 'Output as JSON')
+        .action(async (options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const params = new URLSearchParams();
+        if (options.status)
+            params.set('status', options.status);
+        params.set('limit', '100');
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const result = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/services${qs}`);
+        if (options.json) {
+            (0, output_1.printJson)(result);
+            return;
+        }
+        if (!result.services.length) {
+            process.stdout.write('No services found.\n');
+            process.stdout.write(chalk_1.default.gray('Deploy one with: orch service deploy <org/agent>\n'));
+            return;
+        }
+        const table = new cli_table3_1.default({
+            head: [
+                chalk_1.default.bold('Name'),
+                chalk_1.default.bold('Agent'),
+                chalk_1.default.bold('State'),
+                chalk_1.default.bold('Health'),
+                chalk_1.default.bold('Restarts'),
+                chalk_1.default.bold('Deployed'),
+            ],
+        });
+        for (const svc of result.services) {
+            const stateLabel = svc.auto_paused_at
+                ? chalk_1.default.bgRed.white(' CRASH-LOOP ')
+                : stateColor(svc.current_state);
+            const restartsLabel = svc.consecutive_restart_failures > 0
+                ? `${svc.restart_count} (${chalk_1.default.red(String(svc.consecutive_restart_failures))} fails)`
+                : String(svc.restart_count);
+            table.push([
+                svc.service_name,
+                `${svc.agent_name}@${svc.agent_version}`,
+                stateLabel,
+                healthColor(svc.health_status),
+                restartsLabel,
+                formatDate(svc.last_deployed_at),
+            ]);
+        }
+        process.stdout.write(`${table.toString()}\n`);
+        process.stdout.write(chalk_1.default.gray(`\n${result.total} service${result.total !== 1 ? 's' : ''}\n`));
+    });
+    // orch service logs <service-id>
+    service
+        .command('logs <service-id>')
+        .description('Fetch recent logs for a service')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--limit <n>', 'Number of log lines (default: 100)', '100')
+        .option('--since <timestamp>', 'Only show logs after this ISO timestamp')
+        .option('--json', 'Output as JSON')
+        .action(async (serviceId, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const params = new URLSearchParams();
+        params.set('limit', options.limit);
+        if (options.since)
+            params.set('since', options.since);
+        const qs = `?${params.toString()}`;
+        const result = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/services/${serviceId}/logs${qs}`);
+        if (options.json) {
+            (0, output_1.printJson)(result);
+            return;
+        }
+        if (!result.logs.length) {
+            process.stdout.write('No logs found.\n');
+            return;
+        }
+        for (const entry of result.logs) {
+            const ts = entry.timestamp ? new Date(entry.timestamp).toISOString().replace('T', ' ').replace('Z', '') : '???';
+            const sev = entry.severity.padEnd(7);
+            process.stdout.write(`${chalk_1.default.gray(ts)} ${severityColor(entry.severity, sev)} ${entry.message}\n`);
+        }
+    });
+    // orch service restart <service-id>
+    service
+        .command('restart <service-id>')
+        .description('Restart an automation service')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--json', 'Output as JSON')
+        .action(async (serviceId, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const spinner = (0, spinner_1.createSpinner)('Restarting service...');
+        spinner.start();
+        try {
+            const result = await (0, api_1.request)(config, 'POST', `/workspaces/${workspaceId}/services/${serviceId}/restart`);
+            spinner.succeed('Service restarted');
+            if (options.json) {
+                (0, output_1.printJson)(result.service);
+                return;
+            }
+            process.stdout.write(`${chalk_1.default.green('\u2713')} Service '${result.service.service_name}' restarted (restarts: ${result.service.restart_count})\n`);
+        }
+        catch (e) {
+            spinner.fail('Restart failed');
+            throw e;
+        }
+    });
+    // orch service info <service-id>
+    service
+        .command('info <service-id>')
+        .description('Show detailed service information with events')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--json', 'Output as JSON')
+        .action(async (serviceId, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const result = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/services/${serviceId}`);
+        if (options.json) {
+            (0, output_1.printJson)(result.service);
+            return;
+        }
+        const svc = result.service;
+        process.stdout.write(`\n${chalk_1.default.bold('Service Details')}\n\n`);
+        process.stdout.write(`  ID:           ${svc.id}\n`);
+        process.stdout.write(`  Name:         ${svc.service_name}\n`);
+        process.stdout.write(`  Agent:        ${svc.agent_name}@${svc.agent_version}\n`);
+        process.stdout.write(`  State:        ${stateColor(svc.current_state)}\n`);
+        process.stdout.write(`  Health:       ${healthColor(svc.health_status)}\n`);
+        if (svc.auto_paused_at) {
+            process.stdout.write(`  ${chalk_1.default.bgRed.white(' CRASH-LOOP ')} auto-paused at ${formatDate(svc.auto_paused_at)}\n`);
+        }
+        process.stdout.write(`  Restarts:     ${svc.restart_count}\n`);
+        if (svc.consecutive_restart_failures > 0) {
+            process.stdout.write(`  Fail Streak:  ${chalk_1.default.red(String(svc.consecutive_restart_failures))} / ${svc.max_restart_failures}\n`);
+        }
+        process.stdout.write(`  Instances:    ${svc.min_instances}-${svc.max_instances}\n`);
+        process.stdout.write(`  Cloud Run:    ${svc.cloud_run_service || '-'}\n`);
+        process.stdout.write(`  URL:          ${svc.cloud_run_url || '-'}\n`);
+        process.stdout.write(`  Deployed:     ${formatDate(svc.last_deployed_at)}\n`);
+        process.stdout.write(`  Last Restart: ${formatDate(svc.last_restart_at)}\n`);
+        if (svc.last_error) {
+            process.stdout.write(`  Last Error:   ${chalk_1.default.red(svc.last_error)}\n`);
+        }
+        if (svc.alert_webhook_url) {
+            process.stdout.write(`  Alert URL:    ${svc.alert_webhook_url.slice(0, 50)}...\n`);
+        }
+        // Events timeline
+        const events = svc.events || [];
+        if (events.length > 0) {
+            process.stdout.write(`\n${chalk_1.default.bold('Recent Events')}\n`);
+            for (const e of events.slice(0, 10)) {
+                const color = e.event_type.includes('fail') || e.event_type.includes('paused') ? chalk_1.default.red : chalk_1.default.gray;
+                process.stdout.write(`  ${chalk_1.default.gray(formatDate(e.created_at))} ${color(e.event_type)} ${e.message || ''}\n`);
+            }
+        }
+        process.stdout.write('\n');
+    });
+    // orch service delete <service-id>
+    service
+        .command('delete <service-id>')
+        .description('Delete an automation service')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--json', 'Output as JSON')
+        .action(async (serviceId, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const spinner = (0, spinner_1.createSpinner)('Deleting service...');
+        spinner.start();
+        try {
+            const result = await (0, api_1.request)(config, 'DELETE', `/workspaces/${workspaceId}/services/${serviceId}`);
+            spinner.succeed('Service deleted');
+            if (options.json) {
+                (0, output_1.printJson)(result);
+                return;
+            }
+            process.stdout.write(`${chalk_1.default.green('\u2713')} Service '${result.service.service_name}' deleted\n`);
+        }
+        catch (e) {
+            spinner.fail('Delete failed');
+            throw e;
+        }
+    });
+}
+// ============================================
+// OPTION COLLECTORS
+// ============================================
+function collectKeyValue(value, previous) {
+    const idx = value.indexOf('=');
+    if (idx < 0) {
+        throw new errors_1.CliError(`Invalid env format: '${value}'. Use KEY=VALUE.`);
+    }
+    previous[value.slice(0, idx)] = value.slice(idx + 1);
+    return previous;
+}
+function collectArray(value, previous) {
+    previous.push(value);
+    return previous;
+}

package/dist/commands/transfer.js

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTransferCommand = registerTransferCommand;
+const promises_1 = __importDefault(require("readline/promises"));
+const chalk_1 = __importDefault(require("chalk"));
+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 output_1 = require("../lib/output");
+async function promptText(message) {
+    const rl = promises_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const answer = await rl.question(message);
+    rl.close();
+    return answer.trim();
+}
+function registerTransferCommand(program) {
+    program
+        .command('transfer <agent-name>')
+        .description('Transfer an agent to another workspace')
+        .requiredOption('--to <workspace-slug>', 'Target workspace slug')
+        .option('-y, --yes', 'Skip confirmation prompt')
+        .option('--dry-run', 'Show what would be transferred without making changes')
+        .option('--json', 'Output result as JSON')
+        .addHelpText('after', `
+Examples:
+  orch transfer my-agent --to team-workspace           # Transfer agent to another workspace
+  orch transfer my-agent --to team-workspace --dry-run  # Preview transfer
+  orch transfer my-agent --to team-workspace --yes      # Skip confirmation
+`)
+        .action(async (agentName, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Not logged in. Run `orchagent login` first.');
+        }
+        process.stdout.write('Finding agent and workspaces...\n');
+        // Fetch workspaces and agents in parallel
+        const [workspacesResponse, agents] = await Promise.all([
+            (0, api_1.request)(config, 'GET', '/workspaces'),
+            (0, api_1.listMyAgents)(config),
+        ]);
+        // Find the target workspace by slug
+        const targetWorkspace = workspacesResponse.workspaces.find((w) => w.slug === options.to);
+        if (!targetWorkspace) {
+            throw new errors_1.CliError(`Workspace '${options.to}' not found. Run \`orchagent workspace list\` to see available workspaces.`);
+        }
+        // Find the agent by name
+        const matching = agents.filter((a) => a.name === agentName);
+        if (matching.length === 0) {
+            throw new errors_1.CliError(`Agent '${agentName}' not found in current workspace.`);
+        }
+        // Use the most recent version to get the agent ID
+        const agent = matching.sort((a, b) => new Date(b.created_at).getTime() - new Date(a.created_at).getTime())[0];
+        // Check transfer eligibility
+        const check = await (0, api_1.checkAgentTransfer)(config, agent.id, targetWorkspace.id);
+        // Show transfer summary
+        process.stdout.write(`\n${chalk_1.default.bold('Agent:')} ${agent.name}\n`);
+        process.stdout.write(`${chalk_1.default.bold('Target workspace:')} ${targetWorkspace.name} (${targetWorkspace.slug})\n`);
+        const { details } = check;
+        process.stdout.write(`${chalk_1.default.bold('Versions:')} ${details.version_count}\n`);
+        if (details.grants_count > 0) {
+            process.stdout.write(`${chalk_1.default.bold('Grants to revoke:')} ${details.grants_count}\n`);
+        }
+        if (details.keys_count > 0) {
+            process.stdout.write(`${chalk_1.default.bold('Keys to delete:')} ${details.keys_count}\n`);
+        }
+        if (details.schedules_count > 0) {
+            process.stdout.write(`${chalk_1.default.bold('Schedules to disable:')} ${details.schedules_count}\n`);
+        }
+        process.stdout.write('\n');
+        // Show warnings
+        if (check.warnings.length > 0) {
+            for (const warning of check.warnings) {
+                process.stdout.write(chalk_1.default.yellow(`Warning: ${warning}\n`));
+            }
+            process.stdout.write('\n');
+        }
+        // Show blockers and exit if any
+        if (check.blockers.length > 0) {
+            for (const blocker of check.blockers) {
+                process.stdout.write(chalk_1.default.red(`Blocker: ${blocker}\n`));
+            }
+            process.stdout.write(chalk_1.default.red('\nTransfer cannot proceed due to blockers above.\n'));
+            process.exit(1);
+        }
+        // Handle dry-run
+        if (options.dryRun) {
+            process.stdout.write('DRY RUN - No changes will be made\n\n');
+            process.stdout.write(`Would transfer: ${agent.name} (${details.version_count} version(s))\n`);
+            process.stdout.write(`Target: ${targetWorkspace.name} (${targetWorkspace.slug})\n`);
+            if (details.grants_count > 0 || details.keys_count > 0 || details.schedules_count > 0) {
+                process.stdout.write(chalk_1.default.yellow(`Cleanup: ${details.grants_count} grant(s) revoked, ${details.keys_count} key(s) deleted, ${details.schedules_count} schedule(s) disabled\n`));
+            }
+            process.stdout.write('\nNo changes made (dry run)\n');
+            return;
+        }
+        // Prompt for confirmation
+        if (!options.yes) {
+            process.stdout.write(chalk_1.default.yellow('This will transfer the agent and all its versions to the target workspace.\n'));
+            process.stdout.write(chalk_1.default.yellow('Existing grants, keys, and schedules in the source workspace will be cleaned up.\n\n'));
+            const confirmName = await promptText(`Type "${agent.name}" to confirm transfer: `);
+            if (confirmName !== agent.name) {
+                process.stdout.write(chalk_1.default.red('\nTransfer cancelled. Name did not match.\n'));
+                process.exit(1);
+            }
+        }
+        // Perform transfer
+        process.stdout.write('Transferring agent...\n');
+        const result = await (0, api_1.transferAgent)(config, agent.id, {
+            target_workspace_id: targetWorkspace.id,
+            confirmation_name: agent.name,
+        });
+        await (0, analytics_1.track)('cli_transfer', {
+            agent_name: result.agent_name,
+            versions_transferred: result.versions_transferred,
+            target_workspace: result.target_workspace.slug,
+        });
+        if (options.json) {
+            (0, output_1.printJson)(result);
+            return;
+        }
+        process.stdout.write(`\n${chalk_1.default.green('+')} Transferred ${result.agent_name} (${result.versions_transferred} version(s))\n`);
+        process.stdout.write(`  From: ${result.source_workspace.name} (${result.source_workspace.slug})\n`);
+        process.stdout.write(`  To:   ${result.target_workspace.name} (${result.target_workspace.slug})\n`);
+        if (result.cleanup.grants_revoked > 0 || result.cleanup.keys_deleted > 0 || result.cleanup.schedules_disabled > 0) {
+            process.stdout.write(chalk_1.default.gray(`\nCleanup: ${result.cleanup.grants_revoked} grant(s) revoked, ${result.cleanup.keys_deleted} key(s) deleted, ${result.cleanup.schedules_disabled} schedule(s) disabled\n`));
+        }
+    });
+}

package/dist/lib/api.js

@@ -54,6 +54,8 @@ exports.getAgentWithFallback = getAgentWithFallback;
 exports.downloadCodeBundleAuthenticated = downloadCodeBundleAuthenticated;
 exports.checkAgentDelete = checkAgentDelete;
 exports.deleteAgent = deleteAgent;
+exports.checkAgentTransfer = checkAgentTransfer;
+exports.transferAgent = transferAgent;
 exports.previewAgentVersion = previewAgentVersion;
 exports.reportInstall = reportInstall;
 exports.fetchUserProfile = fetchUserProfile;
@@ -248,7 +250,7 @@ async function fetchLlmKeys(config) {
     return result.keys;
 }
 /**
- * Download a tool bundle for local execution.
+ * Download a code-runtime bundle for local execution.
  */
 async function downloadCodeBundle(config, org, agent, version) {
     const response = await safeFetch(`${config.apiUrl.replace(/\/$/, '')}/public/agents/${org}/${agent}/${version}/bundle`);
@@ -366,6 +368,21 @@ async function deleteAgent(config, agentId, confirmationName) {
     const params = confirmationName ? `?confirmation_name=${encodeURIComponent(confirmationName)}` : '';
     return request(config, 'DELETE', `/agents/${agentId}${params}`);
 }
+/**
+ * Check if an agent can be transferred to another workspace.
+ */
+async function checkAgentTransfer(config, agentId, targetWorkspaceId) {
+    return request(config, 'GET', `/agents/${agentId}/transfer-check?target_workspace_id=${encodeURIComponent(targetWorkspaceId)}`);
+}
+/**
+ * Transfer an agent to another workspace.
+ */
+async function transferAgent(config, agentId, data) {
+    return request(config, 'POST', `/agents/${agentId}/transfer`, {
+        body: JSON.stringify(data),
+        headers: { 'Content-Type': 'application/json' },
+    });
+}
 /**
  * Preview the next version number for an agent.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchagent/cli",
-  "version": "0.3.54",
+  "version": "0.3.55",
   "description": "Command-line interface for orchagent — deploy and run AI agents for your team",
   "license": "MIT",
   "author": "orchagent <hello@orchagent.io>",