@xyagent/cli 0.0.1 → 1.1.0

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

@@ -1,272 +0,0 @@
-// Pico Protocol ↔ OpenAI Responses API 风格 native event 翻译器。
-//
-// CLI 把巴布(PicoClaw)WebSocket 上的 PicoMessage 翻译成服务端
-// `internal/adapter/picoclaw` 期望的 native event 流(与 openclaw 共享 mapper)。
-//
-// PicoMessage 格式:
-//   { type, id, session_id, timestamp, payload }
-//
-// CLI 出参格式(与 openclaw bridge 现有产物对齐):
-//   { event: "start" }
-//   { event: "chunk", data: JSON.stringify({ type: "response.output_text.delta", delta: "..." }) }
-//   { event: "chunk", data: JSON.stringify({ type: "response.reasoning_summary_text.delta", delta: "..." }) }
-//   { event: "chunk", data: JSON.stringify({ type: "response.function_call_arguments.delta", call_id, name, arguments }) }
-//   { event: "chunk", data: JSON.stringify({ type: "response.output_text.done", text: "<full>" }) }
-//   { event: "end" }
-//   { event: "error", error: "msg" }
-//
-// **Pico → OpenClaw 映射表**:
-//
-// | Pico (server→client) | OpenClaw native (CLI emits) |
-// |----------------------|------------------------------|
-// | message.create       | { event: "start" }(每个 turn 起头一次)|
-// | message.update (default kind, payload.content) | response.output_text.delta(算 delta) |
-// | message.update (kind=thought)                  | response.reasoning_summary_text.delta |
-// | message.update (kind=tool_calls)               | response.function_call_arguments.delta(简化:把 tool_calls JSON 序列化进 arguments) |
-// | typing.stop / 最后一条 update                  | response.output_text.done + { event: "end" } |
-// | media.create                                   | 一期降级:转成 response.output_text.delta 加占位文本(支持 base64/url 二期) |
-// | error                                          | { event: "error", error: msg } + { event: "end" } |
-// | pong                                           | drop                          |
-//
-// **Delta 计算**: PicoClaw 的 message.update 通常发"累积全文",CLI 通过比对
-// 内部 lastText 字段算出 delta 增量再发。如果服务端遇到回退场景(content
-// 比上次短),按"重置 + 全量重发"处理(不应发生,但写防御代码)。
-
-const KIND_THOUGHT = "thought";
-const KIND_TOOL_CALLS = "tool_calls";
-
-// 单条 turn 的累积状态。每个 turn 一个,`reset()` 后复用。
-export function createTurnState() {
-  return {
-    started: false,
-    finalized: false,
-    // 主回复正文的累积值
-    textAccum: "",
-    // 思考链的累积值
-    thoughtAccum: "",
-    // tool_calls 列表的累积 JSON(上次发送的)
-    toolCallsAccum: "",
-    // 上次响应的 PicoClaw message_id
-    lastMessageID: "",
-  };
-}
-
-/**
- * 翻译一条 PicoMessage 为 0..N 个 native event。
- *
- * @param {object} msg PicoMessage `{ type, id, session_id, timestamp, payload }`
- * @param {object} state createTurnState() 返回的状态
- * @returns {Array<{event:string, data?:string, error?:string}>} native events
- */
-export function translatePicoMessage(msg, state) {
-  if (!msg || typeof msg !== "object") return [];
-  // Bug 4 防御:turn 已 finalized 后再来 update/media 等都直接丢弃,避免发出
-  // 服务端 run 已 completed 之后的 delta 导致状态机错位。pong/error 仍处理
-  // (error 即使在 finalize 后也要透传)。
-  if (state.finalized && msg.type !== "error" && msg.type !== "pong") {
-    return [];
-  }
-  const out = [];
-  switch (msg.type) {
-    case "message.create": {
-      // 一个 turn 的起始 — 服务端 openclaw mapper 期望 "start"。
-      if (!state.started) {
-        state.started = true;
-        out.push({ event: "start" });
-      }
-      // payload.content 可能携带初始文本,按 update 处理一次。
-      const content = readContent(msg);
-      if (content) {
-        emitDeltaForKind(out, state, msg, content);
-      }
-      return out;
-    }
-    case "message.update": {
-      if (!state.started) {
-        state.started = true;
-        out.push({ event: "start" });
-      }
-      const content = readContent(msg);
-      if (content !== null && content !== undefined) {
-        emitDeltaForKind(out, state, msg, content);
-      }
-      return out;
-    }
-    case "media.create": {
-      // 一期:把 media 描述 inline 成正文占位文字,告诉用户"这里有一张图"。
-      // 二期会接 /pico/media/<id> 下载 + 转 base64 + response.output_text.delta with image。
-      if (!state.started) {
-        state.started = true;
-        out.push({ event: "start" });
-      }
-      const placeholder = describeMedia(msg);
-      if (placeholder) {
-        appendDelta(out, state, "text", placeholder);
-      }
-      return out;
-    }
-    case "typing.stop": {
-      // 流结束信号 — 收到后 finalize。
-      finalizeTurn(out, state);
-      return out;
-    }
-    case "error": {
-      const errMsg = (msg.payload && (msg.payload.message || msg.payload.error)) || "picoclaw error";
-      out.push({ event: "error", error: String(errMsg) });
-      // error 后强制 end,避免服务端 adapter 觉得 turn 悬空
-      if (!state.finalized) {
-        state.finalized = true;
-        out.push({ event: "end" });
-      }
-      return out;
-    }
-    case "typing.start":
-    case "pong":
-      return [];
-    default:
-      // 未识别消息类型 — 一期忽略,日志侧记录(translator 不持有 logger;调用方记)。
-      return [];
-  }
-}
-
-/**
- * 在调用方决定 turn 已结束时(比如 WS 端关闭、超时、显式 typing.stop 都没拿到),
- * 强制 finalize。幂等。
- */
-export function forceFinalize(state) {
-  const out = [];
-  finalizeTurn(out, state);
-  return out;
-}
-
-// ── internal ────────────────────────────────────────────────────
-
-function emitDeltaForKind(out, state, msg, content) {
-  const kind = readKind(msg);
-  if (kind === KIND_THOUGHT) {
-    appendDelta(out, state, "thought", content);
-    return;
-  }
-  if (kind === KIND_TOOL_CALLS) {
-    // tool_calls 的 content 期望是 JSON(数组或对象);序列化成 arguments string。
-    const argsJSON = typeof content === "string" ? content : safeJSON(content);
-    if (argsJSON !== state.toolCallsAccum) {
-      state.toolCallsAccum = argsJSON;
-      out.push({
-        event: "chunk",
-        data: JSON.stringify({
-          type: "response.function_call_arguments.delta",
-          call_id: String(msg.id || msg.session_id || ""),
-          name: pickToolName(msg) || "tool_call",
-          arguments: argsJSON,
-        }),
-      });
-    }
-    return;
-  }
-  // 默认:正文 delta
-  appendDelta(out, state, "text", content);
-}
-
-function appendDelta(out, state, kind, content) {
-  const text = typeof content === "string" ? content : String(content);
-  let delta;
-  if (kind === "text") {
-    delta = computeDelta(state.textAccum, text);
-    if (delta == null) return;
-    state.textAccum = text;
-    out.push({
-      event: "chunk",
-      data: JSON.stringify({
-        type: "response.output_text.delta",
-        delta,
-      }),
-    });
-  } else if (kind === "thought") {
-    delta = computeDelta(state.thoughtAccum, text);
-    if (delta == null) return;
-    state.thoughtAccum = text;
-    out.push({
-      event: "chunk",
-      data: JSON.stringify({
-        type: "response.reasoning_summary_text.delta",
-        delta,
-      }),
-    });
-  }
-}
-
-// computeDelta: 优先按"累积全文"模型计算增量;若新文本比旧短(异常 reset),
-// 把 prev 当空,delta = full new。返回 null 表示没增量(同文本)。
-function computeDelta(prev, next) {
-  if (next === prev) return null;
-  if (next.startsWith(prev)) return next.slice(prev.length);
-  // 回退/重置 — 直接整段重发
-  return next;
-}
-
-function finalizeTurn(out, state) {
-  if (state.finalized) return;
-  state.finalized = true;
-  if (state.started && state.textAccum) {
-    out.push({
-      event: "chunk",
-      data: JSON.stringify({
-        type: "response.output_text.done",
-        text: state.textAccum,
-      }),
-    });
-  }
-  if (state.started) {
-    out.push({ event: "end" });
-  }
-}
-
-function readContent(msg) {
-  if (!msg || typeof msg.payload !== "object" || msg.payload === null) return null;
-  const c = msg.payload.content;
-  if (c === undefined || c === null) return null;
-  if (typeof c === "string") return c;
-  return c; // 留给 emitDeltaForKind 决定如何处理(tool_calls 用 JSON)
-}
-
-function readKind(msg) {
-  if (!msg || typeof msg.payload !== "object" || msg.payload === null) return "";
-  const k = msg.payload.kind;
-  if (typeof k === "string") return k.trim().toLowerCase();
-  // legacy: payload.thought=true
-  if (msg.payload.thought === true) return KIND_THOUGHT;
-  return "";
-}
-
-function pickToolName(msg) {
-  if (!msg || typeof msg.payload !== "object" || msg.payload === null) return "";
-  if (Array.isArray(msg.payload.tool_calls) && msg.payload.tool_calls[0]) {
-    const t = msg.payload.tool_calls[0];
-    if (t && typeof t === "object") {
-      if (typeof t.name === "string") return t.name;
-      if (t.function && typeof t.function.name === "string") return t.function.name;
-    }
-  }
-  return "";
-}
-
-function describeMedia(msg) {
-  if (!msg || typeof msg.payload !== "object" || msg.payload === null) return "";
-  const p = msg.payload;
-  if (typeof p.url === "string" && p.url.length > 0) {
-    return `\n[media: ${p.url}]\n`;
-  }
-  if (typeof p.id === "string" && p.id.length > 0) {
-    return `\n[media:${p.id}]\n`;
-  }
-  return "\n[media]\n";
-}
-
-function safeJSON(v) {
-  try {
-    return JSON.stringify(v);
-  } catch {
-    return "";
-  }
-}

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

@@ -1,129 +0,0 @@
-// PicoClaw daemon WebSocket 客户端。
-//
-// PicoClaw daemon 默认监听 127.0.0.1:18790,WS 路径 /pico/ws。
-// 鉴权 3 种方式(picoclaw 自身支持):
-//   1. Authorization: Bearer <token>     (服务端 / Node `ws` 包可用)
-//   2. Sec-WebSocket-Protocol "token.<value>"  (浏览器 / Node 22 内置 WebSocket 用这条)
-//   3. query 参数 ?token=<value>(picoclaw 必须开启 AllowTokenQuery)
-//
-// 这里走 #2 子协议 — Node 22 内置 WebSocket 不支持自定义 header,但支持
-// 第二参数 protocols。`@xyagent/cli` 之前没有任何 npm 依赖,我们保持零依赖,
-// 直接用 globalThis.WebSocket(Node ≥21 内置)。
-//
-// 通讯使用 PicoMessage:
-//   { type, id, session_id, timestamp, payload }
-//
-// CLI 端只需:
-//   send(msg)      —— 发消息(JSON 序列化)
-//   onMessage(fn)  —— 收消息回调
-//   onClose(fn)    —— 断开回调(自动重连由调用方决定)
-//   close()        —— 主动关闭
-
-import {
-  PICOCLAW_TOKEN,
-  PICOCLAW_WS_URL,
-} from "./constants.mjs";
-
-/**
- * 建一个 PicoClaw 连接。
- * @returns {Promise<PicoclawConn>}
- */
-export function connect({ url, token, log }) {
-  const target = url || PICOCLAW_WS_URL;
-  const bearer = token || PICOCLAW_TOKEN;
-  return new Promise((resolve, reject) => {
-    const subprotocol = `token.${bearer}`;
-    const WS = globalThis.WebSocket;
-    if (!WS) {
-      reject(new Error("global WebSocket not available; require Node >= 21"));
-      return;
-    }
-    const ws = new WS(target, [subprotocol]);
-    let settled = false;
-    ws.addEventListener("open", () => {
-      if (settled) return;
-      settled = true;
-      resolve(makeConn(ws, log, target));
-    });
-    ws.addEventListener("error", (ev) => {
-      if (settled) return;
-      settled = true;
-      const msg = (ev && ev.message) || "ws error";
-      reject(new Error(String(msg)));
-    });
-    ws.addEventListener("close", (ev) => {
-      if (settled) return;
-      settled = true;
-      reject(new Error(`picoclaw ws closed before open: code=${ev?.code}`));
-    });
-  });
-}
-
-function makeConn(ws, log, target) {
-  /** @type {Set<(msg:any)=>void>} */
-  const messageHandlers = new Set();
-  /** @type {Set<(reason:string)=>void>} */
-  const closeHandlers = new Set();
-
-  ws.addEventListener("message", (ev) => {
-    let parsed;
-    try {
-      const data = typeof ev.data === "string" ? ev.data : Buffer.from(ev.data).toString("utf8");
-      parsed = JSON.parse(data);
-    } catch (err) {
-      if (log) log.warn("picoclaw.ws.parse.err", "bad pico message", { err: String(err?.message || err) });
-      return;
-    }
-    for (const h of messageHandlers) {
-      try { h(parsed); } catch (err) {
-        if (log) log.warn("picoclaw.ws.handler.err", "handler threw", { err: String(err?.message || err) });
-      }
-    }
-  });
-  ws.addEventListener("close", (ev) => {
-    if (log) log.info("picoclaw.ws.closed", "ws closed", { code: ev?.code, reason: String(ev?.reason || "") });
-    for (const h of closeHandlers) {
-      try { h(`code=${ev?.code}`); } catch {}
-    }
-  });
-  ws.addEventListener("error", (ev) => {
-    if (log) log.warn("picoclaw.ws.err", "ws error", { err: String(ev?.message || "ws error") });
-  });
-
-  if (log) log.info("picoclaw.ws.open", "connected", { url: target });
-
-  return {
-    send(picoMessage) {
-      if (ws.readyState !== 1 /* OPEN */) {
-        throw new Error(`picoclaw ws not open: state=${ws.readyState}`);
-      }
-      ws.send(JSON.stringify(picoMessage));
-    },
-    onMessage(fn) { messageHandlers.add(fn); return () => messageHandlers.delete(fn); },
-    onClose(fn) { closeHandlers.add(fn); return () => closeHandlers.delete(fn); },
-    close(reason) {
-      try { ws.close(1000, reason || "client close"); } catch {}
-    },
-    get readyState() { return ws.readyState; },
-    get url() { return target; },
-  };
-}
-
-/**
- * 构造 message.send 帧(用户消息进入 PicoClaw)。
- *
- * @param {{sessionId:string, content:string, requestId?:string}} arg
- */
-export function buildMessageSend({ sessionId, content, requestId }) {
-  return {
-    type: "message.send",
-    id: requestId || randomID(),
-    session_id: sessionId,
-    timestamp: Date.now(),
-    payload: { content: String(content || "") },
-  };
-}
-
-function randomID() {
-  return Math.random().toString(36).slice(2, 10) + Date.now().toString(36);
-}