@xyagent/cli 0.0.1 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyagent/cli",
-  "version": "0.0.1",
+  "version": "1.0.0",
   "private": false,
   "description": "Relay-first CLI for pairing and bridging OpenClaw gateway traffic",
   "type": "module",
@@ -33,6 +33,8 @@
     "agentlink-mcp-stdio": "bin/agentlink-mcp-stdio"
   },
   "dependencies": {
-    "pdfjs-dist": "^4.10.38"
+    "pdfjs-dist": "^4.10.38",
+    "qrcode": "^1.5.4",
+    "qrcode-terminal": "^0.12.0"
   }
 }

package/src/core.mjs

@@ -80,6 +80,16 @@ export function normalizeProvidedCode(raw, onInvalid = throwError) {
   if (/^\d{4}$/.test(compact)) return compact;
   if (/^\d{6}$/.test(compact)) return compact;
   if (/^[A-Z0-9]{8}$/.test(compact)) return formatCode(compact);
+  // High-entropy scan code (`agentlink scan`, unify-scan-pairing): generated
+  // locally by the CLI via generateScanPairCode(), never hand-typed by a user
+  // (QR/deeplink transport only) — so no dash-grouping is applied. Contract
+  // with go_relay (real-device P0 fix): EXACTLY 16 uppercase hex chars
+  // (64 bits) — go_relay's `pair_sessions.pair_code` column is `varchar(16)`
+  // (no DDL), and go_relay's own validation was tightened to the same
+  // `^[0-9A-F]{16}$`. Do not widen this range again without a matching DDL —
+  // a wider CLI-side accept here previously let an 18-char/72-bit code
+  // through that overflowed the column (HTTP 500 "Data too long").
+  if (/^[A-Z0-9]{16}$/.test(compact)) return compact;
   return onInvalid(
     "invalid --code format. expected 4 digits (e.g. 1234), 6 digits (e.g. 123456), " +
       "or 8 alphanumeric characters (e.g. ABCD-1234; case-insensitive, dash optional)",
@@ -92,6 +102,22 @@ export function generatePairCode(random = Math.random, numericCodeLength = NUMER
   return String(min + Math.floor(random() * (max - min)));
 }
 
+// High-entropy pair code for `agentlink scan` (unify-scan-pairing spec's "安全
+// 信封" §1: >=64-bit entropy, cryptographic random source, unenumerable).
+// EXACTLY 8 random bytes -> 16 uppercase hex chars = 64 bits — pinned to this
+// exact length to fit go_relay's `pair_sessions.pair_code varchar(16)` column
+// (no DDL, per user decision after a real-device P0: an earlier 9-byte/18-char
+// version overflowed the column with HTTP 500 "Data too long"). 64 bits still
+// clears the spec's >=64-bit floor for a short-TTL(<=5min) + rate-limited
+// (30/min) one-time code. Never hand-typed by a user, so no dash-grouping
+// (contrast generatePairCode()/formatCode() above, which target human entry).
+// Do not change the byte count without re-confirming the column width with
+// go_relay first.
+export function generateScanPairCode(randomBytesFn = randomBytes) {
+  const buf = randomBytesFn(8);
+  return Buffer.from(buf).toString("hex").toUpperCase();
+}
+
 export function parseNonNegativeInt(value, fallback = 0) {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value >= 0 ? Math.trunc(value) : fallback;

package/src-ext/bin.mjs

@@ -94,7 +94,6 @@ async function main() {
     case "claude":
     case "codex":
     case "hermes":
-    case "picoclaw":
       await runAgentCommand({ runtime: subcommand, options, positional, log });
       return;
     case "service":

package/src-ext/commands/agent.mjs

@@ -1,7 +1,6 @@
 import { runClaudeBridge } from "../runtime/claude/index.mjs";
 import { runCodexBridge } from "../runtime/codex/index.mjs";
 import { runHermesBridge } from "../runtime/hermes/index.mjs";
-import { runPicoclawBridge } from "../runtime/picoclaw/index.mjs";
 import { runPairInstall, runUninstall } from "./pair.mjs";
 
 /**
@@ -17,13 +16,6 @@ export async function runAgentCommand({ runtime, options, positional, log }) {
   const action = (positional[0] || "").toLowerCase();
 
   if (action === "pair") {
-    // picoclaw 不走传统 `pair <code>`,daemon 启动后自动配对(QR 流)。
-    if (runtime === "picoclaw") {
-      process.stderr.write(
-        "picoclaw 不需要 pair 子命令,直接启动 daemon: agentlink-agent picoclaw\n",
-      );
-      process.exit(2);
-    }
     const code = String(positional[1] || options.pair || "").trim();
     if (!code) {
       process.stderr.write(`usage: agentlink pair <code> -r ${runtime}\n`);
@@ -55,9 +47,6 @@ export async function runAgentCommand({ runtime, options, positional, log }) {
     case "hermes":
       await runHermesBridge({ options, positional, log: rtLog });
       return;
-    case "picoclaw":
-      await runPicoclawBridge({ options, positional, log: rtLog });
-      return;
     default:
       rtLog.error("bridge.unknown_runtime", "unsupported runtime", { runtime });
       process.stderr.write(`unsupported runtime: ${runtime}\n`);

package/src-ext/core/agentlinkToolsBootstrap.mjs

@@ -19,7 +19,7 @@ import { createPathAttachScanner } from "./bridgeAttachAutoScanner.mjs";
 
 /**
  * @param {object} opts
- * @param {string} opts.runtime           "claude"|"codex"|"hermes"|"openclaw"|"picoclaw"
+ * @param {string} opts.runtime           "claude"|"codex"|"hermes"|"openclaw"
  * @param {string} opts.gwId              gateway id (= clientUserID 跨 pair_session 反查的键)
  * @param {string} opts.relayUrl          relay base URL
  * @param {string} opts.bridgeToken       gateway/client token, used by attach 工具调 relay sign/commit

package/src-ext/core/autoTunnelDetector.mjs

@@ -22,7 +22,12 @@ const LAN_HOST =
 
 // URL 尾部：可省略；若有，以 / ? # 起，止于空白或闭合标点。
 // 不包含 ) ] > " ' ` 避免吞 markdown / HTML / 引号边界。
-const URL_TAIL = "(?:[/?#][^\\s)\\]>\"'`]*)?";
+// 另排除全角标点/括号（＀-￯，含全角 `（）`）与 CJK 字符（CJK 标点
+// 　-ヿ、汉字 一-鿿、谚文 가-힯）：模型常在 URL 后
+// 紧跟中文说明（如 `index.html（返回 200 正常）`），不排除会把中文吞进 URL，
+// 导致穿透 URL 与 markdown label 都带上乱码路径 → WebView 404。
+const URL_TAIL =
+  "(?:[/?#][^\\s)\\]>\"'`\\u3000-\\u30FF\\u4E00-\\u9FFF\\uAC00-\\uD7AF\\uFF00-\\uFFEF]*)?";
 
 function buildRegex(hostFragment) {
   // 锚定：URL 前必须有非字母数字（或字符串开头）

package/src-ext/core/autoTunnelWiring.mjs

@@ -8,7 +8,7 @@
 //     则禁用）选择是否注册到 bridgeHooks 全局 registry。
 //   - 多次调用幂等：用模块级 flag 防止重复注册。
 //
-// 调用方：每个 runtime 入口（src-ext/runtime/{claude,codex,hermes,picoclaw}/index.mjs）
+// 调用方：每个 runtime 入口（src-ext/runtime/{claude,codex,hermes}/index.mjs）
 // 在 bridge 主循环启动前调一次 installAutoTunnel({ relayUrl, log })。
 
 import fs from "node:fs";

package/src-ext/core/bridgeSelfUninstall.mjs

@@ -43,7 +43,7 @@ function findCliBinary() {
 
 /**
  * @param {{ runtime: string, log: any }} opts
- *   runtime: hermes / claude / codex / openclaw / picoclaw
+ *   runtime: hermes / claude / codex / openclaw
  *   log:     bridge 自己的 logger（已经带 cid / gw context）
  *
  * 返回 Promise，不抛错 —— 任一步失败都 best-effort，最差也就是用户手动

package/src-ext/core/relayWorker.mjs

@@ -111,7 +111,7 @@ export function createRelayWorker(opts) {
   // App 端用 `meta.online ?? meta.connected ?? meta.alive ?? meta.state` 串行
   // 兜底来判 bridge 是否在线（见 agent_app/matelink-app/lib/src/models/relay_models.dart:477）。
   // legacy openclaw bridge 的 `buildBridgePresenceMeta` 一直会发这套字段，
-  // ext runtime（hermes / claude / codex / picoclaw）漏发会导致 onlineHint=null
+  // ext runtime（hermes / claude / codex）漏发会导致 onlineHint=null
   // → App UI 兜底显示"离线"（即用户报"配对完显示离线"的根因）。
   // detail === "stopped" 时表示主动下线，其它（"ready" / "heartbeat" / "alive"）都视为在线。
   async function sendMeta(detail) {

package/src-ext/core/scanDeeplink.mjs

@@ -0,0 +1,67 @@
+// `agentlink scan` 中性 deeplink 构造 + 本地 QR PNG 渲染。
+//
+// unify-scan-pairing 取代了上一代扫码硬件方案：旧方案的 QR payload/PNG 由**服务端**
+// 在专用 create 端点响应里下发（`qr_payload` + `qr_png_base64`，已随硬件方案一并
+// 删除）。新契约下 `POST /v1/pair-sessions` host-claim 响应不带任何二维码内容——
+// CLI 必须自己构造 payload、自己渲染 PNG。
+//
+// 契约（spec「中性 deeplink 契约」，冻结，App 侧对齐）：
+//   agentlink://pair/scan?v=1&code=<CODE>&relay=<urlencoded relay base>
+//   v    = payload 版本号（当前 1）
+//   code = 高熵 pair code（generateScanPairCode()，见 src/core.mjs）
+//   relay= 可选；缺省时 App 用自己已配置的 relay。
+
+import fs from "node:fs";
+import path from "node:path";
+
+const DEFAULT_DEEPLINK_VERSION = 1;
+
+/**
+ * 构造中性 deeplink payload 字符串。
+ *
+ * @param {{ code: string, relay?: string, version?: number }} opts
+ * @returns {string}
+ */
+export function buildScanDeeplink({ code, relay, version = DEFAULT_DEEPLINK_VERSION } = {}) {
+  const trimmedCode = String(code ?? "").trim();
+  if (!trimmedCode) {
+    throw new Error("buildScanDeeplink: code is required");
+  }
+  const params = new URLSearchParams();
+  params.set("v", String(version));
+  params.set("code", trimmedCode);
+  const trimmedRelay = String(relay ?? "").trim();
+  if (trimmedRelay) {
+    params.set("relay", trimmedRelay);
+  }
+  return `agentlink://pair/scan?${params.toString()}`;
+}
+
+/**
+ * 把 payload 渲染成 QR PNG 并落地到 outputPath。永不抛错——渲染失败时返回
+ * `{ ok: false, error }`，调用方（runScan）据此打印兜底提示，不中断守护循环
+ * （spec S5 的兜底精神：QR 展示失败不能中断配对流程；这里同样适用于 PNG 落地失败，
+ * 例如磁盘写入被拒）。
+ *
+ * @param {{
+ *   payload: string,
+ *   outputPath: string,
+ *   generateImpl?: (payload: string, outputPath: string) => Promise<void>,
+ * }} opts
+ * @returns {Promise<{ ok: boolean, path?: string, error?: string }>}
+ */
+export async function renderScanQrPng({ payload, outputPath, generateImpl }) {
+  const generate = generateImpl || defaultGenerateImpl;
+  try {
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    await generate(payload, outputPath);
+    return { ok: true, path: outputPath };
+  } catch (err) {
+    return { ok: false, error: String(err?.message || err) };
+  }
+}
+
+async function defaultGenerateImpl(payload, outputPath) {
+  const { default: QRCode } = await import("qrcode");
+  await QRCode.toFile(outputPath, String(payload ?? ""), { type: "png" });
+}

package/src-ext/core/scanPairFlow.mjs

@@ -0,0 +1,28 @@
+// `agentlink scan` 二维码 PNG 落地路径 + 清理工具。
+//
+// unify-scan-pairing 全量移除了上一代扫码硬件方案:本模块曾承载其专用
+// pair-code create/poll 客户端(`createPairCode`/`pollPairStatus`/
+// `runScanOutcodeLoop`)、专用命名空间常量、只写不 issue 的
+// `buildScanConfigPatch`,以及一个命名空间归一 hack——这些全部随该硬件方案的
+// 专用端点一并删除,新扫码路径改走 `pair_sessions` host-claim(见 bin/agentlink
+// 的 runScan/runPair pairMode="scan" 分支)+ 本地渲染的中性 deeplink QR
+// (见 scanDeeplink.mjs)。
+//
+// 保留下来的只有与具体硬件方案无关的通用 QR 文件落地/清理工具:CLI 出码循环
+// 每轮把新二维码 PNG 写到约定路径,过期重出码或配对成功后清掉旧文件。
+
+import fs from "node:fs";
+
+// 二维码 PNG 落地兜底路径,可用 --qr-path 或 AGENTLINK_SCAN_QR_PNG_PATH 覆盖。
+export const SCAN_QR_PNG_OUTPUT_PATH =
+  process.env.AGENTLINK_SCAN_QR_PNG_PATH?.trim() || "/tmp/bubu/scan-pair-qr.png";
+
+/**
+ * 删除 QR 图片(配对成功/重新出码前清理)。不存在时是安全的 no-op。
+ */
+export function clearQRImage(outputPath) {
+  const target = outputPath || SCAN_QR_PNG_OUTPUT_PATH;
+  try {
+    fs.unlinkSync(target);
+  } catch {}
+}

package/src-ext/core/scanQrRenderer.mjs

@@ -0,0 +1,40 @@
+// `agentlink scan` 终端二维码渲染 —— 封装 `qrcode-terminal`(`small: true`)。
+//
+// spec S6（二维码展示兜底）：终端不支持 ASCII 二维码渲染时（渲染抛错），
+// SHALL 回退为打印 payload 文本，不因渲染失败中断配对流程。因此本函数
+// **永不抛错**——渲染失败被内部吞掉并转成文本兜底。
+
+import qrcodeTerminal from "qrcode-terminal";
+
+/**
+ * 在终端渲染 payload 的 ASCII 二维码；渲染失败时回退打印 payload 文本。
+ *
+ * @param {string} payload  二维码内容（qr_payload deeplink）
+ * @param {{
+ *   generateImpl?: (input: string, opts: {small: boolean}, cb: (output: string) => void) => void,
+ *   print?: (s: string) => void,
+ *   warn?: (s: string) => void,
+ * }} [deps]
+ * @returns {{ ok: boolean, mode: "qr" | "text", error?: string }}
+ */
+export function renderQrToTerminal(payload, { generateImpl, print, warn } = {}) {
+  // NB: must call through `qrcodeTerminal.generate(...)`, not a bare
+  // reference to the method — qrcode-terminal's generate() reads `this.error`
+  // internally, and a detached reference loses that binding (`this` would be
+  // undefined under ESM's implicit strict mode), throwing on every call.
+  const generate = generateImpl || ((input, opts, cb) => qrcodeTerminal.generate(input, opts, cb));
+  const doPrint = print || ((s) => console.log(s));
+  const doWarn = warn || ((s) => console.warn(s));
+  const text = payload == null ? "" : String(payload);
+  try {
+    generate(text, { small: true }, (output) => {
+      doPrint(output);
+    });
+    return { ok: true, mode: "qr" };
+  } catch (err) {
+    const message = String(err?.message || err);
+    doWarn(`⚠ 二维码渲染失败，回退为文本（仍可完成配对）：${message}`);
+    doPrint(text);
+    return { ok: false, mode: "text", error: message };
+  }
+}

package/src-ext/core/unifiedDispatchHandler.mjs

@@ -9,7 +9,7 @@
  *
  * Injection points for testing:
  *   producerFactory({ relayUrl, bridgeToken, threadId }) → { postEvents }
- *   openclawInvoke({ input, onChunk }) → async void   (default: picoclaw wsHolder)
+ *   openclawInvoke({ input, onChunk }) → async void   (default: openclaw wsHolder)
  *   flushPolicy({ size, timeMs }) → 控制 micro-batched flush 触发阈值（默认 {size:1, timeMs:0} —— 即来即发，保流式体验）
  */
 
@@ -29,7 +29,7 @@ import { signGetCosObject } from "./cosUploadClient.mjs";
 // Streaming-first policy: size:1 means every envelope (especially
 // content_block.delta) posts immediately, so the App SSE stream receives
 // chunks as the runtime produces them rather than in 8-envelope batches.
-// Tests/picoclaw replay can override via flushPolicy if they want fewer POSTs.
+// Tests can override via flushPolicy if they want fewer POSTs.
 const DEFAULT_FLUSH_POLICY = Object.freeze({ size: 1, timeMs: 0 });
 const STREAM_DEBUG = process.env.BUBBO_DEBUG_STREAM === "1";
 
@@ -343,7 +343,7 @@ export function createUnifiedDispatchHandler({
       let runPausedFromRuntime = false;
 
       if (typeof openclawInvoke === "function") {
-        // Injected (test mode or picoclaw ws integration)
+        // Injected (test mode or ws integration)
         // thread_id 透传给 runtime adapter，让需要"按 thread 维护原生 session
         // 续接"的 runtime（如 claude --resume <sid>）可以做 mapping。
         await openclawInvoke({

package/src-ext/core/usageReporter.mjs

@@ -40,8 +40,7 @@ export function createUsageReporter({ publishEvent, runtime, log, debounceMs = D
   if (
     runtime !== "claude" &&
     runtime !== "codex" &&
-    runtime !== "hermes" &&
-    runtime !== "picoclaw"
+    runtime !== "hermes"
   ) {
     throw new Error(`createUsageReporter: bad runtime ${runtime}`);
   }

package/src-ext/openclaw-plugin/envelope-builder.cjs

@@ -448,7 +448,7 @@ function translateOpenClawChunkToEnvelope(chunk, runId, blockState) {
     }
     envelopes.push(env);
   } else if (event === "response.function_call_arguments.delta") {
-    // picoclaw legacy event name → maps to tool_use.start + arguments.delta.
+    // legacy event name → maps to tool_use.start + arguments.delta.
     // chunk shape: { call_id, name, arguments } where arguments is a JSON
     // fragment to append. We auto-start a tool_use block on first occurrence.
     const callId = String(chunk.call_id || "");
@@ -540,7 +540,7 @@ function translateOpenClawChunkToEnvelope(chunk, runId, blockState) {
     envelopes.push(started, completed);
   } else if (event === "response.output_text.done") {
     // No incremental envelope needed — full text already accumulated via deltas.
-    // If runtime carries authoritative full text on .done (e.g. picoclaw), prefer it.
+    // If the runtime carries authoritative full text on .done, prefer it.
     if (typeof chunk.text === "string" && chunk.text.length > 0) {
       text.content = chunk.text;
     }

package/src-ext/openclaw-plugin/todoTranslatorUtils.cjs

@@ -75,7 +75,7 @@ function normalizeStatus(raw) {
  * rawItems 中每项支持字段：
  *   - id?:         string（有则保留，无则生成 td_{idx}）
  *   - content?:    string（主内容字段，Claude/Hermes 用）
- *   - step?:       string（Codex/picoclaw 用，作为 content 的 fallback）
+ *   - step?:       string（Codex 用，作为 content 的 fallback）
  *   - status?:     string（经 normalizeStatus 归一）
  *
  * @param {Array<{id?: string, content?: string, step?: string, status?: string}>} rawItems

package/src-ext/runtime/_shared/relayObjectToBlock.mjs

@@ -12,9 +12,9 @@
  *   { type: "image"|"attachment", source: { kind: "url", url, media_type, attachment_kind }, name?, mime?, size? }
  *
  * @param {object} opts
- * @param {string}   opts.runtimeHint          - "claude"|"openclaw"|"picoclaw"|"codex"|"hermes"
+ * @param {string}   opts.runtimeHint          - "claude"|"openclaw"|"codex"|"hermes"
  * @param {string[]|null} opts.modelCaps        - modalities 数组（如 ["text","image","pdf"]）。
- *                                               null 表示跳过 caps 检查（picoclaw）。
+ *                                               null 表示跳过 caps 检查。
  *                                               缺失时默认 ["text"]。
  * @param {Function} opts.fetchAndBase64Encode  - async (url, opts) => { base64, mediaType, bytes }
  * @param {Function} [opts.fetchAndDecodeText]  - async (url, opts) => string
@@ -26,7 +26,6 @@
  *   { type: "input_image",   source: { type: "base64", media_type, data } }
  *   { type: "input_file",    source: { type: "base64", media_type: "application/pdf", filename, data } }
  *   { type: "input_text",    text }
- *   { type: "url_ref",       url, media_type }   // picoclaw only
  *
  * ErrorResult:
  *   { error: { code: "caps_mismatch",    message, model?, missing_modality } }
@@ -70,8 +69,12 @@ function resolveAttachmentKind(block) {
 
 export async function relayObjectToBlock(block, opts = {}) {
   const {
-    runtimeHint,
-    modelCaps,       // null = skip caps check (picoclaw); undefined/missing = default ["text"]
+    // 曾经唯一消费 runtimeHint 的分支(url_ref 直通)是移除硬件方案时删掉的
+    // 专属逻辑;所有真实 runtime(openclaw/claude/hermes)现在走同一条
+    // fetch+base64 路径,不再需要按 runtime 分叉。保留在签名里是为了不动调用方
+    // (openclaw/claude/hermes 三处仍显式传它),留作未来按 runtime 差异化的挂钩点。
+    runtimeHint: _runtimeHint,
+    modelCaps,       // null = skip caps check; undefined/missing = default ["text"]
     fetchAndBase64Encode,
     fetchAndDecodeText,
   } = opts;
@@ -107,12 +110,7 @@ export async function relayObjectToBlock(block, opts = {}) {
       };
     }
 
-    // 2. picoclaw → url_ref（无 fetch）
-    if (runtimeHint === "picoclaw") {
-      return { type: "url_ref", url, media_type: mediaType };
-    }
-
-    // 3. fetch + base64
+    // 2. fetch + base64
     try {
       const { base64, mediaType: resolvedMime, bytes } = await fetchAndBase64Encode(url, {
         expectedMime: mediaType,

package/src-ext/runtime/_shared/todoTranslatorUtils.mjs

@@ -72,7 +72,7 @@ export function normalizeStatus(raw) {
  * rawItems 中每项支持字段：
  *   - id?:         string（有则保留，无则生成 td_{idx}）
  *   - content?:    string（主内容字段，Claude/Hermes 用）
- *   - step?:       string（Codex/picoclaw 用，作为 content 的 fallback）
+ *   - step?:       string（Codex 用，作为 content 的 fallback）
  *   - status?:     string（经 normalizeStatus 归一）
  *
  * @param {Array<{id?: string, content?: string, step?: string, status?: string}>} rawItems

package/src-ext/runtime/claude/launcher.mjs

@@ -285,12 +285,6 @@ export async function writeUserMessage(child, text, blocks = [], { _fetchAndBase
       case "input_text":
         content.push({ type: "text", text: result.text });
         break;
-      case "url_ref":
-        // picoclaw only — claude runtime never returns url_ref from relayObjectToBlock;
-        // if this branch is somehow hit, drop to a safe description with NO URL in LLM context
-        // (铁律 #1: signed URL must not appear in LLM input). (CR-003)
-        content.push({ type: "text", text: `[image] (preview unavailable for this runtime)` });
-        break;
       default:
         break;
     }

package/src-ext/runtime/openclaw/buildOpenclawDaemonInput.mjs

@@ -127,12 +127,6 @@ export async function buildOpenclawDaemonInput(textInput, blocks, {
         // text 文件内容 / binary 描述 / document text extraction fallback
         content.push({ type: "input_text", text: result.text });
         break;
-      case "url_ref":
-        // picoclaw only — openclaw/claude runtimes never return url_ref from relayObjectToBlock;
-        // if this branch is somehow hit, drop to a safe description with NO URL in LLM context
-        // (铁律 #1: signed URL must not appear in LLM input). (CR-003)
-        content.push({ type: "input_text", text: `[image] (preview unavailable for this runtime)` });
-        break;
       default:
         break;
     }

package/src-shared/envelope_builder.mjs

@@ -445,7 +445,7 @@ export function translateOpenClawChunkToEnvelope(chunk, runId, blockState) {
     }
     envelopes.push(env);
   } else if (event === "response.function_call_arguments.delta") {
-    // picoclaw legacy event name → maps to tool_use.start + arguments.delta.
+    // legacy event name → maps to tool_use.start + arguments.delta.
     // chunk shape: { call_id, name, arguments } where arguments is a JSON
     // fragment to append. We auto-start a tool_use block on first occurrence.
     const callId = String(chunk.call_id || "");
@@ -537,7 +537,7 @@ export function translateOpenClawChunkToEnvelope(chunk, runId, blockState) {
     envelopes.push(started, completed);
   } else if (event === "response.output_text.done") {
     // No incremental envelope needed — full text already accumulated via deltas.
-    // If runtime carries authoritative full text on .done (e.g. picoclaw), prefer it.
+    // If the runtime carries authoritative full text on .done, prefer it.
     if (typeof chunk.text === "string" && chunk.text.length > 0) {
       text.content = chunk.text;
     }

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

@@ -1,39 +0,0 @@
-// 巴布(PicoClaw)运行时常量。
-//
-// 部署假设:matelink-cli 与 picoclaw daemon 烧录在同一开发板,
-// cli 默认连本地回环 picoclaw WebSocket。token 烧录时固化,cli 端写死同值。
-//
-// 如需改 token,**两处**(开发板 picoclaw config + 此文件)必须同步,否则连接失败。
-
-import process from "node:process";
-
-// PicoClaw daemon 的 WebSocket 端点(Pico Protocol)。
-// 默认 127.0.0.1:18790/pico/ws,可通过 env 覆盖(开发/调试用)。
-export const PICOCLAW_WS_URL =
-  process.env.PICOCLAW_WS_URL?.trim() || "ws://127.0.0.1:18790/pico/ws";
-
-// PicoClaw Bearer token —— 与开发板 picoclaw config 里 [pico].token 一致。
-// 生产烧录时双方都写死成下面这个固定值;切换值时必须双侧同步。
-export const PICOCLAW_TOKEN =
-  process.env.PICOCLAW_TOKEN?.trim() || "bubu-local-token";
-
-// 巴布配对二维码 PNG 输出路径 —— 屏幕显示模块从这个路径加载图片。
-// 默认写到 /tmp/bubu/pair-qr.png,可通过 env 覆盖。
-export const QR_PNG_OUTPUT_PATH =
-  process.env.BUBU_QR_PNG_PATH?.trim() || "/tmp/bubu/pair-qr.png";
-
-// 配对状态轮询间隔(秒)。服务端建议值在 create 响应里返回,这是兜底。
-export const PAIR_STATUS_POLL_INTERVAL_SEC = 2;
-
-// 配对状态最长等待时间(秒)。超过后 cli 重新生成 QR(配对码已过期)。
-export const PAIR_STATUS_POLL_MAX_SEC = 300;
-
-// 长轮询拉取请求的等待时长(秒)。
-export const LONG_POLL_WAIT_SEC = 30;
-
-// PicoClaw WS 重连退避(毫秒)— 指数退避,上限 30s。
-export const WS_RECONNECT_INITIAL_MS = 1000;
-export const WS_RECONNECT_MAX_MS = 30000;
-
-// runtime 名 — 必须与服务端 RuntimeKindPicoclaw 字符串一致。
-export const RUNTIME_NAME = "picoclaw";