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

package/dist/es/localFiles/tools/writeTools.mjs

@@ -0,0 +1,173 @@
+var C = Object.defineProperty, $ = Object.defineProperties;
+var k = Object.getOwnPropertyDescriptors;
+var q = Object.getOwnPropertySymbols;
+var v = Object.prototype.hasOwnProperty, z = Object.prototype.propertyIsEnumerable;
+var A = (t, e, a) => e in t ? C(t, e, { enumerable: !0, configurable: !0, writable: !0, value: a }) : t[e] = a, H = (t, e) => {
+  for (var a in e || (e = {}))
+    v.call(e, a) && A(t, a, e[a]);
+  if (q)
+    for (var a of q(e))
+      z.call(e, a) && A(t, a, e[a]);
+  return t;
+}, W = (t, e) => $(t, k(e));
+var h = (t, e, a) => new Promise((r, n) => {
+  var s = (o) => {
+    try {
+      d(a.next(o));
+    } catch (c) {
+      n(c);
+    }
+  }, f = (o) => {
+    try {
+      d(a.throw(o));
+    } catch (c) {
+      n(c);
+    }
+  }, d = (o) => o.done ? r(o.value) : Promise.resolve(o.value).then(s, f);
+  d((a = a.apply(t, e)).next());
+});
+import { ToolError as l, ToolCode as w } from "../errors.mjs";
+import { normalizeWorkspacePath as F, parentPath as N } from "../security/pathPolicy.mjs";
+import { assertNotSensitive as D, hasUtf8Bom as P, decodeUtf8Strict as S, tooLarge as B, statOrNull as T, requireFile as _, readBytes as j, sha256 as O } from "./runtime.mjs";
+const u = new Uint8Array([239, 187, 191]);
+function y(t, e) {
+  return new l(w.Conflict, e, {
+    currentHash: t
+  });
+}
+function b(t, e) {
+  return h(this, null, function* () {
+    var n;
+    if (((n = (yield _(t.adapter, e)).size) != null ? n : 0) > t.limits.maxWriteBytes)
+      throw B(t.limits.maxWriteBytes, "目标文件");
+    const r = yield j(yield t.adapter.readFile(e));
+    return {
+      bytes: r,
+      hash: yield O(r)
+    };
+  });
+}
+function R(t, e, a) {
+  return h(this, null, function* () {
+    const {
+      hash: r
+    } = yield b(t, e);
+    if (r !== a)
+      throw y(r, "文件在确认期间已被修改，本次写入已取消。请重新读取后再修改。");
+  });
+}
+function m(t, e) {
+  const a = new TextEncoder().encode(t);
+  if (!e)
+    return a;
+  const r = new Uint8Array(u.byteLength + a.byteLength);
+  return r.set(u, 0), r.set(a, u.byteLength), r;
+}
+function M(t, e) {
+  let a = 0, r = t.indexOf(e);
+  for (; r >= 0; )
+    a++, r = t.indexOf(e, r + e.length);
+  return a;
+}
+function E(t, e) {
+  return !e || t.includes(`\r
+`) ? t : t.replace(/\n/g, `\r
+`);
+}
+function U(t, e, a, r = !1) {
+  return h(this, null, function* () {
+    return t.progress({
+      stage: "writing",
+      loaded: 0,
+      total: a.byteLength,
+      path: e
+    }), yield t.adapter.writeFile(e, a, {
+      createDirectories: r,
+      signal: t.signal
+    }), {
+      path: e,
+      hash: yield O(a),
+      size: a.byteLength
+    };
+  });
+}
+const Q = (t, e) => h(void 0, null, function* () {
+  const a = F(t.path);
+  if (D(e, a, "write"), !t.edits.length)
+    throw new l(w.BadRequest, "参数 edits 不能为空。");
+  const {
+    bytes: r,
+    hash: n
+  } = yield b(e, a);
+  if (n !== t.expectedHash)
+    throw y(n, "expectedHash 与文件当前内容不一致，请重新读取文件后再修改。");
+  const s = P(r), f = S(s ? r.subarray(3) : r), d = f.includes(`\r
+`);
+  let o = f;
+  t.edits.forEach((i, p) => {
+    if (typeof (i == null ? void 0 : i.oldText) != "string" || !i.oldText || typeof i.newText != "string")
+      throw new l(w.BadRequest, `第 ${p + 1} 条修改无效：oldText 必须是非空字符串，newText 必须是字符串。`);
+    const x = E(i.oldText, d), L = E(i.newText, d), g = M(o, x);
+    if (g === 0)
+      throw new l(w.Conflict, `第 ${p + 1} 条修改的 oldText 在文件中不存在，请重新读取文件确认当前内容。`);
+    if (g > 1 && !i.replaceAll)
+      throw new l(w.BadRequest, `第 ${p + 1} 条修改的 oldText 在文件中出现了 ${g} 次，请补充上下文使其唯一，或设置 replaceAll。`);
+    o = i.replaceAll ? o.split(x).join(L) : o.replace(x, () => L);
+  });
+  const c = m(o, s);
+  if (c.byteLength > e.limits.maxWriteBytes)
+    throw B(e.limits.maxWriteBytes, "修改后的内容");
+  return yield e.requestApproval(a, {
+    type: "text",
+    before: f,
+    after: o,
+    created: !1
+  }), yield R(e, a, n), {
+    data: yield U(e, a, c)
+  };
+}), V = (t, e) => h(void 0, null, function* () {
+  const a = F(t.path);
+  D(e, a, "write");
+  const r = yield T(e.adapter, a);
+  if ((r == null ? void 0 : r.kind) === "directory")
+    throw new l(w.BadRequest, "目标是目录，不能写入文件。");
+  let n, s;
+  if (r) {
+    const o = yield b(e, a);
+    if (s = o.hash, !t.expectedHash)
+      throw y(s, "目标文件已存在，覆盖前需要提供 expectedHash（可通过 read_file 或 stat_file 获取）。");
+    if (t.expectedHash !== s)
+      throw y(s, "expectedHash 与文件当前内容不一致，请重新读取文件后再写入。");
+    n = new TextDecoder("utf-8").decode(o.bytes);
+  } else if (!t.createDirectories) {
+    const o = N(a), c = o ? yield T(e.adapter, o) : {
+      kind: "directory"
+    };
+    if (!c)
+      throw new l(w.NotFound, "父目录不存在，可设置 createDirectories 自动创建。");
+    if (c.kind !== "directory")
+      throw new l(w.BadRequest, "父路径不是目录。");
+  }
+  const f = new TextEncoder().encode(t.content);
+  if (f.byteLength > e.limits.maxWriteBytes)
+    throw B(e.limits.maxWriteBytes, "写入内容");
+  if (yield e.requestApproval(a, {
+    type: "text",
+    before: n,
+    after: t.content,
+    created: !r
+  }), s)
+    yield R(e, a, s);
+  else if (yield T(e.adapter, a))
+    throw new l(w.Conflict, "目标文件在确认期间被创建，本次写入已取消。请重新检查后再写入。");
+  const d = yield U(e, a, f, t.createDirectories);
+  return {
+    data: W(H({}, d), {
+      created: !r
+    })
+  };
+});
+export {
+  Q as applyPatch,
+  V as writeFile
+};

package/dist/es/localFiles/transfer/SessionFileTransfer.mjs

@@ -0,0 +1,111 @@
+var h = (u, c, l) => new Promise((r, f) => {
+  var i = (e) => {
+    try {
+      t(l.next(e));
+    } catch (d) {
+      f(d);
+    }
+  }, a = (e) => {
+    try {
+      t(l.throw(e));
+    } catch (d) {
+      f(d);
+    }
+  }, t = (e) => e.done ? r(e.value) : Promise.resolve(e.value).then(i, a);
+  t((l = l.apply(u, c)).next());
+});
+import { ToolError as n, ToolCode as o } from "../errors.mjs";
+function w() {
+  return new n(o.Internal, "平台文件服务请求失败，请稍后重试。");
+}
+function F(u, c = () => {
+}) {
+  const l = () => {
+    const i = u();
+    if (!i)
+      throw w();
+    return i;
+  }, r = () => {
+    const i = c();
+    if (!i)
+      throw w();
+    return i;
+  };
+  return {
+    upload(i, a, t) {
+      return h(this, null, function* () {
+        if (!a.sessionId)
+          throw new n(o.BadRequest, "当前没有可用的会话，无法上传文件。");
+        try {
+          t == null || t({
+            loaded: 0,
+            total: i.size
+          });
+          const e = yield r().postFile(i, (d, p) => t == null ? void 0 : t({
+            loaded: d,
+            total: p
+          }));
+          if (!(e != null && e.id) || !e.url)
+            throw w();
+          return t == null || t({
+            loaded: i.size,
+            total: i.size
+          }), {
+            fileId: e.id,
+            url: e.url
+          };
+        } catch (e) {
+          throw e instanceof n ? e : w();
+        }
+      });
+    },
+    resolveDownload(i, a) {
+      return h(this, null, function* () {
+        if (i.type === "platformFile")
+          return I(r(), i.fileId);
+        if (!a.sessionId)
+          throw new n(o.BadRequest, "当前没有可用的会话，无法下载会话文件。");
+        let t;
+        try {
+          t = yield l().getApplicationIdSessionFile(a.applicationId, a.sessionId, i.fileId);
+        } catch (e) {
+          throw w();
+        }
+        if (!(t != null && t.url))
+          throw new n(o.NotFound, "会话文件不存在或暂不可下载。");
+        return {
+          url: t.url,
+          name: t.name,
+          size: t.size
+        };
+      });
+    }
+  };
+}
+function I(u, c) {
+  return h(this, null, function* () {
+    let l;
+    try {
+      l = yield u.getFile(c);
+    } catch (f) {
+      throw w();
+    }
+    if (!(l != null && l.url))
+      throw new n(o.NotFound, "平台文件不存在或暂不可下载。");
+    let r;
+    try {
+      r = new URL(l.url);
+    } catch (f) {
+      throw new n(o.Internal, "平台返回的下载地址无效。");
+    }
+    if (r.protocol !== "https:")
+      throw new n(o.Internal, "平台返回的下载地址无效。");
+    return {
+      url: l.url,
+      size: l.bytes
+    };
+  });
+}
+export {
+  F as createDefaultSessionFileTransfer
+};

package/dist/es/localFiles/validate.mjs

@@ -0,0 +1,66 @@
+var j = Object.defineProperty, p = Object.defineProperties;
+var x = Object.getOwnPropertyDescriptors;
+var $ = Object.getOwnPropertySymbols;
+var A = Object.prototype.hasOwnProperty, I = Object.prototype.propertyIsEnumerable;
+var g = (i, r, n) => r in i ? j(i, r, { enumerable: !0, configurable: !0, writable: !0, value: n }) : i[r] = n, s = (i, r) => {
+  for (var n in r || (r = {}))
+    A.call(r, n) && g(i, n, r[n]);
+  if ($)
+    for (var n of $(r))
+      I.call(r, n) && g(i, n, r[n]);
+  return i;
+}, c = (i, r) => p(i, x(r));
+import { ToolError as O, ToolCode as w } from "./errors.mjs";
+function t(i, r) {
+  throw new O(w.BadRequest, i ? `参数 ${i} ${r}` : `参数${r}`);
+}
+function N(i, r) {
+  return typeof i != "string" ? i : (r.type === "integer" || r.type === "number") && /^-?\d+(\.\d+)?$/.test(i.trim()) ? Number(i) : r.type === "boolean" && (i === "true" || i === "false") ? i === "true" : i;
+}
+function y(i, r, n) {
+  switch (i = N(i, r), r.type) {
+    case "string":
+      typeof i != "string" && t(n, "必须是字符串。"), r.minLength !== void 0 && i.length < r.minLength && t(n, "不能为空。");
+      break;
+    case "integer":
+      (typeof i != "number" || !Number.isInteger(i)) && t(n, "必须是整数。");
+      break;
+    case "number":
+      (typeof i != "number" || !Number.isFinite(i)) && t(n, "必须是数字。");
+      break;
+    case "boolean":
+      typeof i != "boolean" && t(n, "必须是布尔值。");
+      break;
+    case "array":
+      if (Array.isArray(i) || t(n, "必须是数组。"), r.minItems !== void 0 && i.length < r.minItems && t(n, "不能为空。"), r.items) {
+        const e = r.items;
+        return i.map((f, m) => y(f, e, `${n}[${m}]`));
+      }
+      break;
+    case "object":
+      return k(i, r, n);
+  }
+  return r.enum && !r.enum.includes(i) && t(n, `必须是 ${r.enum.join("、")} 之一。`), typeof i == "number" && (r.minimum !== void 0 && i < r.minimum && t(n, `不能小于 ${r.minimum}。`), r.maximum !== void 0 && i > r.maximum && t(n, `不能大于 ${r.maximum}。`)), i;
+}
+function k(i, r, n) {
+  var m, d;
+  (!i || typeof i != "object" || Array.isArray(i)) && t(n, "必须是对象。");
+  const e = i, f = {};
+  for (const o of (m = r.required) != null ? m : [])
+    (e[o] === void 0 || e[o] === null) && t(n ? `${n}.${o}` : o, "是必填项。");
+  for (const [o, b] of Object.entries((d = r.properties) != null ? d : {})) {
+    if (e[o] === void 0 || e[o] === null)
+      continue;
+    const u = n ? `${n}.${o}` : o;
+    f[o] = b.oneOf ? (y(e[o], c(s({}, b), {
+      oneOf: void 0
+    }), u), e[o]) : y(e[o], b, u);
+  }
+  return f;
+}
+function L(i, r) {
+  return k(i, r, "");
+}
+export {
+  L as validateToolInput
+};

package/dist/es/localFiles/workspace/LocalWorkspace.mjs

@@ -0,0 +1,339 @@
+var _ = Object.defineProperty, k = Object.defineProperties;
+var S = Object.getOwnPropertyDescriptors;
+var w = Object.getOwnPropertySymbols;
+var C = Object.prototype.hasOwnProperty, P = Object.prototype.propertyIsEnumerable;
+var u = (r, e, t) => e in r ? _(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t, f = (r, e) => {
+  for (var t in e || (e = {}))
+    C.call(e, t) && u(r, t, e[t]);
+  if (w)
+    for (var t of w(e))
+      P.call(e, t) && u(r, t, e[t]);
+  return r;
+}, A = (r, e) => k(r, S(e));
+var s = (r, e, t) => (u(r, typeof e != "symbol" ? e + "" : e, t), t);
+var o = (r, e, t) => new Promise((i, a) => {
+  var n = (l) => {
+    try {
+      c(t.next(l));
+    } catch (d) {
+      a(d);
+    }
+  }, h = (l) => {
+    try {
+      c(t.throw(l));
+    } catch (d) {
+      a(d);
+    }
+  }, c = (l) => l.done ? i(l.value) : Promise.resolve(l.value).then(n, h);
+  c((t = t.apply(r, e)).next());
+});
+import H from "../../EventBus.mjs";
+import { FileSystemAccessAdapter as b } from "../adapters/FileSystemAccessAdapter.mjs";
+import { getNativeDirectoryPicker as D } from "../adapters/fsaTypes.mjs";
+import { LOCAL_FILES_FUNCTION_CODES as T } from "../constants.mjs";
+import { getDownloadUrlAllowlist as F } from "../security/downloadUrlPolicy.mjs";
+import { SensitiveFilePolicy as W } from "../security/sensitiveFiles.mjs";
+import { resolveLimits as q } from "../limits.mjs";
+import { createDefaultSessionFileTransfer as N } from "../transfer/SessionFileTransfer.mjs";
+import { createMemoryStore as I } from "./handleStore.mjs";
+import { watchDirectoryHandle as E } from "./watchDirectory.mjs";
+const p = {
+  mode: "readwrite"
+};
+function K(r) {
+  const e = r.replace(/\\/g, "/").trim().replace(/^\.\/+/, "").replace(/\/+$/, "");
+  if (!e || e === ".")
+    return "";
+  if (e.startsWith("/") || e.includes(":") || e.includes("\0"))
+    return;
+  const t = e.split("/");
+  if (!t.some((i) => !i || i === "." || i === ".."))
+    return t.join("/");
+}
+function L(r) {
+  return !!r && typeof r == "object" && r.name === "AbortError";
+}
+class J {
+  constructor(e) {
+    s(this, "applicationId");
+    s(this, "limits");
+    s(this, "sensitive");
+    s(this, "downloadUrlAllowlist");
+    s(this, "allowWorkspaceWideTextSearch");
+    s(this, "transfer");
+    s(this, "fetch");
+    s(this, "store");
+    s(this, "picker");
+    s(this, "event", new H(!0));
+    s(this, "_status");
+    s(this, "_displayName");
+    s(this, "_adapter", null);
+    s(this, "pendingHandle", null);
+    s(this, "approvalHandler");
+    s(this, "activeCalls", 0);
+    s(this, "inflight", /* @__PURE__ */ new Set());
+    s(this, "_ready", Promise.resolve());
+    s(this, "stopWatching", () => {
+    });
+    s(this, "pendingChangePaths", /* @__PURE__ */ new Set());
+    s(this, "changeTimer");
+    s(this, "refreshAllVisible", !1);
+    var n, h, c, l, d, m, g, y, v;
+    const t = (n = e.config) != null ? n : {};
+    this.applicationId = e.applicationId, this.store = (h = e.store) != null ? h : I(), this.picker = e.picker === null ? void 0 : (c = e.picker) != null ? c : D(), this.limits = q(t.limits), this.sensitive = new W(t.sensitiveRulesAppend), this.downloadUrlAllowlist = F(t.downloadUrlAllowlistAppend), this.allowWorkspaceWideTextSearch = !!t.allowWorkspaceWideTextSearch, this.approvalHandler = t.onApprovalRequired;
+    const i = (l = e.transfer) != null ? l : N(() => {
+    });
+    this.transfer = {
+      upload: (m = (d = t.transfer) == null ? void 0 : d.upload) != null ? m : i.upload,
+      resolveDownload: (y = (g = t.transfer) == null ? void 0 : g.resolveDownload) != null ? y : i.resolveDownload
+    };
+    const a = (v = e.fetch) != null ? v : typeof fetch == "function" ? fetch : void 0;
+    this.fetch = a ? a.bind(globalThis) : () => Promise.reject(new Error("fetch is not available")), this._status = this.picker ? "none" : "unsupported";
+  }
+  // -------------------------------------------------------------------------
+  // 状态
+  // -------------------------------------------------------------------------
+  get status() {
+    return this._status;
+  }
+  /** 当前（或待恢复的）文件夹名，不含绝对路径。 */
+  get displayName() {
+    return this._displayName;
+  }
+  get isSupported() {
+    return !!this.picker;
+  }
+  /** 最近一次 restore() 完成前，工具调用会等待它。 */
+  get ready() {
+    return this._ready;
+  }
+  /** @internal 已授权时可用的 Adapter。 */
+  get adapter() {
+    return this._status === "granted" ? this._adapter : null;
+  }
+  get handleKey() {
+    return `workspace:${this.applicationId}`;
+  }
+  get disclosureKey() {
+    return `disclosure:${this.applicationId}`;
+  }
+  setStatus(e, t = this._displayName) {
+    e === this._status && t === this._displayName || (this._status = e, this._displayName = t, this.emit("workspace:changed", {
+      status: e,
+      displayName: t
+    }));
+  }
+  attachHandle(e) {
+    this.cancelFilesChanged(), this.pendingHandle = e, this._adapter = new b(e), this.setStatus("granted", e.name), this.unwatchDirectory(), this.stopWatching = E(e, (t) => this.notifyFilesChanged(t));
+  }
+  // -------------------------------------------------------------------------
+  // 授权
+  // -------------------------------------------------------------------------
+  /**
+   * 弹出目录选择框。必须在用户点击事件中调用。
+   * 用户取消时返回 false 且状态不变。
+   */
+  pick() {
+    if (!this.picker)
+      return Promise.resolve(!1);
+    let e;
+    try {
+      e = this.picker({
+        mode: "readwrite"
+      });
+    } catch (t) {
+      return Promise.reject(t);
+    }
+    return e.then((t) => o(this, null, function* () {
+      var a, n;
+      this.cancelAll();
+      const i = (n = yield (a = t.queryPermission) == null ? void 0 : a.call(t, p)) != null ? n : "granted";
+      return yield this.store.set(this.handleKey, {
+        handle: t,
+        displayName: t.name,
+        savedAt: Date.now()
+      }).catch(() => {
+      }), i === "denied" ? (this.pendingHandle = t, this._adapter = null, this.setStatus("denied", t.name), !1) : (this.attachHandle(t), !0);
+    }), (t) => {
+      if (L(t))
+        return !1;
+      throw t;
+    });
+  }
+  /** 读取上次的目录句柄并检查权限，不弹窗。 */
+  restore() {
+    return this._ready = this.doRestore(), this._ready;
+  }
+  doRestore() {
+    return o(this, null, function* () {
+      var i, a, n;
+      if (!this.picker) {
+        this._adapter || this.setStatus("unsupported");
+        return;
+      }
+      let e;
+      try {
+        e = yield this.store.get(this.handleKey);
+      } catch (h) {
+        e = void 0;
+      }
+      if (!(e != null && e.handle)) {
+        this.pendingHandle = null, this._adapter = null, this.setStatus("none", void 0);
+        return;
+      }
+      let t;
+      try {
+        t = (n = yield (a = (i = e.handle).queryPermission) == null ? void 0 : a.call(i, p)) != null ? n : "prompt";
+      } catch (h) {
+        t = "prompt";
+      }
+      t === "granted" ? this.attachHandle(e.handle) : (this.pendingHandle = e.handle, this._adapter = null, this.setStatus(t === "denied" ? "denied" : "prompt", e.displayName));
+    });
+  }
+  /** 对已保存的目录重新申请权限。必须在用户点击事件中调用。 */
+  requestPermission() {
+    const e = this.pendingHandle;
+    if (!(e != null && e.requestPermission))
+      return Promise.resolve(!1);
+    let t;
+    try {
+      t = e.requestPermission(p);
+    } catch (i) {
+      return Promise.reject(i);
+    }
+    return t.then((i) => i === "granted" ? (this.attachHandle(e), !0) : (this._adapter = null, this.setStatus(i === "denied" ? "denied" : "prompt", e.name), !1));
+  }
+  /** 断开工作区并删除持久化句柄。状态立即变为未授权，存储删除在其后完成。 */
+  clear() {
+    return o(this, null, function* () {
+      this.cancelAll(), this.cancelFilesChanged(), this.unwatchDirectory(), this.pendingHandle = null, this._adapter = null, this.setStatus(this.picker ? "none" : "unsupported", void 0), yield this.store.delete(this.handleKey).catch(() => {
+      });
+    });
+  }
+  /** 直接挂载一个 Adapter（测试或自定义后端），视为已授权。 */
+  attachAdapter(e, t = e.displayName) {
+    this.cancelAll(), this.cancelFilesChanged(), this.unwatchDirectory(), this.pendingHandle = null, this._adapter = e, this.setStatus("granted", t);
+  }
+  /**
+   * 通知目录树重读。`paths` 是相对工作区根的目录；省略时重读当前展开的全部目录。
+   * 短时间内的多次通知会合并成一次。
+   */
+  notifyFilesChanged(e) {
+    if (this._status === "granted") {
+      if (!e || e.length === 0)
+        this.refreshAllVisible = !0;
+      else
+        for (const t of e) {
+          const i = K(t);
+          i === void 0 ? this.refreshAllVisible = !0 : this.pendingChangePaths.add(i);
+        }
+      clearTimeout(this.changeTimer), this.changeTimer = setTimeout(() => this.flushFilesChanged(), 150);
+    }
+  }
+  /** @internal 工具执行中遇到权限错误时调用，重新检查并更新状态。 */
+  handlePermissionLost() {
+    return o(this, null, function* () {
+      const e = this.pendingHandle;
+      if (!(e != null && e.queryPermission))
+        return;
+      const t = yield e.queryPermission(p).catch(() => "prompt");
+      t !== "granted" && (this.cancelAll(), this.cancelFilesChanged(), this.unwatchDirectory(), this._adapter = null, this.setStatus(t === "denied" ? "denied" : "prompt", e.name));
+    });
+  }
+  // -------------------------------------------------------------------------
+  // 外发提示
+  // -------------------------------------------------------------------------
+  isDisclosureAcknowledged() {
+    return o(this, null, function* () {
+      try {
+        return !!(yield this.store.get(this.disclosureKey));
+      } catch (e) {
+        return !1;
+      }
+    });
+  }
+  acknowledgeDisclosure() {
+    return o(this, null, function* () {
+      yield this.store.set(this.disclosureKey, !0).catch(() => {
+      });
+    });
+  }
+  // -------------------------------------------------------------------------
+  // 确认、并发与取消
+  // -------------------------------------------------------------------------
+  setApprovalHandler(e) {
+    this.approvalHandler = e;
+  }
+  get hasApprovalHandler() {
+    return !!this.approvalHandler;
+  }
+  /** @internal */
+  getApprovalHandler() {
+    return this.approvalHandler;
+  }
+  /** @internal 占用一个并发名额；已满时返回 null。 */
+  acquireSlot() {
+    if (this.activeCalls >= this.limits.maxConcurrentRequests)
+      return null;
+    this.activeCalls++;
+    let e = !1;
+    return () => {
+      e || (e = !0, this.activeCalls--);
+    };
+  }
+  /** @internal 登记进行中的调用，更换或断开工作区时统一中止。 */
+  track(e) {
+    return this.inflight.add(e), () => this.inflight.delete(e);
+  }
+  /** 中止所有进行中的调用（含等待确认的请求）。 */
+  cancelAll() {
+    const e = Array.from(this.inflight);
+    this.inflight.clear(), e.forEach((t) => t.abort());
+  }
+  handshake() {
+    const e = Object.fromEntries(T.map((t) => [t, !0]));
+    return {
+      protocolVersion: "1.0",
+      capabilities: A(f({}, e), {
+        cancellation: !0,
+        atomicWrite: !0
+      }),
+      limits: f({}, this.limits)
+    };
+  }
+  // -------------------------------------------------------------------------
+  // 事件
+  // -------------------------------------------------------------------------
+  on(e, t) {
+    return this.event.on(e, t), () => this.off(e, t);
+  }
+  off(e, t) {
+    this.event.off(e, t);
+  }
+  unwatchDirectory() {
+    const e = this.stopWatching;
+    this.stopWatching = () => {
+    }, e();
+  }
+  cancelFilesChanged() {
+    clearTimeout(this.changeTimer), this.changeTimer = void 0, this.pendingChangePaths.clear(), this.refreshAllVisible = !1;
+  }
+  flushFilesChanged() {
+    this.changeTimer = void 0;
+    const e = this.refreshAllVisible, t = [...this.pendingChangePaths].sort((i, a) => i < a ? -1 : i > a ? 1 : 0);
+    this.pendingChangePaths.clear(), this.refreshAllVisible = !1, this._status === "granted" && this.emit("files:changed", {
+      paths: e ? [] : t
+    });
+  }
+  /** @internal */
+  emit(e, t) {
+    try {
+      this.event.emit(e, t);
+    } catch (i) {
+      console.error(`[LocalWorkspace] ${e} listener failed`, i);
+    }
+  }
+}
+export {
+  J as LocalWorkspace
+};