@tunnelbox/cursor 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# @tunnelbox/cursor
+
+tunnelbox 的 **Cursor 适配器**（独立进程，驱动 **Cursor CLI** 的 headless 模式）：手机远程驱动电脑上的 Cursor agent（会话/流式/中止/删除），复用 `@tunnelbox/core`（RelayClient/状态/二维码）。
+
+```
+手机 PWA ──WSS──► relay ──WSS──► 本适配器（电脑上常驻 Node 进程）
+                                      └─ agent -p --output-format stream-json --stream-partial-output
+```
+
+> 说明：Cursor 官方提供了 headless CLI（`agent -p`，见 https://cursor.com/docs/cli ），
+> 本适配器即其"CLI 外部驱动"桥接（仓库原列为 C 类/IDE 型，落地路径取官方 agent CLI）。
+
+## 前置条件
+
+- Node.js ≥ 22；
+- 已安装 **Cursor CLI** 并登录/配置 API key：
+  - macOS/Linux：`curl https://cursor.com/install -fsS | bash`
+  - Windows：`irm 'https://cursor.com/install?win32=true' | iex`
+  - `agent -p "hello"` 可正常输出（headless 走 Cursor 计费，需在计划内）。
+
+## 构建与运行
+
+```bash
+cd plugin && npm install            # workspaces 根（含 cursor）
+cd cursor && npm run build
+node dist/index.mjs                 # 或 npm start
+```
+
+## 配置
+
+| 环境变量 | 默认 | 说明 |
+|---|---|---|
+| `TUNNELBOX_RELAY_URL` | state 保存地址 | 中继地址 |
+| `TUNNELBOX_CWD` | `process.cwd()` | 默认工作区（agent 在该目录跑） |
+| `TUNNELBOX_CURSOR_MODE` | `agent` | `agent` / `plan` / `ask`（`--mode`） |
+| `TUNNELBOX_CURSOR_MODEL` | Cursor 默认 | `--model` |
+| `TUNNELBOX_CURSOR_FORCE` | 关 | 加 `--force`：允许直接改文件（无确认） |
+| `TUNNELBOX_CURSOR_YOLO` | 关 | 加 `--yolo`（更强放行，危险，慎用） |
+| `TUNNELBOX_CURSOR_SANDBOX` | `enabled` | `--sandbox enabled/disabled` |
+| `TUNNELBOX_CURSOR_BIN` | `agent` | Cursor CLI 可执行名/绝对路径 |
+
+```bash
+TUNNELBOX_RELAY_URL=wss://chat.example.com TUNNELBOX_CURSOR_MODE=plan TUNNELBOX_CURSOR_FORCE=1 node dist/index.mjs
+```
+
+## 能力位
+
+| 能力 | 值 | 说明 |
+|---|---|---|
+| streaming | true | stream-json：assistant 增量行（timestamp_ms）→ delta；整块行（model_call_id）→ 收尾 |
+| thinking | true | 流式推理文本（如输出 agent_reasoning）→ thinking |
+| permission | **false** | `agent -p` 无审批回调；放行由 `--force/--yolo` + `--sandbox` 决定（默认只读式沙箱） |
+| commands | true | `/new` `/help` |
+| abort | true | kill 子进程（SIGTERM → SIGKILL） |
+
+## 会话模型
+
+- 会话 = 本地镜像（`~/.config/opencode/cursor-sessions/<uuid>/`）：每个流式部件/用户消息即时落一行，供列表/历史/删除。
+- 续聊：尽力从流中采集 Cursor chat id（`meta.resumeId`）→ 后续消息用 `--resume=<id>`；采集不到则该会话每次为独立问答（连续上下文受限）。
+- 状态文件：`~/.config/opencode/remote-state.cursor.json`。
+
+## 目录结构
+
+```
+plugin/cursor/
+├── package.json / tsconfig.json
+├── scripts/build.mjs  / smoke.mjs
+└── src/
+    ├── index.ts       # env 解析 + 连接中继
+    ├── bridge.ts      # relay/配对/消息路由/回合/镜像写入
+    ├── runner.ts      # agent -p stream-json 子进程（增量解析 + tool_call + kill）
+    ├── mirror.ts      # 会话镜像存储（列表/历史/删除/meta）
+    └── globals.d.ts
+```
+
+## 备注
+
+- 未验证项（需装有 Cursor CLI 实测校正）：stream-json 行的确切字段（assistant 增量/整块、tool_call 形态、可 resume 的 chat id 出现在哪个事件）、`--force/--yolo` 与 `--sandbox` 组合的放行语义、`--mode` 参数名。解析集中在 `runner.ts`，便于按实际输出调整。
+- 安全：默认不传 `--force`（agent 不改文件、只出方案），并开 `--sandbox=enabled`；要实际改代码需显式 `TUNNELBOX_CURSOR_FORCE=1`。请勿在不受信目录启用 yolo。

package/dist/index.mjs

@@ -0,0 +1,935 @@
+// tunnelbox cursor adapter — built by scripts/build.mjs
+
+// src/index.ts
+import { resolve as resolve2 } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/bridge.ts
+import { randomBytes as randomBytes2 } from "node:crypto";
+import { existsSync as existsSync3, statSync as statSync2 } from "node:fs";
+import { hostname } from "node:os";
+import { resolve } from "node:path";
+
+// ../core/src/types.ts
+function envelope(type, payload, id) {
+  return { id, type, payload, ts: Date.now() };
+}
+
+// ../core/src/relay.ts
+var BASE_DELAY = 1e3;
+var MAX_DELAY = 15e3;
+var RelayClient = class {
+  ws = null;
+  url = "";
+  headers = {};
+  handlers = null;
+  timer = null;
+  retry = 0;
+  stopped = false;
+  connected = false;
+  get isConnected() {
+    return this.connected;
+  }
+  connect(url, headers, handlers) {
+    this.url = url;
+    this.headers = headers;
+    this.handlers = handlers;
+    this.stopped = false;
+    this.retry = 0;
+    this.open();
+  }
+  send(env) {
+    if (this.ws && this.connected) {
+      try {
+        this.ws.send(JSON.stringify(env));
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    return false;
+  }
+  close() {
+    this.stopped = true;
+    if (this.timer) clearTimeout(this.timer);
+    this.timer = null;
+    if (this.ws) {
+      try {
+        this.ws.close();
+      } catch {
+      }
+    }
+    this.ws = null;
+    this.connected = false;
+  }
+  open() {
+    if (this.stopped) return;
+    try {
+      const ws = new WebSocket(this.url, { headers: this.headers });
+      this.ws = ws;
+      ws.onopen = () => {
+        this.connected = true;
+        this.retry = 0;
+        this.handlers?.onOpen();
+      };
+      ws.onmessage = (ev) => {
+        try {
+          const msg = JSON.parse(String(ev.data));
+          this.handlers?.onMessage(msg);
+        } catch {
+        }
+      };
+      ws.onerror = (e) => this.handlers?.onError(e);
+      ws.onclose = () => {
+        this.connected = false;
+        this.ws = null;
+        this.handlers?.onClose();
+        this.scheduleReconnect();
+      };
+    } catch (e) {
+      this.handlers?.onError(e);
+      this.scheduleReconnect();
+    }
+  }
+  scheduleReconnect() {
+    if (this.stopped) return;
+    const delay = Math.min(BASE_DELAY * 2 ** this.retry, MAX_DELAY);
+    this.retry++;
+    this.timer = setTimeout(() => this.open(), delay);
+  }
+};
+
+// ../core/src/state.ts
+import { randomBytes } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+var DEFAULT_RELAY_URL = process.env.TUNNELBOX_RELAY_URL || (process.env.NODE_ENV === "production" ? "wss://chat.wxngrok.com" : "ws://127.0.0.1:8080");
+function baseName() {
+  return join(homedir(), ".config", "opencode");
+}
+function suffix(type) {
+  return type ? `.${type}` : "";
+}
+function statePath(type) {
+  return join(baseName(), `remote-state${suffix(type)}.json`);
+}
+function saveState(st, type) {
+  try {
+    const p = statePath(type);
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, JSON.stringify(st, null, 2), "utf8");
+  } catch (e) {
+    console.error("[tunnelbox] \u4FDD\u5B58\u72B6\u6001\u5931\u8D25", e);
+  }
+}
+function loadState(type) {
+  const fallback = {
+    agentId: randomBytes(16).toString("hex"),
+    relayUrl: DEFAULT_RELAY_URL
+  };
+  try {
+    if (!existsSync(statePath(type))) {
+      saveState(fallback, type);
+      return fallback;
+    }
+    const parsed = JSON.parse(readFileSync(statePath(type), "utf8"));
+    if (parsed.agentId && parsed.agentId.length >= 16) {
+      return {
+        agentId: parsed.agentId,
+        relayUrl: parsed.relayUrl || DEFAULT_RELAY_URL,
+        claimed: parsed.claimed === true
+      };
+    }
+    saveState(fallback, type);
+    return fallback;
+  } catch {
+    saveState(fallback, type);
+    return fallback;
+  }
+}
+function writePairingFile(link, code, type) {
+  const p = join(baseName(), `remote-pairing${suffix(type)}.txt`);
+  try {
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, `\u914D\u5BF9\u7801: ${code}
+\u914D\u5BF9\u94FE\u63A5: ${link}
+`, "utf8");
+  } catch {
+  }
+  return p;
+}
+function writePairingJson(info, type) {
+  const p = join(baseName(), `remote-pairing${suffix(type)}.json`);
+  try {
+    mkdirSync(dirname(p), { recursive: true });
+    writeFileSync(p, JSON.stringify(info, null, 2), "utf8");
+  } catch {
+  }
+  return p;
+}
+
+// ../core/src/qr.ts
+async function printPairing(relayHttpBase, code, type, name) {
+  const p = new URLSearchParams({ code });
+  if (type) p.set("type", type);
+  if (name) p.set("name", name);
+  const link = `${relayHttpBase}/app/#/pages/index/index?${p.toString()}`;
+  const file = writePairingFile(link, code, type);
+  const tag = type ? ` ${type}` : "";
+  console.log("");
+  console.log("\u250C\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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
+  console.log(`\u2502                tunnelbox${tag} \u624B\u673A\u914D\u5BF9               \u2502`);
+  console.log("\u251C\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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524");
+  console.log(`\u2502  \u914D\u5BF9\u7801: ${code.padEnd(42)} \u2502`);
+  console.log(`\u2502  \u94FE\u63A5  : ${link.padEnd(42)} \u2502`);
+  console.log("\u2514\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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");
+  console.log("  \u624B\u673A\u6D4F\u89C8\u5668\u6253\u5F00\u94FE\u63A5\uFF0C\u6216\u6253\u5F00 App \u540E\u624B\u52A8\u8F93\u5165\u914D\u5BF9\u7801\u3002");
+  try {
+    const mod = await import("qrcode");
+    const render = mod.default ?? mod;
+    const toString = render.toString;
+    if (toString) {
+      const qr = await toString(link, { type: "terminal", small: true });
+      if (qr) console.log(qr);
+    }
+  } catch {
+    console.log("  \uFF08\u672A\u5B89\u88C5 qrcode\uFF0C\u8BF7\u4F7F\u7528\u4E0A\u65B9\u94FE\u63A5\u6216\u914D\u5BF9\u7801\uFF09");
+  }
+  console.log(`  \u914D\u5BF9\u4FE1\u606F\u5DF2\u5199\u5165: ${file}`);
+  console.log("");
+}
+
+// src/runner.ts
+import { spawn } from "node:child_process";
+function rec(v) {
+  return v && typeof v === "object" ? v : {};
+}
+function parseLine(line) {
+  const s = line.trim();
+  if (!s) return null;
+  try {
+    return rec(JSON.parse(s));
+  } catch {
+    return null;
+  }
+}
+function toolNameAndArgs(tool) {
+  const o = rec(tool);
+  for (const key of Object.keys(o)) {
+    const sub = rec(o[key]);
+    const innerName = typeof sub.name === "string" ? sub.name : "";
+    const name = innerName || key.replace(/ToolCall$/, "").replace(/[A-Z]/g, (c) => "_" + c.toLowerCase()).replace(/^_/, "") || key;
+    const rawArgs = sub.args ?? sub.input ?? sub.parameters;
+    let args = "";
+    if (rawArgs !== void 0 && rawArgs !== null) {
+      try {
+        args = JSON.stringify(rawArgs, null, 2);
+      } catch {
+        args = String(rawArgs);
+      }
+    }
+    return { name, args };
+  }
+  return { name: "tool", args: "" };
+}
+var CursorProcess = class {
+  constructor(displaySessionID, hooks) {
+    this.displaySessionID = displaySessionID;
+    this.hooks = hooks;
+  }
+  child = null;
+  killed = false;
+  textId = null;
+  toolSeq = 0;
+  turnSeq = 0;
+  emitCount = 0;
+  tail = "";
+  exitCode = null;
+  capturedResumeId = null;
+  get resumeId() {
+    return this.capturedResumeId;
+  }
+  get produced() {
+    return this.emitCount > 0;
+  }
+  start(opts, text, resumeId) {
+    return new Promise((resolve3, reject) => {
+      let stderrBuf = "";
+      let settled = false;
+      const done = (err) => {
+        if (settled) return;
+        settled = true;
+        if (err) reject(err);
+        else resolve3();
+      };
+      const bin = opts.bin || "agent";
+      const args = ["-p", "--output-format", "stream-json", "--stream-partial-output"];
+      if (opts.model) args.push("--model", opts.model);
+      if (opts.mode && opts.mode !== "agent") args.push("--mode", opts.mode);
+      if (opts.force) args.push("--force");
+      if (opts.yolo) args.push("--yolo");
+      args.push("--sandbox", opts.sandbox || "enabled");
+      if (resumeId) args.push(`--resume=${resumeId}`);
+      args.push(text);
+      let child;
+      try {
+        child = spawn(bin, args, { cwd: opts.cwd, env: process.env, stdio: ["ignore", "pipe", "pipe"] });
+      } catch (e) {
+        done(new Error(`\u65E0\u6CD5\u542F\u52A8 Cursor CLI\uFF08agent\uFF09\uFF1A\u8BF7\u786E\u8BA4\u5DF2\u5B89\u88C5\u5E76\u767B\u5F55\uFF08${e.message}\uFF09`));
+        return;
+      }
+      this.child = child;
+      child.stdout?.setEncoding("utf8");
+      child.stdout?.on("data", (chunk) => this.onChunk(chunk));
+      child.stderr?.setEncoding("utf8");
+      child.stderr?.on("data", (chunk) => {
+        stderrBuf += chunk;
+        for (const l of chunk.split("\n")) {
+          const s = l.trim();
+          if (s && /error|login|auth|denied|key|not (found|installed)|permission/i.test(s)) {
+            this.hooks.log(`cursor: ${s.slice(0, 300)}`);
+          }
+        }
+      });
+      child.on("error", (e) => {
+        if (!this.killed) done(new Error(`Cursor CLI \u542F\u52A8\u5931\u8D25: ${e.message}`));
+      });
+      child.on("close", (code, signal) => {
+        this.exitCode = code;
+        if (this.killed || signal) {
+          done();
+          return;
+        }
+        if (code !== 0) {
+          const err = stderrBuf.trim().split("\n").pop() || `Cursor CLI \u9000\u51FA\u7801 ${code}`;
+          this.emitError(`Cursor CLI \u9000\u51FA(${code}): ${err.slice(0, 500)}`);
+        }
+        done();
+      });
+    });
+  }
+  kill() {
+    this.killed = true;
+    if (this.child && this.child.exitCode === null) {
+      try {
+        this.child.kill("SIGTERM");
+      } catch {
+      }
+      setTimeout(() => {
+        try {
+          if (this.child && this.child.exitCode === null) this.child.kill("SIGKILL");
+        } catch {
+        }
+      }, 1500);
+    }
+  }
+  buf = "";
+  onChunk(chunk) {
+    this.buf += chunk;
+    let idx;
+    while ((idx = this.buf.indexOf("\n")) >= 0) {
+      const line = this.buf.slice(0, idx);
+      this.buf = this.buf.slice(idx + 1);
+      this.onLine(line);
+    }
+  }
+  nextTextId() {
+    return `m-${Date.now()}-${++this.turnSeq}`;
+  }
+  emit(sessionID, messageID, part) {
+    this.emitCount++;
+    this.hooks.emit(sessionID, messageID, part);
+  }
+  emitError(text) {
+    this.emit(this.displaySessionID, `m-err-${Date.now()}`, { id: "err", type: "text", text: `[cursor] ${text}`, complete: true });
+    this.hooks.status(this.displaySessionID, "error");
+  }
+  /** 尽力采集可 resume 的会话标识 */
+  maybeCaptureId(o) {
+    if (this.capturedResumeId) return;
+    const candidates = [];
+    const walk = (v) => {
+      if (typeof v === "string") {
+        if (v.length >= 8 && /^[0-9a-zA-Z_-]+$/.test(v)) candidates.push(v);
+        return;
+      }
+      if (Array.isArray(v)) {
+        for (const x of v) walk(x);
+        return;
+      }
+      if (v && typeof v === "object") {
+        for (const [k, val] of Object.entries(v)) {
+          if (/(^id$|session|chat|thread|conversation)/i.test(k)) walk(val);
+        }
+      }
+    };
+    walk(o);
+    const hit = candidates.find((c) => c.length >= 8);
+    if (hit) {
+      this.capturedResumeId = hit;
+      this.hooks.onResumeId?.(hit);
+    }
+  }
+  onLine(line) {
+    const o = parseLine(line);
+    if (!o) return;
+    const type = String(o.type ?? "");
+    const subtype = typeof o.subtype === "string" ? o.subtype : "";
+    if (type === "assistant") {
+      const hasTs = Object.prototype.hasOwnProperty.call(o, "timestamp_ms");
+      const hasMc = Object.prototype.hasOwnProperty.call(o, "model_call_id");
+      const msg = rec(o.message);
+      const content = msg.content;
+      let text = "";
+      if (Array.isArray(content)) {
+        const first = rec(content[0]);
+        if (typeof first.text === "string") text = first.text;
+      } else if (typeof msg.text === "string") {
+        text = msg.text;
+      }
+      if (hasTs && !hasMc) {
+        if (text) {
+          if (!this.textId) this.textId = this.nextTextId();
+          this.emit(this.displaySessionID, this.textId, { id: "t", type: "text", delta: text, complete: false });
+        }
+        return;
+      }
+      if (hasMc) {
+        if (this.textId) {
+          this.emit(this.displaySessionID, this.textId, { id: "t", type: "text", complete: true });
+          this.textId = null;
+        }
+        return;
+      }
+      if (text) {
+        this.emit(this.displaySessionID, this.nextTextId(), { id: "t", type: "text", text, complete: true });
+      }
+      return;
+    }
+    if (type === "tool_call") {
+      const call = o.tool_call;
+      const { name, args } = toolNameAndArgs(call);
+      const key = `mt-${++this.toolSeq}`;
+      if (subtype === "started") {
+        this.emit(this.displaySessionID, key, { id: "c", type: "tool", tool: name, args: args || "{}", complete: false });
+      } else {
+        this.emit(this.displaySessionID, key, { id: "c", type: "tool", tool: name, args: args || "{}", complete: true });
+      }
+      return;
+    }
+    if (type === "result") {
+      const out = o.output ?? o.result ?? o.finalAnswer;
+      if (typeof out === "string" && out) this.tail = out;
+      return;
+    }
+    if (type === "error") {
+      const msg = o.error ?? o.message;
+      this.emitError(typeof msg === "string" ? msg : "Cursor \u51FA\u9519");
+      return;
+    }
+    this.maybeCaptureId(o);
+  }
+};
+
+// src/mirror.ts
+import {
+  existsSync as existsSync2,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync2,
+  readdirSync,
+  rmSync,
+  statSync,
+  writeFileSync as writeFileSync2
+} from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join2 } from "node:path";
+function root() {
+  return join2(homedir2(), ".config", "opencode", "cursor-sessions");
+}
+function dirOf(sessionID) {
+  return join2(root(), sessionID);
+}
+var FILE = "session.jsonl";
+var META = "meta.json";
+function readMeta(sessionID) {
+  try {
+    const p = join2(dirOf(sessionID), META);
+    if (existsSync2(p)) return JSON.parse(readFileSync2(p, "utf8"));
+  } catch {
+  }
+  return null;
+}
+function getMeta(sessionID) {
+  return readMeta(sessionID);
+}
+function writeMeta(sessionID, meta) {
+  try {
+    mkdirSync2(dirOf(sessionID), { recursive: true });
+    writeFileSync2(join2(dirOf(sessionID), META), JSON.stringify(meta, null, 2), "utf8");
+  } catch {
+  }
+}
+function newSessionId() {
+  if (typeof globalThis.crypto?.randomUUID === "function") return globalThis.crypto.randomUUID();
+  return `s-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function saveMeta(sessionID, patch) {
+  const prev = readMeta(sessionID) || { title: "\u65B0\u4F1A\u8BDD", created: Date.now(), updated: Date.now() };
+  const meta = { ...prev, ...patch, updated: Date.now() };
+  writeMeta(sessionID, meta);
+  return meta;
+}
+function appendPart(sessionID, msgId, role, part, created = Date.now()) {
+  try {
+    const d = dirOf(sessionID);
+    mkdirSync2(d, { recursive: true });
+    const line = JSON.stringify({ id: msgId, role, parts: [part], created });
+    writeFileSync2(join2(d, FILE), line + "\n", { encoding: "utf8", flag: "a" });
+    if (role === "user" && part.type === "text" && part.text) {
+      const meta = readMeta(sessionID);
+      if (!meta || meta.title === "\u65B0\u4F1A\u8BDD") {
+        const t = part.text.trim();
+        saveMeta(sessionID, { title: t.length > 30 ? `${t.slice(0, 30)}\u2026` : t });
+      }
+    }
+    saveMeta(sessionID, {});
+  } catch {
+  }
+}
+function exists(sessionID) {
+  return existsSync2(join2(dirOf(sessionID), FILE));
+}
+function walkDirs() {
+  try {
+    return readdirSync(root()).filter((n) => existsSync2(join2(root(), n, FILE)));
+  } catch {
+    return [];
+  }
+}
+async function listSessions() {
+  const out = [];
+  for (const id of walkDirs()) {
+    const meta = readMeta(id);
+    if (!meta) continue;
+    out.push({ id, title: meta.title, created: meta.created, updated: meta.updated, status: "idle", workspace: meta.cwd });
+  }
+  return out.sort((a, b) => b.updated - a.updated);
+}
+async function readHistory(sessionID) {
+  let lines;
+  try {
+    lines = readFileSync2(join2(dirOf(sessionID), FILE), "utf8").split("\n");
+  } catch {
+    return [];
+  }
+  const byId = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const line of lines) {
+    const s = line.trim();
+    if (!s) continue;
+    try {
+      const o = JSON.parse(s);
+      if (!o.id || !Array.isArray(o.parts)) continue;
+      const hit = byId.get(o.id);
+      if (hit) {
+        hit.parts.push(...o.parts);
+      } else {
+        order.push(o.id);
+        byId.set(o.id, { id: o.id, role: o.role, parts: [...o.parts], created: o.created ?? Date.now() });
+      }
+    } catch {
+    }
+  }
+  return order.map((id) => byId.get(id)).filter((m) => m.parts.length);
+}
+async function removeSession(sessionID) {
+  try {
+    rmSync(dirOf(sessionID), { recursive: true, force: true });
+  } catch {
+  }
+}
+
+// src/bridge.ts
+var VERSION = "0.1.0";
+var AGENT_TYPE = "cursor";
+var ADAPTER_COMMANDS = [
+  { name: "new", description: "\u65B0\u5EFA\u4F1A\u8BDD" },
+  { name: "help", description: "\u663E\u793A\u5E2E\u52A9" }
+];
+var CursorBridge = class {
+  constructor(cfg) {
+    this.cfg = cfg;
+    this.currentWorkspace = resolve(cfg.cwd || process.cwd());
+  }
+  ws = new RelayClient();
+  state = loadState(AGENT_TYPE);
+  claimed = !!this.state.claimed;
+  everConnected = false;
+  relayBase = "";
+  currentWorkspace;
+  pendingWorkspaces = /* @__PURE__ */ new Map();
+  sessionCwd = /* @__PURE__ */ new Map();
+  activeRuns = /* @__PURE__ */ new Map();
+  get relayHttpBase() {
+    return this.relayBase.replace(/^ws/, "http").replace(/\/+$/, "");
+  }
+  async start() {
+    const url = (this.cfg.relayUrl || this.state.relayUrl || "").replace(/\/+$/, "");
+    this.relayBase = url;
+    this.connect(url);
+  }
+  dispose() {
+    this.ws.close();
+    for (const p of this.activeRuns.values()) p.kill();
+    this.activeRuns.clear();
+  }
+  log(msg) {
+    console.log(`[tunnelbox:cursor] ${msg}`);
+  }
+  send(e) {
+    return this.ws.send(e);
+  }
+  reply(src, type, payload) {
+    const msg = envelope(type, payload, src.id);
+    msg.clientID = src.clientID;
+    this.send(msg);
+  }
+  pairingLink(code) {
+    const p = new URLSearchParams({ code, type: AGENT_TYPE, name: hostname() });
+    return `${this.relayHttpBase}/app/#/pages/index/index?${p.toString()}`;
+  }
+  connect(url) {
+    const agentID = this.state.agentId;
+    const wsUrl = `${url}/ws/agent?token=${encodeURIComponent(agentID)}`;
+    this.ws.connect(
+      wsUrl,
+      { Authorization: `Bearer ${agentID}` },
+      {
+        onOpen: () => {
+          this.everConnected = true;
+          this.log("\u5DF2\u8FDE\u63A5\u4E2D\u7EE7 " + url);
+          this.announce();
+        },
+        onMessage: (env) => {
+          void this.onMessage(env).catch((e) => this.log(`\u6D88\u606F\u5904\u7406\u672A\u6355\u83B7\u5F02\u5E38: ${e.message}`));
+        },
+        onClose: () => {
+          if (this.everConnected) {
+            this.everConnected = false;
+            this.log("\u4E0E\u4E2D\u7EE7\u65AD\u5F00\uFF0C\u6B63\u5728\u81EA\u52A8\u91CD\u8FDE\u2026");
+          }
+        },
+        onError: () => {
+        }
+      }
+    );
+  }
+  announce() {
+    const info = {
+      name: hostname(),
+      version: VERSION,
+      type: AGENT_TYPE,
+      capabilities: {
+        streaming: true,
+        thinking: true,
+        // Cursor 流式增量正文；推理如输出则进 thinking
+        permission: false,
+        // agent -p 无审批回调：放行由 --force/--yolo + --sandbox 决定
+        commands: true,
+        abort: true
+        // kill 子进程
+      },
+      platform: process.platform,
+      directory: this.currentWorkspace,
+      timezone: localTimezone()
+    };
+    this.send(envelope("agent.info", info));
+    if (!this.claimed) this.send(envelope("pair.create", {}));
+  }
+  // ---- 消息路由 ----
+  async onMessage(env) {
+    try {
+      switch (env.type) {
+        case "pair.created": {
+          const code = env.payload.code;
+          const link = this.pairingLink(code);
+          writePairingJson({ code, link, relayUrl: this.relayBase, at: Date.now() }, AGENT_TYPE);
+          this.log("\u751F\u6210\u914D\u5BF9\u7801: " + code);
+          void printPairing(this.relayHttpBase, code, AGENT_TYPE, hostname());
+          return;
+        }
+        case "agent.claimed":
+          this.claimed = true;
+          this.state.claimed = true;
+          saveState(this.state, AGENT_TYPE);
+          this.log("\u5DF2\u7ED1\u5B9A\u5230\u624B\u673A\u8D26\u53F7\uFF0C\u4E4B\u540E\u624B\u673A\u4ECE\u300C\u6211\u7684\u7535\u8111\u300D\u76F4\u63A5\u8FDE\u63A5");
+          return;
+        case "agent.revoked":
+          this.resetIdentity();
+          return;
+        case "session.list":
+          return this.sessionList(env);
+        case "session.create":
+          return this.sessionCreate(env);
+        case "session.messages":
+          return this.sessionMessages(env);
+        case "session.prompt":
+          return this.sessionPrompt(env);
+        case "session.abort":
+          return this.sessionAbort(env);
+        case "session.delete":
+          return this.sessionDelete(env);
+        case "command.list":
+          return this.commandList(env);
+        case "workspace.list":
+          return this.workspaceList(env);
+        case "workspace.set":
+          return this.workspaceSet(env);
+        case "error":
+          return;
+        default:
+          this.log("\u672A\u5904\u7406\u7684\u6D88\u606F\u7C7B\u578B: " + env.type);
+      }
+    } catch (e) {
+      this.log(`\u5904\u7406 ${env.type} \u5931\u8D25: ${e.message}`);
+      this.reply(env, "error", { code: "HANDLER_ERROR", message: e.message, id: env.id });
+    }
+  }
+  // ---- 会话 ----
+  async sessionList(env) {
+    const sessions = (await listSessions()).map((s) => ({
+      ...s,
+      status: this.activeRuns.has(s.id) ? "running" : s.status
+    }));
+    this.reply(env, "sessions", { sessions });
+  }
+  async sessionCreate(env) {
+    const payload = env.payload;
+    const workspace = payload?.workspace || this.currentWorkspace;
+    const id = newSessionId();
+    const now = Date.now();
+    saveMeta(id, { title: "\u65B0\u4F1A\u8BDD", cwd: workspace, created: now, updated: now });
+    this.pendingWorkspaces.set(id, workspace);
+    this.reply(env, "session.created", {
+      session: { id, title: "\u65B0\u4F1A\u8BDD", created: now, updated: now, status: "idle", workspace }
+    });
+  }
+  async sessionMessages(env) {
+    const { sessionID } = env.payload;
+    const messages = exists(sessionID) ? await readHistory(sessionID) : [];
+    this.reply(env, "messages", { sessionID, messages });
+  }
+  async sessionPrompt(env) {
+    const payload = env.payload;
+    const text = (payload.text || "").trim();
+    if (!text) return;
+    if (text.startsWith("/new")) return this.sessionCreate(env);
+    if (text.startsWith("/help")) {
+      this.reply(env, "message.part", {
+        sessionID: payload.sessionID,
+        messageID: `m-${Date.now()}`,
+        part: { id: "t", type: "text", text: "\u652F\u6301\u7684\u547D\u4EE4\uFF1A\n- /new \u65B0\u5EFA\u4F1A\u8BDD\n- /help \u663E\u793A\u5E2E\u52A9", complete: true }
+      });
+      return;
+    }
+    if (this.activeRuns.has(payload.sessionID)) {
+      this.reply(env, "error", { code: "BUSY", message: "\u8BE5\u4F1A\u8BDD\u6B63\u5728\u751F\u6210\u4E2D\uFF0C\u8BF7\u7B49\u5F85\u5B8C\u6210\u6216\u5148\u505C\u6B62", id: env.id });
+      return;
+    }
+    try {
+      await this.runTurn(payload.sessionID, text);
+    } catch (e) {
+      const msg = e.message || String(e);
+      this.log(`session.prompt \u5931\u8D25: ${msg}`);
+      this.reply(env, "error", { code: "PROMPT_ERROR", message: msg, id: env.id });
+    }
+  }
+  async sessionAbort(env) {
+    const { sessionID } = env.payload;
+    const p = this.activeRuns.get(sessionID);
+    if (p) {
+      p.kill();
+      this.log(`\u5DF2\u53D1\u9001\u4E2D\u6B62 (session=${sessionID})`);
+    }
+    this.send(envelope("session.status", { sessionID, status: "idle" }));
+  }
+  async sessionDelete(env) {
+    const { sessionID } = env.payload;
+    const p = this.activeRuns.get(sessionID);
+    if (p) p.kill();
+    this.activeRuns.delete(sessionID);
+    this.pendingWorkspaces.delete(sessionID);
+    this.sessionCwd.delete(sessionID);
+    await removeSession(sessionID);
+    this.reply(env, "session.deleted", { sessionID });
+  }
+  async commandList(env) {
+    this.reply(env, "commands", { commands: ADAPTER_COMMANDS });
+  }
+  // ---- 工作区（占位：仅当前目录，前端默认不显示） ----
+  async workspaceList(env) {
+    this.reply(env, "workspaces", {
+      workspaces: [{ path: this.currentWorkspace, name: this.currentWorkspace.split(/[\\/]/).pop() || this.currentWorkspace, sessionCount: 0, updated: 0 }],
+      current: this.currentWorkspace
+    });
+  }
+  async workspaceSet(env) {
+    const raw = (env.payload?.path || "").trim();
+    const path = raw ? resolve(raw) : "";
+    if (!path || !existsSync3(path) || !statSync2(path).isDirectory()) {
+      this.reply(env, "error", { code: "BAD_WORKSPACE", message: "\u8BE5\u76EE\u5F55\u4E0D\u5B58\u5728\u6216\u4E0D\u53EF\u7528", id: env.id });
+      return;
+    }
+    this.currentWorkspace = path;
+    this.log("\u5207\u6362\u5DE5\u4F5C\u533A: " + path);
+    this.announce();
+    await this.workspaceList(env);
+  }
+  // ---- 回合 ----
+  async runTurn(sessionID, text) {
+    const dir = this.pendingWorkspaces.get(sessionID) || this.sessionCwd.get(sessionID) || this.currentWorkspace;
+    if (!existsSync3(dir) || !statSync2(dir).isDirectory()) {
+      throw new Error(`\u5DE5\u4F5C\u533A\u4E0D\u5B58\u5728: ${dir}`);
+    }
+    this.pendingWorkspaces.delete(sessionID);
+    const now = Date.now();
+    appendPart(sessionID, `u-${now}`, "user", { id: "u", type: "text", text, complete: true }, now);
+    this.send(envelope("session.status", { sessionID, status: "running" }));
+    const meta = getMeta(sessionID);
+    const resumeId = meta?.resumeId || void 0;
+    const proc = new CursorProcess(sessionID, {
+      emit: (s, messageID, part) => {
+        this.send(envelope("message.part", { sessionID: s, messageID, part }));
+        appendPart(sessionID, messageID, "assistant", part);
+      },
+      status: (s, status) => this.send(envelope("session.status", { sessionID: s, status })),
+      log: (m) => this.log(m),
+      onResumeId: (id) => saveMeta(sessionID, { resumeId: id, cwd: dir })
+    });
+    this.activeRuns.set(sessionID, proc);
+    try {
+      await proc.start(
+        {
+          cwd: dir,
+          mode: this.cfg.mode,
+          model: this.cfg.model,
+          force: this.cfg.force,
+          yolo: this.cfg.yolo,
+          sandbox: this.cfg.sandbox,
+          bin: this.cfg.bin
+        },
+        text,
+        resumeId
+      );
+      if (!proc.produced && proc.tail) {
+        const id = `m-tail-${Date.now()}`;
+        this.send(envelope("message.part", { sessionID, messageID: id, part: { id: "t", type: "text", text: proc.tail, complete: true } }));
+        appendPart(sessionID, id, "assistant", { id: "t", type: "text", text: proc.tail, complete: true });
+      }
+      this.sessionCwd.set(sessionID, dir);
+      if (!getMeta(sessionID)) saveMeta(sessionID, { title: "Cursor \u4F1A\u8BDD", cwd: dir });
+    } catch (e) {
+      const msg = e.message || String(e);
+      this.log(`\u56DE\u5408\u51FA\u9519 (session=${sessionID}): ${msg}`);
+      const id = `m-err-${Date.now()}`;
+      const part = { id: "err", type: "text", text: `[cursor] ${msg}`, complete: true };
+      this.send(envelope("message.part", { sessionID, messageID: id, part }));
+      appendPart(sessionID, id, "assistant", part);
+    } finally {
+      this.activeRuns.delete(sessionID);
+      this.send(envelope("session.status", { sessionID, status: "idle" }));
+      void this.broadcastSessionUpdate(sessionID);
+    }
+  }
+  async broadcastSessionUpdate(sessionID) {
+    try {
+      if (!this.ws.isConnected) return;
+      const list = await listSessions().catch(() => []);
+      const found = list.find((s) => s.id === sessionID);
+      if (found) this.send(envelope("session.updated", { session: found }));
+    } catch {
+    }
+  }
+  resetIdentity() {
+    this.log("\u88AB\u8D26\u53F7\u89E3\u7ED1\uFF0C\u6B63\u5728\u91CD\u7F6E\u8EAB\u4EFD\u5E76\u91CD\u65B0\u751F\u6210\u914D\u5BF9\u7801\u2026");
+    this.claimed = false;
+    this.state.agentId = randomBytes2(16).toString("hex");
+    this.state.claimed = false;
+    saveState(this.state, AGENT_TYPE);
+    this.ws.close();
+    this.connect(this.relayBase);
+  }
+};
+function localTimezone() {
+  try {
+    const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    if (tz) return tz;
+  } catch {
+  }
+  return "";
+}
+
+// src/index.ts
+var MODES = /* @__PURE__ */ new Set(["agent", "plan", "ask"]);
+var SANDBOXES = /* @__PURE__ */ new Set(["enabled", "disabled"]);
+function envOn(name) {
+  return /^(1|true|yes|on)$/i.test(process.env[name] || "");
+}
+function parseMode(raw) {
+  const m = (raw || "").trim().toLowerCase();
+  if (m && !MODES.has(m)) {
+    console.warn(`[tunnelbox:cursor] \u5FFD\u7565\u65E0\u6548 TUNNELBOX_CURSOR_MODE: ${raw}\uFF08agent|plan|ask\uFF09`);
+    return void 0;
+  }
+  return m || void 0;
+}
+function parseSandbox(raw) {
+  const s = (raw || "").trim().toLowerCase();
+  if (s && SANDBOXES.has(s)) return s;
+  return "enabled";
+}
+function start(opts = {}) {
+  const cfg = {
+    relayUrl: (process.env.TUNNELBOX_RELAY_URL || opts.relayUrl || "").trim(),
+    cwd: process.env.TUNNELBOX_CWD || opts.cwd || process.cwd(),
+    mode: parseMode(process.env.TUNNELBOX_CURSOR_MODE || opts.mode),
+    model: process.env.TUNNELBOX_CURSOR_MODEL?.trim() || opts.model || void 0,
+    force: envOn("TUNNELBOX_CURSOR_FORCE") || !!opts.force,
+    yolo: envOn("TUNNELBOX_CURSOR_YOLO") || !!opts.yolo,
+    sandbox: parseSandbox(process.env.TUNNELBOX_CURSOR_SANDBOX || opts.sandbox),
+    bin: process.env.TUNNELBOX_CURSOR_BIN?.trim() || opts.bin || "agent"
+  };
+  const bridge = new CursorBridge(cfg);
+  void bridge.start().catch((e) => {
+    console.error("[tunnelbox:cursor] \u542F\u52A8\u5931\u8D25:", e);
+  });
+  let stopped = false;
+  return {
+    stop() {
+      if (stopped) return;
+      stopped = true;
+      bridge.dispose();
+    }
+  };
+}
+var isEntry = (() => {
+  try {
+    return !!process.argv[1] && resolve2(process.argv[1]) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+})();
+if (isEntry) {
+  const { stop } = start();
+  const onSignal = () => {
+    stop();
+    process.exit(0);
+  };
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  console.log("[tunnelbox:cursor] Cursor \u9002\u914D\u5668\u5DF2\u542F\u52A8\uFF08Ctrl+C \u9000\u51FA\uFF09");
+}
+export {
+  start
+};

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@tunnelbox/cursor",
+  "version": "0.1.0",
+  "description": "tunnelbox 的 Cursor 适配器（C 类/B2 头less）：手机远程驱动本机 Cursor CLI（agent -p stream-json，会话/流式/中止/删除）",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "build": "node scripts/build.mjs",
+    "start": "node dist/index.mjs",
+    "smoke": "node scripts/smoke.mjs"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "qrcode": "^1.5.3"
+  },
+  "devDependencies": {
+    "@tunnelbox/core": "0.1.0",
+    "@types/node": "^22.0.0",
+    "@types/qrcode": "^1.5.5",
+    "esbuild": "^0.24.0",
+    "typescript": "^5.4.5"
+  }
+}