cssprobe-cli 0.2.26 → 0.3.1

package/dist/daemon/flowRunner.js

@@ -0,0 +1,155 @@
+"use strict";
+// Flow script runner: loads a user script in the daemon process, injects the
+// interaction API, captures console output and returns a result envelope.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFlowScript = loadFlowScript;
+exports.runFlow = runFlow;
+const path_1 = __importDefault(require("path"));
+const util_1 = __importDefault(require("util"));
+const url_1 = require("url");
+const interactions_1 = require("../browser/interactions");
+const analyzer_1 = require("../engine/analyzer");
+const renderer_1 = require("../engine/renderer");
+const evalSerializer_1 = require("../engine/evalSerializer");
+const screenshot_1 = require("../utils/screenshot");
+const FLOW_DEFAULT_TIMEOUT = 300_000;
+const CAPTURED_CONSOLE_METHODS = ['log', 'info', 'warn', 'error'];
+// tsc compiles `import()` to `require()` under module=commonjs, which cannot
+// load ESM scripts; a Function-constructed import keeps the native loader.
+const nativeImport = new Function('p', 'return import(p)');
+async function loadFlowScript(absPath) {
+    const mod = await nativeImport(`${(0, url_1.pathToFileURL)(absPath).href}?v=${Date.now()}`);
+    const fn = mod?.default;
+    if (typeof fn !== 'function')
+        throw new Error(`Flow script must default-export an async function: ${absPath}`);
+    return fn;
+}
+function captureConsole(logs) {
+    const originals = new Map();
+    for (const method of CAPTURED_CONSOLE_METHODS) {
+        originals.set(method, console[method]);
+        console[method] = (...args) => {
+            logs.push(`[${method}] ${util_1.default.format(...args)}`);
+        };
+    }
+    return () => {
+        for (const [method, original] of originals) {
+            console[method] = original;
+        }
+    };
+}
+async function withTimeout(promise, timeoutMs) {
+    if (!timeoutMs || timeoutMs <= 0)
+        return promise;
+    let timer;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`Flow timed out after ${timeoutMs}ms (best-effort abort)`)), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function requirePage(launcher) {
+    const page = launcher.getPage();
+    if (!page)
+        throw new Error('Browser is not open. Run: cssprobe-cli open <url>');
+    return page;
+}
+async function flowWaitFor(page, target, opts) {
+    if (typeof target === 'string') {
+        const state = opts?.state ?? 'visible';
+        const timeout = opts?.timeout ?? 30_000;
+        const elapsedMs = await (0, interactions_1.waitForCondition)(page, { kind: 'selector', selector: target, state }, timeout);
+        return { waitedFor: 'selector', state, elapsedMs };
+    }
+    if ('js' in target) {
+        const timeout = target.timeout ?? 30_000;
+        const elapsedMs = await (0, interactions_1.waitForCondition)(page, { kind: 'js', expression: target.js }, timeout);
+        return { waitedFor: 'js', elapsedMs };
+    }
+    if (target.networkIdle) {
+        const timeout = target.timeout ?? 30_000;
+        const elapsedMs = await (0, interactions_1.waitForCondition)(page, { kind: 'networkIdle' }, timeout);
+        return { waitedFor: 'networkidle', elapsedMs };
+    }
+    throw new Error('waitFor requires a selector string, { js }, or { networkIdle: true }');
+}
+function buildFlowApi(launcher, logs, baseDir) {
+    const page = requirePage(launcher);
+    return {
+        page,
+        click: (selector, opts) => (0, interactions_1.clickElement)(page, selector, opts),
+        hover: (selector, opts) => (0, interactions_1.hoverElement)(page, selector, opts),
+        type: (selector, text, opts) => (0, interactions_1.typeInto)(page, selector, text, opts),
+        waitFor: (target, opts) => flowWaitFor(page, target, opts),
+        inspect: async (selector, opts) => {
+            const snapshot = await launcher.collect({
+                rootSelector: selector,
+                downDepth: 6,
+                maxNodes: 60,
+                upTo: 'html',
+            });
+            const findings = (0, analyzer_1.analyze)(snapshot);
+            if (opts?.format === 'markdown')
+                return (0, renderer_1.renderMarkdown)(snapshot, findings);
+            return { snapshot, findings };
+        },
+        screenshot: async (opts) => {
+            const buffer = await page.screenshot({ fullPage: opts?.fullPage });
+            const out = opts?.path ? path_1.default.resolve(baseDir, opts.path) : undefined;
+            return (0, screenshot_1.saveScreenshotFile)(`data:image/png;base64,${buffer.toString('base64')}`, out);
+        },
+        log: (...args) => {
+            logs.push(util_1.default.format(...args));
+        },
+    };
+}
+function renderEnvelope(env) {
+    const lines = [];
+    if (env.ok) {
+        lines.push(`Flow completed in ${env.elapsedMs}ms`);
+        if (env.result !== undefined)
+            lines.push(`Result: ${JSON.stringify(env.result, null, 2)}`);
+    }
+    else {
+        lines.push(`Flow failed in ${env.elapsedMs}ms: ${env.error}`);
+    }
+    if (env.logs.length) {
+        lines.push('', 'Logs:');
+        lines.push(...env.logs.map(line => `  ${line}`));
+    }
+    return lines.join('\n');
+}
+async function runFlow(launcher, absPath, opts = {}) {
+    const logs = [];
+    const started = Date.now();
+    const restore = captureConsole(logs);
+    let env;
+    try {
+        const fn = await loadFlowScript(absPath);
+        const api = buildFlowApi(launcher, logs, path_1.default.dirname(absPath));
+        const result = await withTimeout(Promise.resolve(fn(api)), opts.timeout ?? FLOW_DEFAULT_TIMEOUT);
+        env = { ok: true, logs, elapsedMs: Date.now() - started };
+        if (result !== undefined)
+            env.result = (0, evalSerializer_1.serializeEvalResult)(result);
+    }
+    catch (e) {
+        env = { ok: false, logs, error: e.message, elapsedMs: Date.now() - started };
+    }
+    finally {
+        restore();
+    }
+    return {
+        text: opts.json ? JSON.stringify(env, null, 2) : renderEnvelope(env),
+        exitCode: env.ok ? 0 : 1,
+    };
+}
+//# sourceMappingURL=flowRunner.js.map

package/dist/engine/evalSerializer.d.ts

@@ -0,0 +1 @@
+export declare function serializeEvalResult(value: unknown): unknown;

package/dist/engine/evalSerializer.js

@@ -0,0 +1,43 @@
+"use strict";
+// Self-contained serializer for eval results.
+// Runs inside the page via JSHandle.evaluate (function source is transferred),
+// and is unit-testable in Node — keep it free of external references.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeEvalResult = serializeEvalResult;
+function serializeEvalResult(value) {
+    const seen = new WeakSet();
+    const walk = (v, depth) => {
+        if (v === null || typeof v !== 'object') {
+            if (typeof v === 'function')
+                return `[Function: ${v.name || 'anonymous'}]`;
+            if (typeof v === 'bigint')
+                return `${v}n`;
+            return v;
+        }
+        if (typeof Node !== 'undefined' && v instanceof Node) {
+            if (v.nodeType === 1) {
+                const el = v;
+                return {
+                    tag: el.tagName.toLowerCase(),
+                    id: el.id,
+                    classes: Array.from(el.classList),
+                    text: (el.textContent ?? '').trim().slice(0, 120),
+                };
+            }
+            return `[${v.nodeName}]`;
+        }
+        if (seen.has(v))
+            return '[Circular]';
+        if (depth >= 6)
+            return '[Depth limit]';
+        seen.add(v);
+        if (Array.isArray(v))
+            return v.map(item => walk(item, depth + 1));
+        const out = {};
+        for (const [key, val] of Object.entries(v))
+            out[key] = walk(val, depth + 1);
+        return out;
+    };
+    return walk(value, 0);
+}
+//# sourceMappingURL=evalSerializer.js.map

package/dist/help.json

@@ -1,5 +1,5 @@
 {
-  "global": "Usage: cssprobe-cli <command> [args] [options]\n\n\nSession Management:\n  open [url]                  open browser in session mode (non-blocking)\n  close                       close the browser session\n  status                      show current session status\n  resize <width> <height>     resize the browser viewport\n  eval <expression>           evaluate javascript expression on the page (browser context)\n  playwright <call>           execute playwright api call (node.js context)\n  state-import [file]         import cookies from netscape format file\n  state-save                  save current browser session state (cookies + localstorage)\n\nCSS Inspection:\n  inspect <selector>          inspect the runtime css of a page element\n  tree <selector>             show dom tree structure\n  layout <selector>           show ascii layout diagram\n  findings <selector>         show only issues/warnings/errors\n  inject-css <css>            inject css into the current page\n\nExport:\n  screenshot                  take a screenshot of the current page\n\nConfiguration:\n  config-show                 show current configuration\n  config-set <key> <value>    set a configuration value\n  config-list                 list all profiles\n  config-use <name>           switch active profile\n  config-new <name>           create a new profile\n  config-path                 show configuration file path\n\nAgent Skills:\n  skill-install               install agent skill for cssprobe-cli\n  skill-uninstall             remove agent skill for cssprobe-cli\n\nGlobal options:\n  --help [command]            print help\n  --json                      output response as JSON\n  --raw                       output only the result value\n  --version                   print version\n  -p, --profile <name>        use named profile (or CSSPROBE_PROFILE env)",
+  "global": "Usage: cssprobe-cli <command> [args] [options]\n\n\nSession Management:\n  open [url]                  open browser in session mode (non-blocking)\n  close                       close the browser session\n  status                      show current session status\n  resize <width> <height>     resize the browser viewport\n  eval <expression>           evaluate javascript expression on the page (browser context)\n  playwright <call>           execute playwright api call (node.js context)\n  click <selector>            click an element with real mouse events (works with custom react components)\n  hover <selector>            hover an element with real mouse events\n  type <selector> <text>      type text into an element (fill by default; --sequential for real key events)\n  wait-for [selector]         wait for a condition: selector state, js predicate, or network idle\n  run <file>                  run a multi-step flow script (default-exports an async function receiving the api object)\n  state-import [file]         import cookies from netscape format file\n  state-save                  save current browser session state (cookies + localstorage)\n  mcp                         start mcp server (stdio transport) for ai clients\n  mcp-install                 install mcp server config into ai client configs\n  mcp-uninstall               remove mcp server config from ai client configs\n\nCSS Inspection:\n  inspect <selector>          inspect the runtime css of a page element\n  tree <selector>             show dom tree structure\n  layout <selector>           show ascii layout diagram\n  findings <selector>         show only issues/warnings/errors\n  inject-css <css>            inject css into the current page\n\nExport:\n  screenshot                  take a screenshot of the current page\n\nConfiguration:\n  config-show                 show current configuration\n  config-set <key> <value>    set a configuration value\n  config-list                 list all profiles\n  config-use <name>           switch active profile\n  config-new <name>           create a new profile\n  config-path                 show configuration file path\n\nAgent Skills:\n  skill-install               install agent skill for cssprobe-cli\n  skill-uninstall             remove agent skill for cssprobe-cli\n\nGlobal options:\n  --help [command]            print help\n  --json                      output response as JSON\n  --raw                       output only the result value\n  --version                   print version\n  -p, --profile <name>        use named profile (or CSSPROBE_PROFILE env)",
   "commands": {
     "open": {
       "help": "cssprobe-cli open [url]\n\nOpen browser in session mode (non-blocking)\n\nArguments:\n  [url]                       url, file:// path, or local html file path\nOptions:\n  --browser                   browser engine (default chromium)\n  --headed                    show the browser window\n  --viewport                  viewport size as wxh (e.g. 1280x720)\n  --state                     path to saved state file (cookies + localstorage)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
@@ -97,6 +97,64 @@
       },
       "args": []
     },
+    "click": {
+      "help": "cssprobe-cli click <selector>\n\nClick an element with real mouse events (works with custom React components)\n\nArguments:\n  <selector>                  css selector\nOptions:\n  --nth                       1-based match index (default: first match)\n  --force                     skip actionability checks\n  --timeout                   action timeout in ms (default 30000)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "nth": "string",
+        "force": "boolean",
+        "timeout": "string"
+      },
+      "args": [
+        "selector"
+      ]
+    },
+    "hover": {
+      "help": "cssprobe-cli hover <selector>\n\nHover an element with real mouse events\n\nArguments:\n  <selector>                  css selector\nOptions:\n  --nth                       1-based match index (default: first match)\n  --force                     skip actionability checks\n  --timeout                   action timeout in ms (default 30000)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "nth": "string",
+        "force": "boolean",
+        "timeout": "string"
+      },
+      "args": [
+        "selector"
+      ]
+    },
+    "type": {
+      "help": "cssprobe-cli type <selector> <text>\n\nType text into an element (fill by default; --sequential for real key events)\n\nArguments:\n  <selector>                  css selector\n  <text>                      text to type\nOptions:\n  --press                     key to press after typing (e.g. enter, tab, control+a)\n  --sequential                type with real key events (for custom editors)\n  --clear                     clear existing content before sequential typing\n  --delay                     delay between keystrokes in ms (--sequential, default 0)\n  --nth                       1-based match index (default: first match)\n  --timeout                   action timeout in ms (default 30000)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "press": "string",
+        "sequential": "boolean",
+        "clear": "boolean",
+        "delay": "string",
+        "nth": "string",
+        "timeout": "string"
+      },
+      "args": [
+        "selector",
+        "text"
+      ]
+    },
+    "wait-for": {
+      "help": "cssprobe-cli wait-for [selector]\n\nWait for a condition: selector state, JS predicate, or network idle\n\nArguments:\n  [selector]                  css selector to wait for\nOptions:\n  --state                     selector state to wait for (default visible)\n  --js                        js predicate, e.g. \"() => document.queryselector('.x')?.offsetheight > 100\"\n  --network-idle              wait until the page is network-idle\n  --timeout                   timeout in ms (default 30000)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "state": "string",
+        "js": "string",
+        "network-idle": "boolean",
+        "timeout": "string"
+      },
+      "args": [
+        "selector"
+      ]
+    },
+    "run": {
+      "help": "cssprobe-cli run <file>\n\nRun a multi-step flow script (default-exports an async function receiving the API object)\n\nArguments:\n  <file>                      flow script path (.js / .mjs / .cjs)\nOptions:\n  --timeout                   whole-script timeout in ms (default 300000, 0 = unlimited)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "timeout": "string"
+      },
+      "args": [
+        "file"
+      ]
+    },
     "state-import": {
       "help": "cssprobe-cli state-import [file]\n\nImport cookies from Netscape format file\n\nArguments:\n  [file]                      netscape cookie file path (reads from stdin if omitted)\nOptions:\n  --out                       output state file path (default: ~/.cssprobe-cli/states/imported.json)\n  --name                      custom name for the state file (e.g. mysite or mysite.json)\n  --merge                     existing state file to merge into\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
       "flags": {
@@ -173,6 +231,27 @@
         "path": "string"
       },
       "args": []
+    },
+    "mcp": {
+      "help": "cssprobe-cli mcp \n\nStart MCP server (stdio transport) for AI clients\n\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {},
+      "args": []
+    },
+    "mcp-install": {
+      "help": "cssprobe-cli mcp-install \n\nInstall MCP server config into AI client configs\n\nOptions:\n  --target                    client target: auto, all, none, claude, cursor, codex, opencode, hermes, gemini (default: auto)\n  --local                     write project-local config instead of global\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "target": "string",
+        "local": "boolean"
+      },
+      "args": []
+    },
+    "mcp-uninstall": {
+      "help": "cssprobe-cli mcp-uninstall \n\nRemove MCP server config from AI client configs\n\nOptions:\n  --target                    client target: auto, all, none, claude, cursor, codex, opencode, hermes, gemini (default: auto)\n  --local                     remove project-local config instead of global\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "target": "string",
+        "local": "boolean"
+      },
+      "args": []
     }
   },
   "booleanOptions": [
@@ -182,6 +261,10 @@
     "brief",
     "layout",
     "full-page",
+    "force",
+    "sequential",
+    "clear",
+    "network-idle",
     "local"
   ]
 }

package/dist/installer/index.d.ts

@@ -1,3 +1,5 @@
 export { buildSkillMd, buildPitfallsMd } from './skill-template';
 export { ALL_TARGETS, getTarget, listTargetIds, resolveTargetFlag } from './targets/registry';
 export type { AgentTarget, Location, TargetId, WriteResult } from './targets/types';
+export { installMcpConfig, uninstallMcpConfig, listMcpClientIds, MCP_SERVER_NAME } from './mcp';
+export type { McpCommandResult, McpFileResult } from './mcp';

package/dist/installer/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveTargetFlag = exports.listTargetIds = exports.getTarget = exports.ALL_TARGETS = exports.buildPitfallsMd = exports.buildSkillMd = void 0;
+exports.MCP_SERVER_NAME = exports.listMcpClientIds = exports.uninstallMcpConfig = exports.installMcpConfig = exports.resolveTargetFlag = exports.listTargetIds = exports.getTarget = exports.ALL_TARGETS = exports.buildPitfallsMd = exports.buildSkillMd = void 0;
 var skill_template_1 = require("./skill-template");
 Object.defineProperty(exports, "buildSkillMd", { enumerable: true, get: function () { return skill_template_1.buildSkillMd; } });
 Object.defineProperty(exports, "buildPitfallsMd", { enumerable: true, get: function () { return skill_template_1.buildPitfallsMd; } });
@@ -9,4 +9,9 @@ Object.defineProperty(exports, "ALL_TARGETS", { enumerable: true, get: function
 Object.defineProperty(exports, "getTarget", { enumerable: true, get: function () { return registry_1.getTarget; } });
 Object.defineProperty(exports, "listTargetIds", { enumerable: true, get: function () { return registry_1.listTargetIds; } });
 Object.defineProperty(exports, "resolveTargetFlag", { enumerable: true, get: function () { return registry_1.resolveTargetFlag; } });
+var mcp_1 = require("./mcp");
+Object.defineProperty(exports, "installMcpConfig", { enumerable: true, get: function () { return mcp_1.installMcpConfig; } });
+Object.defineProperty(exports, "uninstallMcpConfig", { enumerable: true, get: function () { return mcp_1.uninstallMcpConfig; } });
+Object.defineProperty(exports, "listMcpClientIds", { enumerable: true, get: function () { return mcp_1.listMcpClientIds; } });
+Object.defineProperty(exports, "MCP_SERVER_NAME", { enumerable: true, get: function () { return mcp_1.MCP_SERVER_NAME; } });
 //# sourceMappingURL=index.js.map

package/dist/installer/mcp.d.ts

@@ -0,0 +1,14 @@
+import type { Location, TargetId } from './targets/types';
+export declare const MCP_SERVER_NAME = "cssprobe-cli";
+export interface McpFileResult {
+    path: string;
+    action: 'created' | 'updated' | 'unchanged' | 'removed' | 'not-found' | 'kept';
+    agent: string;
+}
+export interface McpCommandResult {
+    files: McpFileResult[];
+    notes: string[];
+}
+export declare function installMcpConfig(loc: Location, targetFlag?: string): McpCommandResult;
+export declare function uninstallMcpConfig(loc: Location, targetFlag?: string): McpCommandResult;
+export declare function listMcpClientIds(): TargetId[];

package/dist/installer/mcp.js

@@ -0,0 +1,274 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_SERVER_NAME = void 0;
+exports.installMcpConfig = installMcpConfig;
+exports.uninstallMcpConfig = uninstallMcpConfig;
+exports.listMcpClientIds = listMcpClientIds;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const shared_1 = require("./targets/shared");
+const toml_1 = require("./toml");
+exports.MCP_SERVER_NAME = 'cssprobe-cli';
+const jsonEntry = () => ({ type: 'stdio', command: exports.MCP_SERVER_NAME, args: ['mcp'] });
+const opencodeEntry = () => ({ type: 'local', command: [exports.MCP_SERVER_NAME, 'mcp'], enabled: true });
+function home(...parts) {
+    return path.join(os.homedir(), ...parts);
+}
+function dirExists(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function fileExists(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function opencodeGlobalPath() {
+    const newStyleDir = home('.opencode');
+    if (dirExists(newStyleDir) || fileExists(path.join(newStyleDir, 'opencode.json'))) {
+        return path.join(newStyleDir, 'opencode.json');
+    }
+    return home('.config', 'opencode', 'opencode.json');
+}
+const CLIENTS = [
+    {
+        id: 'claude',
+        displayName: 'Claude Code',
+        format: 'json',
+        supportsLocal: true,
+        configPath: (loc) => (loc === 'global' ? home('.claude.json') : path.join(process.cwd(), '.mcp.json')),
+        detect: (loc) => (loc === 'global' ? fileExists(home('.claude.json')) || dirExists(home('.claude')) : dirExists(path.join(process.cwd(), '.claude'))),
+        serversKey: 'mcpServers',
+        buildEntry: jsonEntry,
+    },
+    {
+        id: 'cursor',
+        displayName: 'Cursor',
+        format: 'json',
+        supportsLocal: true,
+        configPath: (loc) => (loc === 'global' ? home('.cursor', 'mcp.json') : path.join(process.cwd(), '.cursor', 'mcp.json')),
+        detect: (loc) => dirExists(loc === 'global' ? home('.cursor') : path.join(process.cwd(), '.cursor')),
+        serversKey: 'mcpServers',
+        buildEntry: jsonEntry,
+    },
+    {
+        id: 'gemini',
+        displayName: 'Gemini CLI',
+        format: 'json',
+        supportsLocal: false,
+        configPath: () => home('.gemini', 'mcp_settings.json'),
+        detect: () => dirExists(home('.gemini')),
+        serversKey: 'mcpServers',
+        buildEntry: jsonEntry,
+    },
+    {
+        id: 'hermes',
+        displayName: 'Hermes',
+        format: 'json',
+        supportsLocal: false,
+        configPath: () => home('.hermes', 'mcp.json'),
+        detect: () => dirExists(home('.hermes')),
+        serversKey: 'mcpServers',
+        buildEntry: jsonEntry,
+    },
+    {
+        id: 'opencode',
+        displayName: 'opencode',
+        format: 'json',
+        supportsLocal: true,
+        configPath: (loc) => (loc === 'global' ? opencodeGlobalPath() : path.join(process.cwd(), 'opencode.json')),
+        detect: (loc) => dirExists(loc === 'global' ? home('.opencode') : path.join(process.cwd(), '.opencode')) || (loc === 'global' && dirExists(home('.config', 'opencode'))),
+        serversKey: 'mcp',
+        buildEntry: opencodeEntry,
+    },
+    {
+        id: 'codex',
+        displayName: 'Codex CLI',
+        format: 'toml',
+        supportsLocal: false,
+        configPath: () => home('.codex', 'config.toml'),
+        detect: () => dirExists(home('.codex')),
+        table: `mcp_servers.${exports.MCP_SERVER_NAME}`,
+        buildBlock: () => (0, toml_1.buildTomlTable)(`mcp_servers.${exports.MCP_SERVER_NAME}`, { command: exports.MCP_SERVER_NAME, args: ['mcp'] }),
+    },
+];
+function resolveClients(targetFlag, loc) {
+    const notes = [];
+    const allowed = CLIENTS.filter((c) => loc === 'global' || c.supportsLocal);
+    if (targetFlag === 'none')
+        return { clients: [], notes };
+    if (targetFlag === 'all') {
+        if (loc === 'local')
+            notes.push('Local location only applies to claude / cursor / opencode; other clients are global-only.');
+        return { clients: [...allowed], notes };
+    }
+    if (targetFlag === 'auto') {
+        const detected = allowed.filter((c) => c.detect(loc));
+        if (detected.length === 0) {
+            notes.push('No MCP client configs detected. Use --target=all or --target=<id,...> to force.');
+        }
+        return { clients: detected, notes };
+    }
+    const ids = targetFlag.split(',').map((s) => s.trim()).filter(Boolean);
+    const resolved = [];
+    const unknown = [];
+    for (const id of ids) {
+        const client = CLIENTS.find((c) => c.id === id);
+        if (!client) {
+            unknown.push(id);
+            continue;
+        }
+        if (loc === 'local' && !client.supportsLocal) {
+            notes.push(`${client.displayName} has no project-local MCP config; skipped.`);
+            continue;
+        }
+        resolved.push(client);
+    }
+    if (unknown.length > 0) {
+        const known = CLIENTS.map((c) => c.id).join(', ');
+        throw new Error(`Unknown --target id(s): ${unknown.join(', ')}. Known: ${known}, plus 'auto' / 'all' / 'none'.`);
+    }
+    return { clients: resolved, notes };
+}
+function installJson(client, loc) {
+    const file = client.configPath(loc);
+    if (!fileExists(file)) {
+        const data = {};
+        data[client.serversKey] = { [exports.MCP_SERVER_NAME]: client.buildEntry() };
+        (0, shared_1.atomicWriteFileSync)(file, JSON.stringify(data, null, 2) + '\n');
+        return { result: { path: file, action: 'created', agent: client.displayName } };
+    }
+    const raw = fs.readFileSync(file, 'utf-8');
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        return {
+            result: { path: file, action: 'kept', agent: client.displayName },
+            note: `${file} is not valid JSON — skipped (left untouched).`,
+        };
+    }
+    const before = JSON.stringify(data[client.serversKey]?.[exports.MCP_SERVER_NAME] ?? null);
+    const after = JSON.stringify(client.buildEntry());
+    if (before === after) {
+        return { result: { path: file, action: 'unchanged', agent: client.displayName } };
+    }
+    if (!data[client.serversKey])
+        data[client.serversKey] = {};
+    data[client.serversKey][exports.MCP_SERVER_NAME] = client.buildEntry();
+    (0, shared_1.atomicWriteFileSync)(file, JSON.stringify(data, null, 2) + '\n');
+    return { result: { path: file, action: 'updated', agent: client.displayName } };
+}
+function uninstallJson(client, loc) {
+    const file = client.configPath(loc);
+    if (!fileExists(file)) {
+        return { result: { path: file, action: 'not-found', agent: client.displayName } };
+    }
+    const raw = fs.readFileSync(file, 'utf-8');
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        return {
+            result: { path: file, action: 'kept', agent: client.displayName },
+            note: `${file} is not valid JSON — skipped (left untouched).`,
+        };
+    }
+    if (!data[client.serversKey]?.[exports.MCP_SERVER_NAME]) {
+        return { result: { path: file, action: 'not-found', agent: client.displayName } };
+    }
+    delete data[client.serversKey][exports.MCP_SERVER_NAME];
+    if (Object.keys(data[client.serversKey]).length === 0)
+        delete data[client.serversKey];
+    (0, shared_1.atomicWriteFileSync)(file, JSON.stringify(data, null, 2) + '\n');
+    return { result: { path: file, action: 'removed', agent: client.displayName } };
+}
+function installToml(client, loc) {
+    const file = client.configPath(loc);
+    const existing = fileExists(file) ? fs.readFileSync(file, 'utf-8') : '';
+    const { content, action } = (0, toml_1.upsertTomlTable)(existing, client.table, client.buildBlock());
+    if (action === 'unchanged') {
+        return { result: { path: file, action: 'unchanged', agent: client.displayName } };
+    }
+    (0, shared_1.atomicWriteFileSync)(file, content);
+    return { result: { path: file, action: action === 'inserted' ? 'created' : 'updated', agent: client.displayName } };
+}
+function uninstallToml(client, loc) {
+    const file = client.configPath(loc);
+    if (!fileExists(file)) {
+        return { result: { path: file, action: 'not-found', agent: client.displayName } };
+    }
+    const existing = fs.readFileSync(file, 'utf-8');
+    const { content, action } = (0, toml_1.removeTomlTable)(existing, client.table);
+    if (action === 'not-found') {
+        return { result: { path: file, action: 'not-found', agent: client.displayName } };
+    }
+    (0, shared_1.atomicWriteFileSync)(file, content);
+    return { result: { path: file, action: 'removed', agent: client.displayName } };
+}
+function run(mode, loc, targetFlag) {
+    const { clients, notes } = resolveClients(targetFlag, loc);
+    const files = [];
+    for (const client of clients) {
+        const handled = mode === 'install'
+            ? (client.format === 'json' ? installJson(client, loc) : installToml(client, loc))
+            : (client.format === 'json' ? uninstallJson(client, loc) : uninstallToml(client, loc));
+        files.push(handled.result);
+        if (handled.note)
+            notes.push(handled.note);
+    }
+    return { files, notes };
+}
+function installMcpConfig(loc, targetFlag = 'auto') {
+    return run('install', loc, targetFlag);
+}
+function uninstallMcpConfig(loc, targetFlag = 'auto') {
+    return run('uninstall', loc, targetFlag);
+}
+function listMcpClientIds() {
+    return CLIENTS.map((c) => c.id);
+}
+//# sourceMappingURL=mcp.js.map