@tool-bridge/server 0.4.0 → 0.7.0

package/dist/{firehydrant-WJT2MLGI.js → firehydrant-5T3UHAQM.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/firehydrant/api.ts

package/dist/{fixer-TG5NW6OA.js → fixer-3RMJLMFO.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/fixer/api.ts

package/dist/{fly-LYK5NNBG.js → fly-NPHJC5MH.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/fly/api.ts

package/dist/{front-MUQ4YT7O.js → front-PYGXJAQK.js}

@@ -2,14 +2,14 @@ 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 {
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/front/api.ts

package/dist/{geocodio-XXB2D3AN.js → geocodio-T6G3FVIF.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/geocodio/api.ts

package/dist/{ghost-MWYITKQ5.js → ghost-L3XIF4SJ.js}

@@ -2,16 +2,16 @@ import {
   createProviderPlugin,
   requireCredential,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   assertPublicHttpUrl,
   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/ghost/api.ts

package/dist/{github-CIBT2UB2.js → github-7YDUB6N6.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/github/api/shared.ts

package/dist/{gmail-JZECDA2U.js → gmail-RY2ZDG3B.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/gmail/api/shared.ts

package/dist/{googlecalendar-ICIIDGEO.js → googlecalendar-EHOFMXHE.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/googlecalendar/api/shared.ts

package/dist/{googledocs-AV5CHSH3.js → googledocs-BA3OAMKA.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/googledocs/api/shared.ts

package/dist/{grafana-SJVGZAV5.js → grafana-PYZQ4CKI.js}

@@ -2,16 +2,16 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   assertPublicHttpUrl,
   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/grafana/api.ts

package/dist/{graphhopper-ZVBBXBHD.js → graphhopper-3P4YU45N.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/graphhopper/api.ts

package/dist/index.d.ts

@@ -211,7 +211,7 @@ type PluginOAuth = z.infer<typeof pluginOAuthSchema>;
 type PluginProfile = 'tools/v1' | 'context/v1';
 /** 单个 export 的声明。 */
 interface PluginExport {
-    /** 明确声明无需凭证,或声明单值凭证的展示/必填语义。缺省兼容为可选单值凭证。 */
+    /** 明确声明无需凭证,或声明单值凭证的展示/必填语义；与 oauth/credentialFields 三选一。 */
     auth?: PluginExportAuth;
     capabilities?: string[];
     /**
@@ -316,14 +316,8 @@ interface PluginDescribe {
  * `/~describe` 生成(`@tool-bridge/plugins` 的 `catalog.generated.ts`),与插件代码同一份
  * 构建产物 —— 故不可能陈旧,也不需要落 KV。
  *
- * 这里定的是**解析函数的能力边界**。此前 `requirePluginExport` 拿的是 `deps`
- * (含可写 `state`),于是 help/call 这类读操作也能写库:`manifest ??= autoRegisterBinding(…)`
- * 让"删掉一个 plugin 后随便读一次就复活",而 7 个调用点里传 `deps` 还是传裸 store
- * 是随手决定的 —— 同一个语义在四条链上有四种行为。
- *
- * 修法不是"约定读路径要传只读的东西",而是**让解析函数结构上拿不到写能力**:
- * 下面三个函数的入参只有 catalog(纯值)与 {@link ReadOnlyStore}(只有 get)。
- * 想在这里写库得先改签名,而那是 code review 能看见的事。
+ * 这里定的是**解析函数的能力边界**。下面三个函数的入参只有 catalog(纯值)与
+ * {@link ReadOnlyStore}(只有 get)，因此 help/call 等读路径结构上不能创建或修写注册状态。
  */
 
 /** 一个内置目录项:插件声明了什么,以及它的 descriptor 指纹。 */
@@ -467,6 +461,34 @@ interface ObjectStore {
     put(key: string, body: ObjectBody, opts?: ObjectPutOptions): Promise<ObjectMeta>;
 }
 
+/**
+ * DeviceFrame:设备 WS 帧协议的类型与编解码。
+ *
+ * JSON 文本帧、`type` 区分;decode 拒绝非 JSON / 未知 type / 缺字段(invalid_argument),
+ * encode 产出紧凑 JSON。ping/pong 序列化为稳定字面量(PING_FRAME_JSON/PONG_FRAME_JSON)——
+ * DO 的 setWebSocketAutoResponse 按字符串精确匹配,设备侧心跳帧不得有其他序列化形态。
+ */
+
+/**
+ * 网关鉴权后为本次 call 生成的调用方来源与权威期限。
+ * 全部由网关签发,不接受来自调用 arguments;设备只消费不自造,且不做授权裁决
+ * (scope 判定在网关侧已完成)。故意不含 scopes / SK / 敏感参数。
+ */
+interface DeviceCallContext {
+    caller: {
+        displayName?: string;
+        /** 本次调用使用的 SK id(非明文,审计用)。 */
+        keyId: string;
+        owner: OwnerRef;
+    };
+    /** 网关签发时刻(网关时钟,非设备本地时钟)。 */
+    createdAt: Timestamp;
+    /** 本次调用的权威失效时刻;设备复检一律以此比对,不信任设备本地时钟。 */
+    expiresAt: Timestamp;
+    /** 全链路观测,与 call id 同源。 */
+    traceId: string;
+}
+
 /**
  * Tool Layer 的中立类型。
  *
@@ -700,11 +722,13 @@ interface RemoteSettings {
 /** 帧协议 call 转发的入参(id 由调用点生成,幂等键)。 */
 interface DeviceInvokeRequest {
     arguments: Record<string, unknown>;
+    /** 网关鉴权后的调用方来源与权威期限;缺省则不写入 call 帧。 */
+    context?: DeviceCallContext;
     id: string;
     path: string;
     tool: string;
 }
-/** 设备通道宿主(CF = DeviceSession DO / Docker = ws;deviceTransport 的消费面)。 */
+/** 设备通道宿主(CF = DeviceSession DO / Docker = ws)。 */
 interface DeviceChannel {
     /** HTTP→WS 调用转发:结果为 DeviceCallResult 形状(设备侧 result 帧)。 */
     invoke(deviceId: string, req: DeviceInvokeRequest): Promise<unknown>;
@@ -752,7 +776,7 @@ interface TbAppDeps {
     /**
      * 内置插件目录(descriptor)。**编译期常量**,由 `@tool-bridge/plugins` 的
      * `catalog.generated.ts` 求值生成 —— 内置插件的目录项与它的代码是同一份构建产物,
-     * 故不会陈旧、也不落库(见 `llmdoc/memory/decisions/builtin-catalog-not-registry.md`)。
+     * 故不会陈旧、也不落库(见 `llmdoc/architecture/plugin-runtime.md`)。
      *
      * 与 {@link pluginBindings} **是一对**:catalog 说"声明了什么"(挂载校验、选 export、
      * 列凭证字段),bindings 说"代码在哪"(实际调用)。装配了 binding 却没给 catalog,

package/dist/index.js

@@ -6,8 +6,8 @@ import {
   configFromEnv,
   createDataObjectStore,
   createTbServer
-} from "./chunk-OKQUN7BC.js";
-import "./chunk-F4O6ZRH7.js";
+} from "./chunk-7ASYWVYP.js";
+import "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 export {
   DEVICE_WS_PATH,

package/dist/{ip2proxy-EJMBZ4ZQ.js → ip2proxy-GQO6VF4P.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/ip2proxy/schema.ts

package/dist/{ipgeolocation_io-7BP766PO.js → ipgeolocation_io-VOZU6E7H.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/ipgeolocation_io/api.ts

package/dist/{ipqualityscore-QSB62FH3.js → ipqualityscore-XDJ3TTMM.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/ipqualityscore/api.ts

package/dist/{jina_ai-O5GT4ZZZ.js → jina_ai-ELXPSTUJ.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/jina_ai/api.ts

package/dist/{jira-DFOD6SAV.js → jira-INDXWO4I.js}

@@ -2,16 +2,16 @@ import {
   createProviderPlugin,
   requireCredential,
   upstreamError
-} from "./chunk-TKKRVFMK.js";
+} from "./chunk-BUHY4IE6.js";
 import {
   assertPublicHttpUrl,
   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/jira/api.ts

package/dist/{langsmith-B5HC4HNY.js → langsmith-PMCQBCIK.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/langsmith/api.ts

package/dist/{lemlist-63EOIXDT.js → lemlist-VWZXIHJX.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/lemlist/api.ts

package/dist/{linear-LBQC6RCY.js → linear-YXG4KZR4.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/linear/api.ts

package/dist/{logsnag-YQL67XIX.js → logsnag-XENBYHHK.js}

@@ -2,14 +2,14 @@ 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 {
   external_exports
-} from "./chunk-F4O6ZRH7.js";
+} from "./chunk-76YX7XSX.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/logsnag/api.ts