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

package/dist/es/index.mjs

@@ -1,11 +1,71 @@
-import { configuration as t, configure as r } from "./Config.mjs";
-import { default as a } from "./BotClient.mjs";
-import { default as i } from "./Session.mjs";
-import { default as l } from "./AgentPlugin.mjs";
+import { configuration as e, configure as T, getRegisteredLocalFilesPluginCode as E, getRegisteredLocalPythonPluginCode as r, resolveLocalFilesPluginCode as L } from "./Config.mjs";
+import { default as S } from "./BotClient.mjs";
+import { default as O } from "./Session.mjs";
+import { default as C } from "./AgentPlugin.mjs";
+import { ToolCode as l, ToolError as D, toToolError as R } from "./localFiles/errors.mjs";
+import { LOCAL_FILE_TOOL_SCHEMAS as a, LOCAL_PYTHON_TOOL_SCHEMA as U } from "./localFiles/schemas.mjs";
+import { BUILTIN_TOOL_SCHEMAS as M } from "./builtinTools/schemas.mjs";
+import { createLocalFilesPlugin as s } from "./localFiles/createLocalFilesPlugin.mjs";
+import { LocalWorkspace as P } from "./localFiles/workspace/LocalWorkspace.mjs";
+import { createIndexedDbStore as H, createMemoryStore as n } from "./localFiles/workspace/handleStore.mjs";
+import { FileSystemAccessAdapter as d } from "./localFiles/adapters/FileSystemAccessAdapter.mjs";
+import { MemoryWorkspaceAdapter as g } from "./localFiles/adapters/MemoryWorkspaceAdapter.mjs";
+import { createDefaultSessionFileTransfer as u } from "./localFiles/transfer/SessionFileTransfer.mjs";
+import { getDownloadUrlAllowlist as Y, isDownloadUrlAllowed as G } from "./localFiles/security/downloadUrlPolicy.mjs";
+import { SDK_SENSITIVE_BASELINE as w } from "./localFiles/security/sensitiveFiles.mjs";
+import { BINARY_SNIFF_BYTES as K, BUILTIN_TOOLS_PLUGIN_CODE as k, BUILTIN_TOOLS_PLUGIN_CODES as b, DEFAULT_DOWNLOAD_URL_ALLOWLIST as h, DEFAULT_IGNORED_DIRECTORIES as v, DEFAULT_IGNORED_FILE_PATTERNS as V, DEFAULT_LIMITS as Z, KiB as j, LIST_DIRECTORY_DEFAULT_LIMIT as q, LIST_DIRECTORY_MAX_LIMIT as z, LOCAL_FILES_FUNCTION_CODES as J, LOCAL_FILES_PLUGIN_CODES as Q, LOCAL_PYTHON_FUNCTION_CODE as $, LOCAL_PYTHON_PLUGIN_CODES as __, MiB as o_, PYTHON_DEFAULT_TIMEOUT_MS as e_, PYTHON_MAX_ARGS as T_, PYTHON_MAX_TIMEOUT_MS as E_, SEARCH_DEFAULT_DEPTH as r_, SEARCH_FUNCTION_CODES as L_, SEARCH_MAX_DEPTH as I_, TEXT_SEARCH_MAX_CONTEXT_LINES as S_, TEXT_SEARCH_MAX_FILES as A_, TEXT_SEARCH_MAX_FILE_BYTES as O_, TEXT_SEARCH_MAX_LINE_CHARS as t_, TRANSFER_FILE_SIZE_LIMIT_MB as C_, TRANSFER_FUNCTION_CODES as N_, WORKSPACE_GRANT_ID as l_, WRITE_FUNCTION_CODES as D_ } from "./localFiles/constants.mjs";
 export {
-  l as AgentPlugin,
-  a as BotClient,
-  i as Session,
-  t as configuration,
-  r as configure
+  C as AgentPlugin,
+  K as BINARY_SNIFF_BYTES,
+  k as BUILTIN_TOOLS_PLUGIN_CODE,
+  b as BUILTIN_TOOLS_PLUGIN_CODES,
+  M as BUILTIN_TOOL_SCHEMAS,
+  S as BotClient,
+  h as DEFAULT_DOWNLOAD_URL_ALLOWLIST,
+  v as DEFAULT_IGNORED_DIRECTORIES,
+  V as DEFAULT_IGNORED_FILE_PATTERNS,
+  Z as DEFAULT_LIMITS,
+  d as FileSystemAccessAdapter,
+  j as KiB,
+  q as LIST_DIRECTORY_DEFAULT_LIMIT,
+  z as LIST_DIRECTORY_MAX_LIMIT,
+  J as LOCAL_FILES_FUNCTION_CODES,
+  Q as LOCAL_FILES_PLUGIN_CODES,
+  a as LOCAL_FILE_TOOL_SCHEMAS,
+  $ as LOCAL_PYTHON_FUNCTION_CODE,
+  __ as LOCAL_PYTHON_PLUGIN_CODES,
+  U as LOCAL_PYTHON_TOOL_SCHEMA,
+  P as LocalWorkspace,
+  g as MemoryWorkspaceAdapter,
+  o_ as MiB,
+  e_ as PYTHON_DEFAULT_TIMEOUT_MS,
+  T_ as PYTHON_MAX_ARGS,
+  E_ as PYTHON_MAX_TIMEOUT_MS,
+  w as SDK_SENSITIVE_BASELINE,
+  r_ as SEARCH_DEFAULT_DEPTH,
+  L_ as SEARCH_FUNCTION_CODES,
+  I_ as SEARCH_MAX_DEPTH,
+  O as Session,
+  S_ as TEXT_SEARCH_MAX_CONTEXT_LINES,
+  A_ as TEXT_SEARCH_MAX_FILES,
+  O_ as TEXT_SEARCH_MAX_FILE_BYTES,
+  t_ as TEXT_SEARCH_MAX_LINE_CHARS,
+  C_ as TRANSFER_FILE_SIZE_LIMIT_MB,
+  N_ as TRANSFER_FUNCTION_CODES,
+  l as ToolCode,
+  D as ToolError,
+  l_ as WORKSPACE_GRANT_ID,
+  D_ as WRITE_FUNCTION_CODES,
+  e as configuration,
+  T as configure,
+  u as createDefaultSessionFileTransfer,
+  H as createIndexedDbStore,
+  s as createLocalFilesPlugin,
+  n as createMemoryStore,
+  Y as getDownloadUrlAllowlist,
+  E as getRegisteredLocalFilesPluginCode,
+  r as getRegisteredLocalPythonPluginCode,
+  G as isDownloadUrlAllowed,
+  L as resolveLocalFilesPluginCode,
+  R as toToolError
 };

package/dist/es/localFiles/adapters/FileSystemAccessAdapter.mjs

@@ -0,0 +1,264 @@
+var g = (o, t) => {
+  if (t = Symbol[o])
+    return t;
+  throw Error("Symbol." + o + " is not defined");
+};
+var y = (o, t, e) => new Promise((r, a) => {
+  var c = (i) => {
+    try {
+      l(e.next(i));
+    } catch (n) {
+      a(n);
+    }
+  }, w = (i) => {
+    try {
+      l(e.throw(i));
+    } catch (n) {
+      a(n);
+    }
+  }, l = (i) => i.done ? r(i.value) : Promise.resolve(i.value).then(c, w);
+  l((e = e.apply(o, t)).next());
+});
+var p = (o, t, e) => (t = o[g("asyncIterator")]) ? t.call(o) : (o = o[g("iterator")](), t = {}, e = (r, a) => (a = o[r]) && (t[r] = (c) => new Promise((w, l, i) => (c = a.call(o, c), i = c.done, Promise.resolve(c.value).then((n) => w({ value: n, done: i }), l)))), e("next"), e("return"), t);
+import { domError as m, toChunks as D, isSameOrInside as k } from "./WorkspaceFileAdapter.mjs";
+import { throwIfAborted as v } from "../errors.mjs";
+import { splitPath as f } from "../security/pathPolicy.mjs";
+function u(o, t) {
+  return !!o && typeof o == "object" && o.name === t;
+}
+class b {
+  constructor(t) {
+    this.root = t;
+  }
+  get displayName() {
+    return this.root.name;
+  }
+  resolveDirectory(t, e = !1) {
+    return y(this, null, function* () {
+      let r = this.root;
+      for (const a of t)
+        r = yield r.getDirectoryHandle(a, {
+          create: e
+        });
+      return r;
+    });
+  }
+  resolveFile(t) {
+    return y(this, null, function* () {
+      const e = f(t), r = e.pop();
+      if (!r)
+        throw m("TypeMismatchError");
+      return (yield this.resolveDirectory(e)).getFileHandle(r);
+    });
+  }
+  stat(t) {
+    return y(this, null, function* () {
+      const e = f(t), r = e.pop();
+      if (!r)
+        return {
+          name: this.root.name,
+          kind: "directory"
+        };
+      const a = yield this.resolveDirectory(e);
+      try {
+        const c = yield (yield a.getFileHandle(r)).getFile();
+        return {
+          name: r,
+          kind: "file",
+          size: c.size,
+          lastModified: c.lastModified
+        };
+      } catch (c) {
+        if (!u(c, "TypeMismatchError"))
+          throw c;
+        return yield a.getDirectoryHandle(r), {
+          name: r,
+          kind: "directory"
+        };
+      }
+    });
+  }
+  listEntries(t, e) {
+    return y(this, null, function* () {
+      const r = yield this.resolveDirectory(f(t)), a = [];
+      try {
+        for (var c = p(r.values()), w, l, i; w = !(l = yield c.next()).done; w = !1) {
+          const n = l.value;
+          if (v(e), n.kind === "directory")
+            a.push({
+              name: n.name,
+              kind: "directory"
+            });
+          else
+            try {
+              const s = yield n.getFile();
+              a.push({
+                name: n.name,
+                kind: "file",
+                size: s.size,
+                lastModified: s.lastModified
+              });
+            } catch (s) {
+              if (u(s, "NotAllowedError"))
+                throw s;
+              a.push({
+                name: n.name,
+                kind: "file"
+              });
+            }
+        }
+      } catch (l) {
+        i = [l];
+      } finally {
+        try {
+          w && (l = c.return) && (yield l.call(c));
+        } finally {
+          if (i)
+            throw i[0];
+        }
+      }
+      return a;
+    });
+  }
+  readFile(t) {
+    return y(this, null, function* () {
+      return (yield this.resolveFile(t)).getFile();
+    });
+  }
+  writeFile(a, c) {
+    return y(this, arguments, function* (t, e, r = {}) {
+      const w = f(t), l = w.pop();
+      if (!l)
+        throw m("TypeMismatchError");
+      const i = yield this.resolveDirectory(w, r.createDirectories);
+      let n = !0;
+      try {
+        yield i.getFileHandle(l);
+      } catch (h) {
+        if (!u(h, "NotFoundError"))
+          throw h;
+        n = !1;
+      }
+      const s = yield i.getFileHandle(l, {
+        create: !0
+      });
+      let d;
+      try {
+        d = yield s.createWritable();
+        try {
+          for (var A = p(D(e)), x, S, W; x = !(S = yield A.next()).done; x = !1) {
+            const h = S.value;
+            v(r.signal), yield d.write(h);
+          }
+        } catch (S) {
+          W = [S];
+        } finally {
+          try {
+            x && (S = A.return) && (yield S.call(A));
+          } finally {
+            if (W)
+              throw W[0];
+          }
+        }
+        v(r.signal), yield d.close();
+      } catch (h) {
+        throw yield d == null ? void 0 : d.abort().catch(() => {
+        }), n || (yield i.removeEntry(l).catch(() => {
+        })), h;
+      }
+    });
+  }
+  createDirectory(t) {
+    return y(this, null, function* () {
+      yield this.resolveDirectory(f(t), !0);
+    });
+  }
+  remove(r) {
+    return y(this, arguments, function* (t, e = {}) {
+      const a = f(t), c = a.pop();
+      if (!c)
+        throw m("InvalidModificationError");
+      yield (yield this.resolveDirectory(a)).removeEntry(c, {
+        recursive: e.recursive === !0
+      });
+    });
+  }
+  move(t, e) {
+    return y(this, null, function* () {
+      const r = f(t), a = f(e), c = r.pop(), w = a.pop();
+      if (!c || !w)
+        throw m("InvalidModificationError");
+      const l = yield this.resolveDirectory(r), i = yield E(l, c), n = yield this.resolveDirectory(a);
+      if (k(t, e))
+        throw m("InvalidModificationError");
+      let s;
+      try {
+        s = yield E(n, w);
+      } catch (d) {
+        if (!u(d, "NotFoundError"))
+          throw d;
+      }
+      if (s && (s.kind === "directory" || i.kind === "directory"))
+        throw m("InvalidModificationError");
+      if (!s && typeof i.move == "function")
+        try {
+          yield i.move(n, w);
+          return;
+        } catch (d) {
+          if (!u(d, "NotSupportedError") && !(d instanceof TypeError))
+            throw d;
+        }
+      yield F(i, n, w), yield l.removeEntry(c, {
+        recursive: !0
+      });
+    });
+  }
+}
+function E(o, t) {
+  return y(this, null, function* () {
+    try {
+      return yield o.getFileHandle(t);
+    } catch (e) {
+      if (!u(e, "TypeMismatchError"))
+        throw e;
+      return o.getDirectoryHandle(t);
+    }
+  });
+}
+function F(o, t, e) {
+  return y(this, null, function* () {
+    if (o.kind === "file") {
+      const i = yield o.getFile(), n = yield (yield t.getFileHandle(e, {
+        create: !0
+      })).createWritable();
+      try {
+        yield n.write(i), yield n.close();
+      } catch (s) {
+        throw yield n.abort().catch(() => {
+        }), s;
+      }
+      return;
+    }
+    const r = yield t.getDirectoryHandle(e, {
+      create: !0
+    });
+    try {
+      for (var a = p(o.values()), c, w, l; c = !(w = yield a.next()).done; c = !1) {
+        const i = w.value;
+        yield F(i, r, i.name);
+      }
+    } catch (w) {
+      l = [w];
+    } finally {
+      try {
+        c && (w = a.return) && (yield w.call(a));
+      } finally {
+        if (l)
+          throw l[0];
+      }
+    }
+  });
+}
+export {
+  b as FileSystemAccessAdapter
+};

package/dist/es/localFiles/adapters/HostBridgeAdapter.mjs

@@ -0,0 +1,233 @@
+var N = Object.defineProperty;
+var f = Object.getOwnPropertySymbols;
+var O = Object.prototype.hasOwnProperty, T = Object.prototype.propertyIsEnumerable;
+var m = (i, t) => {
+  if (t = Symbol[i])
+    return t;
+  throw Error("Symbol." + i + " is not defined");
+};
+var u = (i, t, e) => t in i ? N(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e, b = (i, t) => {
+  for (var e in t || (t = {}))
+    O.call(t, e) && u(i, e, t[e]);
+  if (f)
+    for (var e of f(t))
+      T.call(t, e) && u(i, e, t[e]);
+  return i;
+};
+var p = (i, t, e) => (u(i, typeof t != "symbol" ? t + "" : t, e), e);
+var l = (i, t, e) => new Promise((r, o) => {
+  var s = (n) => {
+    try {
+      c(e.next(n));
+    } catch (d) {
+      o(d);
+    }
+  }, a = (n) => {
+    try {
+      c(e.throw(n));
+    } catch (d) {
+      o(d);
+    }
+  }, c = (n) => n.done ? r(n.value) : Promise.resolve(n.value).then(s, a);
+  c((e = e.apply(i, t)).next());
+});
+var w = (i, t, e) => (t = i[m("asyncIterator")]) ? t.call(i) : (i = i[m("iterator")](), t = {}, e = (r, o) => (o = i[r]) && (t[r] = (s) => new Promise((a, c, n) => (s = o.call(i, s), n = s.done, Promise.resolve(s.value).then((d) => a({ value: d, done: n }), c)))), e("next"), e("return"), t);
+import { domError as h, toChunks as L } from "./WorkspaceFileAdapter.mjs";
+import { throwIfAborted as A } from "../errors.mjs";
+import { SANDBOX_PROTOCOL as C, HOST_CHANNEL as M } from "../host/protocol.mjs";
+const x = 3e4;
+function B(i) {
+  let t = "";
+  for (let r = 0; r < i.length; r += 32768)
+    t += String.fromCharCode(...i.subarray(r, r + 32768));
+  return btoa(t);
+}
+function k(i) {
+  const t = atob(i), e = new Uint8Array(t.length);
+  for (let r = 0; r < t.length; r++)
+    e[r] = t.charCodeAt(r);
+  return e;
+}
+function v(i, t) {
+  const e = i && typeof i == "object" ? i : {}, r = e.kind === "directory" ? "directory" : "file", o = {
+    name: typeof e.name == "string" && e.name ? e.name : t,
+    kind: r
+  };
+  return r === "file" && typeof e.size == "number" && (o.size = e.size), typeof e.lastModified == "number" && (o.lastModified = e.lastModified), o;
+}
+class q {
+  constructor(t, e = "") {
+    p(this, "displayName");
+    /** 宿主最近一次 workspace 消息声明的能力。 */
+    p(this, "capabilities", /* @__PURE__ */ new Set());
+    /** 宿主随 sandbox-exec 声明的沙箱包版本和协议。 */
+    p(this, "sandboxVersion");
+    p(this, "sandboxProtocol");
+    p(this, "seq", 0);
+    p(this, "pending", /* @__PURE__ */ new Map());
+    this.view = t, this.displayName = e;
+  }
+  setCapabilities(t, e = {}) {
+    const r = Array.isArray(t) ? t.filter((o) => typeof o == "string") : [];
+    this.capabilities = new Set(r), this.sandboxVersion = typeof e.version == "string" ? e.version : void 0, this.sandboxProtocol = typeof e.protocol == "number" ? e.protocol : void 0;
+  }
+  /** 声明了 sandbox-exec 且协议版本与 SDK 一致时才把命令交给宿主。 */
+  get canExec() {
+    return this.capabilities.has("sandbox-exec") && this.sandboxProtocol === C;
+  }
+  requireCapability(t) {
+    if (!this.capabilities.has(t))
+      throw h("NotAllowedError", `宿主未声明 ${t}。`);
+  }
+  settle(t) {
+    const e = this.pending.get(t.id);
+    if (e) {
+      if (clearTimeout(e.timer), this.pending.delete(t.id), t.ok === !1) {
+        e.reject(h(t.name || "NotAllowedError", t.message || t.name || "NotAllowedError"));
+        return;
+      }
+      e.resolve(t);
+    }
+  }
+  call(t, e, r, o = x) {
+    A(r);
+    const s = `host-${++this.seq}`;
+    return new Promise((a, c) => {
+      const n = setTimeout(() => {
+        this.pending.delete(s), c(h("AbortError"));
+      }, o), d = () => {
+        clearTimeout(n), this.pending.delete(s), c(h("AbortError"));
+      };
+      r == null || r.addEventListener("abort", d, {
+        once: !0
+      }), this.pending.set(s, {
+        resolve: (E) => {
+          r == null || r.removeEventListener("abort", d), a(E);
+        },
+        reject: c,
+        timer: n
+      }), this.view.postMessage(b({
+        channel: M,
+        id: s,
+        op: t
+      }, e));
+    });
+  }
+  stat(t) {
+    return l(this, null, function* () {
+      const e = yield this.call("stat", {
+        path: t
+      });
+      return v(e.entry, t.split("/").pop() || this.displayName);
+    });
+  }
+  listEntries(t, e) {
+    return l(this, null, function* () {
+      const r = yield this.call("list", {
+        path: t
+      }, e);
+      return (Array.isArray(r.entries) ? r.entries : []).map((s) => v(s, ""));
+    });
+  }
+  readFile(t) {
+    return l(this, null, function* () {
+      var o;
+      const e = yield this.call("read", {
+        path: t
+      }), r = k((o = e.contentBase64) != null ? o : "");
+      return new Blob([r]);
+    });
+  }
+  createDirectory(t) {
+    return l(this, null, function* () {
+      this.requireCapability("fs-mutate"), yield this.call("mkdir", {
+        path: t
+      });
+    });
+  }
+  remove(r) {
+    return l(this, arguments, function* (t, e = {}) {
+      this.requireCapability("fs-mutate"), yield this.call("remove", {
+        path: t,
+        recursive: e.recursive === !0
+      });
+    });
+  }
+  move(t, e) {
+    return l(this, null, function* () {
+      this.requireCapability("fs-mutate"), yield this.call("move", {
+        from: t,
+        to: e
+      });
+    });
+  }
+  exec(t) {
+    return l(this, null, function* () {
+      var o, s, a;
+      this.requireCapability("sandbox-exec");
+      const e = (o = t.timeoutMs) != null ? o : x, r = yield this.call("exec", {
+        protocol: C,
+        cwd: t.cwd,
+        command: t.command,
+        argv: t.argv,
+        timeoutMs: e
+      }, t.signal, e + 15e3);
+      if (r.timedOut)
+        throw h("AbortError", "命令运行超时。");
+      return {
+        exitCode: typeof r.exitCode == "number" ? r.exitCode : 1,
+        stdout: (s = r.stdout) != null ? s : "",
+        stderr: (a = r.stderr) != null ? a : "",
+        cwd: typeof r.cwd == "string" ? r.cwd : void 0
+      };
+    });
+  }
+  runPython(t, e, r, o) {
+    return l(this, null, function* () {
+      var a, c;
+      const s = yield this.call("run_python", {
+        path: t,
+        args: e,
+        timeoutMs: r
+      }, o, r + 15e3);
+      return {
+        exitCode: typeof s.exitCode == "number" ? s.exitCode : 1,
+        timedOut: s.timedOut === !0,
+        stdout: (a = s.stdout) != null ? a : "",
+        stderr: (c = s.stderr) != null ? c : ""
+      };
+    });
+  }
+  writeFile(o, s) {
+    return l(this, arguments, function* (t, e, r = {}) {
+      const a = [];
+      try {
+        for (var E = w(L(e)), U, F, I; U = !(F = yield E.next()).done; U = !1) {
+          const y = F.value;
+          A(r.signal), a.push(y);
+        }
+      } catch (F) {
+        I = [F];
+      } finally {
+        try {
+          U && (F = E.return) && (yield F.call(E));
+        } finally {
+          if (I)
+            throw I[0];
+        }
+      }
+      const c = a.reduce((y, g) => y + g.byteLength, 0), n = new Uint8Array(c);
+      let d = 0;
+      a.forEach((y) => {
+        n.set(y, d), d += y.byteLength;
+      }), yield this.call("write", {
+        path: t,
+        contentBase64: B(n),
+        createDirectories: r.createDirectories === !0
+      }, r.signal);
+    });
+  }
+}
+export {
+  q as HostBridgeAdapter
+};