nolo-cli 0.188.0-alpha.1 → 0.188.0

package/{chunk-5EMSBTQ6.js → chunk-ECX3NKRD.js}

@@ -1,3 +1,6 @@
+import {
+  ulid
+} from "./chunk-XJWWBO34.js";
 import {
   asNonEmptyStringArray
 } from "./chunk-I42VC5KR.js";
@@ -2393,25 +2396,180 @@ var require_rambda = __commonJS({
   }
 });
 
+// packages/database/keys.ts
+var import_rambda = __toESM(require_rambda(), 1);
+
 // packages/core/toTrimmedString.ts
 function toTrimmedString(value) {
   return typeof value === "string" ? value.trim() : value == null ? "" : String(value).trim();
 }
 
-// packages/database/utils/ulid.ts
-import { monotonicFactory } from "ulid";
-var prng = () => Math.random();
-var ulid = monotonicFactory(prng);
-
-// packages/database/keys.ts
-var import_rambda = __toESM(require_rambda(), 1);
-
 // packages/core/userId.ts
 function normalizeUserId(value) {
   const text = asTrimmedString(value);
   return text.startsWith("user:") ? text.slice("user:".length) : text;
 }
 
+// packages/share/helpers.ts
+var toSafeString = (value) => asTrimmedString(value);
+var toNonEmptyString = (value) => {
+  const text = toSafeString(value);
+  return text || void 0;
+};
+var toSafeAgentKey = (value) => {
+  const text = toSafeString(value);
+  return text && isAgentKey(text) ? text : "";
+};
+var SHARE_TIME_FORMATTER = new Intl.DateTimeFormat("zh-CN", {
+  timeZone: "Asia/Shanghai",
+  year: "numeric",
+  month: "2-digit",
+  day: "2-digit",
+  hour: "2-digit",
+  minute: "2-digit",
+  second: "2-digit",
+  hour12: false
+});
+var findAgentKeyInMessages = (messages) => {
+  for (const raw of messages) {
+    if (!raw || typeof raw !== "object") continue;
+    const key = toSafeAgentKey(raw.cybotKey);
+    if (key) return key;
+  }
+  return "";
+};
+var findAgentKeyInArray = (items) => {
+  for (const raw of items) {
+    const direct = toSafeAgentKey(raw);
+    if (direct) return direct;
+    if (!raw || typeof raw !== "object") continue;
+    const item = raw;
+    const key = toSafeAgentKey(item.dbKey) || toSafeAgentKey(item.id);
+    if (key) return key;
+  }
+  return "";
+};
+var findAgentNameInMessages = (messages) => {
+  for (const raw of messages) {
+    if (!raw || typeof raw !== "object") continue;
+    const msg = raw;
+    const name = toSafeString(msg.agentName) || toSafeString(msg.cybotName) || toSafeString(msg.sourceAgentName);
+    if (name) return name;
+  }
+  return "";
+};
+var findAgentNameInArray = (items) => {
+  for (const raw of items) {
+    if (!raw || typeof raw !== "object") continue;
+    const item = raw;
+    const name = toSafeString(item.name) || toSafeString(item.agentName) || toSafeString(item.cybotName) || toSafeString(item.sourceAgentName);
+    if (name) return name;
+  }
+  return "";
+};
+var extractAgentInfo = (type, data) => {
+  const meta = data.meta;
+  const keyCandidates = [
+    meta?.sourceAgentKey,
+    meta?.agentKey,
+    data.sourceAgentKey,
+    data.agentKey,
+    data.cybotKey,
+    type === "cybot" ? data.dbKey ?? data.id : void 0
+  ];
+  let agentKey = "";
+  for (const candidate of keyCandidates) {
+    agentKey = toSafeAgentKey(candidate);
+    if (agentKey) break;
+  }
+  if (!agentKey && Array.isArray(data.cybots)) {
+    agentKey = findAgentKeyInArray(data.cybots);
+  }
+  if (!agentKey && Array.isArray(data.messages)) {
+    agentKey = findAgentKeyInMessages(data.messages);
+  }
+  if (!agentKey && Array.isArray(data.history)) {
+    agentKey = findAgentKeyInMessages(data.history);
+  }
+  const nameCandidates = [
+    meta?.sourceAgentName,
+    meta?.agentName,
+    meta?.cybotName,
+    data.sourceAgentName,
+    data.agentName,
+    data.cybotName,
+    type === "cybot" ? data.name : void 0
+  ];
+  let agentName = "";
+  for (const candidate of nameCandidates) {
+    agentName = toSafeString(candidate);
+    if (agentName) break;
+  }
+  if (!agentName && Array.isArray(data.cybots)) {
+    agentName = findAgentNameInArray(data.cybots);
+  }
+  if (!agentName && Array.isArray(data.messages)) {
+    agentName = findAgentNameInMessages(data.messages);
+  }
+  if (!agentName && Array.isArray(data.history)) {
+    agentName = findAgentNameInMessages(data.history);
+  }
+  return {
+    ...agentKey ? { sourceAgentKey: agentKey } : {},
+    ...agentName ? { sourceAgentName: agentName } : {}
+  };
+};
+var extractImageFromContent = (content) => {
+  if (Array.isArray(content)) {
+    const part = content.find(
+      (p) => p?.type === "image_url" && typeof p?.image_url?.url === "string"
+    );
+    if (part?.image_url?.url) return part.image_url.url;
+  }
+  if (typeof content === "string") {
+    const match = content.match(/!\[.*?\]\((.*?)\)/);
+    if (match?.[1]) return match[1];
+  }
+  return void 0;
+};
+var extractCoverImage = (type, data) => {
+  if (type === "image" /* IMAGE */) {
+    return toNonEmptyString(data.url);
+  }
+  if (type === "app" /* APP */) {
+    return toNonEmptyString(data.coverImage);
+  }
+  if (type !== "dialog" /* DIALOG */) return void 0;
+  const messages = Array.isArray(data.messages) ? data.messages : Array.isArray(data.history) ? data.history : [];
+  for (const msg of messages) {
+    const fromContent = extractImageFromContent(msg.content);
+    if (fromContent) return fromContent;
+    const image = toNonEmptyString(msg.image);
+    if (image) return image;
+    if (Array.isArray(msg.images)) {
+      const first = asNonEmptyStringArray(msg.images)[0];
+      if (first) return first;
+    }
+  }
+  return void 0;
+};
+var resolveShareAuthorIdentity = (args) => {
+  const authorName = toNonEmptyString(args.profile?.nickname) ?? toNonEmptyString(args.user?.name) ?? toNonEmptyString(args.user?.nickname) ?? toNonEmptyString(args.user?.username) ?? toNonEmptyString(args.fallbackName);
+  const authorAvatar = toNonEmptyString(args.profile?.avatar) ?? toNonEmptyString(args.user?.avatar) ?? toNonEmptyString(args.fallbackAvatar);
+  return {
+    ...authorName ? { authorName } : {},
+    ...authorAvatar ? { authorAvatar } : {}
+  };
+};
+var SENSITIVE_FIELDS = ["apiKey", "secret", "password"];
+var sanitizeShareData = (data) => {
+  const snapshot = { ...data };
+  for (const field of SENSITIVE_FIELDS) {
+    delete snapshot[field];
+  }
+  return snapshot;
+};
+
 // packages/share/keys.ts
 var SHARE_PREFIX = "share";
 var SHARE_INDEX_PREFIX = "shareidx";
@@ -2457,14 +2615,14 @@ var createOwnerRange = (rawUserId) => {
   const start = createKey(SHARE_INDEX_PREFIX, "owner", userId, "");
   return { start, end: start + "\uFFFF" };
 };
-var findAgentKeyInArray = (arr) => {
+var findAgentKeyInArray2 = (arr) => {
   for (const item of arr) {
     const key = toSafeAgentKey(item);
     if (key) return key;
   }
   return "";
 };
-var findAgentKeyInMessages = (messages) => {
+var findAgentKeyInMessages2 = (messages) => {
   for (const raw of messages) {
     if (!raw || typeof raw !== "object") continue;
     const key = toSafeAgentKey(raw.cybotKey);
@@ -2502,15 +2660,15 @@ var resolveAgentKeyFromPayload = (data) => {
       if (key) return key;
     }
     if (Array.isArray(payload?.cybots)) {
-      const key = findAgentKeyInArray(payload.cybots);
+      const key = findAgentKeyInArray2(payload.cybots);
       if (key) return key;
     }
     if (Array.isArray(payload?.messages)) {
-      const key = findAgentKeyInMessages(payload.messages);
+      const key = findAgentKeyInMessages2(payload.messages);
       if (key) return key;
     }
     if (Array.isArray(payload?.history)) {
-      const key = findAgentKeyInMessages(payload.history);
+      const key = findAgentKeyInMessages2(payload.history);
       if (key) return key;
     }
   }
@@ -2580,45 +2738,10 @@ var shareKey = {
   }
 };
 
-// packages/database/dialogKey.ts
-var SEPARATOR = "-";
-var createKey2 = (...parts) => parts.join(SEPARATOR);
-var splitKey2 = (key) => key.split(SEPARATOR);
-var isDialogKey = (key) => {
-  const parts = splitKey2(key);
-  return parts.length >= 3 && parts[0] === "dialog" /* DIALOG */;
-};
-var isDialogRecordKey = (key) => {
-  if (typeof key !== "string" || !key.startsWith(`${"dialog" /* DIALOG */}-`)) return false;
-  if (key.includes("-msg-")) return false;
-  const parts = splitKey2(key);
-  return parts.length >= 3 && parts[0] === "dialog" /* DIALOG */;
-};
-var createDialogKey = Object.assign(
-  (userId) => createKey2("dialog" /* DIALOG */, userId, ulid()),
-  {
-    single: (userId, dialogId) => createKey2("dialog" /* DIALOG */, userId, dialogId),
-    rangeOfUser: (userId) => ({
-      start: createKey2("dialog" /* DIALOG */, userId, ""),
-      end: createKey2("dialog" /* DIALOG */, userId, "\uFFFF")
-    })
-  }
-);
-var dialogMessageKey = (dialogId, messageId) => createKey2("dialog" /* DIALOG */, dialogId, "msg", messageId);
-var createDialogMessageKeyAndId = (dialogId, ulidFn = ulid) => {
-  const messageId = ulidFn();
-  return { key: dialogMessageKey(dialogId, messageId), messageId };
-};
-var dialogMessagePrefix = (dialogId) => createKey2("dialog" /* DIALOG */, dialogId, "msg");
-var dialogMessageRange = (dialogId) => ({
-  start: createKey2("dialog" /* DIALOG */, dialogId, "msg", ""),
-  end: createKey2("dialog" /* DIALOG */, dialogId, "msg", "\uFFFF")
-});
-
 // packages/database/keys.ts
-var SEPARATOR2 = "-";
-var createKey = (...parts) => parts.join(SEPARATOR2);
-var splitKey = (key) => key.split(SEPARATOR2);
+var SEPARATOR = "-";
+var createKey = (...parts) => parts.join(SEPARATOR);
+var splitKey = (key) => key.split(SEPARATOR);
 var TYPE_STORAGE_PREFIXES = {
   ["app" /* APP */]: ["app"],
   ["page" /* DOC */]: ["page"],
@@ -2637,6 +2760,13 @@ var _PREFIX_TO_TYPE = (() => {
   }
   return map;
 })();
+function inferTypeFromDbKey(dbKey) {
+  if (!dbKey) return null;
+  const firstSep = dbKey.indexOf(SEPARATOR);
+  if (firstSep < 0) return null;
+  const prefix = dbKey.slice(0, firstSep);
+  return _PREFIX_TO_TYPE.get(prefix) ?? null;
+}
 var isTableMetaKey = (key) => {
   const parts = splitKey(key);
   return parts.length >= 3 && parts[0] === "meta";
@@ -2649,11 +2779,14 @@ var isTaskKey = (key) => {
   const parts = splitKey(key);
   return parts.length >= 3 && parts[0] === "task" /* TASK */;
 };
+var isAgentAutomationKey = (key) => {
+  return key.startsWith(`${"agent-automation" /* AGENT_AUTOMATION */}-`);
+};
 var isFileKey = (key) => {
   const parts = splitKey(key);
   return parts.length >= 3 && (parts[0] === "file" /* FILE */ || parts[0] === "image" /* IMAGE */);
 };
-var isAgentKey2 = (key) => {
+var isAgentKey = (key) => {
   const parts = splitKey(key);
   return parts.length >= 3 && parts[0] === "agent" /* AGENT */;
 };
@@ -2661,6 +2794,10 @@ var isAppKey = (key) => {
   const parts = splitKey(key);
   return parts.length >= 2 && parts[0] === "app" /* APP */;
 };
+var isEmailKey = (key) => {
+  const parts = splitKey(key);
+  return parts.length >= 3 && parts[0] === "email" /* EMAIL */;
+};
 var rowKey = {
   /** 生成新行主键 + rowId */
   create: (tenantId, tableId) => {
@@ -2694,6 +2831,37 @@ var rowKey = {
     };
   }
 };
+var idxKey = {
+  /** 写入单条索引 */
+  put: (tenantId, tableId, indexName, indexKey, rowId) => createKey("idx", tenantId, tableId, indexName, indexKey, rowId),
+  /** 某一索引名前缀的范围（start / end）—— 供前缀扫描 */
+  range: (tenantId, tableId, indexName, indexKeyPrefix = "") => {
+    const start = createKey(
+      "idx",
+      tenantId,
+      tableId,
+      indexName,
+      indexKeyPrefix
+    );
+    return { start, end: start + "\uFFFF" };
+  },
+  /** 整张表所有索引的范围（gte / lte）—— 供整表删除 */
+  prefix: (tenantId, tableId) => {
+    const start = createKey("idx", tenantId, tableId, "");
+    return {
+      gte: start,
+      lte: start + "\uFFFF"
+    };
+  },
+  /** 某个租户的所有索引范围 */
+  rangeOfTenant: (tenantId) => {
+    const start = createKey("idx", tenantId, "");
+    return {
+      start,
+      end: start + "\uFFFF"
+    };
+  }
+};
 var metaKey = Object.assign(
   (tenantId, tableId) => createKey("meta", tenantId, tableId),
   {
@@ -2707,10 +2875,41 @@ var metaKey = Object.assign(
     }
   }
 );
+var viewKey = {
+  /** 创建一个新视图 key + viewId（由调用方生成或传入） */
+  create: (tenantId, tableId, viewId) => {
+    const id = viewId || ulid();
+    const dbKey = createKey("view", tenantId, tableId, id);
+    return { dbKey, id };
+  },
+  /** 某一视图的单键 */
+  single: (tenantId, tableId, viewId) => createKey("view", tenantId, tableId, viewId),
+  /** 某张表下面的所有视图范围 */
+  rangeOfTable: (tenantId, tableId) => {
+    const start = createKey("view", tenantId, tableId, "");
+    return {
+      start,
+      end: start + "\uFFFF"
+    };
+  },
+  /** 某个租户的所有视图范围 */
+  rangeOfTenant: (tenantId) => {
+    const start = createKey("view", tenantId, "");
+    return {
+      start,
+      end: start + "\uFFFF"
+    };
+  }
+};
 var DB_PREFIX = {
   USER: "user:"
 };
-var USER_SETTINGS_KEY_SUFFIX = `${SEPARATOR2}settings`;
+var createOAuthCredentialKey = (userId, provider) => createKey("oauth", userId, provider);
+var oauthCredentialUserRange = (userId) => ({
+  start: createKey("oauth", userId, ""),
+  end: createKey("oauth", userId, "\uFFFF")
+});
+var USER_SETTINGS_KEY_SUFFIX = `${SEPARATOR}settings`;
 var createUserKey = {
   settings: (userId) => `${userId}${USER_SETTINGS_KEY_SUFFIX}`,
   profile: (userId) => createKey(userId, "profile")
@@ -2735,6 +2934,10 @@ var createMemorySubjectKindIndexKey = (subjectType, subjectId, kind, createdAt,
   createdAt,
   memoryId
 );
+var isMemoryKey = (key) => {
+  const parts = splitKey(key);
+  return parts.length >= 4 && parts[0] === "mem";
+};
 var memoryOwnerRange = (ownerType, ownerId) => ({
   start: createKey("memidx", "owner", ownerType, ownerId, ""),
   end: createKey("memidx", "owner", ownerType, ownerId, "\uFFFF")
@@ -2787,6 +2990,47 @@ var createTokenKey = {
     end: createKey("token", userId, "\uFFFF")
   })
 };
+var TOKEN_DIALOG_INDEX_PREFIX = "idx-token-dialog";
+var encodeTokenIndexSegment = (segment) => {
+  let out = "";
+  for (const ch of segment) {
+    if (/[A-Za-z0-9]/.test(ch)) {
+      out += ch;
+      continue;
+    }
+    for (const byte of new TextEncoder().encode(ch)) {
+      out += `%${byte.toString(16).toUpperCase().padStart(2, "0")}`;
+    }
+  }
+  return out;
+};
+var createTokenDialogIndexKey = Object.assign(
+  (userId, dialogId, callId) => createKey(
+    TOKEN_DIALOG_INDEX_PREFIX,
+    encodeTokenIndexSegment(userId),
+    encodeTokenIndexSegment(dialogId),
+    encodeTokenIndexSegment(callId)
+  ),
+  {
+    /** 某个用户在某个对话下的全部索引项范围（范围扫描用） */
+    rangeOfDialog: (userId, dialogId) => ({
+      start: createKey(
+        TOKEN_DIALOG_INDEX_PREFIX,
+        encodeTokenIndexSegment(userId),
+        encodeTokenIndexSegment(dialogId),
+        ""
+      ),
+      end: createKey(
+        TOKEN_DIALOG_INDEX_PREFIX,
+        encodeTokenIndexSegment(userId),
+        encodeTokenIndexSegment(dialogId),
+        "\uFFFF"
+      )
+    })
+  }
+);
+var TOKEN_DIALOG_INDEX_FORMAT = "v2";
+var createTokenDialogBackfillKey = (userId) => createKey("idx-tokendlg-backfill", encodeTokenIndexSegment(userId));
 var createTokenStatsKey = Object.assign(
   (userId, dateKey) => createKey("token", "stats", "day", "user", userId, dateKey),
   {
@@ -2807,6 +3051,10 @@ var createTokenStatsAppliedKey = Object.assign(
     })
   }
 );
+var isTokenStatsKey = (key) => {
+  const parts = splitKey(key);
+  return parts.length >= 2 && parts[0] === "token" && parts[1] === "stats";
+};
 var DIALOG_AGENT_LIST_INDEX_PREFIX = "dialogidx";
 var DIALOG_LIST_TIMESTAMP_MAX = 9999999999999;
 function parseDialogUpdatedAtMs(value) {
@@ -2845,6 +3093,21 @@ function createDialogAgentListIndexKey(args) {
     dialogId
   );
 }
+function createDialogAgentListIndexRange(userId, agentKey) {
+  const normalizedUserId = userId.trim();
+  const normalizedAgentKey = agentKey.trim();
+  if (!normalizedUserId || !normalizedAgentKey) {
+    return { start: "", end: "" };
+  }
+  const start = createKey(
+    DIALOG_AGENT_LIST_INDEX_PREFIX,
+    "agent",
+    normalizedUserId,
+    normalizedAgentKey,
+    ""
+  );
+  return { start, end: `${start}\uFFFF` };
+}
 function expandDialogAgentListIndexAliases(agentKey) {
   const key = agentKey.trim();
   if (!key) return [];
@@ -2973,6 +3236,7 @@ var createAgentAutomationKey = Object.assign(
     })
   }
 );
+var agentAutomationKey = createAgentAutomationKey;
 var AGENT_AUTOMATION_OWNER_INDEX_PREFIX = "agent-automation-owner-idx";
 var createAgentAutomationOwnerIndexKey = Object.assign(
   (userId, ownerAgentKey, automationId) => createKey(
@@ -3001,6 +3265,56 @@ function buildAgentAutomationOwnerIndexValue(args) {
     ownerAgentKey: args.ownerAgentKey
   };
 }
+function isAgentAutomationOwnerIndexKey(key) {
+  return key.startsWith(`${AGENT_AUTOMATION_OWNER_INDEX_PREFIX}-`);
+}
+function parseAgentAutomationIdFromKey(key) {
+  if (typeof key !== "string") return "";
+  const trimmed = key.trim();
+  if (!trimmed || !isAgentAutomationKey(trimmed)) return "";
+  const withoutPrefix = trimmed.slice(`${"agent-automation" /* AGENT_AUTOMATION */}-`.length);
+  const lastDash = withoutPrefix.lastIndexOf("-");
+  return lastDash >= 0 ? withoutPrefix.slice(lastDash + 1) : "";
+}
+function buildAgentAutomationOwnerIndexDeleteOps(args) {
+  const automationKey = args.automationKey.trim();
+  if (!automationKey || !isAgentAutomationKey(automationKey)) return [];
+  const userIdFromRecord = asTrimmedString(args.record?.createdBy);
+  const userIdFromArg = asTrimmedString(args.userId);
+  const withoutPrefix = automationKey.startsWith(`${"agent-automation" /* AGENT_AUTOMATION */}-`) ? automationKey.slice(`${"agent-automation" /* AGENT_AUTOMATION */}-`.length) : "";
+  const lastDash = withoutPrefix.lastIndexOf("-");
+  const userIdFromKey = lastDash > 0 ? withoutPrefix.slice(0, lastDash) : "";
+  const automationIdFromKey = lastDash > 0 ? withoutPrefix.slice(lastDash + 1) : "";
+  const userId = userIdFromArg || userIdFromRecord || userIdFromKey;
+  const automationId = asOptionalTrimmedString(args.record?.id) || automationIdFromKey;
+  const ownerAgentKey = asTrimmedString(args.record?.ownerAgentKey);
+  if (!userId || !automationId || !ownerAgentKey) return [];
+  return [
+    {
+      type: "del",
+      key: createAgentAutomationOwnerIndexKey(userId, ownerAgentKey, automationId)
+    }
+  ];
+}
+var createBudgetKey = (userId) => createKey("budget", userId, "monthly");
+var createNotificationKey = {
+  single: (userId, notificationId) => createKey("notification" /* NOTIFICATION */, userId, notificationId),
+  rangeOfUser: (userId) => ({
+    start: createKey("notification" /* NOTIFICATION */, userId, ""),
+    end: createKey("notification" /* NOTIFICATION */, userId, "\uFFFF")
+  })
+};
+var emailKey = {
+  create: (ownerId) => {
+    const emailId = ulid();
+    return { dbKey: createKey("email" /* EMAIL */, ownerId, emailId), emailId };
+  },
+  single: (ownerId, emailId) => createKey("email" /* EMAIL */, ownerId, emailId),
+  rangeOfOwner: (ownerId) => ({
+    start: createKey("email" /* EMAIL */, ownerId, ""),
+    end: createKey("email" /* EMAIL */, ownerId, "\uFFFF")
+  })
+};
 var createPageKey = {
   create: (userId) => {
     const id = ulid();
@@ -3021,6 +3335,114 @@ var createAgentKey = {
     end: createKey("agent" /* AGENT */, userId, "\uFFFF")
   })
 };
+var pubAgentKeys = {
+  single: (agentId) => createAgentKey.public(agentId),
+  list: () => ({
+    start: createKey("agent" /* AGENT */, "pub", ""),
+    end: createKey("agent" /* AGENT */, "pub", "\uFFFF")
+  }),
+  allPublicRanges: () => [
+    {
+      start: createKey("agent" /* AGENT */, "pub", ""),
+      end: createKey("agent" /* AGENT */, "pub", "\uFFFF")
+    }
+  ]
+};
+var createAgentGrantKey = {
+  single: (ownerUserId, agentId, granteeUserId) => createKey("grant", "agent", ownerUserId, agentId, granteeUserId),
+  rangeOfAgent: (ownerUserId, agentId) => ({
+    start: createKey("grant", "agent", ownerUserId, agentId, ""),
+    end: createKey("grant", "agent", ownerUserId, agentId, "\uFFFF")
+  })
+};
+var FAV_PREFIX = "fav";
+var createFavoriteKey = {
+  /* ---------- Agent 收藏（按 agentKey 存，当前使用） ---------- */
+  /**
+   * 某个用户收藏了某个 Agent 实例（用完整的 agentKey/dbKey）
+   * key: fav-agent-key-{userId}-{agentKey}
+   */
+  agentByKey: (userId, agentKey) => createKey(FAV_PREFIX, "agent", "key", userId, agentKey),
+  /**
+   * 查询某用户收藏的所有 Agent（基于 agentKey 版本）
+   * 范围: [fav-agent-key-{userId}-, fav-agent-key-{userId}-\uffff]
+   */
+  agentKeyRangeOfUser: (userId) => ({
+    start: createKey(FAV_PREFIX, "agent", "key", userId, ""),
+    end: createKey(FAV_PREFIX, "agent", "key", userId, "\uFFFF")
+  }),
+  userRangeOfAgentKey: (agentKey) => ({
+    start: createKey(FAV_PREFIX, "agent", "key", "by-agent", agentKey, ""),
+    end: createKey(FAV_PREFIX, "agent", "key", "by-agent", agentKey, "\uFFFF")
+  }),
+  agentByKeyReverse: (agentKey, userId) => createKey(FAV_PREFIX, "agent", "key", "by-agent", agentKey, userId),
+  /* ---------- Agent 收藏（按 agentId 存，预留，将来可用） ---------- */
+  /**
+   * 某个用户收藏了某个逻辑 AgentId（当前未使用，预留）
+   * key: fav-agent-id-{userId}-{agentId}
+   */
+  agentById: (userId, agentId) => createKey(FAV_PREFIX, "agent", "id", userId, agentId),
+  /** 查询某用户收藏的所有 AgentId（预留） */
+  agentIdRangeOfUser: (userId) => ({
+    start: createKey(FAV_PREFIX, "agent", "id", userId, ""),
+    end: createKey(FAV_PREFIX, "agent", "id", userId, "\uFFFF")
+  }),
+  userRangeOfAgentId: (agentId) => ({
+    start: createKey(FAV_PREFIX, "agent", "id", "by-agent", agentId, ""),
+    end: createKey(FAV_PREFIX, "agent", "id", "by-agent", agentId, "\uFFFF")
+  }),
+  agentByIdReverse: (agentId, userId) => createKey(FAV_PREFIX, "agent", "id", "by-agent", agentId, userId),
+  /* ---------- Page 收藏（同样区分 key / id，当前可以只用 byKey） ---------- */
+  // Page byKey: fav-page-key-{userId}-{pageKey}
+  pageByKey: (userId, pageKey) => createKey(FAV_PREFIX, "page", "key", userId, pageKey),
+  pageKeyRangeOfUser: (userId) => ({
+    start: createKey(FAV_PREFIX, "page", "key", userId, ""),
+    end: createKey(FAV_PREFIX, "page", "key", userId, "\uFFFF")
+  }),
+  userRangeOfPageKey: (pageKey) => ({
+    start: createKey(FAV_PREFIX, "page", "key", "by-page", pageKey, ""),
+    end: createKey(FAV_PREFIX, "page", "key", "by-page", pageKey, "\uFFFF")
+  }),
+  pageByKeyReverse: (pageKey, userId) => createKey(FAV_PREFIX, "page", "key", "by-page", pageKey, userId),
+  // Page byId（预留）
+  pageById: (userId, pageId) => createKey(FAV_PREFIX, "page", "id", userId, pageId),
+  pageIdRangeOfUser: (userId) => ({
+    start: createKey(FAV_PREFIX, "page", "id", userId, ""),
+    end: createKey(FAV_PREFIX, "page", "id", userId, "\uFFFF")
+  }),
+  userRangeOfPageId: (pageId) => ({
+    start: createKey(FAV_PREFIX, "page", "id", "by-page", pageId, ""),
+    end: createKey(FAV_PREFIX, "page", "id", "by-page", pageId, "\uFFFF")
+  }),
+  pageByIdReverse: (pageId, userId) => createKey(FAV_PREFIX, "page", "id", "by-page", pageId, userId),
+  /** 从 dbKey 中解析出目标标识符 (agentKey/agentId/pageKey/pageId) */
+  getIdentifierFromKey: (key) => {
+    const parts = key.split(SEPARATOR);
+    return parts.slice(4).join(SEPARATOR);
+  }
+};
+var createFavoriteStatsKey = {
+  // 被多少人收藏的 Agent（按 agentKey 统计，当前实际使用）
+  agentByKey: (agentKey) => createKey(FAV_PREFIX, "agent-count", "key", agentKey),
+  // 预留：按逻辑 AgentId 统计
+  agentById: (agentId) => createKey(FAV_PREFIX, "agent-count", "id", agentId),
+  // Page：按 pageKey 统计（预留）
+  pageByKey: (pageKey) => createKey(FAV_PREFIX, "page-count", "key", pageKey),
+  pageById: (pageId) => createKey(FAV_PREFIX, "page-count", "id", pageId)
+};
+var jobKey = {
+  create: (tenantId, jobId) => {
+    const id = jobId || ulid();
+    const dbKey = createKey("job", tenantId, id);
+    return { dbKey, id };
+  },
+  single: (tenantId, jobId) => createKey("job", tenantId, jobId),
+  rangeOfTenant: (tenantId) => {
+    const start = createKey("job", tenantId, "");
+    return { start, end: start + "\uFFFF" };
+  }
+};
+var blobKey = (sha256) => createKey("blob", sha256);
 var fileKey = {
   single: (tenantId, fileId) => createKey("file", tenantId, fileId),
   rangeOfTenant: (tenantId) => {
@@ -3031,173 +3453,17 @@ var fileKey = {
     };
   }
 };
+var fileIdIndexKey = (fileId) => createKey("file", "id", fileId);
 var getFileIdFromKey = (key) => {
-  const parts = key.split(SEPARATOR2);
+  const parts = key.split(SEPARATOR);
   return parts[2];
 };
-
-// packages/share/helpers.ts
-var toSafeString = (value) => asTrimmedString(value);
-var toNonEmptyString = (value) => {
-  const text = toSafeString(value);
-  return text || void 0;
-};
-var toSafeAgentKey = (value) => {
-  const text = toSafeString(value);
-  return text && isAgentKey2(text) ? text : "";
-};
-var SHARE_TIME_FORMATTER = new Intl.DateTimeFormat("zh-CN", {
-  timeZone: "Asia/Shanghai",
-  year: "numeric",
-  month: "2-digit",
-  day: "2-digit",
-  hour: "2-digit",
-  minute: "2-digit",
-  second: "2-digit",
-  hour12: false
-});
-var findAgentKeyInMessages2 = (messages) => {
-  for (const raw of messages) {
-    if (!raw || typeof raw !== "object") continue;
-    const key = toSafeAgentKey(raw.cybotKey);
-    if (key) return key;
-  }
-  return "";
-};
-var findAgentKeyInArray2 = (items) => {
-  for (const raw of items) {
-    const direct = toSafeAgentKey(raw);
-    if (direct) return direct;
-    if (!raw || typeof raw !== "object") continue;
-    const item = raw;
-    const key = toSafeAgentKey(item.dbKey) || toSafeAgentKey(item.id);
-    if (key) return key;
-  }
-  return "";
-};
-var findAgentNameInMessages = (messages) => {
-  for (const raw of messages) {
-    if (!raw || typeof raw !== "object") continue;
-    const msg = raw;
-    const name = toSafeString(msg.agentName) || toSafeString(msg.cybotName) || toSafeString(msg.sourceAgentName);
-    if (name) return name;
-  }
-  return "";
-};
-var findAgentNameInArray = (items) => {
-  for (const raw of items) {
-    if (!raw || typeof raw !== "object") continue;
-    const item = raw;
-    const name = toSafeString(item.name) || toSafeString(item.agentName) || toSafeString(item.cybotName) || toSafeString(item.sourceAgentName);
-    if (name) return name;
-  }
-  return "";
-};
-var extractAgentInfo = (type, data) => {
-  const meta = data.meta;
-  const keyCandidates = [
-    meta?.sourceAgentKey,
-    meta?.agentKey,
-    data.sourceAgentKey,
-    data.agentKey,
-    data.cybotKey,
-    type === "cybot" ? data.dbKey ?? data.id : void 0
-  ];
-  let agentKey = "";
-  for (const candidate of keyCandidates) {
-    agentKey = toSafeAgentKey(candidate);
-    if (agentKey) break;
-  }
-  if (!agentKey && Array.isArray(data.cybots)) {
-    agentKey = findAgentKeyInArray2(data.cybots);
-  }
-  if (!agentKey && Array.isArray(data.messages)) {
-    agentKey = findAgentKeyInMessages2(data.messages);
-  }
-  if (!agentKey && Array.isArray(data.history)) {
-    agentKey = findAgentKeyInMessages2(data.history);
-  }
-  const nameCandidates = [
-    meta?.sourceAgentName,
-    meta?.agentName,
-    meta?.cybotName,
-    data.sourceAgentName,
-    data.agentName,
-    data.cybotName,
-    type === "cybot" ? data.name : void 0
-  ];
-  let agentName = "";
-  for (const candidate of nameCandidates) {
-    agentName = toSafeString(candidate);
-    if (agentName) break;
-  }
-  if (!agentName && Array.isArray(data.cybots)) {
-    agentName = findAgentNameInArray(data.cybots);
-  }
-  if (!agentName && Array.isArray(data.messages)) {
-    agentName = findAgentNameInMessages(data.messages);
-  }
-  if (!agentName && Array.isArray(data.history)) {
-    agentName = findAgentNameInMessages(data.history);
-  }
-  return {
-    ...agentKey ? { sourceAgentKey: agentKey } : {},
-    ...agentName ? { sourceAgentName: agentName } : {}
-  };
-};
-var extractImageFromContent = (content) => {
-  if (Array.isArray(content)) {
-    const part = content.find(
-      (p) => p?.type === "image_url" && typeof p?.image_url?.url === "string"
-    );
-    if (part?.image_url?.url) return part.image_url.url;
-  }
-  if (typeof content === "string") {
-    const match = content.match(/!\[.*?\]\((.*?)\)/);
-    if (match?.[1]) return match[1];
-  }
-  return void 0;
-};
-var extractCoverImage = (type, data) => {
-  if (type === "image" /* IMAGE */) {
-    return toNonEmptyString(data.url);
-  }
-  if (type === "app" /* APP */) {
-    return toNonEmptyString(data.coverImage);
-  }
-  if (type !== "dialog" /* DIALOG */) return void 0;
-  const messages = Array.isArray(data.messages) ? data.messages : Array.isArray(data.history) ? data.history : [];
-  for (const msg of messages) {
-    const fromContent = extractImageFromContent(msg.content);
-    if (fromContent) return fromContent;
-    const image = toNonEmptyString(msg.image);
-    if (image) return image;
-    if (Array.isArray(msg.images)) {
-      const first = asNonEmptyStringArray(msg.images)[0];
-      if (first) return first;
-    }
-  }
-  return void 0;
-};
-var resolveShareAuthorIdentity = (args) => {
-  const authorName = toNonEmptyString(args.profile?.nickname) ?? toNonEmptyString(args.user?.name) ?? toNonEmptyString(args.user?.nickname) ?? toNonEmptyString(args.user?.username) ?? toNonEmptyString(args.fallbackName);
-  const authorAvatar = toNonEmptyString(args.profile?.avatar) ?? toNonEmptyString(args.user?.avatar) ?? toNonEmptyString(args.fallbackAvatar);
-  return {
-    ...authorName ? { authorName } : {},
-    ...authorAvatar ? { authorAvatar } : {}
-  };
-};
-var SENSITIVE_FIELDS = ["apiKey", "secret", "password"];
-var sanitizeShareData = (data) => {
-  const snapshot = { ...data };
-  for (const field of SENSITIVE_FIELDS) {
-    delete snapshot[field];
-  }
-  return snapshot;
+var fileStatKey = {
+  tenantPerDay: (tenantId, dateKey) => createKey("file", "stat", "tenant", tenantId, dateKey),
+  modelPerDay: (modelName, dateKey) => createKey("file", "stat", "model", modelName, dateKey)
 };
 
 export {
-  ulid,
   toTrimmedString,
   toNonEmptyString,
   extractAgentInfo,
@@ -3205,41 +3471,77 @@ export {
   resolveShareAuthorIdentity,
   sanitizeShareData,
   shareKey,
-  isDialogKey,
-  isDialogRecordKey,
-  createDialogKey,
-  dialogMessageKey,
-  createDialogMessageKeyAndId,
-  dialogMessagePrefix,
-  dialogMessageRange,
-  SEPARATOR2 as SEPARATOR,
+  SEPARATOR,
   createKey,
   splitKey,
   TYPE_STORAGE_PREFIXES,
+  inferTypeFromDbKey,
   isTableMetaKey,
   isPageKey,
   isTaskKey,
+  isAgentAutomationKey,
   isFileKey,
-  isAgentKey2 as isAgentKey,
+  isAgentKey,
   isAppKey,
+  isEmailKey,
   rowKey,
+  idxKey,
   metaKey,
+  viewKey,
   DB_PREFIX,
+  createOAuthCredentialKey,
+  oauthCredentialUserRange,
+  USER_SETTINGS_KEY_SUFFIX,
   createUserKey,
   createUserPreferenceKey,
   createMemoryKey,
   createMemoryOwnerIndexKey,
   createMemorySubjectKindIndexKey,
+  isMemoryKey,
   memoryOwnerRange,
   memorySubjectKindRange,
+  createTransactionKey,
   createTokenKey,
+  TOKEN_DIALOG_INDEX_PREFIX,
+  encodeTokenIndexSegment,
+  createTokenDialogIndexKey,
+  TOKEN_DIALOG_INDEX_FORMAT,
+  createTokenDialogBackfillKey,
   createTokenStatsKey,
+  createTokenStatsAppliedKey,
+  isTokenStatsKey,
+  DIALOG_AGENT_LIST_INDEX_PREFIX,
+  parseDialogUpdatedAtMs,
+  toDialogListInvertedTimestamp,
+  createDialogAgentListIndexKey,
+  createDialogAgentListIndexRange,
+  expandDialogAgentListIndexAliases,
+  collectDialogAgentListIndexAgentKeys,
+  isDialogAgentListIndexable,
   buildDialogAgentListIndexDeleteOps,
+  buildDialogAgentListIndexOps,
+  createTaskKey,
   createAgentAutomationKey,
+  agentAutomationKey,
+  AGENT_AUTOMATION_OWNER_INDEX_PREFIX,
   createAgentAutomationOwnerIndexKey,
   buildAgentAutomationOwnerIndexValue,
+  isAgentAutomationOwnerIndexKey,
+  parseAgentAutomationIdFromKey,
+  buildAgentAutomationOwnerIndexDeleteOps,
+  createBudgetKey,
+  createNotificationKey,
+  emailKey,
   createPageKey,
   createAgentKey,
+  pubAgentKeys,
+  createAgentGrantKey,
+  createFavoriteKey,
+  createFavoriteStatsKey,
+  jobKey,
+  blobKey,
   fileKey,
-  getFileIdFromKey
+  fileIdIndexKey,
+  getFileIdFromKey,
+  fileStatKey
 };