fastbrowser_cli 1.0.2 → 1.0.3

package/dist/fastbrowser_mcp/libs/mcp_client.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpClient = void 0;
+// node import
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+//	
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+class McpClient {
+    constructor(options) {
+        this.options = options;
+        this.connected = false;
+        this.client = new index_js_1.Client({
+            name: options.name,
+            version: options.version,
+        });
+    }
+    async connect() {
+        if (this.connected)
+            return;
+        this.transport = this.createTransport(this.options.transport);
+        await this.client.connect(this.transport);
+        this.connected = true;
+    }
+    async close() {
+        if (!this.connected)
+            return;
+        await this.client.close();
+        this.connected = false;
+    }
+    async listTools() {
+        this.assertConnected();
+        const { tools } = await this.client.listTools();
+        return tools;
+    }
+    async callTool(name, args = {}) {
+        this.assertConnected();
+        return this.client.callTool({ name, arguments: args });
+    }
+    async listResources() {
+        this.assertConnected();
+        const { resources } = await this.client.listResources();
+        return resources;
+    }
+    async readResource(uri) {
+        this.assertConnected();
+        return this.client.readResource({ uri });
+    }
+    async listPrompts() {
+        this.assertConnected();
+        const { prompts } = await this.client.listPrompts();
+        return prompts;
+    }
+    async getPrompt(name, args = {}) {
+        this.assertConnected();
+        return this.client.getPrompt({ name, arguments: args });
+    }
+    createTransport(config) {
+        switch (config.type) {
+            case "stdio":
+                return new stdio_js_1.StdioClientTransport({
+                    command: config.command,
+                    args: config.args ?? [],
+                    env: config.env,
+                });
+            case "http":
+                return new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(config.url), {
+                    requestInit: { headers: config.headers },
+                });
+        }
+    }
+    assertConnected() {
+        if (!this.connected) {
+            throw new Error("McpClient is not connected. Call connect() first.");
+        }
+    }
+}
+exports.McpClient = McpClient;
+//# sourceMappingURL=mcp_client.js.map

package/dist/fastbrowser_mcp/libs/mcp_client.js.map

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

package/dist/fastbrowser_mcp/libs/mcp_proxy.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpClient } from "./mcp_client.js";
+export declare class McpProxy {
+    private _mcpServer;
+    constructor();
+    connect(): Promise<void>;
+    getMcpServer(): Promise<McpServer>;
+    proxyToolCall(mcpClient: McpClient, toolName: string): Promise<void>;
+}
+//# sourceMappingURL=mcp_proxy.d.ts.map

package/dist/fastbrowser_mcp/libs/mcp_proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_proxy.d.ts","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/mcp_proxy.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,QAAQ;IACpB,OAAO,CAAC,UAAU,CAAY;;IASxB,OAAO;IAKP,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAOlC,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM;CAc1D"}

package/dist/fastbrowser_mcp/libs/mcp_proxy.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpProxy = void 0;
+// node imports
+const node_assert_1 = __importDefault(require("node:assert"));
+// npm imports
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_from_json_schema_1 = require("zod-from-json-schema");
+class McpProxy {
+    constructor() {
+        this._mcpServer = new mcp_js_1.McpServer({
+            name: "fastbrowser_mcp",
+            version: "1.0.0",
+        });
+    }
+    async connect() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this._mcpServer.connect(transport);
+    }
+    async getMcpServer() {
+        if (this._mcpServer === null) {
+            throw new Error("MCP server is not initialized");
+        }
+        return this._mcpServer;
+    }
+    async proxyToolCall(mcpClient, toolName) {
+        const mcpClientTools = await mcpClient.listTools();
+        const mcpClientTool = mcpClientTools.find((tool) => tool.name === toolName);
+        node_assert_1.default.ok(mcpClientTool !== undefined, `Tool ${toolName} not found in mcp client tools`);
+        const inputSchema = (0, zod_from_json_schema_1.convertJsonSchemaToZod)(mcpClientTool.inputSchema);
+        this._mcpServer.registerTool(toolName, {
+            description: mcpClientTool.description,
+            inputSchema: inputSchema,
+        }, async (...args) => {
+            const callResult = await mcpClient.callTool(toolName, args[0]);
+            return callResult;
+        });
+    }
+}
+exports.McpProxy = McpProxy;
+//# sourceMappingURL=mcp_proxy.js.map

package/dist/fastbrowser_mcp/libs/mcp_proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_proxy.js","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/mcp_proxy.ts"],"names":[],"mappings":";;;;;;AAAA,eAAe;AACf,8DAAiC;AAEjC,cAAc;AACd,oEAAoE;AACpE,wEAAiF;AACjF,+DAA8D;AAK9D,MAAa,QAAQ;IAGpB;QACC,IAAI,CAAC,UAAU,GAAG,IAAI,kBAAS,CAAC;YAC/B,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,OAAO;SAChB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;QAC7C,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,YAAY;QACjB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAoB,EAAE,QAAgB;QACzD,MAAM,cAAc,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAA;QAClD,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QAC5E,qBAAM,CAAC,EAAE,CAAC,aAAa,KAAK,SAAS,EAAE,QAAQ,QAAQ,gCAAgC,CAAC,CAAA;QAExF,MAAM,WAAW,GAAG,IAAA,6CAAsB,EAAC,aAAa,CAAC,WAAkB,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,EAAE;YACtC,WAAW,EAAE,aAAa,CAAC,WAAW;YACtC,WAAW,EAAE,WAAW;SACxB,EAAE,KAAK,EAAE,GAAG,IAAW,EAAE,EAAE;YAC3B,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9D,OAAO,UAAU,CAAA;QAClB,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AApCD,4BAoCC"}

package/dist/fastbrowser_mcp/libs/schemas.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const QuerySelectorInputSchema: z.ZodObject<{
+    selector: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    withAncestors: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const QuerySelectorsInputSchema: z.ZodObject<{
+    selectors: z.ZodArray<z.ZodObject<{
+        selector: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+        withAncestors: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const QuerySelectorFirstInputSchema: z.ZodObject<{
+    selector: z.ZodString;
+    withAncestors: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const QuerySelectorsFirstInputSchema: z.ZodObject<{
+    selectors: z.ZodArray<z.ZodObject<{
+        selector: z.ZodString;
+        withAncestors: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type QuerySelectorInput = z.infer<typeof QuerySelectorInputSchema>;
+export type QuerySelectorsInput = z.infer<typeof QuerySelectorsInputSchema>;
+export type QuerySelectorFirstInput = z.infer<typeof QuerySelectorFirstInputSchema>;
+export type QuerySelectorsFirstInput = z.infer<typeof QuerySelectorsFirstInputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/fastbrowser_mcp/libs/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/schemas.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,wBAAwB;;;;iBASnC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;iBAGpC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;iBAMxC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;iBAGzC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC"}

package/dist/fastbrowser_mcp/libs/schemas.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuerySelectorsFirstInputSchema = exports.QuerySelectorFirstInputSchema = exports.QuerySelectorsInputSchema = exports.QuerySelectorInputSchema = void 0;
+// npm imports
+const zod_1 = require("zod");
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+//	Authoritative query selector schemas — shared between the MCP server
+//	and the HTTP/CLI layer. Kept out of the fastbrowser_mcp.ts entrypoint so
+//	importing the schemas does not execute the CLI's top-level `main()`.
+///////////////////////////////////////////////////////////////////////////////
+///////////////////////////////////////////////////////////////////////////////
+exports.QuerySelectorInputSchema = zod_1.z.object({
+    selector: zod_1.z.string()
+        .describe("CSS-like selector to query the accessibility tree"),
+    limit: zod_1.z.number()
+        .describe("Maximum number of nodes to return (excluding ancestors). Set to 0 for no limit.")
+        .default(0),
+    withAncestors: zod_1.z.boolean()
+        .describe("Whether to include ancestor nodes in the result")
+        .default(true),
+});
+exports.QuerySelectorsInputSchema = zod_1.z.object({
+    selectors: zod_1.z.array(exports.QuerySelectorInputSchema)
+        .describe("List of selectors to query the accessibility tree"),
+});
+exports.QuerySelectorFirstInputSchema = zod_1.z.object({
+    selector: zod_1.z.string()
+        .describe("CSS-like selector to query the accessibility tree"),
+    withAncestors: zod_1.z.boolean()
+        .describe("Whether to include ancestor nodes in the result")
+        .default(true),
+});
+exports.QuerySelectorsFirstInputSchema = zod_1.z.object({
+    selectors: zod_1.z.array(exports.QuerySelectorFirstInputSchema)
+        .describe("List of selectors; for each, the first matching node is returned"),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/fastbrowser_mcp/libs/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/fastbrowser_mcp/libs/schemas.ts"],"names":[],"mappings":";;;AAAA,cAAc;AACd,6BAAwB;AAExB,+EAA+E;AAC/E,+EAA+E;AAC/E,uEAAuE;AACvE,2EAA2E;AAC3E,uEAAuE;AACvE,+EAA+E;AAC/E,+EAA+E;AAElE,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,QAAQ,CAAC,mDAAmD,CAAC;IAC/D,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;SACf,QAAQ,CAAC,iFAAiF,CAAC;SAC3F,OAAO,CAAC,CAAC,CAAC;IACZ,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE;SACxB,QAAQ,CAAC,iDAAiD,CAAC;SAC3D,OAAO,CAAC,IAAI,CAAC;CACf,CAAC,CAAC;AAEU,QAAA,yBAAyB,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC;SAC1C,QAAQ,CAAC,mDAAmD,CAAC;CAC/D,CAAC,CAAC;AAEU,QAAA,6BAA6B,GAAG,OAAC,CAAC,MAAM,CAAC;IACrD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;SAClB,QAAQ,CAAC,mDAAmD,CAAC;IAC/D,aAAa,EAAE,OAAC,CAAC,OAAO,EAAE;SACxB,QAAQ,CAAC,iDAAiD,CAAC;SAC3D,OAAO,CAAC,IAAI,CAAC;CACf,CAAC,CAAC;AAEU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACtD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,qCAA6B,CAAC;SAC/C,QAAQ,CAAC,kEAAkE,CAAC;CAC9E,CAAC,CAAC"}

package/docs/brainstorm_scrap_by_ai.md

@@ -29,4 +29,4 @@
   - possible by selector language ? yes
 - get link with an url starting with "https://www.welcometothejungle.com/fr/companies/"
   - on a https://www.welcometothejungle.com/fr/jobs?refinementList%5Boffices.country_code%5D%5B%5D=FR&query=machine%20learning&page=7
-  - `npx tsx ./src/fastweb_cli/fastweb_cli.ts query_selectors_all --selector 'RootWebArea > link[url^="https://www.welcometothejungle.com/fr/companies/"]'`
+  - `npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts query_selectors_all --selector 'RootWebArea > link[url^="https://www.welcometothejungle.com/fr/companies/"]'`

package/docs/feature_support_cli.md

@@ -1,22 +1,22 @@
-# FastWeb MCP
+# FastBrowser MCP
 
 ## Overview
 
-FastWeb is a Model Context Protocol (MCP) server accessible via STDIO. It acts as a smarter proxy in front of the official `chrome-devtools-mcp`, exposing a leaner, more efficient toolset tuned for LLM agents.
+FastBrowser is a Model Context Protocol (MCP) server accessible via STDIO. It acts as a smarter proxy in front of the official `chrome-devtools-mcp`, exposing a leaner, more efficient toolset tuned for LLM agents.
 
-Where the standard Chrome DevTools MCP exposes a broad, low-level API, FastWeb adds a structured accessibility-tree query layer (`querySelectorsAll`) that lets an agent extract exactly the page nodes it needs in a single call — rather than consuming the entire raw snapshot. This reduces token usage and round-trips, making FastWeb noticeably more efficient for web automation tasks.
+Where the standard Chrome DevTools MCP exposes a broad, low-level API, FastBrowser adds a structured accessibility-tree query layer (`querySelectorsAll`) that lets an agent extract exactly the page nodes it needs in a single call — rather than consuming the entire raw snapshot. This reduces token usage and round-trips, making FastBrowser noticeably more efficient for web automation tasks.
 
 ## HTTP Server Architecture
 
-Connecting to `fastweb-mcp` on every invocation is slow: the MCP process starts cold, handshakes with `chrome-devtools-mcp`, and tears down after each session. To eliminate that overhead, `fastweb-http-server` acts as a persistent MCP client that connects to `fastweb-mcp` once and keeps that connection alive. It then re-exposes the same capabilities over a REST API, so `fastweb-cli` can issue commands with minimal latency. This splits the stack into two roles — a long-lived server that owns the MCP connection, and a thin client that issues commands and reads results — making interactions dramatically faster and easier to script.
+Connecting to `fastbrowser-mcp` on every invocation is slow: the MCP process starts cold, handshakes with `chrome-devtools-mcp`, and tears down after each session. To eliminate that overhead, `fastbrowser-httpd` acts as a persistent MCP client that connects to `fastbrowser-mcp` once and keeps that connection alive. It then re-exposes the same capabilities over a REST API, so `fastbrowser-cli` can issue commands with minimal latency. This splits the stack into two roles — a long-lived server that owns the MCP connection, and a thin client that issues commands and reads results — making interactions dramatically faster and easier to script.
 
 ## Components
 
-FastWeb is made up of three tools that work together:
+FastBrowser is made up of three tools that work together:
 
-- **fastweb-mcp** — The MCP server, accessible via STDIO. It connects directly to Chrome via `chrome-devtools-mcp` and exposes a curated, efficient toolset to any MCP-compatible LLM agent.
-- **fastweb-http-server** — A persistent HTTP server that acts as an MCP client connecting to `fastweb-mcp`. By keeping that MCP connection alive, it eliminates the cold-start penalty and exposes the same capabilities over a REST API for other clients to consume.
-- **fastweb-cli** — A lightweight command-line client that talks to `fastweb-http-server` over a REST API. It provides a fast, scriptable interface to browser automation without the overhead of spawning a new MCP process each time.
+- **fastbrowser-mcp** — The MCP server, accessible via STDIO. It connects directly to Chrome via `chrome-devtools-mcp` and exposes a curated, efficient toolset to any MCP-compatible LLM agent.
+- **fastbrowser-httpd** — A persistent HTTP server that acts as an MCP client connecting to `fastbrowser-mcp`. By keeping that MCP connection alive, it eliminates the cold-start penalty and exposes the same capabilities over a REST API for other clients to consume.
+- **fastbrowser-cli** — A lightweight command-line client that talks to `fastbrowser-httpd` over a REST API. It provides a fast, scriptable interface to browser automation without the overhead of spawning a new MCP process each time.
 
 ### Tools exposed
 
@@ -32,49 +32,49 @@ FastWeb is made up of three tools that work together:
 | `querySelectors` | Query the accessibility tree and return the first matching node per selector |
 | `pressKeys` | Send a sequence of keyboard events |
 
-## FastWeb CLI Command Lines
+## FastBrowser CLI Command Lines
 
-Each command maps 1-to-1 to a FastWeb MCP tool and sends the request to `fastweb-http-server` via REST.
+Each command maps 1-to-1 to a FastBrowser MCP tool and sends the request to `fastbrowser-httpd` via REST.
 
 ```bash
 # List all open browser pages
-fastweb-cli list_pages
+fastbrowser-cli list_pages
 
 # Open a new browser page
-fastweb-cli new_page
+fastbrowser-cli new_page
 
 # Close a page by its ID
-fastweb-cli close_page --page-id <pageId>
+fastbrowser-cli close_page --page-id <pageId>
 
 # Navigate the current page to a URL
-fastweb-cli navigate_page --url https://example.com
+fastbrowser-cli navigate_page --url https://example.com
 
 # Click an element by accessibility selector (fast path: "#1_42" is a direct uid reference)
-fastweb-cli click --selector "#1_42"
-fastweb-cli click -s 'button[name="Submit"]'
+fastbrowser-cli click --selector "#1_42"
+fastbrowser-cli click -s 'button[name="Submit"]'
 
 # Fill a form field by accessibility selector
-fastweb-cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
+fastbrowser-cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
 
 # Query the accessibility tree — --selector can be repeated for multiple selectors.
 # --limit and --with-ancestors apply to all selectors equally.
-fastweb-cli query_selectors_all --selector "button" --selector "link" --limit 5 --with-ancestors
-fastweb-cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
+fastbrowser-cli query_selectors_all --selector "button" --selector "link" --limit 5 --with-ancestors
+fastbrowser-cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
 
 # For per-selector control over limit/withAncestors, pass a JSON array directly:
-fastweb-cli query_selectors_all --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
+fastbrowser-cli query_selectors_all --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
 
 # Query the accessibility tree for the first matching element per selector (mirrors DOM querySelector).
 # --selector can be repeated for multiple selectors; --with-ancestors applies to all.
-fastweb-cli query_selectors --selector "button"
-fastweb-cli query_selectors --selector "button" --selector "link" --no-with-ancestors
+fastbrowser-cli query_selectors --selector "button"
+fastbrowser-cli query_selectors --selector "button" --selector "link" --no-with-ancestors
 
 # For per-selector control over withAncestors, pass a JSON array directly:
-fastweb-cli query_selectors --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
+fastbrowser-cli query_selectors --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
 
 # Press a sequence of keys
-fastweb-cli press_keys --keys "Tab, Tab, Enter"
-fastweb-cli press_keys --keys "Hello, Tab, Enter"
+fastbrowser-cli press_keys --keys "Tab, Tab, Enter"
+fastbrowser-cli press_keys --keys "Hello, Tab, Enter"
 ```
 
 ## Implementation Notes
@@ -82,5 +82,5 @@ fastweb-cli press_keys --keys "Hello, Tab, Enter"
 - The HTTP server is built with **Express**.
 - All REST request and response payloads are validated with **Zod**.
 - Every data structure has both a TypeScript `type` alias and a corresponding Zod schema — the type is derived from the schema via `z.infer<>` to keep them in sync.
-- `fastweb-http-server` lives in `contrib/fastweb-http-server/`.
-- `fastweb-cli` lives in `contrib/fastweb-cli/`.
+- `fastbrowser-httpd` lives in `contrib/fastbrowser-httpd/`.
+- `fastbrowser-cli` lives in `contrib/fastbrowser-cli/`.

package/package.json

@@ -1,16 +1,16 @@
 {
     "name": "fastbrowser_cli",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "description": "",
-    "main": "dist/fastweb_cli/fastweb_cli.js",
+    "main": "dist/fastbrowser_cli/fastbrowser_cli.js",
     "bin": {
-        "fastbrowser_cli": "./dist/fastweb_cli/fastweb_cli.js"
+        "fastbrowser_cli": "./dist/fastbrowser_cli/fastbrowser_cli.js"
     },
     "scripts": {
-        "start:fastweb_mcp": "npx tsx ./src/fastweb_mcp/fastweb_mcp.ts",
-        "start:http-server": "npx tsx ./src/fastweb_http_server/fastweb_http_server.ts",
-        "start:cli": "npx tsx ./src/fastweb_cli/fastweb_cli.ts",
-        "inspect:fastweb_mcp": "npx @modelcontextprotocol/inspector npx tsx ./src/fastweb_mcp/fastweb_mcp.ts mcp_server",
+        "start:fastbrowser_mcp": "npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts",
+        "start:http-server": "npx tsx ./src/fastbrowser_httpd/fastbrowser_httpd.ts",
+        "start:cli": "npx tsx ./src/fastbrowser_cli/fastbrowser_cli.ts",
+        "inspect:fastbrowser_mcp": "npx @modelcontextprotocol/inspector npx tsx ./src/fastbrowser_mcp/fastbrowser_mcp.ts mcp_server",
         "inspect:chrome-devtools": "npx @modelcontextprotocol/inspector npx chrome-devtools-mcp@latest --autoconnect",
         "build": "tsc -p tsconfig.json",
         "publish:all": "npm run build && npm version patch && npm publish --access public",

package/skills/fastbrowser/SKILL.md

@@ -0,0 +1,214 @@
+---
+name: fastbrowser
+description: >
+  Control a live browser from the command line: navigate, click, fill forms, and query the accessibility tree with CSS-like selectors. Lighter alternative to Chrome DevTools MCP or Puppeteer. Triggers on: navigate/click/fill actions, page snapshots, or mentions of fastbrowser.
+---
+
+# fastbrowser Skill
+
+`fastbrowser-cli` is a command-line client for the FastWeb HTTP server, which keeps a persistent
+MCP connection to a Chrome browser alive so commands incur minimal latency. Each command
+maps 1-to-1 to a FastWeb tool and returns the tool's response on stdout.
+
+## Invocation
+
+Run the CLI directly via `tsx`:
+
+```bash
+npx fastbrowser_cli <command> [flags]
+```
+
+## Typical Workflow
+
+1. **Query** the accessibility tree for specific nodes: `query_selectors` (first match per selector) or `query_selectors_all` (every match per selector).
+2. **Act** on an element by its accessibility selector: `click`, `fill_form`, `press_keys`. The selector can be a direct uid reference (e.g. `#1_42`, fastest path) or any CSS-like selector (e.g. `button[name="Submit"]`), which is resolved to a uid internally.
+
+Snapshot output looks like:
+
+```
+uid=1_0 RootWebArea "Example Domain" url="https://example.com/"
+  uid=1_1 heading "Example Domain" level="1"
+  uid=1_2 link "More information..." url="https://www.iana.org/..."
+```
+
+## Page Management
+
+```bash
+# List all open browser pages
+npx fastbrowser_cli list_pages
+
+# Open a new page at a URL
+npx fastbrowser_cli new_page --url https://example.com
+
+# Close a page by its numeric id
+npx fastbrowser_cli close_page --page-id 1
+
+# Navigate the current page to a URL
+npx fastbrowser_cli navigate_page --url https://example.com
+```
+
+
+## Selector Language
+
+The selector syntax is modelled on CSS selectors, adapted for accessibility tree structures.
+
+### Role selector
+
+Matches nodes by their accessibility role.
+
+```
+button
+link
+comboxbox
+searchbox
+heading
+WebArea
+```
+
+### Universal selector
+
+Matches any node.
+
+```
+*
+```
+
+### UID selector
+
+Matches a node by its exact unique identifier.
+
+```
+#4
+#1_3
+```
+
+### Attribute selectors
+
+Attribute selectors match values inside `node.attributes`. The special virtual attribute `name` maps to `node.name`.
+
+| Syntax | Semantics |
+|--------|-----------|
+| `[attr]` | attribute is present |
+| `[attr="value"]` | exact match |
+| `[attr^="prefix"]` | starts with |
+| `[attr$="suffix"]` | ends with |
+| `[attr*="sub"]` | contains substring |
+
+```
+link[href]
+button[disabled="true"]
+link[href^="https"]
+link[href$=".com"]
+link[href*="example"]
+heading[name="Welcome"]
+link[name="Click \"here\""]
+```
+
+### Combinators
+
+| Syntax | Semantics |
+|--------|-----------|
+| `A B` | B is a descendant of A (any depth) |
+| `A > B` | B is a direct child of A |
+| `A, B` | union — matches A or B |
+
+```
+WebArea link
+main > button
+heading, button
+RootWebArea > link[href^="https"]
+```
+
+### Examples
+
+Sample accessibility tree:
+
+```
+uid=1 WebArea "Main Page"
+  uid=2 main
+    uid=3 heading "Welcome"
+    uid=4 link "Click here" href="https://example.com"
+    uid=5 button "Submit" disabled="true"
+  uid=6 navigation
+    uid=7 link "Home" href="/"
+    uid=8 link "About" href="/about"
+```
+
+Example queries on it:
+- `link` matches all the links (uid=4, uid=7, uid=8)
+- 'navigation > link' matches only the links that are direct children of navigation (uid=7, uid=8)
+- `link[href^="https"]` matches links with an external href (uid=4)
+- `button[name="Submit"]` matches the submit button by name (uid=5)
+- `*[disabled="true"]` matches any disabled element (uid=5)
+- `heading, button` matches both headings and buttons in one query (uid=3, uid=5)
+- `#7` matches a node by its UID (uid=7)
+
+## Inspection
+
+- `query_selectors` and `query_selectors_all` are the most efficient way to get specific elements or data from the page. Use them instead of `take_snapshot` whenever possible.
+- Prefer `query_selectors` when you only need the first match per selector (cheaper, less output); use `query_selectors_all` when you need every match or want to cap with `--limit`.
+
+```bash
+# Query the accessibility tree returning the FIRST match per selector (--selector is repeatable)
+npx fastbrowser_cli query_selectors --selector "button" --selector "link"
+
+# Exclude ancestor nodes from the result
+npx fastbrowser_cli query_selectors --selector 'heading[level="1"]' --no-with-ancestors
+
+# Per-selector control over withAncestors via JSON
+npx fastbrowser_cli query_selectors \
+  --selectors-json '[{"selector":"button","withAncestors":true},{"selector":"link","withAncestors":false}]'
+
+# Query the accessibility tree returning ALL matches per selector (--selector is repeatable)
+npx fastbrowser_cli query_selectors_all --selector "button" --selector "link" --limit 5
+
+# Exclude ancestor nodes from the result
+npx fastbrowser_cli query_selectors_all --selector 'heading[level="1"]' --no-with-ancestors
+
+# Per-selector control over limit / withAncestors via JSON
+npx fastbrowser_cli query_selectors_all \
+  --selectors-json '[{"selector":"button","limit":3,"withAncestors":true},{"selector":"link","limit":0,"withAncestors":false}]'
+
+# Take an accessibility-tree full page snapshot of the current page - very expensive, prefer targeted queries when possible
+npx fastbrowser_cli take_snapshot
+```
+
+## Interaction
+
+```bash
+# Click by a direct uid reference (fast path - no accessibility-tree lookup)
+npx fastbrowser_cli click --selector "#1_42"
+
+# Click by any CSS-like selector - resolved to a uid internally
+npx fastbrowser_cli click -s 'button[name="Submit"]'
+
+# Fill a single form field - selector can be a uid (#1_7) or any CSS-like selector
+npx fastbrowser_cli fill_form -s 'textbox[name="Email"]' --value "hello@example.com"
+
+# Press a comma-separated sequence of keys (literals and named keys both work)
+npx fastbrowser_cli press_keys --keys "Tab, Tab, Enter"
+npx fastbrowser_cli press_keys --keys "Hello, Tab, Enter"
+```
+
+## Command Reference
+
+| Command | Purpose | Required flags |
+|---------|---------|----------------|
+| `list_pages` | List open browser pages | — |
+| `new_page` | Open a new page at a URL | `--url` |
+| `close_page` | Close a page by id | `--page-id` |
+| `navigate_page` | Navigate current page to a URL | `--url` |
+| `take_snapshot` | Dump the accessibility tree of the whole page - very expensive, prefer targeted queries (`query_selectors` / `query_selectors_all`) when possible | — |
+| `query_selectors` | Query a11y tree by CSS-like selector, returning the first match per selector | `--selector` or `--selectors-json` |
+| `query_selectors_all` | Query a11y tree by CSS-like selector, returning every match per selector | `--selector` or `--selectors-json` |
+| `click` | Click an element by accessibility selector | `--selector` / `-s` |
+| `fill_form` | Fill a form field by accessibility selector | `--selector` / `-s`, `--value` |
+| `press_keys` | Press a comma-separated key sequence | `--keys` |
+| `server start` | Start the HTTP server daemon | — |
+| `server status` | Report server running/stopped | — |
+| `server stop` | Stop the HTTP server | — |
+
+## Output & Errors
+
+Tool output is written to **stdout** — one line per response content part. On failure the
+CLI writes `fastbrowser-cli error: <message>` to **stderr** and exits with code 1.