@a5c-ai/agent-mux-cli 0.2.0

package/dist/commands/plugins.js

@@ -0,0 +1,180 @@
+/**
+ * `amux plugins` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 11
+ */
+import { AgentMuxError } from '@a5c-ai/agent-mux-core';
+import { flagBool, flagStr } from '../parse-args.js';
+import { ExitCode, errorCodeToExitCode } from '../exit-codes.js';
+import { printTable, printJsonOk, printJsonError, printError, } from '../output.js';
+export async function pluginsCommand(client, args) {
+    const sub = args.subcommand;
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    if (sub === 'list') {
+        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 pluginsList(client, agent, jsonMode);
+    }
+    if (sub === 'install') {
+        const agent = args.positionals[0];
+        const plugin = args.positionals[1];
+        if (!agent || !plugin) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Usage: amux plugins install <agent> <plugin>');
+            }
+            else {
+                printError('Usage: amux plugins install <agent> <plugin>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return pluginsInstall(client, agent, plugin, args, jsonMode);
+    }
+    if (sub === 'uninstall') {
+        const agent = args.positionals[0];
+        const plugin = args.positionals[1];
+        if (!agent || !plugin) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Usage: amux plugins uninstall <agent> <plugin>');
+            }
+            else {
+                printError('Usage: amux plugins uninstall <agent> <plugin>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return pluginsUninstall(client, agent, plugin, jsonMode);
+    }
+    if (!sub) {
+        if (jsonMode) {
+            printJsonError('VALIDATION_ERROR', 'Missing subcommand. Available: list, install, uninstall');
+        }
+        else {
+            printError('Missing subcommand. Available: list, install, uninstall');
+        }
+        return ExitCode.USAGE_ERROR;
+    }
+    if (jsonMode) {
+        printJsonError('VALIDATION_ERROR', `Unknown subcommand: plugins ${sub}`);
+    }
+    else {
+        printError(`Unknown subcommand: plugins ${sub}`);
+    }
+    return ExitCode.USAGE_ERROR;
+}
+async function pluginsList(client, agent, jsonMode) {
+    try {
+        // PluginManager is currently a stub — gracefully handle
+        // PluginManager is a stub interface at this phase; accessing optional
+        // methods/properties by string key requires a loose view.
+        const pm = client.plugins;
+        if (pm['_stub']) {
+            if (jsonMode) {
+                printJsonOk([]);
+            }
+            else {
+                process.stdout.write('Plugin management is not yet implemented.\n');
+            }
+            return ExitCode.SUCCESS;
+        }
+        const list = (await pm['list']?.(agent)) ?? [];
+        if (jsonMode) {
+            printJsonOk(list);
+            return ExitCode.SUCCESS;
+        }
+        const rows = list.map((p) => [
+            String(p['id'] ?? '--'),
+            String(p['name'] ?? '--'),
+            String(p['version'] ?? '--'),
+            String(p['format'] ?? '--'),
+            p['enabled'] ? 'yes' : 'no',
+        ]);
+        printTable(['Plugin ID', 'Name', 'Version', 'Format', 'Enabled'], rows);
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function pluginsInstall(client, agent, plugin, args, jsonMode) {
+    try {
+        // PluginManager is a stub interface at this phase; accessing optional
+        // methods/properties by string key requires a loose view.
+        const pm = client.plugins;
+        if (pm['_stub']) {
+            if (jsonMode) {
+                printJsonError('PLUGIN_ERROR', 'Plugin management is not yet implemented');
+            }
+            else {
+                printError('Plugin management is not yet implemented.');
+            }
+            return ExitCode.PLUGIN_ERROR;
+        }
+        const version = flagStr(args.flags, 'version');
+        const global = flagBool(args.flags, 'global');
+        await pm['install']?.(agent, plugin, { version, global });
+        if (jsonMode) {
+            printJsonOk({ installed: plugin, agent });
+        }
+        else {
+            process.stdout.write(`Plugin "${plugin}" installed for ${agent}.\n`);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function pluginsUninstall(client, agent, plugin, jsonMode) {
+    try {
+        // PluginManager is a stub interface at this phase; accessing optional
+        // methods/properties by string key requires a loose view.
+        const pm = client.plugins;
+        if (pm['_stub']) {
+            if (jsonMode) {
+                printJsonError('PLUGIN_ERROR', 'Plugin management is not yet implemented');
+            }
+            else {
+                printError('Plugin management is not yet implemented.');
+            }
+            return ExitCode.PLUGIN_ERROR;
+        }
+        await pm['uninstall']?.(agent, plugin);
+        if (jsonMode) {
+            printJsonOk({ uninstalled: plugin, agent });
+        }
+        else {
+            process.stdout.write(`Plugin "${plugin}" uninstalled from ${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=plugins.js.map

package/dist/commands/plugins.js.map

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

package/dist/commands/profiles.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/commands/profiles.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,CAkE/F"}

package/dist/commands/profiles.js

@@ -0,0 +1,206 @@
+/**
+ * `amux profiles` subcommands.
+ *
+ * @see docs/10-cli-reference.md Section 17
+ */
+import { AgentMuxError } from '@a5c-ai/agent-mux-core';
+import { flagBool, flagStr } from '../parse-args.js';
+import { ExitCode, errorCodeToExitCode } from '../exit-codes.js';
+import { printTable, printJsonOk, printJsonError, printError, printJson, toPlain, } from '../output.js';
+export async function profilesCommand(client, args) {
+    const sub = args.subcommand;
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    if (sub === 'list' || !sub) {
+        return profilesList(client, args, jsonMode);
+    }
+    if (sub === 'show') {
+        const name = args.positionals[0];
+        if (!name) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <name>');
+            }
+            else {
+                printError('Missing required argument: <name>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return profilesShow(client, name, jsonMode);
+    }
+    if (sub === 'set') {
+        const name = args.positionals[0];
+        if (!name) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <name>');
+            }
+            else {
+                printError('Missing required argument: <name>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return profilesSet(client, name, args, jsonMode);
+    }
+    if (sub === 'delete') {
+        const name = args.positionals[0];
+        if (!name) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <name>');
+            }
+            else {
+                printError('Missing required argument: <name>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return profilesDelete(client, name, args, jsonMode);
+    }
+    if (sub === 'apply') {
+        const name = args.positionals[0];
+        if (!name) {
+            if (jsonMode) {
+                printJsonError('VALIDATION_ERROR', 'Missing required argument: <name>');
+            }
+            else {
+                printError('Missing required argument: <name>');
+            }
+            return ExitCode.USAGE_ERROR;
+        }
+        return profilesApply(client, name, jsonMode);
+    }
+    if (jsonMode) {
+        printJsonError('VALIDATION_ERROR', `Unknown subcommand: profiles ${sub}`);
+    }
+    else {
+        printError(`Unknown subcommand: profiles ${sub}`);
+    }
+    return ExitCode.USAGE_ERROR;
+}
+function parseScope(raw) {
+    if (raw === undefined)
+        return undefined;
+    if (raw === 'global' || raw === 'project')
+        return raw;
+    throw new Error(`Invalid --scope: "${raw}" (expected "global" or "project")`);
+}
+async function profilesList(client, args, jsonMode) {
+    try {
+        const scope = parseScope(flagStr(args.flags, 'scope'));
+        const opts = scope ? { scope } : undefined;
+        const profiles = await client.profiles.list(opts);
+        if (jsonMode) {
+            printJsonOk(profiles);
+            return ExitCode.SUCCESS;
+        }
+        const rows = profiles.map((profile) => {
+            const p = toPlain(profile);
+            return [
+                String(p['name'] ?? '--'),
+                String(p['scope'] ?? '--'),
+                String(p['agent'] ?? '--'),
+                String(p['model'] ?? '--'),
+            ];
+        });
+        printTable(['Name', 'Scope', 'Agent', 'Model'], rows);
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function profilesShow(client, name, jsonMode) {
+    try {
+        const profile = await client.profiles.show(name);
+        if (jsonMode) {
+            printJsonOk(profile);
+        }
+        else {
+            printJson(profile);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function profilesSet(client, name, args, jsonMode) {
+    try {
+        // Build profile data from remaining flags
+        const data = {};
+        const scope = parseScope(flagStr(args.flags, 'scope'));
+        const agent = flagStr(args.flags, 'agent');
+        const model = flagStr(args.flags, 'model');
+        if (agent)
+            data['agent'] = agent;
+        if (model)
+            data['model'] = model;
+        // Pass through known run flags
+        for (const key of Object.keys(args.flags)) {
+            if (['agent', 'model', 'scope', 'json', 'help', 'debug', 'config-dir', 'project-dir', 'no-color', 'version'].includes(key)) {
+                continue;
+            }
+            data[key] = args.flags[key];
+        }
+        const opts = scope ? { scope } : undefined;
+        await client.profiles.set(name, data, opts);
+        if (jsonMode) {
+            printJsonOk({ name, data });
+        }
+        else {
+            process.stdout.write(`Profile "${name}" saved.\n`);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function profilesDelete(client, name, args, jsonMode) {
+    try {
+        const scope = parseScope(flagStr(args.flags, 'scope'));
+        const opts = scope ? { scope } : undefined;
+        await client.profiles.delete(name, opts);
+        if (jsonMode) {
+            printJsonOk({ deleted: name });
+        }
+        else {
+            process.stdout.write(`Profile "${name}" deleted.\n`);
+        }
+        return ExitCode.SUCCESS;
+    }
+    catch (err) {
+        return handleError(err, jsonMode);
+    }
+}
+async function profilesApply(client, name, jsonMode) {
+    try {
+        const resolved = await client.profiles.apply(name);
+        if (jsonMode) {
+            printJsonOk(resolved);
+        }
+        else {
+            printJson(resolved);
+        }
+        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=profiles.js.map

package/dist/commands/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/commands/profiles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EACL,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,GACxE,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAsB,EAAE,IAAgB;IAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IAEvD,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,mCAAmC,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,OAAO,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,mCAAmC,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,OAAO,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,mCAAmC,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,mCAAmC,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,mCAAmC,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,cAAc,CAAC,kBAAkB,EAAE,gCAAgC,GAAG,EAAE,CAAC,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,CAAC;AAC9B,CAAC;AAED,SAAS,UAAU,CAAC,GAAuB;IACzC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACtD,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,oCAAoC,CAAC,CAAC;AAChF,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAAsB,EAAE,IAAgB,EAAE,QAAiB;IAE3D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAElD,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,QAAQ,CAAC,CAAC;YACtB,OAAO,QAAQ,CAAC,OAAO,CAAC;QAC1B,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACpC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3B,OAAO;gBACL,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC;gBACzB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;gBAC1B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;gBAC1B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;aAC3B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QACtD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAsB,EAAE,IAAY,EAAE,QAAiB;IACjF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,MAAsB,EAAE,IAAY,EAAE,IAAgB,EAAE,QAAiB;IAEzE,IAAI,CAAC;QACH,0CAA0C;QAC1C,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QAEvD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,KAAK;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QACjC,IAAI,KAAK;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QAEjC,+BAA+B;QAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3H,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3C,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE5C,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,YAAY,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAsB,EAAE,IAAY,EAAE,IAAgB,EAAE,QAAiB;IAEzE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3C,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEzC,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,cAAc,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAsB,EAAE,IAAY,EAAE,QAAiB;IAClF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEnD,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,QAAiB;IAClD,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,QAAQ,EAAE,CAAC;QACb,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC,aAAa,CAAC;AAChC,CAAC"}

package/dist/commands/remote.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `amux remote install <host>` / `amux remote update <host>`.
+ *
+ * Self-install pipeline — uses `buildInvocationCommand()` to build each step
+ * so the transport (ssh/docker/k8s) is selectable via `--mode` and works
+ * uniformly across environments.
+ *
+ * Steps:
+ *   1. Probe:    `amux --version`            — check if amux is on the remote.
+ *   2. Install:  `npm install -g @a5c-ai/agent-mux-cli` if missing (or --force).
+ *   3. Harness:  `amux install <harness>`    — deploy the desired harness.
+ *   4. Verify:   `amux detect --all --json`  — confirm the harness is active.
+ */
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs, FlagDef } from '../parse-args.js';
+export declare const REMOTE_FLAGS: Record<string, FlagDef>;
+/** Minimal spawner used by the remote command. Injectable for tests. */
+export type RemoteSpawner = (command: string, args: string[]) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+export interface RemoteCommandDeps {
+    spawner?: RemoteSpawner;
+}
+/**
+ * `amux remote install <host> [--mode ssh|docker|k8s|local] [--harness <agent>]`
+ * `amux remote update <host> ...`
+ */
+export declare function remoteCommand(_client: AgentMuxClient, args: ParsedArgs, deps?: RemoteCommandDeps): Promise<number>;
+//# sourceMappingURL=remote.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/commands/remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAK5D,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAUhD,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,KACX,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAmB/D,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAmDD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,EAChB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6GjB"}

package/dist/commands/remote.js

@@ -0,0 +1,204 @@
+/**
+ * `amux remote install <host>` / `amux remote update <host>`.
+ *
+ * Self-install pipeline — uses `buildInvocationCommand()` to build each step
+ * so the transport (ssh/docker/k8s) is selectable via `--mode` and works
+ * uniformly across environments.
+ *
+ * Steps:
+ *   1. Probe:    `amux --version`            — check if amux is on the remote.
+ *   2. Install:  `npm install -g @a5c-ai/agent-mux-cli` if missing (or --force).
+ *   3. Harness:  `amux install <harness>`    — deploy the desired harness.
+ *   4. Verify:   `amux detect --all --json`  — confirm the harness is active.
+ */
+import { spawn } from 'node:child_process';
+import { buildInvocationCommand } from '@a5c-ai/agent-mux-core';
+import { flagBool, flagStr } from '../parse-args.js';
+import { ExitCode } from '../exit-codes.js';
+import { printJsonOk, printJsonError, printError } from '../output.js';
+export const REMOTE_FLAGS = {
+    'mode': { type: 'string' }, // ssh | docker | k8s | local
+    'harness': { type: 'string' }, // agent to install (default: claude)
+    'image': { type: 'string' }, // docker image
+    'identity-file': { type: 'string' }, // ssh key
+    'port': { type: 'number' }, // ssh port
+    'namespace': { type: 'string' }, // k8s namespace
+    'context': { type: 'string' }, // k8s context
+    'force': { type: 'boolean' },
+    'dry-run': { type: 'boolean' },
+};
+const defaultSpawner = (command, args) => new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: false,
+        windowsHide: true,
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout?.setEncoding('utf8');
+    child.stderr?.setEncoding('utf8');
+    child.stdout?.on('data', (c) => { stdout += c; });
+    child.stderr?.on('data', (c) => { stderr += c; });
+    child.on('error', (err) => reject(err));
+    child.on('exit', (code) => resolve({ code: code ?? 1, stdout, stderr }));
+});
+/** Build a SpawnArgs shell for a given amux (or npm) command. */
+function makeSpawnArgs(command, args, cwd) {
+    return { command, args, env: {}, cwd, usePty: false };
+}
+/**
+ * Resolve the InvocationMode for a given CLI invocation of `amux remote`.
+ * The first positional after the subcommand is typically the host (for ssh)
+ * or is ignored for docker/k8s/local (which read image/namespace from flags).
+ */
+function buildMode(modeFlag, host, args) {
+    switch (modeFlag) {
+        case 'local':
+            return { mode: 'local' };
+        case 'docker': {
+            const image = flagStr(args.flags, 'image');
+            if (!image)
+                throw new Error('--mode=docker requires --image=<image>');
+            return { mode: 'docker', image };
+        }
+        case 'k8s': {
+            const ns = flagStr(args.flags, 'namespace');
+            const ctx = flagStr(args.flags, 'context');
+            const m = {
+                mode: 'k8s',
+                ...(ns !== undefined ? { namespace: ns } : {}),
+                ...(ctx !== undefined ? { context: ctx } : {}),
+            };
+            return m;
+        }
+        case 'ssh':
+        default: {
+            if (!host)
+                throw new Error('ssh mode requires a <host> positional argument');
+            const port = flagStr(args.flags, 'port');
+            const id = flagStr(args.flags, 'identity-file');
+            const m = {
+                mode: 'ssh',
+                host,
+                ...(port !== undefined ? { port: Number(port) } : {}),
+                ...(id !== undefined ? { identityFile: id } : {}),
+            };
+            return m;
+        }
+    }
+}
+/**
+ * `amux remote install <host> [--mode ssh|docker|k8s|local] [--harness <agent>]`
+ * `amux remote update <host> ...`
+ */
+export async function remoteCommand(_client, args, deps = {}) {
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    const spawner = deps.spawner ?? defaultSpawner;
+    const sub = args.subcommand ?? args.positionals[0];
+    if (sub !== 'install' && sub !== 'update') {
+        const msg = 'Usage: amux remote install <host> [--mode ssh|docker|k8s] [--harness <agent>]';
+        if (jsonMode)
+            printJsonError('VALIDATION_ERROR', msg);
+        else
+            printError(msg);
+        return ExitCode.USAGE_ERROR;
+    }
+    // Positional order: `remote install <host>` — when parser assigned `sub` as
+    // subcommand the host is positionals[0]; when it put `install` in positionals[0]
+    // the host is positionals[1].
+    const host = args.subcommand === sub ? args.positionals[0] : args.positionals[1];
+    const modeFlag = flagStr(args.flags, 'mode') ?? 'ssh';
+    const harness = flagStr(args.flags, 'harness') ?? 'claude';
+    const force = flagBool(args.flags, 'force') === true;
+    const dryRun = flagBool(args.flags, 'dry-run') === true;
+    let invocation;
+    try {
+        invocation = buildMode(modeFlag, host, args);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (jsonMode)
+            printJsonError('VALIDATION_ERROR', msg);
+        else
+            printError(msg);
+        return ExitCode.USAGE_ERROR;
+    }
+    const cwd = process.cwd();
+    const steps = [];
+    const runStep = async (step, cmd, cmdArgs) => {
+        const spawnArgs = makeSpawnArgs(cmd, cmdArgs, cwd);
+        const inv = buildInvocationCommand(invocation, spawnArgs, 'agent-mux-remote');
+        const entry = { step, command: inv.command, args: inv.args };
+        steps.push(entry);
+        if (dryRun) {
+            entry.result = { code: 0, stdout: '', stderr: '' };
+            if (!jsonMode)
+                process.stdout.write(`[dry-run] ${inv.command} ${inv.args.join(' ')}\n`);
+            return entry.result;
+        }
+        if (!jsonMode)
+            process.stdout.write(`=> ${step}: ${inv.command} ${inv.args.slice(0, 6).join(' ')}${inv.args.length > 6 ? ' ...' : ''}\n`);
+        const r = await spawner(inv.command, inv.args);
+        entry.result = r;
+        return r;
+    };
+    // Step 1: probe amux
+    const probe = await runStep('probe', 'amux', ['--version']);
+    const needsInstall = sub === 'update' || probe.code !== 0 || force;
+    // Step 2: install amux itself if missing (or forced / update)
+    if (needsInstall) {
+        const npmVerb = sub === 'update' ? 'update' : 'install';
+        const npm = await runStep('amux-self', 'npm', [npmVerb, '-g', '@a5c-ai/agent-mux-cli']);
+        if (!dryRun && npm.code !== 0) {
+            const msg = `npm ${npmVerb} failed on remote (code ${npm.code})`;
+            if (jsonMode)
+                printJsonError('INTERNAL', msg);
+            else
+                printError(msg);
+            if (!jsonMode && npm.stderr)
+                process.stderr.write(npm.stderr);
+            return ExitCode.GENERAL_ERROR;
+        }
+    }
+    // Step 3: install harness
+    const harnessVerb = sub === 'update' ? 'update' : 'install';
+    const installArgs = [harnessVerb, harness];
+    if (force && sub === 'install')
+        installArgs.push('--force');
+    const hres = await runStep('harness', 'amux', installArgs);
+    if (!dryRun && hres.code !== 0) {
+        const msg = `amux ${harnessVerb} ${harness} failed on remote (code ${hres.code})`;
+        if (jsonMode)
+            printJsonError('INTERNAL', msg);
+        else
+            printError(msg);
+        if (!jsonMode && hres.stderr)
+            process.stderr.write(hres.stderr);
+        return ExitCode.GENERAL_ERROR;
+    }
+    // Step 4: verify
+    const verify = await runStep('verify', 'amux', ['detect', '--all', '--json']);
+    if (jsonMode) {
+        printJsonOk({
+            host: host ?? null,
+            mode: modeFlag,
+            harness,
+            subcommand: sub,
+            dryRun: dryRun || undefined,
+            steps: steps.map((s) => ({
+                step: s.step,
+                command: s.command,
+                args: s.args,
+                code: s.result?.code ?? null,
+                stdout: s.result?.stdout ?? '',
+                stderr: s.result?.stderr ?? '',
+            })),
+        });
+    }
+    else {
+        process.stdout.write(`\n${sub === 'update' ? 'Updated' : 'Installed'} ${harness} on ${host ?? modeFlag} (mode=${modeFlag}).\n` +
+            (verify.stdout ? `\nVerify output:\n${verify.stdout}\n` : ''));
+    }
+    return ExitCode.SUCCESS;
+}
+//# sourceMappingURL=remote.js.map