@a5c-ai/agent-mux-cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 a5c-ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# @a5c-ai/agent-mux-cli
+
+The `amux` command-line interface for [agent-mux](https://github.com/a5c-ai/agent-mux).
+
+## Install
+
+```bash
+npm install -g @a5c-ai/agent-mux-cli
+# or
+npx @a5c-ai/agent-mux-cli --help
+```
+
+Requires Node.js >= 20.9.0.
+
+## Usage
+
+```bash
+amux --help
+amux run --agent claude-code --prompt "Summarize README.md"
+amux adapters list
+amux sessions list
+```
+
+See the [repository README](https://github.com/a5c-ai/agent-mux#readme) for full command documentation.
+
+## License
+
+MIT © a5c-ai

package/dist/bootstrap.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Bootstrap helper: registers all built-in agent adapters with a client.
+ *
+ * The core `AdapterRegistry` starts empty — adapters must be explicitly
+ * registered. This module centralises that wiring so the CLI (and any
+ * consumer) gets all 11 built-in adapters with a single call.
+ */
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+/**
+ * Registers every built-in adapter on the given client's adapter registry.
+ * Safe to call multiple times — `register()` replaces existing entries.
+ */
+export declare function registerBuiltInAdapters(client: AgentMuxClient): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiB7D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CA+BpE"}

package/dist/bootstrap.js

@@ -0,0 +1,41 @@
+/**
+ * Bootstrap helper: registers all built-in agent adapters with a client.
+ *
+ * The core `AdapterRegistry` starts empty — adapters must be explicitly
+ * registered. This module centralises that wiring so the CLI (and any
+ * consumer) gets all 11 built-in adapters with a single call.
+ */
+import { ClaudeAdapter, CodexAdapter, GeminiAdapter, CopilotAdapter, CursorAdapter, OpenCodeAdapter, PiAdapter, OmpAdapter, OpenClawAdapter, HermesAdapter, AgentMuxRemoteAdapter, QwenAdapter, } from '@a5c-ai/agent-mux-adapters';
+/**
+ * Registers every built-in adapter on the given client's adapter registry.
+ * Safe to call multiple times — `register()` replaces existing entries.
+ */
+export function registerBuiltInAdapters(client) {
+    const adapters = [
+        new ClaudeAdapter(),
+        new CodexAdapter(),
+        new GeminiAdapter(),
+        new CopilotAdapter(),
+        new CursorAdapter(),
+        new OpenCodeAdapter(),
+        new PiAdapter(),
+        new OmpAdapter(),
+        new OpenClawAdapter(),
+        new HermesAdapter(),
+        new AgentMuxRemoteAdapter(),
+        new QwenAdapter(),
+    ];
+    // Prefer `registerBuiltIn` on the impl so the `source` shows as 'built-in';
+    // fall back to the public `register()` (which marks as 'plugin') for any
+    // AdapterRegistry implementation that doesn't expose the built-in helper.
+    const registry = client.adapters;
+    for (const adapter of adapters) {
+        if (typeof registry.registerBuiltIn === 'function') {
+            registry.registerBuiltIn(adapter);
+        }
+        else {
+            registry.register(adapter);
+        }
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,eAAe,EACf,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,WAAW,GACZ,MAAM,4BAA4B,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,MAAM,QAAQ,GAAmB;QAC/B,IAAI,aAAa,EAAE;QACnB,IAAI,YAAY,EAAE;QAClB,IAAI,aAAa,EAAE;QACnB,IAAI,cAAc,EAAE;QACpB,IAAI,aAAa,EAAE;QACnB,IAAI,eAAe,EAAE;QACrB,IAAI,SAAS,EAAE;QACf,IAAI,UAAU,EAAE;QAChB,IAAI,eAAe,EAAE;QACrB,IAAI,aAAa,EAAE;QACnB,IAAI,qBAAqB,EAAE;QAC3B,IAAI,WAAW,EAAE;KAClB,CAAC;IAEF,4EAA4E;IAC5E,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,MAAM,CAAC,QAGvB,CAAC;IAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,QAAQ,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;YACnD,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/adapters.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `amux adapters` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 8
+ */
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs } from '../parse-args.js';
+export declare function adaptersCommand(client: AgentMuxClient, args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=adapters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/commands/adapters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOnD,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAwC/F"}

package/dist/commands/adapters.js

@@ -0,0 +1,132 @@
+/**
+ * `amux adapters` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 8
+ */
+import { AgentMuxError } from '@a5c-ai/agent-mux-core';
+import { flagBool, flagStr } from '../parse-args.js';
+import { ExitCode, errorCodeToExitCode } from '../exit-codes.js';
+import { printTable, printKeyValue, printJsonOk, printJsonError, printError, } from '../output.js';
+export async function adaptersCommand(client, args) {
+    const sub = args.subcommand;
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    if (!sub || sub === 'list') {
+        return adaptersList(client, jsonMode);
+    }
+    if (sub === 'detect') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        if (!agent) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <agent>');
+            }
+            else {
+                printError('Missing required argument: <agent>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return adaptersDetect(client, agent, jsonMode);
+    }
+    if (sub === 'info') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        if (!agent) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <agent>');
+            }
+            else {
+                printError('Missing required argument: <agent>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return adaptersInfo(client, agent, jsonMode);
+    }
+    if (jsonMode) {
+        printJsonError('VALIDATION_ERROR', `Unknown subcommand: adapters ${sub}`);
+    }
+    else {
+        printError(`Unknown subcommand: adapters ${sub}`);
+    }
+    return ExitCode.USAGE_ERROR;
+}
+async function adaptersList(client, jsonMode) {
+    try {
+        const adapters = client.adapters.list();
+        if (jsonMode) {
+            printJsonOk(adapters);
+            return ExitCode.SUCCESS;
+        }
+        const rows = adapters.map((a) => [
+            a.agent,
+            a.displayName ?? a.agent,
+            a.source ?? 'built-in',
+        ]);
+        printTable(['Agent', 'Display Name', 'Source'], rows);
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function adaptersDetect(client, agent, jsonMode) {
+    try {
+        const info = await client.adapters.detect(agent);
+        if (jsonMode) {
+            printJsonOk(info);
+            return ExitCode.SUCCESS;
+        }
+        if (!info) {
+            printKeyValue([
+                ['Agent:', agent],
+                ['Installed:', 'no'],
+            ]);
+            return ExitCode.SUCCESS;
+        }
+        printKeyValue([
+            ['Agent:', info.agent],
+            ['Installed:', info.installed ? 'yes' : 'no'],
+            ['Path:', info.cliPath ?? '--'],
+            ['Version:', info.version ?? '--'],
+        ]);
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function adaptersInfo(client, agent, jsonMode) {
+    try {
+        const caps = client.adapters.capabilities(agent);
+        if (jsonMode) {
+            printJsonOk(caps);
+            return ExitCode.SUCCESS;
+        }
+        const entries = [];
+        for (const [key, value] of Object.entries(caps)) {
+            entries.push([`${key}:`, String(value)]);
+        }
+        printKeyValue(entries);
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+function handleError(err, jsonMode) {
+    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;
+}
+//# sourceMappingURL=adapters.js.map

package/dist/commands/adapters.js.map

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

package/dist/commands/auth.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `amux auth` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 18
+ */
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs } from '../parse-args.js';
+export declare function authCommand(client: AgentMuxClient, args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOnD,wBAAsB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAqC3F"}

package/dist/commands/auth.js

@@ -0,0 +1,137 @@
+/**
+ * `amux auth` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 18
+ */
+import { AgentMuxError } from '@a5c-ai/agent-mux-core';
+import { flagBool, flagStr } from '../parse-args.js';
+import { ExitCode, errorCodeToExitCode } from '../exit-codes.js';
+import { printTable, printKeyValue, printJsonOk, printJsonError, printError, toPlain, } from '../output.js';
+export async function authCommand(client, args) {
+    const sub = args.subcommand;
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    if (sub === 'check') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        return authCheck(client, agent, jsonMode);
+    }
+    if (sub === 'setup') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        if (!agent) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <agent>');
+            }
+            else {
+                printError('Missing required argument: <agent>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return authSetup(client, agent, jsonMode);
+    }
+    if (!sub) {
+        if (jsonMode) {
+            printJsonError('VALIDATION_ERROR', 'Missing subcommand. Available: check, setup');
+        }
+        else {
+            printError('Missing subcommand. Available: check, setup');
+        }
+        return ExitCode.USAGE_ERROR;
+    }
+    if (jsonMode) {
+        printJsonError('VALIDATION_ERROR', `Unknown subcommand: auth ${sub}`);
+    }
+    else {
+        printError(`Unknown subcommand: auth ${sub}`);
+    }
+    return ExitCode.USAGE_ERROR;
+}
+async function authCheck(client, agent, jsonMode) {
+    try {
+        if (agent) {
+            const state = await client.auth.check(agent);
+            if (jsonMode) {
+                printJsonOk(state);
+                return ExitCode.SUCCESS;
+            }
+            const s = toPlain(state);
+            printKeyValue([
+                ['Agent:', agent],
+                ['Status:', String(s['status'] ?? '--')],
+                ['Method:', String(s['method'] ?? '--')],
+                ['Identity:', String(s['identity'] ?? '--')],
+            ]);
+            return ExitCode.SUCCESS;
+        }
+        // Check all agents
+        const allStates = await client.auth.checkAll();
+        if (jsonMode) {
+            printJsonOk(allStates);
+            return ExitCode.SUCCESS;
+        }
+        const entries = Object.entries(allStates);
+        const rows = entries.map(([name, state]) => {
+            const s = toPlain(state);
+            return [
+                name,
+                String(s['status'] ?? '--'),
+                String(s['method'] ?? '--'),
+                String(s['identity'] ?? '--'),
+            ];
+        });
+        printTable(['Agent', 'Status', 'Method', 'Identity'], rows);
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function authSetup(client, agent, jsonMode) {
+    try {
+        const guidance = await client.auth.getSetupGuidance(agent);
+        if (jsonMode) {
+            printJsonOk(guidance);
+            return ExitCode.SUCCESS;
+        }
+        const g = toPlain(guidance);
+        process.stdout.write(`Authentication setup for ${agent}\n\n`);
+        if (g['steps'] && Array.isArray(g['steps'])) {
+            const steps = g['steps'];
+            for (let i = 0; i < steps.length; i++) {
+                const step = steps[i];
+                process.stdout.write(`${i + 1}. ${step['description'] ?? step['instruction'] ?? String(step)}\n`);
+            }
+        }
+        if (g['envVars'] && Array.isArray(g['envVars'])) {
+            process.stdout.write('\nEnvironment variables:\n');
+            for (const v of g['envVars']) {
+                process.stdout.write(`  ${v}\n`);
+            }
+        }
+        if (g['docsUrl']) {
+            process.stdout.write(`\nDocumentation: ${g['docsUrl']}\n`);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+function handleError(err, jsonMode) {
+    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;
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `amux config` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 16
+ */
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs } from '../parse-args.js';
+export declare function configCommand(client: AgentMuxClient, args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAOnD,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA+E7F"}

package/dist/commands/config.js

@@ -0,0 +1,221 @@
+/**
+ * `amux config` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 16
+ */
+import { AgentMuxError } from '@a5c-ai/agent-mux-core';
+import { flagBool, flagStr } from '../parse-args.js';
+import { ExitCode, errorCodeToExitCode } from '../exit-codes.js';
+import { printJson, printJsonOk, printJsonError, printError, toPlain, } from '../output.js';
+export async function configCommand(client, args) {
+    const sub = args.subcommand;
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    if (sub === 'get') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        if (!agent) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <agent>');
+            }
+            else {
+                printError('Missing required argument: <agent>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        const field = args.positionals[1];
+        return configGet(client, agent, field, jsonMode);
+    }
+    if (sub === 'set') {
+        const agent = args.positionals[0];
+        const field = args.positionals[1];
+        const value = args.positionals[2];
+        if (!agent || !field || value === undefined) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Usage: amux config set <agent> <field> <value>');
+            }
+            else {
+                printError('Usage: amux config set <agent> <field> <value>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return configSet(client, agent, field, value, jsonMode);
+    }
+    if (sub === 'schema') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        if (!agent) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <agent>');
+            }
+            else {
+                printError('Missing required argument: <agent>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return configSchema(client, agent, jsonMode);
+    }
+    if (sub === 'validate') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        if (!agent) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <agent>');
+            }
+            else {
+                printError('Missing required argument: <agent>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return configValidate(client, agent, jsonMode);
+    }
+    if (sub === 'reload') {
+        const agent = args.positionals[0] ?? flagStr(args.flags, 'agent');
+        return configReload(client, agent, jsonMode);
+    }
+    if (!sub) {
+        if (jsonMode) {
+            printJsonError('VALIDATION_ERROR', 'Missing subcommand. Available: get, set, schema, validate, reload');
+        }
+        else {
+            printError('Missing subcommand. Available: get, set, schema, validate, reload');
+        }
+        return ExitCode.USAGE_ERROR;
+    }
+    if (jsonMode) {
+        printJsonError('VALIDATION_ERROR', `Unknown subcommand: config ${sub}`);
+    }
+    else {
+        printError(`Unknown subcommand: config ${sub}`);
+    }
+    return ExitCode.USAGE_ERROR;
+}
+async function configGet(client, agent, field, jsonMode) {
+    try {
+        let result;
+        if (field) {
+            result = await client.config.getField(agent, field);
+        }
+        else {
+            result = await client.config.get(agent);
+        }
+        if (jsonMode) {
+            // Ensure `data` key is present even when the field is missing, so
+            // consumers can rely on a consistent { ok, data } shape.
+            printJsonOk(result === undefined ? null : result);
+        }
+        else if (typeof result === 'object' && result !== null) {
+            printJson(result);
+        }
+        else {
+            process.stdout.write(String(result) + '\n');
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function configSet(client, agent, field, rawValue, jsonMode) {
+    try {
+        // Parse value: JSON if it starts with {, [, ", or is a number/boolean
+        let value = rawValue;
+        if (rawValue.startsWith('{') || rawValue.startsWith('[') || rawValue.startsWith('"') ||
+            rawValue === 'true' || rawValue === 'false' || rawValue === 'null' ||
+            !Number.isNaN(Number(rawValue))) {
+            try {
+                value = JSON.parse(rawValue);
+            }
+            catch {
+                // Keep as string
+            }
+        }
+        await client.config.setField(agent, field, value);
+        if (jsonMode) {
+            printJsonOk({ agent, field, value });
+        }
+        else {
+            process.stdout.write(`Set ${agent}.${field} = ${JSON.stringify(value)}\n`);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function configSchema(client, agent, jsonMode) {
+    try {
+        const schema = await client.config.schema(agent);
+        if (jsonMode) {
+            printJsonOk(schema);
+        }
+        else {
+            printJson(schema);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function configValidate(client, agent, jsonMode) {
+    try {
+        const config = await client.config.get(agent);
+        const result = await client.config.validate(agent, config);
+        if (jsonMode) {
+            printJsonOk(result);
+        }
+        else {
+            const r = toPlain(result);
+            if (r['valid']) {
+                process.stdout.write('Configuration is valid.\n');
+            }
+            else {
+                const errors = (r['errors'] ?? []);
+                for (const e of errors) {
+                    process.stderr.write(`  ${e['field']}: ${e['message']}\n`);
+                }
+            }
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function configReload(client, agent, jsonMode) {
+    try {
+        if (agent) {
+            await client.config.reload(agent);
+        }
+        else {
+            await client.config.reload();
+        }
+        if (jsonMode) {
+            printJsonOk({ reloaded: agent ?? 'all' });
+        }
+        else {
+            process.stdout.write(`Configuration reloaded${agent ? ` for ${agent}` : ''}.\n`);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+function handleError(err, jsonMode) {
+    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;
+}
+//# sourceMappingURL=config.js.map