@a5c-ai/agent-mux-adapters 0.2.0

package/dist/cursor-adapter.js

@@ -0,0 +1,247 @@
+/**
+ * CursorAdapter — Cursor IDE CLI adapter.
+ */
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { BaseAgentAdapter } from './base-adapter.js';
+import { mcpListPlugins, mcpInstallPlugin, mcpUninstallPlugin } from './mcp-plugins.js';
+import { readAuthConfigIdentity } from './auth-config.js';
+import { listJsonlFiles, parseJsonlSessionFile, readJsonFile, writeJsonFileAtomic, } from './session-fs.js';
+export class CursorAdapter extends BaseAgentAdapter {
+    agent = 'cursor';
+    displayName = 'Cursor';
+    cliCommand = 'cursor-agent';
+    minVersion = '0.40.0';
+    hostEnvSignals = ['CURSOR_SESSION', 'CURSOR_AGENT_SESSION'];
+    capabilities = {
+        agent: 'cursor',
+        canResume: true,
+        canFork: false,
+        supportsMultiTurn: true,
+        sessionPersistence: 'sqlite',
+        supportsTextStreaming: true,
+        supportsToolCallStreaming: true,
+        supportsThinkingStreaming: false,
+        supportsNativeTools: true,
+        supportsMCP: true,
+        supportsParallelToolCalls: true,
+        requiresToolApproval: true,
+        approvalModes: ['yolo', 'prompt'],
+        supportsThinking: false,
+        thinkingEffortLevels: [],
+        supportsThinkingBudgetTokens: false,
+        supportsJsonMode: false,
+        supportsStructuredOutput: false,
+        supportsSkills: false,
+        supportsAgentsMd: true,
+        skillsFormat: null,
+        supportsSubagentDispatch: false,
+        supportsParallelExecution: false,
+        supportsInteractiveMode: true,
+        supportsStdinInjection: false,
+        supportsImageInput: true,
+        supportsImageOutput: false,
+        supportsFileAttachments: true,
+        supportsPlugins: true,
+        pluginFormats: ['mcp-server'],
+        pluginRegistries: [{ name: 'mcp', url: 'https://modelcontextprotocol.io', searchable: false }],
+        supportedPlatforms: ['darwin', 'linux', 'win32'],
+        requiresGitRepo: false,
+        requiresPty: false,
+        authMethods: [
+            { type: 'api_key', name: 'API Key', description: 'CURSOR_API_KEY environment variable' },
+            { type: 'browser_login', name: 'Browser Login', description: 'Cursor account browser login' },
+        ],
+        authFiles: ['.cursor/settings.json'],
+        installMethods: [
+            { platform: 'all', type: 'manual', command: 'Download from https://cursor.com' },
+        ],
+    };
+    models = [
+        {
+            agent: 'cursor',
+            modelId: 'cursor-fast',
+            displayName: 'Cursor Fast',
+            deprecated: false,
+            contextWindow: 128000,
+            maxOutputTokens: 8192,
+            supportsThinking: false,
+            supportsToolCalling: true,
+            supportsParallelToolCalls: true,
+            supportsToolCallStreaming: true,
+            supportsJsonMode: false,
+            supportsStructuredOutput: false,
+            supportsTextStreaming: true,
+            supportsThinkingStreaming: false,
+            supportsImageInput: true,
+            supportsImageOutput: false,
+            supportsFileInput: true,
+            cliArgKey: '--model',
+            cliArgValue: 'cursor-fast',
+            lastUpdated: '2025-01-01',
+            source: 'bundled',
+        },
+    ];
+    defaultModelId = 'cursor-fast';
+    configSchema = {
+        agent: 'cursor',
+        version: 1,
+        fields: [],
+        configFilePaths: [path.join(os.homedir(), '.cursor', 'settings.json')],
+        configFormat: 'json',
+        supportsProjectConfig: true,
+    };
+    buildSpawnArgs(options) {
+        const args = [];
+        if (options.model) {
+            args.push('--model', options.model);
+        }
+        const prompt = Array.isArray(options.prompt) ? options.prompt.join('\n') : options.prompt;
+        args.push('--prompt', prompt);
+        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 ts = Date.now();
+        const base = { runId: context.runId, agent: this.agent, timestamp: ts };
+        const type = obj['type'];
+        if (type === 'text' || type === 'message') {
+            const content = (obj['content'] ?? obj['text'] ?? '');
+            if (content) {
+                return { ...base, type: 'text_delta', delta: content, accumulated: content };
+            }
+        }
+        if (type === 'tool_call') {
+            return {
+                ...base,
+                type: 'tool_call_start',
+                toolCallId: (obj['id'] ?? ''),
+                toolName: (obj['name'] ?? ''),
+                inputAccumulated: JSON.stringify(obj['input'] ?? {}),
+            };
+        }
+        if (type === 'error') {
+            return {
+                ...base,
+                type: 'error',
+                code: 'INTERNAL',
+                message: (obj['message'] ?? 'Unknown error'),
+                recoverable: false,
+            };
+        }
+        return null;
+    }
+    async detectAuth() {
+        const apiKey = process.env['CURSOR_API_KEY'];
+        if (apiKey) {
+            return {
+                status: 'authenticated',
+                method: 'api_key',
+                identity: `...${apiKey.slice(-4)}`,
+            };
+        }
+        const home = os.homedir();
+        const found = await readAuthConfigIdentity([
+            path.join(home, '.cursor', 'auth.json'),
+            path.join(home, '.cursor', 'credentials.json'),
+            path.join(home, '.config', 'cursor', 'auth.json'),
+        ]);
+        if (found) {
+            return { status: 'authenticated', method: 'config_file', identity: found.identity };
+        }
+        return { status: 'unauthenticated' };
+    }
+    getAuthGuidance() {
+        return {
+            agent: 'cursor',
+            providerName: 'Cursor',
+            steps: [
+                { step: 1, description: 'Download Cursor from https://cursor.com', url: 'https://cursor.com' },
+                { step: 2, description: 'Sign in with your Cursor account in the IDE' },
+                { step: 3, description: 'Optionally set CURSOR_API_KEY for CLI usage', command: 'export CURSOR_API_KEY=...' },
+            ],
+            envVars: [
+                { name: 'CURSOR_API_KEY', description: 'Cursor API key', required: false },
+            ],
+            documentationUrls: ['https://cursor.com/docs'],
+            verifyCommand: 'cursor --version',
+        };
+    }
+    sessionDir(_cwd) {
+        return path.join(os.homedir(), '.cursor', 'sessions');
+    }
+    async parseSessionFile(filePath) {
+        const parsed = await parseJsonlSessionFile(filePath, 'cursor');
+        return { ...parsed, agent: 'cursor' };
+    }
+    async listSessionFiles(_cwd) {
+        return listJsonlFiles(this.sessionDir());
+    }
+    async readConfig(_cwd) {
+        const filePath = this.configSchema.configFilePaths?.[0];
+        if (!filePath)
+            return { agent: 'cursor', source: 'global' };
+        const data = (await readJsonFile(filePath)) ?? {};
+        return { agent: 'cursor', source: 'global', filePaths: [filePath], ...data };
+    }
+    async writeConfig(config, _cwd) {
+        const filePath = this.configSchema.configFilePaths?.[0];
+        if (!filePath)
+            return;
+        const existing = (await readJsonFile(filePath)) ?? {};
+        const { agent: _a, source: _s, filePaths: _fp, ...rest } = config;
+        void _a;
+        void _s;
+        void _fp;
+        await writeJsonFileAtomic(filePath, { ...existing, ...rest });
+    }
+    /**
+     * Override: Cursor is install-only via manual download. Return a clear
+     * message rather than attempting to spawn anything.
+     */
+    async install(_opts) {
+        const method = this.capabilities.installMethods[0];
+        const cmd = method?.command ?? 'https://cursor.com';
+        return {
+            ok: false,
+            method: 'manual',
+            command: cmd,
+            message: `Cursor must be installed manually. ${cmd}`,
+        };
+    }
+    /**
+     * Override: no programmatic update path; surface a manual-update message.
+     */
+    async update(_opts) {
+        return {
+            ok: false,
+            method: 'manual',
+            command: '',
+            message: 'Cursor updates are delivered via the Cursor desktop app; no CLI update is available.',
+        };
+    }
+    pluginsPath() {
+        return this.configSchema.configFilePaths?.[0] ?? '';
+    }
+    async listPlugins() {
+        return mcpListPlugins(this.pluginsPath());
+    }
+    async installPlugin(pluginId, options) {
+        return mcpInstallPlugin(this.pluginsPath(), pluginId, options);
+    }
+    async uninstallPlugin(pluginId) {
+        return mcpUninstallPlugin(this.pluginsPath(), pluginId);
+    }
+}
+//# sourceMappingURL=cursor-adapter.js.map

package/dist/cursor-adapter.js.map

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

package/dist/gemini-adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * GeminiAdapter — Google Gemini CLI adapter.
+ */
+import type { AgentCapabilities, ModelCapabilities, AgentConfigSchema, AuthState, AuthSetupGuidance, Session, SpawnArgs, ParseContext, RunOptions, AgentEvent, InstalledPlugin, PluginInstallOptions, AgentConfig } from '@a5c-ai/agent-mux-core';
+import { BaseAgentAdapter } from './base-adapter.js';
+export declare class GeminiAdapter extends BaseAgentAdapter {
+    readonly agent: "gemini";
+    readonly displayName = "Gemini CLI";
+    readonly cliCommand = "gemini";
+    readonly minVersion = "0.1.0";
+    readonly hostEnvSignals: readonly ["GEMINI_CLI", "GEMINI_SESSION_ID"];
+    readonly capabilities: AgentCapabilities;
+    readonly models: ModelCapabilities[];
+    readonly defaultModelId = "gemini-2.5-pro";
+    readonly configSchema: AgentConfigSchema;
+    buildSpawnArgs(options: RunOptions): SpawnArgs;
+    parseEvent(line: string, context: ParseContext): AgentEvent | AgentEvent[] | null;
+    detectAuth(): Promise<AuthState>;
+    getAuthGuidance(): AuthSetupGuidance;
+    sessionDir(_cwd?: string): string;
+    parseSessionFile(filePath: string): Promise<Session>;
+    listSessionFiles(_cwd?: string): Promise<string[]>;
+    readConfig(_cwd?: string): Promise<AgentConfig>;
+    writeConfig(config: Partial<AgentConfig>, _cwd?: string): Promise<void>;
+    /**
+     * Override: `gemini --version` output on some platforms is simply a bare
+     * version line like `0.4.2`. The base semver regex handles that but this
+     * override strips the leading `gemini-cli/` or `gemini ` prefix if present.
+     */
+    protected parseVersionOutput(raw: string): string | undefined;
+    private pluginsPath;
+    listPlugins(): Promise<InstalledPlugin[]>;
+    installPlugin(pluginId: string, options?: PluginInstallOptions): Promise<InstalledPlugin>;
+    uninstallPlugin(pluginId: string): Promise<void>;
+}
+//# sourceMappingURL=gemini-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-adapter.d.ts","sourceRoot":"","sources":["../src/gemini-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,SAAS,EACT,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAUrD,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,QAAQ,CAAC,KAAK,EAAG,QAAQ,CAAU;IACnC,QAAQ,CAAC,WAAW,gBAAgB;IACpC,QAAQ,CAAC,UAAU,YAAY;IAC/B,QAAQ,CAAC,UAAU,WAAW;IAC9B,QAAQ,CAAC,cAAc,+CAAgD;IAEvE,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CA2CtC;IAEF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAkDlC;IAEF,QAAQ,CAAC,cAAc,oBAAoB;IAE3C,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAOtC;IAEF,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;IAyB9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAwD3E,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IA6BtC,eAAe,IAAI,iBAAiB;IAmBpC,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,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAO/C,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7E;;;;OAIG;cACgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQtE,OAAO,CAAC,WAAW;IAIJ,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAIzC,aAAa,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC;IAIZ,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhE"}

package/dist/gemini-adapter.js

@@ -0,0 +1,287 @@
+/**
+ * GeminiAdapter — Google Gemini CLI adapter.
+ */
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { BaseAgentAdapter } from './base-adapter.js';
+import { mcpListPlugins, mcpInstallPlugin, mcpUninstallPlugin } from './mcp-plugins.js';
+import { readAuthConfigIdentity } from './auth-config.js';
+import { listJsonlFiles, parseJsonlSessionFile, readJsonFile, writeJsonFileAtomic, } from './session-fs.js';
+export class GeminiAdapter extends BaseAgentAdapter {
+    agent = 'gemini';
+    displayName = 'Gemini CLI';
+    cliCommand = 'gemini';
+    minVersion = '0.1.0';
+    hostEnvSignals = ['GEMINI_CLI', 'GEMINI_SESSION_ID'];
+    capabilities = {
+        agent: 'gemini',
+        canResume: true,
+        canFork: false,
+        supportsMultiTurn: true,
+        sessionPersistence: 'file',
+        supportsTextStreaming: true,
+        supportsToolCallStreaming: true,
+        supportsThinkingStreaming: true,
+        supportsNativeTools: true,
+        supportsMCP: true,
+        supportsParallelToolCalls: true,
+        requiresToolApproval: true,
+        approvalModes: ['yolo', 'prompt'],
+        supportsThinking: true,
+        thinkingEffortLevels: ['low', 'medium', 'high'],
+        supportsThinkingBudgetTokens: true,
+        supportsJsonMode: true,
+        supportsStructuredOutput: true,
+        supportsSkills: false,
+        supportsAgentsMd: false,
+        skillsFormat: null,
+        supportsSubagentDispatch: false,
+        supportsParallelExecution: false,
+        supportsInteractiveMode: true,
+        supportsStdinInjection: true,
+        supportsImageInput: true,
+        supportsImageOutput: false,
+        supportsFileAttachments: true,
+        supportsPlugins: true,
+        pluginFormats: ['mcp-server'],
+        pluginRegistries: [{ name: 'mcp', url: 'https://modelcontextprotocol.io', searchable: false }],
+        supportedPlatforms: ['darwin', 'linux', 'win32'],
+        requiresGitRepo: false,
+        requiresPty: false,
+        authMethods: [
+            { type: 'api_key', name: 'API Key', description: 'GOOGLE_API_KEY or GEMINI_API_KEY environment variable' },
+            { type: 'browser_login', name: 'Browser Login', description: 'Google account browser login' },
+        ],
+        authFiles: ['.config/gemini/settings.json'],
+        installMethods: [
+            { platform: 'all', type: 'npm', command: 'npm install -g @google/gemini-cli' },
+        ],
+    };
+    models = [
+        {
+            agent: 'gemini',
+            modelId: 'gemini-2.5-pro',
+            displayName: 'Gemini 2.5 Pro',
+            deprecated: false,
+            contextWindow: 1000000,
+            maxOutputTokens: 65536,
+            maxThinkingTokens: 65536,
+            supportsThinking: true,
+            thinkingEffortLevels: ['low', 'medium', 'high'],
+            supportsToolCalling: true,
+            supportsParallelToolCalls: true,
+            supportsToolCallStreaming: true,
+            supportsJsonMode: true,
+            supportsStructuredOutput: true,
+            supportsTextStreaming: true,
+            supportsThinkingStreaming: true,
+            supportsImageInput: true,
+            supportsImageOutput: false,
+            supportsFileInput: true,
+            cliArgKey: '--model',
+            cliArgValue: 'gemini-2.5-pro',
+            lastUpdated: '2025-03-01',
+            source: 'bundled',
+        },
+        {
+            agent: 'gemini',
+            modelId: 'gemini-2.5-flash',
+            displayName: 'Gemini 2.5 Flash',
+            deprecated: false,
+            contextWindow: 1000000,
+            maxOutputTokens: 65536,
+            supportsThinking: true,
+            thinkingEffortLevels: ['low', 'medium', 'high'],
+            supportsToolCalling: true,
+            supportsParallelToolCalls: true,
+            supportsToolCallStreaming: true,
+            supportsJsonMode: true,
+            supportsStructuredOutput: true,
+            supportsTextStreaming: true,
+            supportsThinkingStreaming: true,
+            supportsImageInput: true,
+            supportsImageOutput: false,
+            supportsFileInput: true,
+            cliArgKey: '--model',
+            cliArgValue: 'gemini-2.5-flash',
+            lastUpdated: '2025-03-01',
+            source: 'bundled',
+        },
+    ];
+    defaultModelId = 'gemini-2.5-pro';
+    configSchema = {
+        agent: 'gemini',
+        version: 1,
+        fields: [],
+        configFilePaths: [path.join(os.homedir(), '.config', 'gemini', 'settings.json')],
+        configFormat: 'json',
+        supportsProjectConfig: false,
+    };
+    buildSpawnArgs(options) {
+        const args = [];
+        if (options.model) {
+            args.push('--model', options.model);
+        }
+        if (options.approvalMode === 'yolo') {
+            args.push('--sandbox', 'false');
+        }
+        const prompt = Array.isArray(options.prompt) ? options.prompt.join('\n') : options.prompt;
+        args.push('--prompt', prompt);
+        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 ts = Date.now();
+        const base = { runId: context.runId, agent: this.agent, timestamp: ts };
+        const type = obj['type'];
+        if (type === 'text' || type === 'message') {
+            const content = (obj['content'] ?? obj['text'] ?? '');
+            if (content) {
+                return { ...base, type: 'text_delta', delta: content, accumulated: content };
+            }
+        }
+        if (type === 'tool_call') {
+            return {
+                ...base,
+                type: 'tool_call_start',
+                toolCallId: (obj['id'] ?? ''),
+                toolName: (obj['name'] ?? ''),
+                inputAccumulated: JSON.stringify(obj['args'] ?? obj['input'] ?? {}),
+            };
+        }
+        if (type === 'tool_result') {
+            return {
+                ...base,
+                type: 'tool_result',
+                toolCallId: (obj['id'] ?? ''),
+                toolName: (obj['name'] ?? ''),
+                output: obj['output'] ?? '',
+                durationMs: 0,
+            };
+        }
+        if (type === 'thinking') {
+            const thinking = (obj['content'] ?? '');
+            return { ...base, type: 'thinking_delta', delta: thinking, accumulated: thinking };
+        }
+        if (type === 'error') {
+            return {
+                ...base,
+                type: 'error',
+                code: 'INTERNAL',
+                message: (obj['message'] ?? 'Unknown error'),
+                recoverable: false,
+            };
+        }
+        return null;
+    }
+    async detectAuth() {
+        const googleKey = process.env['GOOGLE_API_KEY'];
+        if (googleKey) {
+            return {
+                status: 'authenticated',
+                method: 'api_key',
+                identity: `...${googleKey.slice(-4)}`,
+            };
+        }
+        const geminiKey = process.env['GEMINI_API_KEY'];
+        if (geminiKey) {
+            return {
+                status: 'authenticated',
+                method: 'api_key',
+                identity: `...${geminiKey.slice(-4)}`,
+            };
+        }
+        const home = os.homedir();
+        const found = await readAuthConfigIdentity([
+            path.join(home, '.gemini', 'credentials.json'),
+            path.join(home, '.gemini', 'auth.json'),
+            path.join(home, '.config', 'gemini', 'credentials.json'),
+        ]);
+        if (found) {
+            return { status: 'authenticated', method: 'config_file', identity: found.identity };
+        }
+        return { status: 'unauthenticated' };
+    }
+    getAuthGuidance() {
+        return {
+            agent: 'gemini',
+            providerName: 'Google',
+            steps: [
+                { step: 1, description: 'Get an API key from https://aistudio.google.com/apikey', url: 'https://aistudio.google.com/apikey' },
+                { step: 2, description: 'Set GOOGLE_API_KEY or GEMINI_API_KEY environment variable', command: 'export GOOGLE_API_KEY=...' },
+                { step: 3, description: 'Alternatively, run `gemini` and follow the browser login flow', command: 'gemini' },
+            ],
+            envVars: [
+                { name: 'GOOGLE_API_KEY', description: 'Google API key', required: false, exampleFormat: 'AIza...' },
+                { name: 'GEMINI_API_KEY', description: 'Gemini API key (alternative)', required: false, exampleFormat: 'AIza...' },
+            ],
+            documentationUrls: ['https://github.com/google-gemini/gemini-cli'],
+            loginCommand: 'gemini',
+            verifyCommand: 'gemini --version',
+        };
+    }
+    sessionDir(_cwd) {
+        return path.join(os.homedir(), '.gemini', 'sessions');
+    }
+    async parseSessionFile(filePath) {
+        const parsed = await parseJsonlSessionFile(filePath, 'gemini');
+        return { ...parsed, agent: 'gemini' };
+    }
+    async listSessionFiles(_cwd) {
+        return listJsonlFiles(this.sessionDir());
+    }
+    async readConfig(_cwd) {
+        const filePath = this.configSchema.configFilePaths?.[0];
+        if (!filePath)
+            return { agent: 'gemini', source: 'global' };
+        const data = (await readJsonFile(filePath)) ?? {};
+        return { agent: 'gemini', source: 'global', filePaths: [filePath], ...data };
+    }
+    async writeConfig(config, _cwd) {
+        const filePath = this.configSchema.configFilePaths?.[0];
+        if (!filePath)
+            return;
+        const existing = (await readJsonFile(filePath)) ?? {};
+        const { agent: _a, source: _s, filePaths: _fp, ...rest } = config;
+        void _a;
+        void _s;
+        void _fp;
+        await writeJsonFileAtomic(filePath, { ...existing, ...rest });
+    }
+    /**
+     * Override: `gemini --version` output on some platforms is simply a bare
+     * version line like `0.4.2`. The base semver regex handles that but this
+     * override strips the leading `gemini-cli/` or `gemini ` prefix if present.
+     */
+    parseVersionOutput(raw) {
+        const cleaned = raw
+            .replace(/^\s*gemini[\s-]*(cli)?[\s-/]*/i, '')
+            .trim();
+        const match = cleaned.match(/\d+\.\d+\.\d+(?:[\w.+-]*)?/);
+        return match ? match[0] : undefined;
+    }
+    pluginsPath() {
+        return this.configSchema.configFilePaths?.[0] ?? '';
+    }
+    async listPlugins() {
+        return mcpListPlugins(this.pluginsPath());
+    }
+    async installPlugin(pluginId, options) {
+        return mcpInstallPlugin(this.pluginsPath(), pluginId, options);
+    }
+    async uninstallPlugin(pluginId) {
+        return mcpUninstallPlugin(this.pluginsPath(), pluginId);
+    }
+}
+//# sourceMappingURL=gemini-adapter.js.map

package/dist/gemini-adapter.js.map

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

package/dist/hermes-adapter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * HermesAdapter — Hermes agent (NousResearch) CLI 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 HermesAdapter extends BaseAgentAdapter {
+    readonly agent: "hermes";
+    readonly displayName = "Hermes";
+    readonly cliCommand = "hermes";
+    readonly minVersion = "0.1.0";
+    readonly hostEnvSignals: readonly ["HERMES_SESSION", "HERMES_RUN_ID"];
+    readonly capabilities: AgentCapabilities;
+    readonly models: ModelCapabilities[];
+    readonly defaultModelId = "hermes-3-llama-3.1-405b";
+    readonly configSchema: AgentConfigSchema;
+    buildSpawnArgs(options: RunOptions): SpawnArgs;
+    parseEvent(line: string, context: ParseContext): AgentEvent | AgentEvent[] | null;
+    detectAuth(): Promise<AuthState>;
+    getAuthGuidance(): AuthSetupGuidance;
+    sessionDir(_cwd?: string): string;
+    parseSessionFile(filePath: string): Promise<Session>;
+    listSessionFiles(_cwd?: string): Promise<string[]>;
+    readConfig(_cwd?: string): Promise<AgentConfig>;
+    writeConfig(config: Partial<AgentConfig>, _cwd?: string): Promise<void>;
+    /**
+     * Hermes stores config as flat YAML. We encode hooks as a nested
+     * `hooks:` block with one `<hookType>: <command>` entry per line.
+     * Multiple commands per hookType are joined with `&&` since flat YAML
+     * allows only one value per key.
+     */
+    protected writeNativeHook(hookType: string, command: string): Promise<void>;
+}
+//# sourceMappingURL=hermes-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-adapter.d.ts","sourceRoot":"","sources":["../src/hermes-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,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;AAIhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AASrD,qBAAa,aAAc,SAAQ,gBAAgB;IACjD,QAAQ,CAAC,KAAK,EAAG,QAAQ,CAAU;IACnC,QAAQ,CAAC,WAAW,YAAY;IAChC,QAAQ,CAAC,UAAU,YAAY;IAC/B,QAAQ,CAAC,UAAU,WAAW;IAC9B,QAAQ,CAAC,cAAc,+CAAgD;IAEvE,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CA+CtC;IAEF,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAwBlC;IAEF,QAAQ,CAAC,cAAc,6BAA6B;IAEpD,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAOtC;IAEF,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS;IAyB9C,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI;IAwC3E,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IAwBtC,eAAe,IAAI,iBAAiB;IAsBpC,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,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAa/C,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe7E;;;;;OAKG;cACsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAwB3F"}