agent-media-cli 1.0.0

package/dist/commands/apikey.js

@@ -0,0 +1,282 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * `agent-media apikey` command group.
+ *
+ * Manages user API keys: list, create, and revoke. API keys are used
+ * for authenticating CLI and programmatic access to the agent-media
+ * platform.
+ *
+ * Subcommands:
+ * - `agent-media apikey list`            -- list all active API keys
+ * - `agent-media apikey create <name>`   -- create a new API key
+ * - `agent-media apikey revoke <key-id>` -- revoke an existing key
+ *
+ * Supports human, JSON, and quiet output modes via global flags.
+ */
+import { createInterface } from 'node:readline';
+import chalk from 'chalk';
+import { detectOutputMode, printJson, printQuiet, createSpinner, } from '../lib/output.js';
+import { getApiKey, resolveProfileName } from '../lib/credentials.js';
+import { AgentMediaAPI, } from '../lib/api.js';
+import { CLIError, handleError } from '../lib/errors.js';
+/**
+ * Require authentication and return the API key or throw.
+ */
+function requireAuth(profileName) {
+    const apiKey = getApiKey(profileName);
+    if (!apiKey) {
+        throw new CLIError('Not logged in.', {
+            code: 'NOT_AUTHENTICATED',
+            suggestion: "Run 'agent-media login' to authenticate.",
+        });
+    }
+    return apiKey;
+}
+/**
+ * Format a date string into a short human-readable label.
+ * Returns "Never" for null/undefined values.
+ */
+function formatDate(dateStr) {
+    if (!dateStr)
+        return 'Never';
+    const date = new Date(dateStr);
+    const now = new Date();
+    const months = [
+        'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+        'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec',
+    ];
+    const month = months[date.getMonth()];
+    const day = date.getDate();
+    // If same year, show "Mon DD"; otherwise "Mon DD, YYYY"
+    if (date.getFullYear() === now.getFullYear()) {
+        return `${month} ${day}`;
+    }
+    return `${month} ${day}, ${date.getFullYear()}`;
+}
+/**
+ * Pad or truncate a string to an exact column width.
+ * Strips ANSI codes for length calculation.
+ */
+function fixedWidth(str, width) {
+    // eslint-disable-next-line no-control-regex
+    const stripped = str.replace(/\x1B\[[0-9;]*m/g, '');
+    if (stripped.length >= width)
+        return str;
+    return str + ' '.repeat(width - stripped.length);
+}
+/**
+ * Truncate a string to a maximum length, appending ellipsis if needed.
+ */
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.slice(0, maxLen - 1) + '\u2026';
+}
+/**
+ * Print a formatted table of API keys.
+ */
+function printKeyTable(keys) {
+    const COL_PREFIX = 10;
+    const COL_NAME = 14;
+    const COL_CREATED = 12;
+    const COL_LAST_USED = 12;
+    const header = fixedWidth('PREFIX', COL_PREFIX) +
+        fixedWidth('NAME', COL_NAME) +
+        fixedWidth('CREATED', COL_CREATED) +
+        'LAST USED';
+    const separator = '\u2500'.repeat(COL_PREFIX) +
+        '\u2500'.repeat(COL_NAME) +
+        '\u2500'.repeat(COL_CREATED) +
+        '\u2500'.repeat(COL_LAST_USED);
+    console.log();
+    console.log(chalk.bold(`  API Keys (${keys.length})`));
+    console.log();
+    console.log(`  ${chalk.bold(header)}`);
+    console.log(`  ${chalk.dim(separator)}`);
+    for (const key of keys) {
+        const prefix = fixedWidth(key.key_prefix, COL_PREFIX);
+        const name = fixedWidth(truncate(key.name, COL_NAME - 2), COL_NAME);
+        const created = fixedWidth(formatDate(key.created_at), COL_CREATED);
+        const lastUsed = formatDate(key.last_used_at);
+        console.log(`  ${prefix}${name}${created}${lastUsed}`);
+    }
+    console.log();
+}
+/**
+ * Ask a yes/no question on stdin and return the result.
+ * Defaults to "no" (destructive action requires explicit confirmation).
+ */
+function askConfirmation(question) {
+    return new Promise((resolve) => {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(question, (answer) => {
+            rl.close();
+            const trimmed = answer.trim().toLowerCase();
+            resolve(trimmed === 'y' || trimmed === 'yes');
+        });
+    });
+}
+export function registerApikeyCommand(program) {
+    const apikeyCmd = program
+        .command('apikey')
+        .description('Manage API keys');
+    // ── agent-media apikey list ──────────────────────────────────────────────
+    apikeyCmd
+        .command('list')
+        .description('List all active API keys')
+        .action(async () => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        const profileName = resolveProfileName(globalOpts.profile);
+        const apiKey = requireAuth(profileName);
+        try {
+            const spinner = createSpinner('Fetching API keys...');
+            if (mode === 'human')
+                spinner.start();
+            const api = new AgentMediaAPI(apiKey);
+            const keys = await api.listApiKeys();
+            if (mode === 'human')
+                spinner.stop();
+            // ── Empty state ──────────────────────────────────────────────
+            if (keys.length === 0) {
+                switch (mode) {
+                    case 'json':
+                        printJson([]);
+                        break;
+                    case 'quiet':
+                        // No output for quiet mode on empty result
+                        break;
+                    default:
+                        console.log();
+                        console.log(chalk.dim("  No API keys found. Create one with 'agent-media apikey create <name>'."));
+                        console.log();
+                        break;
+                }
+                return;
+            }
+            // ── Output ───────────────────────────────────────────────────
+            switch (mode) {
+                case 'json':
+                    printJson(keys);
+                    break;
+                case 'quiet':
+                    printQuiet(keys.map((k) => k.key_prefix));
+                    break;
+                default:
+                    printKeyTable(keys);
+                    break;
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // ── agent-media apikey create <name> ─────────────────────────────────────
+    apikeyCmd
+        .command('create <name>')
+        .description('Create a new API key')
+        .action(async (name) => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        const profileName = resolveProfileName(globalOpts.profile);
+        const apiKey = requireAuth(profileName);
+        try {
+            const spinner = createSpinner('Creating API key...');
+            if (mode === 'human')
+                spinner.start();
+            const api = new AgentMediaAPI(apiKey);
+            const result = await api.createApiKey(name);
+            if (mode === 'human')
+                spinner.stop();
+            switch (mode) {
+                case 'json':
+                    printJson({
+                        id: result.id,
+                        name: result.name,
+                        api_key: result.key,
+                        key_prefix: result.key_prefix,
+                    });
+                    break;
+                case 'quiet':
+                    printQuiet(result.key);
+                    break;
+                default:
+                    console.log();
+                    console.log(`  ${chalk.green('\u2713')} API key created: ${chalk.bold(`"${result.name}"`)}`);
+                    console.log();
+                    console.log(`  ${chalk.cyan(result.key)}`);
+                    console.log();
+                    console.log(`  ${chalk.yellow('\u26A0')} Copy this key now. You won't see it again.`);
+                    console.log();
+                    break;
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+    // ── agent-media apikey revoke <key-id> ──────────────────────────────────
+    apikeyCmd
+        .command('revoke <key-id>')
+        .description('Revoke an API key')
+        .option('-f, --force', 'Skip confirmation prompt')
+        .action(async (keyId, cmdOpts) => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        const profileName = resolveProfileName(globalOpts.profile);
+        const apiKey = requireAuth(profileName);
+        try {
+            const api = new AgentMediaAPI(apiKey);
+            // Fetch the key list to show details before confirming
+            if (mode === 'human' && !cmdOpts.force) {
+                const spinner = createSpinner('Looking up API key...');
+                spinner.start();
+                const keys = await api.listApiKeys();
+                const targetKey = keys.find((k) => k.id === keyId);
+                spinner.stop();
+                if (targetKey) {
+                    console.log();
+                    console.log(`  ${chalk.bold('Key:')}      ${targetKey.key_prefix}`);
+                    console.log(`  ${chalk.bold('Name:')}     ${targetKey.name}`);
+                    console.log(`  ${chalk.bold('Created:')}  ${formatDate(targetKey.created_at)}`);
+                    console.log();
+                }
+                const confirmed = await askConfirmation(`  Revoke API key ${chalk.cyan(keyId.slice(0, 8))}? This cannot be undone. [y/N] `);
+                if (!confirmed) {
+                    console.log(chalk.dim('  Revocation cancelled.'));
+                    return;
+                }
+            }
+            const revokeSpinner = createSpinner('Revoking API key...');
+            if (mode === 'human')
+                revokeSpinner.start();
+            const result = await api.revokeManagedApiKey(keyId);
+            if (mode === 'human')
+                revokeSpinner.succeed('API key revoked');
+            switch (mode) {
+                case 'json':
+                    printJson({
+                        id: result.id,
+                        revoked: result.revoked,
+                    });
+                    break;
+                case 'quiet':
+                    printQuiet('revoked');
+                    break;
+                default:
+                    console.log();
+                    console.log(`  ${chalk.green('API key revoked successfully.')}`);
+                    console.log(chalk.dim('  Any applications using this key will lose access immediately.'));
+                    console.log();
+                    break;
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=apikey.js.map

package/dist/commands/apikey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apikey.js","sourceRoot":"","sources":["../../src/commands/apikey.ts"],"names":[],"mappings":"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"}

package/dist/commands/cancel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `agent-media cancel <job-id>` command.
+ *
+ * Cancels an active generation job (submitted/queued/processing)
+ * and refunds the credits. Use --all to cancel all active jobs.
+ */
+import type { Command } from 'commander';
+export declare function registerCancelCommand(program: Command): void;
+//# sourceMappingURL=cancel.d.ts.map

package/dist/commands/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/commands/cancel.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2G5D"}

package/dist/commands/cancel.js

@@ -0,0 +1,101 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+import chalk from 'chalk';
+import { detectOutputMode, printJson, printQuiet, createSpinner, } from '../lib/output.js';
+import { getApiKey, resolveProfileName } from '../lib/credentials.js';
+import { AgentMediaAPI } from '../lib/api.js';
+import { CLIError, handleError } from '../lib/errors.js';
+export function registerCancelCommand(program) {
+    program
+        .command('cancel [job-id]')
+        .description('Cancel an active generation job and refund credits')
+        .option('--all', 'Cancel all active (submitted/queued/processing) jobs')
+        .action(async (jobId, cmdOpts) => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        const profileName = resolveProfileName(globalOpts.profile);
+        const apiKey = getApiKey(profileName);
+        if (!apiKey) {
+            throw new CLIError('Not logged in.', {
+                code: 'NOT_AUTHENTICATED',
+                suggestion: "Run 'agent-media login' to authenticate.",
+            });
+        }
+        if (!jobId && !cmdOpts.all) {
+            throw new CLIError('Provide a job ID or use --all.', {
+                code: 'MISSING_ARGUMENT',
+                suggestion: "Usage: agent-media cancel <job-id> or agent-media cancel --all",
+            });
+        }
+        try {
+            const api = new AgentMediaAPI(apiKey);
+            // ── Cancel all active jobs ──────────────────────────────────────
+            if (cmdOpts.all) {
+                const spinner = createSpinner('Finding active jobs...');
+                if (mode === 'human')
+                    spinner.start();
+                const { jobs } = await api.listJobs({ limit: 100 });
+                const activeJobs = jobs.filter((j) => ['submitted', 'queued', 'processing'].includes(j.status));
+                if (activeJobs.length === 0) {
+                    if (mode === 'human') {
+                        spinner.stop();
+                        console.log(chalk.dim('\n  No active jobs to cancel.\n'));
+                    }
+                    else if (mode === 'json') {
+                        printJson({ canceled: [], count: 0, credits_refunded: 0 });
+                    }
+                    else {
+                        printQuiet('0');
+                    }
+                    return;
+                }
+                if (mode === 'human') {
+                    spinner.text = `Canceling ${activeJobs.length} active job${activeJobs.length === 1 ? '' : 's'}...`;
+                }
+                let totalRefunded = 0;
+                const canceled = [];
+                for (const job of activeJobs) {
+                    try {
+                        const result = await api.cancelJob(job.id);
+                        if (result.canceled) {
+                            canceled.push(job.id);
+                            totalRefunded += result.credits_refunded;
+                        }
+                    }
+                    catch {
+                        // Skip jobs that can't be canceled
+                    }
+                }
+                if (mode === 'human') {
+                    spinner.succeed(`Canceled ${canceled.length} job${canceled.length === 1 ? '' : 's'}, refunded ${chalk.green(String(totalRefunded))} credits`);
+                    console.log();
+                }
+                else if (mode === 'json') {
+                    printJson({ canceled, count: canceled.length, credits_refunded: totalRefunded });
+                }
+                else {
+                    printQuiet(String(canceled.length));
+                }
+                return;
+            }
+            // ── Cancel single job ───────────────────────────────────────────
+            const spinner = createSpinner('Canceling job...');
+            if (mode === 'human')
+                spinner.start();
+            const result = await api.cancelJob(jobId);
+            if (mode === 'human') {
+                spinner.succeed(`Job ${chalk.cyan(jobId.slice(0, 8))} canceled, ${chalk.green(String(result.credits_refunded))} credits refunded`);
+                console.log();
+            }
+            else if (mode === 'json') {
+                printJson(result);
+            }
+            else {
+                printQuiet('canceled');
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=cancel.js.map

package/dist/commands/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../src/commands/cancel.ts"],"names":[],"mappings":"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"}

package/dist/commands/completions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `agent-media completions <shell>` command.
+ *
+ * Generates shell completion scripts for bash, zsh, and fish.
+ * Users pipe the output into their shell's configuration to enable
+ * tab-completion of commands, options, and arguments.
+ *
+ * Usage:
+ *   agent-media completions bash >> ~/.bashrc
+ *   agent-media completions zsh  >> ~/.zshrc
+ *   agent-media completions fish > ~/.config/fish/completions/agent-media.fish
+ */
+import type { Command } from 'commander';
+export declare function registerCompletionsCommand(program: Command): void;
+//# sourceMappingURL=completions.d.ts.map

package/dist/commands/completions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completions.d.ts","sourceRoot":"","sources":["../../src/commands/completions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8QzC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqCjE"}