@tianshu-ai/local-bridge 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# local-bridge
+
+`@tianshu-ai/local-bridge` — a lightweight local client that connects
+your machine's tools (browser, and more) into a
+[tianshu](https://github.com/tianshu-ai/tianshu) server via
+**reverse-MCP**.
+
+tianshu runs on a server. This bridge runs on **your** computer, dials
+out to the server over a WebSocket, and registers itself as an MCP
+server. The server-side agent can then drive your local tools — as if
+they were built in — but scoped to your own sessions only.
+
+```
+your machine                         tianshu server
+┌──────────────┐   outbound WSS    ┌──────────────────┐
+│ local-bridge │ ────────────────▶ │ /ws (Local Bridge │
+│  • browser   │   register tools  │   plugin)         │
+│  • echo      │ ◀──── tools/call ─│   → agent uses    │
+└──────────────┘ ──── result ─────▶ │     your tools    │
+                                    └──────────────────┘
+```
+
+## Install & run
+
+Open the **Local Bridge** panel in tianshu, copy the command it shows,
+and run it on your machine:
+
+```bash
+npx @tianshu-ai/local-bridge --server wss://your-tianshu.example.com/ws --token ***
+```
+
+For a local dev server with auth off, the token is optional:
+
+```bash
+npx @tianshu-ai/local-bridge --server ws://localhost:3110/ws
+```
+
+### Flags
+
+| flag | meaning |
+|---|---|
+| `--server <url>` | tianshu chat WS endpoint (required), e.g. `wss://host/ws` |
+| `--token <token>` | connection token from the Local Bridge panel |
+| `--device <id>` | stable device id (default: hostname) |
+| `--label <name>` | human label shown in the panel |
+| `--no-browser` | expose only the connectivity `echo` tool |
+| `--headless` | run the browser without a window (default: headful) |
+| `--cdp <url>` | connect to an already-running Chrome's CDP endpoint (default probe `http://127.0.0.1:9222`; `off` to skip) |
+| `--chrome-channel <ch>` | which installed browser to launch: `chrome` (default), `msedge`, … |
+| `--user-data-dir <dir>` | reuse a Chrome profile dir so logins carry over |
+
+**No Chromium download.** The bridge uses *your* Chrome:
+
+1. If a Chrome is already running with `--remote-debugging-port=9222`,
+   it connects to that (your real browser — real cookies + session).
+2. Otherwise it launches your system-installed Google Chrome via
+   Playwright's `channel: "chrome"`. Pass `--user-data-dir` to reuse
+   your logged-in profile.
+
+To expose your everyday browser, start Chrome with a debugging port:
+
+```bash
+# macOS
+"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222
+```
+
+## Tools
+
+- `echo` — connectivity check.
+- `browser_navigate` / `browser_get_text` / `browser_click` /
+  `browser_screenshot` — drive your real local Chrome (via CDP connect
+  or system-Chrome launch; automation-detection softened).
+
+## Protocol
+
+The bridge speaks the reverse-MCP protocol defined authoritatively in the
+server repo: `plugins/reverse-mcp/PROTOCOL.md`. It's a thin envelope
+around standard MCP JSON-RPC over the authenticated chat WebSocket. This
+client imports no tianshu package.
+
+## Develop
+
+```bash
+npm install
+npm run build
+node dist/index.js --server ws://localhost:3110/ws --no-browser
+```
+
+Repo: <https://github.com/tianshu-ai/local-bridge>
+
+Apache-2.0.

package/dist/browser.js

@@ -0,0 +1,160 @@
+// Local browser tools, driven by Playwright against the user's OWN
+// Chrome — never a bundled/downloaded Chromium.
+//
+// Acquisition strategy (best → fallback), so we reuse the real browser
+// with its real fingerprint + logged-in cookies and avoid a heavy
+// download:
+//
+//   1. CONNECT over CDP to a Chrome the user already has running with
+//      `--remote-debugging-port` (default probe: http://127.0.0.1:9222).
+//      This is the user's actual browser — real profile, real session.
+//   2. LAUNCH the system-installed Google Chrome via Playwright's
+//      `channel: "chrome"` (no Chromium download). Optionally reuse the
+//      user's profile via `userDataDir` so logins carry over. Launched
+//      with automation-detection softened.
+//
+// Nothing here downloads a browser; if neither path works the tool
+// returns a clear, actionable error.
+import { textResult } from "./protocol.js";
+// Args that soften automation detection (navigator.webdriver etc.).
+const STEALTH_ARGS = [
+    "--disable-blink-features=AutomationControlled",
+    "--no-default-browser-check",
+    "--no-first-run",
+];
+async function probeCdp(cdpUrl) {
+    if (!cdpUrl)
+        return false;
+    try {
+        const base = cdpUrl.replace(/\/$/, "");
+        const res = await fetch(`${base}/json/version`, {
+            signal: AbortSignal.timeout(2500),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/** Acquire a Page, connecting to the user's Chrome or launching the
+ *  system Chrome. Cached after first success. */
+async function ensurePage(state, cfg) {
+    if (state.page && !state.page.isClosed())
+        return state.page;
+    const { chromium } = await import("playwright");
+    // 1) Connect to an already-running Chrome over CDP.
+    if (!state.browser && !state.context && (await probeCdp(cfg.cdpUrl))) {
+        try {
+            const browser = await chromium.connectOverCDP(cfg.cdpUrl);
+            state.browser = browser;
+            const ctx = browser.contexts()[0] ?? (await browser.newContext());
+            state.context = ctx;
+            state.page = ctx.pages()[0] ?? (await ctx.newPage());
+            state.how = `connected to your running Chrome at ${cfg.cdpUrl}`;
+            cfg.log(state.how);
+            return state.page;
+        }
+        catch (err) {
+            cfg.log(`CDP connect failed (${err instanceof Error ? err.message : String(err)}); falling back to launch`);
+        }
+    }
+    // 2) Launch the system-installed Chrome (no Chromium download).
+    if (cfg.userDataDir) {
+        // Persistent context reuses the user's profile → logged-in sessions.
+        const ctx = await chromium.launchPersistentContext(cfg.userDataDir, {
+            channel: cfg.channel,
+            headless: !cfg.headful,
+            args: STEALTH_ARGS,
+        });
+        state.context = ctx;
+        state.page = ctx.pages()[0] ?? (await ctx.newPage());
+        state.how = `launched system ${cfg.channel} with your profile (${cfg.userDataDir})`;
+    }
+    else {
+        const browser = await chromium.launch({
+            channel: cfg.channel,
+            headless: !cfg.headful,
+            args: STEALTH_ARGS,
+        });
+        state.browser = browser;
+        state.context = await browser.newContext();
+        state.page = await state.context.newPage();
+        state.how = `launched system ${cfg.channel} (ephemeral profile)`;
+    }
+    cfg.log(state.how);
+    return state.page;
+}
+export function makeBrowserTools(cfg) {
+    const state = { browser: null, context: null, page: null, how: "" };
+    const navigate = {
+        descriptor: {
+            name: "browser_navigate",
+            description: "Open a URL in the user's local browser and return the page title. Uses their real Chrome (real cookies/session).",
+            inputSchema: {
+                type: "object",
+                properties: { url: { type: "string", description: "Absolute http(s) URL to open." } },
+                required: ["url"],
+            },
+        },
+        async run(args) {
+            const url = String(args.url ?? "");
+            if (!/^https?:\/\//i.test(url))
+                return textResult("url must be an absolute http(s) URL", true);
+            const page = await ensurePage(state, cfg);
+            await page.goto(url, { waitUntil: "domcontentloaded", timeout: 45_000 });
+            const title = await page.title();
+            return textResult(`Navigated to ${page.url()}\nTitle: ${title}\n(${state.how})`);
+        },
+    };
+    const getText = {
+        descriptor: {
+            name: "browser_get_text",
+            description: "Return the visible text of the current page (optionally a CSS selector).",
+            inputSchema: {
+                type: "object",
+                properties: { selector: { type: "string", description: "Optional CSS selector; defaults to <body>." } },
+            },
+        },
+        async run(args) {
+            if (!state.page || state.page.isClosed())
+                return textResult("no page open — call browser_navigate first", true);
+            const selector = typeof args.selector === "string" && args.selector ? args.selector : "body";
+            const text = await state.page.locator(selector).first().innerText({ timeout: 15_000 }).catch(() => "");
+            return textResult(text.slice(0, 8000) || "(no text found)");
+        },
+    };
+    const click = {
+        descriptor: {
+            name: "browser_click",
+            description: "Click the first element matching a CSS selector on the current page.",
+            inputSchema: {
+                type: "object",
+                properties: { selector: { type: "string" } },
+                required: ["selector"],
+            },
+        },
+        async run(args) {
+            if (!state.page || state.page.isClosed())
+                return textResult("no page open — call browser_navigate first", true);
+            const selector = String(args.selector ?? "");
+            await state.page.locator(selector).first().click({ timeout: 15_000 });
+            return textResult(`clicked ${selector}\nNow at: ${state.page.url()}`);
+        },
+    };
+    const screenshot = {
+        descriptor: {
+            name: "browser_screenshot",
+            description: "Capture a screenshot of the current page (saved on the bridge host).",
+            inputSchema: { type: "object", properties: {} },
+        },
+        async run() {
+            if (!state.page || state.page.isClosed())
+                return textResult("no page open — call browser_navigate first", true);
+            const path = `/tmp/tianshu-local-bridge-shot-${Date.now()}.png`;
+            await state.page.screenshot({ path, fullPage: false });
+            return textResult(`screenshot saved on the bridge host at ${path}`);
+        },
+    };
+    return [navigate, getText, click, screenshot];
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/connection.js

@@ -0,0 +1,128 @@
+// WebSocket dial-in to a tianshu server + reverse-MCP request handling.
+//
+// The bridge connects OUTBOUND (works behind NAT/firewall), authenticates
+// with a Bearer token, registers its tools, then serves tools/call
+// requests the server sends. Auto-reconnects with backoff.
+import WebSocket from "ws";
+import { MSG, textResult } from "./protocol.js";
+const RECONNECT_BASE_MS = 1000;
+const RECONNECT_MAX_MS = 30_000;
+export class BridgeConnection {
+    opts;
+    ws = null;
+    closed = false;
+    attempt = 0;
+    toolsByName = new Map();
+    log;
+    constructor(opts) {
+        this.opts = opts;
+        this.log = opts.log ?? ((m) => console.log(m));
+        for (const t of opts.tools)
+            this.toolsByName.set(t.descriptor.name, t);
+    }
+    start() {
+        this.closed = false;
+        this.connect();
+    }
+    stop() {
+        this.closed = true;
+        try {
+            this.ws?.send(JSON.stringify({ type: MSG.unregister }));
+        }
+        catch {
+            /* ignore */
+        }
+        this.ws?.close();
+        this.ws = null;
+    }
+    connect() {
+        const headers = {};
+        if (this.opts.token)
+            headers.Authorization = `Bearer ${this.opts.token}`;
+        const ws = new WebSocket(this.opts.server, { headers });
+        this.ws = ws;
+        ws.on("open", () => {
+            this.attempt = 0;
+            this.log(`connected to ${this.opts.server}`);
+            const reg = {
+                type: MSG.register,
+                deviceId: this.opts.deviceId,
+                label: this.opts.label,
+                tools: this.opts.tools.map((t) => t.descriptor),
+            };
+            ws.send(JSON.stringify(reg));
+        });
+        ws.on("message", (raw) => {
+            let msg;
+            try {
+                msg = JSON.parse(raw.toString());
+            }
+            catch {
+                return;
+            }
+            switch (msg.type) {
+                case MSG.registered:
+                    if (msg.ok) {
+                        this.log(`registered device "${this.opts.deviceId}" (${this.toolsByName.size} tools)`);
+                    }
+                    else {
+                        this.log(`register rejected: ${msg.error ?? "unknown"}`);
+                    }
+                    break;
+                case MSG.request:
+                    void this.handleRequest(msg);
+                    break;
+                default:
+                    // Ignore other chat-channel traffic on the shared /ws.
+                    break;
+            }
+        });
+        ws.on("close", () => {
+            this.ws = null;
+            if (this.closed)
+                return;
+            const delay = Math.min(RECONNECT_BASE_MS * 2 ** this.attempt, RECONNECT_MAX_MS);
+            this.attempt++;
+            this.log(`disconnected; reconnecting in ${Math.round(delay / 1000)}s`);
+            setTimeout(() => {
+                if (!this.closed)
+                    this.connect();
+            }, delay);
+        });
+        ws.on("error", (err) => {
+            this.log(`socket error: ${err instanceof Error ? err.message : String(err)}`);
+        });
+    }
+    send(msg) {
+        try {
+            this.ws?.send(JSON.stringify(msg));
+        }
+        catch (err) {
+            this.log(`failed to send response: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    async handleRequest(req) {
+        if (req.method !== "tools/call") {
+            this.send({ type: MSG.response, id: req.id, error: { code: -32601, message: `unsupported method: ${req.method}` } });
+            return;
+        }
+        const params = (req.params ?? {});
+        const tool = params.name ? this.toolsByName.get(params.name) : undefined;
+        if (!tool) {
+            this.send({ type: MSG.response, id: req.id, error: { code: -32602, message: `unknown tool: ${params.name}` } });
+            return;
+        }
+        try {
+            const result = await tool.run(params.arguments ?? {});
+            this.send({ type: MSG.response, id: req.id, result });
+        }
+        catch (err) {
+            this.send({
+                type: MSG.response,
+                id: req.id,
+                result: textResult(`tool "${params.name}" failed: ${err instanceof Error ? err.message : String(err)}`, true),
+            });
+        }
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,0EAA0E;AAC1E,mEAAmE;AACnE,2DAA2D;AAE3D,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EAAE,GAAG,EAAE,UAAU,EAAuE,MAAM,eAAe,CAAC;AAWrH,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,MAAM,OAAO,gBAAgB;IAOE;IANrB,EAAE,GAAqB,IAAI,CAAC;IAC5B,MAAM,GAAG,KAAK,CAAC;IACf,OAAO,GAAG,CAAC,CAAC;IACH,WAAW,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC3C,GAAG,CAAsB;IAE1C,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;QAC9C,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QACD,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACjB,CAAC;IAEO,OAAO;QACb,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACzE,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QAEb,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7C,MAAM,GAAG,GAAgB;gBACvB,IAAI,EAAE,GAAG,CAAC,QAAQ;gBAClB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAC5B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;gBACtB,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;aAChD,CAAC;YACF,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,IAAI,GAAgD,CAAC;YACrD,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YACD,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,GAAG,CAAC,UAAU;oBACjB,IAAK,GAAwB,CAAC,EAAE,EAAE,CAAC;wBACjC,IAAI,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,CAAC;oBACzF,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,GAAG,CAAC,sBAAuB,GAA0B,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC;oBACnF,CAAC;oBACD,MAAM;gBACR,KAAK,GAAG,CAAC,OAAO;oBACd,KAAK,IAAI,CAAC,aAAa,CAAC,GAA4B,CAAC,CAAC;oBACtD,MAAM;gBACR;oBACE,uDAAuD;oBACvD,MAAM;YACV,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAClB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;YACf,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO;YACxB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YAChF,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,iCAAiC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACvE,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,CAAC,IAAI,CAAC,MAAM;oBAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACrB,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,IAAI,CAAC,GAAgB;QAC3B,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAe;QACzC,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,uBAAuB,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YACrH,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAA2D,CAAC;QAC5F,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,iBAAiB,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAChH,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,GAAG,CAAC,QAAQ;gBAClB,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,MAAM,EAAE,UAAU,CAAC,SAAS,MAAM,CAAC,IAAI,aAAa,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC;aAC9G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/index.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+// @tianshu-ai/local-bridge — dial into a tianshu server and expose local
+// tools (browser, …) to the agent via reverse-MCP.
+//
+// Usage:
+//   npx @tianshu-ai/local-bridge --server wss://tianshu.example.com/ws --token ***
+//   npx @tianshu-ai/local-bridge --server ws://localhost:3110/ws       (dev, no auth)
+//
+// Flags:
+//   --server <url>     tianshu chat WS endpoint (required)
+//   --token <token>    connection token from the Local Bridge panel
+//   --device <id>      stable device id (default: hostname)
+//   --label <name>     human label shown in the panel (default: device id)
+//   --no-browser       don't expose browser tools (echo only)
+//   --headless         run the browser without a window (default: headful)
+//   --cdp <url>        connect to an already-running Chrome's CDP endpoint
+//                      (default probe: http://127.0.0.1:9222). Set to "off"
+//                      to skip and always launch.
+//   --chrome-channel   which installed browser to launch: chrome (default),
+//                      msedge, chrome-beta, … (never downloads Chromium)
+//   --user-data-dir    reuse a Chrome profile dir so logins carry over
+import os from "node:os";
+import { BridgeConnection } from "./connection.js";
+import { makeBrowserTools } from "./browser.js";
+import { textResult } from "./protocol.js";
+function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (!a.startsWith("--"))
+            continue;
+        const key = a.slice(2);
+        const next = argv[i + 1];
+        if (next && !next.startsWith("--")) {
+            out[key] = next;
+            i++;
+        }
+        else {
+            out[key] = true;
+        }
+    }
+    return out;
+}
+function main() {
+    const args = parseArgs(process.argv.slice(2));
+    const server = typeof args.server === "string" ? args.server : "";
+    if (!server) {
+        console.error("error: --server <wss://host/ws> is required");
+        console.error("example: npx @tianshu-ai/local-bridge --server wss://tianshu.example.com/ws --token ***");
+        process.exit(2);
+    }
+    const token = typeof args.token === "string" ? args.token : undefined;
+    const deviceId = (typeof args.device === "string" && args.device) || os.hostname() || "bridge";
+    const label = typeof args.label === "string" ? args.label : deviceId;
+    // Default headful: a real browser window the user can watch. --headless to hide.
+    const headful = args.headless !== true;
+    const cdpArg = typeof args.cdp === "string" ? args.cdp : "http://127.0.0.1:9222";
+    const cdpUrl = cdpArg === "off" ? "" : cdpArg;
+    const channel = typeof args["chrome-channel"] === "string" ? args["chrome-channel"] : "chrome";
+    const userDataDir = typeof args["user-data-dir"] === "string" ? args["user-data-dir"] : "";
+    // Always ship a trivial echo tool so the round-trip can be verified
+    // without a browser install.
+    const echo = {
+        descriptor: {
+            name: "echo",
+            description: "Echo the given text back (bridge connectivity check).",
+            inputSchema: { type: "object", properties: { text: { type: "string" } }, required: ["text"] },
+        },
+        async run(a) {
+            return textResult(String(a.text ?? ""));
+        },
+    };
+    const browserOn = args["no-browser"] !== true;
+    const tools = [echo];
+    if (browserOn) {
+        tools.push(...makeBrowserTools({
+            cdpUrl,
+            channel,
+            userDataDir,
+            headful,
+            log: (m) => console.log(`[local-bridge] ${m}`),
+        }));
+    }
+    const conn = new BridgeConnection({
+        server,
+        token,
+        deviceId,
+        label,
+        tools,
+        log: (m) => console.log(`[local-bridge] ${m}`),
+    });
+    console.log(`[local-bridge] starting — device="${deviceId}", ${tools.length} tools, ` +
+        `browser=${browserOn ? (cdpUrl ? `connect(${cdpUrl}) or ${channel}` : channel) : "off"}`);
+    conn.start();
+    const shutdown = () => {
+        console.log("\n[local-bridge] shutting down…");
+        conn.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/protocol.js

@@ -0,0 +1,15 @@
+// Reverse-MCP wire protocol (client side). Mirrors the authoritative
+// contract in the tianshu server's plugins/reverse-mcp/PROTOCOL.md. We
+// deliberately do NOT import any tianshu package — the bridge stays a
+// standalone client that speaks the protocol.
+export const MSG = {
+    register: "reverse_mcp_register",
+    unregister: "reverse_mcp_unregister",
+    response: "reverse_mcp_response",
+    request: "reverse_mcp_request",
+    registered: "reverse_mcp_registered",
+};
+export function textResult(text, isError = false) {
+    return { content: [{ type: "text", text }], isError };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,uEAAuE;AACvE,sEAAsE;AACtE,8CAA8C;AAE9C,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE,sBAAsB;IAChC,UAAU,EAAE,wBAAwB;IACpC,QAAQ,EAAE,sBAAsB;IAChC,OAAO,EAAE,qBAAqB;IAC9B,UAAU,EAAE,wBAAwB;CAC5B,CAAC;AAqBX,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IACtD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@tianshu-ai/local-bridge",
+  "version": "0.1.0",
+  "description": "Local bridge for tianshu — dial into a tianshu server over WebSocket and expose your machine's tools (browser, files, shell) to the agent via reverse-MCP.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "tianshu-local-bridge": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch --preserveWatchOutput",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "playwright": "^1.56.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@types/ws": "^8.5.12",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}