@a5c-ai/agent-mux-cli 0.2.0

package/dist/exit-codes.js

@@ -0,0 +1,68 @@
+/**
+ * Exit code constants and ErrorCode-to-exit-code mapping.
+ *
+ * @see docs/10-cli-reference.md Section 4
+ */
+/** CLI exit code constants. */
+export const ExitCode = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    USAGE_ERROR: 2,
+    AGENT_NOT_FOUND: 3,
+    AGENT_NOT_INSTALLED: 4,
+    AUTH_ERROR: 5,
+    CAPABILITY_ERROR: 6,
+    CONFIG_ERROR: 7,
+    SESSION_NOT_FOUND: 8,
+    PROFILE_NOT_FOUND: 9,
+    PLUGIN_ERROR: 10,
+    TIMEOUT: 11,
+    AGENT_CRASHED: 12,
+    ABORTED: 13,
+    RATE_LIMITED: 14,
+    CONTEXT_EXCEEDED: 15,
+};
+/**
+ * Map an ErrorCode to an exit code.
+ *
+ * @see docs/10-cli-reference.md Section 4.1
+ */
+export function errorCodeToExitCode(code) {
+    switch (code) {
+        case 'VALIDATION_ERROR':
+            return ExitCode.USAGE_ERROR;
+        case 'AGENT_NOT_FOUND':
+        case 'UNKNOWN_AGENT':
+            return ExitCode.AGENT_NOT_FOUND;
+        case 'AGENT_NOT_INSTALLED':
+            return ExitCode.AGENT_NOT_INSTALLED;
+        case 'AUTH_ERROR':
+            return ExitCode.AUTH_ERROR;
+        case 'CAPABILITY_ERROR':
+            return ExitCode.CAPABILITY_ERROR;
+        case 'CONFIG_ERROR':
+        case 'CONFIG_LOCK_ERROR':
+            return ExitCode.CONFIG_ERROR;
+        case 'SESSION_NOT_FOUND':
+            return ExitCode.SESSION_NOT_FOUND;
+        case 'PROFILE_NOT_FOUND':
+            return ExitCode.PROFILE_NOT_FOUND;
+        case 'PLUGIN_ERROR':
+            return ExitCode.PLUGIN_ERROR;
+        case 'TIMEOUT':
+        case 'INACTIVITY_TIMEOUT':
+            return ExitCode.TIMEOUT;
+        case 'AGENT_CRASH':
+            return ExitCode.AGENT_CRASHED;
+        case 'ABORTED':
+            return ExitCode.ABORTED;
+        case 'RATE_LIMITED':
+            return ExitCode.RATE_LIMITED;
+        case 'CONTEXT_EXCEEDED':
+            return ExitCode.CONTEXT_EXCEEDED;
+        // General error: SPAWN_ERROR, INTERNAL, PARSE_ERROR, and everything else
+        default:
+            return ExitCode.GENERAL_ERROR;
+    }
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,+BAA+B;AAC/B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,CAAC;IAClB,mBAAmB,EAAE,CAAC;IACtB,UAAU,EAAE,CAAC;IACb,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,CAAC;IACpB,iBAAiB,EAAE,CAAC;IACpB,YAAY,EAAE,EAAE;IAChB,OAAO,EAAE,EAAE;IACX,aAAa,EAAE,EAAE;IACjB,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;IAChB,gBAAgB,EAAE,EAAE;CACZ,CAAC;AAIX;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,kBAAkB;YACrB,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,qBAAqB;YACxB,OAAO,QAAQ,CAAC,mBAAmB,CAAC;QACtC,KAAK,YAAY;YACf,OAAO,QAAQ,CAAC,UAAU,CAAC;QAC7B,KAAK,kBAAkB;YACrB,OAAO,QAAQ,CAAC,gBAAgB,CAAC;QACnC,KAAK,cAAc,CAAC;QACpB,KAAK,mBAAmB;YACtB,OAAO,QAAQ,CAAC,YAAY,CAAC;QAC/B,KAAK,mBAAmB;YACtB,OAAO,QAAQ,CAAC,iBAAiB,CAAC;QACpC,KAAK,mBAAmB;YACtB,OAAO,QAAQ,CAAC,iBAAiB,CAAC;QACpC,KAAK,cAAc;YACjB,OAAO,QAAQ,CAAC,YAAY,CAAC;QAC/B,KAAK,SAAS,CAAC;QACf,KAAK,oBAAoB;YACvB,OAAO,QAAQ,CAAC,OAAO,CAAC;QAC1B,KAAK,aAAa;YAChB,OAAO,QAAQ,CAAC,aAAa,CAAC;QAChC,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC,OAAO,CAAC;QAC1B,KAAK,cAAc;YACjB,OAAO,QAAQ,CAAC,YAAY,CAAC;QAC/B,KAAK,kBAAkB;YACrB,OAAO,QAAQ,CAAC,gBAAgB,CAAC;QACnC,yEAAyE;QACzE;YACE,OAAO,QAAQ,CAAC,aAAa,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * @a5c-ai/agent-mux-cli
+ *
+ * CLI binary entry point for the `amux` command.
+ *
+ * Parses arguments, creates a client, and dispatches to the appropriate
+ * command handler. Exports core functionality for programmatic use.
+ */
+export { createClient } from '@a5c-ai/agent-mux-core';
+export { ExitCode, errorCodeToExitCode } from './exit-codes.js';
+export { parseArgs } from './parse-args.js';
+export { registerBuiltInAdapters } from './bootstrap.js';
+export type { ParsedArgs, FlagDef } from './parse-args.js';
+export { main as runCli };
+/**
+ * Main CLI entry point.
+ *
+ * @param argv - Command-line arguments (defaults to process.argv.slice(2))
+ * @returns Exit code
+ */
+export declare function main(argv?: string[]): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,CAAC;AAyB1B;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgJ3D"}

package/dist/index.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+/**
+ * @a5c-ai/agent-mux-cli
+ *
+ * CLI binary entry point for the `amux` command.
+ *
+ * Parses arguments, creates a client, and dispatches to the appropriate
+ * command handler. Exports core functionality for programmatic use.
+ */
+export { createClient } from '@a5c-ai/agent-mux-core';
+export { ExitCode, errorCodeToExitCode } from './exit-codes.js';
+export { parseArgs } from './parse-args.js';
+export { registerBuiltInAdapters } from './bootstrap.js';
+// Re-exported so the meta-package shim (`@a5c-ai/agent-mux`) can drive the CLI.
+export { main as runCli };
+import { createClient, AgentMuxError } from '@a5c-ai/agent-mux-core';
+import { parseArgs } from './parse-args.js';
+import { flagBool, flagStr } from './parse-args.js';
+import { RUN_FLAGS } from './commands/run.js';
+import { INSTALL_FLAGS } from './commands/install.js';
+import { ExitCode, errorCodeToExitCode } from './exit-codes.js';
+import { setColorEnabled, printError, printJsonError } from './output.js';
+import { printHelp, printVersion } from './commands/help.js';
+import { runCommand } from './commands/run.js';
+import { adaptersCommand } from './commands/adapters.js';
+import { sessionsCommand } from './commands/sessions.js';
+import { configCommand } from './commands/config.js';
+import { authCommand } from './commands/auth.js';
+import { modelsCommand } from './commands/models.js';
+import { profilesCommand } from './commands/profiles.js';
+import { pluginsCommand } from './commands/plugins.js';
+import { installCommand } from './commands/install.js';
+import { detectHostCommand } from './commands/detect-host.js';
+import { remoteCommand, REMOTE_FLAGS } from './commands/remote.js';
+import { hooksCommand, HOOKS_FLAGS } from './commands/hooks.js';
+import { doctorCommand } from './commands/doctor.js';
+import { registerBuiltInAdapters } from './bootstrap.js';
+/**
+ * Main CLI entry point.
+ *
+ * @param argv - Command-line arguments (defaults to process.argv.slice(2))
+ * @returns Exit code
+ */
+export async function main(argv) {
+    const rawArgs = argv ?? process.argv.slice(2);
+    // First pass: parse with all known flags to capture global flags
+    const args = parseArgs(rawArgs, { ...RUN_FLAGS, ...INSTALL_FLAGS, ...REMOTE_FLAGS, ...HOOKS_FLAGS });
+    // Handle --no-color
+    if (flagBool(args.flags, 'no-color') === true) {
+        setColorEnabled(false);
+    }
+    // Handle --version / -V
+    if (flagBool(args.flags, 'version') === true) {
+        printVersion();
+        return ExitCode.SUCCESS;
+    }
+    // Handle `amux version` command
+    if (args.command === 'version') {
+        printVersion();
+        return ExitCode.SUCCESS;
+    }
+    // Handle --help / -h
+    if (flagBool(args.flags, 'help') === true) {
+        printHelp(args.command);
+        return ExitCode.SUCCESS;
+    }
+    // Handle `amux help [command]`
+    if (args.command === 'help') {
+        printHelp(args.positionals[0] ?? args.subcommand);
+        return ExitCode.SUCCESS;
+    }
+    // No command — print help. But if there are stray positionals, treat
+    // the first as an unknown command so users get actionable feedback
+    // instead of silently seeing the help text with a success exit code.
+    if (!args.command) {
+        if (args.positionals.length > 0) {
+            const unknown = args.positionals[0];
+            const jsonModeEarly = flagBool(args.flags, 'json') === true;
+            if (jsonModeEarly) {
+                printJsonError('VALIDATION_ERROR', `Unknown command: ${unknown}`);
+            }
+            else {
+                printError(`Unknown command: ${unknown}. Run "amux help" for usage.`);
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        printHelp();
+        return ExitCode.SUCCESS;
+    }
+    // Create client with global flag overrides
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    try {
+        const clientOpts = {};
+        const configDir = flagStr(args.flags, 'config-dir');
+        const projectDir = flagStr(args.flags, 'project-dir');
+        const debug = flagBool(args.flags, 'debug');
+        const agent = flagStr(args.flags, 'agent');
+        const model = flagStr(args.flags, 'model');
+        if (configDir)
+            clientOpts['configDir'] = configDir;
+        if (projectDir)
+            clientOpts['projectConfigDir'] = projectDir;
+        if (debug)
+            clientOpts['debug'] = true;
+        if (agent)
+            clientOpts['defaultAgent'] = agent;
+        if (model)
+            clientOpts['defaultModel'] = model;
+        const client = createClient(clientOpts);
+        registerBuiltInAdapters(client);
+        // Dispatch to command handler
+        switch (args.command) {
+            case 'run':
+                return await runCommand(client, args);
+            case 'adapters':
+                return await adaptersCommand(client, args);
+            case 'sessions':
+                return await sessionsCommand(client, args);
+            case 'config':
+                return await configCommand(client, args);
+            case 'auth':
+                return await authCommand(client, args);
+            case 'models':
+                return await modelsCommand(client, args);
+            case 'profiles':
+                return await profilesCommand(client, args);
+            case 'plugins':
+                return await pluginsCommand(client, args);
+            case 'install':
+            case 'uninstall':
+            case 'update':
+            case 'detect':
+                return await installCommand(client, args);
+            case 'detect-host':
+                return await detectHostCommand(client, args);
+            case 'remote':
+                return await remoteCommand(client, args);
+            case 'hooks':
+                return await hooksCommand(client, args);
+            case 'doctor':
+                return await doctorCommand(client, args);
+            default:
+                if (jsonMode) {
+                    printJsonError('VALIDATION_ERROR', `Unknown command: ${args.command}`);
+                }
+                else {
+                    printError(`Unknown command: ${args.command}. Run "amux help" for usage.`);
+                }
+                return ExitCode.USAGE_ERROR;
+        }
+    }
+    catch (err) {
+        if (err instanceof AgentMuxError) {
+            if (jsonMode) {
+                printJsonError(err.code, err.message, err.recoverable);
+            }
+            else {
+                printError(err.message);
+            }
+            return errorCodeToExitCode(err.code);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        if (jsonMode) {
+            printJsonError('INTERNAL', message);
+        }
+        else {
+            printError(message);
+        }
+        return ExitCode.GENERAL_ERROR;
+    }
+}
+// Run when executed directly (not imported)
+// We detect this by checking if this file is the entry point
+const isDirectRun = typeof process !== 'undefined' &&
+    process.argv[1] &&
+    (process.argv[1].endsWith('/index.js') ||
+        process.argv[1].endsWith('\\index.js') ||
+        process.argv[1].endsWith('/amux') ||
+        process.argv[1].endsWith('\\amux'));
+if (isDirectRun) {
+    main().then((code) => {
+        process.exitCode = code;
+    }).catch((err) => {
+        process.stderr.write(`Fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Output formatting utilities for the amux CLI.
+ *
+ * Supports human-readable tables/text and JSON output modes.
+ * Color is supported via ANSI codes, gated by --no-color / NO_COLOR / TTY detection.
+ */
+export declare function setColorEnabled(enabled: boolean): void;
+export declare const color: {
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    red: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    cyan: (text: string) => string;
+};
+/**
+ * Print a table in human-readable format.
+ */
+export declare function printTable(headers: string[], rows: string[][]): void;
+/**
+ * Print key-value pairs in human-readable format.
+ */
+export declare function printKeyValue(pairs: [string, string][]): void;
+/**
+ * Convert a typed object (possibly with a sealed index signature) into a plain
+ * `Record<string, unknown>` suitable for serialization / column-extraction
+ * helpers. Uses JSON round-trip so it drops undefined and functions and loses
+ * prototype — appropriate for the CLI's read-only render paths.
+ */
+export declare function toPlain<T>(value: T): Record<string, unknown>;
+export declare function toPlainArray<T>(values: readonly T[]): Record<string, unknown>[];
+/**
+ * Print JSON output.
+ */
+export declare function printJson(data: unknown): void;
+/**
+ * Print a JSON-wrapped success response.
+ */
+export declare function printJsonOk(data: unknown): void;
+/**
+ * Print a JSON-wrapped error response.
+ */
+export declare function printJsonError(code: string, message: string, recoverable?: boolean): void;
+/**
+ * Print an error message to stderr.
+ */
+export declare function printError(message: string): void;
+/**
+ * Print a warning message to stderr.
+ */
+export declare function printWarning(message: string): void;
+/**
+ * Print an info message to stderr.
+ */
+export declare function printInfo(message: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAsBD,eAAO,MAAM,KAAK;iBACH,MAAM;gBACP,MAAM;gBACN,MAAM;kBACJ,MAAM;mBACL,MAAM;iBACR,MAAM;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CA6BpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI,CAU7D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE5D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAE/E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,IAAI,CAEhG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C"}

package/dist/output.js

@@ -0,0 +1,129 @@
+/**
+ * Output formatting utilities for the amux CLI.
+ *
+ * Supports human-readable tables/text and JSON output modes.
+ * Color is supported via ANSI codes, gated by --no-color / NO_COLOR / TTY detection.
+ */
+/** Whether color output is enabled. */
+let colorEnabled;
+export function setColorEnabled(enabled) {
+    colorEnabled = enabled;
+}
+function isColorEnabled() {
+    if (colorEnabled !== undefined)
+        return colorEnabled;
+    if (process.env['NO_COLOR'])
+        return false;
+    if (!process.stdout.isTTY)
+        return false;
+    return true;
+}
+// ANSI codes
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RED = '\x1b[31m';
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+function c(code, text) {
+    return isColorEnabled() ? `${code}${text}${RESET}` : text;
+}
+export const color = {
+    bold: (text) => c(BOLD, text),
+    dim: (text) => c(DIM, text),
+    red: (text) => c(RED, text),
+    green: (text) => c(GREEN, text),
+    yellow: (text) => c(YELLOW, text),
+    cyan: (text) => c(CYAN, text),
+};
+/**
+ * Print a table in human-readable format.
+ */
+export function printTable(headers, rows) {
+    if (rows.length === 0) {
+        process.stdout.write('(no results)\n');
+        return;
+    }
+    // Calculate column widths
+    const widths = headers.map((h, i) => {
+        let max = h.length;
+        for (const row of rows) {
+            const cell = row[i] ?? '';
+            if (cell.length > max)
+                max = cell.length;
+        }
+        return max;
+    });
+    // Print header
+    const headerLine = headers.map((h, i) => h.padEnd(widths[i])).join('  ');
+    process.stdout.write(c(BOLD, headerLine) + '\n');
+    // Print separator
+    const sep = widths.map((w) => '-'.repeat(w)).join('  ');
+    process.stdout.write(c(DIM, sep) + '\n');
+    // Print rows
+    for (const row of rows) {
+        const line = row.map((cell, i) => (cell ?? '').padEnd(widths[i])).join('  ');
+        process.stdout.write(line + '\n');
+    }
+}
+/**
+ * Print key-value pairs in human-readable format.
+ */
+export function printKeyValue(pairs) {
+    if (pairs.length === 0)
+        return;
+    const maxKeyLen = Math.max(...pairs.map(([k]) => k.length));
+    for (const [key, value] of pairs) {
+        process.stdout.write(`${c(BOLD, key.padEnd(maxKeyLen))}  ${value}\n`);
+    }
+}
+/**
+ * Convert a typed object (possibly with a sealed index signature) into a plain
+ * `Record<string, unknown>` suitable for serialization / column-extraction
+ * helpers. Uses JSON round-trip so it drops undefined and functions and loses
+ * prototype — appropriate for the CLI's read-only render paths.
+ */
+export function toPlain(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export function toPlainArray(values) {
+    return values.map((v) => toPlain(v));
+}
+/**
+ * Print JSON output.
+ */
+export function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}
+/**
+ * Print a JSON-wrapped success response.
+ */
+export function printJsonOk(data) {
+    printJson({ ok: true, data });
+}
+/**
+ * Print a JSON-wrapped error response.
+ */
+export function printJsonError(code, message, recoverable = false) {
+    printJson({ ok: false, error: { code, message, recoverable } });
+}
+/**
+ * Print an error message to stderr.
+ */
+export function printError(message) {
+    process.stderr.write(c(RED, 'Error: ') + message + '\n');
+}
+/**
+ * Print a warning message to stderr.
+ */
+export function printWarning(message) {
+    process.stderr.write(c(YELLOW, 'Warning: ') + message + '\n');
+}
+/**
+ * Print an info message to stderr.
+ */
+export function printInfo(message) {
+    process.stderr.write(c(CYAN, 'Info: ') + message + '\n');
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/parse-args.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Lightweight argument parser for the amux CLI.
+ *
+ * Zero external dependencies. Handles:
+ * - Long flags (--flag, --flag=value, --no-flag for booleans)
+ * - Short flags (-a, -a value, combined -abc)
+ * - Positional arguments
+ * - -- terminator
+ * - Repeatable flags (--tag x --tag y)
+ */
+/** Parsed CLI arguments. */
+export interface ParsedArgs {
+    /** The command (e.g., 'run', 'adapters'). */
+    command: string | undefined;
+    /** The subcommand (e.g., 'list', 'show'). */
+    subcommand: string | undefined;
+    /** Remaining positional arguments after command/subcommand. */
+    positionals: string[];
+    /** Named flags. Boolean flags are true/false. String/number flags are strings. */
+    flags: Record<string, string | boolean | string[]>;
+}
+/** Known flag definition for the parser. */
+export interface FlagDef {
+    /** Short alias (single character). */
+    short?: string;
+    /** Flag type. */
+    type: 'boolean' | 'string' | 'number';
+    /** Whether the flag can be specified multiple times. */
+    repeatable?: boolean;
+}
+/**
+ * Global flags recognized by all commands.
+ */
+export declare const GLOBAL_FLAGS: Record<string, FlagDef>;
+/**
+ * Parse argv into structured args.
+ *
+ * @param argv - Arguments (typically process.argv.slice(2))
+ * @param extraFlags - Additional command-specific flag definitions
+ */
+export declare function parseArgs(argv: string[], extraFlags?: Record<string, FlagDef>): ParsedArgs;
+/**
+ * Get a flag value as a string, or undefined.
+ */
+export declare function flagStr(flags: Record<string, string | boolean | string[]>, name: string): string | undefined;
+/**
+ * Get a flag value as a number, or undefined.
+ */
+export declare function flagNum(flags: Record<string, string | boolean | string[]>, name: string): number | undefined;
+/**
+ * Get a flag value as a boolean.
+ */
+export declare function flagBool(flags: Record<string, string | boolean | string[]>, name: string): boolean | undefined;
+/**
+ * Get a flag value as a string array (for repeatable flags).
+ */
+export declare function flagArr(flags: Record<string, string | boolean | string[]>, name: string): string[];
+//# sourceMappingURL=parse-args.d.ts.map

package/dist/parse-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.d.ts","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;CACpD;AAED,4CAA4C;AAC5C,MAAM,WAAW,OAAO;IACtB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iBAAiB;IACjB,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAEtC,wDAAwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAWhD,CAAC;AAiBF;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,UAAU,CAoLZ;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK5G;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5G;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAM9G;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlG"}