@a5c-ai/agent-mux-adapters 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,26 @@
+# @a5c-ai/agent-mux-adapters
+
+Built-in agent adapters for [agent-mux](https://github.com/a5c-ai/agent-mux): `claude-code`, `codex`, `gemini`, `copilot`, `cursor`, `opencode`, `pi`, `omp`, `openclaw`, `hermes`, plus a remote `agent-mux` adapter.
+
+## Install
+
+```bash
+npm install @a5c-ai/agent-mux-adapters @a5c-ai/agent-mux-core
+```
+
+Requires Node.js >= 20.9.0. ESM-only.
+
+## Usage
+
+```ts
+import { registerBuiltinAdapters } from '@a5c-ai/agent-mux-adapters';
+import { defaultRegistry } from '@a5c-ai/agent-mux-core';
+
+registerBuiltinAdapters(defaultRegistry);
+```
+
+See the [repository README](https://github.com/a5c-ai/agent-mux#readme) for full documentation.
+
+## License
+
+MIT © a5c-ai

package/dist/adapter-install.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Install/update helpers for BaseAgentAdapter.
+ *
+ * The install and update flows share the "pick method → resolve command →
+ * spawn → re-detect" skeleton. Extracted here so the base class stays
+ * small; no behavior change.
+ */
+import type { AdapterInstallOptions, AdapterUpdateOptions, DetectInstallationResult, InstallMethod, InstallResult, Spawner } from '@a5c-ai/agent-mux-core';
+/** Collaborators the helpers need from the adapter. */
+export interface InstallContext {
+    readonly cliCommand: string;
+    readonly displayName: string;
+    readonly spawner: Spawner;
+    detectInstallation(): Promise<DetectInstallationResult>;
+    pickInstallMethod(): InstallMethod | undefined;
+    applyVersionToCommand(method: InstallMethod, version?: string): string;
+    deriveUpdateCommand(method: InstallMethod): string | null;
+}
+export declare function runInstall(ctx: InstallContext, opts: AdapterInstallOptions): Promise<InstallResult>;
+export declare function runUpdate(ctx: InstallContext, opts: AdapterUpdateOptions): Promise<InstallResult>;
+//# sourceMappingURL=adapter-install.d.ts.map

package/dist/adapter-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-install.d.ts","sourceRoot":"","sources":["../src/adapter-install.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,OAAO,EACR,MAAM,wBAAwB,CAAC;AAEhC,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACxD,iBAAiB,IAAI,aAAa,GAAG,SAAS,CAAC;IAC/C,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvE,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3D;AAuCD,wBAAsB,UAAU,CAC9B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,aAAa,CAAC,CA8CxB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,aAAa,CAAC,CA+BxB"}

package/dist/adapter-install.js

@@ -0,0 +1,114 @@
+/**
+ * Install/update helpers for BaseAgentAdapter.
+ *
+ * The install and update flows share the "pick method → resolve command →
+ * spawn → re-detect" skeleton. Extracted here so the base class stays
+ * small; no behavior change.
+ */
+import * as os from 'node:os';
+async function executeCommand(ctx, method, command) {
+    const parts = command.split(/\s+/).filter(Boolean);
+    const [cmd, ...argv] = parts;
+    let runResult;
+    try {
+        runResult = await ctx.spawner(cmd, argv);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            method: method.type,
+            command,
+            stderr: err instanceof Error ? err.message : String(err),
+        };
+    }
+    const ok = runResult.code === 0;
+    let installedVersion;
+    if (ok) {
+        const det = await ctx.detectInstallation().catch(() => null);
+        if (det?.version)
+            installedVersion = det.version;
+    }
+    const result = {
+        ok,
+        method: method.type,
+        command,
+        stdout: runResult.stdout,
+        stderr: runResult.stderr,
+    };
+    if (installedVersion)
+        result.installedVersion = installedVersion;
+    return result;
+}
+export async function runInstall(ctx, opts) {
+    if (!opts.force && !opts.dryRun) {
+        const existing = await ctx.detectInstallation();
+        if (existing.installed) {
+            const r = {
+                ok: true,
+                method: 'already-installed',
+                command: '',
+                message: `${ctx.cliCommand} is already installed${existing.version ? ` (${existing.version})` : ''}`,
+            };
+            if (existing.version)
+                r.installedVersion = existing.version;
+            return r;
+        }
+    }
+    const method = ctx.pickInstallMethod();
+    if (!method) {
+        return {
+            ok: false,
+            method: 'none',
+            command: '',
+            message: `No compatible install method for platform ${os.platform()}`,
+        };
+    }
+    if (method.type === 'manual') {
+        return {
+            ok: false,
+            method: 'manual',
+            command: method.command,
+            message: `${ctx.displayName} must be installed manually: ${method.command}`,
+        };
+    }
+    const command = ctx.applyVersionToCommand(method, opts.version);
+    if (opts.dryRun) {
+        return {
+            ok: true,
+            method: method.type,
+            command,
+            message: `[dry-run] would execute: ${command}`,
+        };
+    }
+    return executeCommand(ctx, method, command);
+}
+export async function runUpdate(ctx, opts) {
+    const method = ctx.pickInstallMethod();
+    if (!method) {
+        return {
+            ok: false,
+            method: 'none',
+            command: '',
+            message: `No compatible update method for platform ${os.platform()}`,
+        };
+    }
+    const command = ctx.deriveUpdateCommand(method);
+    if (!command) {
+        return {
+            ok: false,
+            method: method.type,
+            command: method.command,
+            message: `Update not supported for method "${method.type}". Install command: ${method.command}`,
+        };
+    }
+    if (opts.dryRun) {
+        return {
+            ok: true,
+            method: method.type,
+            command,
+            message: `[dry-run] would execute: ${command}`,
+        };
+    }
+    return executeCommand(ctx, method, command);
+}
+//# sourceMappingURL=adapter-install.js.map

package/dist/adapter-install.js.map

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

package/dist/agent-mux-remote-adapter.d.ts

@@ -0,0 +1,66 @@
+/**
+ * AgentMuxRemoteAdapter — pass-through adapter that delegates to another
+ * `amux` CLI installation. Transport is out of scope: this adapter emits
+ * plain `amux run ...` spawn args, and the caller wraps them with the
+ * desired invocation mode (local/docker/ssh/k8s) via
+ * `buildInvocationCommand()`.
+ *
+ * This lets agent-mux nest: a local amux invocation dispatches to a second
+ * amux executing in a docker container, on a remote SSH host, or in a k8s
+ * pod. All structured events are forwarded verbatim — the remote `amux run`
+ * emits JSONL which we pass through unchanged.
+ *
+ * Configuration is read from RunOptions.env:
+ *   AMUX_REMOTE_AGENT  — agent name to invoke on the remote (default: claude)
+ *
+ * The transport-specific bits (host, identity file, docker image, ...) live
+ * on `RunOptions.invocation` — not on this adapter.
+ */
+import type { AgentCapabilities, ModelCapabilities, AgentConfigSchema, AuthState, AuthSetupGuidance, Session, SpawnArgs, ParseContext, RunOptions, AgentEvent, AgentConfig } from '@a5c-ai/agent-mux-core';
+import { BaseAgentAdapter } from './base-adapter.js';
+export declare class AgentMuxRemoteAdapter extends BaseAgentAdapter {
+    readonly agent: "agent-mux-remote";
+    readonly displayName = "agent-mux (remote via invocation mode)";
+    readonly cliCommand = "amux";
+    readonly minVersion = "0.1.0";
+    readonly hostEnvSignals: readonly [];
+    readonly capabilities: AgentCapabilities;
+    readonly models: ModelCapabilities[];
+    readonly defaultModelId: undefined;
+    readonly configSchema: AgentConfigSchema;
+    /** Resolve the remote agent name (which agent to invoke inside the nested amux). */
+    private resolveRemoteAgent;
+    /**
+     * Emit `amux run --json --agent <agent> --prompt <...>` args.
+     *
+     * The caller is responsible for wrapping these with an invocation mode
+     * (ssh/docker/k8s) via `buildInvocationCommand()`. This keeps the adapter
+     * transport-agnostic so the same binary can be used inside a docker
+     * container, on a remote SSH host, or in a k8s pod.
+     */
+    buildSpawnArgs(options: RunOptions): SpawnArgs;
+    parseEvent(line: string, context: ParseContext): AgentEvent | AgentEvent[] | null;
+    /** Detect version via the local spawner running plain `amux --version`. */
+    detectVersion(): Promise<string | null>;
+    protected detectVersionFromCli(): Promise<string | null>;
+    detectAuth(): Promise<AuthState>;
+    getAuthGuidance(): AuthSetupGuidance;
+    sessionDir(_cwd?: string): string;
+    parseSessionFile(_filePath: string): Promise<Session>;
+    /** List remote sessions via plain `amux sessions list --json` (transport is external). */
+    listSessionFiles(_cwd?: string): Promise<string[]>;
+    readConfig(_cwd?: string): Promise<AgentConfig>;
+    writeConfig(_config: Partial<AgentConfig>, _cwd?: string): Promise<void>;
+    /**
+     * Detect whether `amux` is available at the current spawner scope (local or
+     * wrapped). The wrapper — docker/ssh/k8s — is applied externally.
+     */
+    detectInstallation(): Promise<import('@a5c-ai/agent-mux-core').DetectInstallationResult>;
+    /**
+     * Install amux via `npm install -g @a5c-ai/agent-mux-cli`.
+     * Transport wrapping (ssh/docker/k8s) is the caller's responsibility.
+     */
+    install(opts?: import('@a5c-ai/agent-mux-core').AdapterInstallOptions): Promise<import('@a5c-ai/agent-mux-core').InstallResult>;
+    update(opts?: import('@a5c-ai/agent-mux-core').AdapterUpdateOptions): Promise<import('@a5c-ai/agent-mux-core').InstallResult>;
+}
+//# sourceMappingURL=agent-mux-remote-adapter.d.ts.map

package/dist/agent-mux-remote-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-mux-remote-adapter.d.ts","sourceRoot":"","sources":["../src/agent-mux-remote-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,qBAAsB,SAAQ,gBAAgB;IACzD,QAAQ,CAAC,KAAK,EAAG,kBAAkB,CAAU;IAC7C,QAAQ,CAAC,WAAW,4CAA4C;IAChE,QAAQ,CAAC,UAAU,UAAU;IAC7B,QAAQ,CAAC,UAAU,WAAW;IAC9B,QAAQ,CAAC,cAAc,cAAe;IAEtC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CA0CtC;IAEF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAM;IAC1C,QAAQ,CAAC,cAAc,YAAa;IAEpC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAOtC;IAEF,oFAAoF;IACpF,OAAO,CAAC,kBAAkB;IAK1B;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;IAsB9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAajF,2EAA2E;IACrE,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;cAWpB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIjE,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IAQtC,eAAe,IAAI,iBAAiB;IAiBpC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAI3B,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,0FAA0F;IACpF,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAqBlD,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/C,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9E;;;OAGG;IACY,kBAAkB,IAAI,OAAO,CAAC,OAAO,wBAAwB,EAAE,wBAAwB,CAAC;IAqBvG;;;OAGG;IACY,OAAO,CACpB,IAAI,GAAE,OAAO,wBAAwB,EAAE,qBAA0B,GAChE,OAAO,CAAC,OAAO,wBAAwB,EAAE,aAAa,CAAC;IAwB3C,MAAM,CACnB,IAAI,GAAE,OAAO,wBAAwB,EAAE,oBAAyB,GAC/D,OAAO,CAAC,OAAO,wBAAwB,EAAE,aAAa,CAAC;CAuB3D"}

package/dist/agent-mux-remote-adapter.js

@@ -0,0 +1,283 @@
+/**
+ * AgentMuxRemoteAdapter — pass-through adapter that delegates to another
+ * `amux` CLI installation. Transport is out of scope: this adapter emits
+ * plain `amux run ...` spawn args, and the caller wraps them with the
+ * desired invocation mode (local/docker/ssh/k8s) via
+ * `buildInvocationCommand()`.
+ *
+ * This lets agent-mux nest: a local amux invocation dispatches to a second
+ * amux executing in a docker container, on a remote SSH host, or in a k8s
+ * pod. All structured events are forwarded verbatim — the remote `amux run`
+ * emits JSONL which we pass through unchanged.
+ *
+ * Configuration is read from RunOptions.env:
+ *   AMUX_REMOTE_AGENT  — agent name to invoke on the remote (default: claude)
+ *
+ * The transport-specific bits (host, identity file, docker image, ...) live
+ * on `RunOptions.invocation` — not on this adapter.
+ */
+import { BaseAgentAdapter } from './base-adapter.js';
+export class AgentMuxRemoteAdapter extends BaseAgentAdapter {
+    agent = 'agent-mux-remote';
+    displayName = 'agent-mux (remote via invocation mode)';
+    cliCommand = 'amux';
+    minVersion = '0.1.0';
+    hostEnvSignals = [];
+    capabilities = {
+        agent: 'agent-mux-remote',
+        canResume: true,
+        canFork: false,
+        supportsMultiTurn: true,
+        sessionPersistence: 'none',
+        supportsTextStreaming: true,
+        supportsToolCallStreaming: true,
+        supportsThinkingStreaming: true,
+        supportsNativeTools: true,
+        supportsMCP: false,
+        supportsParallelToolCalls: true,
+        requiresToolApproval: false,
+        approvalModes: ['yolo', 'prompt', 'deny'],
+        supportsThinking: true,
+        thinkingEffortLevels: ['low', 'medium', 'high'],
+        supportsThinkingBudgetTokens: true,
+        supportsJsonMode: true,
+        supportsStructuredOutput: true,
+        supportsSkills: false,
+        supportsAgentsMd: false,
+        skillsFormat: null,
+        supportsSubagentDispatch: true,
+        supportsParallelExecution: true,
+        supportsInteractiveMode: false,
+        supportsStdinInjection: true,
+        supportsImageInput: false,
+        supportsImageOutput: false,
+        supportsFileAttachments: false,
+        supportsPlugins: false,
+        pluginFormats: [],
+        pluginRegistries: [],
+        supportedPlatforms: ['darwin', 'linux', 'win32'],
+        requiresGitRepo: false,
+        requiresPty: false,
+        authMethods: [
+            { type: 'api_key', name: 'Transport', description: 'Handled by invocation mode (local/docker/ssh/k8s).' },
+        ],
+        authFiles: [],
+        installMethods: [
+            { platform: 'all', type: 'manual', command: 'Install amux on the target (see `amux remote install <host>`).' },
+        ],
+    };
+    models = [];
+    defaultModelId = undefined;
+    configSchema = {
+        agent: 'agent-mux-remote',
+        version: 1,
+        fields: [],
+        configFilePaths: [],
+        configFormat: 'json',
+        supportsProjectConfig: false,
+    };
+    /** Resolve the remote agent name (which agent to invoke inside the nested amux). */
+    resolveRemoteAgent(options) {
+        const env = options.env ?? {};
+        return env['AMUX_REMOTE_AGENT'] ?? process.env['AMUX_REMOTE_AGENT'] ?? 'claude';
+    }
+    /**
+     * Emit `amux run --json --agent <agent> --prompt <...>` args.
+     *
+     * The caller is responsible for wrapping these with an invocation mode
+     * (ssh/docker/k8s) via `buildInvocationCommand()`. This keeps the adapter
+     * transport-agnostic so the same binary can be used inside a docker
+     * container, on a remote SSH host, or in a k8s pod.
+     */
+    buildSpawnArgs(options) {
+        const remoteAgent = this.resolveRemoteAgent(options);
+        const prompt = Array.isArray(options.prompt) ? options.prompt.join('\n') : options.prompt;
+        const args = ['run', '--json', '--agent', remoteAgent, '--prompt', prompt];
+        if (options.model)
+            args.push('--model', options.model);
+        if (options.sessionId)
+            args.push('--session', options.sessionId);
+        if (options.approvalMode === 'yolo')
+            args.push('--yolo');
+        if (options.approvalMode === 'deny')
+            args.push('--deny');
+        return {
+            command: this.cliCommand,
+            args,
+            env: this.buildEnvFromOptions(options),
+            cwd: options.cwd ?? process.cwd(),
+            usePty: false,
+            timeout: options.timeout,
+            inactivityTimeout: options.inactivityTimeout,
+        };
+    }
+    parseEvent(line, context) {
+        const parsed = this.parseJsonLine(line);
+        if (parsed == null || typeof parsed !== 'object')
+            return null;
+        const obj = parsed;
+        const event = { ...obj };
+        if (typeof event['runId'] !== 'string')
+            event['runId'] = context.runId;
+        if (typeof event['timestamp'] !== 'number')
+            event['timestamp'] = Date.now();
+        event['agent'] = this.agent;
+        if (typeof event['type'] !== 'string')
+            return null;
+        return event;
+    }
+    /** Detect version via the local spawner running plain `amux --version`. */
+    async detectVersion() {
+        try {
+            const res = await this._spawner('amux', ['--version']);
+            if (res.code !== 0)
+                return null;
+            const match = (res.stdout + '\n' + res.stderr).match(/\d+\.\d+\.\d+(?:-[\w.]+)?/);
+            return match ? match[0] : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async detectVersionFromCli() {
+        return this.detectVersion();
+    }
+    async detectAuth() {
+        return {
+            status: 'authenticated',
+            method: 'transport',
+            identity: 'handled by invocation mode',
+        };
+    }
+    getAuthGuidance() {
+        return {
+            agent: 'agent-mux-remote',
+            providerName: 'agent-mux (remote)',
+            steps: [
+                { step: 1, description: 'Install amux on the target (local, remote SSH host, docker image, or k8s pod).' },
+                { step: 2, description: 'Set RunOptions.invocation to select the transport (ssh/docker/k8s).' },
+                { step: 3, description: 'Optionally set AMUX_REMOTE_AGENT to choose which agent the nested amux invokes.' },
+            ],
+            envVars: [
+                { name: 'AMUX_REMOTE_AGENT', description: 'Agent to invoke on the remote (default: claude)', required: false },
+            ],
+            documentationUrls: [],
+            verifyCommand: 'amux --version',
+        };
+    }
+    sessionDir(_cwd) {
+        return '';
+    }
+    async parseSessionFile(_filePath) {
+        throw new Error('agent-mux-remote does not store sessions locally; use `amux sessions list` on the remote.');
+    }
+    /** List remote sessions via plain `amux sessions list --json` (transport is external). */
+    async listSessionFiles(_cwd) {
+        try {
+            const res = await this._spawner('amux', ['sessions', 'list', '--json']);
+            if (res.code !== 0)
+                return [];
+            const parsed = JSON.parse(res.stdout);
+            const data = Array.isArray(parsed) ? parsed : (parsed?.data ?? []);
+            if (!Array.isArray(data))
+                return [];
+            return data
+                .map((s) => {
+                if (s && typeof s === 'object') {
+                    const sid = s['sessionId'] ?? s['id'];
+                    return typeof sid === 'string' ? sid : null;
+                }
+                return null;
+            })
+                .filter((s) => typeof s === 'string');
+        }
+        catch {
+            return [];
+        }
+    }
+    async readConfig(_cwd) {
+        return { agent: 'agent-mux-remote', source: 'global' };
+    }
+    async writeConfig(_config, _cwd) {
+        /* No local config to write. */
+    }
+    /**
+     * Detect whether `amux` is available at the current spawner scope (local or
+     * wrapped). The wrapper — docker/ssh/k8s — is applied externally.
+     */
+    async detectInstallation() {
+        try {
+            const res = await this._spawner('amux', ['--version']);
+            if (res.code !== 0) {
+                return { installed: false, notes: `amux probe failed (code ${res.code})` };
+            }
+            const version = this.parseVersionOutput(res.stdout + '\n' + res.stderr);
+            const out = {
+                installed: true,
+                path: 'amux',
+            };
+            if (version)
+                out.version = version;
+            return out;
+        }
+        catch (err) {
+            return {
+                installed: false,
+                notes: err instanceof Error ? `amux probe error: ${err.message}` : 'amux probe error',
+            };
+        }
+    }
+    /**
+     * Install amux via `npm install -g @a5c-ai/agent-mux-cli`.
+     * Transport wrapping (ssh/docker/k8s) is the caller's responsibility.
+     */
+    async install(opts = {}) {
+        const command = 'npm install -g @a5c-ai/agent-mux-cli';
+        if (opts.dryRun) {
+            return { ok: true, method: 'npm', command, message: `[dry-run] would execute: ${command}` };
+        }
+        try {
+            const res = await this._spawner('npm', ['install', '-g', '@a5c-ai/agent-mux-cli']);
+            return {
+                ok: res.code === 0,
+                method: 'npm',
+                command,
+                stdout: res.stdout,
+                stderr: res.stderr,
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                method: 'npm',
+                command,
+                stderr: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    async update(opts = {}) {
+        const command = 'npm update -g @a5c-ai/agent-mux-cli';
+        if (opts.dryRun) {
+            return { ok: true, method: 'npm', command, message: `[dry-run] would execute: ${command}` };
+        }
+        try {
+            const res = await this._spawner('npm', ['update', '-g', '@a5c-ai/agent-mux-cli']);
+            return {
+                ok: res.code === 0,
+                method: 'npm',
+                command,
+                stdout: res.stdout,
+                stderr: res.stderr,
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                method: 'npm',
+                command,
+                stderr: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+}
+//# sourceMappingURL=agent-mux-remote-adapter.js.map

package/dist/agent-mux-remote-adapter.js.map

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

package/dist/auth-config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolve a set of candidate paths (supports `~/` prefix) against the user's
+ * home directory and return the first one that exists.
+ */
+export declare function findExistingAuthFile(candidates: string[]): Promise<string | null>;
+/**
+ * Read an agent auth config file (if present) and attempt to extract a
+ * recognizable token/email identity. Returns null if no candidate exists.
+ */
+export declare function readAuthConfigIdentity(candidates: string[], tokenKeys?: string[]): Promise<{
+    filePath: string;
+    identity: string;
+} | null>;
+//# sourceMappingURL=auth-config.d.ts.map

package/dist/auth-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-config.d.ts","sourceRoot":"","sources":["../src/auth-config.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcvF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,GAAE,MAAM,EAAoF,GACpG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAmBxD"}

package/dist/auth-config.js

@@ -0,0 +1,52 @@
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { promises as fsp } from 'node:fs';
+/**
+ * Resolve a set of candidate paths (supports `~/` prefix) against the user's
+ * home directory and return the first one that exists.
+ */
+export async function findExistingAuthFile(candidates) {
+    const home = os.homedir();
+    for (const raw of candidates) {
+        const abs = raw.startsWith('~')
+            ? path.join(home, raw.slice(raw.startsWith('~/') ? 2 : 1))
+            : raw;
+        try {
+            const st = await fsp.stat(abs);
+            if (st.isFile())
+                return abs;
+        }
+        catch {
+            // keep looking
+        }
+    }
+    return null;
+}
+/**
+ * Read an agent auth config file (if present) and attempt to extract a
+ * recognizable token/email identity. Returns null if no candidate exists.
+ */
+export async function readAuthConfigIdentity(candidates, tokenKeys = ['apiKey', 'api_key', 'OPENAI_API_KEY', 'token', 'accessToken', 'access_token']) {
+    const filePath = await findExistingAuthFile(candidates);
+    if (!filePath)
+        return null;
+    let identity = path.basename(filePath);
+    try {
+        const raw = await fsp.readFile(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        for (const k of tokenKeys) {
+            const v = parsed[k];
+            if (typeof v === 'string' && v.length > 4) {
+                identity = `...${v.slice(-4)}`;
+                break;
+            }
+        }
+        if (typeof parsed['email'] === 'string')
+            identity = parsed['email'];
+    }
+    catch {
+        // opaque file; keep the basename identity
+    }
+    return { filePath, identity };
+}
+//# sourceMappingURL=auth-config.js.map

package/dist/auth-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-config.js","sourceRoot":"","sources":["../src/auth-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,IAAI,GAAG,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAoB;IAC7D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAC7B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC,CAAC,GAAG,CAAC;QACR,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,EAAE,CAAC,MAAM,EAAE;gBAAE,OAAO,GAAG,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAAoB,EACpB,YAAsB,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,CAAC;IAErG,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,QAAQ,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,QAAQ;YAAE,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAW,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}