cssprobe-cli 0.2.25 → 0.3.0

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

package/dist/installer/toml.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Tiny TOML helpers — just enough to inject / replace / remove a single
+ * dotted-key table block (`[mcp_servers.cssprobe-cli]`) inside an existing
+ * `~/.codex/config.toml`. We deliberately do NOT try to be a general TOML
+ * parser/serializer.
+ *
+ * Strategy: treat the file as text. Find the header line, splice it (and the
+ * lines that follow it until the next `[...]` header or EOF) in or out.
+ * Everything outside that block is preserved verbatim.
+ */
+export declare function serializeTomlTableBody(values: Record<string, string | string[]>): string;
+export declare function buildTomlTable(header: string, values: Record<string, string | string[]>): string;
+export declare function upsertTomlTable(fileContent: string, header: string, block: string): {
+    content: string;
+    action: 'inserted' | 'replaced' | 'unchanged';
+};
+export declare function removeTomlTable(fileContent: string, header: string): {
+    content: string;
+    action: 'removed' | 'not-found';
+};

package/dist/installer/toml.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Tiny TOML helpers — just enough to inject / replace / remove a single
+ * dotted-key table block (`[mcp_servers.cssprobe-cli]`) inside an existing
+ * `~/.codex/config.toml`. We deliberately do NOT try to be a general TOML
+ * parser/serializer.
+ *
+ * Strategy: treat the file as text. Find the header line, splice it (and the
+ * lines that follow it until the next `[...]` header or EOF) in or out.
+ * Everything outside that block is preserved verbatim.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeTomlTableBody = serializeTomlTableBody;
+exports.buildTomlTable = buildTomlTable;
+exports.upsertTomlTable = upsertTomlTable;
+exports.removeTomlTable = removeTomlTable;
+function serializeTomlTableBody(values) {
+    const lines = [];
+    for (const [key, value] of Object.entries(values)) {
+        if (typeof value === 'string') {
+            lines.push(`${key} = ${quoteString(value)}`);
+        }
+        else if (Array.isArray(value) && value.every((v) => typeof v === 'string')) {
+            const parts = value.map(quoteString).join(', ');
+            lines.push(`${key} = [${parts}]`);
+        }
+        else {
+            throw new Error(`Unsupported TOML value type for key "${key}"`);
+        }
+    }
+    return lines.join('\n');
+}
+function quoteString(s) {
+    return '"' + s.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+}
+function buildTomlTable(header, values) {
+    return `[${header}]\n${serializeTomlTableBody(values)}`;
+}
+function upsertTomlTable(fileContent, header, block) {
+    const headerLine = `[${header}]`;
+    const headerIdx = findHeaderIndex(fileContent, headerLine);
+    if (headerIdx === -1) {
+        const trimmed = fileContent.trimEnd();
+        const sep = trimmed.length > 0 ? '\n\n' : '';
+        return {
+            content: trimmed + sep + block + '\n',
+            action: 'inserted',
+        };
+    }
+    const blockEnd = findNextTableHeader(fileContent, headerIdx + headerLine.length);
+    const existingBlock = fileContent.substring(headerIdx, blockEnd).replace(/\n+$/, '');
+    if (existingBlock === block) {
+        return { content: fileContent, action: 'unchanged' };
+    }
+    const before = fileContent.substring(0, headerIdx);
+    const after = fileContent.substring(blockEnd);
+    const beforeClean = before.replace(/\n+$/, '');
+    const afterClean = after.replace(/^\n+/, '');
+    const sepBefore = beforeClean.length > 0 ? '\n\n' : '';
+    const sepAfter = afterClean.length > 0 ? '\n\n' : '\n';
+    return {
+        content: beforeClean + sepBefore + block + sepAfter + afterClean,
+        action: 'replaced',
+    };
+}
+function removeTomlTable(fileContent, header) {
+    const headerLine = `[${header}]`;
+    const headerIdx = findHeaderIndex(fileContent, headerLine);
+    if (headerIdx === -1)
+        return { content: fileContent, action: 'not-found' };
+    const blockEnd = findNextTableHeader(fileContent, headerIdx + headerLine.length);
+    const before = fileContent.substring(0, headerIdx).replace(/\n+$/, '');
+    const after = fileContent.substring(blockEnd).replace(/^\n+/, '');
+    const joined = before + (before && after ? '\n\n' : '') + after;
+    return { content: joined, action: 'removed' };
+}
+function findHeaderIndex(content, headerLine) {
+    if (content.startsWith(headerLine))
+        return 0;
+    const needle = '\n' + headerLine;
+    const idx = content.indexOf(needle);
+    return idx === -1 ? -1 : idx + 1;
+}
+function findNextTableHeader(content, from) {
+    let i = from;
+    while (i < content.length) {
+        const nlIdx = content.indexOf('\n[', i);
+        if (nlIdx === -1)
+            return content.length;
+        if (content[nlIdx + 2] === '[') {
+            i = nlIdx + 2;
+            continue;
+        }
+        return nlIdx + 1;
+    }
+    return content.length;
+}
+//# sourceMappingURL=toml.js.map

package/dist/mcp/index.d.ts

@@ -0,0 +1,15 @@
+export declare class MCPServer {
+    private rl;
+    private handler;
+    private version;
+    private pending;
+    private closing;
+    private queue;
+    constructor();
+    run(): Promise<void>;
+    handleMessage(message: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
+    private handleToolCall;
+    private executeTool;
+    private send;
+}
+export declare function runMcpServer(): Promise<void>;

package/dist/mcp/index.js

@@ -0,0 +1,174 @@
+"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.MCPServer = void 0;
+exports.runMcpServer = runMcpServer;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const server_instructions_1 = require("./server-instructions");
+const tools_1 = require("./tools");
+const PROTOCOL_VERSION = '2024-11-05';
+class MCPServer {
+    rl = null;
+    handler = new tools_1.MCPToolHandler();
+    version;
+    pending = 0;
+    closing = false;
+    queue = Promise.resolve();
+    constructor() {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+            this.version = pkg.version || '0.0.0';
+        }
+        catch {
+            this.version = '0.0.0';
+        }
+    }
+    async run() {
+        this.rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: false,
+        });
+        process.stderr.write('cssprobe-cli MCP server started\n');
+        // Requests are serialized: tool calls share one browser session, so an
+        // inspect racing an in-flight open must be queued, not run concurrently.
+        this.rl.on('line', (line) => {
+            this.pending++;
+            this.queue = this.queue.then(async () => {
+                try {
+                    const message = JSON.parse(line);
+                    const response = await this.handleMessage(message);
+                    if (response)
+                        this.send(response);
+                }
+                catch {
+                    // ignore malformed lines
+                }
+                finally {
+                    this.pending--;
+                    if (this.closing && this.pending === 0)
+                        process.exit(0);
+                }
+            });
+        });
+        // Exit only after in-flight requests drain, so a client that closes
+        // stdin immediately after sending still receives its responses.
+        this.rl.on('close', () => {
+            this.closing = true;
+            if (this.pending === 0)
+                process.exit(0);
+        });
+        process.on('SIGTERM', () => process.exit(0));
+        process.on('SIGINT', () => process.exit(0));
+    }
+    async handleMessage(message) {
+        const method = message['method'];
+        const id = message['id'];
+        if (!method)
+            return undefined;
+        // Notifications (no id) never receive a response.
+        if (id === undefined)
+            return undefined;
+        switch (method) {
+            case 'initialize':
+                return {
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        protocolVersion: PROTOCOL_VERSION,
+                        capabilities: { tools: {} },
+                        serverInfo: { name: 'cssprobe-cli', version: this.version },
+                        instructions: server_instructions_1.SERVER_INSTRUCTIONS,
+                    },
+                };
+            case 'ping':
+                return { jsonrpc: '2.0', id, result: {} };
+            case 'tools/list':
+                return { jsonrpc: '2.0', id, result: { tools: (0, tools_1.getToolDefinitions)() } };
+            case 'tools/call':
+                return this.handleToolCall(message, id);
+            default:
+                return { jsonrpc: '2.0', id, error: { code: -32601, message: `Method not found: ${method}` } };
+        }
+    }
+    async handleToolCall(message, id) {
+        const params = message['params'];
+        const toolName = params?.['name'];
+        const args = params?.['arguments'] ?? {};
+        if (!toolName) {
+            return { jsonrpc: '2.0', id, error: { code: -32602, message: 'Missing tool name' } };
+        }
+        try {
+            const text = await this.executeTool(toolName, args);
+            return { jsonrpc: '2.0', id, result: { content: [{ type: 'text', text }] } };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    content: [{ type: 'text', text: `cssprobe-cli internal error: ${msg}\n\nThis is an unexpected error — please report it.` }],
+                    isError: true,
+                },
+            };
+        }
+    }
+    executeTool(name, args) {
+        switch (name) {
+            case 'cssprobe_open': return this.handler.open(args);
+            case 'cssprobe_inspect': return this.handler.inspect(args);
+            case 'cssprobe_tree': return this.handler.tree(args);
+            case 'cssprobe_layout': return this.handler.layout(args);
+            case 'cssprobe_findings': return this.handler.findings(args);
+            case 'cssprobe_eval': return this.handler.evalExpression(args);
+            case 'cssprobe_screenshot': return this.handler.screenshot(args);
+            case 'cssprobe_inject_css': return this.handler.injectCss(args);
+            case 'cssprobe_close': return this.handler.close(args);
+            case 'cssprobe_status': return this.handler.status();
+            default: return Promise.resolve(`Unknown tool: ${name}`);
+        }
+    }
+    send(message) {
+        process.stdout.write(JSON.stringify(message) + '\n');
+    }
+}
+exports.MCPServer = MCPServer;
+async function runMcpServer() {
+    await new MCPServer().run();
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/server-instructions.d.ts

@@ -0,0 +1 @@
+export declare const SERVER_INSTRUCTIONS = "cssprobe-cli \u2014 runtime CSS probe for AI agents.\n\nIt opens a real browser session and answers questions that static code cannot:\nwhy an element overflows, where its scroll chain goes, what it actually renders\nas. Findings carry a confidence level (DEFINITE / INDEFINITE / UNVERIFIABLE) \u2014\nreport UNVERIFIABLE items as \"needs verification\", never as conclusions.\n\nTypical workflow:\n1. cssprobe_open \u2014 start a session (optionally with a URL; headed: true when a\n   login is needed, then ask the user to sign in manually).\n2. cssprobe_inspect / cssprobe_layout / cssprobe_findings \u2014 query a selector.\n   inspect returns DOM tree + layout + findings; layout is the ASCII diagram;\n   findings lists only issues/warnings/errors.\n3. cssprobe_eval / cssprobe_inject_css \u2014 probe or patch the live page.\n4. cssprobe_screenshot \u2014 capture the current page to a PNG file.\n5. cssprobe_close \u2014 stop the session when done.\n\nNotes:\n- One shared \"default\" session: open once, run many queries, close at the end.\n- Any command without an open session returns guidance instead of failing.\n- Pair with cssgraph (static CSS knowledge graph MCP) for the full picture:\n  cssgraph finds where styles come from, cssprobe shows what they render as.\n- Prefer narrow selectors (\".card > .title\") to keep output small.";

package/dist/mcp/server-instructions.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVER_INSTRUCTIONS = void 0;
+exports.SERVER_INSTRUCTIONS = `cssprobe-cli — runtime CSS probe for AI agents.
+
+It opens a real browser session and answers questions that static code cannot:
+why an element overflows, where its scroll chain goes, what it actually renders
+as. Findings carry a confidence level (DEFINITE / INDEFINITE / UNVERIFIABLE) —
+report UNVERIFIABLE items as "needs verification", never as conclusions.
+
+Typical workflow:
+1. cssprobe_open — start a session (optionally with a URL; headed: true when a
+   login is needed, then ask the user to sign in manually).
+2. cssprobe_inspect / cssprobe_layout / cssprobe_findings — query a selector.
+   inspect returns DOM tree + layout + findings; layout is the ASCII diagram;
+   findings lists only issues/warnings/errors.
+3. cssprobe_eval / cssprobe_inject_css — probe or patch the live page.
+4. cssprobe_screenshot — capture the current page to a PNG file.
+5. cssprobe_close — stop the session when done.
+
+Notes:
+- One shared "default" session: open once, run many queries, close at the end.
+- Any command without an open session returns guidance instead of failing.
+- Pair with cssgraph (static CSS knowledge graph MCP) for the full picture:
+  cssgraph finds where styles come from, cssprobe shows what they render as.
+- Prefer narrow selectors (".card > .title") to keep output small.`;
+//# sourceMappingURL=server-instructions.js.map