@xyagent/cli 0.0.1

package/src-ext/openclaw-plugin/openclaw.plugin.json

@@ -0,0 +1,20 @@
+{
+  "id": "agentlink-hooks",
+  "name": "Agentlink Hooks",
+  "description": "Captures OpenClaw tool-call, subagent and agent-end lifecycle events and forwards them to the Agentlink relay as unified Agent Protocol envelopes (tool_use / tool_result / run.completed / run.failed).",
+  "activation": {
+    "onStartup": true,
+    "onCapabilities": ["hook"]
+  },
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "enabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Master switch. When false, plugin enters no-op mode."
+      }
+    },
+    "additionalProperties": false
+  }
+}

package/src-ext/openclaw-plugin/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "agentlink-hooks",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Agentlink hooks plugin for OpenClaw — forwards tool-call and subagent lifecycle events to the Agentlink relay.",
+  "main": "index.cjs",
+  "openclaw": {
+    "extensions": [
+      "./index.cjs"
+    ]
+  }
+}

package/src-ext/openclaw-plugin/relay-defaults.json

@@ -0,0 +1,3 @@
+{
+  "defaultRelayUrl": "https://go-relay.xyagent.com"
+}

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

@@ -0,0 +1,101 @@
+// AUTO-GENERATED — DO NOT EDIT.
+// Generated by scripts/build-openclaw-plugin.mjs
+// Source: src-ext/runtime/_shared/todoTranslatorUtils.mjs
+/**
+ * todoTranslatorUtils.mjs — TODO translator 共享工具函数
+ *
+ * 按 translator-spec.md 实现：
+ *   - splitTitleDescription(text)   按优先级切分 title/description
+ *   - normalizeStatus(raw)          camelCase → snake_case + 兜底 pending
+ *   - buildTodoItems(rawItems)      数组归一化
+ */
+
+// ── splitTitleDescription ────────────────────────────────────────────────────
+
+// 分隔符按优先级排列：全角冒号 > 半角冒号 > 破折号 > 带空格短横线
+const SEPARATORS = [
+  "：", // ：全角冒号 U+FF1A
+  ":",      // 半角冒号 U+003A
+  "—", // — 破折号 U+2014
+  " - ",    // 带空格短横线
+];
+
+/**
+ * 按 translator-spec.md §6 的优先级切分 title/description。
+ *
+ * @param {string} text
+ * @returns {{ title: string, description?: string }}
+ */
+function splitTitleDescription(text) {
+  if (typeof text !== "string") {
+    return { title: String(text ?? "") };
+  }
+  for (const sep of SEPARATORS) {
+    const idx = text.indexOf(sep);
+    if (idx === -1) continue;
+    const title = text.slice(0, idx).trim();
+    const description = text.slice(idx + sep.length).trim();
+    // 若切分后 title 为空字符串，视为无匹配（规则 §6.3）
+    if (!title) continue;
+    const result = { title };
+    if (description) result.description = description;
+    return result;
+  }
+  return { title: text.trim() };
+}
+
+// ── normalizeStatus ──────────────────────────────────────────────────────────
+
+const VALID_STATUSES = new Set(["pending", "in_progress", "completed", "cancelled"]);
+
+/**
+ * 归一化 status 值：
+ *   - 已是 snake_case 合法值：原样返回
+ *   - camelCase（如 inProgress）→ snake_case
+ *   - 未知值 → "pending"
+ *
+ * @param {string|null|undefined} raw
+ * @returns {"pending"|"in_progress"|"completed"|"cancelled"}
+ */
+function normalizeStatus(raw) {
+  if (typeof raw !== "string" || !raw) return "pending";
+  // 已是合法 snake_case
+  if (VALID_STATUSES.has(raw)) return raw;
+  // camelCase → snake_case（只处理已知 Codex 值）
+  if (raw === "inProgress") return "in_progress";
+  // 其余未知值兜底
+  return "pending";
+}
+
+// ── buildTodoItems ───────────────────────────────────────────────────────────
+
+/**
+ * 从原始 item 数组构造归一化 TodoItem[]。
+ *
+ * rawItems 中每项支持字段：
+ *   - id?:         string（有则保留，无则生成 td_{idx}）
+ *   - content?:    string（主内容字段，Claude/Hermes 用）
+ *   - step?:       string（Codex/picoclaw 用，作为 content 的 fallback）
+ *   - status?:     string（经 normalizeStatus 归一）
+ *
+ * @param {Array<{id?: string, content?: string, step?: string, status?: string}>} rawItems
+ * @returns {Array<{id: string, title: string, description?: string, status: string, order: number}>}
+ */
+function buildTodoItems(rawItems) {
+  if (!Array.isArray(rawItems)) return [];
+  return rawItems.map((item, idx) => {
+    const id = typeof item?.id === "string" && item.id ? item.id : `td_${idx}`;
+    const contentText = typeof item?.content === "string"
+      ? item.content
+      : (typeof item?.step === "string" ? item.step : "");
+    const { title, description } = splitTitleDescription(contentText);
+    const status = normalizeStatus(item?.status);
+    const result = { id, title, status, order: idx };
+    if (description !== undefined) result.description = description;
+    return result;
+  });
+}
+
+// Auto-generated CJS wrapper. Source of truth: src-ext/runtime/_shared/todoTranslatorUtils.mjs.
+// Do not edit this file by hand; run `node scripts/build-openclaw-plugin.mjs`.
+module.exports = { splitTitleDescription, normalizeStatus, buildTodoItems };

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

@@ -0,0 +1,138 @@
+/**
+ * cliExec.mjs — 给 slash command handler 提供"真起子进程跑 CLI"能力。
+ *
+ * 跟 usageProbe.mjs(PTY 抓 TUI ANSI)区别:
+ *   - 这里跑的是 codex/claude 的**非交互子命令**(codex mcp list / claude --version 等),
+ *     stdout 是纯文本不需要剥 ANSI。
+ *   - 如果一条命令同时有 TUI 版和 subcommand 版, 优先用 subcommand(更可靠)。
+ *
+ * 失败处理:
+ *   - 超时 / 非 0 退出 / 找不到 binary → 抛错(由调用方 fallback 到 synth)
+ *   - 输出空 → 返回空字符串(调用方判)
+ */
+
+import { execFile } from "node:child_process";
+
+/**
+ * 跑一条 CLI 子命令, 返回 stdout 字符串(已 trim)。
+ *
+ * @param {string} bin  binary 名(claude / codex)
+ * @param {string[]} args
+ * @param {{ timeoutMs?: number, cwd?: string, env?: Record<string,string>, maxBuffer?: number }} [opts]
+ * @returns {Promise<string>} stdout(trim 后)
+ */
+export function execCli(bin, args, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? 5000;
+  const maxBuffer = opts.maxBuffer ?? 1024 * 1024;
+  return new Promise((resolve, reject) => {
+    execFile(
+      bin,
+      args,
+      {
+        timeout: timeoutMs,
+        cwd: opts.cwd,
+        env: opts.env || process.env,
+        encoding: "utf8",
+        maxBuffer,
+      },
+      (err, stdout, stderr) => {
+        if (err) {
+          err.stdout = stdout || "";
+          err.stderr = stderr || "";
+          reject(err);
+          return;
+        }
+        resolve((stdout || "").trim());
+      },
+    );
+  });
+}
+
+/**
+ * 安全版本: 失败时返回 null, 不抛, 调用方便于走 fallback。
+ *
+ * @returns {Promise<string|null>}
+ */
+export async function execCliSafe(bin, args, opts = {}) {
+  try {
+    const out = await execCli(bin, args, opts);
+    return out || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 探 claude 的 `system/init` JSON 行(stream-json 模式第一行总是这个),
+ * 里面含 model / claude_code_version / permissionMode / output_style / cwd /
+ * slash_commands / agents / skills / mcp_servers 等全部活体状态。
+ *
+ * 实现: 用 child_process.spawn 起 `claude --print --verbose --output-format
+ * stream-json --input-format stream-json` 并往 stdin 写一条 `/model`(claude
+ * 在 synthetic 模式秒级回复, 不调 LLM), 然后读 stdout 第一行(system/init),
+ * kill 进程, 返回解析后的对象。
+ *
+ * @param {{ cwd?: string, timeoutMs?: number }} [opts]
+ * @returns {Promise<object|null>} 解析后的 system/init payload, 失败 null
+ */
+import { spawn } from "node:child_process";
+export async function probeClaudeSystemInit({ cwd, timeoutMs = 6000 } = {}) {
+  return new Promise((resolve) => {
+    let child;
+    try {
+      child = spawn(
+        "claude",
+        [
+          "--print",
+          "--verbose",
+          "--output-format", "stream-json",
+          "--input-format", "stream-json",
+        ],
+        { cwd, stdio: ["pipe", "pipe", "pipe"] },
+      );
+    } catch {
+      resolve(null);
+      return;
+    }
+    let buf = "";
+    let settled = false;
+    const finish = (val) => {
+      if (settled) return;
+      settled = true;
+      try { child.kill("SIGTERM"); } catch {}
+      resolve(val);
+    };
+    const killTimer = setTimeout(() => finish(null), timeoutMs);
+    killTimer.unref?.();
+    child.stdout.on("data", (chunk) => {
+      buf += chunk.toString("utf8");
+      const nl = buf.indexOf("\n");
+      if (nl < 0) return;
+      const line = buf.slice(0, nl).trim();
+      buf = buf.slice(nl + 1);
+      if (!line) return;
+      try {
+        const obj = JSON.parse(line);
+        if (obj?.type === "system" && obj?.subtype === "init") {
+          clearTimeout(killTimer);
+          finish(obj);
+        }
+      } catch { /* not JSON yet */ }
+    });
+    child.on("error", () => { clearTimeout(killTimer); finish(null); });
+    child.on("exit", () => { clearTimeout(killTimer); finish(null); });
+    // 写一条最便宜的 user 消息触发 init 输出。/model 在 synthetic 模式秒级返回。
+    try {
+      child.stdin.write(
+        JSON.stringify({
+          type: "user",
+          message: { role: "user", content: [{ type: "text", text: "/model" }] },
+        }) + "\n",
+      );
+      child.stdin.end();
+    } catch {
+      clearTimeout(killTimer);
+      finish(null);
+    }
+  });
+}

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

@@ -0,0 +1,120 @@
+/**
+ * cosTextRefs.mjs — 消息正文中 agentlink-cos:// 图片引用的解析。
+ *
+ * P0「读取笔记内图片失败」：App 发送带图片的笔记附件时，正文 markdown 形如
+ *   ![](agentlink-cos://uploads/images/<uid>/2026/06/09/<hash>.jpg)
+ * relay 的 ResolveRelayObjectBlocks 只处理 blocks 数组里的 relay_object，
+ * 正文文本中的 COS 引用原样到达 runtime —— fetch("agentlink-cos://...")
+ * 必然失败，模型只能回复「图片内容没有加载出来」。
+ *
+ * 本模块在 unified dispatch 派发前：
+ *   1. 提取正文中的 agentlink-cos:// 图片引用（markdown image 语法 + 裸引用）
+ *   2. 对每个唯一 objectKey 调 sign-get 换临时 GET URL
+ *   3. 合成 { type:"image", source:{ kind:"url", url, attachment_kind:"image" } }
+ *      block 追加进 blocks（与 relay resolver 产物同构，各 runtime 现有
+ *      relayObjectToBlock 管线直接消费）
+ *   4. 正文中的引用替换为 [图片附件: <文件名>]，避免 LLM 对着死链接发挥
+ *
+ * 仅处理图片扩展名；其余引用保持原样（文档/文件附件走 App 的 relay_object
+ * blocks 路径，不在此处兜底）。sign-get 失败时正文保持原样、只记日志——
+ * 宁可模型看到原始引用，也不丢上下文。
+ */
+
+const IMAGE_EXTS = new Set(["jpg", "jpeg", "png", "gif", "webp", "bmp", "heic", "heif"]);
+
+const EXT_TO_MIME = Object.freeze({
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  png: "image/png",
+  gif: "image/gif",
+  webp: "image/webp",
+  bmp: "image/bmp",
+  heic: "image/heic",
+  heif: "image/heif",
+});
+
+// markdown 图片语法（捕获整段 + objectKey），或裸 agentlink-cos:// 引用
+const MD_IMAGE_RE = /!\[[^\]]*\]\(\s*agentlink-cos:\/\/([^\s)]+)\s*\)/g;
+const BARE_RE = /agentlink-cos:\/\/([^\s)"'<>\]]+)/g;
+
+/**
+ * 提取正文中所有 agentlink-cos:// 图片引用的 objectKey（去重，保序）。
+ * @param {string} text
+ * @returns {string[]}
+ */
+export function extractCosImageKeys(text) {
+  if (typeof text !== "string" || !text.includes("agentlink-cos://")) return [];
+  const keys = [];
+  const seen = new Set();
+  for (const re of [MD_IMAGE_RE, BARE_RE]) {
+    re.lastIndex = 0;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      const key = m[1];
+      const ext = (key.split(".").pop() || "").toLowerCase();
+      if (!IMAGE_EXTS.has(ext)) continue;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      keys.push(key);
+    }
+  }
+  return keys;
+}
+
+/**
+ * 解析 dispatch input 中的 COS 图片引用。
+ *
+ * @param {{
+ *   input: string,
+ *   blocks: Array<object>,
+ *   signGet: (cosObjectKey: string) => Promise<{ getUrl: string }>,
+ *   log?: object,
+ * }} opts
+ * @returns {Promise<{ input: string, blocks: Array<object>, resolved: number }>}
+ */
+export async function resolveCosImageRefs({ input, blocks = [], signGet, log }) {
+  const keys = extractCosImageKeys(input);
+  if (keys.length === 0 || typeof signGet !== "function") {
+    return { input, blocks, resolved: 0 };
+  }
+
+  let nextInput = input;
+  const nextBlocks = [...blocks];
+  let resolved = 0;
+
+  for (const key of keys) {
+    let getUrl;
+    try {
+      ({ getUrl } = await signGet(key));
+    } catch (err) {
+      log?.warn?.("cos_refs.sign_get_failed", "sign-get for inline cos ref failed", {
+        cosObjectKey: key, err: err?.message || String(err),
+      });
+      continue; // 失败保持原文
+    }
+    const name = key.split("/").pop() || "image";
+    const ext = (name.split(".").pop() || "").toLowerCase();
+    nextBlocks.push({
+      type: "image",
+      name,
+      source: {
+        kind: "url",
+        url: getUrl,
+        media_type: EXT_TO_MIME[ext] || "image/jpeg",
+        attachment_kind: "image",
+      },
+    });
+    resolved += 1;
+    const placeholder = `[图片附件: ${name}]`;
+    // 先替换 markdown 图片语法，再替换裸引用
+    nextInput = nextInput
+      .replaceAll(new RegExp(`!\\[[^\\]]*\\]\\(\\s*agentlink-cos://${escapeRe(key)}\\s*\\)`, "g"), placeholder)
+      .replaceAll(`agentlink-cos://${key}`, placeholder);
+  }
+
+  return { input: nextInput, blocks: nextBlocks, resolved };
+}
+
+function escapeRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

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

@@ -0,0 +1,52 @@
+/**
+ * fetchAndBase64Encode.mjs — 共享工具函数
+ *
+ * claude 和 hermes runtime 均需在 bridge 侧将 COS 签名 URL 下载并 base64 编码，
+ * 在签名有效期内固化字节，彻底规避 LLM 异步 fetch 时 TTL 过期导致的幻觉问题。
+ *
+ * spec ref: openspec/changes/openclaw-multimodal-image-passthrough design.md D-attach-C
+ *
+ * @param {string} url - 要下载的 URL（支持 COS 签名 URL）
+ * @param {{ expectedMime?: string, sizeCapBytes?: number }} opts
+ * @returns {Promise<{ base64: string, mediaType: string, bytes: number }>}
+ *   base64 为纯 base64 字符串（无 data: URI 前缀）
+ * @throws {Error} 下载失败、非 2xx、超过 sizeCapBytes 时抛出（调用方捕获后降级为占位 text block）
+ */
+export async function fetchAndBase64Encode(url, { expectedMime, sizeCapBytes = 10 * 1024 * 1024 } = {}) {
+  const res = await fetch(url);
+
+  if (!res.ok) {
+    throw new Error(`HTTP ${res.status} ${res.statusText}`);
+  }
+
+  // 从响应 Content-Type 解析 mediaType（去掉 charset 等参数）
+  const contentType = res.headers.get("content-type") ?? "";
+  const mediaType = contentType
+    ? contentType.split(";")[0].trim()
+    : (expectedMime ?? "application/octet-stream");
+
+  // Content-Length 提前检查（如果 header 存在）
+  const contentLength = res.headers.get("content-length");
+  if (contentLength !== null) {
+    const len = parseInt(contentLength, 10);
+    if (!isNaN(len) && len > sizeCapBytes) {
+      throw new Error(
+        `file size ${len} bytes exceeds limit of ${sizeCapBytes} bytes (content-length check)`
+      );
+    }
+  }
+
+  // 收集字节
+  const arrayBuffer = await res.arrayBuffer();
+  const bytes = arrayBuffer.byteLength;
+
+  if (bytes > sizeCapBytes) {
+    throw new Error(
+      `file size ${bytes} bytes exceeds limit of ${sizeCapBytes} bytes`
+    );
+  }
+
+  const base64 = Buffer.from(arrayBuffer).toString("base64");
+
+  return { base64, mediaType, bytes };
+}