@tool-bridge/server 0.4.0 → 0.7.0

package/dist/{airtable-K3I4W27V.js → airtable-BNVPDLF2.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   guardedFetch
-} from "./chunk-CYTI7JDJ.js";
-import "./chunk-XE34TXY6.js";
+} from "./chunk-EBO6Q4NR.js";
+import "./chunk-GMHELPK3.js";
 import {
   TBError,
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/airtable/api.ts

package/dist/{alt_text_generator_ai-NE5YYNW3.js → alt_text_generator_ai-RMQPHK2Y.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   guardedFetch
-} from "./chunk-CYTI7JDJ.js";
-import "./chunk-XE34TXY6.js";
+} from "./chunk-EBO6Q4NR.js";
+import "./chunk-GMHELPK3.js";
 import {
   TBError,
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/alt_text_generator_ai/schema.ts

package/dist/{amap-C2Y347XH.js → amap-PRNZPQ34.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   guardedFetch
-} from "./chunk-CYTI7JDJ.js";
-import "./chunk-XE34TXY6.js";
+} from "./chunk-EBO6Q4NR.js";
+import "./chunk-GMHELPK3.js";
 import {
   TBError,
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/amap/api.ts

package/dist/{anthropic-HEEOKRI7.js → anthropic-A76VIXR7.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   guardedFetch
-} from "./chunk-CYTI7JDJ.js";
-import "./chunk-XE34TXY6.js";
+} from "./chunk-EBO6Q4NR.js";
+import "./chunk-GMHELPK3.js";
 import {
   TBError,
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/anthropic/api.ts

package/dist/{apify-4SCWADEP.js → apify-2Q2CTLKE.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   guardedFetch
-} from "./chunk-CYTI7JDJ.js";
-import "./chunk-XE34TXY6.js";
+} from "./chunk-EBO6Q4NR.js";
+import "./chunk-GMHELPK3.js";
 import {
   TBError,
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/apify/api.ts

package/dist/{brave_search-UDLPBEMQ.js → brave_search-5YJJVPXH.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   guardedFetch
-} from "./chunk-CYTI7JDJ.js";
-import "./chunk-XE34TXY6.js";
+} from "./chunk-EBO6Q4NR.js";
+import "./chunk-GMHELPK3.js";
 import {
   TBError,
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/brave_search/api.ts

package/dist/{chunk-F4O6ZRH7.js → chunk-76YX7XSX.js}

@@ -15089,24 +15089,27 @@ function projectExportAuth(exported) {
     return { kind: "fields", fields: exported.credentialFields };
   }
   if (exported.auth?.kind === "none") return { kind: "none" };
+  if (exported.auth?.kind !== "single") {
+    throw new TBError(
+      "invalid_argument",
+      `catalog export '${exported.id}' \u5FC5\u987B\u663E\u5F0F\u58F0\u660E auth\u3001oauth \u6216 credentialFields`
+    );
+  }
   return {
     kind: "single",
-    // 兼容旧 descriptor:未显式声明 auth 时沿用“单值但可留空”。
-    required: exported.auth?.required ?? false,
-    ...exported.auth?.label !== void 0 ? { label: exported.auth.label } : {},
-    ...exported.auth?.description !== void 0 ? { description: exported.auth.description } : {}
+    required: exported.auth.required ?? false,
+    ...exported.auth.label !== void 0 ? { label: exported.auth.label } : {},
+    ...exported.auth.description !== void 0 ? { description: exported.auth.description } : {}
   };
 }
 function projectListItem(entry) {
   const exports = entry.describe.exports;
   const kinds = /* @__PURE__ */ new Set();
-  const exportKinds = {};
   const exportDetails = {};
   for (const e of exports) {
     const kind = NODE_KIND_BY_PROFILE[e.profile];
     if (kind !== void 0) {
       kinds.add(kind);
-      exportKinds[e.id] = kind;
       exportDetails[e.id] = {
         id: e.id,
         kind,
@@ -15116,20 +15119,14 @@ function projectListItem(entry) {
       };
     }
   }
-  const withFields = exports.find((e) => e.credentialFields !== void 0);
-  const withMountConfig = exports.find((e) => e.mountConfigFields !== void 0);
   const description = exports.find((e) => e.description !== void 0)?.description;
   return {
     id: entry.id,
     digest: entry.digest,
     exports: exports.map((e) => e.id),
-    exportKinds,
     exportDetails,
     nodeKinds: [...kinds].sort(),
-    needsOAuth: exports.some((e) => e.oauth !== void 0),
-    ...description !== void 0 ? { description } : {},
-    ...withFields?.credentialFields !== void 0 ? { credentialFields: withFields.credentialFields } : {},
-    ...withMountConfig?.mountConfigFields !== void 0 ? { mountConfigFields: withMountConfig.mountConfigFields } : {}
+    ...description !== void 0 ? { description } : {}
   };
 }
 function matches2(item, query) {
@@ -15145,7 +15142,7 @@ function catalogCmds(nodePath) {
       path,
       h: "list built-in integrations available on this host (no credentials, read scope)",
       inputSchema: { type: "object", properties: { opts: LIST_OPTS_SCHEMA } },
-      returns: "Page<CatalogListItem> \u2014 id, exports, nodeKinds, credential field names",
+      returns: "Page<CatalogListItem> \u2014 id, exports, nodeKinds, exportDetails",
       scope: "read"
     },
     {
@@ -15505,6 +15502,12 @@ function validatePluginContract(input) {
       throw new TBError("invalid_argument", `plugin '${manifest.id}' \u7684 export id \u91CD\u590D:'${exported.id}'`);
     }
     seen.add(exported.id);
+    if (exported.auth === void 0 && exported.oauth === void 0 && exported.credentialFields === void 0) {
+      throw new TBError(
+        "invalid_argument",
+        `plugin '${manifest.id}' export '${exported.id}' \u5FC5\u987B\u663E\u5F0F\u58F0\u660E auth\u3001oauth \u6216 credentialFields`
+      );
+    }
     if (exported.auth !== void 0) {
       if (exported.oauth !== void 0 || exported.credentialFields !== void 0) {
         throw new TBError(
@@ -15671,14 +15674,14 @@ var authSchema = external_exports.discriminatedUnion("kind", [
 ]);
 var manifestSchema = external_exports.object({
   id: external_exports.string().regex(ID_RE, "id \u987B\u4E3A path-segment \u5B89\u5168\u5B57\u7B26([A-Za-z0-9._-],\u4E0D\u4EE5\u6807\u70B9\u5F00\u5934)"),
-  protocolVersion: external_exports.string().default(PLUGIN_PROTOCOL_VERSION).refine((v) => v === PLUGIN_PROTOCOL_VERSION, {
+  protocolVersion: external_exports.string().refine((v) => v === PLUGIN_PROTOCOL_VERSION, {
     error: `protocolVersion \u987B\u4E3A '${PLUGIN_PROTOCOL_VERSION}'`
   }),
   endpoint: external_exports.string().min(1),
   auth: authSchema,
   healthPath: external_exports.string().regex(/^\//, "healthPath \u987B\u4EE5 '/' \u5F00\u5934"),
   enabled: external_exports.boolean()
-});
+}).strict();
 function parsePluginManifest(value, opts = {}) {
   const parsed = manifestSchema.safeParse(value);
   if (!parsed.success) {
@@ -15796,15 +15799,6 @@ function pluginCmds(nodePath) {
       inputSchema: idSchema2,
       returns: "{ id, healthy, checkedAt }",
       scope: "admin"
-    },
-    {
-      name: "catalog",
-      method: "POST",
-      path,
-      h: "list in-process plugins assembled by this host (available, not yet activated); register one via write with its endpoint value",
-      inputSchema: { type: "object", properties: {} },
-      returns: "{ items: Array<{ name, endpoint, registered, pluginId? }> }",
-      scope: "admin"
     }
   ];
 }
@@ -15824,10 +15818,14 @@ function createPluginModule(deps) {
   }
   async function view(record2) {
     const describe3 = await store.get(KEY_PLUGIN_META + record2.id);
-    return {
-      ...projectManifest(record2),
-      ...describe3?.exports !== void 0 ? { exports: describe3.exports } : {}
-    };
+    if (describe3 === null) {
+      throw new TBError(
+        "unavailable",
+        `plugin '${record2.id}' \u7F3A\u5C11 ~describe \u7F13\u5B58,\u8BF7\u91CD\u65B0\u6CE8\u518C`,
+        { retryable: false }
+      );
+    }
+    return { ...projectManifest(record2), exports: describe3.exports };
   }
   async function revokeToken(record2) {
     if (record2.tokenSkId !== void 0) await sk.delete(record2.tokenSkId);
@@ -15991,33 +15989,6 @@ function createPluginModule(deps) {
           const record2 = await probeAndRecord(manifest);
           return { id, healthy: record2.healthy, checkedAt: record2.checkedAt };
         }
-        case "catalog": {
-          const names = deps.bindings?.() ?? [];
-          const byEndpoint = /* @__PURE__ */ new Map();
-          let cursor;
-          do {
-            const page = await store.list(KEY_PLUGIN, {
-              limit: LIST_LIMIT_MAX,
-              ...cursor !== void 0 ? { cursor } : {}
-            });
-            for (const { value } of page.items) {
-              const record2 = value;
-              byEndpoint.set(record2.endpoint, record2.id);
-            }
-            cursor = page.cursor;
-          } while (cursor !== void 0);
-          const items = [...names].sort().map((name) => {
-            const endpoint = `binding:${name}`;
-            const pluginId = byEndpoint.get(endpoint);
-            return {
-              name,
-              endpoint,
-              registered: pluginId !== void 0,
-              ...pluginId !== void 0 ? { pluginId } : {}
-            };
-          });
-          return { items };
-        }
         default:
           throw new TBError("invalid_argument", `unknown cmd '${cmd}' on system/plugin`);
       }
@@ -17284,6 +17255,7 @@ var deviceNodeCmdSchema = external_exports.object({
   name: external_exports.string().min(1),
   description: external_exports.string().optional(),
   inputSchema: external_exports.unknown().optional(),
+  outputSchema: external_exports.unknown().optional(),
   effect: external_exports.string().optional(),
   confirm: external_exports.boolean().optional()
 }).passthrough();
@@ -17305,6 +17277,16 @@ var deviceExposeSchema = external_exports.object({
   nodes: external_exports.array(nodeInputSchema).optional()
 });
 var idSchema = external_exports.string().min(1);
+var deviceCallContextSchema = external_exports.object({
+  caller: external_exports.object({
+    keyId: external_exports.string().min(1),
+    owner: external_exports.string().min(1),
+    displayName: external_exports.string().optional()
+  }).passthrough(),
+  traceId: external_exports.string().min(1),
+  createdAt: external_exports.string().min(1),
+  expiresAt: external_exports.string().min(1)
+}).passthrough();
 var schemaByType = {
   hello: external_exports.object({
     type: external_exports.literal("hello"),
@@ -17319,7 +17301,8 @@ var schemaByType = {
     id: idSchema,
     path: external_exports.string(),
     tool: external_exports.string().min(1),
-    arguments: external_exports.record(external_exports.string(), external_exports.unknown())
+    arguments: external_exports.record(external_exports.string(), external_exports.unknown()),
+    context: deviceCallContextSchema.optional()
   }),
   result: external_exports.discriminatedUnion("ok", [
     external_exports.object({ type: external_exports.literal("result"), id: idSchema, ok: external_exports.literal(true), value: external_exports.unknown() }),
@@ -17414,13 +17397,33 @@ function deviceDirectoryHelpModel(node, children = []) {
     node: {
       path: node.path,
       kind: "directory",
-      description: `${node.description} (${node.online ? "online" : "offline"})`
+      description: `${node.description} (${node.presence.state})`
     },
     cmds: [],
     children
   };
 }
 
+// ../core/src/device/presence.ts
+var PRESENCE_STALE_AFTER_MS = 9e4;
+function derivePresence(input) {
+  const lastSeenAt = input.lastSeenAt;
+  const base = lastSeenAt !== void 0 ? { lastSeenAt } : {};
+  if (input.online !== true) {
+    return { state: "offline", ...base };
+  }
+  if (lastSeenAt === void 0) {
+    return { state: "stale", ...base };
+  }
+  const seenMs = Date.parse(lastSeenAt);
+  const nowMs = Date.parse(input.now);
+  if (!Number.isFinite(seenMs) || !Number.isFinite(nowMs)) {
+    return { state: "stale", ...base };
+  }
+  const ttl = input.staleAfterMs ?? PRESENCE_STALE_AFTER_MS;
+  return { state: nowMs - seenMs <= ttl ? "online" : "stale", ...base };
+}
+
 // ../core/src/device/session.ts
 var DEVICE_CALL_TIMEOUT_MS = 6e4;
 var DEVICE_REJECT_CLOSE_CODE = 1008;
@@ -17528,7 +17531,9 @@ var DeviceGatewaySession = class {
       id: req.id,
       path: req.path,
       tool: req.tool,
-      arguments: req.arguments
+      arguments: req.arguments,
+      // undefined 经 JSON.stringify 丢弃:老网关不带 context 时帧形状不变。
+      ...req.context !== void 0 ? { context: req.context } : {}
     });
   }
   /** 幂等表回放种子(DO 从 ctx.storage 恢复时用);已有同 id 结果则忽略。 */
@@ -18028,7 +18033,7 @@ async function buildTree(opts) {
     visited.add(entry.path);
     count++;
     const node = { path: entry.path, kind: entry.kind, description: entry.description };
-    if (entry.online !== void 0) node.online = entry.online;
+    if (entry.presence !== void 0) node.presence = entry.presence;
     if (depthLeft <= 0) {
       if (opts.opaqueKinds?.has(entry.kind)) {
         node.truncated = true;
@@ -18052,7 +18057,7 @@ async function buildTree(opts) {
           description: kid.description,
           truncated: true
         };
-        if (kid.online !== void 0) cyc.online = kid.online;
+        if (kid.presence !== void 0) cyc.presence = kid.presence;
         count++;
         children.push(cyc);
         continue;
@@ -18247,8 +18252,7 @@ async function resolveExternalExport(store, id, nodeKind, what, exportId) {
 }
 async function resolveIntegration(store, catalog, id, nodeKind, what, exportId) {
   const manifest = await store.get(KEY_PLUGIN + id);
-  const isBinding = manifest?.endpoint.startsWith("binding:") === true;
-  if (manifest !== null && !(isBinding && catalog[id] !== void 0)) {
+  if (manifest !== null) {
     return await resolveExternalExport(store, id, nodeKind, what, exportId);
   }
   return resolveBuiltinExport(catalog, id, nodeKind, what, exportId);
@@ -18424,25 +18428,6 @@ function decodePluginCall(body) {
   return parsed.data;
 }
 
-// ../core/src/plugin/package.ts
-var PLUGIN_BUNDLE_MAX_BYTES = 5 * 1024 * 1024;
-var NAME_RE = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
-var SHA256_HEX_RE = /^[0-9a-f]{64}$/;
-var VERSION_RE = /^\d+\.\d+\.\d+(?:[-+.][A-Za-z0-9.-]+)?$/;
-var packageSchema = external_exports.object({
-  name: external_exports.string().regex(NAME_RE, "name \u987B\u4E3A path-segment \u5B89\u5168\u5B57\u7B26([A-Za-z0-9._-],\u4E0D\u4EE5\u6807\u70B9\u5F00\u5934)"),
-  version: external_exports.string().regex(VERSION_RE, "version \u987B\u4E3A semver(\u5982 1.2.3)"),
-  bundleUrl: external_exports.string().min(1),
-  sha256: external_exports.string().regex(SHA256_HEX_RE, "sha256 \u987B\u4E3A 64 \u4F4D hex \u5C0F\u5199"),
-  protocolVersion: external_exports.string().default(PLUGIN_PROTOCOL_VERSION).refine((v) => v === PLUGIN_PROTOCOL_VERSION, {
-    error: `protocolVersion \u987B\u4E3A '${PLUGIN_PROTOCOL_VERSION}'`
-  }),
-  healthPath: external_exports.string().regex(/^\//, "healthPath \u987B\u4EE5 '/' \u5F00\u5934"),
-  description: external_exports.string().optional(),
-  configSchema: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-  mountConfigSchema: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
-});
-
 // ../core/src/search/shortTermSql.ts
 function shortTermsSql(patterns) {
   return `short_terms(pattern) AS (VALUES ${patterns.map(() => "(?)").join(", ")})`;
@@ -19962,6 +19947,7 @@ var NodeRegistryStore = class {
       ...node.config !== void 0 ? { config: node.config } : {},
       ...node.virtualize !== void 0 ? { virtualize: node.virtualize } : {},
       ...opts.online !== void 0 ? { online: opts.online } : {},
+      ...opts.lastSeenAt !== void 0 ? { lastSeenAt: opts.lastSeenAt } : {},
       registeredBy,
       createdAt: existing?.createdAt ?? now,
       updatedAt: now
@@ -19990,15 +19976,34 @@ var NodeRegistryStore = class {
     await this.store.put(this.keyOf(norm), merged);
     return merged;
   }
-  /** 设备生命周期专用:只更新节点 online 状态,不存在 → not_found。 */
+  /**
+   * 设备生命周期专用:更新节点 online 状态,不存在 → not_found。
+   * online 翻 true 时视为一次存活观察,同步把 `lastSeenAt` 刷到 now;翻 false 时保留原
+   * `lastSeenAt`(用于展示"最后在线于")。
+   */
   async setOnline(path, online, now) {
     const norm = normalizePath(path);
     const existing = await this.read(norm);
     if (!existing) throw new TBError("not_found", `\u8282\u70B9\u4E0D\u5B58\u5728:'${norm}'`);
-    const updated = { ...existing, online, updatedAt: now };
+    const updated = {
+      ...existing,
+      online,
+      ...online ? { lastSeenAt: now } : {},
+      updatedAt: now
+    };
     await this.store.put(this.keyOf(norm), updated);
     return updated;
   }
+  /**
+   * 设备心跳专用:只把 `lastSeenAt` 刷到 now,不改 online 也不动 updatedAt(心跳不是元数据变更,
+   * 不该扰动 updatedAt 的语义)。节点不存在时静默返回——心跳晚于节点删除是正常竞态,不报错。
+   */
+  async touchSeen(path, now) {
+    const norm = normalizePath(path);
+    const existing = await this.read(norm);
+    if (!existing) return;
+    await this.store.put(this.keyOf(norm), { ...existing, lastSeenAt: now });
+  }
   /**
    * 卸载;不存在 → not_found。删除后自底向上级联回收:
    * 仅回收 registeredBy=system:auto 且再无子节点的 directory,遇显式节点/仍有子节点即停。
@@ -20137,6 +20142,8 @@ export {
   deviceShellHelpModel,
   deviceFsHelpModel,
   deviceDirectoryHelpModel,
+  derivePresence,
+  DEVICE_CALL_TIMEOUT_MS,
   DeviceGatewaySession,
   FEEDBACK_HIDE_SCORE,
   selectFeedbackSearchText,