@tool-bridge/server 0.10.1 → 0.12.0

package/dist/{chunk-AWXZMW6M.js → chunk-4U5OQW7F.js}

@@ -14591,6 +14591,24 @@ config(en_default());
 function normalizePath(path) {
   return path.replace(/^\/+|\/+$/g, "");
 }
+function validateSegment(seg) {
+  if (seg === "") return new TBError("invalid_argument", "\u6807\u8BC6\u7B26\u6BB5\u4E0D\u80FD\u4E3A\u7A7A");
+  if (seg.startsWith("~")) return new TBError("invalid_argument", `\u6807\u8BC6\u7B26\u6BB5\u4E0D\u80FD\u4EE5 '~' \u5F00\u5934:'${seg}'`);
+  if (seg === "." || seg === "..") {
+    return new TBError("invalid_argument", `\u6807\u8BC6\u7B26\u6BB5\u4E0D\u80FD\u662F '.' \u6216 '..':'${seg}'`);
+  }
+  return null;
+}
+function canonicalizeSegment(seg) {
+  const invalid2 = validateSegment(seg);
+  if (invalid2) throw invalid2;
+  return seg.toLowerCase();
+}
+function canonicalizePath(path) {
+  const norm = normalizePath(path);
+  if (norm === "") return "";
+  return norm.split("/").map((seg) => canonicalizeSegment(seg)).join("/");
+}
 function segments(path) {
   const p = normalizePath(path);
   return p === "" ? [] : p.split("/");
@@ -14607,6 +14625,9 @@ function validatePath(path, opts = {}) {
     if (seg.startsWith("~")) {
       return new TBError("invalid_argument", `\u8DEF\u5F84\u542B\u4FDD\u7559\u6BB5:'${seg}'`);
     }
+    if (seg === "." || seg === "..") {
+      return new TBError("invalid_argument", `\u8DEF\u5F84\u542B\u76F8\u5BF9\u5BFC\u822A\u6BB5:'${seg}'`);
+    }
   }
   return null;
 }
@@ -14758,11 +14779,12 @@ var MAX_PATTERN_SEGMENTS = 64;
 function matchGlob(pattern, path) {
   const pat = [];
   for (const token of segments2(pattern)) {
-    if (token === "**" && pat[pat.length - 1] === "**") continue;
-    pat.push(token);
+    const lower = token.toLowerCase();
+    if (lower === "**" && pat[pat.length - 1] === "**") continue;
+    pat.push(lower);
   }
   if (pat.length > MAX_PATTERN_SEGMENTS) return false;
-  return matchFrom(pat, 0, segments2(path), 0);
+  return matchFrom(pat, 0, segments2(path).map((s) => s.toLowerCase()), 0);
 }
 var effectOf = (scope) => scope.effect ?? "allow";
 var matches = (scope, path, action) => scope.actions.includes(action) && matchGlob(scope.pattern, path);
@@ -15049,6 +15071,9 @@ async function identify(store, bearer, now) {
 
 // ../core/src/builtin/util.ts
 var VOID_ACK = { ok: true };
+function withCommandPaths(nodePath, cmds) {
+  return cmds.map((cmd) => ({ ...cmd, path: `/${nodePath}/${cmd.name}` }));
+}
 var LIST_OPTS_SCHEMA = {
   type: "object",
   description: "pagination options",
@@ -15149,7 +15174,7 @@ function matches2(item, query) {
 }
 function catalogCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
       name: "list",
       method: "POST",
@@ -15189,6 +15214,7 @@ function catalogCmds(nodePath) {
       scope: "read"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function paginate(items, opts) {
   const o = typeof opts === "object" && opts !== null ? opts : {};
@@ -15398,8 +15424,8 @@ function parseTokenResponse(payload, config2, now) {
 }
 
 // ../core/src/context/capabilities.ts
-var CONTEXT_METHODS = ["List", "Get", "Search", "Write", "Update", "Delete"];
-var CONTEXT_WRITE_METHODS = ["Write", "Update", "Delete"];
+var CONTEXT_METHODS = ["list", "get", "search", "write", "update", "delete"];
+var CONTEXT_WRITE_METHODS = ["write", "update", "delete"];
 function contextMethodsOf(provider) {
   const methods = /* @__PURE__ */ new Set();
   for (const method of CONTEXT_METHODS) {
@@ -15412,8 +15438,8 @@ function isReadOnlyProvider(provider) {
 }
 function contextCapabilitiesOf(provider) {
   const capabilities = [];
-  if (provider.Search !== void 0) capabilities.push("search");
-  if (provider.Delete !== void 0) capabilities.push("delete");
+  if (provider.search !== void 0) capabilities.push("search");
+  if (provider.delete !== void 0) capabilities.push("delete");
   return capabilities;
 }
 
@@ -15424,8 +15450,8 @@ var NODE_KIND_BY_PROFILE2 = {
   "context/v1": "context"
 };
 var OPTIONAL_METHOD_BY_CAPABILITY = {
-  search: "Search",
-  delete: "Delete"
+  search: "search",
+  delete: "delete"
 };
 function optionalMethodsForCapabilities(capabilities) {
   const methods = /* @__PURE__ */ new Set();
@@ -15731,7 +15757,7 @@ function pluginCmds(nodePath) {
     properties: { id: { type: "string", description: "plugin id" } },
     required: ["id"]
   };
-  return [
+  const cmds = [
     {
       name: "list",
       method: "POST",
@@ -15815,6 +15841,7 @@ function pluginCmds(nodePath) {
       scope: "admin"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function clampLimit2(limit) {
   if (limit === void 0 || limit < 1) return LIST_LIMIT_DEFAULT;
@@ -16014,7 +16041,7 @@ function createPluginModule(deps) {
 var DESCRIPTION3 = "Path annotations: admin-curated notes shown in ~help of the annotated path (set / get / remove / list)";
 function annotationCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
       name: "set",
       method: "POST",
@@ -16075,6 +16102,7 @@ function annotationCmds(nodePath) {
       scope: "read"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function requireRootablePath(args) {
   const v = args.path;
@@ -16192,7 +16220,7 @@ var RemoteAllowlistStore = class {
 var DESCRIPTION4 = "Remote federation host allowlist: which hosts kind=remote nodes may connect to (env baseline is read-only; admin only)";
 function federationCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
       name: "list",
       method: "POST",
@@ -16234,6 +16262,7 @@ function federationCmds(nodePath) {
       scope: "admin"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function mergedView(base, entries) {
   const byHost = /* @__PURE__ */ new Map();
@@ -16310,7 +16339,7 @@ var NODE_FIELD_SCHEMAS = {
 };
 function registryCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
       name: "list",
       method: "POST",
@@ -16386,6 +16415,7 @@ function registryCmds(nodePath) {
       scope: "register"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function parseNodeInput(args) {
   const path = requireString(args, "path");
@@ -16457,7 +16487,7 @@ function assertUserSecretName(name) {
 }
 function secretCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
       name: "set",
       method: "POST",
@@ -16503,6 +16533,7 @@ function secretCmds(nodePath) {
       scope: "admin"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function createSecretModule(store, now) {
   return {
@@ -16540,7 +16571,7 @@ function createSecretModule(store, now) {
 // ../core/src/builtin/status.ts
 var DESCRIPTION7 = "Gateway health and summary (readable without admin)";
 function statusCmds(nodePath) {
-  return [
+  return withCommandPaths(nodePath, [
     {
       name: "get",
       method: "POST",
@@ -16550,7 +16581,7 @@ function statusCmds(nodePath) {
       returns: "{ healthy, version, nodeCount }",
       scope: "read"
     }
-  ];
+  ]);
 }
 function createStatusModule(deps) {
   return {
@@ -16615,7 +16646,7 @@ var SK_FIELD_SCHEMAS = {
 };
 function skCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
       name: "list",
       method: "POST",
@@ -16690,6 +16721,7 @@ function skCmds(nodePath) {
       scope: "admin"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function asSecretKeyInput(args) {
   const owner = requireString(args, "owner");
@@ -16791,12 +16823,12 @@ function createBuiltins(deps) {
 // ../core/src/context/help.ts
 var CONTEXT_CAPABILITIES = ["search", "delete"];
 var SCOPE_BY_CMD = {
-  List: "read",
-  Get: "read",
-  Search: "read",
-  Write: "write",
-  Update: "write",
-  Delete: "write"
+  list: "read",
+  get: "read",
+  search: "read",
+  write: "write",
+  update: "write",
+  delete: "write"
 };
 function contextScopeForCmd(tool) {
   return SCOPE_BY_CMD[tool] ?? null;
@@ -16847,9 +16879,9 @@ var PATCH_SCHEMA = {
 };
 function contextCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
-      name: "List",
+      name: "list",
       method: "POST",
       path,
       h: "list entries directly under a path (shallow, paginated)",
@@ -16864,7 +16896,7 @@ function contextCmds(nodePath) {
       scope: "read"
     },
     {
-      name: "Get",
+      name: "get",
       method: "POST",
       path,
       h: "read one entry with content (oversized content comes back as { $ref: <download URL> })",
@@ -16879,7 +16911,7 @@ function contextCmds(nodePath) {
       scope: "read"
     },
     {
-      name: "Write",
+      name: "write",
       method: "POST",
       path,
       h: "create or fully replace an entry (idempotent upsert)",
@@ -16895,7 +16927,7 @@ function contextCmds(nodePath) {
       scope: "write"
     },
     {
-      name: "Update",
+      name: "update",
       method: "POST",
       path,
       h: "partially update content and/or metadata (shallow merge); not_found if the entry does not exist",
@@ -16911,7 +16943,7 @@ function contextCmds(nodePath) {
       scope: "write"
     },
     {
-      name: "Delete",
+      name: "delete",
       method: "POST",
       path,
       h: "delete an entry (idempotent)",
@@ -16926,7 +16958,7 @@ function contextCmds(nodePath) {
       effect: "destructive"
     },
     {
-      name: "Search",
+      name: "search",
       method: "POST",
       path,
       h: "keyword search: substring match on entry paths and metadata values",
@@ -16942,6 +16974,7 @@ function contextCmds(nodePath) {
       scope: "read"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function contextHelpModel(node, opts = {}) {
   const all = contextCmds(node.path);
@@ -17110,7 +17143,7 @@ function createObjectContextProvider(store, opts) {
   };
   const notFound = (path) => TBError.notFound(`context entry \u4E0D\u5B58\u5728:'${path}'`);
   return {
-    async List(path, listOpts) {
+    async list(path, listOpts) {
       rejectFilter(listOpts);
       const limit = clampLimit3(listOpts?.limit);
       const rel = path === "" ? "" : `${normalizeEntryPath(path)}/`;
@@ -17132,7 +17165,7 @@ function createObjectContextProvider(store, opts) {
       }
       return res.cursor !== void 0 ? { items, cursor: res.cursor } : { items };
     },
-    async Get(path) {
+    async get(path) {
       const key = keyFor(path);
       const head = await store.head(key);
       if (!head) throw notFound(path);
@@ -17151,8 +17184,8 @@ function createObjectContextProvider(store, opts) {
       }
       return { ...meta3, content: text };
     },
-    async Write(path, entry) {
-      assertWritable("Write");
+    async write(path, entry) {
+      assertWritable("write");
       const key = keyFor(path);
       const { body, contentType } = serializeInput(entry);
       const meta3 = await store.put(key, body, {
@@ -17162,8 +17195,8 @@ function createObjectContextProvider(store, opts) {
       });
       return toMeta(meta3);
     },
-    async Update(path, patch) {
-      assertWritable("Update");
+    async update(path, patch) {
+      assertWritable("update");
       const key = keyFor(path);
       if (patch.content === void 0 && patch.metadata === void 0) {
         throw new TBError("invalid_argument", "patch \u81F3\u5C11\u63D0\u4F9B content \u6216 metadata \u4E4B\u4E00");
@@ -17190,11 +17223,11 @@ function createObjectContextProvider(store, opts) {
       });
       return toMeta(meta3);
     },
-    async Delete(path) {
-      assertWritable("Delete");
+    async delete(path) {
+      assertWritable("delete");
       await store.delete(keyFor(path));
     },
-    async Search(query, searchOpts) {
+    async search(query, searchOpts) {
       const mode = searchOpts?.mode ?? "keyword";
       if (mode === "semantic") {
         throw new TBError("invalid_argument", "semantic \u68C0\u7D22\u672A\u58F0\u660E('search:semantic' capability)");
@@ -17313,8 +17346,7 @@ var schemaByType = {
   call: external_exports.object({
     type: external_exports.literal("call"),
     id: idSchema,
-    path: external_exports.string(),
-    tool: external_exports.string().min(1),
+    path: external_exports.string().min(1),
     arguments: external_exports.record(external_exports.string(), external_exports.unknown()),
     context: deviceCallContextSchema.optional()
   }),
@@ -17544,7 +17576,6 @@ var DeviceGatewaySession = class {
       type: "call",
       id: req.id,
       path: req.path,
-      tool: req.tool,
       arguments: req.arguments,
       // undefined 经 JSON.stringify 丢弃:老网关不带 context 时帧形状不变。
       ...req.context !== void 0 ? { context: req.context } : {}
@@ -17812,8 +17843,7 @@ function renderHelpDsl(model) {
     lines.push(`cmd ${cmd.name} ${cmd.method} ${cmd.path}`);
     if (cmd.h !== void 0) lines.push(...attrLines("h", cmd.h));
     if (cmd.inputSchema !== void 0) {
-      const body = cmd.flatBody ? cmd.inputSchema : { tool: cmd.name, arguments: cmd.inputSchema };
-      lines.push(`  body ${JSON.stringify(body)}`);
+      lines.push(`  body ${JSON.stringify(cmd.inputSchema)}`);
     }
     if (cmd.outputSchema !== void 0) lines.push(`  result ${JSON.stringify(cmd.outputSchema)}`);
     if (cmd.returns !== void 0) lines.push(...attrLines("returns", cmd.returns));
@@ -17887,8 +17917,7 @@ function cmdSection(cmd, index) {
   if (cmd.h !== void 0 && cmd.h.trim() !== "") {
     lines.push(cmd.h.trim(), "");
   }
-  const bodyShape = cmd.flatBody ? "`{...arguments}`" : `\`{"tool": "${cmd.name}", "arguments": {...}}\``;
-  lines.push(`- Invoke: \`POST ${cmd.path}\` with body ${bodyShape}`);
+  lines.push(`- Invoke: \`POST ${cmd.path}\` with body \`{...arguments}\``);
   lines.push(`- Required scope: \`${cmd.scope}\``);
   if (cmd.effect !== void 0) {
     lines.push(
@@ -17901,15 +17930,14 @@ function cmdSection(cmd, index) {
   if (cmd.inputSchema !== void 0) {
     lines.push(
       "",
-      cmd.flatBody ? "Request body (JSON Schema):" : "Arguments (JSON Schema of the `arguments` field):",
+      "Request body (JSON Schema):",
       "",
       "```json",
       JSON.stringify(cmd.inputSchema, null, 2),
       "```"
     );
   } else if (index) {
-    const specPath = cmd.flatBody ? `${cmd.path}/~help` : `${cmd.path}/${cmd.name}/~help`;
-    lines.push(`- Arguments: schema not shown in this index \u2014 \`GET ${specPath}\``);
+    lines.push(`- Arguments: schema not shown in this index \u2014 \`GET ${cmd.path}/~help\``);
   } else {
     lines.push("- Arguments: none declared");
   }
@@ -17934,31 +17962,18 @@ function renderHelpMarkdown(model) {
     out.push(model.note.trim(), "");
   }
   if (model.cmds.length > 0) {
-    const allFlat = model.cmds.every((c) => c.flatBody === true);
     out.push("## How to call");
     out.push("");
-    if (allFlat) {
-      out.push(
-        "Each command has its own direct URL; the request body is the arguments object itself:"
-      );
-      out.push("");
-      out.push("```");
-      out.push(`POST ${model.cmds[0]?.path ?? displayPath2(model.node.path)}`);
-      out.push("Content-Type: application/json");
-      out.push("");
-      out.push("{...arguments}");
-      out.push("```");
-    } else {
-      const invokePath = model.cmds[0]?.path ?? displayPath2(model.node.path);
-      out.push("Every command on this node is invoked with the same request shape:");
-      out.push("");
-      out.push("```");
-      out.push(`POST ${invokePath}`);
-      out.push("Content-Type: application/json");
-      out.push("");
-      out.push('{"tool": "<command name>", "arguments": {...}}');
-      out.push("```");
-    }
+    out.push(
+      "Each command has its own direct URL; the request body is the arguments object itself:"
+    );
+    out.push("");
+    out.push("```");
+    out.push(`POST ${model.cmds[0]?.path ?? displayPath2(model.node.path)}`);
+    out.push("Content-Type: application/json");
+    out.push("");
+    out.push("{...arguments}");
+    out.push("```");
     out.push("");
     out.push("`Required scope` names the permission your Secret Key must hold for that command.");
     out.push("");
@@ -19379,11 +19394,11 @@ function parseFrontmatter(text) {
 // ../core/src/skillhub/help.ts
 var SKILLHUB_CAPABILITIES = ["search"];
 var SCOPE_BY_CMD2 = {
-  List: "read",
-  Get: "read",
-  Search: "read",
-  Publish: "write",
-  Remove: "write"
+  list: "read",
+  get: "read",
+  search: "read",
+  publish: "write",
+  remove: "write"
 };
 function skillhubScopeForCmd(tool) {
   return SCOPE_BY_CMD2[tool] ?? null;
@@ -19410,9 +19425,9 @@ var PUBLISH_FILE_SCHEMA = {
 };
 function skillhubCmds(nodePath) {
   const path = cmdPath(nodePath);
-  return [
+  const cmds = [
     {
-      name: "List",
+      name: "list",
       method: "POST",
       path,
       h: "list published skills (id / name / description from SKILL.md frontmatter, paginated)",
@@ -19424,7 +19439,7 @@ function skillhubCmds(nodePath) {
       scope: "read"
     },
     {
-      name: "Get",
+      name: "get",
       method: "POST",
       path,
       h: "read a skill: SKILL.md body + file manifest; pass 'file' to fetch one bundled file (oversized/binary as { $ref })",
@@ -19443,7 +19458,7 @@ function skillhubCmds(nodePath) {
       scope: "read"
     },
     {
-      name: "Search",
+      name: "search",
       method: "POST",
       path,
       h: "keyword search over skill id / name / description",
@@ -19459,7 +19474,7 @@ function skillhubCmds(nodePath) {
       scope: "read"
     },
     {
-      name: "Publish",
+      name: "publish",
       method: "POST",
       path,
       h: "publish/replace a skill from a set of text files (must include SKILL.md with name+description frontmatter)",
@@ -19482,7 +19497,7 @@ function skillhubCmds(nodePath) {
       scope: "write"
     },
     {
-      name: "Remove",
+      name: "remove",
       method: "POST",
       path,
       h: "delete a skill and all its files (not_found if it does not exist)",
@@ -19495,6 +19510,7 @@ function skillhubCmds(nodePath) {
       effect: "destructive"
     }
   ];
+  return withCommandPaths(nodePath, cmds);
 }
 function skillhubHelpModel(node, opts = {}) {
   const cmds = skillhubCmds(node.path);
@@ -19581,7 +19597,7 @@ function createSkillhubProvider(store, opts) {
     };
   };
   return {
-    async List(listOpts) {
+    async list(listOpts) {
       const limit = clampLimit4(listOpts?.limit);
       const res = await store.list(keyPrefix, {
         delimiter: "/",
@@ -19601,7 +19617,7 @@ function createSkillhubProvider(store, opts) {
       }
       return res.cursor !== void 0 ? { items, cursor: res.cursor } : { items };
     },
-    async Get(idRaw) {
+    async get(idRaw) {
       const id = assertSkillId(idRaw);
       const { text, meta: meta3 } = await readDoc(id);
       const summary = summaryOf(id, text, meta3);
@@ -19623,7 +19639,7 @@ function createSkillhubProvider(store, opts) {
       } while (cursor !== void 0);
       return { ...summary, content: text, files };
     },
-    async GetFile(idRaw, file2) {
+    async get_file(idRaw, file2) {
       const id = assertSkillId(idRaw);
       const rel = normalizeEntryPath(file2);
       const key = `${skillPrefix(id)}${rel}`;
@@ -19638,7 +19654,7 @@ function createSkillhubProvider(store, opts) {
       if (!got) throw TBError.notFound(`skill \u6587\u4EF6\u4E0D\u5B58\u5728:'${id}/${rel}'`);
       return { ...base, content: await readStreamText(got.body) };
     },
-    async Search(query, searchOpts) {
+    async search(query, searchOpts) {
       if (typeof query !== "string" || query === "") {
         throw new TBError("invalid_argument", "query \u4E0D\u80FD\u4E3A\u7A7A");
       }
@@ -19690,8 +19706,8 @@ ${summary.description}`.toLowerCase();
       } while (storeCursor !== void 0);
       return hasMore && lastPrefix !== void 0 ? { items, cursor: lastPrefix } : { items };
     },
-    async Publish(input) {
-      assertWritable("Publish");
+    async publish(input) {
+      assertWritable("publish");
       if (!Array.isArray(input.files) || input.files.length === 0) {
         throw new TBError("invalid_argument", "files \u4E0D\u80FD\u4E3A\u7A7A");
       }
@@ -19734,8 +19750,8 @@ ${summary.description}`.toLowerCase();
       }
       return { id, name: fm.name, description: fm.description, fileCount: files.length };
     },
-    async Remove(idRaw) {
-      assertWritable("Remove");
+    async remove(idRaw) {
+      assertWritable("remove");
       const id = assertSkillId(idRaw);
       const prefix = skillPrefix(id);
       let cursor;
@@ -19811,9 +19827,8 @@ function toolToCmd(nodePath, tool, index) {
   const cmd = {
     name: tool.name,
     method: "POST",
-    path: `${cmdPath(nodePath)}/${tool.name}`,
-    scope: "call",
-    flatBody: true
+    path: `/${nodePath}/${tool.name}`,
+    scope: "call"
   };
   if (tool.description !== void 0) {
     cmd.h = index ? summarizeOneLine(tool.description) : tool.description;
@@ -20018,16 +20033,16 @@ var NodeRegistryStore = class {
     const page = await this.store.list(this.subtreePrefix(norm), { limit: 1 });
     return page.items.length > 0;
   }
-  /** 取单个;不存在 → not_found。 */
+  /** 取单个;不存在 → not_found。路径大小写不敏感(规范化为小写后查)。 */
   async get(path) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const node = await this.read(norm);
     if (!node) throw new TBError("not_found", `\u8282\u70B9\u4E0D\u5B58\u5728:'${norm}'`);
     return node;
   }
-  /** 批量取节点；路径先规范化去重，不存在的节点不进入返回 Map。 */
+  /** 批量取节点；路径先规范化(小写)去重，不存在的节点不进入返回 Map。 */
   async getMany(paths) {
-    const canonical = [...new Set(paths.map((path) => normalizePath(path)))];
+    const canonical = [...new Set(paths.map((path) => canonicalizePath(path)))];
     const values = await this.store.getMany(canonical.map((path) => this.keyOf(path)));
     const out = /* @__PURE__ */ new Map();
     for (const path of canonical) {
@@ -20041,7 +20056,7 @@ var NodeRegistryStore = class {
    * 无 prefix = 全树。cursor 为上一页末节点的 path。
    */
   async list(prefix, opts) {
-    const normPrefix = prefix === void 0 ? "" : normalizePath(prefix);
+    const normPrefix = prefix === void 0 ? "" : canonicalizePath(prefix);
     const limit = clampLimit5(opts?.limit);
     const all = (await this.scanAll()).filter((n) => isPrefixOf(normPrefix, n.path)).sort(byPath);
     const cursor = opts?.cursor;
@@ -20055,7 +20070,7 @@ var NodeRegistryStore = class {
   }
   /** 直接子节点(段深恰好 +1);~help 列子节点用。只扫子树前缀,不扫全树。 */
   async children(path) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const depth = segments(norm).length;
     const sub = await this.scanPrefix(this.subtreePrefix(norm));
     return sub.filter((n) => segments(n.path).length === depth + 1).sort(byPath);
@@ -20066,7 +20081,7 @@ var NodeRegistryStore = class {
    * 不存在的根返回空数组(调用方自行判 not_found)。
    */
   async subtree(path, opts) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     if (opts?.maxNodes !== void 0 && (!Number.isInteger(opts.maxNodes) || opts.maxNodes < 1)) {
       throw new TBError("invalid_argument", "maxNodes \u5FC5\u987B\u662F\u6B63\u6574\u6570");
     }
@@ -20107,9 +20122,9 @@ var NodeRegistryStore = class {
    * conflict(覆盖他人节点)判定在网关注册路径层,不在此——本层是幂等 upsert。
    */
   async write(node, registeredBy, now, opts = {}) {
-    const path = normalizePath(node.path);
-    const invalid2 = validatePath(path);
+    const invalid2 = validatePath(node.path);
     if (invalid2) throw invalid2;
+    const path = canonicalizePath(node.path);
     assertKindConfig(node);
     for (const parent of parentPaths(path)) {
       if (!await this.read(parent)) {
@@ -20142,10 +20157,10 @@ var NodeRegistryStore = class {
   }
   /** 部分更新(patch);不存在 → not_found;path 不可改。 */
   async update(path, patch, now) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const existing = await this.read(norm);
     if (!existing) throw new TBError("not_found", `\u8282\u70B9\u4E0D\u5B58\u5728:'${norm}'`);
-    if (patch.path !== void 0 && normalizePath(patch.path) !== norm) {
+    if (patch.path !== void 0 && canonicalizePath(patch.path) !== norm) {
       throw new TBError("invalid_argument", "path \u4E0D\u53EF\u901A\u8FC7 Update \u53D8\u66F4");
     }
     const merged = {
@@ -20167,7 +20182,7 @@ var NodeRegistryStore = class {
    * `lastSeenAt`(用于展示"最后在线于")。
    */
   async setOnline(path, online, now) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const existing = await this.read(norm);
     if (!existing) throw new TBError("not_found", `\u8282\u70B9\u4E0D\u5B58\u5728:'${norm}'`);
     const updated = {
@@ -20184,7 +20199,7 @@ var NodeRegistryStore = class {
    * 不该扰动 updatedAt 的语义)。节点不存在时静默返回——心跳晚于节点删除是正常竞态,不报错。
    */
   async touchSeen(path, now) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const existing = await this.read(norm);
     if (!existing) return;
     await this.store.put(this.keyOf(norm), { ...existing, lastSeenAt: now });
@@ -20197,7 +20212,7 @@ var NodeRegistryStore = class {
    * (不允许删除非空子树;显式 directory 同理)。
    */
   async delete(path) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const existing = await this.read(norm);
     if (!existing) throw new TBError("not_found", `\u8282\u70B9\u4E0D\u5B58\u5728:'${norm}'`);
     if (await this.hasChildren(norm)) {
@@ -20216,7 +20231,7 @@ var NodeRegistryStore = class {
    * 普通管理面仍使用 delete(),不允许误删非空子树。
    */
   async deleteSubtree(path) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const existing = await this.read(norm);
     if (!existing) throw new TBError("not_found", `\u8282\u70B9\u4E0D\u5B58\u5728:'${norm}'`);
     const descendants = await this.scanPrefix(this.subtreePrefix(norm));
@@ -20235,7 +20250,7 @@ var NodeRegistryStore = class {
    * 完全匹配 → rest=''。无任何匹配 → not_found。
    */
   async resolve(path) {
-    const norm = normalizePath(path);
+    const norm = canonicalizePath(path);
     const candidates = [norm, ...parentPaths(norm).reverse()];
     for (const cand of candidates) {
       const node = await this.read(cand);