agent-switchboard 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Frank Qing
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,56 @@
+# Agent Switchboard (WIP)
+
+Minimal tool to manage MCP servers in one place and apply them to local agents (e.g., Codex, Cursor).
+
+## Installation
+
+Requirements: Node.js >= 16
+
+Global install:
+
+```bash
+npm i -g agent-switchboard
+```
+
+Run once without installing:
+
+```bash
+npx agent-switchboard@latest mcp
+```
+
+## Quick Start
+
+1) Create `~/.agent-switchboard/mcp.json` (if missing).
+2) Run the interactive UI:
+
+```bash
+agent-switchboard mcp
+# or
+asb mcp
+```
+
+That’s it. The tool updates `~/.agent-switchboard/mcp.json` and writes agent configs.
+
+## Configure Agents
+
+Agent Switchboard only applies MCP servers to the agents you list in `~/.agent-switchboard/config.toml`.
+
+Create the file if it does not exist:
+
+```toml
+# ~/.agent-switchboard/config.toml
+agents = ["codex", "cursor"]
+```
+
+Supported agent IDs:
+- `codex` — Codex CLI (~/.codex/config.toml)
+- `cursor` — Cursor IDE (~/.cursor/mcp.json)
+- `claude-code` — Claude Code CLI (~/.claude.json)
+- `claude-desktop` — Claude Desktop app (platform-specific path)
+- `gemini` — Gemini CLI (~/.gemini/settings.json)
+
+Run `agent-switchboard mcp` again after updating the list.
+
+## License
+
+MIT

package/dist/agents/adapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Agent adapter interface
+ * Implements the strategy pattern for different agent config formats
+ */
+import type { McpServer } from "../config/schemas.js";
+/**
+ * Agent adapter interface
+ * Each agent (Claude Code, Codex, Cursor, etc.) implements this interface
+ * to handle its specific configuration format and file location
+ */
+export interface AgentAdapter {
+    /**
+     * Unique identifier for the agent
+     * @example "claude-code", "codex", "cursor"
+     */
+    readonly id: string;
+    /**
+     * Returns the absolute path to the agent's config file
+     * @returns Absolute path to the config file
+     * @example "/Users/username/.claude.json"
+     */
+    configPath(): string;
+    /**
+     * Applies MCP config to the agent's config file
+     * - Merges with existing config (preserves unknown fields)
+     * - The 'enable' field is excluded from the input
+     * @param config - MCP servers to apply (without 'enable')
+     */
+    applyConfig(config: {
+        mcpServers: Record<string, Omit<McpServer, "enable">>;
+    }): void;
+}

package/dist/agents/adapter.js

@@ -0,0 +1,6 @@
+/**
+ * Agent adapter interface
+ * Implements the strategy pattern for different agent config formats
+ */
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/agents/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/agents/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/agents/claude-code.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Claude Code agent adapter
+ * Manages MCP server configuration for Claude Code CLI
+ */
+import type { McpServer } from "../config/schemas.js";
+import type { AgentAdapter } from "./adapter.js";
+/**
+ * Claude Code agent adapter
+ * Config location: ~/.claude.json
+ */
+export declare class ClaudeCodeAgent implements AgentAdapter {
+    readonly id: "claude-code";
+    configPath(): string;
+    applyConfig(config: {
+        mcpServers: Record<string, Omit<McpServer, "enable">>;
+    }): void;
+}

package/dist/agents/claude-code.js

@@ -0,0 +1,27 @@
+/**
+ * Claude Code agent adapter
+ * Manages MCP server configuration for Claude Code CLI
+ */
+import os from "node:os";
+import path from "node:path";
+import { loadJsonFile, saveJsonFile, mergeMcpIntoAgent } from "./json-utils.js";
+/**
+ * Claude Code agent adapter
+ * Config location: ~/.claude.json
+ */
+export class ClaudeCodeAgent {
+    id = "claude-code";
+    configPath() {
+        const base = (process.env.ASB_AGENTS_HOME && process.env.ASB_AGENTS_HOME.trim().length > 0)
+            ? process.env.ASB_AGENTS_HOME
+            : os.homedir();
+        return path.join(base, ".claude.json");
+    }
+    applyConfig(config) {
+        const path = this.configPath();
+        const agentConfig = loadJsonFile(path, { mcpServers: {} });
+        const merged = mergeMcpIntoAgent(agentConfig, config.mcpServers);
+        saveJsonFile(path, merged);
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/agents/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/agents/claude-code.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAwB,MAAM,iBAAiB,CAAC;AAEtG;;;GAGG;AACH,MAAM,OAAO,eAAe;IAClB,EAAE,GAAG,aAAsB,CAAC;IAErC,UAAU;QACT,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1F,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,eAA0B;YACzC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC;IAED,WAAW,CAAC,MAAiE;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,YAAY,CAAkB,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAoC,CAAC,CAAC;QAC3F,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;CACD"}

package/dist/agents/claude-desktop.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Claude Desktop agent adapter
+ * Manages MCP server configuration for Claude Desktop app
+ */
+import type { McpServer } from "../config/schemas.js";
+import type { AgentAdapter } from "./adapter.js";
+/**
+ * Claude Desktop config file structure
+ */
+/**
+ * Claude Desktop agent adapter
+ * Config location (platform-specific):
+ * - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
+ * - Linux: ~/.config/Claude/claude_desktop_config.json
+ * - Windows: %APPDATA%\Claude\claude_desktop_config.json
+ */
+export declare class ClaudeDesktopAgent implements AgentAdapter {
+    readonly id: "claude-desktop";
+    configPath(): string;
+    applyConfig(config: {
+        mcpServers: Record<string, Omit<McpServer, "enable">>;
+    }): void;
+}

package/dist/agents/claude-desktop.js

@@ -0,0 +1,44 @@
+/**
+ * Claude Desktop agent adapter
+ * Manages MCP server configuration for Claude Desktop app
+ */
+import os from "node:os";
+import path from "node:path";
+import { loadJsonFile, saveJsonFile, mergeMcpIntoAgent } from "./json-utils.js";
+/**
+ * Claude Desktop config file structure
+ */
+// Uses shared JsonAgentConfig
+/**
+ * Claude Desktop agent adapter
+ * Config location (platform-specific):
+ * - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
+ * - Linux: ~/.config/Claude/claude_desktop_config.json
+ * - Windows: %APPDATA%\Claude\claude_desktop_config.json
+ */
+export class ClaudeDesktopAgent {
+    id = "claude-desktop";
+    configPath() {
+        const platform = os.platform();
+        const home = (process.env.ASB_AGENTS_HOME && process.env.ASB_AGENTS_HOME.trim().length > 0)
+            ? process.env.ASB_AGENTS_HOME
+            : os.homedir();
+        switch (platform) {
+            case "darwin": // macOS
+                return path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+            case "win32": // Windows
+                return path.join(home, "AppData", "Roaming", "Claude", "claude_desktop_config.json");
+            case "linux": // Linux
+                return path.join(home, ".config", "Claude", "claude_desktop_config.json");
+            default:
+                throw new Error(`Unsupported platform: ${platform}`);
+        }
+    }
+    applyConfig(config) {
+        const path = this.configPath();
+        const agentConfig = loadJsonFile(path, { mcpServers: {} });
+        const merged = mergeMcpIntoAgent(agentConfig, config.mcpServers);
+        saveJsonFile(path, merged);
+    }
+}
+//# sourceMappingURL=claude-desktop.js.map

package/dist/agents/claude-desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.js","sourceRoot":"","sources":["../../src/agents/claude-desktop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAwB,MAAM,iBAAiB,CAAC;AAGtG;;GAEG;AACH,8BAA8B;AAE9B;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACrB,EAAE,GAAG,gBAAyB,CAAC;IAExC,UAAU;QACT,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1F,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,eAA0B;YACzC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAEhB,QAAQ,QAAQ,EAAE,CAAC;YAClB,KAAK,QAAQ,EAAE,QAAQ;gBACtB,OAAO,IAAI,CAAC,IAAI,CACf,IAAI,EACJ,SAAS,EACT,qBAAqB,EACrB,QAAQ,EACR,4BAA4B,CAC5B,CAAC;YACH,KAAK,OAAO,EAAE,UAAU;gBACvB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;YACtF,KAAK,OAAO,EAAE,QAAQ;gBACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;YAC3E;gBACC,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;QACvD,CAAC;IACF,CAAC;IAED,WAAW,CAAC,MAAiE;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,YAAY,CAAkB,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAoC,CAAC,CAAC;QAC3F,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;CACD"}

package/dist/agents/codex.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Codex CLI Agent Adapter
+ * Handles TOML-based configuration with canonical section output
+ */
+import type { McpServer } from "../config/schemas.js";
+import type { AgentAdapter } from "./adapter.js";
+/**
+ * Codex CLI agent adapter
+ * Config: ~/.codex/config.toml (TOML format)
+ */
+export declare class CodexAgent implements AgentAdapter {
+    readonly id: "codex";
+    configPath(): string;
+    applyConfig(config: {
+        mcpServers: Record<string, Omit<McpServer, "enable">>;
+    }): void;
+    private _loadConfig;
+    private _saveConfig;
+}
+/**
+ * Merge MCP server config into TOML content
+ * Preserves unrelated top-level tables/keys; rewrites mcp_servers in canonical form
+ */
+export declare function mergeConfig(content: string, mcpServers: Record<string, Omit<McpServer, "enable">>): string;
+/**
+ * Minimal shape for a Codex MCP server entry used by the renderer
+ */
+export type McpServerLike = Record<string, unknown> & {
+    command?: string;
+    args?: string[];
+    url?: string;
+    type?: string;
+    env_file?: string;
+    env?: Record<string, unknown>;
+};
+/**
+ * Build canonical TOML: one table per server [mcp_servers.<name>]
+ * env must be written as dotted keys inside the same table: env.KEY = "VALUE"
+ * Key order per server: command, args, url, type, env_file, env.* (alpha), unknown (alpha)
+ * Exactly one blank line between server tables; final newline added by caller
+ */
+export declare function buildNestedToml(mcpServers: Record<string, Omit<McpServerLike, "enable">>): string;

package/dist/agents/codex.js

@@ -0,0 +1,135 @@
+/**
+ * Codex CLI Agent Adapter
+ * Handles TOML-based configuration with canonical section output
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { parse as parseToml, stringify as tomlStringify } from "@iarna/toml";
+/**
+ * Codex CLI agent adapter
+ * Config: ~/.codex/config.toml (TOML format)
+ */
+export class CodexAgent {
+    id = "codex";
+    configPath() {
+        const base = (process.env.ASB_AGENTS_HOME && process.env.ASB_AGENTS_HOME.trim().length > 0)
+            ? process.env.ASB_AGENTS_HOME
+            : os.homedir();
+        return path.join(base, ".codex", "config.toml");
+    }
+    applyConfig(config) {
+        const content = this._loadConfig();
+        const updated = mergeConfig(content, config.mcpServers);
+        this._saveConfig(updated);
+    }
+    _loadConfig() {
+        const configPath = this.configPath();
+        if (!fs.existsSync(configPath)) {
+            return "";
+        }
+        return fs.readFileSync(configPath, "utf-8");
+    }
+    _saveConfig(content) {
+        const configPath = this.configPath();
+        const dirPath = path.dirname(configPath);
+        if (!fs.existsSync(dirPath)) {
+            fs.mkdirSync(dirPath, { recursive: true });
+        }
+        fs.writeFileSync(configPath, content, "utf-8");
+    }
+}
+/**
+ * Merge MCP server config into TOML content
+ * Preserves unrelated top-level tables/keys; rewrites mcp_servers in canonical form
+ */
+export function mergeConfig(content, mcpServers) {
+    // Read existing content to preserve unrelated top-level keys (not comments)
+    let otherTopLevel = {};
+    try {
+        if (content && content.trim().length > 0) {
+            const parsed = parseToml(content);
+            // Remove mcp_servers from the preserved portion
+            const { mcp_servers: _ignored, ...rest } = (parsed ?? {});
+            otherTopLevel = rest;
+        }
+    }
+    catch {
+        // If parsing fails, drop old content entirely to avoid propagating bad state
+        otherTopLevel = {};
+    }
+    // Build canonical mcp_servers TOML from provided config
+    const mcpToml = buildNestedToml(mcpServers);
+    // Stringify other top-level tables/keys via iarna/toml
+    let otherToml = "";
+    try {
+        if (Object.keys(otherTopLevel).length > 0) {
+            otherToml = tomlStringify(otherTopLevel);
+        }
+    }
+    catch {
+        otherToml = "";
+    }
+    const parts = [];
+    if (otherToml.trim().length > 0)
+        parts.push(otherToml.trimEnd());
+    if (mcpToml.trim().length > 0)
+        parts.push(mcpToml.trimEnd());
+    return parts.join("\n\n") + "\n";
+}
+/**
+ * Build canonical TOML: one table per server [mcp_servers.<name>]
+ * env must be written as dotted keys inside the same table: env.KEY = "VALUE"
+ * Key order per server: command, args, url, type, env_file, env.* (alpha), unknown (alpha)
+ * Exactly one blank line between server tables; final newline added by caller
+ */
+export function buildNestedToml(mcpServers) {
+    const lines = [];
+    const serverNames = Object.keys(mcpServers); // preserve insertion order for stability
+    for (let idx = 0; idx < serverNames.length; idx++) {
+        const name = serverNames[idx];
+        const server = (mcpServers[name] ?? {});
+        lines.push(`[mcp_servers.${name}]`);
+        const KNOWN_ORDER = [
+            "command",
+            "args",
+            "url",
+            "type",
+            "env_file",
+        ];
+        const emit = (k, v) => {
+            if (v === undefined || v === null)
+                return;
+            // Only allow primitives and primitive arrays
+            const isPrim = (x) => typeof x === "string" || typeof x === "number" || typeof x === "boolean";
+            const isPrimArr = (x) => Array.isArray(x) && x.every(isPrim);
+            if (!isPrim(v) && !isPrimArr(v))
+                return;
+            // @iarna/toml value formatting for RHS
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const rhs = tomlStringify.value ? tomlStringify.value(v) : JSON.stringify(v);
+            lines.push(`${k} = ${rhs}`);
+        };
+        // Known keys
+        for (const k of KNOWN_ORDER)
+            emit(k, server[k]);
+        // env dotted keys (alphabetical)
+        if (server.env && typeof server.env === "object") {
+            const envEntries = Object.entries(server.env).filter(([_, v]) => v !== undefined && v !== null);
+            envEntries.sort(([a], [b]) => a.localeCompare(b));
+            for (const [ek, ev] of envEntries)
+                emit(`env.${ek}`, String(ev));
+        }
+        // Unknown keys (exclude known + env)
+        const knownSet = new Set([...KNOWN_ORDER.map(String), "env"]);
+        const unknownKeys = Object.keys(server)
+            .filter((k) => !knownSet.has(k))
+            .sort((a, b) => a.localeCompare(b));
+        for (const uk of unknownKeys)
+            emit(uk, server[uk]);
+        if (idx !== serverNames.length - 1)
+            lines.push(""); // blank line between servers
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=codex.js.map

package/dist/agents/codex.js.map

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

package/dist/agents/cursor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Cursor agent adapter
+ * Manages MCP server configuration for Cursor IDE
+ */
+import type { McpServer } from "../config/schemas.js";
+import type { AgentAdapter } from "./adapter.js";
+/**
+ * Cursor config file structure
+ */
+/**
+ * Cursor agent adapter
+ * Config location: ~/.cursor/mcp.json
+ */
+export declare class CursorAgent implements AgentAdapter {
+    readonly id: "cursor";
+    configPath(): string;
+    applyConfig(config: {
+        mcpServers: Record<string, Omit<McpServer, "enable">>;
+    }): void;
+}

package/dist/agents/cursor.js

@@ -0,0 +1,31 @@
+/**
+ * Cursor agent adapter
+ * Manages MCP server configuration for Cursor IDE
+ */
+import os from "node:os";
+import path from "node:path";
+import { loadJsonFile, saveJsonFile, mergeMcpIntoAgent } from "./json-utils.js";
+/**
+ * Cursor config file structure
+ */
+// Uses shared JsonAgentConfig
+/**
+ * Cursor agent adapter
+ * Config location: ~/.cursor/mcp.json
+ */
+export class CursorAgent {
+    id = "cursor";
+    configPath() {
+        const base = (process.env.ASB_AGENTS_HOME && process.env.ASB_AGENTS_HOME.trim().length > 0)
+            ? process.env.ASB_AGENTS_HOME
+            : os.homedir();
+        return path.join(base, ".cursor", "mcp.json");
+    }
+    applyConfig(config) {
+        const path = this.configPath();
+        const agentConfig = loadJsonFile(path, { mcpServers: {} });
+        const merged = mergeMcpIntoAgent(agentConfig, config.mcpServers);
+        saveJsonFile(path, merged);
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/agents/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/agents/cursor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAwB,MAAM,iBAAiB,CAAC;AAGtG;;GAEG;AACH,8BAA8B;AAE9B;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,EAAE,GAAG,QAAiB,CAAC;IAEhC,UAAU;QACT,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1F,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,eAA0B;YACzC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,WAAW,CAAC,MAAiE;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,YAAY,CAAkB,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAoC,CAAC,CAAC;QAC3F,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;CACD"}

package/dist/agents/gemini.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Gemini CLI agent adapter
+ * Manages MCP server configuration for Gemini CLI
+ */
+import type { McpServer } from "../config/schemas.js";
+import type { AgentAdapter } from "./adapter.js";
+/**
+ * Gemini CLI config file structure
+ */
+/**
+ * Gemini CLI agent adapter
+ * Config location: ~/.gemini/settings.json
+ */
+export declare class GeminiAgent implements AgentAdapter {
+    readonly id: "gemini";
+    configPath(): string;
+    applyConfig(config: {
+        mcpServers: Record<string, Omit<McpServer, "enable">>;
+    }): void;
+}

package/dist/agents/gemini.js

@@ -0,0 +1,31 @@
+/**
+ * Gemini CLI agent adapter
+ * Manages MCP server configuration for Gemini CLI
+ */
+import os from "node:os";
+import path from "node:path";
+import { loadJsonFile, saveJsonFile, mergeMcpIntoAgent } from "./json-utils.js";
+/**
+ * Gemini CLI config file structure
+ */
+// Uses shared JsonAgentConfig
+/**
+ * Gemini CLI agent adapter
+ * Config location: ~/.gemini/settings.json
+ */
+export class GeminiAgent {
+    id = "gemini";
+    configPath() {
+        const base = (process.env.ASB_AGENTS_HOME && process.env.ASB_AGENTS_HOME.trim().length > 0)
+            ? process.env.ASB_AGENTS_HOME
+            : os.homedir();
+        return path.join(base, ".gemini", "settings.json");
+    }
+    applyConfig(config) {
+        const path = this.configPath();
+        const agentConfig = loadJsonFile(path, { mcpServers: {} });
+        const merged = mergeMcpIntoAgent(agentConfig, config.mcpServers);
+        saveJsonFile(path, merged);
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/agents/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/agents/gemini.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAwB,MAAM,iBAAiB,CAAC;AAGtG;;GAEG;AACH,8BAA8B;AAE9B;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,EAAE,GAAG,QAAiB,CAAC;IAEhC,UAAU;QACT,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1F,CAAC,CAAE,OAAO,CAAC,GAAG,CAAC,eAA0B;YACzC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACpD,CAAC;IAED,WAAW,CAAC,MAAiE;QAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,YAAY,CAAkB,IAAI,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAoC,CAAC,CAAC;QAC3F,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;CACD"}

package/dist/agents/json-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared JSON file helpers for agent adapters
+ */
+export type JsonAgentConfig = {
+    mcpServers?: Record<string, unknown>;
+} & Record<string, unknown>;
+export declare function loadJsonFile<T extends object>(filePath: string, fallback: T): T;
+export declare function saveJsonFile(filePath: string, data: object): void;
+export declare function mergeMcpIntoAgent(agentConfig: JsonAgentConfig, mcpServers: Record<string, object>): JsonAgentConfig;

package/dist/agents/json-utils.js

@@ -0,0 +1,26 @@
+/**
+ * Shared JSON file helpers for agent adapters
+ */
+import fs from "node:fs";
+export function loadJsonFile(filePath, fallback) {
+    if (!fs.existsSync(filePath))
+        return fallback;
+    const content = fs.readFileSync(filePath, "utf-8");
+    return JSON.parse(content);
+}
+export function saveJsonFile(filePath, data) {
+    const json = `${JSON.stringify(data, null, 2)}\n`;
+    fs.writeFileSync(filePath, json, "utf-8");
+}
+export function mergeMcpIntoAgent(agentConfig, mcpServers) {
+    if (Object.keys(mcpServers).length === 0)
+        return agentConfig;
+    const merged = { ...agentConfig };
+    const target = (merged.mcpServers ??= {});
+    for (const [name, server] of Object.entries(mcpServers)) {
+        const existing = target[name] ?? {};
+        target[name] = { ...existing, ...server };
+    }
+    return merged;
+}
+//# sourceMappingURL=json-utils.js.map

package/dist/agents/json-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-utils.js","sourceRoot":"","sources":["../../src/agents/json-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,MAAM,UAAU,YAAY,CAAmB,QAAgB,EAAE,QAAW;IAC1E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC9C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,IAAY;IACzD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAClD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,WAA4B,EAC5B,UAAkC;IAElC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;IAE7D,MAAM,MAAM,GAAoB,EAAE,GAAG,WAAW,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC;IAE1C,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,MAAM,QAAQ,GAAI,MAAM,CAAC,IAAI,CAA6B,IAAI,EAAE,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/agents/registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Agent adapter registry
+ * Central registry for all supported agent adapters
+ */
+import type { AgentAdapter } from "./adapter.js";
+/**
+ * Get an agent adapter by its ID
+ * @param id - Agent identifier (e.g., "claude-code", "codex", "cursor")
+ * @returns Agent adapter instance
+ * @throws {Error} If agent ID is not supported
+ */
+export declare function getAgentById(id: string): AgentAdapter;
+/**
+ * Get list of all supported agent IDs
+ * @returns Array of agent IDs
+ */
+export declare function supportedAgentIds(): string[];
+/**
+ * Register a new agent adapter
+ * Used for dynamic registration or testing
+ * @param adapter - Agent adapter to register
+ */
+export declare function registerAgent(adapter: AgentAdapter): void;