@darkiceinteractive/mcp-conductor 3.0.0-beta.2 → 3.1.1

package/dist/cli/clients/claude-code.js

@@ -0,0 +1,110 @@
+/**
+ * MCPClientAdapter implementation for Claude Code.
+ *
+ * Claude Code stores MCP servers under the canonical Anthropic `mcpServers` key
+ * in a JSON settings file, so parse() reads the key directly without any field
+ * translation, and serialize() writes it back in the same shape.
+ *
+ * The adapter registers itself in `ADAPTERS` at module load time; callers only
+ * need to `import './claude-code.js'` (done in `index.ts`) to enable it.
+ *
+ * @module cli/clients/claude-code
+ */
+import { existsSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs';
+import { ADAPTERS } from './adapter.js';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Generate a `.bak.YYYYMMDDHHMMSS` path alongside `filePath` and copy the
+ * original file to it.
+ *
+ * Matches the same strategy as `writeBackup` in
+ * `src/cli/commands/import-servers.ts`:
+ * - Derive a 14-digit UTC timestamp from ISO string.
+ * - Guard against sub-second collisions with a 4-char hex salt.
+ *
+ * @returns The path of the backup file written.
+ */
+function writeBackup(filePath) {
+    // toISOString() → "2026-05-05T11:23:45.678Z"; strip non-digits, take first 14.
+    const ts = new Date().toISOString().replace(/\D/g, '').slice(0, 14);
+    let backupPath = `${filePath}.bak.${ts}`;
+    // Sub-second collision guard.
+    if (existsSync(backupPath)) {
+        const salt = Math.floor(Math.random() * 0xffff).toString(16).padStart(4, '0');
+        backupPath = `${backupPath}.${salt}`;
+    }
+    copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+export const CLAUDE_CODE_ADAPTER = {
+    client: 'claude-code',
+    /**
+     * Parse the Claude Code settings file at `path`.
+     *
+     * Returns `null` when the file does not exist, is not valid JSON, or contains
+     * no `mcpServers` entries — allowing callers to skip gracefully.
+     */
+    parse(path) {
+        if (!existsSync(path)) {
+            return null;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+        const mcpServers = raw.mcpServers;
+        if (!mcpServers ||
+            typeof mcpServers !== 'object' ||
+            Object.keys(mcpServers).length === 0) {
+            return null;
+        }
+        // Claude Code uses the canonical Anthropic shape — no field translation needed.
+        const servers = {};
+        for (const [name, entry] of Object.entries(mcpServers)) {
+            if (entry && typeof entry.command === 'string') {
+                servers[name] = {
+                    command: entry.command,
+                    ...(Array.isArray(entry.args) ? { args: entry.args } : {}),
+                    ...(entry.env && typeof entry.env === 'object' ? { env: entry.env } : {}),
+                };
+            }
+        }
+        return { servers, raw };
+    },
+    /**
+     * Write the (potentially modified) config back to disk at `path`.
+     *
+     * Steps:
+     * 1. Write a `.bak.YYYYMMDDHHMMSS` backup if the file already exists.
+     * 2. Start from `config.raw` so non-MCP keys (e.g. `apiKeyHelper`) are kept.
+     * 3. If `keepOnlyConductor` is set, replace `mcpServers` with just the
+     *    conductor entry; otherwise write the full `config.servers` map and
+     *    ensure `"mcp-conductor"` is present and up-to-date.
+     */
+    serialize(path, config, options) {
+        if (existsSync(path)) {
+            writeBackup(path);
+        }
+        // Clone raw to avoid mutating the caller's in-memory config.
+        const output = { ...config.raw };
+        let mcpServers;
+        if (options.keepOnlyConductor) {
+            mcpServers = { 'mcp-conductor': options.conductorEntry };
+        }
+        else {
+            // Spread existing servers then overlay the conductor entry.
+            mcpServers = { ...config.servers };
+            mcpServers['mcp-conductor'] = options.conductorEntry;
+        }
+        output['mcpServers'] = mcpServers;
+        writeFileSync(path, JSON.stringify(output, null, 2) + '\n', 'utf-8');
+    },
+};
+// Side-effect registration: runs when this module is first imported.
+ADAPTERS.set('claude-code', CLAUDE_CODE_ADAPTER);
+//# sourceMappingURL=claude-code.js.map

package/dist/cli/clients/claude-code.js.map

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

package/dist/cli/clients/claude-desktop.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCPClientAdapter implementation for Claude Desktop.
+ *
+ * Claude Desktop stores its MCP server list in a JSON file under:
+ *   - macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   - Linux:   ~/.config/claude/claude_desktop_config.json
+ *   - Windows: %APPDATA%\Claude\claude_desktop_config.json
+ *
+ * The schema is identical to the canonical Anthropic MCP format:
+ *   { mcpServers: { "<name>": { command, args?, env? } } }
+ *
+ * This adapter auto-registers in the ADAPTERS singleton at module load time
+ * so consumers only need to import this file as a side-effect.
+ *
+ * @module cli/clients/claude-desktop
+ */
+import type { MCPClientAdapter } from './adapter.js';
+/**
+ * MCPClientAdapter for Claude Desktop.
+ *
+ * Reads and writes `claude_desktop_config.json` in the canonical Anthropic
+ * `{ command, args, env }` format under the `mcpServers` key.  All non-MCP
+ * top-level keys in the config file are preserved verbatim on every write.
+ */
+export declare const CLAUDE_DESKTOP_ADAPTER: MCPClientAdapter;
+//# sourceMappingURL=claude-desktop.d.ts.map

package/dist/cli/clients/claude-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.d.ts","sourceRoot":"","sources":["../../../src/cli/clients/claude-desktop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EACV,gBAAgB,EAIjB,MAAM,cAAc,CAAC;AAqBtB;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,gBA2FpC,CAAC"}

package/dist/cli/clients/claude-desktop.js

@@ -0,0 +1,118 @@
+/**
+ * MCPClientAdapter implementation for Claude Desktop.
+ *
+ * Claude Desktop stores its MCP server list in a JSON file under:
+ *   - macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
+ *   - Linux:   ~/.config/claude/claude_desktop_config.json
+ *   - Windows: %APPDATA%\Claude\claude_desktop_config.json
+ *
+ * The schema is identical to the canonical Anthropic MCP format:
+ *   { mcpServers: { "<name>": { command, args?, env? } } }
+ *
+ * This adapter auto-registers in the ADAPTERS singleton at module load time
+ * so consumers only need to import this file as a side-effect.
+ *
+ * @module cli/clients/claude-desktop
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { safeJsonParse } from '../../utils/index.js';
+import { writeBackup } from '../commands/import-servers.js';
+import { ADAPTERS } from './adapter.js';
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+/**
+ * MCPClientAdapter for Claude Desktop.
+ *
+ * Reads and writes `claude_desktop_config.json` in the canonical Anthropic
+ * `{ command, args, env }` format under the `mcpServers` key.  All non-MCP
+ * top-level keys in the config file are preserved verbatim on every write.
+ */
+export const CLAUDE_DESKTOP_ADAPTER = {
+    client: 'claude-desktop',
+    /**
+     * Parse `claude_desktop_config.json` at `path` into normalised form.
+     *
+     * Returns `null` when:
+     * - the file does not exist
+     * - the file is not valid JSON
+     * - the file has no `mcpServers` key (or the key is empty)
+     *
+     * The original parsed object is stored in `raw` for round-trip writes.
+     */
+    parse(path) {
+        if (!existsSync(path)) {
+            return null;
+        }
+        let content;
+        try {
+            content = readFileSync(path, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        const raw = safeJsonParse(content, {});
+        const mcpServers = raw.mcpServers;
+        if (!mcpServers || typeof mcpServers !== 'object') {
+            return null;
+        }
+        const servers = {};
+        for (const [name, entry] of Object.entries(mcpServers)) {
+            if (typeof entry.command !== 'string') {
+                // Skip malformed entries rather than crashing.
+                continue;
+            }
+            servers[name] = {
+                command: entry.command,
+                ...(Array.isArray(entry.args) && { args: entry.args }),
+                ...(entry.env && typeof entry.env === 'object' && { env: entry.env }),
+            };
+        }
+        return { servers, raw };
+    },
+    /**
+     * Write a (possibly modified) config back to `path`.
+     *
+     * Steps:
+     * 1. If the file exists, write a `.bak.YYYYMMDDHHMMSS` backup first.
+     * 2. Determine the server map to persist:
+     *    - `keepOnlyConductor: true` → only `{ "mcp-conductor": conductorEntry }`
+     *    - otherwise → merge `config.servers` with `conductorEntry` under
+     *      `"mcp-conductor"` (conductorEntry always wins for that key).
+     * 3. Overlay the resulting `mcpServers` onto `config.raw`, preserving every
+     *    other top-level key unchanged.
+     * 4. Write the resulting JSON with 2-space indentation and a trailing newline.
+     *
+     * Creates parent directories if they do not yet exist (first-time install).
+     */
+    serialize(path, config, options) {
+        const { keepOnlyConductor, conductorEntry } = options;
+        // Write a backup before touching the original (only when it already exists).
+        if (existsSync(path)) {
+            writeBackup(path);
+        }
+        // Build the mcpServers map to persist.
+        const mcpServers = keepOnlyConductor
+            ? { 'mcp-conductor': conductorEntry }
+            : { ...config.servers, 'mcp-conductor': conductorEntry };
+        // Merge into the raw object so non-MCP keys are preserved.
+        const raw = typeof config.raw === 'object' && config.raw !== null
+            ? config.raw
+            : {};
+        const output = { ...raw, mcpServers };
+        // Ensure parent directories exist (first-time write on a fresh install).
+        const dir = dirname(path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(path, JSON.stringify(output, null, 2) + '\n', 'utf-8');
+    },
+};
+// ---------------------------------------------------------------------------
+// Auto-registration
+// ---------------------------------------------------------------------------
+// Register at module load time so any side-effect importer of this file gets
+// the adapter into the ADAPTERS map without needing an explicit call.
+ADAPTERS.set('claude-desktop', CLAUDE_DESKTOP_ADAPTER);
+//# sourceMappingURL=claude-desktop.js.map

package/dist/cli/clients/claude-desktop.js.map

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

package/dist/cli/clients/cline.d.ts

@@ -0,0 +1,40 @@
+/**
+ * MCPClientAdapter for Cline (VS Code extension by Saoud Rizwan).
+ *
+ * Cline stores MCP server definitions in VS Code's per-extension globalStorage
+ * directory.  The path is stable as long as the extension ID remains
+ * `saoudrizwan.claude-dev`.  If Cline ever changes its extension ID the path
+ * returned by the registry becomes stale and the adapter will return `null`
+ * from `parse()` (file not found) rather than throwing.
+ *
+ * Platform paths (registered in `src/cli/clients/registry.ts`):
+ *   macOS   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+ *   Linux   ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+ *   Windows %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
+ *
+ * Config shape:
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "<server-name>": {
+ *       "command": "node",
+ *       "args": ["path/to/server.js"],
+ *       "env": { "KEY": "value" }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * The format is Anthropic-compatible (same shape as Claude Desktop / Claude
+ * Code), so normalisation is straightforward.
+ *
+ * @module cli/clients/cline
+ */
+import type { MCPClientAdapter } from './adapter.js';
+/**
+ * Singleton adapter instance for the Cline VS Code extension.
+ *
+ * Registered in `ADAPTERS` by `src/cli/clients/index.ts` at module load time.
+ */
+export declare const CLINE_ADAPTER: MCPClientAdapter;
+//# sourceMappingURL=cline.d.ts.map

package/dist/cli/clients/cline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline.d.ts","sourceRoot":"","sources":["../../../src/cli/clients/cline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAA4C,MAAM,cAAc,CAAC;AAsI/F;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,gBAA+B,CAAC"}

package/dist/cli/clients/cline.js

@@ -0,0 +1,134 @@
+/**
+ * MCPClientAdapter for Cline (VS Code extension by Saoud Rizwan).
+ *
+ * Cline stores MCP server definitions in VS Code's per-extension globalStorage
+ * directory.  The path is stable as long as the extension ID remains
+ * `saoudrizwan.claude-dev`.  If Cline ever changes its extension ID the path
+ * returned by the registry becomes stale and the adapter will return `null`
+ * from `parse()` (file not found) rather than throwing.
+ *
+ * Platform paths (registered in `src/cli/clients/registry.ts`):
+ *   macOS   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+ *   Linux   ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
+ *   Windows %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
+ *
+ * Config shape:
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "<server-name>": {
+ *       "command": "node",
+ *       "args": ["path/to/server.js"],
+ *       "env": { "KEY": "value" }
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * The format is Anthropic-compatible (same shape as Claude Desktop / Claude
+ * Code), so normalisation is straightforward.
+ *
+ * @module cli/clients/cline
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { writeBackup } from '../../utils/backup.js';
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+const clineAdapter = {
+    client: 'cline',
+    /**
+     * Parse `cline_mcp_settings.json` at `path` into the normalised shape.
+     *
+     * Returns `null` when:
+     * - The file does not exist (Cline not installed or path stale after an
+     *   extension-ID change).
+     * - The file cannot be parsed as JSON.
+     * - `mcpServers` is absent or empty.
+     */
+    parse(path) {
+        if (!existsSync(path)) {
+            return null;
+        }
+        let raw;
+        try {
+            raw = JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch {
+            return null;
+        }
+        const mcpServers = raw.mcpServers ?? {};
+        if (Object.keys(mcpServers).length === 0) {
+            return null;
+        }
+        const servers = {};
+        for (const [name, entry] of Object.entries(mcpServers)) {
+            servers[name] = {
+                command: entry.command,
+                ...(entry.args !== undefined ? { args: entry.args } : {}),
+                ...(entry.env !== undefined ? { env: entry.env } : {}),
+            };
+        }
+        return { servers, raw };
+    },
+    /**
+     * Write a (potentially modified) config back to `path`.
+     *
+     * Steps:
+     * 1. If the file exists, create a `.bak.YYYYMMDDHHMMSS` backup first.
+     * 2. Build the server map: either only the conductor entry
+     *    (`keepOnlyConductor: true`) or all servers from `config.servers` with
+     *    the conductor entry merged in.
+     * 3. Merge the new `mcpServers` map into `config.raw`, preserving any other
+     *    top-level keys Cline may have written.
+     * 4. Write pretty-printed JSON (2-space indent) to `path`, creating parent
+     *    directories if they do not yet exist.
+     */
+    serialize(path, config, options) {
+        // Backup before any destructive operation.
+        if (existsSync(path)) {
+            writeBackup(path);
+        }
+        // Build the server map to write.
+        const serversToWrite = {};
+        if (!options.keepOnlyConductor) {
+            // Carry over every server from the normalised config.
+            for (const [name, entry] of Object.entries(config.servers)) {
+                serversToWrite[name] = {
+                    command: entry.command,
+                    ...(entry.args !== undefined ? { args: entry.args } : {}),
+                    ...(entry.env !== undefined ? { env: entry.env } : {}),
+                };
+            }
+        }
+        // Always ensure the conductor entry is present.
+        serversToWrite['mcp-conductor'] = {
+            command: options.conductorEntry.command,
+            ...(options.conductorEntry.args !== undefined ? { args: options.conductorEntry.args } : {}),
+            ...(options.conductorEntry.env !== undefined ? { env: options.conductorEntry.env } : {}),
+        };
+        // Merge into the original raw object so non-MCP keys are preserved.
+        const output = {
+            ...config.raw,
+            mcpServers: serversToWrite,
+        };
+        // Ensure parent directory exists (first-time setup for users who have
+        // never launched Cline on this machine).
+        const dir = dirname(path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(path, JSON.stringify(output, null, 2), 'utf-8');
+    },
+};
+// ---------------------------------------------------------------------------
+// Exports
+// ---------------------------------------------------------------------------
+/**
+ * Singleton adapter instance for the Cline VS Code extension.
+ *
+ * Registered in `ADAPTERS` by `src/cli/clients/index.ts` at module load time.
+ */
+export const CLINE_ADAPTER = clineAdapter;
+//# sourceMappingURL=cline.js.map

package/dist/cli/clients/cline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cline.js","sourceRoot":"","sources":["../../../src/cli/clients/cline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA2BpD,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,YAAY,GAAqB;IACrC,MAAM,EAAE,OAAO;IAEf;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,GAAgB,CAAC;QACrB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAgB,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAsC,EAAE,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,GAAG;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,IAAY,EAAE,MAA8B,EAAE,OAAyB;QAC/E,2CAA2C;QAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,WAAW,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAED,iCAAiC;QACjC,MAAM,cAAc,GAAqC,EAAE,CAAC;QAE5D,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC/B,sDAAsD;YACtD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3D,cAAc,CAAC,IAAI,CAAC,GAAG;oBACrB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzD,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,cAAc,CAAC,eAAe,CAAC,GAAG;YAChC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,OAAO;YACvC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzF,CAAC;QAEF,oEAAoE;QACpE,MAAM,MAAM,GAAgB;YAC1B,GAAI,MAAM,CAAC,GAAmB;YAC9B,UAAU,EAAE,cAAc;SAC3B,CAAC;QAEF,sEAAsE;QACtE,yCAAyC;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF,CAAC;AAEF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAqB,YAAY,CAAC"}

package/dist/cli/clients/codex.d.ts

@@ -0,0 +1,30 @@
+/**
+ * MCPClientAdapter for the OpenAI Codex CLI.
+ *
+ * Codex stores MCP server definitions in TOML format at:
+ *   Global:  ~/.codex/config.toml
+ *   Project: .codex/config.toml
+ *
+ * Schema:
+ *   [mcp_servers.<name>]
+ *   command = "node"
+ *   args    = ["server.js"]
+ *
+ *   [mcp_servers.<name>.env_vars]
+ *   KEY = "plain-string-value"          # plain env var → normalised env.KEY
+ *
+ *   [mcp_servers.<name>.env_vars.KEY]   # remote-source form → dropped with warning
+ *   name   = "KEY"
+ *   source = "remote"
+ *
+ * Key divergence from the normalised shape:
+ *   - Codex uses `env_vars`, not `env`.
+ *   - `env_vars` values can be plain strings OR `{name, source}` objects.
+ *     Plain strings  → normalised `env` map.
+ *     source="remote" → dropped; warning logged (we don't proxy remote exec).
+ *
+ * @module cli/clients/codex
+ */
+import type { MCPClientAdapter } from './adapter.js';
+export declare const CODEX_ADAPTER: MCPClientAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/cli/clients/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/cli/clients/codex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAOH,OAAO,KAAK,EAAE,gBAAgB,EAA4C,MAAM,cAAc,CAAC;AAuE/F,eAAO,MAAM,aAAa,EAAE,gBA4H3B,CAAC"}

package/dist/cli/clients/codex.js

@@ -0,0 +1,176 @@
+/**
+ * MCPClientAdapter for the OpenAI Codex CLI.
+ *
+ * Codex stores MCP server definitions in TOML format at:
+ *   Global:  ~/.codex/config.toml
+ *   Project: .codex/config.toml
+ *
+ * Schema:
+ *   [mcp_servers.<name>]
+ *   command = "node"
+ *   args    = ["server.js"]
+ *
+ *   [mcp_servers.<name>.env_vars]
+ *   KEY = "plain-string-value"          # plain env var → normalised env.KEY
+ *
+ *   [mcp_servers.<name>.env_vars.KEY]   # remote-source form → dropped with warning
+ *   name   = "KEY"
+ *   source = "remote"
+ *
+ * Key divergence from the normalised shape:
+ *   - Codex uses `env_vars`, not `env`.
+ *   - `env_vars` values can be plain strings OR `{name, source}` objects.
+ *     Plain strings  → normalised `env` map.
+ *     source="remote" → dropped; warning logged (we don't proxy remote exec).
+ *
+ * @module cli/clients/codex
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import TOML from '@iarna/toml';
+import { writeBackup } from '../../utils/backup.js';
+import { ADAPTERS } from './adapter.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Translate a Codex `env_vars` map into the normalised `env` map.
+ *
+ * - Plain string values → `{ KEY: value }`
+ * - `{ source: "remote" }` objects → dropped with a console warning.
+ * - Any other unexpected shape → dropped silently.
+ */
+function normaliseEnvVars(envVars, serverName) {
+    const env = {};
+    for (const [key, value] of Object.entries(envVars)) {
+        if (typeof value === 'string') {
+            env[key] = value;
+        }
+        else if (typeof value === 'object' &&
+            value !== null &&
+            'source' in value &&
+            value['source'] === 'remote') {
+            // Remote-source env vars require Codex's own remote execution pipeline.
+            // mcp-conductor does not proxy remote exec — drop and warn.
+            console.warn(`[codex-adapter] server "${serverName}": env_vars.${key} has source="remote" ` +
+                `— skipped (remote-exec env vars are not supported by mcp-conductor).`);
+        }
+        // Other unexpected shapes are silently dropped.
+    }
+    return env;
+}
+/**
+ * Translate the normalised `env` map back to Codex `env_vars` plain-string form.
+ */
+function denormaliseEnv(env) {
+    return env ?? {};
+}
+// ---------------------------------------------------------------------------
+// CODEX_ADAPTER singleton
+// ---------------------------------------------------------------------------
+export const CODEX_ADAPTER = {
+    client: 'codex',
+    /**
+     * Parse `~/.codex/config.toml` (or a project-local equivalent) into the
+     * normalised shape.
+     *
+     * Returns `null` when:
+     * - The file does not exist.
+     * - The file cannot be parsed as valid TOML.
+     * - The file contains no `[mcp_servers]` table (or it is empty).
+     */
+    parse(path) {
+        if (!existsSync(path))
+            return null;
+        let raw;
+        try {
+            const content = readFileSync(path, 'utf-8');
+            raw = TOML.parse(content);
+        }
+        catch {
+            return null;
+        }
+        const mcpServers = raw.mcp_servers;
+        if (!mcpServers ||
+            typeof mcpServers !== 'object' ||
+            Object.keys(mcpServers).length === 0) {
+            return null;
+        }
+        const servers = {};
+        for (const [name, server] of Object.entries(mcpServers)) {
+            if (!server || typeof server !== 'object')
+                continue;
+            const command = server.command;
+            if (typeof command !== 'string' || command.trim() === '')
+                continue;
+            const args = Array.isArray(server.args)
+                ? server.args.filter((a) => typeof a === 'string')
+                : undefined;
+            const rawEnvVars = server.env_vars;
+            const env = rawEnvVars && typeof rawEnvVars === 'object'
+                ? normaliseEnvVars(rawEnvVars, name)
+                : undefined;
+            servers[name] = {
+                command,
+                ...(args !== undefined && { args }),
+                ...(env !== undefined && Object.keys(env).length > 0 && { env }),
+            };
+        }
+        return { servers, raw };
+    },
+    /**
+     * Write the normalised config back to `path` as TOML.
+     *
+     * 1. Determines which servers to include (all vs. conductor-only).
+     * 2. Ensures `conductorEntry` is present under `"mcp-conductor"`.
+     * 3. Preserves all non-`mcp_servers` top-level keys from `config.raw`.
+     * 4. Creates a `.bak.YYYYMMDDHHMMSS` backup if the file already exists.
+     * 5. Serialises to TOML and writes via `writeFileSync`.
+     */
+    serialize(path, config, options) {
+        const { keepOnlyConductor, conductorEntry } = options;
+        // Preserve non-mcp_servers top-level keys from the original raw config.
+        const rawRoot = (config.raw && typeof config.raw === 'object' ? config.raw : {});
+        // Build the mcp_servers table.
+        const mcpServers = {};
+        if (!keepOnlyConductor) {
+            for (const [name, entry] of Object.entries(config.servers)) {
+                mcpServers[name] = {
+                    command: entry.command,
+                    ...(entry.args !== undefined && { args: entry.args }),
+                    ...(entry.env && Object.keys(entry.env).length > 0
+                        ? { env_vars: denormaliseEnv(entry.env) }
+                        : {}),
+                };
+            }
+        }
+        // Always ensure mcp-conductor is present (add or overwrite).
+        mcpServers['mcp-conductor'] = {
+            command: conductorEntry.command,
+            ...(conductorEntry.args !== undefined && { args: conductorEntry.args }),
+            ...(conductorEntry.env && Object.keys(conductorEntry.env).length > 0
+                ? { env_vars: denormaliseEnv(conductorEntry.env) }
+                : {}),
+        };
+        // Compose final TOML object: preserve other top-level keys, then mcp_servers.
+        const tomlObj = {};
+        for (const [k, v] of Object.entries(rawRoot)) {
+            if (k !== 'mcp_servers') {
+                tomlObj[k] = v;
+            }
+        }
+        tomlObj['mcp_servers'] = mcpServers;
+        // Backup existing file before any write.
+        if (existsSync(path)) {
+            writeBackup(path);
+        }
+        // Ensure the parent directory exists (project-local .codex/ may not exist yet).
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, TOML.stringify(tomlObj), 'utf-8');
+    },
+};
+// ---------------------------------------------------------------------------
+// Auto-register in the ADAPTERS map at module load time.
+// ---------------------------------------------------------------------------
+ADAPTERS.set('codex', CODEX_ADAPTER);
+//# sourceMappingURL=codex.js.map