chrome-devtools-axi 0.1.0

package/LICENSE

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

package/dist/bin/chrome-devtools-axi.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/chrome-devtools-axi.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from '../src/cli.js';
+main(process.argv.slice(2));
+//# sourceMappingURL=chrome-devtools-axi.js.map

package/dist/bin/chrome-devtools-axi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-devtools-axi.js","sourceRoot":"","sources":["../../bin/chrome-devtools-axi.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/src/bridge.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env tsx
+/**
+ * Persistent MCP bridge server for chrome-devtools-axi.
+ *
+ * Spawns chrome-devtools-mcp as a child process and maintains a single
+ * persistent MCP session. Exposes a simple HTTP API:
+ *   POST /call  { name, args }  → { result }
+ *   GET  /tools                 → [{ name, description }]
+ *   GET  /health                → { status: "ok" }
+ *
+ * Writes a PID file to ~/.chrome-devtools-axi/bridge.pid on startup.
+ */
+export {};

package/dist/src/bridge.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env tsx
+/**
+ * Persistent MCP bridge server for chrome-devtools-axi.
+ *
+ * Spawns chrome-devtools-mcp as a child process and maintains a single
+ * persistent MCP session. Exposes a simple HTTP API:
+ *   POST /call  { name, args }  → { result }
+ *   GET  /tools                 → [{ name, description }]
+ *   GET  /health                → { status: "ok" }
+ *
+ * Writes a PID file to ~/.chrome-devtools-axi/bridge.pid on startup.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { createServer } from "node:http";
+import { mkdirSync, writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const PORT = parseInt(process.env.CHROME_DEVTOOLS_AXI_PORT ?? "9224", 10);
+const STATE_DIR = join(homedir(), ".chrome-devtools-axi");
+const PID_FILE = join(STATE_DIR, "bridge.pid");
+function writePidFile(port) {
+    mkdirSync(STATE_DIR, { recursive: true });
+    writeFileSync(PID_FILE, JSON.stringify({ pid: process.pid, port }));
+}
+function removePidFile() {
+    try {
+        unlinkSync(PID_FILE);
+    }
+    catch {
+        // Already gone — fine
+    }
+}
+async function main() {
+    // Connect to chrome-devtools-mcp via stdio
+    const transport = new StdioClientTransport({
+        command: "npx",
+        args: ["-y", "chrome-devtools-mcp@latest", "--headless", "--isolated"],
+    });
+    const client = new Client({ name: "chrome-devtools-axi-bridge", version: "1.0.0" });
+    await client.connect(transport);
+    console.error(`[chrome-devtools-axi] Connected to chrome-devtools-mcp`);
+    const server = createServer(async (req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        if (req.method === "GET" && req.url === "/health") {
+            res.end(JSON.stringify({ status: "ok" }));
+            return;
+        }
+        if (req.method === "GET" && req.url === "/tools") {
+            try {
+                const result = await client.listTools();
+                const tools = result.tools.map((t) => ({
+                    name: t.name,
+                    description: t.description,
+                }));
+                res.end(JSON.stringify(tools));
+            }
+            catch (err) {
+                res.statusCode = 500;
+                res.end(JSON.stringify({ error: err.message }));
+            }
+            return;
+        }
+        if (req.method === "POST" && req.url === "/call") {
+            let body = "";
+            for await (const chunk of req)
+                body += chunk;
+            try {
+                const { name, args } = JSON.parse(body);
+                const result = await client.callTool({ name, arguments: args ?? {} });
+                const parts = [];
+                for (const block of result.content) {
+                    if (block.type === "text" && block.text)
+                        parts.push(block.text);
+                }
+                res.end(JSON.stringify({ result: parts.join("\n") }));
+            }
+            catch (err) {
+                res.statusCode = 500;
+                res.end(JSON.stringify({ error: err.message }));
+            }
+            return;
+        }
+        res.statusCode = 404;
+        res.end(JSON.stringify({ error: "not found" }));
+    });
+    server.listen(PORT, "127.0.0.1", () => {
+        writePidFile(PORT);
+        console.error(`[chrome-devtools-axi] Listening on http://127.0.0.1:${PORT}`);
+        // Signal readiness to parent
+        console.log("READY");
+    });
+    // Graceful shutdown
+    const shutdown = async () => {
+        removePidFile();
+        server.close();
+        await client.close();
+        await transport.close();
+        process.exit(0);
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+}
+main().catch((err) => {
+    console.error(`[chrome-devtools-axi] Fatal: ${err}`);
+    removePidFile();
+    process.exit(1);
+});
+//# sourceMappingURL=bridge.js.map

package/dist/src/bridge.js.map

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

package/dist/src/cli.d.ts

@@ -0,0 +1 @@
+export declare function main(argv: string[]): Promise<void>;

package/dist/src/cli.js

@@ -0,0 +1,287 @@
+import { encode } from "@toon-format/toon";
+import { CdpError, callTool, ensureBridge, stopBridge } from "./client.js";
+import { countRefs, extractTitle } from "./snapshot.js";
+import { getSuggestions } from "./suggestions.js";
+const HELP = `usage: chrome-devtools-axi <command> [args]
+commands[12]:
+  open <url>, snapshot, click @<uid>, fill @<uid> <text>, type <text>,
+  press <key>, scroll <dir>, back, wait <ms|text>, eval <js>, start, stop
+`;
+function renderHelp(lines) {
+    if (lines.length === 0)
+        return "";
+    const indented = lines.map((l) => `  ${l}`).join("\n");
+    return `help[${lines.length}]:\n${indented}`;
+}
+function renderError(message, code, suggestions = []) {
+    const blocks = [encode({ error: message, code })];
+    if (suggestions.length > 0) {
+        blocks.push(renderHelp(suggestions));
+    }
+    return blocks.join("\n");
+}
+function renderOutput(blocks) {
+    return blocks.filter(Boolean).join("\n");
+}
+/**
+ * Parse snapshot from an includeSnapshot response.
+ * The response contains a "## Latest page snapshot" section.
+ */
+function parseSnapshotFromResponse(response) {
+    const marker = "## Latest page snapshot";
+    const idx = response.indexOf(marker);
+    if (idx === -1)
+        return null;
+    const after = response.slice(idx + marker.length);
+    // The snapshot follows after the header line, possibly with a blank line
+    const trimmed = after.replace(/^\s*\n/, "");
+    // Snapshot ends at the next ## heading or end of text
+    const nextHeading = trimmed.indexOf("\n## ");
+    return nextHeading === -1 ? trimmed.trimEnd() : trimmed.slice(0, nextHeading).trimEnd();
+}
+/** Format page metadata (TOON) + raw snapshot + suggestions. */
+function formatPageOutput(snapshot, command, url) {
+    const title = extractTitle(snapshot);
+    const refs = countRefs(snapshot);
+    const blocks = [];
+    // Page metadata as TOON
+    const page = {};
+    if (title)
+        page.title = title;
+    if (url)
+        page.url = url;
+    page.refs = refs;
+    blocks.push(encode({ page }));
+    // Raw snapshot (not TOON-encoded — already token-efficient tree format)
+    blocks.push(`snapshot:\n${snapshot.trimEnd()}`);
+    // Contextual suggestions
+    const suggestions = getSuggestions({ command, url, snapshot });
+    if (suggestions.length > 0) {
+        blocks.push(renderHelp(suggestions));
+    }
+    return renderOutput(blocks);
+}
+/** Strip the `## Latest page snapshot` header that chrome-devtools-mcp prepends. */
+function stripSnapshotHeader(text) {
+    return text.replace(/^##\s+Latest page snapshot\s*\n/, "");
+}
+/** Strip leading @ from uid ref. */
+function parseUid(arg) {
+    return arg.startsWith("@") ? arg.slice(1) : arg;
+}
+/**
+ * Call a tool with includeSnapshot:true and extract the snapshot.
+ * Falls back to a separate take_snapshot() if parsing fails.
+ */
+async function callWithSnapshot(name, args) {
+    const result = await callTool(name, { ...args, includeSnapshot: true });
+    const snapshot = parseSnapshotFromResponse(result);
+    if (snapshot && snapshot.length > 0)
+        return stripSnapshotHeader(snapshot);
+    // Fallback: take snapshot separately
+    return stripSnapshotHeader(await callTool("take_snapshot"));
+}
+const SCROLL_FUNCTIONS = {
+    up: "window.scrollBy(0, -500)",
+    down: "window.scrollBy(0, 500)",
+    top: "window.scrollTo(0, 0)",
+    bottom: "window.scrollTo(0, document.body.scrollHeight)",
+};
+async function handleOpen(args) {
+    const url = args[0];
+    if (!url) {
+        throw new CdpError("Missing URL", "VALIDATION_ERROR", [
+            "Run `chrome-devtools-axi open https://example.com` to navigate to a page",
+        ]);
+    }
+    await callTool("navigate_page", { type: "url", url });
+    const snapshot = stripSnapshotHeader(await callTool("take_snapshot"));
+    return formatPageOutput(snapshot, "open", url);
+}
+async function handleSnapshot() {
+    const snapshot = stripSnapshotHeader(await callTool("take_snapshot"));
+    return formatPageOutput(snapshot, "snapshot");
+}
+async function handleClick(args) {
+    const uid = args[0];
+    if (!uid) {
+        throw new CdpError("Missing element ref", "VALIDATION_ERROR", [
+            "Run `chrome-devtools-axi click @<uid>` — get uid from snapshot",
+        ]);
+    }
+    const snapshot = await callWithSnapshot("click", { uid: parseUid(uid) });
+    return formatPageOutput(snapshot, "click");
+}
+async function handleFill(args) {
+    const uid = args[0];
+    const value = args.slice(1).join(" ");
+    if (!uid) {
+        throw new CdpError("Missing element ref", "VALIDATION_ERROR", [
+            'Run `chrome-devtools-axi fill @<uid> "text"` — get uid from snapshot',
+        ]);
+    }
+    if (!value) {
+        throw new CdpError("Missing fill text", "VALIDATION_ERROR", [
+            'Run `chrome-devtools-axi fill @<uid> "text"` to fill the field',
+        ]);
+    }
+    const snapshot = await callWithSnapshot("fill", { uid: parseUid(uid), value });
+    return formatPageOutput(snapshot, "fill");
+}
+async function handlePress(args) {
+    const key = args[0];
+    if (!key) {
+        throw new CdpError("Missing key name", "VALIDATION_ERROR", [
+            "Run `chrome-devtools-axi press Enter` to press a key",
+        ]);
+    }
+    const snapshot = await callWithSnapshot("press_key", { key });
+    return formatPageOutput(snapshot, "press");
+}
+async function handleType(args) {
+    const text = args.join(" ");
+    if (!text) {
+        throw new CdpError("Missing text", "VALIDATION_ERROR", [
+            'Run `chrome-devtools-axi type "hello"` to type text',
+        ]);
+    }
+    await callTool("type_text", { text });
+    const snapshot = stripSnapshotHeader(await callTool("take_snapshot"));
+    return formatPageOutput(snapshot, "type");
+}
+async function handleScroll(args) {
+    const dir = (args[0] ?? "down").toLowerCase();
+    const fn = SCROLL_FUNCTIONS[dir];
+    if (!fn) {
+        throw new CdpError(`Unknown scroll direction: ${dir}`, "VALIDATION_ERROR", [
+            "Run `chrome-devtools-axi scroll down` — directions: up, down, top, bottom",
+        ]);
+    }
+    await callTool("evaluate_script", { function: fn });
+    const snapshot = stripSnapshotHeader(await callTool("take_snapshot"));
+    return formatPageOutput(snapshot, "scroll");
+}
+async function handleBack() {
+    await callTool("navigate_page", { type: "back" });
+    const snapshot = stripSnapshotHeader(await callTool("take_snapshot"));
+    return formatPageOutput(snapshot, "back");
+}
+async function handleWait(args) {
+    const target = args[0];
+    if (!target) {
+        throw new CdpError("Missing wait target (milliseconds or text)", "VALIDATION_ERROR", [
+            "Run `chrome-devtools-axi wait 2000` to wait 2 seconds",
+            'Run `chrome-devtools-axi wait "Submit"` to wait for text to appear',
+        ]);
+    }
+    const isNumeric = /^\d+$/.test(target);
+    if (isNumeric) {
+        await callTool("evaluate_script", {
+            function: `new Promise(r => setTimeout(r, ${target}))`,
+        });
+    }
+    else {
+        await callTool("wait_for", { text: [target] });
+    }
+    const blocks = [];
+    blocks.push(encode({ waited: target }));
+    const suggestions = getSuggestions({ command: "wait" });
+    if (suggestions.length > 0)
+        blocks.push(renderHelp(suggestions));
+    return renderOutput(blocks);
+}
+async function handleEval(args) {
+    const js = args.join(" ");
+    if (!js) {
+        throw new CdpError("Missing JavaScript expression", "VALIDATION_ERROR", [
+            'Run `chrome-devtools-axi eval "document.title"` to evaluate JavaScript',
+        ]);
+    }
+    const output = await callTool("evaluate_script", { function: js });
+    const blocks = [];
+    blocks.push(encode({ result: output.trim() }));
+    const suggestions = getSuggestions({ command: "eval" });
+    if (suggestions.length > 0)
+        blocks.push(renderHelp(suggestions));
+    return renderOutput(blocks);
+}
+async function handleStart() {
+    const port = await ensureBridge();
+    return encode({ status: "ready", port });
+}
+async function handleStop() {
+    await stopBridge();
+    return encode({ status: "stopped" });
+}
+export async function main(argv) {
+    const args = [...argv];
+    if (args.includes("--help") || args.includes("-h")) {
+        process.stdout.write(HELP);
+        return;
+    }
+    const command = args[0] ?? "";
+    const commandArgs = args.slice(1);
+    try {
+        let output;
+        switch (command) {
+            case "open":
+                output = await handleOpen(commandArgs);
+                break;
+            case "snapshot":
+                output = await handleSnapshot();
+                break;
+            case "click":
+                output = await handleClick(commandArgs);
+                break;
+            case "fill":
+                output = await handleFill(commandArgs);
+                break;
+            case "type":
+                output = await handleType(commandArgs);
+                break;
+            case "press":
+                output = await handlePress(commandArgs);
+                break;
+            case "scroll":
+                output = await handleScroll(commandArgs);
+                break;
+            case "back":
+                output = await handleBack();
+                break;
+            case "wait":
+                output = await handleWait(commandArgs);
+                break;
+            case "eval":
+                output = await handleEval(commandArgs);
+                break;
+            case "start":
+                output = await handleStart();
+                break;
+            case "stop":
+                output = await handleStop();
+                break;
+            case "":
+                // No command = show current page state
+                output = await handleSnapshot();
+                break;
+            default:
+                process.stdout.write(renderError(`Unknown command: ${command}`, "UNKNOWN", [
+                    "Run `chrome-devtools-axi --help` to see available commands",
+                ]) + "\n");
+                process.exitCode = 1;
+                return;
+        }
+        process.stdout.write(output + "\n");
+    }
+    catch (err) {
+        if (err instanceof CdpError) {
+            process.stdout.write(renderError(err.message, err.code, err.suggestions) + "\n");
+        }
+        else {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stdout.write(renderError(message, "UNKNOWN") + "\n");
+        }
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * HTTP client for the chrome-devtools-axi bridge + bridge lifecycle management.
+ */
+export type ErrorCode = "BRIDGE_NOT_READY" | "REF_NOT_FOUND" | "TIMEOUT" | "BROWSER_ERROR" | "VALIDATION_ERROR" | "UNKNOWN";
+export declare class CdpError extends Error {
+    readonly code: ErrorCode;
+    readonly suggestions: string[];
+    constructor(message: string, code: ErrorCode, suggestions?: string[]);
+}
+/**
+ * Ensure the bridge is running, starting it if needed. Returns the port.
+ */
+export declare function ensureBridge(): Promise<number>;
+/**
+ * Call an MCP tool via the bridge. Returns the text result.
+ */
+export declare function callTool(name: string, args?: Record<string, unknown>): Promise<string>;
+/**
+ * Stop the bridge process.
+ */
+export declare function stopBridge(): Promise<void>;

package/dist/src/client.js

@@ -0,0 +1,204 @@
+/**
+ * HTTP client for the chrome-devtools-axi bridge + bridge lifecycle management.
+ */
+import { spawn } from "node:child_process";
+import { readFileSync, existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { request } from "node:http";
+const STATE_DIR = join(homedir(), ".chrome-devtools-axi");
+const PID_FILE = join(STATE_DIR, "bridge.pid");
+const DEFAULT_PORT = 9224;
+export class CdpError extends Error {
+    code;
+    suggestions;
+    constructor(message, code, suggestions = []) {
+        super(message);
+        this.code = code;
+        this.suggestions = suggestions;
+        this.name = "CdpError";
+    }
+}
+function readPidFile() {
+    try {
+        if (!existsSync(PID_FILE))
+            return null;
+        const data = JSON.parse(readFileSync(PID_FILE, "utf-8"));
+        if (typeof data.pid === "number" && typeof data.port === "number") {
+            return data;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function httpGet(port, path, timeoutMs = 2000) {
+    return new Promise((resolve, reject) => {
+        const req = request({ hostname: "127.0.0.1", port, path, method: "GET", timeout: timeoutMs }, (res) => {
+            let data = "";
+            res.on("data", (chunk) => (data += chunk));
+            res.on("end", () => resolve(data));
+        });
+        req.on("error", reject);
+        req.on("timeout", () => {
+            req.destroy();
+            reject(new Error("timeout"));
+        });
+        req.end();
+    });
+}
+function httpPost(port, path, body, timeoutMs = 120_000) {
+    return new Promise((resolve, reject) => {
+        const payload = JSON.stringify(body);
+        const req = request({
+            hostname: "127.0.0.1",
+            port,
+            path,
+            method: "POST",
+            timeout: timeoutMs,
+            headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(payload) },
+        }, (res) => {
+            let data = "";
+            res.on("data", (chunk) => (data += chunk));
+            res.on("end", () => {
+                if (res.statusCode && res.statusCode >= 400) {
+                    reject(new Error(data));
+                }
+                else {
+                    resolve(data);
+                }
+            });
+        });
+        req.on("error", reject);
+        req.on("timeout", () => {
+            req.destroy();
+            reject(new Error("timeout"));
+        });
+        req.write(payload);
+        req.end();
+    });
+}
+async function checkBridgeHealth(port) {
+    try {
+        const resp = await httpGet(port, "/health");
+        const data = JSON.parse(resp);
+        return data.status === "ok";
+    }
+    catch {
+        return false;
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+/**
+ * Ensure the bridge is running, starting it if needed. Returns the port.
+ */
+export async function ensureBridge() {
+    const port = parseInt(process.env.CHROME_DEVTOOLS_AXI_PORT ?? String(DEFAULT_PORT), 10);
+    // Check existing bridge via PID file
+    const pidInfo = readPidFile();
+    if (pidInfo && isProcessAlive(pidInfo.pid)) {
+        if (await checkBridgeHealth(pidInfo.port)) {
+            return pidInfo.port;
+        }
+    }
+    // Start a new bridge
+    console.error("[chrome-devtools-axi] Starting browser...");
+    const bridgeScript = resolve(import.meta.dirname, "bridge.js");
+    // Try .ts first (dev mode), fall back to .js (built)
+    const script = existsSync(bridgeScript.replace(/\.js$/, ".ts"))
+        ? bridgeScript.replace(/\.js$/, ".ts")
+        : bridgeScript;
+    const runner = script.endsWith(".ts") ? "tsx" : "node";
+    const child = spawn(runner === "tsx" ? "npx" : "node", runner === "tsx" ? ["tsx", script] : [script], {
+        stdio: ["pipe", "pipe", "inherit"],
+        env: { ...process.env, CHROME_DEVTOOLS_AXI_PORT: String(port) },
+        detached: true,
+    });
+    child.unref();
+    // Detach stdin so parent can exit
+    child.stdin?.end();
+    // Poll for health (max 30s — Chrome launch can be slow)
+    const deadline = Date.now() + 30_000;
+    while (Date.now() < deadline) {
+        if (await checkBridgeHealth(port)) {
+            return port;
+        }
+        await sleep(500);
+    }
+    throw new CdpError("Bridge failed to start within 30s", "BRIDGE_NOT_READY", ["Check that chrome-devtools-mcp is installed: npx chrome-devtools-mcp@latest --help"]);
+}
+/**
+ * Call an MCP tool via the bridge. Returns the text result.
+ */
+export async function callTool(name, args = {}) {
+    const port = await ensureBridge();
+    try {
+        const resp = await httpPost(port, "/call", { name, args });
+        const data = JSON.parse(resp);
+        if (data.error) {
+            throw new Error(data.error);
+        }
+        return data.result ?? "";
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw mapError(message);
+    }
+}
+function mapError(message) {
+    if (message.includes("ECONNREFUSED") || message.includes("ECONNRESET")) {
+        return new CdpError("Bridge is not running", "BRIDGE_NOT_READY", [
+            "Run `chrome-devtools-axi open <url>` — the bridge starts automatically",
+        ]);
+    }
+    if ((message.includes("uid") || message.includes("element")) &&
+        (message.includes("not found") || message.includes("invalid"))) {
+        return new CdpError(message, "REF_NOT_FOUND", [
+            "Run `chrome-devtools-axi snapshot` to see available elements and their @uid refs",
+        ]);
+    }
+    if (message.includes("timeout") || message.includes("timed out")) {
+        return new CdpError(message, "TIMEOUT", [
+            "Run `chrome-devtools-axi snapshot` to see current page state",
+        ]);
+    }
+    // Try to parse JSON error
+    try {
+        const parsed = JSON.parse(message);
+        if (parsed.error) {
+            return new CdpError(parsed.error, "BROWSER_ERROR", [
+                "Run `chrome-devtools-axi snapshot` to see current page state",
+            ]);
+        }
+    }
+    catch {
+        // Not JSON
+    }
+    return new CdpError(message, "UNKNOWN");
+}
+/**
+ * Stop the bridge process.
+ */
+export async function stopBridge() {
+    const pidInfo = readPidFile();
+    if (!pidInfo) {
+        return;
+    }
+    if (isProcessAlive(pidInfo.pid)) {
+        process.kill(pidInfo.pid, "SIGTERM");
+    }
+    // PID file is cleaned up by the bridge on shutdown
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/snapshot.d.ts

@@ -0,0 +1,13 @@
+export interface RefInfo {
+    ref: string;
+    label: string;
+    type: string;
+}
+/** Count interactive refs (uid=...) in snapshot text. */
+export declare function countRefs(snapshot: string): number;
+/** Extract ref IDs with labels and types from snapshot text. */
+export declare function extractRefs(snapshot: string): RefInfo[];
+/** Extract page title from snapshot (RootWebArea or first heading). */
+export declare function extractTitle(snapshot: string): string;
+/** Check if a ref type is an input/form field. */
+export declare function isInputType(type: string): boolean;

package/dist/src/snapshot.js

@@ -0,0 +1,32 @@
+/** Count interactive refs (uid=...) in snapshot text. */
+export function countRefs(snapshot) {
+    const matches = snapshot.match(/\buid=\S+/g);
+    return matches ? matches.length : 0;
+}
+/** Extract ref IDs with labels and types from snapshot text. */
+export function extractRefs(snapshot) {
+    const refs = [];
+    for (const line of snapshot.split("\n")) {
+        const m = line.match(/\buid=(\S+)\s+(\w+)\s+"([^"]*)"/);
+        if (!m)
+            continue;
+        refs.push({ ref: m[1], type: m[2], label: m[3] });
+    }
+    return refs;
+}
+/** Extract page title from snapshot (RootWebArea or first heading). */
+export function extractTitle(snapshot) {
+    const rootMatch = snapshot.match(/RootWebArea\s+"([^"]+)"/);
+    if (rootMatch)
+        return rootMatch[1];
+    const headingMatch = snapshot.match(/\bheading\s+"([^"]+)"/);
+    if (headingMatch)
+        return headingMatch[1];
+    return "";
+}
+const INPUT_TYPES = ["textbox", "searchbox", "input", "combobox", "textarea"];
+/** Check if a ref type is an input/form field. */
+export function isInputType(type) {
+    return INPUT_TYPES.includes(type);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/src/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/snapshot.ts"],"names":[],"mappings":"AAMA,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACxD,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5D,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7D,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAE9E,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/src/suggestions.d.ts

@@ -0,0 +1,6 @@
+export interface SuggestionContext {
+    command: string;
+    url?: string;
+    snapshot?: string;
+}
+export declare function getSuggestions(ctx: SuggestionContext): string[];

package/dist/src/suggestions.js

@@ -0,0 +1,49 @@
+import { extractRefs, isInputType } from "./snapshot.js";
+export function getSuggestions(ctx) {
+    // Commands without auto-snapshot — suggest viewing page state
+    if (ctx.command === "wait" || ctx.command === "eval") {
+        return ["Run `chrome-devtools-axi snapshot` to see current page state"];
+    }
+    const refs = ctx.snapshot ? extractRefs(ctx.snapshot) : [];
+    const links = refs.filter((r) => r.type === "link");
+    const buttons = refs.filter((r) => r.type === "button");
+    const inputs = refs.filter((r) => isInputType(r.type));
+    const lines = [];
+    // After filling a field, suggest submitting
+    if (ctx.command === "fill") {
+        const submitBtn = buttons.find((r) => /submit|search|go|send|login|sign|ok/i.test(r.label));
+        if (submitBtn) {
+            lines.push(`Run \`chrome-devtools-axi click @${submitBtn.ref}\` to click "${submitBtn.label}"`);
+        }
+        else {
+            lines.push("Run `chrome-devtools-axi press Enter` to submit the form");
+        }
+    }
+    // Suggest filling inputs (unless we just filled one)
+    if (inputs.length > 0 && ctx.command !== "fill") {
+        const inp = inputs[0];
+        const label = inp.label ? `the "${inp.label}" field` : "the input field";
+        lines.push(`Run \`chrome-devtools-axi fill @${inp.ref} "text"\` to fill ${label}`);
+    }
+    // Suggest clicking buttons
+    if (buttons.length > 0 && lines.length < 2) {
+        const btn = ctx.command === "fill"
+            ? buttons.find((r) => !/submit|search|go|send|login|sign|ok/i.test(r.label)) ?? buttons[0]
+            : buttons[0];
+        if (btn && !lines.some((l) => l.includes(`@${btn.ref}`))) {
+            const label = btn.label ? `"${btn.label}" ` : "";
+            lines.push(`Run \`chrome-devtools-axi click @${btn.ref}\` to click the ${label}button`);
+        }
+    }
+    // Suggest clicking links
+    if (links.length > 0 && lines.length < 2) {
+        const link = links[0];
+        lines.push(`Run \`chrome-devtools-axi click @${link.ref}\` to click the "${link.label}" link`);
+    }
+    // Suggest scrolling if page has many elements
+    if (refs.length > 5 && lines.length < 3) {
+        lines.push("Run `chrome-devtools-axi scroll down` to scroll down");
+    }
+    return lines.slice(0, 3);
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/src/suggestions.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "chrome-devtools-axi",
+  "version": "0.1.0",
+  "description": "AXI-compliant chrome-devtools-mcp wrapper — combined operations, TOON output, contextual suggestions",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kunchenguid/chrome-devtools-axi.git"
+  },
+  "keywords": [
+    "chrome",
+    "devtools",
+    "browser",
+    "cli",
+    "agent",
+    "axi",
+    "toon",
+    "mcp"
+  ],
+  "bin": {
+    "chrome-devtools-axi": "./dist/bin/chrome-devtools-axi.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx bin/chrome-devtools-axi.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@toon-format/toon": "^2.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}