@glodon-aiot/bot-client-sdk 3.26.0-alpha.4 → 3.26.0-alpha.5

package/dist/es/builtinTools/schemas.mjs

@@ -0,0 +1,216 @@
+import { MAX_COMMAND_CHARS as s, MAX_WRITE_BYTES as n, BUILTIN_FUNCTION_CODES as r } from "./constants.mjs";
+const e = (i) => ({
+  type: "string",
+  minLength: 1,
+  description: i
+}), t = "必填。工作区内绝对路径，以 / 开头，例如 /说明.md。不要使用 /input、/output、/uploads、/tmp，也不要新建这些目录。", o = {
+  shell: {
+    functionCode: "shell",
+    name: "执行命令",
+    description: "在当前会话工作区中执行一条 shell 命令并返回标准输出。每次调用都是新的 shell，只保留上次停留的目录；环境变量不会保留，需要时在同一条命令里设置。当前目录是工作区根目录。用相对路径，或以 / 开头表示工作区内已有的路径，例如 notes/a.md、/说明.md。不要使用或新建 input、output、uploads、tmp。/dev、/usr、/bin 仍是系统路径。写进脚本文件里的路径要用相对路径（见 run_file）。超过 20000 字的脚本请用 write_file 写到工作区文件后再调用 run_file；读取文件正文或结构摘要请用 read_file 的 start_line 和 end_line，不要用 cat、sed 或 head 把大文件正文打到标准输出。",
+    parameters: {
+      type: "object",
+      required: ["command"],
+      properties: {
+        command: {
+          type: "string",
+          minLength: 1,
+          maxLength: s,
+          description: "必填。一条不超过 20000 字的 shell 命令。当前目录已是工作区根目录。可以包含短的 python 或 heredoc。读取文件正文请改用 read_file。"
+        }
+      }
+    }
+  },
+  read_file: {
+    functionCode: "read_file",
+    name: "读取文件",
+    description: "按绝对路径读取工作区内的文本文件并返回内容；读不到时返回失败原因。未超过上限的文本按原文返回；超过单次读取上限的结构化文本（JSON/XML/SVG/CSV/TSV）会先附带通用结构概览和短预览，需要特定片段时再用 start_line 和 end_line。PDF 和图片只返回文件摘要，不返回正文。",
+    parameters: {
+      type: "object",
+      required: ["path"],
+      properties: {
+        path: e(t),
+        start_line: {
+          type: "integer",
+          minimum: 1,
+          description: "可选。起始行号，从 1 开始，含本行。省略则从第 1 行读。"
+        },
+        end_line: {
+          type: "integer",
+          minimum: 1,
+          description: "可选。结束行号，从 1 开始，含本行。省略则读到文件末尾。"
+        }
+      }
+    }
+  },
+  write_file: {
+    functionCode: "write_file",
+    name: "写入文件",
+    description: `把文本写入工作区内文件，path 为工作区内绝对路径，文件已存在时覆盖。单次覆盖写入按 UTF-8 字节计，默认不超过 ${n} 字节。超限时先写一段，再用 edit_file 修改，或用 append_file 追加下一段。SVG 和整页 HTML 由工作区里的脚本生成，不要直接放进 content。`,
+    parameters: {
+      type: "object",
+      required: ["path", "content"],
+      properties: {
+        path: e(t),
+        content: {
+          type: "string",
+          description: `必填。覆盖写入的文本，UTF-8 不超过 ${n} 字节。不要放入 SVG 或整页 HTML。`
+        }
+      }
+    }
+  },
+  append_file: {
+    functionCode: "append_file",
+    name: "追加文件",
+    description: "把一段文本追加到工作区内文件末尾，path 为工作区内绝对路径，文件不存在时创建。覆盖写入超过字节上限时，用本工具把下一段接到同一文件。追加不设字节上限，但不要在一次调用里放入整份 HTML 或 SVG。",
+    parameters: {
+      type: "object",
+      required: ["path", "content"],
+      properties: {
+        path: e(t),
+        content: {
+          type: "string",
+          description: "必填。要追加到文件末尾的文本。不受覆盖写入的字节上限约束。"
+        }
+      }
+    }
+  },
+  run_file: {
+    functionCode: "run_file",
+    name: "执行文件",
+    description: "执行工作区里已经存在的 .py、.sh 或 .js 脚本文件。生成 SVG、HTML、JSON 等产物时优先使用：先用 write_file 写脚本，脚本自行读取工作区文件并写出产物，再调用本工具。脚本运行时当前目录是工作区根目录，脚本里访问工作区文件要写相对路径，例如 data.json、notes/a.py。不要使用或新建 input、output、uploads、tmp。需要查看文件正文时用 read_file，不要把整份文件打印到标准输出。",
+    parameters: {
+      type: "object",
+      required: ["path"],
+      properties: {
+        path: e("必填。要执行的 .py、.sh 或 .js 文件，工作区内绝对路径，例如 /scripts/gen.py。")
+      }
+    }
+  },
+  edit_file: {
+    functionCode: "edit_file",
+    name: "修改文件",
+    description: "把工作区内文本文件中第一处与 old_text 完全相同的内容替换为 new_text。找不到 old_text 时返回最接近片段的行号，可直接复制原文重试，不必再读全文。old_text 与 new_text 不设长度上限。",
+    parameters: {
+      type: "object",
+      required: ["path", "old_text", "new_text"],
+      properties: {
+        path: e(t),
+        old_text: {
+          type: "string",
+          minLength: 1,
+          description: "必填。文件中要被替换的原文，必须完全一致。"
+        },
+        new_text: {
+          type: "string",
+          description: "必填。替换后的文本。可以是一整段生成逻辑，不必拆成追加。"
+        }
+      }
+    }
+  },
+  grep: {
+    functionCode: "grep",
+    name: "搜索文件",
+    description: "在工作区目录中递归搜索文本，返回带行号的匹配行。path 为工作区内绝对路径，pattern 按 grep 基本正则匹配。用于定位内容，不要用来取回大文件全文。",
+    parameters: {
+      type: "object",
+      required: ["path", "pattern"],
+      properties: {
+        path: e(t),
+        pattern: {
+          type: "string",
+          minLength: 1,
+          description: "必填。grep 基本正则表达式。"
+        }
+      }
+    }
+  },
+  find: {
+    functionCode: "find",
+    name: "查找文件",
+    description: "按文件名通配在工作区目录中查找文件。path 为起始绝对路径，name 传给 find 的 -name，例如 *.html。",
+    parameters: {
+      type: "object",
+      required: ["path", "name"],
+      properties: {
+        path: e(t),
+        name: {
+          type: "string",
+          minLength: 1,
+          description: "必填。find -name 通配，例如 *.svg 或 *.html。"
+        }
+      }
+    }
+  },
+  load_skill: {
+    functionCode: "load_skill",
+    name: "加载技能",
+    description: "按技能名称加载指定技能的完整说明（SKILL.md）。",
+    parameters: {
+      type: "object",
+      required: ["skill_name"],
+      properties: {
+        skill_name: {
+          type: "string",
+          minLength: 1,
+          description: "必填。要加载的技能名称。"
+        }
+      }
+    }
+  },
+  read_skill_resource: {
+    functionCode: "read_skill_resource",
+    name: "读取技能资源",
+    description: "读取与指定技能关联的资源文件，例如参考资料、模板或附加说明。",
+    parameters: {
+      type: "object",
+      required: ["skill_name", "resource_name"],
+      properties: {
+        skill_name: {
+          type: "string",
+          minLength: 1,
+          description: "必填。技能名称。"
+        },
+        resource_name: {
+          type: "string",
+          minLength: 1,
+          description: "必填。要读取的技能资源相对路径名称。"
+        }
+      }
+    }
+  },
+  run_skill_script: {
+    functionCode: "run_skill_script",
+    name: "运行技能脚本",
+    description: "在当前会话工作区中执行与指定技能关联的脚本并返回输出。脚本运行时当前目录是工作区根目录，参数里的文件路径按相对工作区根目录传，例如 docs/a.docx。",
+    parameters: {
+      type: "object",
+      required: ["skill_name", "script_name"],
+      properties: {
+        skill_name: {
+          type: "string",
+          minLength: 1,
+          description: "必填。技能名称。"
+        },
+        script_name: {
+          type: "string",
+          minLength: 1,
+          description: "必填。要运行的技能脚本相对路径（保持技能说明中列出的目录前缀，如 scripts/run.py）。"
+        },
+        args: {
+          type: "array",
+          description: '传递给脚本的命令行位置参数数组，例如 ["input.docx", "--output", "result.idx"]。',
+          items: {
+            type: "string",
+            description: "单个脚本参数。"
+          }
+        }
+      }
+    }
+  }
+}, p = Object.keys(o);
+if (p.length !== r.length || r.some((i) => !p.includes(i)))
+  throw new Error("BUILTIN_TOOL_SCHEMAS 与 BUILTIN_FUNCTION_CODES 不一致");
+export {
+  o as BUILTIN_TOOL_SCHEMAS
+};

package/dist/es/builtinTools/tools.mjs

@@ -0,0 +1,471 @@
+var l = (t, n, e) => new Promise((r, o) => {
+  var c = (a) => {
+    try {
+      s(e.next(a));
+    } catch (f) {
+      o(f);
+    }
+  }, i = (a) => {
+    try {
+      s(e.throw(a));
+    } catch (f) {
+      o(f);
+    }
+  }, s = (a) => a.done ? r(a.value) : Promise.resolve(a.value).then(c, i);
+  s((e = e.apply(t, n)).next());
+});
+import { throwIfAborted as x, ToolError as d, ToolCode as u } from "../localFiles/errors.mjs";
+import { looksBinary as g, utf8ByteLength as v, readBytes as j } from "../localFiles/tools/runtime.mjs";
+import { MAX_READ_BYTES as _, MAX_WRITE_BYTES as k, RUNNABLE_EXTENSIONS as A, SHELL_CWD as U } from "./constants.mjs";
+import { isImagePath as M, isPdf as I, isStructuredPath as z, structureOverview as W, extensionOf as X } from "./overview.mjs";
+import { resolveFilePath as m, resolveRunPath as Y, mentionsSyntheticDir as C, SYNTHETIC_DIR_MESSAGE as H, isSafeCwd as G, skillRelative as $, toVirtualPath as B } from "./paths.mjs";
+function E(t) {
+  return !!t && typeof t == "object" && t.name === "NotFoundError";
+}
+function p(t) {
+  try {
+    return new TextDecoder("utf-8", {
+      fatal: !0
+    }).decode(t);
+  } catch (n) {
+    throw new d(u.BadRequest, "文件不是 UTF-8 文本。");
+  }
+}
+function T(t) {
+  return t === "" ? [] : (t.endsWith(`
+`) ? t.slice(0, -1) : t).split(`
+`);
+}
+function K(t, n, e) {
+  if (n !== void 0 && e !== void 0 && e < n)
+    throw new d(u.BadRequest, "end_line 不能小于 start_line。");
+  const r = T(t), o = Math.max((n != null ? n : 1) - 1, 0), c = e != null ? e : r.length;
+  return r.slice(o, c).join(`
+`);
+}
+function q(t) {
+  if (v(t) <= _)
+    return {
+      text: t,
+      truncated: !1
+    };
+  const n = new TextEncoder().encode(t);
+  let e = _;
+  for (; e > 0 && (n[e] & 192) === 128; )
+    e -= 1;
+  const r = new TextDecoder().decode(n.slice(0, e)), o = r.lastIndexOf(`
+`);
+  return {
+    text: o > 0 ? r.slice(0, o) : r,
+    truncated: !0
+  };
+}
+function y(t, n) {
+  return l(this, null, function* () {
+    const e = yield t.stat(n);
+    if (e.kind !== "file")
+      throw new d(u.BadRequest, "目标是目录，不是文件。");
+    const r = yield j(yield t.readFile(n));
+    return {
+      entry: e,
+      bytes: r
+    };
+  });
+}
+function L(t, n, e) {
+  const r = typeof e == "number" ? `${e} 字节，` : "";
+  return `${t}，${r}路径 ${B(n)}。不返回正文。`;
+}
+function S(t) {
+  const n = X(t);
+  if (!A.includes(n))
+    throw new d(u.BadRequest, "只能执行 .py、.sh 或 .js 文件。");
+  return n === ".py" ? "python3" : n === ".js" ? "node" : "sh";
+}
+function N(t) {
+  if (!t.runner)
+    throw new d(u.NotImplemented, "当前环境不能执行命令或脚本，需要端侧宿主。");
+  return t.runner;
+}
+function b(t, n, e, r) {
+  return l(this, null, function* () {
+    yield t.writeFile(n, e, {
+      createDirectories: !0,
+      signal: r
+    });
+  });
+}
+function at(t, n) {
+  return l(this, null, function* () {
+    const e = m(t.path);
+    if (x(n.signal), M(e)) {
+      const a = yield n.adapter.stat(e);
+      if (a.kind !== "file")
+        throw new d(u.BadRequest, "目标是目录，不是文件。");
+      return {
+        data: {
+          content: L("图片", e, a.size),
+          truncated: !1
+        }
+      };
+    }
+    const {
+      entry: r,
+      bytes: o
+    } = yield y(n.adapter, e);
+    if (I(e, o))
+      return {
+        data: {
+          content: L("PDF", e, r.size),
+          truncated: !1
+        }
+      };
+    if (g(o))
+      throw new d(u.BadRequest, "文件不是文本，无法读取正文。");
+    const c = p(o);
+    if (t.start_line !== void 0 || t.end_line !== void 0) {
+      const a = K(c, t.start_line, t.end_line), f = q(a);
+      return {
+        data: {
+          content: f.text,
+          truncated: f.truncated
+        }
+      };
+    }
+    if (o.byteLength > _ && z(e))
+      return {
+        data: {
+          content: W(e, c),
+          truncated: !0
+        }
+      };
+    const s = q(c);
+    return {
+      data: {
+        content: s.text,
+        truncated: s.truncated
+      }
+    };
+  });
+}
+function it(t, n) {
+  return l(this, null, function* () {
+    const e = m(t.path);
+    if (v(t.content) > k)
+      throw new d(u.TooLarge, `content 按 UTF-8 计超过 ${k} 字节。请缩短后写入，或改用 append_file、edit_file。`);
+    return x(n.signal), yield b(n.adapter, e, t.content, n.signal), {
+      data: {}
+    };
+  });
+}
+function lt(t, n) {
+  return l(this, null, function* () {
+    const e = m(t.path);
+    x(n.signal);
+    let r = "";
+    try {
+      const {
+        bytes: o
+      } = yield y(n.adapter, e);
+      if (g(o))
+        throw new d(u.BadRequest, "文件不是文本，无法追加。");
+      r = p(o);
+    } catch (o) {
+      if (!E(o))
+        throw o;
+    }
+    return yield b(n.adapter, e, r + t.content, n.signal), {
+      data: {}
+    };
+  });
+}
+function dt(t, n) {
+  return l(this, null, function* () {
+    const e = m(t.path);
+    x(n.signal);
+    const {
+      bytes: r
+    } = yield y(n.adapter, e);
+    if (g(r))
+      throw new d(u.BadRequest, "文件不是文本，无法修改。");
+    const o = p(r), c = o.indexOf(t.old_text);
+    if (c < 0) {
+      const s = V(o, t.old_text);
+      throw new d(u.BadRequest, `找不到与 old_text 完全相同的内容。最接近的原文从第 ${s.line} 行开始，可复制后重试：
+${s.excerpt}`, {
+        line: s.line,
+        excerpt: s.excerpt
+      });
+    }
+    const i = o.slice(0, c) + t.new_text + o.slice(c + t.old_text.length);
+    return yield b(n.adapter, e, i, n.signal), {
+      data: {}
+    };
+  });
+}
+function V(t, n) {
+  var a;
+  const e = T(t);
+  if (e.length === 0)
+    return {
+      line: 1,
+      excerpt: ""
+    };
+  const r = n.split(`
+`), o = ((a = r[0]) != null ? a : "").slice(0, 200);
+  let c = 0, i = -1;
+  for (let f = 0; f < e.length; f += 1) {
+    const w = J(e[f], o);
+    w > i && (i = w, c = f);
+  }
+  const s = Math.min(Math.max(r.length, 1), 8);
+  return {
+    line: c + 1,
+    excerpt: e.slice(c, c + s).join(`
+`)
+  };
+}
+function J(t, n) {
+  if (!n)
+    return 0;
+  const e = t.toLowerCase(), r = n.toLowerCase();
+  let o = 0, c = 0;
+  for (const i of e)
+    c < r.length && i === r[c] && (o += 1, c += 1);
+  return o;
+}
+function Q(t) {
+  let n = "";
+  for (let e = 0; e < t.length; e += 1) {
+    const r = t[e];
+    if (r === "\\") {
+      const o = t[e + 1];
+      if (o === void 0) {
+        n += "\\\\";
+        continue;
+      }
+      e += 1, n += "+?|{}()".includes(o) ? `\\${o}` : o === "n" ? "\\n" : o === "t" ? "\\t" : R(o);
+      continue;
+    }
+    if ("+?|{}()".includes(r)) {
+      n += `\\${r}`;
+      continue;
+    }
+    if (r === "[") {
+      const o = t.indexOf("]", e + 1);
+      if (o < 0) {
+        n += "\\[";
+        continue;
+      }
+      n += t.slice(e, o + 1), e = o;
+      continue;
+    }
+    n += ".^$*".includes(r) ? r : R(r);
+  }
+  return new RegExp(n);
+}
+function R(t) {
+  return /[\\^$.*+?()[\]{}|]/.test(t) ? `\\${t}` : t;
+}
+function Z(t) {
+  try {
+    return Q(t);
+  } catch (n) {
+    throw new d(u.BadRequest, "pattern 不是合法的 grep 基本正则。");
+  }
+}
+function F(t, n, e, r, o) {
+  return l(this, null, function* () {
+    if (r > 16)
+      return;
+    x(e);
+    const c = yield t.stat(n);
+    if (yield o(n, c.kind), c.kind !== "directory")
+      return;
+    const i = yield t.listEntries(n, e);
+    i.sort((s, a) => s.name < a.name ? -1 : s.name > a.name ? 1 : 0);
+    for (const s of i) {
+      const a = n ? `${n}/${s.name}` : s.name;
+      yield F(t, a, e, r + 1, o);
+    }
+  });
+}
+function ut(t, n) {
+  return l(this, null, function* () {
+    const e = m(t.path), r = Z(t.pattern), o = [];
+    yield F(n.adapter, e, n.signal, 0, (i, s) => l(this, null, function* () {
+      if (s !== "file" || o.length >= 200)
+        return;
+      const {
+        bytes: a
+      } = yield y(n.adapter, i);
+      if (g(a) || M(i) || I(i, a))
+        return;
+      let f;
+      try {
+        f = p(a);
+      } catch (h) {
+        return;
+      }
+      const w = T(f);
+      for (let h = 0; h < w.length && o.length < 200; h += 1) {
+        if (!r.test(w[h]))
+          continue;
+        const D = w[h].length > 500 ? `${w[h].slice(0, 500)}…` : w[h];
+        o.push(`${B(i)}:${h + 1}:${D}`);
+      }
+    }));
+    const c = o.join(`
+`);
+    return {
+      data: {
+        matches: o.length >= 200 ? `${c}
+（匹配过多，已截断）` : c
+      }
+    };
+  });
+}
+function tt(t, n) {
+  let e = "^";
+  for (let r = 0; r < t.length; r += 1) {
+    const o = t[r];
+    if (o === "*")
+      e += ".*";
+    else if (o === "?")
+      e += ".";
+    else if (o === "[") {
+      const c = t.indexOf("]", r + 1);
+      c < 0 ? e += "\\[" : (e += t.slice(r, c + 1), r = c);
+    } else
+      e += R(o);
+  }
+  return new RegExp(`${e}$`).test(n);
+}
+function ft(t, n) {
+  return l(this, null, function* () {
+    const e = m(t.path), r = [];
+    yield F(n.adapter, e, n.signal, 0, (c) => l(this, null, function* () {
+      var s;
+      if (r.length >= 500)
+        return;
+      const i = (s = c.split("/").pop()) != null ? s : c;
+      tt(t.name, i) && r.push(B(c));
+    })), r.sort();
+    const o = r.join(`
+`);
+    return {
+      data: {
+        files: r.length >= 500 ? `${o}
+（结果过多，已截断）` : o
+      }
+    };
+  });
+}
+function O(t, n, e) {
+  return l(this, null, function* () {
+    const r = N(e);
+    yield y(e.adapter, t);
+    const o = yield r.exec({
+      argv: [S(t), t, ...n],
+      cwd: U,
+      timeoutMs: e.timeoutMs,
+      signal: e.signal
+    });
+    return {
+      data: {
+        exitCode: o.exitCode,
+        stdout: o.stdout,
+        stderr: o.stderr
+      }
+    };
+  });
+}
+function wt(t, n) {
+  return l(this, null, function* () {
+    const e = Y(t.path);
+    return S(e), O(e, [], n);
+  });
+}
+function ht(t, n) {
+  return l(this, null, function* () {
+    if (C(t.command) || C(n.shellCwd.cwd))
+      return {
+        data: {
+          exitCode: 1,
+          stdout: "",
+          stderr: `${H}
+`
+        }
+      };
+    const r = yield N(n).exec({
+      command: t.command,
+      cwd: n.shellCwd.cwd,
+      timeoutMs: n.timeoutMs,
+      signal: n.signal
+    });
+    return r.cwd && G(r.cwd) && (n.shellCwd.cwd = r.cwd), {
+      data: {
+        exitCode: r.exitCode,
+        stdout: r.stdout,
+        stderr: r.stderr
+      }
+    };
+  });
+}
+function P(t, n) {
+  return l(this, null, function* () {
+    try {
+      const {
+        bytes: e
+      } = yield y(n.adapter, t);
+      if (g(e))
+        throw new d(u.BadRequest, "技能资源不是文本。");
+      return p(e);
+    } catch (e) {
+      throw E(e) ? new d(u.NotFound, "技能或资源不存在。") : e;
+    }
+  });
+}
+function mt(t, n) {
+  return l(this, null, function* () {
+    return {
+      data: {
+        content: yield P($(t.skill_name, "SKILL.md"), n)
+      }
+    };
+  });
+}
+function yt(t, n) {
+  return l(this, null, function* () {
+    return {
+      data: {
+        content: yield P($(t.skill_name, t.resource_name), n)
+      }
+    };
+  });
+}
+function xt(t, n) {
+  return l(this, null, function* () {
+    var r;
+    const e = $(t.skill_name, t.script_name);
+    S(e);
+    try {
+      return yield O(e, (r = t.args) != null ? r : [], n);
+    } catch (o) {
+      throw E(o) ? new d(u.NotFound, "技能脚本不存在。") : o;
+    }
+  });
+}
+export {
+  lt as appendFile,
+  dt as editFile,
+  ft as find,
+  ut as grep,
+  mt as loadSkill,
+  at as readFile,
+  yt as readSkillResource,
+  wt as runFile,
+  xt as runSkillScript,
+  ht as shell,
+  it as writeFile
+};