poke-browser 0.2.8

package/README.md

@@ -0,0 +1,60 @@
+# poke-browser-mcp
+
+Node process that implements an **MCP server** (stdio) and a **WebSocket server** (localhost) used by the **poke-browser** Chrome extension.
+
+## Role in the stack
+
+1. **WebSocket (extension → this process)**  
+   The extension connects to `ws://127.0.0.1:<port>`. This package listens on that port (default **9009**). When a new client connects, any previous client is closed so only one browser session is attached at a time.
+
+2. **JSON commands**  
+   The server sends messages shaped like:
+
+   ```json
+   { "type": "command", "id": "<uuid>", "command": "navigate", "payload": { "url": "https://example.com" } }
+   ```
+
+   The extension replies with:
+
+   ```json
+   { "type": "response", "id": "<uuid>", "ok": true, "result": { } }
+   ```
+
+   or `ok: false` and an `error` string.
+
+   On connect, the extension may send `{ "type": "hello", "client": "poke-browser-extension", "version": "..." }` for logging only.
+
+3. **MCP (AI client → this process)**  
+   The official `@modelcontextprotocol/sdk` exposes tools (`list_tabs`, `get_active_tab`, `navigate`, `click`, `screenshot`, `evaluate_js`, `new_tab`, `close_tab`). Each tool forwards to the extension over the WebSocket and returns JSON text in the MCP result.
+
+## Configuration
+
+| Variable | Default | Meaning |
+|----------|---------|---------|
+| `POKE_BROWSER_WS_PORT` | `9009` | WebSocket listen port (`WS_PORT` is also read as a fallback) |
+
+The Chrome extension stores its target port in `chrome.storage.local` (`wsPort`); keep it aligned with this value.
+
+## Scripts
+
+| Command | Description |
+|---------|-------------|
+| `npm start` | Run `index.ts` with `tsx` (stdio MCP + WebSocket) |
+| `npm run build` | Emit JavaScript to `dist/` |
+| `npm run serve` | Run `node dist/index.js` |
+
+## Dependencies
+
+- `@modelcontextprotocol/sdk` — MCP server over stdio  
+- `ws` — WebSocket server for the extension  
+- `zod` — tool input schemas (peer-style dependency of the SDK)
+
+## Development
+
+Typecheck:
+
+```bash
+npx tsc --noEmit
+```
+
+The server logs WebSocket lifecycle messages on **stderr** so stdio **stdout** stays clean for MCP JSON-RPC.

package/cli.mjs

@@ -0,0 +1,457 @@
+#!/usr/bin/env node
+/**
+ * Launcher for poke-browser MCP (same Poke auth + tunnel pattern as @leokok/poke-apple-music).
+ * Auth: `npx poke@latest whoami` / `poke login` — not POKE_API_KEY.
+ * Tunnel: `npx poke@latest tunnel <local /mcp URL> -n "<label>"` (stdio inherit).
+ *
+ * Mode selection (first match wins):
+ *   1. stdin is a pipe (not TTY)  → stdio MCP mode (Cursor, Claude Desktop, etc.)
+ *   2. --http or --stdio flag     → explicit HTTP / stdio mode
+ *   3. everything else            → poke-tunnel mode (interactive terminal)
+ */
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { stdin as input, stderr as output } from "node:process";
+
+async function findAvailablePort(startPort) {
+  const net = await import("node:net");
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.listen(startPort, "127.0.0.1", () => {
+      const port = server.address().port;
+      server.close(() => resolve(port));
+    });
+    server.on("error", () => resolve(findAvailablePort(startPort + 1)));
+  });
+}
+
+// Handle setup command
+if (process.argv.includes("setup") || process.argv.includes("--install")) {
+  const { cp, mkdir } = await import("node:fs/promises");
+  const { resolve } = await import("node:path");
+  const __dir = dirname(fileURLToPath(import.meta.url));
+  const srcExt = resolve(__dir, "..", "extension");
+  const destExt = resolve(process.cwd(), "poke-browser-extension");
+  try {
+    await mkdir(destExt, { recursive: true });
+    await cp(srcExt, destExt, { recursive: true, force: true });
+    console.log("\n  poke-browser setup complete!\n");
+    console.log("  Extension copied to: " + destExt + "\n");
+    console.log("  Next: open chrome://extensions, enable Developer Mode,");
+    console.log('  click "Load unpacked" and select: ' + destExt + "\n");
+  } catch (e) {
+    console.error("  Setup failed:", e.message);
+  }
+  process.exit(0);
+}
+
+const require = createRequire(import.meta.url);
+const pkg = require("./package.json");
+const VERSION = pkg.version;
+
+const root = dirname(fileURLToPath(import.meta.url));
+const entry = join(root, "dist", "index.js");
+
+const rawArgs = process.argv.slice(2);
+const verboseCli =
+  rawArgs.includes("--debug") || rawArgs.includes("--verbose");
+
+/** Same shape as @leokok/poke-agents `argAfter` (used there for `--mcp-name`). */
+function argAfter(flag) {
+  const i = process.argv.indexOf(flag);
+  if (i === -1) return null;
+  const v = process.argv[i + 1];
+  if (v == null || String(v).startsWith("-")) return null;
+  return String(v);
+}
+
+function slugifyMcpServerName(s) {
+  const t = String(s)
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+  if (t.length === 0) return "poke-browser-mcp";
+  return t.length > 64 ? t.slice(0, 64) : t;
+}
+
+/** Custom Poke tunnel `-n` label + MCP `initialize` server name (when `--name` is passed). */
+const customMcpName = argAfter("--name");
+
+const color =
+  output.isTTY && !process.env.NO_COLOR
+    ? {
+        dim: (s) => `\x1b[2m${s}\x1b[0m`,
+        bold: (s) => `\x1b[1m${s}\x1b[0m`,
+        green: (s) => `\x1b[32m${s}\x1b[0m`,
+        red: (s) => `\x1b[31m${s}\x1b[0m`,
+        grey: (s) => `\x1b[90m${s}\x1b[0m`,
+      }
+    : {
+        dim: (s) => s,
+        bold: (s) => s,
+        green: (s) => s,
+        red: (s) => s,
+        grey: (s) => s,
+      };
+
+/** Same check as poke-apple-music `checkPokeLogin`. */
+function checkPokeLogin() {
+  const r = spawnSync("npx", ["--yes", "poke@latest", "whoami"], {
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+    env: process.env,
+  });
+  return r.status === 0;
+}
+
+/**
+ * Same flow as poke-apple-music preflight: `poke whoami`, then `poke login` if needed.
+ * Set POKE_BROWSER_SKIP_POKE_LOGIN=1 to skip (e.g. CI).
+ */
+function ensurePokeLoginForTunnel() {
+  if (process.env.POKE_BROWSER_SKIP_POKE_LOGIN === "1") {
+    return true;
+  }
+  if (checkPokeLogin()) {
+    return true;
+  }
+  console.error(
+    color.dim("  Not signed in to Poke (`npx poke@latest whoami` failed)."),
+  );
+  if (!input.isTTY) {
+    console.error(
+      color.red(
+        "  Run `npx poke@latest login` in a terminal, or set POKE_BROWSER_SKIP_POKE_LOGIN=1.",
+      ),
+    );
+    return false;
+  }
+  console.error(
+    color.dim(
+      "  Starting Poke login in your browser (complete the flow, then return here).",
+    ),
+  );
+  const login = spawnSync("npx", ["--yes", "poke@latest", "login"], {
+    stdio: "inherit",
+    env: process.env,
+  });
+  if (login.status !== 0) {
+    console.error(color.red("  `poke login` did not finish successfully."));
+    return false;
+  }
+  if (!checkPokeLogin()) {
+    console.error(color.red("  Still not signed in after login."));
+    return false;
+  }
+  return true;
+}
+
+function extensionFolderPath() {
+  const inPkg = join(root, "extension");
+  if (existsSync(inPkg)) return inPkg;
+  return join(root, "..", "extension");
+}
+
+function printQuietStartupBanner({
+  mcpPort,
+  wsPort,
+  mcpDesiredStart,
+  wsDesiredStart,
+  showMcpLine,
+}) {
+  const extPath = extensionFolderPath();
+  const mcpAuto = mcpPort !== mcpDesiredStart ? " (auto-selected)" : "";
+  const wsAuto = wsPort !== wsDesiredStart ? " (auto-selected)" : "";
+  console.error("");
+  console.error(
+    customMcpName
+      ? `  poke-browser v${VERSION} (as '${customMcpName}')`
+      : `  poke-browser v${VERSION}`,
+  );
+  console.error("");
+  console.error("  Load the Chrome extension:");
+  console.error("");
+  console.error("  1. Open chrome://extensions");
+  console.error("");
+  console.error("  2. Enable Developer Mode");
+  console.error("");
+  console.error("  3. Click Load unpacked \u2192 select the /extension folder");
+  console.error(
+    color.grey(
+      "     (NOT the root \u2014 open poke-browser/extension specifically)",
+    ),
+  );
+  console.error(color.dim(`     ${extPath}`));
+  console.error("");
+  console.error("  4. Extension auto-connects to this server");
+  console.error("");
+  console.error("  \u2605 Star us: https://github.com/leoakok/poke-browser");
+  console.error("");
+  console.error("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  if (showMcpLine) {
+    console.error(
+      `  Local MCP:  http://127.0.0.1:${mcpPort}/mcp${mcpAuto}`,
+    );
+  }
+  console.error(`  Local WS:   ws://127.0.0.1:${wsPort}${wsAuto}`);
+  console.error("");
+}
+
+function childEnv() {
+  const env = { ...process.env };
+  if (verboseCli) env.POKE_BROWSER_VERBOSE = "1";
+  if (customMcpName) {
+    env.POKE_BROWSER_TUNNEL_NAME = customMcpName;
+    env.POKE_BROWSER_MCP_SERVER_NAME = slugifyMcpServerName(customMcpName);
+  }
+  return env;
+}
+
+if (rawArgs.includes("--help") || rawArgs.includes("-h")) {
+  console.error(`poke-browser \u2014 MCP server for the poke-browser Chrome extension
+
+Usage:
+  poke-browser                    Poke tunnel mode when run in a terminal (default)
+  poke-browser --poke-tunnel      Same as above (explicit)
+  poke-browser --stdio            Force stdio MCP mode (Cursor, Claude Desktop, etc.)
+  poke-browser --http [port]      Streamable HTTP MCP on 127.0.0.1 (default: env POKE_BROWSER_MCP_PORT or 8755)
+  poke-browser --tunnel [port]    Same as --http, then: npx poke@latest tunnel \u2026/mcp
+  poke-browser --name <label>     Poke tunnel -n label and MCP server id
+  poke-browser --debug            Verbose stderr ([poke-browser], WebSocket port, MCP debug)
+  poke-browser --verbose          Same as --debug
+
+Mode selection (first match wins):
+  - stdin is NOT a TTY (piped)    \u2192 stdio mode  (Cursor / Claude Desktop auto-detection)
+  - --http or --stdio flag        \u2192 explicit HTTP / stdio mode
+  - interactive terminal          \u2192 poke-tunnel mode (shows public URL)
+
+Poke auth (tunnel flows):
+  Uses the global Poke CLI \u2014 same as @leokok/poke-apple-music:
+    npx poke@latest whoami    # must succeed before tunnel
+    npx poke@latest login     # browser login if needed
+  Optional: POKE_BROWSER_SKIP_POKE_LOGIN=1 to skip the whoami/login gate.
+
+Environment:
+  POKE_BROWSER_WS_PORT          WebSocket port for the extension (default 9009)
+  POKE_BROWSER_MCP_PORT       HTTP MCP listen port for --http / tunnel (default 8755)
+  POKE_BROWSER_PORT             Alias for HTTP MCP port (same as run.ts)
+  POKE_BROWSER_TUNNEL_NAME      poke tunnel -n label (default: poke-browser; --name overrides)
+  POKE_BROWSER_MCP_SERVER_NAME  MCP initialize server name slug (set from --name when passed)
+
+Build once (or pass --build):
+  npm run build
+`);
+  process.exit(0);
+}
+
+if (rawArgs.includes("--version") || rawArgs.includes("-v")) {
+  console.error(pkg.version ?? "0.0.0");
+  process.exit(0);
+}
+
+const wantBuild = rawArgs.includes("--build");
+
+/**
+ * Tunnel mode is active when ANY of:
+ *   1. npm run start:tunnel lifecycle
+ *   2. explicit --poke-tunnel flag
+ *   3. --name flag (custom label implies tunnel intent)
+ *   4. stdin is an interactive TTY AND no explicit --http / --stdio / pipe mode
+ *
+ * stdio mode (for Cursor / Claude Desktop) is used when:
+ *   - stdin is NOT a TTY (process is spawned with a pipe), OR
+ *   - --stdio flag is explicitly passed, OR
+ *   - --http flag is explicitly passed
+ */
+const wantStdioMode =
+  !input.isTTY ||
+  rawArgs.includes("--stdio") ||
+  rawArgs.includes("--http");
+
+const wantPokeTunnelFlow =
+  !wantStdioMode ||
+  process.env.npm_lifecycle_event === "start:tunnel" ||
+  rawArgs.includes("--poke-tunnel") ||
+  !!customMcpName;
+
+const childArgs = rawArgs.filter((a, i, arr) => {
+  if (
+    a === "--build" ||
+    a === "--poke-tunnel" ||
+    a === "--stdio" ||
+    a === "--debug" ||
+    a === "--verbose" ||
+    a === "--name"
+  ) {
+    return false;
+  }
+  if (i > 0 && arr[i - 1] === "--name") return false;
+  return true;
+});
+
+function readMcpDesiredStartFromCliArgs(args) {
+  const i = args.indexOf("--http");
+  if (i === -1) return null;
+  const next = args[i + 1];
+  if (next != null && /^\d+$/.test(String(next))) return Math.trunc(Number(next));
+  return null;
+}
+
+function readMcpDesiredStart(args) {
+  const fromCli = readMcpDesiredStartFromCliArgs(args);
+  if (fromCli !== null) return fromCli;
+  const raw =
+    process.env.POKE_BROWSER_MCP_PORT ??
+    process.env.POKE_BROWSER_PORT ??
+    "8755";
+  const httpPort = Number(raw);
+  return Number.isFinite(httpPort) && httpPort > 0 && httpPort <= 65535
+    ? Math.trunc(httpPort)
+    : 8755;
+}
+
+function readWsDesiredStart() {
+  const raw = process.env.POKE_BROWSER_WS_PORT ?? "9009";
+  const n = Number(raw);
+  return Number.isFinite(n) && n > 0 && n <= 65535 ? Math.trunc(n) : 9009;
+}
+
+function cloneArgsWithResolvedMcpPort(args, mcpPort) {
+  const out = [...args];
+  const i = out.indexOf("--http");
+  if (i !== -1 && out[i + 1] != null && /^\d+$/.test(String(out[i + 1]))) {
+    out[i + 1] = String(mcpPort);
+  }
+  return out;
+}
+
+function runBuild() {
+  const npm = process.platform === "win32" ? "npm.cmd" : "npm";
+  const b = spawnSync(npm, ["run", "build"], {
+    cwd: root,
+    stdio: "inherit",
+    env: process.env,
+  });
+  if (b.error) {
+    console.error(b.error);
+    process.exit(1);
+  }
+  if (b.status !== 0) {
+    process.exit(b.status ?? 1);
+  }
+}
+
+if (wantBuild) {
+  runBuild();
+}
+
+if (!existsSync(entry)) {
+  console.error(
+    "poke-browser: missing dist/. Run `npm run build` in this package, or pass `--build` once.",
+  );
+  process.exit(1);
+}
+
+(async () => {
+  const mcpDesiredStart = readMcpDesiredStart(childArgs);
+  const wsDesiredStart = readWsDesiredStart();
+  const mcpPort = await findAvailablePort(mcpDesiredStart);
+  const wsPort = await findAvailablePort(wsDesiredStart);
+  const showMcpLine =
+    wantPokeTunnelFlow || childArgs.includes("--http");
+  const envWithPorts = {
+    ...childEnv(),
+    POKE_BROWSER_MCP_PORT: String(mcpPort),
+    POKE_BROWSER_WS_PORT: String(wsPort),
+  };
+
+  printQuietStartupBanner({
+    mcpPort,
+    wsPort,
+    mcpDesiredStart,
+    wsDesiredStart,
+    showMcpLine,
+  });
+
+  // Check for newer version (non-blocking)
+  (async () => {
+    try {
+      const https = await import("node:https");
+      const latest = await new Promise((resolve, reject) => {
+        const req = https.get(
+          "https://registry.npmjs.org/poke-browser/latest",
+          { timeout: 3000 },
+          (res) => {
+            let data = "";
+            res.on("data", (d) => (data += d));
+            res.on("end", () => {
+              try {
+                resolve(JSON.parse(data).version);
+              } catch {
+                reject();
+              }
+            });
+          },
+        );
+        req.on("error", reject);
+        req.on("timeout", () => {
+          req.destroy();
+          reject();
+        });
+      });
+      const current = pkg.version;
+      if (latest && latest !== current) {
+        console.log(
+          "\x1b[33m  \u26a1 Update available: v" +
+            latest +
+            " (you have v" +
+            current +
+            ")\x1b[0m",
+        );
+        console.log(
+          "\x1b[90m     npx poke-browser@latest\x1b[0m\n",
+        );
+      }
+    } catch {}
+  })();
+
+  const resolvedChildArgs = cloneArgsWithResolvedMcpPort(childArgs, mcpPort);
+
+  if (wantPokeTunnelFlow) {
+    if (!ensurePokeLoginForTunnel()) {
+      process.exit(1);
+    }
+    console.error(color.green("  Signed in to Poke \u2014 starting HTTP MCP and tunnel."));
+    console.error(
+      color.dim("  Poke can use poke-browser while this window stays open."),
+    );
+    console.error("");
+    const r = spawnSync(
+      process.execPath,
+      [
+        entry,
+        "--http",
+        String(mcpPort),
+        "--tunnel",
+        ...(customMcpName ? ["--name", customMcpName] : []),
+        ...resolvedChildArgs,
+      ],
+      { stdio: "inherit", env: envWithPorts },
+    );
+    process.exit(r.status ?? 1);
+  }
+
+  // stdio mode: Cursor / Claude Desktop (stdin is a pipe)
+  const r = spawnSync(process.execPath, [entry, ...resolvedChildArgs], {
+    stdio: "inherit",
+    env: envWithPorts,
+  });
+  process.exit(r.status ?? 1);
+})().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+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":""}

package/dist/index.js

@@ -0,0 +1,9 @@
+// All server logs MUST go to stderr - stdout is reserved for MCP JSON-RPC.
+// Each MCP tool call is logged to stderr from `registerTools()` in tools.ts.
+import { logError } from "./logger.js";
+import { main } from "./run.js";
+main().catch((err) => {
+    logError("[poke-browser-mcp] Fatal startup error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,6EAA6E;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,QAAQ,CAAC,yCAAyC,EAAE,GAAG,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * All server logs MUST go to stderr — stdout is reserved for MCP JSON-RPC over stdio.
+ * Quiet mode (default): only logError / logNotice print. Verbose: set POKE_BROWSER_VERBOSE=1
+ * (CLI --debug / --verbose).
+ */
+export declare function isVerbose(): boolean;
+/** Verbose / debug logging only (--debug / --verbose). */
+export declare function log(...args: unknown[]): void;
+/** Always printed (fatal errors, port bind failures, security rejects). */
+export declare function logError(...args: unknown[]): void;
+/** Short user-facing lines in quiet mode (e.g. tunnel URL, browser connected). */
+export declare function logNotice(...args: unknown[]): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,0DAA0D;AAC1D,wBAAgB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAG5C;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAEjD;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAElD"}

package/dist/logger.js

@@ -0,0 +1,23 @@
+/**
+ * All server logs MUST go to stderr — stdout is reserved for MCP JSON-RPC over stdio.
+ * Quiet mode (default): only logError / logNotice print. Verbose: set POKE_BROWSER_VERBOSE=1
+ * (CLI --debug / --verbose).
+ */
+export function isVerbose() {
+    return process.env.POKE_BROWSER_VERBOSE === "1";
+}
+/** Verbose / debug logging only (--debug / --verbose). */
+export function log(...args) {
+    if (!isVerbose())
+        return;
+    console.error(...args);
+}
+/** Always printed (fatal errors, port bind failures, security rejects). */
+export function logError(...args) {
+    console.error(...args);
+}
+/** Short user-facing lines in quiet mode (e.g. tunnel URL, browser connected). */
+export function logNotice(...args) {
+    console.error(...args);
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,CAAC;AAClD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,GAAG,CAAC,GAAG,IAAe;IACpC,IAAI,CAAC,SAAS,EAAE;QAAE,OAAO;IACzB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,QAAQ,CAAC,GAAG,IAAe;IACzC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,GAAG,IAAe;IAC1C,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,7 @@
+export type RunMode = "stdio" | "http" | "http-tunnel";
+export declare function parseArgs(argv: string[]): {
+    mode: RunMode;
+    mcpHttpPort: number;
+};
+export declare function main(): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAwGA,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;AAkBvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAqBA;AAuMD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAa1C"}