@tool-bridge/server 0.5.0 → 0.10.0

package/dist/{chunk-7GP7DRES.js → chunk-SBJMMSPA.js}

@@ -1,6 +1,6 @@
 import {
   TBError
-} from "./chunk-7PM4FD5K.js";
+} from "./chunk-TPGTA43F.js";
 
 // ../plugins/src/_runtime/ipPolicy.ts
 function parseIpv4(value) {

package/dist/{chunk-7PM4FD5K.js → chunk-TPGTA43F.js}

@@ -14820,7 +14820,7 @@ function checkRegisterPath(input) {
   if (!checkScopes(sk.scopes, targetPath, "register")) {
     return deny(`no scope grants 'register' on '${targetPath}'`);
   }
-  if (existing && existing.registeredBy !== sk.id && existing.registeredBy !== SYSTEM_AUTO) {
+  if (existing && existing.registeredBy !== sk.id && existing.registeredBy !== SYSTEM_AUTO && !checkScopes(sk.scopes, targetPath, "admin")) {
     return {
       allow: false,
       error: new TBError("conflict", `path '${targetPath}' is registered by another key`)
@@ -16362,7 +16362,7 @@ function registryCmds(nodePath) {
       name: "delete",
       method: "POST",
       path,
-      h: "unmount a node (and reclaim empty auto-created parents)",
+      h: "unmount a node (and reclaim empty auto-created parents); a node registered by another key can only be removed by its registrar or by a key holding the 'admin' scope on that path",
       inputSchema: {
         type: "object",
         properties: { path: { type: "string", description: "exact tree path" } },
@@ -17255,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();
@@ -17276,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"),
@@ -17290,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() }),
@@ -17385,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;
@@ -17499,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 结果则忽略。 */
@@ -17999,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;
@@ -18023,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;
@@ -18394,32 +18428,6 @@ function decodePluginCall(body) {
   return parsed.data;
 }
 
-// ../core/src/search/shortTermSql.ts
-function shortTermsSql(patterns) {
-  return `short_terms(pattern) AS (VALUES ${patterns.map(() => "(?)").join(", ")})`;
-}
-var SHORT_MATCH_SQL = `
-NOT EXISTS (
-  SELECT 1 FROM short_terms
-  WHERE tools.name NOT LIKE pattern ESCAPE '!'
-    AND tools.description NOT LIKE pattern ESCAPE '!'
-    AND tools.feedback NOT LIKE pattern ESCAPE '!'
-)
-`;
-var SHORT_SCORE_SQL = `
-(
-  SELECT COALESCE(SUM(
-    CASE
-      WHEN tools.name LIKE pattern ESCAPE '!' THEN 10
-      WHEN tools.description LIKE pattern ESCAPE '!' THEN 3
-      WHEN tools.feedback LIKE pattern ESCAPE '!' THEN 1
-      ELSE 0
-    END
-  ), 0)
-  FROM short_terms
-)
-`;
-
 // ../core/src/search/types.ts
 var TOOL_SEARCH_BATCH_LIMIT = 100;
 var TOOL_SEARCH_WORK_LIMIT = 400;
@@ -18604,6 +18612,13 @@ function likePattern(term) {
   const escaped = term.replaceAll("!", "!!").replaceAll("%", "!%").replaceAll("_", "!_");
   return `%${escaped}%`;
 }
+function toolSearchLikePatterns(query) {
+  const terms = normalizeToolSearchQuery(query).split(/\s+/u);
+  if (terms.length > TOOL_SEARCH_TERM_LIMIT) {
+    throw new TBError("invalid_argument", `\u641C\u7D22 query \u6700\u591A ${TOOL_SEARCH_TERM_LIMIT} \u4E2A terms`);
+  }
+  return terms.map(likePattern);
+}
 function prepareToolSearchQuery(query) {
   const normalized = normalizeToolSearchQuery(query);
   const terms = normalized.split(/\s+/u);
@@ -18688,6 +18703,32 @@ async function decodeToolSearchCursor(cursor, query, mode, revision, secret) {
   return payload.o ?? 0;
 }
 
+// ../core/src/search/shortTermSql.ts
+function shortTermsSql(patterns) {
+  return `short_terms(pattern) AS (VALUES ${patterns.map(() => "(?)").join(", ")})`;
+}
+var SHORT_MATCH_SQL = `
+NOT EXISTS (
+  SELECT 1 FROM short_terms
+  WHERE tools.name NOT LIKE pattern ESCAPE '!'
+    AND tools.description NOT LIKE pattern ESCAPE '!'
+    AND tools.feedback NOT LIKE pattern ESCAPE '!'
+)
+`;
+var SHORT_SCORE_SQL = `
+(
+  SELECT COALESCE(SUM(
+    CASE
+      WHEN tools.name LIKE pattern ESCAPE '!' THEN 10
+      WHEN tools.description LIKE pattern ESCAPE '!' THEN 3
+      WHEN tools.feedback LIKE pattern ESCAPE '!' THEN 1
+      ELSE 0
+    END
+  ), 0)
+  FROM short_terms
+)
+`;
+
 // ../core/src/search/sqlSearchIndex.ts
 var TOOL_SEARCH_SCHEMA_STATEMENTS = [
   `CREATE TABLE IF NOT EXISTS tb_search_tools_v3 (
@@ -18825,12 +18866,34 @@ function toolSearchCandidateStatement(prepared, limit, offset) {
     `
   };
 }
+var sqliteSearchDialect = {
+  candidateStatement: (query, limit, offset) => toolSearchCandidateStatement(prepareToolSearchQuery(query), limit, offset),
+  schemaStatements: TOOL_SEARCH_SCHEMA_STATEMENTS,
+  statements: {
+    bumpRevision: BUMP_REVISION_SQL,
+    completeRebuild: COMPLETE_REBUILD_SQL,
+    deleteAllSnapshots: DELETE_ALL_SNAPSHOTS_SQL,
+    deleteAllTools: DELETE_ALL_TOOLS_SQL,
+    deleteSnapshot: DELETE_SNAPSHOT_SQL,
+    deleteSnapshotPrefix: DELETE_SNAPSHOT_PREFIX_SQL,
+    deleteTools: DELETE_TOOLS_SQL,
+    deleteToolsPrefix: DELETE_TOOLS_PREFIX_SQL,
+    insertSnapshot: TOOL_SEARCH_INSERT_SNAPSHOT_SQL,
+    meta: META_SQL,
+    pathState: PATH_STATE_SQL,
+    present: PRESENT_SQL,
+    presentPrefix: PRESENT_PREFIX_SQL,
+    snapshotDigests: SNAPSHOT_DIGESTS_SQL
+  }
+};
 var SqlSearchIndex = class {
-  constructor(driver) {
+  constructor(driver, dialect = sqliteSearchDialect) {
     this.driver = driver;
+    this.dialect = dialect;
   }
   driver;
   capabilities = ["search"];
+  dialect;
   /** 容量 trigger 的 ABORT 在各驱动里错误形状不同,统一按标记串归一。 */
   async writeOrCapacity(statements) {
     try {
@@ -18843,14 +18906,14 @@ var SqlSearchIndex = class {
     }
   }
   async meta() {
-    const row = await this.driver.first({ params: [], sql: META_SQL });
+    const row = await this.driver.first({ params: [], sql: this.dialect.statements.meta });
     if (row === null) throw new TBError("internal", "\u5DE5\u5177\u641C\u7D22 meta \u7F3A\u5931");
     return row;
   }
   async snapshotDigests() {
     const rows = await this.driver.all({
       params: [],
-      sql: SNAPSHOT_DIGESTS_SQL
+      sql: this.dialect.statements.snapshotDigests
     });
     return new Map(rows.map((row) => [row.path, row.digest]));
   }
@@ -18864,7 +18927,7 @@ var SqlSearchIndex = class {
     await this.driver.ensureSchema();
     const current = await this.driver.first({
       params: [canonical, canonical],
-      sql: PATH_STATE_SQL
+      sql: this.dialect.statements.pathState
     });
     const digest = records.length === 0 ? null : toolSearchSnapshotDigest(records);
     if (current !== null && (digest !== null && current.digest === digest || digest === null && current.digest === null && current.has_tools === 0)) return;
@@ -18873,12 +18936,13 @@ var SqlSearchIndex = class {
     }
     const inserts = this.driver.insertRecords(records);
     this.driver.assertInsertBudget?.(inserts.length);
+    const statements = this.dialect.statements;
     await this.writeOrCapacity([
-      { params: [canonical], sql: DELETE_TOOLS_SQL },
+      { params: [canonical], sql: statements.deleteTools },
       ...inserts,
-      { params: [canonical], sql: DELETE_SNAPSHOT_SQL },
-      ...digest === null ? [] : [{ params: [canonical, digest], sql: TOOL_SEARCH_INSERT_SNAPSHOT_SQL }],
-      { params: [], sql: BUMP_REVISION_SQL }
+      { params: [canonical], sql: statements.deleteSnapshot },
+      ...digest === null ? [] : [{ params: [canonical, digest], sql: statements.insertSnapshot }],
+      { params: [], sql: statements.bumpRevision }
     ]);
   }
   async remove(path) {
@@ -18886,13 +18950,14 @@ var SqlSearchIndex = class {
     await this.driver.ensureSchema();
     const current = await this.driver.first({
       params: [canonical],
-      sql: PRESENT_SQL
+      sql: this.dialect.statements.present
     });
     if (current === null) return;
+    const statements = this.dialect.statements;
     await this.driver.write([
-      { params: [canonical], sql: DELETE_TOOLS_SQL },
-      { params: [canonical], sql: DELETE_SNAPSHOT_SQL },
-      { params: [], sql: BUMP_REVISION_SQL }
+      { params: [canonical], sql: statements.deleteTools },
+      { params: [canonical], sql: statements.deleteSnapshot },
+      { params: [], sql: statements.bumpRevision }
     ]);
   }
   async removePrefix(path) {
@@ -18901,13 +18966,14 @@ var SqlSearchIndex = class {
     const prefixParams = [canonical, canonical, canonical];
     const current = await this.driver.first({
       params: prefixParams,
-      sql: PRESENT_PREFIX_SQL
+      sql: this.dialect.statements.presentPrefix
     });
     if (current === null) return;
+    const statements = this.dialect.statements;
     await this.driver.write([
-      { params: prefixParams, sql: DELETE_TOOLS_PREFIX_SQL },
-      { params: prefixParams, sql: DELETE_SNAPSHOT_PREFIX_SQL },
-      { params: [], sql: BUMP_REVISION_SQL }
+      { params: prefixParams, sql: statements.deleteToolsPrefix },
+      { params: prefixParams, sql: statements.deleteSnapshotPrefix },
+      { params: [], sql: statements.bumpRevision }
     ]);
   }
   async rebuild(documents) {
@@ -18921,12 +18987,13 @@ var SqlSearchIndex = class {
     const inserts = this.driver.insertRecords(records);
     const snapshots = this.driver.insertSnapshots(desired);
     this.driver.assertInsertBudget?.(inserts.length + snapshots.length);
+    const statements = this.dialect.statements;
     await this.writeOrCapacity([
-      { params: [], sql: DELETE_ALL_TOOLS_SQL },
-      { params: [], sql: DELETE_ALL_SNAPSHOTS_SQL },
+      { params: [], sql: statements.deleteAllTools },
+      { params: [], sql: statements.deleteAllSnapshots },
       ...inserts,
       ...snapshots,
-      { params: [], sql: COMPLETE_REBUILD_SQL }
+      { params: [], sql: statements.completeRebuild }
     ]);
   }
   async search(query, opts) {
@@ -18945,7 +19012,7 @@ var SqlSearchIndex = class {
     );
     const limit = Math.min(normalizeToolSearchLimit(opts?.limit), TOOL_SEARCH_BATCH_LIMIT);
     const rows = await this.driver.all(
-      toolSearchCandidateStatement(prepareToolSearchQuery(normalized), limit, offset)
+      this.dialect.candidateStatement(normalized, limit, offset)
     );
     const hasMore = rows.length > limit;
     const page = hasMore ? rows.slice(0, limit) : rows;
@@ -18984,6 +19051,145 @@ var SqlSearchIndex = class {
   }
 };
 
+// ../core/src/search/pgSearchDialect.ts
+var PG_SEARCH_SCHEMA_STATEMENTS = [
+  `CREATE TABLE IF NOT EXISTS tb_search_tools_v3 (
+    id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+    path text NOT NULL,
+    name text NOT NULL,
+    description text NOT NULL DEFAULT '',
+    feedback text NOT NULL DEFAULT '',
+    UNIQUE(path, name)
+  )`,
+  // 这里**故意不建 trigram GIN 索引**。实测(4000 条记录 = 500 节点上限满载):
+  // 候选查询是"三列 ILIKE 用 OR 连接 + LIMIT",规划器一律选 Seq Scan(整表仅 1 个
+  // buffer),GIN 索引一次都没被使用;而它让插入从 13.7ms 涨到 75.8ms(5.5×)、表总大小
+  // 从 1072 kB 涨到 7208 kB(6.7×),检索却仍是 0.50 vs 0.53ms —— 纯负担。
+  // 索引记录数受 TOOL_SEARCH_AUDIT_NODE_LIMIT 硬顶约束,不会增长到需要索引的规模;
+  // 若将来放宽该上限,应连同候选查询形状(拆成 UNION 或改单列检索列)一起重新评估。
+  `CREATE TABLE IF NOT EXISTS tb_search_meta_v3 (
+    singleton integer PRIMARY KEY CHECK (singleton = 1),
+    revision bigint NOT NULL DEFAULT 0,
+    seeded integer NOT NULL DEFAULT 0,
+    cursor_secret text NOT NULL
+  )`,
+  // cursor_secret 需 64 hex(32 字节)。两个内置 gen_random_uuid() 去连字符正好 64
+  // hex,避免依赖 pgcrypto 的 gen_random_bytes(自托管 PG 未必预装 pgcrypto)。
+  `INSERT INTO tb_search_meta_v3(singleton, revision, seeded, cursor_secret)
+    VALUES (
+      1, 0, 0,
+      replace(gen_random_uuid()::text, '-', '') || replace(gen_random_uuid()::text, '-', '')
+    )
+    ON CONFLICT (singleton) DO NOTHING`,
+  `CREATE TABLE IF NOT EXISTS tb_search_snapshots_v3 (
+    path text PRIMARY KEY,
+    digest text NOT NULL
+  )`,
+  `CREATE OR REPLACE FUNCTION tb_search_snapshots_v3_capacity()
+    RETURNS trigger AS $$
+    BEGIN
+      IF (SELECT COUNT(*) FROM tb_search_snapshots_v3) >= ${TOOL_SEARCH_AUDIT_NODE_LIMIT} THEN
+        RAISE EXCEPTION '${TOOL_SEARCH_CAPACITY_MARKER}';
+      END IF;
+      RETURN NEW;
+    END;
+    $$ LANGUAGE plpgsql`,
+  `DROP TRIGGER IF EXISTS tb_search_snapshots_v3_capacity_trg ON tb_search_snapshots_v3`,
+  `CREATE TRIGGER tb_search_snapshots_v3_capacity_trg
+    BEFORE INSERT ON tb_search_snapshots_v3
+    FOR EACH ROW EXECUTE FUNCTION tb_search_snapshots_v3_capacity()`
+];
+var PG_SEARCH_WRITE_LOCK_KEY = 2069799624;
+var PG_SEARCH_INSERT_SNAPSHOT_SQL = "INSERT INTO tb_search_snapshots_v3(path, digest) VALUES ($1, $2)";
+function pgBulkInsertSql(table, columns, rows) {
+  const tuples = [];
+  for (let r = 0; r < rows; r++) {
+    const placeholders = columns.map((_, c) => `$${r * columns.length + c + 1}`);
+    tuples.push(`(${placeholders.join(", ")})`);
+  }
+  return `INSERT INTO ${table} (${columns.join(", ")}) VALUES ${tuples.join(", ")}`;
+}
+var PG_SEARCH_TOOLS_TABLE = "tb_search_tools_v3";
+var PG_SEARCH_TOOLS_COLUMNS = ["path", "name", "description", "feedback"];
+var PG_SEARCH_SNAPSHOTS_TABLE = "tb_search_snapshots_v3";
+var PG_SEARCH_SNAPSHOTS_COLUMNS = ["path", "digest"];
+var PG_SEARCH_INSERT_ROWS_MAX = 1e3;
+var META_SQL2 = `
+SELECT revision::int AS revision, seeded::int AS seeded, cursor_secret
+FROM tb_search_meta_v3 WHERE singleton = 1
+`;
+var SNAPSHOT_DIGESTS_SQL2 = "SELECT path, digest FROM tb_search_snapshots_v3 ORDER BY path";
+var PATH_STATE_SQL2 = `
+SELECT snapshots.digest,
+  EXISTS(SELECT 1 FROM tb_search_tools_v3 WHERE path = $1)::int AS has_tools,
+  (SELECT COUNT(*) FROM tb_search_snapshots_v3)::int AS path_count
+FROM (SELECT 1) AS singleton
+LEFT JOIN tb_search_snapshots_v3 AS snapshots ON snapshots.path = $2
+`;
+var PRESENT_SQL2 = "SELECT 1 AS present FROM tb_search_tools_v3 WHERE path = $1 LIMIT 1";
+var PRESENT_PREFIX_SQL2 = `
+SELECT 1 AS present FROM tb_search_tools_v3
+WHERE path = $1 OR substr(path, 1, length($2) + 1) = $3 || '/'
+LIMIT 1
+`;
+var DELETE_TOOLS_SQL2 = "DELETE FROM tb_search_tools_v3 WHERE path = $1";
+var DELETE_SNAPSHOT_SQL2 = "DELETE FROM tb_search_snapshots_v3 WHERE path = $1";
+var DELETE_TOOLS_PREFIX_SQL2 = `
+DELETE FROM tb_search_tools_v3
+WHERE path = $1 OR substr(path, 1, length($2) + 1) = $3 || '/'
+`;
+var DELETE_SNAPSHOT_PREFIX_SQL2 = `
+DELETE FROM tb_search_snapshots_v3
+WHERE path = $1 OR substr(path, 1, length($2) + 1) = $3 || '/'
+`;
+var DELETE_ALL_TOOLS_SQL2 = "DELETE FROM tb_search_tools_v3";
+var DELETE_ALL_SNAPSHOTS_SQL2 = "DELETE FROM tb_search_snapshots_v3";
+var BUMP_REVISION_SQL2 = "UPDATE tb_search_meta_v3 SET revision = revision + 1 WHERE singleton = 1";
+var COMPLETE_REBUILD_SQL2 = "UPDATE tb_search_meta_v3 SET seeded = 1, revision = revision + 1 WHERE singleton = 1";
+function pgCandidateStatement(query, limit, offset) {
+  const patterns = toolSearchLikePatterns(query);
+  const matchClauses = patterns.map((_, i) => {
+    const p = `$${i + 1}`;
+    return `(name ILIKE ${p} ESCAPE '!' OR description ILIKE ${p} ESCAPE '!' OR feedback ILIKE ${p} ESCAPE '!')`;
+  });
+  const scoreTerms = patterns.map((_, i) => {
+    const p = `$${i + 1}`;
+    return `CASE WHEN name ILIKE ${p} ESCAPE '!' THEN 10 WHEN description ILIKE ${p} ESCAPE '!' THEN 3 WHEN feedback ILIKE ${p} ESCAPE '!' THEN 1 ELSE 0 END`;
+  });
+  const limitParam = `$${patterns.length + 1}`;
+  const offsetParam = `$${patterns.length + 2}`;
+  return {
+    params: [...patterns, limit + 1, offset],
+    sql: `
+      SELECT id, path, name, (${scoreTerms.join(" + ")}) AS score
+      FROM tb_search_tools_v3
+      WHERE ${matchClauses.join(" AND ")}
+      ORDER BY score DESC, path, name
+      LIMIT ${limitParam} OFFSET ${offsetParam}
+    `
+  };
+}
+var pgSearchDialect = {
+  candidateStatement: pgCandidateStatement,
+  schemaStatements: PG_SEARCH_SCHEMA_STATEMENTS,
+  statements: {
+    bumpRevision: BUMP_REVISION_SQL2,
+    completeRebuild: COMPLETE_REBUILD_SQL2,
+    deleteAllSnapshots: DELETE_ALL_SNAPSHOTS_SQL2,
+    deleteAllTools: DELETE_ALL_TOOLS_SQL2,
+    deleteSnapshot: DELETE_SNAPSHOT_SQL2,
+    deleteSnapshotPrefix: DELETE_SNAPSHOT_PREFIX_SQL2,
+    deleteTools: DELETE_TOOLS_SQL2,
+    deleteToolsPrefix: DELETE_TOOLS_PREFIX_SQL2,
+    insertSnapshot: PG_SEARCH_INSERT_SNAPSHOT_SQL,
+    meta: META_SQL2,
+    pathState: PATH_STATE_SQL2,
+    present: PRESENT_SQL2,
+    presentPrefix: PRESENT_PREFIX_SQL2,
+    snapshotDigests: SNAPSHOT_DIGESTS_SQL2
+  }
+};
+
 // ../core/src/secret/secretStore.ts
 var AES_GCM_IV_BYTES = 12;
 var MASTER_KEY_BYTES = 32;
@@ -19913,6 +20119,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
@@ -19941,15 +20148,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,遇显式节点/仍有子节点即停。
@@ -20088,6 +20314,8 @@ export {
   deviceShellHelpModel,
   deviceFsHelpModel,
   deviceDirectoryHelpModel,
+  derivePresence,
+  DEVICE_CALL_TIMEOUT_MS,
   DeviceGatewaySession,
   FEEDBACK_HIDE_SCORE,
   selectFeedbackSearchText,
@@ -20129,6 +20357,14 @@ export {
   TOOL_SEARCH_INSERT_SQL,
   TOOL_SEARCH_INSERT_SNAPSHOT_SQL,
   SqlSearchIndex,
+  PG_SEARCH_WRITE_LOCK_KEY,
+  pgBulkInsertSql,
+  PG_SEARCH_TOOLS_TABLE,
+  PG_SEARCH_TOOLS_COLUMNS,
+  PG_SEARCH_SNAPSHOTS_TABLE,
+  PG_SEARCH_SNAPSHOTS_COLUMNS,
+  PG_SEARCH_INSERT_ROWS_MAX,
+  pgSearchDialect,
   SecretStoreImpl,
   SKILLHUB_CAPABILITIES,
   skillhubScopeForCmd,

package/dist/{circleci-QY36SZIM.js → circleci-JG7RV2RU.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-FHYFPPBZ.js";
+} from "./chunk-2DA2UI37.js";
 import {
   guardedFetch
-} from "./chunk-7GP7DRES.js";
-import "./chunk-B4ZA7EGO.js";
+} from "./chunk-SBJMMSPA.js";
+import "./chunk-Q44CYUSI.js";
 import {
   TBError,
   external_exports
-} from "./chunk-7PM4FD5K.js";
+} from "./chunk-TPGTA43F.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/circleci/api.ts

package/dist/{clerk-ECH23XL5.js → clerk-U7OS5ALG.js}

@@ -2,14 +2,14 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-FHYFPPBZ.js";
+} from "./chunk-2DA2UI37.js";
 import {
   guardedFetch
-} from "./chunk-7GP7DRES.js";
-import "./chunk-B4ZA7EGO.js";
+} from "./chunk-SBJMMSPA.js";
+import "./chunk-Q44CYUSI.js";
 import {
   external_exports
-} from "./chunk-7PM4FD5K.js";
+} from "./chunk-TPGTA43F.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/clerk/api.ts

package/dist/{cloudflare_dns-F6DN2F3X.js → cloudflare_dns-ADCTFMMI.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-FHYFPPBZ.js";
+} from "./chunk-2DA2UI37.js";
 import {
   guardedFetch
-} from "./chunk-7GP7DRES.js";
-import "./chunk-B4ZA7EGO.js";
+} from "./chunk-SBJMMSPA.js";
+import "./chunk-Q44CYUSI.js";
 import {
   TBError,
   external_exports
-} from "./chunk-7PM4FD5K.js";
+} from "./chunk-TPGTA43F.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/cloudflare_dns/api.ts

package/dist/{cohere-HD4XZOPJ.js → cohere-Z7ZEC2YV.js}

@@ -2,14 +2,14 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-FHYFPPBZ.js";
+} from "./chunk-2DA2UI37.js";
 import {
   guardedFetch
-} from "./chunk-7GP7DRES.js";
-import "./chunk-B4ZA7EGO.js";
+} from "./chunk-SBJMMSPA.js";
+import "./chunk-Q44CYUSI.js";
 import {
   external_exports
-} from "./chunk-7PM4FD5K.js";
+} from "./chunk-TPGTA43F.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/cohere/api.ts

package/dist/{confluence-J4AZ2KYL.js → confluence-FT22JGYQ.js}

@@ -2,15 +2,15 @@ import {
   createProviderPlugin,
   requireCredential,
   upstreamError
-} from "./chunk-FHYFPPBZ.js";
+} from "./chunk-2DA2UI37.js";
 import {
   guardedFetch
-} from "./chunk-7GP7DRES.js";
-import "./chunk-B4ZA7EGO.js";
+} from "./chunk-SBJMMSPA.js";
+import "./chunk-Q44CYUSI.js";
 import {
   TBError,
   external_exports
-} from "./chunk-7PM4FD5K.js";
+} from "./chunk-TPGTA43F.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/confluence/api.ts

package/dist/{convertapi-BXBII5Z6.js → convertapi-UQQCWVWP.js}

@@ -2,16 +2,16 @@ import {
   createProviderPlugin,
   requireApiKey,
   upstreamError
-} from "./chunk-FHYFPPBZ.js";
+} from "./chunk-2DA2UI37.js";
 import {
   assertPublicHttpUrl,
   guardedFetch
-} from "./chunk-7GP7DRES.js";
-import "./chunk-B4ZA7EGO.js";
+} from "./chunk-SBJMMSPA.js";
+import "./chunk-Q44CYUSI.js";
 import {
   TBError,
   external_exports
-} from "./chunk-7PM4FD5K.js";
+} from "./chunk-TPGTA43F.js";
 import "./chunk-MLKGABMK.js";
 
 // ../plugins/src/convertapi/schema.ts