@a5c-ai/agent-mux-adapters 0.3.0 → 0.4.0

package/dist/amp-adapter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Adapter for Sourcegraph Amp CLI.
+ *
+ * Amp is Sourcegraph's agentic coding assistant with multi-model support,
+ * specialized subagents (Oracle, Librarian), and advanced code understanding.
+ */
+import { BaseAgentAdapter } from './base-adapter.js';
+import type { AgentCapabilities, ModelCapabilities, AuthState, AuthSetupGuidance, Session, RunOptions, SpawnArgs, ParseContext, AgentEvent, InstalledPlugin, PluginInstallOptions, AgentConfig } from '@a5c-ai/agent-mux-core';
+export declare class AmpAdapter extends BaseAgentAdapter {
+    readonly agent: "amp";
+    readonly displayName = "Sourcegraph Amp";
+    readonly cliCommand = "amp";
+    readonly minVersion = "2.0.0";
+    readonly hostEnvSignals: string[];
+    readonly capabilities: AgentCapabilities;
+    readonly models: ModelCapabilities[];
+    readonly defaultModelId = "amp-oracle";
+    buildSpawnArgs(options: RunOptions): SpawnArgs;
+    parseEvent(line: string, context: ParseContext): AgentEvent | AgentEvent[] | null;
+    sessionDir(_cwd?: string): string;
+    parseSessionFile(filePath: string): Promise<Session>;
+    listSessionFiles(_cwd?: string): Promise<string[]>;
+    detectAuth(): Promise<AuthState>;
+    getAuthGuidance(): AuthSetupGuidance;
+    readConfig(_cwd?: string): Promise<AgentConfig>;
+    writeConfig(config: Partial<AgentConfig>, _cwd?: string): Promise<void>;
+    listPlugins(): Promise<InstalledPlugin[]>;
+    installPlugin(_pluginId: string, _options?: PluginInstallOptions): Promise<InstalledPlugin>;
+    uninstallPlugin(_pluginId: string): Promise<void>;
+}
+//# sourceMappingURL=amp-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"amp-adapter.d.ts","sourceRoot":"","sources":["../src/amp-adapter.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAUhC,qBAAa,UAAW,SAAQ,gBAAgB;IAC9C,QAAQ,CAAC,KAAK,EAAG,KAAK,CAAU;IAChC,QAAQ,CAAC,WAAW,qBAAqB;IACzC,QAAQ,CAAC,UAAU,SAAS;IAC5B,QAAQ,CAAC,UAAU,WAAW;IAC9B,QAAQ,CAAC,cAAc,WAAmD;IAE1E,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAgDtC;IAEF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAoDlC;IAEF,QAAQ,CAAC,cAAc,gBAAgB;IAEvC,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;IAyD9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IA0FjF,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAI3B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpD,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIlD,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IAYtC,eAAe,IAAI,iBAAiB;IAwC9B,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAM/C,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvE,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAKzC,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,OAAO,CAAC,eAAe,CAAC;IAIrB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxD"}

package/dist/amp-adapter.js

@@ -0,0 +1,336 @@
+// @ts-nocheck -- TODO(amp-adapter): align with current ModelCapabilities/AgentEvent types
+/**
+ * Adapter for Sourcegraph Amp CLI.
+ *
+ * Amp is Sourcegraph's agentic coding assistant with multi-model support,
+ * specialized subagents (Oracle, Librarian), and advanced code understanding.
+ */
+import { BaseAgentAdapter } from './base-adapter.js';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { listJsonlFiles, parseJsonlSessionFile, readJsonFile, writeJsonFileAtomic, } from './session-fs.js';
+export class AmpAdapter extends BaseAgentAdapter {
+    agent = 'amp';
+    displayName = 'Sourcegraph Amp';
+    cliCommand = 'amp';
+    minVersion = '2.0.0';
+    hostEnvSignals = ['SOURCEGRAPH_ACCESS_TOKEN', 'AMP_CONFIG_PATH'];
+    capabilities = {
+        agent: 'amp',
+        canResume: true,
+        canFork: true,
+        supportsMultiTurn: true,
+        sessionPersistence: 'file',
+        supportsTextStreaming: true,
+        supportsToolCallStreaming: true,
+        supportsNativeTools: true,
+        supportsMCP: true,
+        supportsSubagentDispatch: true,
+        supportsParallelExecution: true,
+        maxParallelTasks: 8,
+        requiresToolApproval: true,
+        approvalModes: ['yolo', 'prompt'],
+        supportedPlatforms: ['darwin', 'linux', 'win32'],
+        requiresGitRepo: false,
+        requiresPty: false,
+        authMethods: [
+            {
+                type: 'api_key',
+                name: 'Sourcegraph Access Token',
+                description: 'SOURCEGRAPH_ACCESS_TOKEN environment variable',
+            },
+            {
+                type: 'browser_login',
+                name: 'Sourcegraph OAuth',
+                description: 'Interactive browser-based login',
+            },
+        ],
+        installMethods: [
+            {
+                platform: 'all',
+                type: 'npm',
+                command: 'npm install -g @sourcegraph/amp-cli',
+            },
+            {
+                platform: 'unix',
+                type: 'curl',
+                command: 'curl -fsSL https://get.sourcegraph.com/amp | bash',
+            },
+            {
+                platform: 'all',
+                type: 'manual',
+                description: 'Download from GitHub Releases',
+                url: 'https://github.com/sourcegraph/amp/releases',
+            },
+        ],
+    };
+    models = [
+        {
+            agent: 'amp',
+            modelId: 'claude-3-5-sonnet-20241022',
+            displayName: 'Claude 3.5 Sonnet',
+            modelAlias: 'claude-sonnet',
+            deprecated: false,
+            contextWindow: 200000,
+            maxOutputTokens: 8192,
+            inputPricePerMillion: 3.0,
+            outputPricePerMillion: 15.0,
+            supportsToolCalling: true,
+            supportsParallelToolCalls: true,
+        },
+        {
+            agent: 'amp',
+            modelId: 'gpt-4o',
+            displayName: 'GPT-4o',
+            modelAlias: 'gpt-4o',
+            deprecated: false,
+            contextWindow: 128000,
+            maxOutputTokens: 4096,
+            inputPricePerMillion: 5.0,
+            outputPricePerMillion: 15.0,
+            supportsToolCalling: true,
+            supportsParallelToolCalls: true,
+        },
+        {
+            agent: 'amp',
+            modelId: 'amp-oracle',
+            displayName: 'Amp Oracle (Multi-Model)',
+            modelAlias: 'oracle',
+            deprecated: false,
+            contextWindow: 200000,
+            maxOutputTokens: 8192,
+            description: 'Multi-model routing with specialized subagents',
+            supportsToolCalling: true,
+            supportsParallelToolCalls: true,
+        },
+        {
+            agent: 'amp',
+            modelId: 'gemini-1.5-pro',
+            displayName: 'Gemini 1.5 Pro',
+            modelAlias: 'gemini-pro',
+            deprecated: false,
+            contextWindow: 2000000,
+            maxOutputTokens: 8192,
+            inputPricePerMillion: 1.25,
+            outputPricePerMillion: 5.0,
+            supportsToolCalling: true,
+            supportsParallelToolCalls: true,
+        },
+    ];
+    defaultModelId = 'amp-oracle';
+    buildSpawnArgs(options) {
+        const args = [];
+        // Command selection
+        if (options.sessionId) {
+            args.push('resume', options.sessionId);
+        }
+        else {
+            args.push('chat');
+        }
+        // Output format
+        args.push('--output', 'jsonl');
+        args.push('--stream');
+        // Model selection
+        if (options.model) {
+            args.push('--model', options.model);
+        }
+        // System prompt
+        if (options.systemPrompt) {
+            args.push('--system', options.systemPrompt);
+        }
+        // Tool approval mode
+        if (options.approvalMode === 'yolo') {
+            args.push('--auto-approve');
+        }
+        // Max turns
+        if (options.maxTurns) {
+            args.push('--max-turns', String(options.maxTurns));
+        }
+        // Working directory
+        if (options.cwd) {
+            args.push('--cwd', options.cwd);
+        }
+        const { prompt, stdin } = this.buildPromptTransport(options);
+        if (stdin === undefined) {
+            args.push('--headless');
+            args.push('--prompt', prompt);
+        }
+        return {
+            command: this.cliCommand,
+            args,
+            cwd: options.cwd,
+            env: {
+                ...process.env,
+                ...options.env,
+            },
+            stdin,
+        };
+    }
+    parseEvent(line, context) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return null;
+        try {
+            const parsed = JSON.parse(trimmed);
+            const baseEvent = {
+                agent: this.agent,
+                runId: context.runId,
+                timestamp: Date.now(),
+            };
+            switch (parsed.type) {
+                case 'session_start':
+                    return {
+                        type: 'session_start',
+                        ...baseEvent,
+                        sessionId: parsed.sessionId,
+                        turnCount: 0,
+                        resumed: false,
+                    };
+                case 'text_delta':
+                    return {
+                        type: 'text_delta',
+                        ...baseEvent,
+                        delta: parsed.content || parsed.delta,
+                        accumulated: parsed.accumulated,
+                    };
+                case 'tool_call_start':
+                    return {
+                        type: 'tool_call_start',
+                        ...baseEvent,
+                        toolCallId: parsed.id,
+                        toolName: parsed.tool || parsed.name,
+                        arguments: parsed.arguments || parsed.args,
+                    };
+                case 'tool_result':
+                    return {
+                        type: 'tool_result',
+                        ...baseEvent,
+                        toolCallId: parsed.id,
+                        toolName: parsed.tool || parsed.name,
+                        output: parsed.result || parsed.output,
+                        durationMs: parsed.duration || parsed.durationMs,
+                    };
+                case 'cost':
+                    return {
+                        type: 'cost',
+                        ...baseEvent,
+                        cost: {
+                            totalUsd: parsed.totalUsd || parsed.total,
+                            inputTokens: parsed.inputTokens || parsed.input || 0,
+                            outputTokens: parsed.outputTokens || parsed.output || 0,
+                            thinkingTokens: parsed.thinkingTokens || 0,
+                            cacheReadTokens: parsed.cacheReadTokens,
+                            cacheCreationTokens: parsed.cacheCreationTokens,
+                        },
+                    };
+                case 'error':
+                    return {
+                        type: 'error',
+                        ...baseEvent,
+                        code: parsed.code,
+                        message: parsed.message,
+                        recoverable: parsed.recoverable ?? true,
+                        fatal: parsed.fatal ?? false,
+                    };
+                case 'session_end':
+                    return {
+                        type: 'session_end',
+                        ...baseEvent,
+                        sessionId: parsed.sessionId,
+                        reason: parsed.reason,
+                        finalTurnCount: parsed.turnCount || parsed.turns,
+                    };
+                default:
+                    return null;
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    sessionDir(_cwd) {
+        return join(homedir(), '.config', 'amp', 'sessions');
+    }
+    async parseSessionFile(filePath) {
+        const parsed = await parseJsonlSessionFile(filePath, 'amp');
+        return { ...parsed, agent: 'amp', title: parsed.sessionId };
+    }
+    async listSessionFiles(_cwd) {
+        return listJsonlFiles(this.sessionDir());
+    }
+    async detectAuth() {
+        const token = process.env['SOURCEGRAPH_ACCESS_TOKEN'];
+        if (token) {
+            return {
+                status: 'authenticated',
+                method: 'api_key',
+                identity: `token-...${token.slice(-4)}`,
+            };
+        }
+        return { status: 'unauthenticated' };
+    }
+    getAuthGuidance() {
+        return {
+            agent: 'amp',
+            providerName: 'Sourcegraph Amp',
+            steps: [
+                {
+                    step: 1,
+                    description: 'Sign up for a Sourcegraph account at sourcegraph.com',
+                    url: 'https://sourcegraph.com/sign-up',
+                },
+                {
+                    step: 2,
+                    description: 'Install the Amp CLI',
+                    command: 'npm install -g @sourcegraph/amp-cli',
+                },
+                {
+                    step: 3,
+                    description: 'Generate an access token in Sourcegraph settings',
+                    url: 'https://sourcegraph.com/users/settings/tokens',
+                },
+                {
+                    step: 4,
+                    description: 'Authenticate with Sourcegraph',
+                    command: 'amp auth login',
+                },
+            ],
+            envVars: [
+                {
+                    name: 'SOURCEGRAPH_ACCESS_TOKEN',
+                    description: 'Sourcegraph access token for API authentication',
+                    required: false,
+                    exampleFormat: 'sgp_...',
+                },
+            ],
+            documentationUrls: ['https://docs.sourcegraph.com/amp'],
+            loginCommand: 'amp auth login',
+            verifyCommand: 'amp --version',
+        };
+    }
+    async readConfig(_cwd) {
+        const configPath = join(homedir(), '.config', 'amp', 'config.json');
+        const data = (await readJsonFile(configPath)) ?? {};
+        return { agent: 'amp', source: 'global', filePaths: [configPath], ...data };
+    }
+    async writeConfig(config, _cwd) {
+        const configPath = join(homedir(), '.config', 'amp', 'config.json');
+        const existing = (await readJsonFile(configPath)) ?? {};
+        const { agent: _a, source: _s, filePaths: _fp, ...rest } = config;
+        void _a;
+        void _s;
+        void _fp;
+        await writeJsonFileAtomic(configPath, { ...existing, ...rest });
+    }
+    async listPlugins() {
+        // Amp doesn't have native plugin support in the same way Claude does
+        return [];
+    }
+    async installPlugin(_pluginId, _options) {
+        throw new Error('Amp does not support plugin installation via agent-mux');
+    }
+    async uninstallPlugin(_pluginId) {
+        throw new Error('Amp does not support plugin uninstallation via agent-mux');
+    }
+}
+//# sourceMappingURL=amp-adapter.js.map

package/dist/amp-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amp-adapter.js","sourceRoot":"","sources":["../src/amp-adapter.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAerD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,OAAO,UAAW,SAAQ,gBAAgB;IACrC,KAAK,GAAG,KAAc,CAAC;IACvB,WAAW,GAAG,iBAAiB,CAAC;IAChC,UAAU,GAAG,KAAK,CAAC;IACnB,UAAU,GAAG,OAAO,CAAC;IACrB,cAAc,GAAG,CAAC,0BAA0B,EAAE,iBAAiB,CAAC,CAAC;IAEjE,YAAY,GAAsB;QACzC,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,IAAI;QACf,OAAO,EAAE,IAAI;QACb,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,MAAM;QAC1B,qBAAqB,EAAE,IAAI;QAC3B,yBAAyB,EAAE,IAAI;QAC/B,mBAAmB,EAAE,IAAI;QACzB,WAAW,EAAE,IAAI;QACjB,wBAAwB,EAAE,IAAI;QAC9B,yBAAyB,EAAE,IAAI;QAC/B,gBAAgB,EAAE,CAAC;QACnB,oBAAoB,EAAE,IAAI;QAC1B,aAAa,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;QACjC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC;QAChD,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE;YACX;gBACE,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,0BAA0B;gBAChC,WAAW,EAAE,+CAA+C;aAC7D;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,iCAAiC;aAC/C;SACF;QACD,cAAc,EAAE;YACd;gBACE,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,qCAAqC;aAC/C;YACD;gBACE,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,mDAAmD;aAC7D;YACD;gBACE,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;gBAC5C,GAAG,EAAE,6CAA6C;aACnD;SACF;KACF,CAAC;IAEO,MAAM,GAAwB;QACrC;YACE,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,4BAA4B;YACrC,WAAW,EAAE,mBAAmB;YAChC,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,MAAM;YACrB,eAAe,EAAE,IAAI;YACrB,oBAAoB,EAAE,GAAG;YACzB,qBAAqB,EAAE,IAAI;YAC3B,mBAAmB,EAAE,IAAI;YACzB,yBAAyB,EAAE,IAAI;SAChC;QACD;YACE,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,MAAM;YACrB,eAAe,EAAE,IAAI;YACrB,oBAAoB,EAAE,GAAG;YACzB,qBAAqB,EAAE,IAAI;YAC3B,mBAAmB,EAAE,IAAI;YACzB,yBAAyB,EAAE,IAAI;SAChC;QACD;YACE,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,YAAY;YACrB,WAAW,EAAE,0BAA0B;YACvC,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,MAAM;YACrB,eAAe,EAAE,IAAI;YACrB,WAAW,EAAE,gDAAgD;YAC7D,mBAAmB,EAAE,IAAI;YACzB,yBAAyB,EAAE,IAAI;SAChC;QACD;YACE,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,gBAAgB;YACzB,WAAW,EAAE,gBAAgB;YAC7B,UAAU,EAAE,YAAY;YACxB,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,OAAO;YACtB,eAAe,EAAE,IAAI;YACrB,oBAAoB,EAAE,IAAI;YAC1B,qBAAqB,EAAE,GAAG;YAC1B,mBAAmB,EAAE,IAAI;YACzB,yBAAyB,EAAE,IAAI;SAChC;KACF,CAAC;IAEO,cAAc,GAAG,YAAY,CAAC;IAEvC,cAAc,CAAC,OAAmB;QAChC,MAAM,IAAI,GAAa,EAAE,CAAC;QAE1B,oBAAoB;QACpB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QAED,gBAAgB;QAChB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEtB,kBAAkB;QAClB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,gBAAgB;QAChB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC9B,CAAC;QAED,YAAY;QACZ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,oBAAoB;QACpB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,UAAU;YACxB,IAAI;YACJ,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,GAAG,OAAO,CAAC,GAAG;aACf;YACD,KAAK;SACN,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,OAAqB;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG;gBAChB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,eAAe;oBAClB,OAAO;wBACL,IAAI,EAAE,eAAwB;wBAC9B,GAAG,SAAS;wBACZ,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,SAAS,EAAE,CAAC;wBACZ,OAAO,EAAE,KAAK;qBACf,CAAC;gBAEJ,KAAK,YAAY;oBACf,OAAO;wBACL,IAAI,EAAE,YAAqB;wBAC3B,GAAG,SAAS;wBACZ,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK;wBACrC,WAAW,EAAE,MAAM,CAAC,WAAW;qBAChC,CAAC;gBAEJ,KAAK,iBAAiB;oBACpB,OAAO;wBACL,IAAI,EAAE,iBAA0B;wBAChC,GAAG,SAAS;wBACZ,UAAU,EAAE,MAAM,CAAC,EAAE;wBACrB,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;wBACpC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI;qBAC3C,CAAC;gBAEJ,KAAK,aAAa;oBAChB,OAAO;wBACL,IAAI,EAAE,aAAsB;wBAC5B,GAAG,SAAS;wBACZ,UAAU,EAAE,MAAM,CAAC,EAAE;wBACrB,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI;wBACpC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM;wBACtC,UAAU,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU;qBACjD,CAAC;gBAEJ,KAAK,MAAM;oBACT,OAAO;wBACL,IAAI,EAAE,MAAe;wBACrB,GAAG,SAAS;wBACZ,IAAI,EAAE;4BACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK;4BACzC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC;4BACpD,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;4BACvD,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,CAAC;4BAC1C,eAAe,EAAE,MAAM,CAAC,eAAe;4BACvC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;yBAChD;qBACF,CAAC;gBAEJ,KAAK,OAAO;oBACV,OAAO;wBACL,IAAI,EAAE,OAAgB;wBACtB,GAAG,SAAS;wBACZ,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,IAAI;wBACvC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;qBAC7B,CAAC;gBAEJ,KAAK,aAAa;oBAChB,OAAO;wBACL,IAAI,EAAE,aAAsB;wBAC5B,GAAG,SAAS;wBACZ,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,cAAc,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK;qBACjD,CAAC;gBAEJ;oBACE,OAAO,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAa;QACtB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QACrC,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAa;QAClC,OAAO,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACtD,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,MAAM,EAAE,eAAe;gBACvB,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,YAAY,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;aACxC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACvC,CAAC;IAED,eAAe;QACb,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,iBAAiB;YAC/B,KAAK,EAAE;gBACL;oBACE,IAAI,EAAE,CAAC;oBACP,WAAW,EAAE,sDAAsD;oBACnE,GAAG,EAAE,iCAAiC;iBACvC;gBACD;oBACE,IAAI,EAAE,CAAC;oBACP,WAAW,EAAE,qBAAqB;oBAClC,OAAO,EAAE,qCAAqC;iBAC/C;gBACD;oBACE,IAAI,EAAE,CAAC;oBACP,WAAW,EAAE,kDAAkD;oBAC/D,GAAG,EAAE,+CAA+C;iBACrD;gBACD;oBACE,IAAI,EAAE,CAAC;oBACP,WAAW,EAAE,+BAA+B;oBAC5C,OAAO,EAAE,gBAAgB;iBAC1B;aACF;YACD,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,0BAA0B;oBAChC,WAAW,EAAE,iDAAiD;oBAC9D,QAAQ,EAAE,KAAK;oBACf,aAAa,EAAE,SAAS;iBACzB;aACF;YACD,iBAAiB,EAAE,CAAC,kCAAkC,CAAC;YACvD,YAAY,EAAE,gBAAgB;YAC9B,aAAa,EAAE,eAAe;SAC/B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAa;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,CAAC,MAAM,YAAY,CAA0B,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAA4B,EAAE,IAAa;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,CAAC,MAAM,YAAY,CAA0B,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QACjF,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAiC,CAAC;QAC7F,KAAK,EAAE,CAAC;QAAC,KAAK,EAAE,CAAC;QAAC,KAAK,GAAG,CAAC;QAC3B,MAAM,mBAAmB,CAAC,UAAU,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,WAAW;QACf,qEAAqE;QACrE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,SAAiB,EACjB,QAA+B;QAE/B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,SAAiB;QACrC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/base-adapter-helpers.d.ts

@@ -0,0 +1,8 @@
+import type { CostRecord, Spawner } from '@a5c-ai/agent-mux-core';
+/**
+ * Default Spawner that runs the command via `child_process.spawn`, capturing
+ * stdout/stderr. `shell: false`, `windowsHide: true`.
+ */
+export declare const defaultSpawner: Spawner;
+export declare function assembleCostRecord(raw: unknown): CostRecord | null;
+//# sourceMappingURL=base-adapter-helpers.d.ts.map

package/dist/base-adapter-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter-helpers.d.ts","sourceRoot":"","sources":["../src/base-adapter-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,OAiBzB,CAAC;AAEL,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CA2BlE"}

package/dist/base-adapter-helpers.js

@@ -0,0 +1,68 @@
+import { spawn } from 'node:child_process';
+/**
+ * Default Spawner that runs the command via `child_process.spawn`, capturing
+ * stdout/stderr. `shell: false`, `windowsHide: true`.
+ */
+export const defaultSpawner = (command, args, options) => new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: false,
+        windowsHide: true,
+        env: options?.env ? { ...process.env, ...options.env } : process.env,
+        cwd: options?.cwd,
+    });
+    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 }));
+});
+export function assembleCostRecord(raw) {
+    if (raw == null || typeof raw !== 'object')
+        return null;
+    const obj = raw;
+    const totalUsd = extractNumber(obj, ['totalUsd', 'total_usd', 'cost', 'total_cost', 'totalCost']) ?? 0;
+    const inputTokens = extractNumber(obj, ['inputTokens', 'input_tokens', 'prompt_tokens']) ?? 0;
+    const outputTokens = extractNumber(obj, ['outputTokens', 'output_tokens', 'completion_tokens']) ?? 0;
+    const thinkingTokens = extractNumber(obj, ['thinkingTokens', 'thinking_tokens', 'reasoning_tokens']);
+    const cacheCreationTokens = extractNumber(obj, ['cacheCreationTokens', 'cache_creation_tokens', 'cache_write_tokens']);
+    const cacheReadTokens = extractNumber(obj, ['cacheReadTokens', 'cache_read_tokens', 'cache_read_input_tokens']);
+    const cachedTokens = extractNumber(obj, ['cachedTokens', 'cached_tokens']) ??
+        ((cacheCreationTokens != null && cacheReadTokens != null) ? cacheCreationTokens + cacheReadTokens : undefined);
+    if (totalUsd === 0 && inputTokens === 0 && outputTokens === 0)
+        return null;
+    const record = {
+        totalUsd,
+        inputTokens,
+        outputTokens,
+    };
+    if (thinkingTokens != null)
+        record.thinkingTokens = thinkingTokens;
+    if (cachedTokens != null)
+        record.cachedTokens = cachedTokens;
+    if (cacheCreationTokens != null)
+        record.cacheCreationTokens = cacheCreationTokens;
+    if (cacheReadTokens != null)
+        record.cacheReadTokens = cacheReadTokens;
+    return record;
+}
+function extractNumber(obj, keys) {
+    for (const key of keys) {
+        const val = obj[key];
+        if (typeof val === 'number' && Number.isFinite(val))
+            return val;
+        if (typeof val === 'object' && val !== null) {
+            const nested = val;
+            for (const nk of Object.keys(nested)) {
+                const nv = nested[nk];
+                if (typeof nv === 'number' && Number.isFinite(nv))
+                    return nv;
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=base-adapter-helpers.js.map

package/dist/base-adapter-helpers.js.map

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

package/dist/base-adapter.d.ts

@@ -6,18 +6,18 @@
  *
  * @see 05-adapter-system.md §4
  */
-import type { AgentName, CostRecord, RetryPolicy, AgentCapabilities, ModelCapabilities, AgentConfig, AgentConfigSchema, AuthState, AuthSetupGuidance, Session, InstalledPlugin, PluginInstallOptions, PluginSearchOptions, PluginListing, SpawnArgs, ParseContext, AgentAdapter, RunOptions, AgentEvent, DetectInstallationResult, InstallResult, AdapterInstallOptions, AdapterUpdateOptions, Spawner, InstallMethod } from '@a5c-ai/agent-mux-core';
+import type { AgentName, CostRecord, RetryPolicy, AgentCapabilities, ModelCapabilities, AgentConfig, AgentConfigSchema, AuthState, AuthSetupGuidance, Session, InstalledPlugin, PluginInstallOptions, PluginSearchOptions, PluginListing, SpawnArgs, ParseContext, SubprocessAdapter, RunOptions, AgentEvent, DetectInstallationResult, InstallResult, AdapterInstallOptions, AdapterUpdateOptions, Spawner, InstallMethod } from '@a5c-ai/agent-mux-core';
 import { StreamAssembler } from '@a5c-ai/agent-mux-core';
+export { defaultSpawner } from './base-adapter-helpers.js';
 /**
- * Default Spawner that runs the command via `child_process.spawn`, capturing
- * stdout/stderr. `shell: false`, `windowsHide: true`.
- */
-export declare const defaultSpawner: Spawner;
-/**
- * Abstract base class for agent adapters. Provides shared utilities
- * and hook points with sensible defaults.
+ * Abstract base class for subprocess-based agent adapters.
+ * Provides shared utilities and hook points with sensible defaults.
+ *
+ * Implements SubprocessAdapter from the new multi-adapter architecture.
+ * For HTTP/WebSocket/SDK adapters, create separate base classes.
  */
-export declare abstract class BaseAgentAdapter implements AgentAdapter {
+export declare abstract class BaseAgentAdapter implements SubprocessAdapter {
+    readonly adapterType: "subprocess";
     abstract readonly agent: AgentName;
     abstract readonly displayName: string;
     abstract readonly cliCommand: string;
@@ -44,6 +44,11 @@ export declare abstract class BaseAgentAdapter implements AgentAdapter {
     protected _spawner: Spawner;
     /** Replaces the internal Spawner (used by tests and CLI DI). */
     setSpawner(spawner: Spawner): void;
+    protected normalizePrompt(prompt: string | string[]): string;
+    protected buildPromptTransport(options: RunOptions): {
+        prompt: string;
+        stdin?: string;
+    };
     /**
      * Locates the harness binary and queries its `--version`. Default
      * implementation uses `which`/`where` + `<cli> --version`.

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

@@ -1 +1 @@
-{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../src/base-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../src/base-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,YAAY,EAEZ,iBAAiB,EACjB,UAAU,EACV,UAAU,EAEV,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,OAAO,EACP,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;;;;;GAMG;AACH,8BAAsB,gBAAiB,YAAW,iBAAiB;IAGjE,QAAQ,CAAC,WAAW,EAAG,YAAY,CAAU;IAG7C,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAElD,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;IACvD,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAC1F,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IACzC,QAAQ,CAAC,eAAe,IAAI,iBAAiB;IAC7C,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM;IACzC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAC7D,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,WAAW,CAAC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAC1C,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAC1F,eAAe,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAItF,SAAS,CAAC,QAAQ,CAAC,eAAe,kBAAyB;IAI3D,uEAAuE;IACvE,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAkB;IAE7C,gEAAgE;IAChE,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM;IAI5D,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAcvF;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAgC7D;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAO7D;;;OAGG;IACH,OAAO,CAAC,eAAe;IAYjB,OAAO,CAAC,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,aAAa,CAAC;IAMvE,8DAA8D;IACxD,MAAM,CAAC,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAMrE;;;OAGG;IACH,SAAS,CAAC,iBAAiB,IAAI,aAAa,GAAG,SAAS;IA2BxD;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAYhF;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;IA+BnE;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQrD;;;OAGG;IACH,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI;IAI7D;;;OAGG;cACa,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI9D;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IA0B1E;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;IASnE;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU;IAWtC;;OAEG;IACH,SAAS,IAAI,UAAU;IAYvB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,EAAE;IA6BpE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO;IAmB7E;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GACvD,OAAO,CAAC,IAAI,CAAC;IAKhB,6DAA6D;cAC7C,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GACvD,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;OAKG;cACa,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAO,GAC1C,OAAO,CAAC,OAAO,CAAC;IAMnB;;;;;;OAMG;cACa,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;CAsBjB"}

package/dist/base-adapter.js

@@ -6,36 +6,21 @@
  *
  * @see 05-adapter-system.md §4
  */
-import { spawn } from 'node:child_process';
 import * as os from 'node:os';
 import { StreamAssembler } from '@a5c-ai/agent-mux-core';
 import { runInstall, runUpdate } from './adapter-install.js';
+import { assembleCostRecord, defaultSpawner } from './base-adapter-helpers.js';
+export { defaultSpawner } from './base-adapter-helpers.js';
 /**
- * Default Spawner that runs the command via `child_process.spawn`, capturing
- * stdout/stderr. `shell: false`, `windowsHide: true`.
- */
-export const defaultSpawner = (command, args, options) => new Promise((resolve, reject) => {
-    const child = spawn(command, args, {
-        stdio: ['ignore', 'pipe', 'pipe'],
-        shell: false,
-        windowsHide: true,
-        env: options?.env ? { ...process.env, ...options.env } : process.env,
-        cwd: options?.cwd,
-    });
-    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 }));
-});
-/**
- * Abstract base class for agent adapters. Provides shared utilities
- * and hook points with sensible defaults.
+ * Abstract base class for subprocess-based agent adapters.
+ * Provides shared utilities and hook points with sensible defaults.
+ *
+ * Implements SubprocessAdapter from the new multi-adapter architecture.
+ * For HTTP/WebSocket/SDK adapters, create separate base classes.
  */
 export class BaseAgentAdapter {
+    // ── Adapter Type ──────────────────────────────────────────────────
+    adapterType = 'subprocess';
     // ── Protected stream assembler ────────────────────────────────────
     streamAssembler = new StreamAssembler();
     // ── Injectable spawner for install/update/detect ──────────────────
@@ -45,6 +30,19 @@ export class BaseAgentAdapter {
     setSpawner(spawner) {
         this._spawner = spawner;
     }
+    normalizePrompt(prompt) {
+        return Array.isArray(prompt) ? prompt.join('\n') : prompt;
+    }
+    buildPromptTransport(options) {
+        const prompt = this.normalizePrompt(options.prompt);
+        if (options.nonInteractive === true || !this.capabilities.supportsStdinInjection) {
+            return { prompt };
+        }
+        return {
+            prompt,
+            stdin: prompt.endsWith('\n') ? prompt : `${prompt}\n`,
+        };
+    }
     // ── detectInstallation ────────────────────────────────────────────
     /**
      * Locates the harness binary and queries its `--version`. Default
@@ -216,28 +214,7 @@ export class BaseAgentAdapter {
      * standard CostRecord type.
      */
     assembleCostRecord(raw) {
-        if (raw == null || typeof raw !== 'object')
-            return null;
-        const obj = raw;
-        // Try common field names for total cost
-        const totalUsd = extractNumber(obj, ['totalUsd', 'total_usd', 'cost', 'total_cost', 'totalCost']) ?? 0;
-        const inputTokens = extractNumber(obj, ['inputTokens', 'input_tokens', 'prompt_tokens']) ?? 0;
-        const outputTokens = extractNumber(obj, ['outputTokens', 'output_tokens', 'completion_tokens']) ?? 0;
-        const thinkingTokens = extractNumber(obj, ['thinkingTokens', 'thinking_tokens', 'reasoning_tokens']);
-        const cachedTokens = extractNumber(obj, ['cachedTokens', 'cached_tokens', 'cache_read_input_tokens']);
-        // Must have at least some recognizable data
-        if (totalUsd === 0 && inputTokens === 0 && outputTokens === 0)
-            return null;
-        const record = {
-            totalUsd,
-            inputTokens,
-            outputTokens,
-        };
-        if (thinkingTokens != null)
-            record.thinkingTokens = thinkingTokens;
-        if (cachedTokens != null)
-            record.cachedTokens = cachedTokens;
-        return record;
+        return assembleCostRecord(raw);
     }
     /**
      * Detects the installed CLI version. Returns null in the base implementation.
@@ -435,24 +412,4 @@ export class BaseAgentAdapter {
         await fsp.writeFile(settingsPath, JSON.stringify(doc, null, 2) + '\n', 'utf8');
     }
 }
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-function extractNumber(obj, keys) {
-    for (const key of keys) {
-        const val = obj[key];
-        if (typeof val === 'number' && Number.isFinite(val))
-            return val;
-        // Check nested objects
-        if (typeof val === 'object' && val !== null) {
-            const nested = val;
-            for (const nk of Object.keys(nested)) {
-                const nv = nested[nk];
-                if (typeof nv === 'number' && Number.isFinite(nv))
-                    return nv;
-            }
-        }
-    }
-    return undefined;
-}
 //# sourceMappingURL=base-adapter.js.map