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

package/dist/commands/remote.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `adapters remote install <host>` / `adapters 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:    `adapters --version`            — check if adapters is on the remote.
+ *   2. Install:  `npm install -g @a5c-ai/adapters-cli` if missing (or --force).
+ *   3. Harness:  `adapters install <harness>`    — deploy the desired harness.
+ *   4. Verify:   `adapters detect --all --json`  — confirm the harness is active.
+ */
+import type { AgentMuxClient } from '@a5c-ai/comm-adapter';
+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;
+}
+/**
+ * `adapters remote install <host> [--mode ssh|docker|k8s|local] [--harness <agent>]`
+ * `adapters remote update <host> ...`
+ */
+export declare function remoteCommand(_client: AgentMuxClient, args: ParsedArgs, deps?: RemoteCommandDeps): Promise<number>;

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,sBAAsB,CAAC;AAG9B,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 @@
+/**
+ * `adapters remote install <host>` / `adapters 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:    `adapters --version`            — check if adapters is on the remote.
+ *   2. Install:  `npm install -g @a5c-ai/adapters-cli` if missing (or --force).
+ *   3. Harness:  `adapters install <harness>`    — deploy the desired harness.
+ *   4. Verify:   `adapters detect --all --json`  — confirm the harness is active.
+ */
+import { spawn } from 'node:child_process';
+import { buildInvocationCommand } from '@a5c-ai/comm-adapter';
+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 adapters (or npm) command. */
+function makeSpawnArgs(command, args, cwd) {
+    return { command, args, env: {}, cwd, usePty: false };
+}
+/**
+ * Resolve the InvocationMode for a given CLI invocation of `adapters 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;
+        }
+    }
+}
+/**
+ * `adapters remote install <host> [--mode ssh|docker|k8s|local] [--harness <agent>]`
+ * `adapters 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: adapters 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, 'adapters-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 adapters
+    const probe = await runStep('probe', 'adapters', ['--version']);
+    const needsInstall = sub === 'update' || probe.code !== 0 || force;
+    // Step 2: install adapters itself if missing (or forced / update)
+    if (needsInstall) {
+        const npmVerb = sub === 'update' ? 'update' : 'install';
+        const npm = await runStep('adapters-self', 'npm', [npmVerb, '-g', '@a5c-ai/adapters-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', 'adapters', installArgs);
+    if (!dryRun && hres.code !== 0) {
+        const msg = `adapters ${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', 'adapters', ['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

package/dist/commands/remote.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `adapters run` command implementation.
+ *
+ * @see docs/10-cli-reference.md Section 6
+ */
+import type { AgentMuxClient } from '@a5c-ai/comm-adapter';
+import type { ParsedArgs } from '../parse-args.js';
+import type { FlagDef } from '../parse-args.js';
+/** Run-specific flag definitions. */
+export declare const RUN_FLAGS: Record<string, FlagDef>;
+/**
+ * Validate mutual exclusion rules.
+ * Returns an error message or null if valid.
+ */
+export declare function validateRunFlags(flags: Record<string, string | boolean | string[]>): string | null;
+/**
+ * Build RunOptions from parsed args.
+ */
+export declare function buildRunOptions(args: ParsedArgs, registeredAgents: Set<string>): {
+    agent?: string;
+    prompt?: string;
+    options: Record<string, unknown>;
+};
+/**
+ * Execute the run command.
+ */
+export declare function runCommand(client: AgentMuxClient, args: ParsedArgs): Promise<number>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQhD,qCAAqC;AACrC,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAsC7C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAgBlG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CA+FvE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAyH1F"}

package/dist/commands/run.js

@@ -0,0 +1,355 @@
+/**
+ * `adapters run` command implementation.
+ *
+ * @see docs/10-cli-reference.md Section 6
+ */
+import * as path from 'node:path';
+import { AgentMuxError } from '@a5c-ai/comm-adapter';
+import { flagStr, flagNum, flagBool, flagArr } from '../parse-args.js';
+import { ExitCode, errorCodeToExitCode } from '../exit-codes.js';
+import { printError, printJsonError } from '../output.js';
+import { readStdin } from '../read-stdin.js';
+/** Run-specific flag definitions. */
+export const RUN_FLAGS = {
+    'stream': { type: 'boolean' },
+    'thinking-effort': { type: 'string' },
+    'thinking-budget': { type: 'number' },
+    'temperature': { type: 'number' },
+    'top-p': { type: 'number' },
+    'top-k': { type: 'number' },
+    'thinking-override': { type: 'string' },
+    'max-tokens': { type: 'number' },
+    'max-output-tokens': { type: 'number' },
+    'max-turns': { type: 'number' },
+    'session': { type: 'string' },
+    'fork': { type: 'string' },
+    'no-session': { type: 'boolean' },
+    'system': { type: 'string' },
+    'system-mode': { type: 'string' },
+    'cwd': { type: 'string' },
+    'env': { type: 'string', repeatable: true },
+    'yolo': { type: 'boolean' },
+    'deny': { type: 'boolean' },
+    'timeout': { type: 'number' },
+    'inactivity-timeout': { type: 'number' },
+    'output-format': { type: 'string' },
+    'tag': { type: 'string', repeatable: true },
+    'run-id': { type: 'string' },
+    'attach': { type: 'string', repeatable: true },
+    'skill': { type: 'string', repeatable: true },
+    'agents-doc': { type: 'string' },
+    'mcp-server': { type: 'string', repeatable: true },
+    'project-id': { type: 'string' },
+    'profile': { type: 'string' },
+    'prompt': { short: 'p', type: 'string' },
+    'non-interactive': { type: 'boolean' },
+    'interactive': { short: 'i', type: 'boolean' },
+    'quiet': { short: 'q', type: 'boolean' },
+    'no-stream': { type: 'boolean' },
+    'use-mock-harness': { type: 'boolean' },
+    'mock-scenario': { type: 'string' },
+};
+/**
+ * Validate mutual exclusion rules.
+ * Returns an error message or null if valid.
+ */
+export function validateRunFlags(flags) {
+    const session = flagBool(flags, 'session') !== undefined || flagStr(flags, 'session') !== undefined;
+    const noSession = flagBool(flags, 'no-session') === true;
+    const fork = flagStr(flags, 'fork') !== undefined;
+    const yolo = flagBool(flags, 'yolo') === true;
+    const deny = flagBool(flags, 'deny') === true;
+    const stream = flagBool(flags, 'stream') === true;
+    const noStream = flagBool(flags, 'no-stream') === true;
+    if (session && noSession)
+        return 'Cannot use --session with --no-session';
+    if (session && fork)
+        return 'Cannot use --session with --fork';
+    if (fork && noSession)
+        return 'Cannot use --fork with --no-session';
+    if (yolo && deny)
+        return 'Cannot use --yolo with --deny';
+    if (stream && noStream)
+        return 'Cannot use --stream with --no-stream';
+    return null;
+}
+/**
+ * Build RunOptions from parsed args.
+ */
+export function buildRunOptions(args, registeredAgents) {
+    const { flags, positionals } = args;
+    const interactiveFlag = flagBool(flags, 'interactive') === true;
+    // Resolve agent and prompt from flags/positionals.
+    let agent = flagStr(flags, 'agent');
+    const promptFlag = flagStr(flags, 'prompt');
+    let prompt = promptFlag;
+    if (positionals.length >= 1) {
+        const positionalAgent = !agent && registeredAgents.has(positionals[0]);
+        if (positionalAgent) {
+            agent = positionals[0];
+        }
+        if (prompt === undefined) {
+            prompt = positionalAgent ? positionals.slice(1).join(' ') || undefined : positionals.join(' ');
+        }
+    }
+    // Parse --env KEY=VALUE pairs
+    const envArr = flagArr(flags, 'env');
+    const env = {};
+    for (const entry of envArr) {
+        const eqIdx = entry.indexOf('=');
+        if (eqIdx !== -1) {
+            env[entry.slice(0, eqIdx)] = entry.slice(eqIdx + 1);
+        }
+    }
+    // Determine approval mode
+    let approvalMode;
+    if (flagBool(flags, 'yolo'))
+        approvalMode = 'yolo';
+    else if (flagBool(flags, 'deny'))
+        approvalMode = 'deny';
+    // Determine stream mode
+    let stream;
+    if (flagBool(flags, 'stream') === true)
+        stream = true;
+    if (flagBool(flags, 'no-stream') === true)
+        stream = false;
+    // Parse thinking override
+    let thinkingOverride;
+    const toStr = flagStr(flags, 'thinking-override');
+    if (toStr) {
+        try {
+            thinkingOverride = JSON.parse(toStr);
+        }
+        catch {
+            // Will be caught by validation
+        }
+    }
+    const maxOutputTokens = flagNum(flags, 'max-output-tokens') ?? flagNum(flags, 'max-tokens');
+    const options = {
+        agent,
+        prompt,
+        model: flagStr(flags, 'model'),
+        stream,
+        thinkingEffort: flagStr(flags, 'thinking-effort'),
+        thinkingBudgetTokens: flagNum(flags, 'thinking-budget'),
+        thinkingOverride,
+        temperature: flagNum(flags, 'temperature'),
+        topP: flagNum(flags, 'top-p'),
+        topK: flagNum(flags, 'top-k'),
+        maxOutputTokens,
+        maxTurns: flagNum(flags, 'max-turns'),
+        sessionId: flagStr(flags, 'session'),
+        forkSessionId: flagStr(flags, 'fork'),
+        noSession: flagBool(flags, 'no-session'),
+        systemPrompt: flagStr(flags, 'system'),
+        systemPromptMode: flagStr(flags, 'system-mode'),
+        cwd: flagStr(flags, 'cwd'),
+        env: Object.keys(env).length > 0 ? env : undefined,
+        approvalMode,
+        timeout: flagNum(flags, 'timeout'),
+        inactivityTimeout: flagNum(flags, 'inactivity-timeout'),
+        outputFormat: flagStr(flags, 'output-format'),
+        tags: flagArr(flags, 'tag').length > 0 ? flagArr(flags, 'tag') : undefined,
+        runId: flagStr(flags, 'run-id'),
+        skills: flagArr(flags, 'skill').length > 0 ? flagArr(flags, 'skill') : undefined,
+        agentsDoc: flagStr(flags, 'agents-doc'),
+        projectId: flagStr(flags, 'project-id'),
+        profile: flagStr(flags, 'profile'),
+        nonInteractive: flagBool(flags, 'non-interactive') === true && promptFlag !== undefined && !interactiveFlag ? true : undefined,
+        interactive: interactiveFlag ? true : undefined,
+    };
+    // Remove undefined entries
+    for (const key of Object.keys(options)) {
+        if (options[key] === undefined) {
+            delete options[key];
+        }
+    }
+    return { agent, prompt, options };
+}
+/**
+ * Execute the run command.
+ */
+export async function runCommand(client, args) {
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    const interactiveFlag = flagBool(args.flags, 'interactive') === true;
+    // Validate mutual exclusions
+    const exclusionError = validateRunFlags(args.flags);
+    if (exclusionError) {
+        if (jsonMode) {
+            printJsonError('VALIDATION_ERROR', exclusionError);
+        }
+        else {
+            printError(exclusionError);
+        }
+        return ExitCode.USAGE_ERROR;
+    }
+    // Get registered agents for positional resolution
+    const adapters = client.adapters.list();
+    const agentNames = new Set(adapters.map((a) => a.agent));
+    const { agent, prompt, options } = buildRunOptions(args, agentNames);
+    const explicitPrompt = prompt ?? options['prompt'];
+    const stdinPrompt = explicitPrompt === undefined && process.stdin.isTTY === false
+        ? await readStdin()
+        : undefined;
+    const resolvedPrompt = explicitPrompt
+        ?? (stdinPrompt && stdinPrompt.trim() ? stdinPrompt : undefined)
+        ?? (interactiveFlag ? ' ' : undefined);
+    if (!agent && !options['agent']) {
+        if (jsonMode) {
+            printJsonError('VALIDATION_ERROR', 'No agent specified. Use --agent or provide agent as first argument.');
+        }
+        else {
+            printError('No agent specified. Use --agent or provide agent as first argument.');
+        }
+        return ExitCode.USAGE_ERROR;
+    }
+    const effectiveAgent = agent ?? options['agent'];
+    const adapterRegistry = client.adapters;
+    const selectedAdapter = effectiveAgent && typeof adapterRegistry.get === 'function'
+        ? adapterRegistry.get(effectiveAgent)
+        : undefined;
+    // Interactive mode is now supported via PTY spawn in spawn-runner.
+    // Pass it through to RunOptions so the spawn layer uses node-pty.
+    if (!resolvedPrompt) {
+        if (jsonMode) {
+            printJsonError('VALIDATION_ERROR', 'No prompt specified. Provide a prompt argument or pipe via stdin.');
+        }
+        else {
+            printError('No prompt specified. Provide a prompt argument or pipe via stdin.');
+        }
+        return ExitCode.USAGE_ERROR;
+    }
+    const useMock = flagBool(args.flags, 'use-mock-harness') === true ||
+        process.env['USE_MOCK_HARNESS'] === '1' ||
+        process.env['USE_MOCK_HARNESS'] === 'true';
+    const mockScenario = flagStr(args.flags, 'mock-scenario');
+    if (useMock) {
+        const effectiveAgent = agent ?? options['agent'];
+        if (effectiveAgent) {
+            swapInMockAdapter(client, effectiveAgent, mockScenario);
+        }
+    }
+    try {
+        let runOpts = {
+            agent: effectiveAgent,
+            prompt: resolvedPrompt,
+            ...options,
+        };
+        if (typeof runOpts.profile === 'string' && runOpts.profile.length > 0) {
+            runOpts = await client.profiles.apply(runOpts.profile, runOpts);
+        }
+        const handle = client.run(runOpts);
+        // If we get here, stream events
+        if (jsonMode) {
+            // JSONL mode
+            for await (const event of handle) {
+                process.stdout.write(JSON.stringify(event) + '\n');
+            }
+        }
+        else {
+            for await (const event of handle) {
+                if (event.type === 'text_delta') {
+                    process.stdout.write(event.delta);
+                }
+            }
+        }
+        const result = await handle.result();
+        if (jsonMode) {
+            process.stdout.write(JSON.stringify({ type: 'run_result', ...result }) + '\n');
+        }
+        return runResultToExitCode(result);
+    }
+    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;
+    }
+}
+function runResultToExitCode(result) {
+    if (result.exitReason === 'completed') {
+        return ExitCode.SUCCESS;
+    }
+    if (result.error?.code) {
+        return errorCodeToExitCode(result.error.code);
+    }
+    switch (result.exitReason) {
+        case 'timeout':
+        case 'inactivity':
+            return ExitCode.TIMEOUT;
+        case 'aborted':
+        case 'interrupted':
+            return ExitCode.ABORTED;
+        case 'crashed':
+        case 'killed':
+            return ExitCode.AGENT_CRASHED;
+        default:
+            return ExitCode.GENERAL_ERROR;
+    }
+}
+const MOCK_SCENARIO_ALIASES = {
+    'claude-basic': 'claude:basic-text',
+    'codex-basic': 'codex:basic-text',
+    'gemini-basic': 'gemini:basic-text',
+    'copilot-basic': 'copilot:basic-text',
+    'cursor-basic': 'cursor:basic-text',
+    'opencode-basic': 'opencode:basic-text',
+    'pi-basic': 'pi:basic-text',
+    'omp-basic': 'omp:basic-text',
+    'openclaw-basic': 'openclaw:basic-text',
+    'hermes-basic': 'hermes:basic-text',
+};
+function resolveMockScenarioName(agent, scenario) {
+    const requested = scenario ?? `${agent}-basic`;
+    return MOCK_SCENARIO_ALIASES[requested] ?? requested;
+}
+/**
+ * Replace the target agent's registered adapter with a wrapper whose
+ * `buildSpawnArgs` redirects the spawn to the `mock-harness` binary.
+ * Enables `--use-mock-harness` / `USE_MOCK_HARNESS=1` for offline E2E.
+ *
+ * The scenario name defaults to `<agent>-basic` (resolved by the mock's
+ * scenario registry at runtime); override with `--mock-scenario <name>`.
+ */
+function swapInMockAdapter(client, agent, scenario) {
+    const original = client.adapters.get(agent);
+    if (!original)
+        return;
+    const mockBin = process.env['AGENT_MUX_MOCK_HARNESS_BIN'] ?? 'mock-harness';
+    const scenarioName = resolveMockScenarioName(agent, scenario);
+    const mockExt = path.extname(mockBin).toLowerCase();
+    const launchWithNode = ['.js', '.mjs', '.cjs'].includes(mockExt);
+    const wrapped = Object.create(original);
+    wrapped.buildSpawnArgs = function mockBuildSpawnArgs(options) {
+        const real = original.buildSpawnArgs(options);
+        return {
+            ...real,
+            command: launchWithNode ? process.execPath : mockBin,
+            args: launchWithNode
+                ? [mockBin, '--scenario', scenarioName, '--agent', agent]
+                : ['--scenario', scenarioName, '--agent', agent],
+            usePty: false,
+        };
+    };
+    const registry = client.adapters;
+    if (typeof registry.unregister === 'function') {
+        registry.unregister(agent);
+    }
+    if (typeof registry.register === 'function') {
+        registry.register(wrapped);
+    }
+}
+//# sourceMappingURL=run.js.map