@orchagent/cli 0.3.52 → 0.3.53

package/dist/commands/index.js

@@ -28,6 +28,7 @@ const test_1 = require("./test");
 const security_1 = require("./security");
 const billing_1 = require("./billing");
 const agent_keys_1 = require("./agent-keys");
+const schedule_1 = require("./schedule");
 function registerCommands(program) {
     (0, login_1.registerLoginCommand)(program);
     (0, whoami_1.registerWhoamiCommand)(program);
@@ -56,4 +57,5 @@ function registerCommands(program) {
     (0, security_1.registerSecurityCommand)(program);
     (0, billing_1.registerBillingCommand)(program);
     (0, agent_keys_1.registerAgentKeysCommand)(program);
+    (0, schedule_1.registerScheduleCommand)(program);
 }

package/dist/commands/schedule.js

@@ -0,0 +1,297 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerScheduleCommand = registerScheduleCommand;
+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 agent_ref_1 = require("../lib/agent-ref");
+const api_2 = require("../lib/api");
+// ============================================
+// 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 statusColor(status) {
+    if (!status)
+        return '-';
+    switch (status) {
+        case 'completed': return chalk_1.default.green(status);
+        case 'failed': return chalk_1.default.red(status);
+        case 'running': return chalk_1.default.yellow(status);
+        default: return status;
+    }
+}
+// ============================================
+// COMMAND REGISTRATION
+// ============================================
+function registerScheduleCommand(program) {
+    const schedule = program
+        .command('schedule')
+        .description('Manage scheduled agent runs (cron and webhooks)');
+    // orch schedule list
+    schedule
+        .command('list')
+        .description('List schedules in your workspace')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .option('--agent <name>', 'Filter by agent name')
+        .option('--type <type>', 'Filter by type (cron or webhook)')
+        .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.agent)
+            params.set('agent_id', options.agent);
+        if (options.type)
+            params.set('schedule_type', options.type);
+        params.set('limit', '100');
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        const result = await (0, api_1.request)(config, 'GET', `/workspaces/${workspaceId}/schedules${qs}`);
+        if (options.json) {
+            (0, output_1.printJson)(result);
+            return;
+        }
+        if (result.schedules.length === 0) {
+            process.stdout.write('No schedules found.\n');
+            process.stdout.write(chalk_1.default.gray('\nCreate one with: orch schedule create <org/agent> --cron "0 9 * * *"\n'));
+            return;
+        }
+        const table = new cli_table3_1.default({
+            head: [
+                chalk_1.default.bold('ID'),
+                chalk_1.default.bold('Agent'),
+                chalk_1.default.bold('Type'),
+                chalk_1.default.bold('Schedule'),
+                chalk_1.default.bold('Enabled'),
+                chalk_1.default.bold('Last Run'),
+                chalk_1.default.bold('Status'),
+                chalk_1.default.bold('Runs'),
+            ],
+        });
+        result.schedules.forEach((s) => {
+            table.push([
+                s.id.slice(0, 8),
+                `${s.agent_name}@${s.agent_version}`,
+                s.schedule_type,
+                s.schedule_type === 'cron' ? (s.cron_expression ?? '-') : 'webhook',
+                s.enabled ? chalk_1.default.green('yes') : chalk_1.default.red('no'),
+                formatDate(s.last_run_at),
+                statusColor(s.last_run_status),
+                s.run_count.toString(),
+            ]);
+        });
+        process.stdout.write(`\n${table.toString()}\n`);
+        process.stdout.write(chalk_1.default.gray(`\n${result.total} schedule(s) total\n`));
+    });
+    // orch schedule create <agent>
+    schedule
+        .command('create <agent>')
+        .description('Create a cron or webhook schedule (org/agent[@version])')
+        .option('--cron <expression>', 'Cron expression (e.g., "0 9 * * 1" for every Monday 9am)')
+        .option('--webhook', 'Create a webhook-triggered schedule instead of cron')
+        .option('--timezone <tz>', 'Timezone for cron schedule (default: UTC)', 'UTC')
+        .option('--input <json>', 'Input data as JSON string')
+        .option('--provider <provider>', 'LLM provider (anthropic, openai, gemini)')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .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.');
+        }
+        if (!options.cron && !options.webhook) {
+            throw new errors_1.CliError('Specify --cron <expression> or --webhook');
+        }
+        if (options.cron && options.webhook) {
+            throw new errors_1.CliError('Cannot use both --cron and --webhook. Choose one.');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const ref = (0, agent_ref_1.parseAgentRef)(agentArg);
+        // Resolve agent to get the ID
+        const agent = await (0, api_2.getAgentWithFallback)(config, ref.org, ref.agent, ref.version);
+        // Parse input data
+        let inputData;
+        if (options.input) {
+            try {
+                inputData = JSON.parse(options.input);
+            }
+            catch {
+                throw new errors_1.CliError('Invalid JSON in --input. Use single quotes: --input \'{"key": "value"}\'');
+            }
+        }
+        const scheduleType = options.webhook ? 'webhook' : 'cron';
+        const body = {
+            agent_id: agent.id,
+            agent_name: ref.agent,
+            agent_version: ref.version === 'latest' ? (agent.version ?? ref.version) : ref.version,
+            schedule_type: scheduleType,
+            timezone: options.timezone ?? 'UTC',
+        };
+        if (options.cron)
+            body.cron_expression = options.cron;
+        if (inputData)
+            body.input_data = inputData;
+        if (options.provider)
+            body.llm_provider = options.provider;
+        const result = await (0, api_1.request)(config, 'POST', `/workspaces/${workspaceId}/schedules`, {
+            body: JSON.stringify(body),
+            headers: { 'Content-Type': 'application/json' },
+        });
+        const s = result.schedule;
+        process.stdout.write(chalk_1.default.green('\u2713') + ` Schedule created\n\n`);
+        process.stdout.write(`  ID:     ${s.id}\n`);
+        process.stdout.write(`  Agent:  ${s.agent_name}@${s.agent_version}\n`);
+        process.stdout.write(`  Type:   ${s.schedule_type}\n`);
+        if (s.schedule_type === 'cron') {
+            process.stdout.write(`  Cron:   ${s.cron_expression}\n`);
+            process.stdout.write(`  TZ:     ${s.timezone}\n`);
+            if (s.next_run_at) {
+                process.stdout.write(`  Next:   ${formatDate(s.next_run_at)}\n`);
+            }
+        }
+        else {
+            if (s.webhook_url) {
+                process.stdout.write(`\n  ${chalk_1.default.bold('Webhook URL')} (save this — secret shown once):\n`);
+                process.stdout.write(`  ${s.webhook_url}\n`);
+            }
+        }
+        process.stdout.write('\n');
+    });
+    // orch schedule update <schedule-id>
+    schedule
+        .command('update <schedule-id>')
+        .description('Update a schedule')
+        .option('--cron <expression>', 'New cron expression')
+        .option('--timezone <tz>', 'New timezone')
+        .option('--input <json>', 'New input data as JSON')
+        .option('--provider <provider>', 'New LLM provider')
+        .option('--enable', 'Enable the schedule')
+        .option('--disable', 'Disable the schedule')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .action(async (scheduleId, options) => {
+        const config = await (0, config_1.getResolvedConfig)();
+        if (!config.apiKey) {
+            throw new errors_1.CliError('Missing API key. Run `orch login` first.');
+        }
+        if (options.enable && options.disable) {
+            throw new errors_1.CliError('Cannot use both --enable and --disable');
+        }
+        const workspaceId = await resolveWorkspaceId(config, options.workspace);
+        const updates = {};
+        if (options.cron)
+            updates.cron_expression = options.cron;
+        if (options.timezone)
+            updates.timezone = options.timezone;
+        if (options.provider)
+            updates.llm_provider = options.provider;
+        if (options.enable)
+            updates.enabled = true;
+        if (options.disable)
+            updates.enabled = false;
+        if (options.input) {
+            try {
+                updates.input_data = JSON.parse(options.input);
+            }
+            catch {
+                throw new errors_1.CliError('Invalid JSON in --input');
+            }
+        }
+        if (Object.keys(updates).length === 0) {
+            throw new errors_1.CliError('Nothing to update. Specify at least one option.');
+        }
+        const result = await (0, api_1.request)(config, 'PATCH', `/workspaces/${workspaceId}/schedules/${scheduleId}`, {
+            body: JSON.stringify(updates),
+            headers: { 'Content-Type': 'application/json' },
+        });
+        const s = result.schedule;
+        process.stdout.write(chalk_1.default.green('\u2713') + ` Schedule updated\n\n`);
+        process.stdout.write(`  ID:      ${s.id}\n`);
+        process.stdout.write(`  Enabled: ${s.enabled ? chalk_1.default.green('yes') : chalk_1.default.red('no')}\n`);
+        if (s.cron_expression) {
+            process.stdout.write(`  Cron:    ${s.cron_expression}\n`);
+            process.stdout.write(`  TZ:      ${s.timezone}\n`);
+        }
+        if (s.next_run_at) {
+            process.stdout.write(`  Next:    ${formatDate(s.next_run_at)}\n`);
+        }
+        process.stdout.write('\n');
+    });
+    // orch schedule delete <schedule-id>
+    schedule
+        .command('delete <schedule-id>')
+        .description('Delete a schedule')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .action(async (scheduleId, 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);
+        await (0, api_1.request)(config, 'DELETE', `/workspaces/${workspaceId}/schedules/${scheduleId}`);
+        process.stdout.write(chalk_1.default.green('\u2713') + ` Schedule ${scheduleId} deleted\n`);
+    });
+    // orch schedule trigger <schedule-id>
+    schedule
+        .command('trigger <schedule-id>')
+        .description('Manually trigger a schedule execution')
+        .option('--input <json>', 'Override input data as JSON')
+        .option('--workspace <slug>', 'Workspace slug (default: current workspace)')
+        .action(async (scheduleId, 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);
+        let body;
+        if (options.input) {
+            try {
+                JSON.parse(options.input); // validate
+                body = options.input;
+            }
+            catch {
+                throw new errors_1.CliError('Invalid JSON in --input');
+            }
+        }
+        process.stdout.write('Triggering schedule...\n');
+        const result = await (0, api_1.request)(config, 'POST', `/workspaces/${workspaceId}/schedules/${scheduleId}/trigger`, body ? {
+            body,
+            headers: { 'Content-Type': 'application/json' },
+        } : {});
+        process.stdout.write(chalk_1.default.green('\u2713') + ` Run completed\n\n`);
+        process.stdout.write(`  Run ID:   ${result.run_id}\n`);
+        process.stdout.write(`  Status:   ${statusColor(result.status)}\n`);
+        process.stdout.write(`  Duration: ${result.duration_ms}ms\n`);
+        if (result.error) {
+            process.stdout.write(`  Error:    ${chalk_1.default.red(result.error)}\n`);
+        }
+        if (result.output) {
+            process.stdout.write(`\n  Output:\n`);
+            process.stdout.write(`  ${JSON.stringify(result.output, null, 2).split('\n').join('\n  ')}\n`);
+        }
+        process.stdout.write('\n');
+    });
+}

package/package.json

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