@a5c-ai/adapters-cli 5.1.1-staging.52898ebfc24f

package/dist/commands/workspaces.js

@@ -0,0 +1,187 @@
+import { WorkspaceService } from '@a5c-ai/comm-adapter';
+import { flagArr, flagBool, flagStr } from '../parse-args.js';
+import { ExitCode } from '../exit-codes.js';
+import { printError, printJsonError, printJsonOk, printTable } from '../output.js';
+export const WORKSPACE_FLAGS = {
+    repo: { type: 'string', repeatable: true },
+    mode: { type: 'string' },
+    name: { type: 'string' },
+    branch: { type: 'string' },
+    root: { type: 'string' },
+    force: { type: 'boolean' },
+};
+function jsonMode(args) {
+    return flagBool(args.flags, 'json') === true;
+}
+function toSessionBindings(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.flatMap((entry) => {
+        if (!entry || typeof entry !== 'object') {
+            return [];
+        }
+        const session = entry;
+        if (typeof session.agent !== 'string' || typeof session.sessionId !== 'string') {
+            return [];
+        }
+        return [{
+                agent: session.agent,
+                sessionId: session.sessionId,
+                status: session.status === 'running' ? 'running' : 'stopped',
+                cwd: typeof session.cwd === 'string' ? session.cwd : undefined,
+                title: typeof session.title === 'string' ? session.title : undefined,
+                updatedAt: typeof session.updatedAt === 'string' ? session.updatedAt : new Date().toISOString(),
+                activeRunId: typeof session.activeRunId === 'string' ? session.activeRunId : null,
+                latestRunId: typeof session.latestRunId === 'string' ? session.latestRunId : null,
+            }];
+    });
+}
+export async function workspacesCommand(_client, args) {
+    const json = jsonMode(args);
+    const service = new WorkspaceService();
+    const sub = args.subcommand ?? 'list';
+    try {
+        switch (sub) {
+            case 'list': {
+                const payload = await service.listWorkspaces();
+                if (json) {
+                    printJsonOk(payload);
+                    return ExitCode.SUCCESS;
+                }
+                printTable(['ID', 'Name', 'Status', 'Mode', 'CWD', 'Root'], payload.workspaces.map((workspace) => [
+                    workspace.id,
+                    workspace.name,
+                    workspace.status,
+                    workspace.mode,
+                    workspace.defaultCwd,
+                    workspace.rootPath,
+                ]));
+                return ExitCode.SUCCESS;
+            }
+            case 'create': {
+                const name = args.positionals[0] ?? flagStr(args.flags, 'name');
+                const repos = flagArr(args.flags, 'repo');
+                if (!name) {
+                    if (json)
+                        printJsonError('VALIDATION_ERROR', 'Usage: adapters workspaces create <name> --repo <path> [--repo <path>...]');
+                    else
+                        printError('Usage: adapters workspaces create <name> --repo <path> [--repo <path>...]');
+                    return ExitCode.USAGE_ERROR;
+                }
+                if (repos.length === 0) {
+                    if (json)
+                        printJsonError('VALIDATION_ERROR', 'At least one --repo path is required.');
+                    else
+                        printError('At least one --repo path is required.');
+                    return ExitCode.USAGE_ERROR;
+                }
+                const created = await service.createWorkspace({
+                    name,
+                    repos: repos.map((repo) => ({ path: repo })),
+                    mode: flagStr(args.flags, 'mode') === 'symlink' ? 'symlink' : 'worktree',
+                    branchName: flagStr(args.flags, 'branch') ?? undefined,
+                    rootDir: flagStr(args.flags, 'root') ?? undefined,
+                });
+                if (json) {
+                    printJsonOk(created);
+                }
+                else {
+                    process.stdout.write(`${created.id}\t${created.rootPath}\n`);
+                }
+                return ExitCode.SUCCESS;
+            }
+            case 'archive': {
+                const identifier = args.positionals[0];
+                if (!identifier) {
+                    if (json)
+                        printJsonError('VALIDATION_ERROR', 'Usage: adapters workspaces archive <workspace>');
+                    else
+                        printError('Usage: adapters workspaces archive <workspace>');
+                    return ExitCode.USAGE_ERROR;
+                }
+                const archived = await service.archiveWorkspace(identifier);
+                if (json)
+                    printJsonOk(archived);
+                else
+                    process.stdout.write(`Archived ${archived.id}\n`);
+                return ExitCode.SUCCESS;
+            }
+            case 'cleanup': {
+                const identifier = args.positionals[0];
+                if (!identifier) {
+                    if (json)
+                        printJsonError('VALIDATION_ERROR', 'Usage: adapters workspaces cleanup <workspace>');
+                    else
+                        printError('Usage: adapters workspaces cleanup <workspace>');
+                    return ExitCode.USAGE_ERROR;
+                }
+                const cleaned = await service.cleanupWorkspace(identifier);
+                if (json)
+                    printJsonOk(cleaned);
+                else
+                    process.stdout.write(`Cleaned ${cleaned.id}\n`);
+                return ExitCode.SUCCESS;
+            }
+            case 'recover': {
+                const identifier = args.positionals[0];
+                if (!identifier) {
+                    if (json)
+                        printJsonError('VALIDATION_ERROR', 'Usage: adapters workspaces recover <workspace>');
+                    else
+                        printError('Usage: adapters workspaces recover <workspace>');
+                    return ExitCode.USAGE_ERROR;
+                }
+                const recovered = await service.recoverWorkspace(identifier);
+                if (json)
+                    printJsonOk(recovered);
+                else
+                    process.stdout.write(`Recovered ${recovered.id}\n`);
+                return ExitCode.SUCCESS;
+            }
+            case 'delete': {
+                const identifier = args.positionals[0];
+                if (!identifier) {
+                    if (json)
+                        printJsonError('VALIDATION_ERROR', 'Usage: adapters workspaces delete <workspace> [--force]');
+                    else
+                        printError('Usage: adapters workspaces delete <workspace> [--force]');
+                    return ExitCode.USAGE_ERROR;
+                }
+                await service.deleteWorkspace(identifier, { forceCleanup: flagBool(args.flags, 'force') === true });
+                if (json)
+                    printJsonOk({ deleted: identifier });
+                else
+                    process.stdout.write(`Deleted ${identifier}\n`);
+                return ExitCode.SUCCESS;
+            }
+            case 'sync-sessions': {
+                const body = toSessionBindings(args.positionals[0] ? JSON.parse(args.positionals[0]) : []);
+                await service.reconcileSessions(body);
+                const payload = await service.listWorkspaces();
+                if (json)
+                    printJsonOk(payload);
+                else
+                    process.stdout.write(`Synced ${body.length} sessions\n`);
+                return ExitCode.SUCCESS;
+            }
+            default:
+                if (json)
+                    printJsonError('VALIDATION_ERROR', `Unknown workspaces subcommand: ${sub}`);
+                else
+                    printError(`Unknown workspaces subcommand: ${sub}`);
+                return ExitCode.USAGE_ERROR;
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (json) {
+            printJsonError('INTERNAL', message);
+        }
+        else {
+            printError(message);
+        }
+        return ExitCode.GENERAL_ERROR;
+    }
+}
+//# sourceMappingURL=workspaces.js.map

package/dist/commands/workspaces.js.map

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

package/dist/exit-codes.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Exit code constants and ErrorCode-to-exit-code mapping.
+ *
+ * @see docs/10-cli-reference.md Section 4
+ */
+import type { ErrorCode } from '@a5c-ai/comm-adapter';
+/** CLI exit code constants. */
+export declare const ExitCode: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly USAGE_ERROR: 2;
+    readonly AGENT_NOT_FOUND: 3;
+    readonly AGENT_NOT_INSTALLED: 4;
+    readonly AUTH_ERROR: 5;
+    readonly CAPABILITY_ERROR: 6;
+    readonly CONFIG_ERROR: 7;
+    readonly SESSION_NOT_FOUND: 8;
+    readonly PROFILE_NOT_FOUND: 9;
+    readonly PLUGIN_ERROR: 10;
+    readonly TIMEOUT: 11;
+    readonly AGENT_CRASHED: 12;
+    readonly ABORTED: 13;
+    readonly RATE_LIMITED: 14;
+    readonly CONTEXT_EXCEEDED: 15;
+};
+export type ExitCodeValue = (typeof ExitCode)[keyof typeof ExitCode];
+/**
+ * Map an ErrorCode to an exit code.
+ *
+ * @see docs/10-cli-reference.md Section 4.1
+ */
+export declare function errorCodeToExitCode(code: ErrorCode): ExitCodeValue;

package/dist/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,+BAA+B;AAC/B,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;CAiBX,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAqClE"}

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/adapters-cli
+ *
+ * CLI binary entry point for the `adapters` command.
+ *
+ * Parses arguments, creates a client, and dispatches to the appropriate
+ * command handler. Exports core functionality for programmatic use.
+ */
+export { createClient } from '@a5c-ai/comm-adapter';
+export { ExitCode, errorCodeToExitCode } from './exit-codes.js';
+export { parseArgs } from './parse-args.js';
+export { registerBuiltInAdapters } from './bootstrap.js';
+export { resolveCliLoggerConfig, type CliLoggerConfig } from './loggingConfig.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>;

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,sBAAsB,CAAC;AACpD,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,OAAO,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,CAAC;AAkC1B;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0K3D"}

package/dist/index.js

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+/**
+ * @a5c-ai/adapters-cli
+ *
+ * CLI binary entry point for the `adapters` command.
+ *
+ * Parses arguments, creates a client, and dispatches to the appropriate
+ * command handler. Exports core functionality for programmatic use.
+ */
+export { createClient } from '@a5c-ai/comm-adapter';
+export { ExitCode, errorCodeToExitCode } from './exit-codes.js';
+export { parseArgs } from './parse-args.js';
+export { registerBuiltInAdapters } from './bootstrap.js';
+export { resolveCliLoggerConfig } from './loggingConfig.js';
+// Re-exported so the meta-package shim (`@a5c-ai/adapters`) can drive the CLI.
+export { main as runCli };
+import { createClient, AgentMuxError } from '@a5c-ai/comm-adapter';
+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 { pluginCommand } from './commands/plugin.js';
+import { mcpCommand } from './commands/mcp.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 { tuiCommand } from './commands/tui.js';
+import { skillCommand, SKILL_FLAGS } from './commands/skill.js';
+import { agentCommand, AGENT_FLAGS } from './commands/agent.js';
+import { gatewayCommand, GATEWAY_FLAGS } from './commands/gateway/index.js';
+import { launchCommand, LAUNCH_FLAGS } from './commands/launch.js';
+import { workspacesCommand, WORKSPACE_FLAGS } from './commands/workspaces.js';
+import { registerBuiltInAdapters } from './bootstrap.js';
+import { reconfigureLogger } from '@a5c-ai/adapters-observability';
+import { resolveCliLoggerConfig } from './loggingConfig.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, ...SKILL_FLAGS, ...AGENT_FLAGS, ...GATEWAY_FLAGS, ...LAUNCH_FLAGS, ...WORKSPACE_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 `adapters 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 `adapters 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 "adapters 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');
+        const logLevel = flagStr(args.flags, 'log-level');
+        const logFile = flagStr(args.flags, 'log-file');
+        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;
+        reconfigureLogger(resolveCliLoggerConfig({ debug, logLevel, logFile }));
+        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 'plugin':
+            case 'plugins':
+                return await pluginCommand(client, args);
+            case 'mcp':
+                return await mcpCommand(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);
+            case 'tui':
+                return await tuiCommand(client, args);
+            case 'skill':
+                return await skillCommand(client, args);
+            case 'agent':
+                return await agentCommand(client, args);
+            case 'gateway':
+                return await gatewayCommand(client, args);
+            case 'launch':
+                return await launchCommand(client, args);
+            case 'workspaces':
+                return await workspacesCommand(client, args);
+            default:
+                if (jsonMode) {
+                    printJsonError('VALIDATION_ERROR', `Unknown command: ${args.command}`);
+                }
+                else {
+                    printError(`Unknown command: ${args.command}. Run "adapters 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('/adapters') ||
+        process.argv[1].endsWith('\\adapters'));
+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/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from "vitest";
+import { resolveCliLoggerConfig } from "./loggingConfig.js";
+describe("resolveCliLoggerConfig", () => {
+    it("uses CLI logging flags without mutating ADAPTERS env vars", () => {
+        const env = {};
+        const config = resolveCliLoggerConfig({
+            debug: true,
+            logLevel: "warn",
+            logFile: "/tmp/adapters.log",
+        }, env);
+        expect(config).toEqual({ level: "warn", logFile: "/tmp/adapters.log" });
+        expect(env.AGENT_MUX_LOG_LEVEL).toBeUndefined();
+        expect(env.AGENT_MUX_LOG_FILE).toBeUndefined();
+        expect(env.AGENT_MUX_OBSERVABILITY_MODE).toBeUndefined();
+    });
+    it("falls back to startup env as input when flags are absent", () => {
+        expect(resolveCliLoggerConfig({}, {
+            AGENT_MUX_LOG_LEVEL: "error",
+            AGENT_MUX_LOG_FILE: "/tmp/from-env.log",
+        })).toEqual({ level: "error", logFile: "/tmp/from-env.log" });
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,GAAG,GAAsB,EAAE,CAAC;QAElC,MAAM,MAAM,GAAG,sBAAsB,CAAC;YACpC,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,mBAAmB;SAC7B,EAAE,GAAG,CAAC,CAAC;QAER,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE;YAChC,mBAAmB,EAAE,OAAO;YAC5B,kBAAkB,EAAE,mBAAmB;SACxC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/agent-capabilities.d.ts

@@ -0,0 +1,6 @@
+export interface AgentCapabilities {
+    supportsPlugins: boolean;
+    pluginCommands: string[];
+    nativePluginCommand: string;
+}
+export declare function detectAgentCapabilities(agent: string): Promise<AgentCapabilities>;

package/dist/lib/agent-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-capabilities.d.ts","sourceRoot":"","sources":["../../src/lib/agent-capabilities.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAqCD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyBvF"}