camofox-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CamoFox MCP Contributors
+
+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/README.md

@@ -0,0 +1,201 @@
+# 🦊 CamoFox MCP
+
+**The anti-detection browser MCP server for AI agents.** Navigate, interact, and automate the web without getting blocked.
+
+[![npm version](https://img.shields.io/npm/v/camofox-mcp.svg)](https://www.npmjs.com/package/camofox-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
+[![MCP](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io/)
+
+---
+
+## Why CamoFox MCP?
+
+AI agents using Playwright get **blocked constantly**. CAPTCHAs, fingerprint detection, IP bans — the web fights back against automation.
+
+**CamoFox MCP** wraps the [CamoFox anti-detection browser](https://github.com/jo-inc/camofox-browser) as an MCP server, giving your AI agent:
+
+- 🛡️ **Anti-detection fingerprinting** — Each tab gets a unique, human-like browser fingerprint
+- ⚡ **Fast, token-efficient snapshots** — Accessibility tree snapshots use 90% fewer tokens than screenshots
+- 🔍 **Built-in search** — Search Google, YouTube, Amazon + 11 more engines without getting blocked  
+- 🍪 **Session persistence** — Import cookies, maintain login state across interactions
+- 🎯 **CSS selector fallback** — Target elements even when accessibility refs aren't available
+
+### CamoFox MCP vs Playwright MCP
+
+| Feature | CamoFox MCP | Playwright MCP |
+|---------|:-----------:|:--------------:|
+| Anti-detection fingerprinting | ✅ | ❌ |
+| Passes bot detection tests | ✅ | ❌ |
+| Search engine macros (14 engines) | ✅ | ❌ |
+| Accessibility snapshots | ✅ | ✅ |
+| Cookie import/export | ✅ | Limited |
+| Headless support | ✅ | ✅ |
+| Setup complexity | Medium | Easy |
+| Token efficiency | High | High |
+
+### CamoFox MCP vs Other Camoufox MCPs
+
+| Feature | CamoFox MCP | whit3rabbit/camoufox-mcp | baixianger/camoufox-mcp |
+|---------|:-----------:|:-----------------------:|:-----------------------:|
+| Tools | 18 | 1 | 33 |
+| Architecture | REST API client | Direct browser | Direct browser |
+| Session persistence | ✅ | ❌ (destroyed per request) | ✅ |
+| Token efficiency | High (snapshots) | Low (raw HTML) | High (snapshots) |
+| Search macros | ✅ (14 engines) | ❌ | ❌ |
+| CSS selector fallback | ✅ | ❌ | ❌ |
+| Active maintenance | ✅ | ❌ (stale 8mo) | ✅ |
+| Press key support | ✅ | ❌ | ✅ |
+
+## Quick Start
+
+### Prerequisites
+
+1. Install and run [CamoFox Browser](https://github.com/jo-inc/camofox-browser):
+   ```bash
+   # Follow CamoFox installation guide
+   # CamoFox must be running on port 9377 (default)
+   ```
+
+### VS Code / Cursor / Claude Desktop
+
+Add to your MCP configuration:
+
+```json
+{
+  "camofox": {
+    "command": "node",
+    "args": ["/path/to/camofox-mcp/dist/index.js"],
+    "env": {
+      "CAMOFOX_URL": "http://localhost:9377"
+    },
+    "type": "stdio"
+  }
+}
+```
+
+### From Source
+
+```bash
+git clone https://github.com/redf0x1/camofox-mcp.git
+cd camofox-mcp
+npm install
+npm run build
+```
+
+## Tools (18)
+
+### Tab Management
+| Tool | Description |
+|------|-------------|
+| `create_tab` | Create a new tab with anti-detection fingerprinting |
+| `close_tab` | Close a tab and release resources |
+| `list_tabs` | List all open tabs with URLs and titles |
+
+### Navigation
+| Tool | Description |
+|------|-------------|
+| `navigate` | Navigate to a URL, waits for page load |
+| `go_back` | Browser back button |
+| `go_forward` | Browser forward button |
+| `refresh` | Reload current page |
+
+### Interaction
+| Tool | Description |
+|------|-------------|
+| `click` | Click element by ref (from snapshot) or CSS selector |
+| `type_text` | Type text into input fields by ref or CSS selector |
+| `press_key` | Press keyboard keys (Enter, Tab, Escape, etc.) |
+| `scroll` | Scroll page up or down by pixel amount |
+
+### Observation
+| Tool | Description |
+|------|-------------|
+| `snapshot` | Get accessibility tree — PRIMARY way to read pages. Token-efficient |
+| `screenshot` | Take visual screenshot as base64 PNG |
+| `get_links` | Get all hyperlinks with URLs and text |
+
+### Search
+| Tool | Description |
+|------|-------------|
+| `web_search` | Search via 14 engines: Google, YouTube, Amazon, Bing, DuckDuckGo, Reddit, GitHub, StackOverflow, Wikipedia, Twitter, LinkedIn, Facebook, Instagram, TikTok |
+
+### Session
+| Tool | Description |
+|------|-------------|
+| `import_cookies` | Import cookies for authenticated sessions |
+| `get_stats` | Get session statistics and performance metrics |
+| `server_status` | Check CamoFox server health and connection |
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CAMOFOX_URL` | `http://localhost:9377` | CamoFox server URL |
+| `CAMOFOX_TIMEOUT` | `30000` | Request timeout in ms |
+| `CAMOFOX_API_KEY` | — | API key (if CamoFox requires auth) |
+
+## Architecture
+
+```
+AI Agent (Claude, GPT, etc.)
+       │
+       │ MCP Protocol (stdio)
+       ▼
+┌─────────────────┐
+│  CamoFox MCP    │  ← This package
+│  (TypeScript)   │
+└────────┬────────┘
+         │
+         │ REST API (HTTP)
+         ▼
+┌─────────────────┐
+│  CamoFox Server │  ← Anti-detection browser
+│  (Port 9377)    │
+└────────┬────────┘
+         │
+         │ Browser Engine
+         ▼
+┌─────────────────┐
+│  Camoufox       │  ← Firefox-based, fingerprint spoofing
+│  (Firefox)      │
+└─────────────────┘
+```
+
+## How It Works
+
+1. **Your AI agent** sends MCP tool calls (e.g., `create_tab`, `navigate`, `snapshot`)
+2. **CamoFox MCP** translates these into REST API calls to the CamoFox server
+3. **CamoFox server** manages a Camoufox browser with anti-detection features
+4. **Each tab** gets a unique fingerprint — different user agent, screen size, WebGL, fonts, etc.
+5. **Websites see** what appears to be a normal human browser, not automation
+
+## Anti-Detection Features
+
+CamoFox (via [Camoufox](https://github.com/jo-inc/camofox-browser)) provides:
+
+- ✅ Unique browser fingerprint per tab
+- ✅ Human-like user agent rotation
+- ✅ WebGL fingerprint spoofing
+- ✅ Canvas fingerprint protection
+- ✅ Screen resolution randomization
+- ✅ Font enumeration protection
+- ✅ Navigator properties masking
+- ✅ Timezone/locale consistency
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a PR.
+
+## License
+
+[MIT](LICENSE)
+
+## Acknowledgments
+
+- [CamoFox Browser](https://github.com/jo-inc/camofox-browser) — The anti-detection browser this MCP wraps
+- [Camoufox](https://camoufox.com/) — Firefox-based anti-detection browser engine
+- [Model Context Protocol](https://modelcontextprotocol.io/) — The protocol standard by Anthropic

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+import type { ClickParams, ClickResponse, Config, CreateTabParams, HealthResponse, LinkResponse, NavigateResponse, SnapshotResponse, StatsResponse, TabResponse } from "./types.js";
+export declare class CamofoxClient {
+    private readonly baseUrl;
+    private readonly timeout;
+    private readonly apiKey?;
+    constructor(config: Config);
+    healthCheck(): Promise<HealthResponse>;
+    createTab(params: CreateTabParams): Promise<TabResponse>;
+    closeTab(tabId: string, userId: string): Promise<void>;
+    navigate(tabId: string, url: string, userId: string): Promise<NavigateResponse>;
+    navigateMacro(tabId: string, macro: string, query: string, userId: string): Promise<NavigateResponse>;
+    goBack(tabId: string, userId: string): Promise<void>;
+    goForward(tabId: string, userId: string): Promise<void>;
+    refresh(tabId: string, userId: string): Promise<void>;
+    click(tabId: string, params: ClickParams, userId: string): Promise<ClickResponse>;
+    typeText(tabId: string, locator: {
+        ref?: string;
+        selector?: string;
+    }, text: string, userId: string): Promise<void>;
+    pressKey(tabId: string, key: string, userId: string): Promise<void>;
+    scroll(tabId: string, direction: string, amount: number | undefined, userId: string): Promise<void>;
+    snapshot(tabId: string, userId: string): Promise<SnapshotResponse>;
+    screenshot(tabId: string, userId: string): Promise<Buffer>;
+    getLinks(tabId: string, userId: string): Promise<LinkResponse>;
+    getStats(tabId: string, userId: string): Promise<StatsResponse>;
+    importCookies(userId: string, cookies: string): Promise<void>;
+    private requestJson;
+    private requestBinary;
+    private requestNoContent;
+    private request;
+    private buildHttpError;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,MAAM,EACN,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAC;AAOpB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,EAAE,MAAM;IAMpB,WAAW,IAAI,OAAO,CAAC,cAAc,CAAC;IAItC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAsBxD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY/E,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAYrG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAYjF,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAelE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU1D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB9D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAS/D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQrD,WAAW;YAQX,aAAa;YAKb,gBAAgB;YAIhB,OAAO;YAmDP,cAAc;CA2B7B"}

package/dist/client.js

@@ -0,0 +1,224 @@
+import { AppError } from "./errors.js";
+export class CamofoxClient {
+    baseUrl;
+    timeout;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.camofoxUrl.replace(/\/$/, "");
+        this.timeout = config.timeout;
+        this.apiKey = config.apiKey;
+    }
+    async healthCheck() {
+        return this.requestJson("/health", { method: "GET" });
+    }
+    async createTab(params) {
+        const response = await this.requestJson("/tabs", {
+            method: "POST",
+            body: JSON.stringify(params)
+        });
+        const tabId = response.tabId ??
+            response.id ??
+            (response.tab?.id ?? undefined);
+        if (!tabId) {
+            throw new AppError("INTERNAL_ERROR", "CamoFox did not return a valid tab ID");
+        }
+        return {
+            tabId,
+            url: response.url ?? params.url ?? "about:blank",
+            title: response.title
+        };
+    }
+    async closeTab(tabId, userId) {
+        await this.requestNoContent(`/tabs/${encodeURIComponent(tabId)}`, {
+            method: "DELETE",
+            body: JSON.stringify({ userId })
+        });
+    }
+    async navigate(tabId, url, userId) {
+        const response = await this.requestJson(`/tabs/${encodeURIComponent(tabId)}/navigate`, {
+            method: "POST",
+            body: JSON.stringify({ url, userId })
+        });
+        return {
+            url: response.url ?? url,
+            title: response.title
+        };
+    }
+    async navigateMacro(tabId, macro, query, userId) {
+        const response = await this.requestJson(`/tabs/${encodeURIComponent(tabId)}/navigate`, {
+            method: "POST",
+            body: JSON.stringify({ macro, query, userId })
+        });
+        return {
+            url: response.url ?? "",
+            title: response.title
+        };
+    }
+    async goBack(tabId, userId) {
+        await this.requestNoContent(`/tabs/${encodeURIComponent(tabId)}/back`, {
+            method: "POST",
+            body: JSON.stringify({ userId })
+        });
+    }
+    async goForward(tabId, userId) {
+        await this.requestNoContent(`/tabs/${encodeURIComponent(tabId)}/forward`, {
+            method: "POST",
+            body: JSON.stringify({ userId })
+        });
+    }
+    async refresh(tabId, userId) {
+        await this.requestNoContent(`/tabs/${encodeURIComponent(tabId)}/refresh`, {
+            method: "POST",
+            body: JSON.stringify({ userId })
+        });
+    }
+    async click(tabId, params, userId) {
+        const response = await this.requestJson(`/tabs/${encodeURIComponent(tabId)}/click`, {
+            method: "POST",
+            body: JSON.stringify({ ...params, userId })
+        });
+        return {
+            success: response.success ?? true,
+            navigated: response.navigated
+        };
+    }
+    async typeText(tabId, locator, text, userId) {
+        await this.requestNoContent(`/tabs/${encodeURIComponent(tabId)}/type`, {
+            method: "POST",
+            body: JSON.stringify({ ...locator, text, userId })
+        });
+    }
+    async pressKey(tabId, key, userId) {
+        await this.requestNoContent(`/tabs/${encodeURIComponent(tabId)}/press`, {
+            method: "POST",
+            body: JSON.stringify({ key, userId })
+        });
+    }
+    async scroll(tabId, direction, amount, userId) {
+        await this.requestNoContent(`/tabs/${encodeURIComponent(tabId)}/scroll`, {
+            method: "POST",
+            body: JSON.stringify({ direction, amount, userId })
+        });
+    }
+    async snapshot(tabId, userId) {
+        const response = await this.requestJson(`/tabs/${encodeURIComponent(tabId)}/snapshot?userId=${encodeURIComponent(userId)}`, {
+            method: "GET"
+        });
+        return {
+            url: response.url ?? "",
+            snapshot: response.snapshot ?? "",
+            refsCount: response.refsCount ?? 0
+        };
+    }
+    async screenshot(tabId, userId) {
+        const binary = await this.requestBinary(`/tabs/${encodeURIComponent(tabId)}/screenshot?userId=${encodeURIComponent(userId)}`, {
+            method: "GET"
+        });
+        return Buffer.from(binary);
+    }
+    async getLinks(tabId, userId) {
+        const response = await this.requestJson(`/tabs/${encodeURIComponent(tabId)}/links?userId=${encodeURIComponent(userId)}`, {
+            method: "GET"
+        });
+        const links = Array.isArray(response.links) ? response.links : [];
+        return {
+            links: links.map((item) => ({
+                text: String(item.text ?? ""),
+                href: String(item.href ?? "")
+            }))
+        };
+    }
+    async getStats(tabId, userId) {
+        return this.requestJson(`/tabs/${encodeURIComponent(tabId)}/stats?userId=${encodeURIComponent(userId)}`, {
+            method: "GET"
+        });
+    }
+    async importCookies(userId, cookies) {
+        await this.requestNoContent(`/sessions/${encodeURIComponent(userId)}/cookies`, {
+            method: "POST",
+            body: JSON.stringify({ cookies }),
+            requireApiKey: true
+        });
+    }
+    async requestJson(path, init) {
+        const response = await this.request(path, init);
+        if (response.status === 204) {
+            return {};
+        }
+        return (await response.json());
+    }
+    async requestBinary(path, init) {
+        const response = await this.request(path, init);
+        return response.arrayBuffer();
+    }
+    async requestNoContent(path, init) {
+        await this.request(path, init);
+    }
+    async request(path, init) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            if (init.requireApiKey && !this.apiKey) {
+                throw new AppError("API_KEY_REQUIRED", "CAMOFOX_API_KEY is required for this operation");
+            }
+            const headers = {
+                "content-type": "application/json"
+            };
+            if (this.apiKey) {
+                headers["x-api-key"] = this.apiKey;
+                headers.authorization = `Bearer ${this.apiKey}`;
+            }
+            const response = await fetch(`${this.baseUrl}${path}`, {
+                ...init,
+                headers: {
+                    ...headers,
+                    ...init.headers
+                },
+                signal: controller.signal
+            });
+            if (!response.ok) {
+                throw await this.buildHttpError(response);
+            }
+            return response;
+        }
+        catch (error) {
+            if (error instanceof AppError) {
+                throw error;
+            }
+            if (error instanceof DOMException && error.name === "AbortError") {
+                throw new AppError("TIMEOUT", `CamoFox API request timed out after ${this.timeout}ms`);
+            }
+            if (error instanceof Error) {
+                throw new AppError("CONNECTION_REFUSED", `Failed to connect to CamoFox API: ${error.message}`);
+            }
+            throw new AppError("INTERNAL_ERROR", "Unknown error while calling CamoFox API");
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async buildHttpError(response) {
+        let message = `CamoFox API request failed with ${response.status}`;
+        const rawBody = await response.text();
+        if (rawBody) {
+            try {
+                const body = JSON.parse(rawBody);
+                message = body.error ?? body.message ?? rawBody;
+            }
+            catch {
+                message = rawBody;
+            }
+        }
+        if (response.status === 404) {
+            return new AppError("TAB_NOT_FOUND", message, response.status);
+        }
+        if (response.status === 400 && /element|ref|selector/i.test(message)) {
+            return new AppError("ELEMENT_NOT_FOUND", message, response.status);
+        }
+        if (response.status >= 500) {
+            return new AppError("NAVIGATION_FAILED", message, response.status);
+        }
+        return new AppError("INTERNAL_ERROR", message, response.status);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,3 @@
+import { type Config } from "./types.js";
+export declare function loadConfig(argv?: string[], env?: NodeJS.ProcessEnv): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AA8CzC,wBAAgB,UAAU,CAAC,IAAI,WAAwB,EAAE,GAAG,oBAAc,GAAG,MAAM,CAUlF"}

package/dist/config.js

@@ -0,0 +1,41 @@
+function parseCliArgs(argv) {
+    const args = {};
+    for (let i = 0; i < argv.length; i += 1) {
+        const current = argv[i];
+        const next = argv[i + 1];
+        if ((current === "--camofox-url" || current === "--url") && next) {
+            args.camofoxUrl = next;
+            i += 1;
+            continue;
+        }
+        if ((current === "--api-key" || current === "--key") && next) {
+            args.apiKey = next;
+            i += 1;
+            continue;
+        }
+        if ((current === "--default-user-id" || current === "--user-id") && next) {
+            args.defaultUserId = next;
+            i += 1;
+            continue;
+        }
+        if (current === "--timeout" && next) {
+            const timeout = Number.parseInt(next, 10);
+            if (!Number.isNaN(timeout) && timeout > 0) {
+                args.timeout = timeout;
+            }
+            i += 1;
+        }
+    }
+    return args;
+}
+export function loadConfig(argv = process.argv.slice(2), env = process.env) {
+    const cli = parseCliArgs(argv);
+    const timeoutFromEnv = Number.parseInt(env.CAMOFOX_TIMEOUT ?? "", 10);
+    return {
+        camofoxUrl: cli.camofoxUrl ?? env.CAMOFOX_URL ?? "http://localhost:9377",
+        apiKey: cli.apiKey ?? env.CAMOFOX_API_KEY,
+        defaultUserId: cli.defaultUserId ?? env.CAMOFOX_DEFAULT_USER_ID ?? "default",
+        timeout: cli.timeout ?? (Number.isNaN(timeoutFromEnv) ? 30_000 : timeoutFromEnv)
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,SAAS,YAAY,CAAC,IAAc;IAClC,MAAM,IAAI,GAAY,EAAE,CAAC;IAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAEzB,IAAI,CAAC,OAAO,KAAK,eAAe,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YACjE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO,KAAK,mBAAmB,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;YACzE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,OAAO,KAAK,WAAW,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACzB,CAAC;YACD,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG;IACxE,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAEtE,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,WAAW,IAAI,uBAAuB;QACxE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,eAAe;QACzC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,uBAAuB,IAAI,SAAS;QAC5E,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;KACjF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+export type ErrorCode = "CONNECTION_REFUSED" | "TAB_NOT_FOUND" | "ELEMENT_NOT_FOUND" | "NAVIGATION_FAILED" | "API_KEY_REQUIRED" | "TIMEOUT" | "VALIDATION_ERROR" | "INTERNAL_ERROR";
+export declare class AppError extends Error {
+    readonly code: ErrorCode;
+    readonly status?: number;
+    constructor(code: ErrorCode, message: string, status?: number);
+}
+export interface ToolResult {
+    [key: string]: unknown;
+    isError?: boolean;
+    content: Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }>;
+}
+export declare function okResult(data: unknown): ToolResult;
+export declare function imageResult(base64Png: string): ToolResult;
+export declare function normalizeError(error: unknown): AppError;
+export declare function toErrorResult(error: unknown): ToolResult;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GACjB,oBAAoB,GACpB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,GACT,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEpB,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM9D;AAED,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,KAAK,CACV;QACE,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,GACD;QACE,IAAI,EAAE,OAAO,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;KAClB,CACJ,CAAC;CACH;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAIlD;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAIzD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAcvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAYxD"}

package/dist/errors.js

@@ -0,0 +1,46 @@
+import { ZodError } from "zod";
+export class AppError extends Error {
+    code;
+    status;
+    constructor(code, message, status) {
+        super(message);
+        this.name = "AppError";
+        this.code = code;
+        this.status = status;
+    }
+}
+export function okResult(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data) }]
+    };
+}
+export function imageResult(base64Png) {
+    return {
+        content: [{ type: "image", data: base64Png, mimeType: "image/png" }]
+    };
+}
+export function normalizeError(error) {
+    if (error instanceof AppError) {
+        return error;
+    }
+    if (error instanceof ZodError) {
+        return new AppError("VALIDATION_ERROR", error.issues.map((issue) => issue.message).join(", "));
+    }
+    if (error instanceof Error) {
+        return new AppError("INTERNAL_ERROR", error.message);
+    }
+    return new AppError("INTERNAL_ERROR", "An unknown internal error occurred");
+}
+export function toErrorResult(error) {
+    const appError = normalizeError(error);
+    const payload = {
+        isError: true,
+        code: appError.code,
+        message: appError.message
+    };
+    return {
+        isError: true,
+        content: [{ type: "text", text: JSON.stringify(payload) }]
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAY/B,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,IAAI,CAAY;IAEhB,MAAM,CAAU;IAEhC,YAAY,IAAe,EAAE,OAAe,EAAE,MAAe;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAkBD,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,QAAQ,CAAC,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,oCAAoC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;KAC1B,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}