@xyagent/cli 0.0.1 → 1.1.0

package/src-ext/runtime/picoclaw/index.mjs

@@ -1,314 +0,0 @@
-// 巴布(PicoClaw)桥接入口 — daemon 主循环。
-//
-// 与 hermes/claude/codex 的差异:
-//   - 配对流程不是 `agentlink pair <code>` 由用户在 cli 输入,而是 daemon 启动后
-//     自动调 server `/v1/pair-codes/picoclaw/create` 拿 QR PNG → 写到本地约定路径
-//     由屏幕显示模块独立读取 → App 扫码 → server consume → cli 通过 fetch_token
-//     poll status 拿到 bridge_token。全程零命令行交互。
-//
-//   - 与本地的 PicoClaw daemon (默认 ws://127.0.0.1:18790/pico/ws) 建立 WebSocket
-//     连接,把用户消息翻译为 message.send 发出去;接收 message.create / .update
-//     翻译成 OpenClaw 风格 native event 透传给服务端 long-poll 通道。
-//
-//   - daemon 主循环:
-//       1. readState() 拿 bridge_token
-//       2. 没有 → pair flow → writeState
-//       3. 有 → 启 worker(long-poll + WS),失败/被撤销时 clearState 回到 1
-//
-// 使用入口: `agentlink-agent picoclaw`
-
-import process from "node:process";
-
-import { createLogger } from "../../../src-shared/logger.mjs";
-import { newCid } from "../../../src-shared/correlation.mjs";
-import { createSessionSlot, SESSION_STATES } from "../../core/sessionSlot.mjs";
-import { createRelayWorker } from "../../core/relayWorker.mjs";
-import { installAutoTunnel } from "../../core/autoTunnelWiring.mjs";
-import { createUsageReporter } from "../../core/usageReporter.mjs";
-import { resolveRelayUrl } from "../../core/pairCodeClient.mjs";
-
-import {
-  PAIR_STATUS_POLL_INTERVAL_SEC,
-  PAIR_STATUS_POLL_MAX_SEC,
-  RUNTIME_NAME,
-  WS_RECONNECT_INITIAL_MS,
-  WS_RECONNECT_MAX_MS,
-} from "./constants.mjs";
-import { readState, writeState, clearState } from "./state.mjs";
-import {
-  createPairCode,
-  pollPairStatus,
-  writeQRImage,
-  clearQRImage,
-  writeDevPairInfo,
-  clearDevPairInfo,
-} from "./pairFlow.mjs";
-import { connect as wsConnect } from "./wsClient.mjs";
-import { translatePicoMessage } from "./translator.mjs";
-import { createPicoHandleRequest } from "./handleRequest.mjs";
-import { createPicoTodoTranslator } from "./todoTranslator.mjs";
-
-export async function runPicoclawBridge({ options, positional, log }) {
-  const relayBase = resolveRelayUrl(options.relay);
-  const log0 = log || createLogger({ comp: "bridge", cid: newCid() }).child({ rt: RUNTIME_NAME });
-  log0.info("bridge.preflight.pass", "picoclaw daemon entering main loop", { relay: relayBase });
-
-  let shuttingDown = false;
-  process.once("SIGINT", () => { shuttingDown = true; });
-  process.once("SIGTERM", () => { shuttingDown = true; });
-
-  // daemon 主循环 — 每次循环代表一次"配对 + 长轮询"周期。
-  // 解绑或鉴权失效会导致内层 worker 退出并清 state,主循环回到 0 重新生成 QR。
-  while (!shuttingDown) {
-    let st = readState();
-    if (!st) {
-      // 没绑定 → 走 pair flow
-      try {
-        st = await runPairFlow({ relayBase, options, log: log0 });
-      } catch (err) {
-        log0.warn("picoclaw.pair.failed", "pair flow failed; retry in 5s", { err: String(err?.message || err) });
-        await sleep(5000);
-        continue;
-      }
-      writeState(st);
-      log0.info("picoclaw.pair.persisted", "bridge_token saved, entering worker", { gw_id: st.gw_id });
-    }
-    // 启 worker — 内部异常或 token 撤销返回 reason
-    let exitReason;
-    try {
-      exitReason = await runWorkerWithBridge({ state: st, log: log0 });
-    } catch (err) {
-      log0.error("picoclaw.worker.fatal", "worker fatal", { err: String(err?.message || err) });
-      exitReason = "fatal";
-    }
-    log0.info("picoclaw.worker.exited", "worker exited", { reason: exitReason });
-    if (exitReason === "revoked" || exitReason === "auth-failed") {
-      clearState();
-      log0.info("picoclaw.state.cleared", "bridge_token revoked; back to pair loop");
-      continue;
-    }
-    if (shuttingDown) break;
-    // 网络抖动等 — 不清 state,直接重启 worker
-    await sleep(2000);
-  }
-  log0.info("bridge.shutdown", "picoclaw daemon exiting");
-}
-
-// ── pair flow ────────────────────────────────────────────────────
-
-async function runPairFlow({ relayBase, options, log }) {
-  // 1. 调 server 创建 pair-code
-  const created = await createPairCode({
-    relayUrl: relayBase,
-    label: options.label,
-    deviceId: options.deviceId || process.env.PICOCLAW_DEVICE_ID || "",
-    fetchImpl: globalThis.fetch,
-    log,
-  });
-  // 2. 写 QR PNG 到约定路径(屏幕模块读)
-  const qrPath = writeQRImage(created.qr_png_base64, options.qrPath);
-  log.info("picoclaw.pair.qr.written", "qr image written", { path: qrPath, code: created.code });
-  // 2.5 dev 测试钩子:把 code + fetch_token + relay + 完整 deeplink 写到本地,
-  //      让 e2e 测试脚本 / iOS 模拟器粘贴测试扮演 App 角色用。
-  //      (仅当 BUBU_DEV_DUMP_PAIR_INFO=1 时生效;生产环境严禁开启)
-  const devPath = writeDevPairInfo({
-    code: created.code,
-    fetch_token: created.fetch_token,
-    relay: relayBase,
-    label: options.label,
-    expires_at: created.expires_at,
-    qr_payload: created.qr_payload, // 完整 deeplink,粘贴到 App 输入框直接绑定
-  });
-  if (devPath) {
-    log.info("picoclaw.pair.devinfo.written", "dev pair-info written for test", { path: devPath });
-  }
-  // 3. poll status
-  try {
-    const result = await pollPairStatus({
-      relayUrl: relayBase,
-      code: created.code,
-      fetchToken: created.fetch_token,
-      intervalSec: created.poll_interval_seconds || PAIR_STATUS_POLL_INTERVAL_SEC,
-      maxSec: PAIR_STATUS_POLL_MAX_SEC,
-      log,
-    });
-    // 4. 配对成功 — 清 QR 图(屏幕切换为已绑定画面;具体显示模块自己处理)
-    clearQRImage(options.qrPath);
-    clearDevPairInfo();
-    return {
-      gw_id: result.gw_id,
-      bridge_token: result.bridge_token,
-      relay_url: relayBase,
-      client_user_id: result.client_user_id,
-      label: result.label,
-    };
-  } catch (err) {
-    clearQRImage(options.qrPath);
-    clearDevPairInfo();
-    throw err;
-  }
-}
-
-// ── worker(long-poll + WS) ─────────────────────────────────────
-
-async function runWorkerWithBridge({ state, log }) {
-  const sessLog = log.child({ gw: state.gw_id });
-  const worker = createRelayWorker({
-    relayUrl: state.relay_url,
-    gwId: state.gw_id,
-    bridgeToken: state.bridge_token,
-    runtime: RUNTIME_NAME,
-    log: sessLog,
-  });
-  installAutoTunnel({ relayUrl: state.relay_url, log: sessLog });
-
-  // ── PicoClaw WS — 自带重连 ──
-  const wsHolder = createReconnectingWS({ log: sessLog });
-
-  // 当前 in-flight turn 的 ctx — handleRequest 期间唯一非空
-  const activeTurnRef = { current: null };
-  const slot = createSessionSlot({ log: sessLog, name: RUNTIME_NAME });
-  slot.transition(SESSION_STATES.READY, "picoclaw-no-spawn");
-
-  const usage = createUsageReporter({
-    runtime: RUNTIME_NAME,
-    log: sessLog,
-    publishEvent: (event) => {
-      if (!activeTurnRef.current) return Promise.resolve(false);
-      return worker.publishEvent(activeTurnRef.current.ctx.requestId, event);
-    },
-  });
-
-  // 连 WS
-  try {
-    await wsHolder.connectOnce();
-  } catch (err) {
-    sessLog.warn("picoclaw.ws.first_connect.err", "initial ws connect failed", { err: String(err?.message || err) });
-    // 不致命 — handleRequest 时会再触发重连。
-  }
-
-  // todo translator（ws 路径）：拦截 update_plan，阻止透传原始 tool_call 事件
-  // ws 路径不走 envelope 系统，所以只做拦截（不发 todo_list block）
-  const wsTodoTranslator = createPicoTodoTranslator("ws_path");
-
-  // 把 ws 收到的消息分发给当前 turn
-  wsHolder.onMessage((picoMsg) => {
-    const activeTurn = activeTurnRef.current;
-    if (!activeTurn) {
-      sessLog.warn("picoclaw.ws.msg.no_turn", "received pico message but no active turn", { type: picoMsg?.type });
-      return;
-    }
-    // todo translator 拦截：update_plan 消息不透传（阻止 function_call_arguments.delta chunk）
-    const intercepted = wsTodoTranslator.intercept(picoMsg);
-    if (intercepted.length > 0 && intercepted[0] !== picoMsg) {
-      // 拦截到 update_plan，静默丢弃（ws 路径无 envelope 能力）
-      return;
-    }
-    const events = translatePicoMessage(picoMsg, activeTurn.translatorState);
-    if (!events.length) return;
-    void publishEvents(activeTurn, events).catch((err) => {
-      sessLog.warn("picoclaw.publish.err", "publish failed", { err: String(err?.message || err) });
-    });
-    if (activeTurn.translatorState.finalized) {
-      const turn = activeTurnRef.current;
-      activeTurnRef.current = null;
-      turn.resolve(); // wake the awaiting handleRequest
-    }
-  });
-
-  // ── handleRequest: dispatch 走 unifiedHandler，普通请求走原有 ws 路径 ──
-  const handleRequest = createPicoHandleRequest({
-    wsHolder,
-    log: sessLog,
-    activeTurnRef,
-    dispatchHandlerOptions: {
-      relayUrl: state.relay_url,
-      bridgeToken: state.bridge_token,
-    },
-  });
-
-  // Wrap to add usage tracking for non-dispatch turns.
-  const handleRequestWithUsage = async (request, ctx) => {
-    const turnStartedAt = Date.now();
-    await handleRequest(request, ctx);
-    usage.addCost({ turns: 1, duration_ms: Date.now() - turnStartedAt });
-    usage.schedulePublish("picoclaw.turn_end");
-  };
-
-  // 启 long-poll 循环。worker.run() 在 401/410 时会抛带特征的错误。
-  let exitReason = "loop-exit";
-  try {
-    await worker.run(handleRequestWithUsage);
-  } catch (err) {
-    const msg = String(err?.message || err);
-    if (/401|403|410|revoked|unauthorized/i.test(msg)) {
-      exitReason = "revoked";
-    } else {
-      exitReason = "fatal";
-      sessLog.error("picoclaw.worker.err", "worker errored", { err: msg });
-    }
-  } finally {
-    try { wsHolder.close("worker-exit"); } catch {}
-    try { usage.dispose(); } catch {}
-  }
-  return exitReason;
-}
-
-// ── helpers ──────────────────────────────────────────────────────
-
-async function publishEvents({ ctx }, events) {
-  for (const e of events) {
-    if (!e) continue;
-    await ctx.publishEvent(e);
-  }
-}
-
-function createReconnectingWS({ log }) {
-  let conn = null;
-  const messageHandlers = new Set();
-  let backoff = WS_RECONNECT_INITIAL_MS;
-
-  async function connectOnce() {
-    if (conn && conn.readyState === 1) return conn;
-    conn = await wsConnect({ log });
-    backoff = WS_RECONNECT_INITIAL_MS;
-    conn.onMessage((m) => {
-      for (const h of messageHandlers) {
-        try { h(m); } catch (err) {
-          log.warn("picoclaw.ws.handler.err", "handler threw", { err: String(err?.message || err) });
-        }
-      }
-    });
-    conn.onClose(() => {
-      conn = null;
-      // 异步重连,不阻塞 ws.onClose 回调
-      setTimeout(() => {
-        connectOnce().catch((err) => {
-          log.warn("picoclaw.ws.reconnect.err", "reconnect failed", { err: String(err?.message || err) });
-          backoff = Math.min(backoff * 2, WS_RECONNECT_MAX_MS);
-        });
-      }, backoff);
-    });
-    return conn;
-  }
-
-  return {
-    connectOnce,
-    isOpen() { return conn && conn.readyState === 1; },
-    send(msg) {
-      if (!conn || conn.readyState !== 1) {
-        throw new Error("picoclaw ws not open");
-      }
-      conn.send(msg);
-    },
-    onMessage(fn) { messageHandlers.add(fn); return () => messageHandlers.delete(fn); },
-    close(reason) {
-      try { conn?.close(reason); } catch {}
-      conn = null;
-    },
-  };
-}
-
-function sleep(ms) {
-  return new Promise((r) => setTimeout(r, ms));
-}

package/src-ext/runtime/picoclaw/pairFlow.mjs

@@ -1,224 +0,0 @@
-// 巴布配对流程。
-//
-// 步骤(daemon 主循环未持有 token 时执行):
-//
-//   1. POST <relay>/v1/pair-codes/picoclaw/create
-//      Body: { label, ttl_seconds, device_id }
-//      Resp: { code, qr_payload, qr_png_base64, fetch_token, expires_at, poll_interval_seconds }
-//
-//   2. 把 qr_png_base64 解码写到 QR_PNG_OUTPUT_PATH(通常 /tmp/bubu/pair-qr.png)。
-//      巴布开发板的屏幕显示模块独立读取这个文件,在屏幕上展示 QR。
-//
-//   3. 每 poll_interval_seconds 调一次:
-//      GET <relay>/v1/pair-codes/picoclaw/<code>/status
-//      Header: X-Pair-Fetch-Token: <fetch_token>
-//      Resp:
-//        { state: "pending", expires_at }
-//        { state: "consumed", gw_id, bridge_token, client_user_id, runtime, label }
-//        { state: "expired" }
-//
-//   4. consumed 命中 → 返回 {gw_id, bridge_token, client_user_id, label, relay_url}
-//      expired   → 抛错,主循环重新走步骤 1
-//      poll 超时 → 抛错,主循环重新走步骤 1
-//
-// 全程不需要用户在 cli 上输入任何东西;所有信息走二维码 ↔ App。
-
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-
-import {
-  PAIR_STATUS_POLL_INTERVAL_SEC,
-  PAIR_STATUS_POLL_MAX_SEC,
-  QR_PNG_OUTPUT_PATH,
-  RUNTIME_NAME,
-} from "./constants.mjs";
-
-const PAIR_LABEL_DEFAULT = "我的巴布";
-
-/**
- * 调 server 创建一个 picoclaw pair-code。
- * @returns {Promise<{code, qr_payload, qr_png_base64, fetch_token, expires_at, poll_interval_seconds}>}
- */
-export async function createPairCode({ relayUrl, label, deviceId, ttlSeconds, fetchImpl, log }) {
-  const f = fetchImpl || globalThis.fetch;
-  const url = `${trimRight(relayUrl)}/v1/pair-codes/picoclaw/create`;
-  const body = {
-    label: label || PAIR_LABEL_DEFAULT,
-    device_id: deviceId || "",
-    ttl_seconds: ttlSeconds > 0 ? ttlSeconds : undefined,
-  };
-  const res = await f(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(body),
-  });
-  if (!res.ok) {
-    const text = await safeText(res);
-    throw new Error(`picoclaw pair-code create failed: HTTP ${res.status} ${text}`);
-  }
-  const j = await res.json();
-  if (!j || j.status !== "ok" || !j.code || !j.fetch_token || !j.qr_png_base64) {
-    throw new Error(`picoclaw pair-code create: malformed response ${JSON.stringify(j).slice(0, 200)}`);
-  }
-  if (log) {
-    log.info("picoclaw.pair.created", "pair-code created", {
-      code: j.code, expires_at: j.expires_at,
-    });
-  }
-  return j;
-}
-
-/**
- * 把 base64 PNG 写到约定路径,屏幕模块读取。
- */
-export function writeQRImage(b64, outputPath) {
-  const target = outputPath || QR_PNG_OUTPUT_PATH;
-  const dir = path.dirname(target);
-  try {
-    fs.mkdirSync(dir, { recursive: true });
-  } catch {}
-  const buf = Buffer.from(b64, "base64");
-  fs.writeFileSync(target, buf);
-  return target;
-}
-
-/**
- * 删除 QR 图片(配对成功后清理)。
- */
-export function clearQRImage(outputPath) {
-  const target = outputPath || QR_PNG_OUTPUT_PATH;
-  try {
-    fs.unlinkSync(target);
-  } catch {}
-}
-
-/**
- * dev 测试钩子:把 code + fetch_token + relay 等关键信息以 plain JSON 写到本地,
- * 让端到端测试脚本能扮演 App 角色拿到 code 调 consume。
- *
- * 仅当环境变量 `BUBU_DEV_DUMP_PAIR_INFO=1` 时才写。
- * **生产环境严禁开启** —— fetch_token 落地会被任何能读这台机器文件的进程拿走。
- *
- * 输出路径默认 /tmp/bubu/pair-info.json,可由 `BUBU_DEV_PAIR_INFO_PATH` 覆盖。
- */
-export function writeDevPairInfo(info) {
-  if (process.env.BUBU_DEV_DUMP_PAIR_INFO !== "1") return null;
-  const target =
-    process.env.BUBU_DEV_PAIR_INFO_PATH?.trim() || "/tmp/bubu/pair-info.json";
-  const dir = path.dirname(target);
-  try {
-    fs.mkdirSync(dir, { recursive: true });
-  } catch {}
-  const obj = {
-    code: info.code,
-    fetch_token: info.fetch_token,
-    relay: info.relay,
-    label: info.label || "",
-    expires_at: info.expires_at || "",
-    // qr_payload 是完整 deeplink(agentlink://pair/picoclaw?...),直接粘到
-    // App 输入框就能完成绑定,省去自己拼 URL 的麻烦。
-    qr_payload: info.qr_payload || "",
-    written_at: new Date().toISOString(),
-    warning: "BUBU_DEV_DUMP_PAIR_INFO=1; do NOT enable in production.",
-  };
-  try {
-    fs.writeFileSync(target, JSON.stringify(obj, null, 2) + "\n", "utf8");
-    return target;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 删除 dev pair-info(配对成功后清理 fetch_token 落地文件)。
- */
-export function clearDevPairInfo() {
-  if (process.env.BUBU_DEV_DUMP_PAIR_INFO !== "1") return;
-  const target =
-    process.env.BUBU_DEV_PAIR_INFO_PATH?.trim() || "/tmp/bubu/pair-info.json";
-  try {
-    fs.unlinkSync(target);
-  } catch {}
-}
-
-/**
- * 轮询 status 端点直到 consumed 或 expired。
- * @returns {Promise<{gw_id, bridge_token, client_user_id, runtime, label}>} consumed payload
- */
-export async function pollPairStatus({ relayUrl, code, fetchToken, intervalSec, maxSec, fetchImpl, log, signal }) {
-  const f = fetchImpl || globalThis.fetch;
-  const interval = (intervalSec > 0 ? intervalSec : PAIR_STATUS_POLL_INTERVAL_SEC) * 1000;
-  const maxMs = (maxSec > 0 ? maxSec : PAIR_STATUS_POLL_MAX_SEC) * 1000;
-  const startedAt = Date.now();
-  const url = `${trimRight(relayUrl)}/v1/pair-codes/picoclaw/${encodeURIComponent(code)}/status`;
-  for (;;) {
-    if (signal?.aborted) {
-      throw new Error("picoclaw pair poll aborted");
-    }
-    let res;
-    try {
-      res = await f(url, {
-        method: "GET",
-        headers: { "X-Pair-Fetch-Token": fetchToken },
-      });
-    } catch (err) {
-      // 网络抖动 — 等下次重试,日志一下
-      if (log) log.warn("picoclaw.pair.poll.err", "status poll error", { err: String(err?.message || err) });
-      await sleep(interval);
-      continue;
-    }
-    if (res.status === 401) {
-      throw new Error("picoclaw pair status: fetch_token rejected (401)");
-    }
-    if (!res.ok) {
-      const text = await safeText(res);
-      if (log) log.warn("picoclaw.pair.poll.bad", "non-ok status", { status: res.status, text });
-      await sleep(interval);
-      continue;
-    }
-    const j = await res.json().catch(() => null);
-    if (!j || typeof j.state !== "string") {
-      await sleep(interval);
-      continue;
-    }
-    if (j.state === "consumed") {
-      if (!j.bridge_token || !j.gw_id) {
-        throw new Error("picoclaw pair status: consumed but missing bridge_token/gw_id");
-      }
-      return {
-        gw_id: j.gw_id,
-        bridge_token: j.bridge_token,
-        client_user_id: j.client_user_id || "",
-        runtime: j.runtime || RUNTIME_NAME,
-        label: j.label || "",
-      };
-    }
-    if (j.state === "expired") {
-      throw new Error("picoclaw pair-code expired before consume");
-    }
-    // pending
-    if (Date.now() - startedAt >= maxMs) {
-      throw new Error("picoclaw pair-code poll timeout");
-    }
-    await sleep(interval);
-  }
-}
-
-// ── helpers ──────────────────────────────────────────────────────
-
-function trimRight(s) {
-  return String(s || "").replace(/\/+$/, "");
-}
-
-function sleep(ms) {
-  return new Promise((r) => setTimeout(r, ms));
-}
-
-async function safeText(res) {
-  try {
-    return await res.text();
-  } catch {
-    return "";
-  }
-}

package/src-ext/runtime/picoclaw/state.mjs

@@ -1,78 +0,0 @@
-// 巴布(PicoClaw)本地配对状态持久化。
-//
-// 文件: ~/.agentlink/picoclaw-state.json
-//
-// 内容:
-//   {
-//     gw_id, bridge_token, relay_url, client_user_id, label, runtime: "picoclaw",
-//     saved_at: <ISO timestamp>
-//   }
-//
-// 缺/损坏时返回 null,daemon 主循环会触发新一轮 pair-code create + QR 显示。
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-
-const STATE_DIR = path.join(os.homedir(), ".agentlink");
-const STATE_FILE = path.join(STATE_DIR, "picoclaw-state.json");
-
-function ensureDir() {
-  try {
-    fs.mkdirSync(STATE_DIR, { recursive: true });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export function readState() {
-  try {
-    const raw = fs.readFileSync(STATE_FILE, "utf8");
-    const obj = JSON.parse(raw);
-    if (!obj || typeof obj !== "object") return null;
-    if (obj.runtime !== "picoclaw") return null;
-    const gwId = String(obj.gw_id || "").trim();
-    const relayUrl = String(obj.relay_url || "").trim();
-    const bridgeToken = String(obj.bridge_token || "").trim();
-    if (!gwId || !relayUrl || !bridgeToken) return null;
-    return {
-      gw_id: gwId,
-      bridge_token: bridgeToken,
-      relay_url: relayUrl,
-      client_user_id: String(obj.client_user_id || "").trim(),
-      label: String(obj.label || "").trim(),
-      saved_at: obj.saved_at || null,
-    };
-  } catch {
-    return null;
-  }
-}
-
-export function writeState(state) {
-  if (!ensureDir()) return false;
-  const obj = {
-    runtime: "picoclaw",
-    gw_id: state.gw_id,
-    bridge_token: state.bridge_token,
-    relay_url: state.relay_url,
-    client_user_id: state.client_user_id || "",
-    label: state.label || "",
-    saved_at: new Date().toISOString(),
-  };
-  try {
-    fs.writeFileSync(STATE_FILE, JSON.stringify(obj, null, 2) + "\n", "utf8");
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-export function clearState() {
-  try {
-    fs.unlinkSync(STATE_FILE);
-    return true;
-  } catch {
-    return false;
-  }
-}

package/src-ext/runtime/picoclaw/todoTranslator.mjs

@@ -1,67 +0,0 @@
-/**
- * todoTranslator.mjs — picoclaw runtime update_plan → todo_list block translator
- *
- * 按 translator-spec.md 和 npm-cli-todo-translator-picoclaw spec 实现：
- *   - 识别 PicoMessage type==="message.update" && payload.kind==="tool_calls"
- *   - 检查 tool_calls 中是否含 update_plan
- *   - 若含：转写为 content_block.started + content_block.completed，拦截不透传
- *   - 否则：原样透传（返回 [msg]）
- */
-
-import {
-  buildBlockStarted,
-  buildBlockCompleted,
-  newBlockId,
-} from "../../../src-shared/envelope_builder.mjs";
-import { buildTodoItems } from "../_shared/todoTranslatorUtils.mjs";
-
-/**
- * 创建 picoclaw update_plan translator 实例。
- *
- * @param {string} runId  当前 run 的 run_id，用于构造 envelope
- * @returns {{ intercept(msg: object): object[] }}
- */
-export function createPicoTodoTranslator(runId) {
-  return {
-    /**
-     * @param {object} msg  PicoMessage（{ type, id, session_id, payload }）
-     * @returns {object[]}  2 个 envelope（update_plan）或 [msg]（透传）
-     */
-    intercept(msg) {
-      if (!msg || typeof msg !== "object") return [msg];
-
-      // 只处理 message.update(kind=tool_calls)
-      if (msg.type !== "message.update") return [msg];
-      const payload = msg.payload;
-      if (!payload || payload.kind !== "tool_calls") return [msg];
-
-      // 从 tool_calls 数组中找 update_plan
-      const toolCalls = Array.isArray(payload.tool_calls)
-        ? payload.tool_calls
-        : (Array.isArray(payload.content) ? payload.content : []);
-      const updatePlanCall = toolCalls.find(
-        (tc) => tc && typeof tc === "object" && tc.name === "update_plan",
-      );
-      if (!updatePlanCall) return [msg];
-
-      // 解析 arguments
-      let args = {};
-      if (updatePlanCall.arguments) {
-        try {
-          args = JSON.parse(String(updatePlanCall.arguments));
-        } catch { /* 保持空对象 */ }
-      }
-
-      // plan 数组映射为 TodoItem[]（explanation 忽略）
-      const rawPlan = Array.isArray(args.plan) ? args.plan : [];
-      const items = buildTodoItems(rawPlan);
-      const blockId = newBlockId();
-      const block = { id: blockId, type: "todo_list", items };
-
-      return [
-        buildBlockStarted(runId, block),
-        buildBlockCompleted(runId, { ...block }),
-      ];
-    },
-  };
-}