agent-media-cli 1.0.0

package/dist/commands/update.js

@@ -0,0 +1,211 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+import { createRequire } from 'node:module';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { detectOutputMode, printJson, printQuiet, createSpinner } from '../lib/output.js';
+import { CLIError, handleError } from '../lib/errors.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+/** npm registry URL for the package. */
+const REGISTRY_URL = `https://registry.npmjs.org/${pkg.name}/latest`;
+/** Timeout for the registry fetch (5 seconds). */
+const FETCH_TIMEOUT_MS = 5_000;
+/**
+ * Compare two semver strings. Returns:
+ *  -1 if a < b, 0 if equal, 1 if a > b.
+ */
+function compareSemver(a, b) {
+    const pa = a.replace(/^v/, '').split('.').map(Number);
+    const pb = b.replace(/^v/, '').split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (va < vb)
+            return -1;
+        if (va > vb)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Fetch the latest version string from the npm registry.
+ */
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const res = await fetch(REGISTRY_URL, {
+            method: 'GET',
+            signal: controller.signal,
+            headers: { Accept: 'application/json' },
+        });
+        if (!res.ok) {
+            throw new CLIError(`Failed to check for updates (HTTP ${res.status})`, {
+                code: 'REGISTRY_ERROR',
+                suggestion: 'Check your network connection or try again later.',
+            });
+        }
+        const data = (await res.json());
+        if (!data.version) {
+            throw new CLIError('Unexpected response from npm registry.', {
+                code: 'REGISTRY_PARSE_ERROR',
+                suggestion: 'Try again later or check https://www.npmjs.com/package/agent-media manually.',
+            });
+        }
+        return data.version;
+    }
+    catch (error) {
+        if (error instanceof CLIError)
+            throw error;
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new CLIError('Timed out checking for updates.', {
+                code: 'REGISTRY_TIMEOUT',
+                suggestion: 'Check your network connection or try again later.',
+            });
+        }
+        throw new CLIError('Failed to check for updates.', {
+            code: 'REGISTRY_ERROR',
+            suggestion: 'Check your network connection or try again later.',
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Detect the package manager used to install the CLI globally.
+ *
+ * Checks for common indicators. Falls back to npm.
+ */
+function detectPackageManager() {
+    try {
+        const npmGlobalRoot = execSync('npm root -g', { encoding: 'utf-8' }).trim();
+        if (npmGlobalRoot && process.argv[1]?.includes(npmGlobalRoot)) {
+            return 'npm';
+        }
+    }
+    catch {
+        // ignore
+    }
+    try {
+        execSync('pnpm --version', { encoding: 'utf-8', stdio: 'pipe' });
+        return 'pnpm';
+    }
+    catch {
+        // ignore
+    }
+    return 'npm';
+}
+/**
+ * Build the install command string for the detected package manager.
+ */
+function buildInstallCommand(pm, version) {
+    const spec = `${pkg.name}@${version}`;
+    switch (pm) {
+        case 'pnpm':
+            return `pnpm add -g ${spec}`;
+        case 'yarn':
+            return `yarn global add ${spec}`;
+        default:
+            return `npm install -g ${spec}`;
+    }
+}
+export function registerUpdateCommand(program) {
+    program
+        .command('update')
+        .description('Check for and install CLI updates')
+        .option('--check', 'Check only, do not install')
+        .action(async (cmdOpts) => {
+        const globalOpts = program.opts();
+        const mode = detectOutputMode(globalOpts);
+        const checkOnly = cmdOpts.check ?? false;
+        try {
+            const spinner = createSpinner('Checking for updates...');
+            if (mode === 'human')
+                spinner.start();
+            const latestVersion = await fetchLatestVersion();
+            const currentVersion = pkg.version;
+            const comparison = compareSemver(currentVersion, latestVersion);
+            if (mode === 'human')
+                spinner.stop();
+            // Already up to date
+            if (comparison >= 0) {
+                switch (mode) {
+                    case 'json':
+                        printJson({
+                            current: currentVersion,
+                            latest: latestVersion,
+                            update_available: false,
+                        });
+                        break;
+                    case 'quiet':
+                        printQuiet(currentVersion);
+                        break;
+                    default:
+                        console.log();
+                        console.log(`  ${chalk.green('Up to date!')} agent-media v${currentVersion} is the latest version.`);
+                        console.log();
+                        break;
+                }
+                return;
+            }
+            // Update available
+            const pm = detectPackageManager();
+            const installCmd = buildInstallCommand(pm, latestVersion);
+            switch (mode) {
+                case 'json':
+                    printJson({
+                        current: currentVersion,
+                        latest: latestVersion,
+                        update_available: true,
+                        install_command: installCmd,
+                    });
+                    break;
+                case 'quiet':
+                    printQuiet(latestVersion);
+                    break;
+                default: {
+                    console.log();
+                    console.log(chalk.bold('  Update available!'));
+                    console.log();
+                    console.log(`  ${chalk.dim('Current:')}  v${currentVersion}`);
+                    console.log(`  ${chalk.green('Latest:')}   v${latestVersion}`);
+                    console.log();
+                    if (checkOnly) {
+                        console.log(`  Run the following to update:`);
+                        console.log();
+                        console.log(`    ${chalk.cyan(installCmd)}`);
+                        console.log();
+                        return;
+                    }
+                    // Attempt to install the update
+                    console.log(`  Installing update via ${pm}...`);
+                    console.log();
+                    const installSpinner = createSpinner(`Running: ${installCmd}`);
+                    installSpinner.start();
+                    try {
+                        execSync(installCmd, {
+                            encoding: 'utf-8',
+                            stdio: 'pipe',
+                        });
+                        installSpinner.succeed(`Updated agent-media from v${currentVersion} to v${latestVersion}`);
+                        console.log();
+                    }
+                    catch (installError) {
+                        installSpinner.fail('Installation failed');
+                        const msg = installError instanceof Error ? installError.message : String(installError);
+                        throw new CLIError(`Failed to install update: ${msg}`, {
+                            code: 'UPDATE_INSTALL_FAILED',
+                            suggestion: `Try installing manually:\n  ${installCmd}`,
+                        });
+                    }
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/commands/usage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `agent-media usage` command.
+ *
+ * Displays usage analytics for the authenticated user, including job
+ * counts, credit consumption, per-model breakdowns, and per-operation
+ * distributions. Data is fetched from the usage-stats edge function.
+ *
+ * Supports human (box-drawn tables), JSON, and quiet output modes.
+ * The time period is configurable via --period (7d, 30d, 90d).
+ */
+import type { Command } from 'commander';
+export declare function registerUsageCommand(program: Command): void;
+//# sourceMappingURL=usage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkXzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsG3D"}

package/dist/commands/usage.js

@@ -0,0 +1,344 @@
+// 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';
+// ── Box-drawing characters ─────────────────────────────────────────────────
+const BOX = {
+    topLeft: '\u256D',
+    topRight: '\u256E',
+    bottomLeft: '\u2570',
+    bottomRight: '\u256F',
+    horizontal: '\u2500',
+    vertical: '\u2502',
+    teeRight: '\u251C',
+    teeLeft: '\u2524',
+    cross: '\u253C',
+    teeDown: '\u252C',
+    teeUp: '\u2534',
+};
+/** Valid period values. */
+const VALID_PERIODS = ['7d', '30d', '90d'];
+/** Table width for the outer box (content area, excluding box chars). */
+const BOX_WIDTH = 61;
+// ── Formatting helpers ─────────────────────────────────────────────────────
+/**
+ * Format a number with thousands separators (e.g., 8540 -> "8,540").
+ */
+function formatNumber(n) {
+    return n.toLocaleString('en-US');
+}
+/**
+ * Compute success rate as a percentage from summary data.
+ */
+function successRate(stats) {
+    const { total_jobs, failed_jobs } = stats.summary;
+    if (total_jobs === 0)
+        return '0.0%';
+    const rate = ((total_jobs - failed_jobs) / total_jobs) * 100;
+    return `${rate.toFixed(1)}%`;
+}
+/**
+ * Compute average credit cost per job.
+ */
+function avgCostPerJob(stats) {
+    const { total_jobs, credits_used } = stats.summary;
+    if (total_jobs === 0)
+        return '0.0';
+    return (credits_used / total_jobs).toFixed(1);
+}
+/**
+ * Pad or truncate a string to an exact width.
+ */
+function pad(str, width) {
+    if (str.length >= width)
+        return str.slice(0, width);
+    return str + ' '.repeat(width - str.length);
+}
+/**
+ * Right-align a string within a given width.
+ */
+function rpad(str, width) {
+    if (str.length >= width)
+        return str.slice(0, width);
+    return ' '.repeat(width - str.length) + str;
+}
+/**
+ * Draw a horizontal box line (top, bottom, or separator).
+ */
+function boxLine(left, fill, right, width) {
+    return left + fill.repeat(width) + right;
+}
+/**
+ * Draw a box title row.
+ */
+function boxTitle(title, width) {
+    const top = boxLine(BOX.topLeft, BOX.horizontal, BOX.topRight, width);
+    const content = `${BOX.vertical}  ${pad(title, width - 3)}${BOX.vertical}`;
+    const bottom = boxLine(BOX.bottomLeft, BOX.horizontal, BOX.bottomRight, width);
+    return `${top}\n${content}\n${bottom}`;
+}
+/**
+ * Build a bar chart string with filled and empty blocks.
+ *
+ * @param fraction - Value between 0 and 1.
+ * @param barWidth - Total number of block characters.
+ */
+function barChart(fraction, barWidth) {
+    const filled = Math.round(fraction * barWidth);
+    const empty = barWidth - filled;
+    return '\u2588'.repeat(filled) + '\u2591'.repeat(empty);
+}
+/**
+ * Format an operation slug for display (e.g., "text_to_video" -> "text_to_video").
+ * Keeps underscores for alignment consistency.
+ */
+function formatOperation(op) {
+    return op;
+}
+/**
+ * Compute per-model success rate. The edge function does not return
+ * per-model success counts, so we approximate using the overall
+ * success rate for display. In a future version the edge function
+ * could be extended to return per-model success/fail counts.
+ *
+ * For now, we compute model-level success from available data.
+ * Since the edge function only provides job_count and credits_used
+ * per model (no per-model fail count), we show "N/A" unless we can
+ * derive it. We'll use the overall success rate as a stand-in.
+ */
+function modelSuccessLabel(_model, overallRate) {
+    return overallRate;
+}
+// ── Table rendering ────────────────────────────────────────────────────────
+/**
+ * Render the "By Model" table section.
+ */
+function renderByModelTable(models, overallRate) {
+    const lines = [];
+    // Column widths: Model(14) | Jobs(6) | Credits(9) | Avg Cost(10) | Success(18)
+    const colModel = 14;
+    const colJobs = 6;
+    const colCredits = 9;
+    const colAvgCost = 10;
+    const colSuccess = 18;
+    const headerLabels = [
+        pad('Model', colModel),
+        pad('Jobs', colJobs),
+        pad('Credits', colCredits),
+        pad('Avg Cost', colAvgCost),
+        pad('Success', colSuccess),
+    ];
+    // Top border with column dividers
+    lines.push(BOX.topLeft +
+        BOX.horizontal.repeat(BOX_WIDTH) +
+        BOX.topRight);
+    // Section title
+    lines.push(`${BOX.vertical}  ${pad('By Model', BOX_WIDTH - 3)}${BOX.vertical}`);
+    // Header separator with column tees
+    const colWidths = [colModel, colJobs, colCredits, colAvgCost, colSuccess];
+    lines.push(BOX.teeRight +
+        colWidths.map((w) => BOX.horizontal.repeat(w)).join(BOX.teeDown) +
+        BOX.teeLeft);
+    // Header row
+    lines.push(`${BOX.vertical}${headerLabels.join(BOX.vertical)}${BOX.vertical}`);
+    // Header/data separator
+    lines.push(BOX.teeRight +
+        colWidths.map((w) => BOX.horizontal.repeat(w)).join(BOX.cross) +
+        BOX.teeLeft);
+    // Data rows
+    for (const model of models) {
+        const avgCost = model.job_count > 0
+            ? (model.credits_used / model.job_count).toFixed(1)
+            : '0.0';
+        const row = [
+            ' ' + pad(model.model_slug, colModel - 1),
+            rpad(formatNumber(model.job_count), colJobs - 1) + ' ',
+            rpad(formatNumber(model.credits_used), colCredits - 1) + ' ',
+            rpad(avgCost, colAvgCost - 1) + ' ',
+            ' ' + pad(modelSuccessLabel(model, overallRate), colSuccess - 1),
+        ];
+        lines.push(`${BOX.vertical}${row.join(BOX.vertical)}${BOX.vertical}`);
+    }
+    // Bottom border
+    lines.push(BOX.bottomLeft +
+        colWidths.map((w) => BOX.horizontal.repeat(w)).join(BOX.teeUp) +
+        BOX.bottomRight);
+    return lines.join('\n');
+}
+/**
+ * Render the "By Operation" table section.
+ */
+function renderByOperationTable(operations, totalCredits) {
+    const lines = [];
+    // For credits per operation, we need credit data. The edge function
+    // returns job_count per operation but not credits_used per operation.
+    // We'll estimate credits proportionally based on job count share
+    // of total credits. The bar chart uses job_count share.
+    const totalJobs = operations.reduce((sum, op) => sum + op.job_count, 0);
+    // Column widths: Type(17) | Jobs(6) | Credits(9) | Share(26)
+    const colType = 17;
+    const colJobs = 6;
+    const colCredits = 9;
+    const colShare = 26;
+    const headerLabels = [
+        pad('Type', colType),
+        pad('Jobs', colJobs),
+        pad('Credits', colCredits),
+        pad('Share', colShare),
+    ];
+    const colWidths = [colType, colJobs, colCredits, colShare];
+    // Top border
+    lines.push(BOX.topLeft +
+        BOX.horizontal.repeat(BOX_WIDTH - 3) +
+        BOX.horizontal.repeat(3) +
+        BOX.topRight);
+    // Section title
+    lines.push(`${BOX.vertical}  ${pad('By Operation', BOX_WIDTH - 3)}${BOX.vertical}`);
+    // Header separator
+    lines.push(BOX.teeRight +
+        colWidths.map((w) => BOX.horizontal.repeat(w)).join(BOX.teeDown) +
+        BOX.teeLeft);
+    // Header row
+    lines.push(`${BOX.vertical}${headerLabels.join(BOX.vertical)}${BOX.vertical}`);
+    // Header/data separator
+    lines.push(BOX.teeRight +
+        colWidths.map((w) => BOX.horizontal.repeat(w)).join(BOX.cross) +
+        BOX.teeLeft);
+    // Data rows
+    for (const op of operations) {
+        const fraction = totalJobs > 0 ? op.job_count / totalJobs : 0;
+        const pct = Math.round(fraction * 100);
+        // Estimate credits proportionally
+        const estCredits = totalJobs > 0
+            ? Math.round((op.job_count / totalJobs) * totalCredits)
+            : 0;
+        const barWidth = 17;
+        const bar = barChart(fraction, barWidth);
+        const shareStr = `${bar}  ${rpad(String(pct), 3)}%`;
+        const row = [
+            ' ' + pad(formatOperation(op.operation), colType - 1),
+            rpad(formatNumber(op.job_count), colJobs - 1) + ' ',
+            rpad(formatNumber(estCredits), colCredits - 1) + ' ',
+            ' ' + pad(shareStr, colShare - 1),
+        ];
+        lines.push(`${BOX.vertical}${row.join(BOX.vertical)}${BOX.vertical}`);
+    }
+    // Bottom border
+    lines.push(BOX.bottomLeft +
+        colWidths.map((w) => BOX.horizontal.repeat(w)).join(BOX.teeUp) +
+        BOX.bottomRight);
+    return lines.join('\n');
+}
+/**
+ * Render the full human-readable usage report.
+ */
+function renderHumanReport(stats) {
+    const periodLabel = stats.period === '7d'
+        ? '7 days'
+        : stats.period === '90d'
+            ? '90 days'
+            : '30 days';
+    console.log();
+    // Title box
+    console.log(boxTitle(`Usage Report (${periodLabel})`, BOX_WIDTH));
+    console.log();
+    // Summary section
+    const totalJobsStr = formatNumber(stats.summary.total_jobs);
+    const creditsStr = formatNumber(stats.summary.credits_used);
+    const rateStr = successRate(stats);
+    const avgStr = avgCostPerJob(stats);
+    console.log(`  Total Jobs:      ${chalk.bold(pad(totalJobsStr, 14))}Success Rate: ${chalk.bold(rateStr)}`);
+    console.log(`  Credits Used:    ${chalk.bold(pad(creditsStr, 14))}Avg Cost/Job: ${chalk.bold(avgStr)}`);
+    // By Model table
+    if (stats.by_model.length > 0) {
+        console.log();
+        console.log(renderByModelTable(stats.by_model, rateStr));
+    }
+    // By Operation table
+    if (stats.by_operation.length > 0) {
+        console.log();
+        console.log(renderByOperationTable(stats.by_operation, stats.summary.credits_used));
+    }
+    console.log();
+}
+// ── Command registration ───────────────────────────────────────────────────
+export function registerUsageCommand(program) {
+    program
+        .command('usage')
+        .description('Show usage analytics and credit consumption')
+        .option('--period <period>', 'Time period: 7d, 30d, or 90d (default: 30d)')
+        .action(async (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.",
+            });
+        }
+        // Validate --period flag
+        const period = (cmdOpts.period ?? '30d');
+        if (!VALID_PERIODS.includes(period)) {
+            throw new CLIError(`Invalid period: ${cmdOpts.period}`, {
+                code: 'INVALID_ARGUMENT',
+                suggestion: `Valid periods: ${VALID_PERIODS.join(', ')}`,
+            });
+        }
+        try {
+            const api = new AgentMediaAPI(apiKey);
+            const spinner = createSpinner('Fetching usage data...');
+            if (mode === 'human')
+                spinner.start();
+            const stats = await api.getUsageStats(period);
+            if (mode === 'human')
+                spinner.stop();
+            switch (mode) {
+                case 'json':
+                    printJson({
+                        period: stats.period,
+                        period_start: stats.period_start,
+                        period_end: stats.period_end,
+                        summary: {
+                            total_jobs: stats.summary.total_jobs,
+                            completed_jobs: stats.summary.completed_jobs,
+                            failed_jobs: stats.summary.failed_jobs,
+                            credits_used: stats.summary.credits_used,
+                            success_rate: stats.summary.total_jobs > 0
+                                ? parseFloat((((stats.summary.total_jobs - stats.summary.failed_jobs) /
+                                    stats.summary.total_jobs) *
+                                    100).toFixed(1))
+                                : 0,
+                            avg_cost_per_job: stats.summary.total_jobs > 0
+                                ? parseFloat((stats.summary.credits_used / stats.summary.total_jobs).toFixed(1))
+                                : 0,
+                        },
+                        by_model: stats.by_model,
+                        by_operation: stats.by_operation,
+                        daily: stats.daily,
+                    });
+                    break;
+                case 'quiet':
+                    printQuiet(`${stats.summary.total_jobs}\t${stats.summary.credits_used}\t${successRate(stats)}`);
+                    break;
+                default:
+                    // Empty state
+                    if (stats.summary.total_jobs === 0) {
+                        console.log();
+                        console.log(chalk.dim(`  No usage data for the past ${period}. Run 'agent-media generate <model>' to get started.`));
+                        console.log();
+                        return;
+                    }
+                    renderHumanReport(stats);
+                    break;
+            }
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+}
+//# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

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

package/dist/commands/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `agent-media version` command.
+ *
+ * Displays the CLI version in human, JSON, or quiet mode.
+ */
+import type { Command } from 'commander';
+export declare function registerVersionCommand(program: Command): void;
+//# sourceMappingURL=version.d.ts.map

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

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

package/dist/commands/version.js

@@ -0,0 +1,26 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+import { createRequire } from 'node:module';
+import { detectOutputMode, printJson, printQuiet } from '../lib/output.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+export function registerVersionCommand(program) {
+    program
+        .command('version')
+        .description('Show CLI version information')
+        .action(() => {
+        const opts = program.opts();
+        const mode = detectOutputMode(opts);
+        switch (mode) {
+            case 'json':
+                printJson({ version: pkg.version });
+                break;
+            case 'quiet':
+                printQuiet(pkg.version);
+                break;
+            default:
+                console.log(`agent-media v${pkg.version}`);
+                break;
+        }
+    });
+}
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAS/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEjE,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAuC,CAAC;QACjE,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEpC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,MAAM;gBACT,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpC,MAAM;YACR,KAAK,OAAO;gBACV,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACxB,MAAM;YACR;gBACE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC3C,MAAM;QACV,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/whoami.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `agent-media whoami` command.
+ *
+ * Shows the authenticated user's identity, subscription plan,
+ * and credit balances. Requires a valid API key.
+ */
+import type { Command } from 'commander';
+export declare function registerWhoAmICommand(program: Command): void;
+//# sourceMappingURL=whoami.d.ts.map

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

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