agent-media-cli 1.0.0

package/dist/lib/config.js

@@ -0,0 +1,91 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * Configuration management for the agent-media CLI.
+ *
+ * Stores config at ~/.agent-media/config.json (or AGENT_MEDIA_CONFIG_DIR).
+ *
+ * Supported keys:
+ * - api_url: Supabase Edge Functions URL
+ * - output_format: default output format (human/json/quiet)
+ * - default_model: default model for generate command
+ * - auto_open_browser: whether to auto-open browser on login (default: true)
+ * - download_dir: default download directory
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export const CONFIG_DIR = process.env['AGENT_MEDIA_CONFIG_DIR'] ?? join(homedir(), '.agent-media');
+export const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+/** All recognized configuration keys. */
+export const VALID_CONFIG_KEYS = [
+    'api_url',
+    'output_format',
+    'default_model',
+    'auto_open_browser',
+    'download_dir',
+];
+/** Default values for configuration keys. */
+export const CONFIG_DEFAULTS = {
+    auto_open_browser: true,
+    output_format: 'human',
+};
+/**
+ * Check whether a string is a valid configuration key.
+ */
+export function isValidConfigKey(key) {
+    return VALID_CONFIG_KEYS.includes(key);
+}
+/**
+ * Ensure the config directory exists.
+ */
+function ensureConfigDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Load the config file. Returns an empty object if it does not exist.
+ */
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    try {
+        const raw = readFileSync(CONFIG_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save the config object to disk.
+ */
+export function saveConfig(config) {
+    ensureConfigDir();
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Get a single config value by key.
+ */
+export function getConfigValue(key) {
+    const config = loadConfig();
+    return config[key];
+}
+/**
+ * Set a single config value and persist to disk.
+ */
+export function setConfigValue(key, value) {
+    const config = loadConfig();
+    config[key] = value;
+    saveConfig(config);
+}
+/**
+ * Reset the config file by removing it entirely, restoring defaults.
+ */
+export function resetConfig() {
+    if (existsSync(CONFIG_FILE)) {
+        unlinkSync(CONFIG_FILE);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAE/D;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AACnG,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAI3D,yCAAyC;AACzC,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS;IACT,eAAe;IACf,eAAe;IACf,mBAAmB;IACnB,cAAc;CACN,CAAC;AAIX,6CAA6C;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAwC;IAClE,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,OAAO;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAS,eAAe;IACtB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,eAAe,EAAE,CAAC;IAClB,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,KAAc;IACxD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACpB,UAAU,CAAC,MAAM,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,UAAU,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/lib/credentials.d.ts

@@ -0,0 +1,60 @@
+export declare const DEFAULT_PROFILE = "default";
+export interface CredentialProfile {
+    apiKey: string;
+    email: string;
+    userId: string;
+    createdAt: string;
+}
+export interface CredentialsStore {
+    currentProfile: string;
+    profiles: Record<string, CredentialProfile>;
+}
+/**
+ * Load the credentials store from disk. Returns an empty store if the
+ * file does not exist or is malformed.
+ */
+export declare function loadCredentials(): CredentialsStore;
+/**
+ * Persist the credentials store to disk.
+ */
+export declare function saveCredentials(store: CredentialsStore): void;
+/**
+ * Get the active profile name, respecting:
+ * 1. Explicit --profile flag
+ * 2. AGENT_MEDIA_PROFILE env var
+ * 3. The currentProfile field in the store
+ */
+export declare function resolveProfileName(flagProfile?: string): string;
+/**
+ * Get the API key for the resolved profile.
+ *
+ * Resolution order:
+ * 1. AGENT_MEDIA_API_KEY env var (bypasses profile system entirely)
+ * 2. Profile-based lookup from credentials.json
+ *
+ * Returns null if no credentials are found.
+ */
+export declare function getApiKey(profileName?: string): string | null;
+/**
+ * Get the full credential profile for a given profile name.
+ */
+export declare function getProfile(profileName?: string): CredentialProfile | null;
+/**
+ * Save credentials for a profile.
+ */
+export declare function saveProfile(profileName: string, profile: CredentialProfile): void;
+/**
+ * Delete a specific profile from the store.
+ * If the deleted profile was the current one, resets to the first
+ * remaining profile or DEFAULT_PROFILE.
+ */
+export declare function deleteProfile(profileName: string): boolean;
+/**
+ * Delete all profiles and remove the credentials file entirely.
+ */
+export declare function clearAllCredentials(): void;
+/**
+ * List all profile names in the store.
+ */
+export declare function listProfiles(): string[];
+//# sourceMappingURL=credentials.d.ts.map

package/dist/lib/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,eAAe,YAAY,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC7C;AAWD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAelD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAM7D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAIzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAQN;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAa1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAGvC"}

package/dist/lib/credentials.js

@@ -0,0 +1,152 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * Credential store for the agent-media CLI.
+ *
+ * Manages API keys and profiles at ~/.agent-media/credentials.json
+ * (or AGENT_MEDIA_CONFIG_DIR). Supports multiple named profiles for
+ * multi-account usage.
+ *
+ * File format:
+ * {
+ *   "currentProfile": "default",
+ *   "profiles": {
+ *     "default": {
+ *       "apiKey": "ma_xxxxx",
+ *       "email": "user@example.com",
+ *       "userId": "uuid",
+ *       "createdAt": "ISO8601"
+ *     }
+ *   }
+ * }
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { CONFIG_DIR } from './config.js';
+const CREDENTIALS_FILE = join(CONFIG_DIR, 'credentials.json');
+export const DEFAULT_PROFILE = 'default';
+/**
+ * Ensure the config directory exists.
+ */
+function ensureDir() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+/**
+ * Load the credentials store from disk. Returns an empty store if the
+ * file does not exist or is malformed.
+ */
+export function loadCredentials() {
+    if (!existsSync(CREDENTIALS_FILE)) {
+        return { currentProfile: DEFAULT_PROFILE, profiles: {} };
+    }
+    try {
+        const raw = readFileSync(CREDENTIALS_FILE, 'utf-8');
+        const data = JSON.parse(raw);
+        // Basic shape validation
+        if (!data.profiles || typeof data.profiles !== 'object') {
+            return { currentProfile: DEFAULT_PROFILE, profiles: {} };
+        }
+        return data;
+    }
+    catch {
+        return { currentProfile: DEFAULT_PROFILE, profiles: {} };
+    }
+}
+/**
+ * Persist the credentials store to disk.
+ */
+export function saveCredentials(store) {
+    ensureDir();
+    writeFileSync(CREDENTIALS_FILE, JSON.stringify(store, null, 2) + '\n', {
+        encoding: 'utf-8',
+        mode: 0o600, // rw------- owner-only
+    });
+}
+/**
+ * Get the active profile name, respecting:
+ * 1. Explicit --profile flag
+ * 2. AGENT_MEDIA_PROFILE env var
+ * 3. The currentProfile field in the store
+ */
+export function resolveProfileName(flagProfile) {
+    if (flagProfile)
+        return flagProfile;
+    const envProfile = process.env['AGENT_MEDIA_PROFILE'];
+    if (envProfile)
+        return envProfile;
+    const store = loadCredentials();
+    return store.currentProfile || DEFAULT_PROFILE;
+}
+/**
+ * Get the API key for the resolved profile.
+ *
+ * Resolution order:
+ * 1. AGENT_MEDIA_API_KEY env var (bypasses profile system entirely)
+ * 2. Profile-based lookup from credentials.json
+ *
+ * Returns null if no credentials are found.
+ */
+export function getApiKey(profileName) {
+    // Env var always wins
+    const envKey = process.env['AGENT_MEDIA_API_KEY'];
+    if (envKey)
+        return envKey;
+    const store = loadCredentials();
+    const name = resolveProfileName(profileName);
+    const profile = store.profiles[name];
+    return profile?.apiKey ?? null;
+}
+/**
+ * Get the full credential profile for a given profile name.
+ */
+export function getProfile(profileName) {
+    const store = loadCredentials();
+    const name = resolveProfileName(profileName);
+    return store.profiles[name] ?? null;
+}
+/**
+ * Save credentials for a profile.
+ */
+export function saveProfile(profileName, profile) {
+    const store = loadCredentials();
+    store.profiles[profileName] = profile;
+    // If this is the first profile, make it the current one
+    if (Object.keys(store.profiles).length === 1) {
+        store.currentProfile = profileName;
+    }
+    saveCredentials(store);
+}
+/**
+ * Delete a specific profile from the store.
+ * If the deleted profile was the current one, resets to the first
+ * remaining profile or DEFAULT_PROFILE.
+ */
+export function deleteProfile(profileName) {
+    const store = loadCredentials();
+    if (!store.profiles[profileName])
+        return false;
+    delete store.profiles[profileName];
+    if (store.currentProfile === profileName) {
+        const remaining = Object.keys(store.profiles);
+        store.currentProfile = remaining[0] ?? DEFAULT_PROFILE;
+    }
+    saveCredentials(store);
+    return true;
+}
+/**
+ * Delete all profiles and remove the credentials file entirely.
+ */
+export function clearAllCredentials() {
+    if (existsSync(CREDENTIALS_FILE)) {
+        unlinkSync(CREDENTIALS_FILE);
+    }
+}
+/**
+ * List all profile names in the store.
+ */
+export function listProfiles() {
+    const store = loadCredentials();
+    return Object.keys(store.profiles);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/lib/credentials.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Structured CLI error with an error code and optional suggestion.
+ */
+export declare class CLIError extends Error {
+    readonly code: string;
+    readonly suggestion?: string;
+    constructor(message: string, options: {
+        code: string;
+        suggestion?: string;
+    });
+}
+/**
+ * Display a user-friendly error message and exit.
+ *
+ * - CLIError: shows code, message, and optional suggestion.
+ * - Generic Error: shows the message with contextual suggestion.
+ * - Unknown: shows a generic message with troubleshooting hint.
+ */
+export declare function handleError(error: unknown): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAM5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CA2BjD"}

package/dist/lib/errors.js

@@ -0,0 +1,77 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * Error handling utilities for the agent-media CLI.
+ */
+import chalk from 'chalk';
+/**
+ * Structured CLI error with an error code and optional suggestion.
+ */
+export class CLIError extends Error {
+    code;
+    suggestion;
+    constructor(message, options) {
+        super(message);
+        this.name = 'CLIError';
+        this.code = options.code;
+        this.suggestion = options.suggestion;
+    }
+}
+/**
+ * Display a user-friendly error message and exit.
+ *
+ * - CLIError: shows code, message, and optional suggestion.
+ * - Generic Error: shows the message with contextual suggestion.
+ * - Unknown: shows a generic message with troubleshooting hint.
+ */
+export function handleError(error) {
+    if (error instanceof CLIError) {
+        console.error(chalk.red(`\u2717 ${error.message}`));
+        if (error.suggestion) {
+            console.error(chalk.yellow(`  \u2192 ${error.suggestion}`));
+        }
+        console.error(chalk.dim(`  Error code: ${error.code}`));
+        process.exit(1);
+    }
+    if (error instanceof Error) {
+        console.error(chalk.red(`\u2717 ${error.message}`));
+        // Provide contextual suggestions for common generic error types
+        const suggestion = inferSuggestion(error);
+        if (suggestion) {
+            console.error(chalk.yellow(`  \u2192 ${suggestion}`));
+        }
+        console.error(chalk.dim(`  Error code: UNEXPECTED_ERROR`));
+        process.exit(1);
+    }
+    console.error(chalk.red('\u2717 An unexpected error occurred.'));
+    console.error(chalk.yellow(`  \u2192 Run 'agent-media doctor' to diagnose common issues.`));
+    console.error(chalk.dim(`  Error code: UNKNOWN_ERROR`));
+    process.exit(1);
+}
+/**
+ * Infer a helpful suggestion from a generic Error based on common patterns.
+ */
+function inferSuggestion(error) {
+    const msg = error.message.toLowerCase();
+    // Network / fetch failures
+    if (msg.includes('fetch') || msg.includes('enotfound') || msg.includes('econnrefused')) {
+        return "Check your internet connection or run 'agent-media doctor' to verify API connectivity.";
+    }
+    // Timeout
+    if (msg.includes('timeout') || msg.includes('aborted') || error.name === 'AbortError') {
+        return 'The request timed out. Check your network or try again later.';
+    }
+    // Permission denied
+    if (msg.includes('eacces') || msg.includes('permission denied')) {
+        return 'Check file permissions. You may need to run with elevated privileges.';
+    }
+    // File system
+    if (msg.includes('enoent') || msg.includes('no such file')) {
+        return 'A required file or directory was not found. Check the path and try again.';
+    }
+    // JSON parse errors
+    if (msg.includes('json') && (msg.includes('parse') || msg.includes('unexpected token'))) {
+        return 'Received an invalid response. The API may be temporarily unavailable.';
+    }
+    return "Run 'agent-media doctor' to diagnose common issues.";
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

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

package/dist/lib/output.d.ts

@@ -0,0 +1,33 @@
+import { type Ora } from 'ora';
+import type { OutputMode } from '../types.js';
+/**
+ * Detect the output mode based on CLI flags.
+ */
+export declare function detectOutputMode(options: {
+    json?: boolean;
+    quiet?: boolean;
+}): OutputMode;
+/**
+ * Print a formatted table to stdout.
+ *
+ * In human mode, renders an aligned ASCII table with header.
+ * In JSON mode, outputs the rows as an array of objects keyed by headers.
+ * In quiet mode, outputs each row's first column value, one per line.
+ */
+export declare function printTable(headers: string[], rows: string[][], options?: {
+    json?: boolean;
+    quiet?: boolean;
+}): void;
+/**
+ * Print data as formatted JSON to stdout.
+ */
+export declare function printJson(data: unknown): void;
+/**
+ * Print minimal output for piping / scripting.
+ */
+export declare function printQuiet(value: string | string[]): void;
+/**
+ * Create an ora spinner instance.
+ */
+export declare function createSpinner(text: string): Ora;
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAOA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,UAAU,CAIzF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5C,IAAI,CAmCN;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAQzD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C"}

package/dist/lib/output.js

@@ -0,0 +1,77 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+/**
+ * Output formatting utilities for human, JSON, and quiet modes.
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+/**
+ * Detect the output mode based on CLI flags.
+ */
+export function detectOutputMode(options) {
+    if (options.json)
+        return 'json';
+    if (options.quiet)
+        return 'quiet';
+    return 'human';
+}
+/**
+ * Print a formatted table to stdout.
+ *
+ * In human mode, renders an aligned ASCII table with header.
+ * In JSON mode, outputs the rows as an array of objects keyed by headers.
+ * In quiet mode, outputs each row's first column value, one per line.
+ */
+export function printTable(headers, rows, options) {
+    const mode = detectOutputMode(options ?? {});
+    if (mode === 'json') {
+        const data = rows.map((row) => {
+            const obj = {};
+            headers.forEach((header, i) => {
+                obj[header.toLowerCase().replace(/\s+/g, '_')] = row[i] ?? '';
+            });
+            return obj;
+        });
+        printJson(data);
+        return;
+    }
+    if (mode === 'quiet') {
+        printQuiet(rows.map((row) => row[0] ?? ''));
+        return;
+    }
+    // Human mode: calculate column widths and render aligned table
+    const colWidths = headers.map((header, i) => Math.max(header.length, ...rows.map((row) => (row[i] ?? '').length)));
+    const headerLine = headers.map((h, i) => h.padEnd(colWidths[i])).join('  ');
+    const separator = colWidths.map((w) => '─'.repeat(w)).join('──');
+    console.log(chalk.bold(headerLine));
+    console.log(chalk.dim(separator));
+    for (const row of rows) {
+        const line = row.map((cell, i) => cell.padEnd(colWidths[i])).join('  ');
+        console.log(line);
+    }
+}
+/**
+ * Print data as formatted JSON to stdout.
+ */
+export function printJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+/**
+ * Print minimal output for piping / scripting.
+ */
+export function printQuiet(value) {
+    if (Array.isArray(value)) {
+        for (const v of value) {
+            console.log(v);
+        }
+    }
+    else {
+        console.log(value);
+    }
+}
+/**
+ * Create an ora spinner instance.
+ */
+export function createSpinner(text) {
+    return ora({ text, spinner: 'dots' });
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI-specific type definitions.
+ */
+export interface GlobalOptions {
+    json?: boolean;
+    quiet?: boolean;
+    noColor?: boolean;
+    verbose?: boolean;
+    profile?: string;
+}
+export type OutputMode = 'human' | 'json' | 'quiet';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Copyright 2026 agent-media contributors. Apache-2.0 license.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "agent-media-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "private": false,
+  "license": "Apache-2.0",
+  "description": "Open-source CLI for unified AI video and image generation",
+  "homepage": "https://agent-media.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yuvalsuede/agent-media.git"
+  },
+  "keywords": [
+    "ai",
+    "video",
+    "image",
+    "generation",
+    "cli",
+    "terminal",
+    "media"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "agent-media": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "open": "^10.1.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "typescript": "^5.7.3"
+  }
+}