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

package/dist/es/builtinTools/browserRuntime/pyodideWorker.mjs

@@ -0,0 +1,242 @@
+const e = `// Pyodide 专用 Worker。PythonRunner 用这份源码创建 Blob Module Worker，不经过集成方的打包器，
+// 所以这里只能写浏览器直接能跑的 JS，不能有 import/export 语句和顶层 await。
+//
+// init { indexURL, packages, runner } → ready | failed { message }
+// run { id, files, dirs, cwd, mode, target, argv, stdin } → result { id, exitCode, stdout, stderr, written, removed, createdDirs, removedDirs }
+'use strict';
+
+const ROOTS = ['/workspace'];
+const OUTPUT_LIMIT = 16 * 1024 * 1024;
+
+let pyodide = null;
+let runPython = null;
+let sink = null;
+
+/** Emscripten 的 ErrnoError 不是 Error，只带 errno 和 code。 */
+function describe(error) {
+  if (error && error.message) return error.message;
+  if (error && (error.code || error.errno !== undefined)) return \`文件系统错误 \${error.code || \`errno \${error.errno}\`}\`;
+  return String(error);
+}
+
+function networkDenied(url) {
+  return new TypeError(\`浏览器里的 Python 不能访问网络：\${url}\`);
+}
+
+/** 只放行 indexURL 下的资源（Pyodide 自身和白名单 wheel），其余请求一律拒绝。 */
+function guardNetwork(indexURL) {
+  const realFetch = globalThis.fetch ? globalThis.fetch.bind(globalThis) : null;
+  const resolve = (input) => {
+    const raw = typeof input === 'string' || input instanceof URL ? String(input) : input && input.url;
+    try {
+      return new URL(raw, indexURL).href;
+    } catch {
+      return String(raw);
+    }
+  };
+  globalThis.fetch = (input, init) => {
+    const url = resolve(input);
+    if (!realFetch || !url.startsWith(indexURL)) return Promise.reject(networkDenied(url));
+    return realFetch(input, init);
+  };
+  for (const name of ['XMLHttpRequest', 'WebSocket', 'EventSource']) {
+    globalThis[name] = class {
+      constructor(url) {
+        throw networkDenied(url === undefined ? name : resolve(url));
+      }
+    };
+  }
+}
+
+function collector() {
+  const decoder = new TextDecoder();
+  let text = '';
+  let size = 0;
+  let dropped = false;
+  return {
+    write(bytes) {
+      if (dropped || size + bytes.length > OUTPUT_LIMIT) {
+        dropped = true;
+        return;
+      }
+      size += bytes.length;
+      text += decoder.decode(bytes, { stream: true });
+    },
+    finish() {
+      return text + decoder.decode() + (dropped ? '\\n…输出超过 16 MB，后面的内容已丢弃\\n' : '');
+    },
+  };
+}
+
+async function init({ indexURL, packages, runner }) {
+  guardNetwork(indexURL);
+  const { loadPyodide } = await import(indexURL + 'pyodide.mjs');
+  pyodide = await loadPyodide({ indexURL, env: { HOME: '/home/pyodide', MPLBACKEND: 'Agg' } });
+  const stream = (name) => ({
+    write(bytes) {
+      if (sink) sink[name].write(bytes);
+      return bytes.length;
+    },
+  });
+  pyodide.setStdout(stream('stdout'));
+  pyodide.setStderr(stream('stderr'));
+  runPython = pyodide.runPython(runner, { globals: pyodide.toPy({ PACKAGES: packages }) });
+}
+
+function dirname(path) {
+  const index = path.lastIndexOf('/');
+  return index <= 0 ? '/' : path.slice(0, index);
+}
+
+/** 主脚本、\`-c\` 代码，以及主脚本目录和 cwd 下的 .py 文件里出现的 import。 */
+function sourcesToScan({ files, cwd, mode, target }) {
+  const decoder = new TextDecoder();
+  const sources = mode === 'c' ? [target] : [];
+  const dirs = new Set([cwd]);
+  if (mode === 'file') dirs.add(dirname(target));
+  for (const file of files) {
+    if (file.path.endsWith('.py') && (file.path === target || dirs.has(dirname(file.path)))) {
+      sources.push(decoder.decode(file.data));
+    }
+  }
+  return sources;
+}
+
+async function loadPackages(sources, stderr) {
+  const encoder = new TextEncoder();
+  const report = (message) => stderr.write(encoder.encode(\`\${message}\\n\`));
+  for (const source of sources) {
+    try {
+      await pyodide.loadPackagesFromImports(source, { messageCallback() {}, errorCallback: report });
+    } catch (error) {
+      report(\`加载 Python 包失败：\${describe(error)}\`);
+    }
+  }
+}
+
+function lstat(path) {
+  try {
+    return pyodide.FS.lstat(path);
+  } catch {
+    return null;
+  }
+}
+
+function removeTree(path) {
+  const { FS } = pyodide;
+  const stat = lstat(path);
+  if (!stat) return;
+  if (!FS.isDir(stat.mode)) {
+    FS.unlink(path);
+    return;
+  }
+  for (const name of FS.readdir(path)) {
+    if (name !== '.' && name !== '..') removeTree(\`\${path}/\${name}\`);
+  }
+  FS.rmdir(path);
+}
+
+function walk(path, files, dirs) {
+  const { FS } = pyodide;
+  for (const name of FS.readdir(path)) {
+    if (name === '.' || name === '..') continue;
+    const child = \`\${path}/\${name}\`;
+    const stat = lstat(child);
+    if (!stat) continue;
+    if (FS.isDir(stat.mode)) {
+      dirs.add(child);
+      walk(child, files, dirs);
+    } else if (FS.isFile(stat.mode)) {
+      files.set(child, FS.readFile(child));
+    }
+  }
+}
+
+function sameBytes(a, b) {
+  if (a.length !== b.length) return false;
+  for (let index = 0; index < a.length; index += 1) if (a[index] !== b[index]) return false;
+  return true;
+}
+
+async function execute(message) {
+  const { FS } = pyodide;
+  const output = { stdout: collector(), stderr: collector() };
+  await loadPackages(sourcesToScan(message), output.stderr);
+
+  const before = new Map();
+  const beforeDirs = new Set(ROOTS);
+  // 上次运行停在某个根目录里时，Emscripten 不允许删除当前目录。
+  FS.chdir('/');
+  for (const root of ROOTS) {
+    removeTree(root);
+    FS.mkdirTree(root);
+  }
+  for (const dir of message.dirs) {
+    FS.mkdirTree(dir);
+    beforeDirs.add(dir);
+  }
+  for (const file of message.files) {
+    FS.mkdirTree(dirname(file.path));
+    FS.writeFile(file.path, file.data);
+    before.set(file.path, file.data);
+  }
+
+  sink = output;
+  let exitCode;
+  const argv = pyodide.toPy(message.argv);
+  try {
+    exitCode = runPython(message.mode, message.target, argv, message.cwd, message.stdin);
+  } finally {
+    argv.destroy();
+    sink = null;
+  }
+
+  const after = new Map();
+  const afterDirs = new Set();
+  for (const root of ROOTS) if (lstat(root)) walk(root, after, afterDirs);
+
+  const written = [];
+  for (const [path, data] of after) {
+    const old = before.get(path);
+    if (!old || !sameBytes(old, data)) written.push({ path, data });
+  }
+  return {
+    exitCode,
+    stdout: output.stdout.finish(),
+    stderr: output.stderr.finish(),
+    written,
+    removed: [...before.keys()].filter((path) => !after.has(path)),
+    createdDirs: [...afterDirs].filter((dir) => !beforeDirs.has(dir)),
+    removedDirs: [...beforeDirs].filter((dir) => !ROOTS.includes(dir) && !afterDirs.has(dir)),
+  };
+}
+
+self.onmessage = (event) => {
+  const message = event.data;
+  if (message.type === 'init') {
+    init(message).then(
+      () => self.postMessage({ type: 'ready' }),
+      (error) => self.postMessage({ type: 'failed', message: describe(error) })
+    );
+  } else if (message.type === 'run') {
+    execute(message).then(
+      (result) => self.postMessage({ type: 'result', id: message.id, ...result }),
+      (error) =>
+        self.postMessage({
+          type: 'result',
+          id: message.id,
+          exitCode: 1,
+          stdout: '',
+          stderr: \`Python 运行环境出错：\${describe(error)}\\n\`,
+          written: [],
+          removed: [],
+          createdDirs: [],
+          removedDirs: [],
+        })
+    );
+  }
+};
+`;
+export {
+  e as default
+};

package/dist/es/builtinTools/command.mjs

@@ -0,0 +1,56 @@
+var d = Object.defineProperty, l = Object.defineProperties;
+var N = Object.getOwnPropertyDescriptors;
+var s = Object.getOwnPropertySymbols;
+var a = Object.prototype.hasOwnProperty, f = Object.prototype.propertyIsEnumerable;
+var A = (e, n, t) => n in e ? d(e, n, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[n] = t, T = (e, n) => {
+  for (var t in n || (n = {}))
+    a.call(n, t) && A(e, t, n[t]);
+  if (s)
+    for (var t of s(n))
+      f.call(n, t) && A(e, t, n[t]);
+  return e;
+}, _ = (e, n) => l(e, N(n));
+var O = (e, n, t) => new Promise((u, o) => {
+  var U = (r) => {
+    try {
+      c(t.next(r));
+    } catch (i) {
+      o(i);
+    }
+  }, C = (r) => {
+    try {
+      c(t.throw(r));
+    } catch (i) {
+      o(i);
+    }
+  }, c = (r) => r.done ? u(r.value) : Promise.resolve(r.value).then(U, C);
+  c((t = t.apply(e, n)).next());
+});
+const R = 16e3, D = `
+…输出已截断`;
+function M(e) {
+  if (e.length <= 16e3)
+    return e;
+  let n = 16e3;
+  const t = e.charCodeAt(n - 1);
+  return t >= 55296 && t <= 56319 && (n -= 1), e.slice(0, n) + D;
+}
+function h(e) {
+  return {
+    exec(t) {
+      return O(this, null, function* () {
+        const u = yield e.exec(t);
+        return _(T({}, u), {
+          stdout: M(u.stdout),
+          stderr: M(u.stderr)
+        });
+      });
+    }
+  };
+}
+export {
+  R as MAX_COMMAND_OUTPUT_CHARS,
+  D as OUTPUT_TRUNCATED_NOTE,
+  M as limitOutput,
+  h as withOutputLimit
+};

package/dist/es/builtinTools/constants.mjs

@@ -0,0 +1,10 @@
+const _ = ["shell", "read_file", "write_file", "append_file", "run_file", "edit_file", "grep", "find", "load_skill", "read_skill_resource", "run_skill_script"], e = 81920, s = 81920, l = 2e4, i = ".", n = "/workspace", o = [".py", ".sh", ".js"];
+export {
+  _ as BUILTIN_FUNCTION_CODES,
+  l as MAX_COMMAND_CHARS,
+  e as MAX_READ_BYTES,
+  s as MAX_WRITE_BYTES,
+  o as RUNNABLE_EXTENSIONS,
+  i as SHELL_CWD,
+  n as WORKSPACE_MOUNT
+};

package/dist/es/builtinTools/createBuiltinToolsPlugin.mjs

@@ -0,0 +1,236 @@
+var G = Object.defineProperty, K = Object.defineProperties;
+var W = Object.getOwnPropertyDescriptors;
+var D = Object.getOwnPropertySymbols;
+var X = Object.prototype.hasOwnProperty, Q = Object.prototype.propertyIsEnumerable;
+var P = (e, t, o) => t in e ? G(e, t, { enumerable: !0, configurable: !0, writable: !0, value: o }) : e[t] = o, s = (e, t) => {
+  for (var o in t || (t = {}))
+    X.call(t, o) && P(e, o, t[o]);
+  if (D)
+    for (var o of D(t))
+      Q.call(t, o) && P(e, o, t[o]);
+  return e;
+}, h = (e, t) => K(e, W(t));
+var U = (e, t, o) => new Promise((l, u) => {
+  var m = (n) => {
+    try {
+      d(o.next(n));
+    } catch (r) {
+      u(r);
+    }
+  }, c = (n) => {
+    try {
+      d(o.throw(n));
+    } catch (r) {
+      u(r);
+    }
+  }, d = (n) => n.done ? l(n.value) : Promise.resolve(n.value).then(m, c);
+  d((o = o.apply(e, t)).next());
+});
+import { v4 as Y } from "uuid";
+import Z from "../Logger.mjs";
+import { HostBridgeAdapter as k } from "../localFiles/adapters/HostBridgeAdapter.mjs";
+import { SANDBOX_PROTOCOL as ee } from "../localFiles/host/protocol.mjs";
+import { cancelledError as w, workspaceNotGranted as te, ToolError as f, ToolCode as a, toToolError as oe } from "../localFiles/errors.mjs";
+import { validateToolInput as ne } from "../localFiles/validate.mjs";
+import { BrowserCommandRunner as re } from "./browserRuntime/BrowserCommandRunner.mjs";
+import { withOutputLimit as E } from "./command.mjs";
+import { BUILTIN_FUNCTION_CODES as ie, SHELL_CWD as se } from "./constants.mjs";
+import { BUILTIN_TOOL_SCHEMAS as le } from "./schemas.mjs";
+import { shell as ae, readFile as de, writeFile as ce, appendFile as ue, runFile as me, editFile as fe, grep as ge, find as he, loadSkill as _e, readSkillResource as be, runSkillScript as ye } from "./tools.mjs";
+const Te = {
+  shell: ae,
+  read_file: de,
+  write_file: ce,
+  append_file: ue,
+  run_file: me,
+  edit_file: fe,
+  grep: ge,
+  find: he,
+  load_skill: _e,
+  read_skill_resource: be,
+  run_skill_script: ye
+}, T = new Z("[BuiltinTools] "), H = /* @__PURE__ */ new Set(["shell", "run_file", "run_skill_script"]);
+function we(e, t, o) {
+  var l, u;
+  if (e.commandRunner)
+    return E(e.commandRunner);
+  if (t instanceof k && t.capabilities.has("sandbox-exec")) {
+    if (t.canExec)
+      return E({
+        exec: (c) => t.exec(c)
+      });
+    const m = `${(l = t.sandboxVersion) != null ? l : ""}@${(u = t.sandboxProtocol) != null ? u : ""}`;
+    o.rejectedSandbox !== m && (o.rejectedSandbox = m, T.error("sandbox-protocol", {
+      sandboxVersion: t.sandboxVersion,
+      sandboxProtocol: t.sandboxProtocol,
+      supported: ee
+    }));
+  }
+  if (e.browserRuntime.enabled)
+    return (o.adapter !== t || !o.runner) && (o.adapter = t, o.runner = E(new re({
+      adapter: t,
+      sensitive: e.sensitive,
+      moduleURL: e.browserRuntime.bashModuleURL,
+      pyodideIndexURL: e.browserRuntime.pyodideIndexURL
+    }))), o.runner;
+}
+function pe(e) {
+  if (typeof e != "string")
+    return e;
+  try {
+    return JSON.parse(e);
+  } catch (t) {
+    throw new f(a.BadRequest, "参数不是合法的 JSON 对象。");
+  }
+}
+function xe(e) {
+  const t = e instanceof DOMException ? e.name : "", o = e instanceof Error ? e.message : "";
+  if (t === "NotFoundError")
+    return new f(a.NotFound, "脚本或目录不存在。");
+  if (t === "SecurityError")
+    return new f(a.Forbidden, "命令路径不在工作区内。");
+  if (t === "AbortError")
+    return o.includes("超时") ? new f(a.Timeout, "命令运行超时，已中止。") : o.includes("已有") ? new f(a.TooManyRequests, "已有一个命令在运行。") : w();
+  if (t === "NotAllowedError")
+    return new f(a.NotImplemented, "当前环境不能执行命令或脚本，需要端侧宿主。");
+}
+function Ie(e) {
+  return new Promise((t, o) => {
+    e.aborted && o(w()), e.addEventListener("abort", () => o(w()), {
+      once: !0
+    });
+  });
+}
+function V(e, t = 160) {
+  return e.length > t ? `${e.slice(0, t)}…` : e;
+}
+function Oe(e) {
+  const t = {};
+  for (const o of ["path", "skill_name", "resource_name", "script_name", "pattern", "name"])
+    typeof e[o] == "string" && (t[o] = e[o]);
+  return typeof e.command == "string" && (t.command = V(e.command)), typeof e.start_line == "number" && (t.start_line = e.start_line), typeof e.end_line == "number" && (t.end_line = e.end_line), typeof e.content == "string" && (t.contentLength = e.content.length), typeof e.old_text == "string" && (t.oldTextLength = e.old_text.length), typeof e.new_text == "string" && (t.newTextLength = e.new_text.length), Array.isArray(e.args) && (t.argCount = e.args.length), t;
+}
+function Le(e) {
+  return s({
+    code: e.code,
+    message: e.message
+  }, e.data ? {
+    data: e.data
+  } : {});
+}
+function Ue({
+  pluginCode: e,
+  workspace: t
+}) {
+  const o = /* @__PURE__ */ new Map(), l = {}, u = {};
+  return ie.forEach((m) => {
+    u[m] = (c, d, n) => {
+      let r = !1;
+      Se(t, o, l, m, c, (S) => {
+        if (!r) {
+          r = !0;
+          try {
+            d(S);
+          } catch (x) {
+            console.error("[BuiltinTools] callback failed", x);
+          }
+        }
+      }, h(s({}, n), {
+        pluginCode: e
+      }));
+    };
+  }), {
+    [e]: u
+  };
+}
+function Se(e, t, o, l, u, m, c) {
+  return U(this, null, function* () {
+    var N, F, M, A, q;
+    const d = {
+      requestId: c.requestId || Y(),
+      applicationId: c.applicationId || e.applicationId,
+      sessionId: c.sessionId || "",
+      pluginCode: c.pluginCode,
+      functionCode: l,
+      signal: c.signal
+    }, n = {
+      requestId: d.requestId,
+      sessionId: d.sessionId,
+      functionCode: l
+    }, r = new AbortController();
+    let p = !1;
+    const S = setTimeout(() => {
+      p = !0, r.abort();
+    }, e.limits.toolTimeoutMs), x = () => r.abort();
+    (N = d.signal) == null || N.addEventListener("abort", x, {
+      once: !0
+    }), (F = d.signal) != null && F.aborted && r.abort();
+    let b = null, y = null, I;
+    const R = Date.now();
+    try {
+      const O = pe(u), i = ne(O, le[l].parameters);
+      if (typeof i.path == "string" && (n.path = i.path), T.log("start", s(s({}, n), Oe(i))), yield e.ready, r.signal.aborted)
+        throw w();
+      const _ = e.adapter;
+      if (!_)
+        throw te();
+      if (b = e.acquireSlot(), !b)
+        throw new f(a.TooManyRequests, "同时进行的文件操作过多，请稍后重试。");
+      if (H.has(l) && (y = e.acquireCommand(), !y))
+        throw new f(a.TooManyRequests, "已有一个命令在运行，请等它结束后再试。");
+      I = e.track(r), e.emit("tool:start", s({}, n));
+      const v = d.sessionId || "default";
+      let g = t.get(v);
+      g || (g = {
+        cwd: se
+      }, t.set(v, g));
+      const $ = we(e, _, o), j = g.cwd, J = {
+        adapter: _,
+        runner: $,
+        signal: r.signal,
+        timeoutMs: e.limits.toolTimeoutMs,
+        shellCwd: g
+      }, L = yield Promise.race([Te[l](i, J), Ie(r.signal)]), B = {
+        code: a.Ok,
+        message: "ok",
+        data: L.data
+      };
+      L.truncated && (B.truncated = !0);
+      const z = Date.now() - R, C = L.data.exitCode;
+      T.log("finish", s(s(s(h(s({}, n), {
+        elapsedMs: z,
+        code: a.Ok
+      }), L.truncated ? {
+        truncated: !0
+      } : {}), typeof C == "number" ? {
+        exitCode: C
+      } : {}), l === "shell" ? {
+        cwd: g.cwd,
+        cwdChanged: g.cwd !== j
+      } : {})), e.emit("tool:finish", h(s({}, n), {
+        code: a.Ok
+      })), H.has(l) && e.notifyFilesChanged(), m(B);
+    } catch (O) {
+      let i = (M = xe(O)) != null ? M : oe(O);
+      p ? i = new f(a.Timeout, "操作超时，已中止。") : r.signal.aborted && i.code !== a.Cancelled && (i = w());
+      const _ = Date.now() - R;
+      i.code === a.Cancelled ? (T.log("cancelled", h(s({}, n), {
+        elapsedMs: _,
+        timedOut: p
+      })), e.emit("tool:cancelled", s({}, n))) : (T.error("error", h(s({}, n), {
+        elapsedMs: _,
+        code: i.code,
+        message: V(i.message, 300)
+      })), e.emit("tool:error", h(s({}, n), {
+        code: i.code,
+        message: i.message,
+        reason: (A = i.data) == null ? void 0 : A.reason
+      }))), m(Le(i));
+    } finally {
+      clearTimeout(S), (q = d.signal) == null || q.removeEventListener("abort", x), b == null || b(), y == null || y(), I == null || I();
+    }
+  });
+}
+export {
+  Ue as createBuiltinToolsPlugin
+};

package/dist/es/builtinTools/overview.mjs

@@ -0,0 +1,77 @@
+function c(r) {
+  return `预览：
+${r.length > 500 ? r.slice(0, 500) : r}`;
+}
+function O(r) {
+  let n;
+  try {
+    n = JSON.parse(r);
+  } catch (e) {
+    return `JSON 无法完整解析。
+${c(r)}`;
+  }
+  if (Array.isArray(n)) {
+    const e = n[0], t = e && typeof e == "object" && !Array.isArray(e) ? `元素字段：${Object.keys(e).slice(0, 20).join(", ") || "（无）"}。` : `元素类型：${e === null ? "null" : typeof e}。`;
+    return `JSON 数组，长度 ${n.length}。${t}
+${c(r)}`;
+  }
+  if (n && typeof n == "object") {
+    const e = n, t = Object.keys(e), s = t.filter((i) => Array.isArray(e[i])).slice(0, 10).map((i) => `${i} (${e[i].length})`), o = s.length ? `数组字段：${s.join("、")}。` : "";
+    return `JSON 对象。字段：${t.slice(0, 40).join(", ") || "（无）"}。${o}
+${c(r)}`;
+  }
+  return `JSON ${n === null ? "null" : typeof n}。
+${c(r)}`;
+}
+function h(r, n) {
+  var a, p;
+  const e = r.match(/<([A-Za-z_][\w:.-]*)\b/), t = (a = e == null ? void 0 : e[1]) != null ? a : "未知", s = /* @__PURE__ */ new Map(), o = new RegExp("<([A-Za-z_][\\w:.-]*)\\b", "g");
+  let i, u = !1;
+  for (; i = o.exec(r); ) {
+    const l = i[1];
+    if (!u && l === t) {
+      u = !0;
+      continue;
+    }
+    if (s.set(l, ((p = s.get(l)) != null ? p : 0) + 1), s.size > 30)
+      break;
+  }
+  const f = Array.from(s.entries()).slice(0, 20).map(([l, v]) => `${l} (${v})`).join("、");
+  return `${n} 根元素 ${t}。直接或嵌套子元素：${f || "（无）"}。
+${c(r)}`;
+}
+function g(r, n, e) {
+  var f;
+  const t = r.split(/\r?\n/).filter((a) => a.length > 0), s = (f = t[0]) != null ? f : "", o = s ? s.split(n).length : 0, i = Math.max(t.length - 1, 0), u = t.slice(0, 4).join(`
+`);
+  return `${e}，${o} 列，数据行 ${i}。表头：${s}
+预览：
+${u}`;
+}
+function j(r) {
+  const n = $(r);
+  return n === ".json" || n === ".xml" || n === ".svg" || n === ".csv" || n === ".tsv";
+}
+function m(r, n) {
+  const e = $(r);
+  return e === ".json" ? O(n) : e === ".svg" ? h(n, "SVG") : e === ".xml" ? h(n, "XML") : e === ".tsv" ? g(n, "	", "TSV") : e === ".csv" ? g(n, ",", "CSV") : c(n);
+}
+function $(r) {
+  var t;
+  const n = (t = r.split("/").pop()) != null ? t : "", e = n.lastIndexOf(".");
+  return e >= 0 ? n.slice(e).toLowerCase() : "";
+}
+const S = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".bmp", ".ico", ".tif", ".tiff"]);
+function w(r) {
+  return S.has($(r));
+}
+function A(r, n) {
+  return $(r) === ".pdf" ? !0 : !n || n.byteLength < 4 ? !1 : n[0] === 37 && n[1] === 80 && n[2] === 68 && n[3] === 70;
+}
+export {
+  $ as extensionOf,
+  w as isImagePath,
+  A as isPdf,
+  j as isStructuredPath,
+  m as structureOverview
+};

package/dist/es/builtinTools/paths.mjs

@@ -0,0 +1,63 @@
+import { ToolError as o, ToolCode as i } from "../localFiles/errors.mjs";
+const l = ["input", "output", "uploads", "tmp"], h = "不要使用 input、output、uploads、tmp，也不要新建这些目录。请把文件直接放在工作区已有位置或根目录。", c = /(?:^|[\s'"=;|&<>`:])\/?(?:input|output|uploads|tmp)(?=\/|[\s'"=;|&<>`:]|$)/;
+function d(t) {
+  return c.test(t);
+}
+function u(t) {
+  const n = t.split("/")[0];
+  return l.includes(n);
+}
+function r(t) {
+  throw new o(i.Forbidden, t, {
+    reason: "path_outside_workspace"
+  });
+}
+function f(t) {
+  if (typeof t != "string" || t.length === 0)
+    throw new o(i.BadRequest, "path 必须是工作区内绝对路径。");
+  (t.includes("\0") || t.includes("\\")) && r("路径不能包含反斜杠。");
+  const n = t.normalize("NFC").trim();
+  if (!n.startsWith("/"))
+    throw new o(i.BadRequest, "path 必须是工作区内绝对路径，例如 /说明.md。");
+  const e = n.split("/").filter((s) => s.length > 0);
+  if (e.some((s) => s === "." || s === "..") && r("路径不能包含 . 或 .. 。"), e.length > 0 && u(e[0]))
+    throw new o(i.BadRequest, h);
+  return e.join("/");
+}
+function a(t) {
+  return f(t);
+}
+function w(t) {
+  return f(t);
+}
+function R(t) {
+  return t ? `/${t}` : "/";
+}
+function S(t) {
+  if (t === ".")
+    return !0;
+  if (!t || t.startsWith("/") || t.includes("\\") || t.includes("\0"))
+    return !1;
+  const n = t.split("/").filter((e) => e.length > 0);
+  return n.length > 0 && n.every((e) => e !== "." && e !== "..") && !u(n[0]);
+}
+function g(t, n) {
+  if (!t || /[\\/\0]/.test(t) || t === "." || t === "..")
+    throw new o(i.BadRequest, "skill_name 必须是单个技能目录名。");
+  if (!n || n.startsWith("/") || n.includes("\\") || n.includes("\0"))
+    throw new o(i.BadRequest, "资源路径必须是技能目录内的相对路径。");
+  const e = n.split("/").filter((s) => s.length > 0);
+  return (e.length === 0 || e.some((s) => s === "." || s === "..")) && r("资源路径不能跳出技能目录。"), `skills/${t}/${e.join("/")}`;
+}
+export {
+  l as SYNTHETIC_DIRS,
+  h as SYNTHETIC_DIR_MESSAGE,
+  S as isSafeCwd,
+  u as isSyntheticCwd,
+  d as mentionsSyntheticDir,
+  a as resolveFilePath,
+  w as resolveRunPath,
+  f as resolveWorkspacePath,
+  g as skillRelative,
+  R as toVirtualPath
+};