@lark-project/openclaw-lark-project 2026.3.131

package/dist/src/messaging/converters/post.js

@@ -0,0 +1,113 @@
+import { resolveMentions } from "./content-converter";
+import { safeParse } from "./utils";
+const LOCALE_PRIORITY = ["zh_cn", "en_us", "ja_jp"];
+function unwrapLocale(parsed) {
+  if ("title" in parsed || "content" in parsed) {
+    return parsed;
+  }
+  for (const locale of LOCALE_PRIORITY) {
+    const localeData = parsed[locale];
+    if (localeData != null && typeof localeData === "object") {
+      return localeData;
+    }
+  }
+  const firstKey = Object.keys(parsed)[0];
+  if (firstKey) {
+    const firstValue = parsed[firstKey];
+    if (firstValue != null && typeof firstValue === "object") {
+      return firstValue;
+    }
+  }
+  return void 0;
+}
+const convertPost = (raw, ctx) => {
+  const rawParsed = safeParse(raw);
+  if (rawParsed == null || typeof rawParsed !== "object") {
+    return { content: "[rich text message]", resources: [] };
+  }
+  const parsed = unwrapLocale(rawParsed);
+  if (!parsed) {
+    return { content: "[rich text message]", resources: [] };
+  }
+  const resources = [];
+  const lines = [];
+  if (parsed.title) {
+    lines.push(`**${parsed.title}**`, "");
+  }
+  const contentBlocks = parsed.content ?? [];
+  for (const paragraph of contentBlocks) {
+    if (!Array.isArray(paragraph)) continue;
+    let line = "";
+    for (const el of paragraph) {
+      line += renderElement(el, ctx, resources);
+    }
+    lines.push(line);
+  }
+  let content = lines.join("\n").trim() || "[rich text message]";
+  content = resolveMentions(content, ctx);
+  return { content, resources };
+};
+function renderElement(el, ctx, resources) {
+  switch (el.tag) {
+    case "text": {
+      let text = el.text ?? "";
+      text = applyStyle(text, el.style);
+      return text;
+    }
+    case "a": {
+      const text = el.text ?? el.href ?? "";
+      return el.href ? `[${text}](${el.href})` : text;
+    }
+    case "at": {
+      const userId = el.user_id ?? "";
+      if (userId === "all") return "@all";
+      const name = el.user_name ?? userId;
+      const info = ctx.mentionsByOpenId.get(userId);
+      if (info) {
+        return info.key;
+      }
+      return `@${name}`;
+    }
+    case "img": {
+      if (el.image_key) {
+        resources.push({ type: "image", fileKey: el.image_key });
+        return `![image](${el.image_key})`;
+      }
+      return "";
+    }
+    case "media": {
+      if (el.file_key) {
+        resources.push({ type: "file", fileKey: el.file_key });
+        return `<file key="${el.file_key}"/>`;
+      }
+      return "";
+    }
+    case "code_block": {
+      const lang = el.language ?? "";
+      const code = el.text ?? "";
+      return `
+\`\`\`${lang}
+${code}
+\`\`\`
+`;
+    }
+    case "hr":
+      return "\n---\n";
+    default:
+      return el.text ?? "";
+  }
+}
+function applyStyle(text, style) {
+  if (!style || style.length === 0) return text;
+  let result = text;
+  if (style.includes("bold")) result = `**${result}**`;
+  if (style.includes("italic")) result = `*${result}*`;
+  if (style.includes("underline")) result = `<u>${result}</u>`;
+  if (style.includes("lineThrough")) result = `~~${result}~~`;
+  if (style.includes("codeInline")) result = `\`${result}\``;
+  return result;
+}
+export {
+  convertPost
+};
+//# sourceMappingURL=post.js.map

package/dist/src/messaging/converters/post.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/post.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"post\" (rich text) message type.\n *\n * Preserves structure as Markdown: links as `[text](href)`,\n * images as `![image](key)`, code blocks, and mention resolution.\n */\n\nimport type { ResourceDescriptor } from '../types';\nimport type { ContentConverterFn, ConvertContext, PostElement } from './types';\nimport { resolveMentions } from './content-converter';\nimport { safeParse } from './utils';\n\n/** Preferred locale order for multi-language post unwrapping. */\nconst LOCALE_PRIORITY = ['zh_cn', 'en_us', 'ja_jp'] as const;\n\ninterface PostBody {\n  title?: string;\n  content?: PostElement[][];\n}\n\n/**\n * Unwrap a parsed post object that may be locale-wrapped.\n *\n * Feishu post messages come in two shapes:\n *   - Flat:   `{ title, content }`\n *   - Locale: `{ zh_cn: { title, content }, en_us: { title, content } }`\n */\nfunction unwrapLocale(parsed: Record<string, unknown>): PostBody | undefined {\n  if ('title' in parsed || 'content' in parsed) {\n    return parsed as unknown as PostBody;\n  }\n\n  for (const locale of LOCALE_PRIORITY) {\n    const localeData = parsed[locale];\n    if (localeData != null && typeof localeData === 'object') {\n      return localeData as PostBody;\n    }\n  }\n\n  const firstKey = Object.keys(parsed)[0];\n  if (firstKey) {\n    const firstValue = parsed[firstKey];\n    if (firstValue != null && typeof firstValue === 'object') {\n      return firstValue as PostBody;\n    }\n  }\n\n  return undefined;\n}\n\nexport const convertPost: ContentConverterFn = (raw, ctx) => {\n  const rawParsed = safeParse(raw);\n  if (rawParsed == null || typeof rawParsed !== 'object') {\n    return { content: '[rich text message]', resources: [] };\n  }\n\n  const parsed = unwrapLocale(rawParsed as Record<string, unknown>);\n  if (!parsed) {\n    return { content: '[rich text message]', resources: [] };\n  }\n\n  const resources: ResourceDescriptor[] = [];\n  const lines: string[] = [];\n\n  // Title\n  if (parsed.title) {\n    lines.push(`**${parsed.title}**`, '');\n  }\n\n  const contentBlocks = parsed.content ?? [];\n\n  for (const paragraph of contentBlocks) {\n    if (!Array.isArray(paragraph)) continue;\n\n    let line = '';\n    for (const el of paragraph) {\n      line += renderElement(el, ctx, resources);\n    }\n    lines.push(line);\n  }\n\n  let content = lines.join('\\n').trim() || '[rich text message]';\n  content = resolveMentions(content, ctx);\n\n  return { content, resources };\n};\n\nfunction renderElement(el: PostElement, ctx: ConvertContext, resources: ResourceDescriptor[]): string {\n  switch (el.tag) {\n    case 'text': {\n      let text = el.text ?? '';\n      text = applyStyle(text, el.style);\n      return text;\n    }\n    case 'a': {\n      const text = el.text ?? el.href ?? '';\n      return el.href ? `[${text}](${el.href})` : text;\n    }\n    case 'at': {\n      // At-mention in post \u2014 use placeholder key if available via context,\n      // otherwise fall back to @user_name.\n      const userId = el.user_id ?? '';\n      if (userId === 'all') return '@all';\n      const name = el.user_name ?? userId;\n      // O(1) lookup via reverse map\n      const info = ctx.mentionsByOpenId.get(userId);\n      if (info) {\n        // Let resolveMentions handle it \u2014 return the placeholder key\n        return info.key;\n      }\n      return `@${name}`;\n    }\n    case 'img': {\n      if (el.image_key) {\n        resources.push({ type: 'image', fileKey: el.image_key });\n        return `![image](${el.image_key})`;\n      }\n      return '';\n    }\n    case 'media': {\n      if (el.file_key) {\n        resources.push({ type: 'file', fileKey: el.file_key });\n        return `<file key=\"${el.file_key}\"/>`;\n      }\n      return '';\n    }\n    case 'code_block': {\n      const lang = el.language ?? '';\n      const code = el.text ?? '';\n      return `\\n\\`\\`\\`${lang}\\n${code}\\n\\`\\`\\`\\n`;\n    }\n    case 'hr':\n      return '\\n---\\n';\n    default:\n      return el.text ?? '';\n  }\n}\n\nfunction applyStyle(text: string, style?: string[]): string {\n  if (!style || style.length === 0) return text;\n  let result = text;\n  if (style.includes('bold')) result = `**${result}**`;\n  if (style.includes('italic')) result = `*${result}*`;\n  if (style.includes('underline')) result = `<u>${result}</u>`;\n  if (style.includes('lineThrough')) result = `~~${result}~~`;\n  if (style.includes('codeInline')) result = `\\`${result}\\``;\n  return result;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/messaging/converters/share.js

@@ -0,0 +1,22 @@
+import { safeParse } from "./utils";
+const convertShareChat = (raw) => {
+  const parsed = safeParse(raw);
+  const chatId = parsed?.chat_id ?? "";
+  return {
+    content: `<group_card id="${chatId}"/>`,
+    resources: []
+  };
+};
+const convertShareUser = (raw) => {
+  const parsed = safeParse(raw);
+  const userId = parsed?.user_id ?? "";
+  return {
+    content: `<contact_card id="${userId}"/>`,
+    resources: []
+  };
+};
+export {
+  convertShareChat,
+  convertShareUser
+};
+//# sourceMappingURL=share.js.map

package/dist/src/messaging/converters/share.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/share.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"share_chat\" and \"share_user\" message types.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { safeParse } from './utils';\n\nexport const convertShareChat: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as { chat_id?: string } | undefined;\n  const chatId = parsed?.chat_id ?? '';\n\n  return {\n    content: `<group_card id=\"${chatId}\"/>`,\n    resources: [],\n  };\n};\n\nexport const convertShareUser: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as { user_id?: string } | undefined;\n  const userId = parsed?.user_id ?? '';\n\n  return {\n    content: `<contact_card id=\"${userId}\"/>`,\n    resources: [],\n  };\n};\n"],
+  "mappings": "AAQA,SAAS,iBAAiB;AAEnB,MAAM,mBAAuC,CAAC,QAAQ;AAC3D,QAAM,SAAS,UAAU,GAAG;AAC5B,QAAM,SAAS,QAAQ,WAAW;AAElC,SAAO;AAAA,IACL,SAAS,mBAAmB,MAAM;AAAA,IAClC,WAAW,CAAC;AAAA,EACd;AACF;AAEO,MAAM,mBAAuC,CAAC,QAAQ;AAC3D,QAAM,SAAS,UAAU,GAAG;AAC5B,QAAM,SAAS,QAAQ,WAAW;AAElC,SAAO;AAAA,IACL,SAAS,qBAAqB,MAAM;AAAA,IACpC,WAAW,CAAC;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/src/messaging/converters/sticker.js

@@ -0,0 +1,16 @@
+import { safeParse } from "./utils";
+const convertSticker = (raw) => {
+  const parsed = safeParse(raw);
+  const fileKey = parsed?.file_key;
+  if (!fileKey) {
+    return { content: "[sticker]", resources: [] };
+  }
+  return {
+    content: `<sticker key="${fileKey}"/>`,
+    resources: [{ type: "sticker", fileKey }]
+  };
+};
+export {
+  convertSticker
+};
+//# sourceMappingURL=sticker.js.map

package/dist/src/messaging/converters/sticker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/sticker.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"sticker\" message type.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { safeParse } from './utils';\n\nexport const convertSticker: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as { file_key?: string } | undefined;\n  const fileKey = parsed?.file_key;\n\n  if (!fileKey) {\n    return { content: '[sticker]', resources: [] };\n  }\n\n  return {\n    content: `<sticker key=\"${fileKey}\"/>`,\n    resources: [{ type: 'sticker', fileKey }],\n  };\n};\n"],
+  "mappings": "AAQA,SAAS,iBAAiB;AAEnB,MAAM,iBAAqC,CAAC,QAAQ;AACzD,QAAM,SAAS,UAAU,GAAG;AAC5B,QAAM,UAAU,QAAQ;AAExB,MAAI,CAAC,SAAS;AACZ,WAAO,EAAE,SAAS,aAAa,WAAW,CAAC,EAAE;AAAA,EAC/C;AAEA,SAAO;AAAA,IACL,SAAS,iBAAiB,OAAO;AAAA,IACjC,WAAW,CAAC,EAAE,MAAM,WAAW,QAAQ,CAAC;AAAA,EAC1C;AACF;",
+  "names": []
+}

package/dist/src/messaging/converters/system.js

@@ -0,0 +1,25 @@
+import { safeParse } from "./utils";
+const convertSystem = (raw) => {
+  const parsed = safeParse(raw);
+  if (!parsed?.template) {
+    return { content: "[system message]", resources: [] };
+  }
+  let content = parsed.template;
+  const replacements = {
+    "{from_user}": parsed.from_user?.length ? parsed.from_user.filter(Boolean).join(", ") : void 0,
+    "{to_chatters}": parsed.to_chatters?.length ? parsed.to_chatters.filter(Boolean).join(", ") : void 0,
+    "{divider_text}": parsed.divider_text?.text
+  };
+  for (const [placeholder, value] of Object.entries(replacements)) {
+    if (value != null) {
+      content = content.replaceAll(placeholder, value);
+    } else {
+      content = content.replaceAll(placeholder, "");
+    }
+  }
+  return { content: content.trim(), resources: [] };
+};
+export {
+  convertSystem
+};
+//# sourceMappingURL=system.js.map

package/dist/src/messaging/converters/system.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/system.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"system\" message type.\n *\n * System messages use a template string with placeholders like\n * `{from_user}`, `{to_chatters}`, `{divider_text}` that are replaced\n * with actual values from the message body.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { safeParse } from './utils';\n\nexport const convertSystem: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as\n    | {\n        template?: string;\n        from_user?: string[];\n        to_chatters?: string[];\n        divider_text?: { text?: string };\n      }\n    | undefined;\n\n  if (!parsed?.template) {\n    return { content: '[system message]', resources: [] };\n  }\n\n  let content = parsed.template;\n\n  const replacements: Record<string, string | undefined> = {\n    '{from_user}': parsed.from_user?.length ? parsed.from_user.filter(Boolean).join(', ') : undefined,\n    '{to_chatters}': parsed.to_chatters?.length ? parsed.to_chatters.filter(Boolean).join(', ') : undefined,\n    '{divider_text}': parsed.divider_text?.text,\n  };\n\n  for (const [placeholder, value] of Object.entries(replacements)) {\n    if (value != null) {\n      content = content.replaceAll(placeholder, value);\n    } else {\n      content = content.replaceAll(placeholder, '');\n    }\n  }\n\n  return { content: content.trim(), resources: [] };\n};\n"],
+  "mappings": "AAYA,SAAS,iBAAiB;AAEnB,MAAM,gBAAoC,CAAC,QAAQ;AACxD,QAAM,SAAS,UAAU,GAAG;AAS5B,MAAI,CAAC,QAAQ,UAAU;AACrB,WAAO,EAAE,SAAS,oBAAoB,WAAW,CAAC,EAAE;AAAA,EACtD;AAEA,MAAI,UAAU,OAAO;AAErB,QAAM,eAAmD;AAAA,IACvD,eAAe,OAAO,WAAW,SAAS,OAAO,UAAU,OAAO,OAAO,EAAE,KAAK,IAAI,IAAI;AAAA,IACxF,iBAAiB,OAAO,aAAa,SAAS,OAAO,YAAY,OAAO,OAAO,EAAE,KAAK,IAAI,IAAI;AAAA,IAC9F,kBAAkB,OAAO,cAAc;AAAA,EACzC;AAEA,aAAW,CAAC,aAAa,KAAK,KAAK,OAAO,QAAQ,YAAY,GAAG;AAC/D,QAAI,SAAS,MAAM;AACjB,gBAAU,QAAQ,WAAW,aAAa,KAAK;AAAA,IACjD,OAAO;AACL,gBAAU,QAAQ,WAAW,aAAa,EAAE;AAAA,IAC9C;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,QAAQ,KAAK,GAAG,WAAW,CAAC,EAAE;AAClD;",
+  "names": []
+}

package/dist/src/messaging/converters/text.js

@@ -0,0 +1,12 @@
+import { resolveMentions } from "./content-converter";
+import { safeParse } from "./utils";
+const convertText = (raw, ctx) => {
+  const parsed = safeParse(raw);
+  const text = parsed?.text ?? raw;
+  const content = resolveMentions(text, ctx);
+  return { content, resources: [] };
+};
+export {
+  convertText
+};
+//# sourceMappingURL=text.js.map

package/dist/src/messaging/converters/text.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/text.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"text\" message type.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { resolveMentions } from './content-converter';\nimport { safeParse } from './utils';\n\nexport const convertText: ContentConverterFn = (raw, ctx) => {\n  const parsed = safeParse(raw) as { text?: string } | undefined;\n  const text = parsed?.text ?? raw;\n  const content = resolveMentions(text, ctx);\n  return { content, resources: [] };\n};\n"],
+  "mappings": "AAQA,SAAS,uBAAuB;AAChC,SAAS,iBAAiB;AAEnB,MAAM,cAAkC,CAAC,KAAK,QAAQ;AAC3D,QAAM,SAAS,UAAU,GAAG;AAC5B,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,UAAU,gBAAgB,MAAM,GAAG;AACzC,SAAO,EAAE,SAAS,WAAW,CAAC,EAAE;AAClC;",
+  "names": []
+}

package/dist/src/messaging/converters/todo.js

@@ -0,0 +1,37 @@
+import { safeParse, millisToDatetime } from "./utils";
+function extractPlainText(content) {
+  const lines = [];
+  for (const paragraph of content) {
+    if (!Array.isArray(paragraph)) continue;
+    let line = "";
+    for (const el of paragraph) {
+      if (el.text) line += el.text;
+    }
+    lines.push(line);
+  }
+  return lines.join("\n").trim();
+}
+const convertTodo = (raw) => {
+  const parsed = safeParse(raw);
+  const parts = [];
+  const title = parsed?.summary?.title ?? "";
+  const body = parsed?.summary?.content ? extractPlainText(parsed.summary.content) : "";
+  const fullTitle = [title, body].filter(Boolean).join("\n");
+  if (fullTitle) {
+    parts.push(fullTitle);
+  }
+  if (parsed?.due_time) {
+    parts.push(`Due: ${millisToDatetime(parsed.due_time)}`);
+  }
+  const inner = parts.join("\n") || "[todo]";
+  return {
+    content: `<todo>
+${inner}
+</todo>`,
+    resources: []
+  };
+};
+export {
+  convertTodo
+};
+//# sourceMappingURL=todo.js.map

package/dist/src/messaging/converters/todo.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/todo.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"todo\" message type.\n */\n\nimport type { ContentConverterFn, PostElement } from './types';\nimport { safeParse, millisToDatetime } from './utils';\n\n/** Extract plain text from post-style content blocks. */\nfunction extractPlainText(content: PostElement[][]): string {\n  const lines: string[] = [];\n  for (const paragraph of content) {\n    if (!Array.isArray(paragraph)) continue;\n    let line = '';\n    for (const el of paragraph) {\n      if (el.text) line += el.text;\n    }\n    lines.push(line);\n  }\n  return lines.join('\\n').trim();\n}\n\nexport const convertTodo: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as\n    | {\n        task_id?: string;\n        summary?: {\n          title?: string;\n          content?: PostElement[][];\n        };\n        due_time?: string;\n      }\n    | undefined;\n\n  const parts: string[] = [];\n\n  // Build title from summary.title and summary.content\n  const title = parsed?.summary?.title ?? '';\n  const body = parsed?.summary?.content ? extractPlainText(parsed.summary.content) : '';\n\n  const fullTitle = [title, body].filter(Boolean).join('\\n');\n  if (fullTitle) {\n    parts.push(fullTitle);\n  }\n\n  if (parsed?.due_time) {\n    parts.push(`Due: ${millisToDatetime(parsed.due_time)}`);\n  }\n\n  const inner = parts.join('\\n') || '[todo]';\n\n  return {\n    content: `<todo>\\n${inner}\\n</todo>`,\n    resources: [],\n  };\n};\n"],
+  "mappings": "AAQA,SAAS,WAAW,wBAAwB;AAG5C,SAAS,iBAAiB,SAAkC;AAC1D,QAAM,QAAkB,CAAC;AACzB,aAAW,aAAa,SAAS;AAC/B,QAAI,CAAC,MAAM,QAAQ,SAAS,EAAG;AAC/B,QAAI,OAAO;AACX,eAAW,MAAM,WAAW;AAC1B,UAAI,GAAG,KAAM,SAAQ,GAAG;AAAA,IAC1B;AACA,UAAM,KAAK,IAAI;AAAA,EACjB;AACA,SAAO,MAAM,KAAK,IAAI,EAAE,KAAK;AAC/B;AAEO,MAAM,cAAkC,CAAC,QAAQ;AACtD,QAAM,SAAS,UAAU,GAAG;AAW5B,QAAM,QAAkB,CAAC;AAGzB,QAAM,QAAQ,QAAQ,SAAS,SAAS;AACxC,QAAM,OAAO,QAAQ,SAAS,UAAU,iBAAiB,OAAO,QAAQ,OAAO,IAAI;AAEnF,QAAM,YAAY,CAAC,OAAO,IAAI,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI;AACzD,MAAI,WAAW;AACb,UAAM,KAAK,SAAS;AAAA,EACtB;AAEA,MAAI,QAAQ,UAAU;AACpB,UAAM,KAAK,QAAQ,iBAAiB,OAAO,QAAQ,CAAC,EAAE;AAAA,EACxD;AAEA,QAAM,QAAQ,MAAM,KAAK,IAAI,KAAK;AAElC,SAAO;AAAA,IACL,SAAS;AAAA,EAAW,KAAK;AAAA;AAAA,IACzB,WAAW,CAAC;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/src/messaging/converters/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/src/messaging/converters/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/src/messaging/converters/unknown.js

@@ -0,0 +1,13 @@
+import { safeParse } from "./utils";
+const convertUnknown = (raw) => {
+  const parsed = safeParse(raw);
+  if (parsed != null && typeof parsed === "object" && "text" in parsed) {
+    const text = parsed.text;
+    if (typeof text === "string") return { content: text, resources: [] };
+  }
+  return { content: "[unsupported message]", resources: [] };
+};
+export {
+  convertUnknown
+};
+//# sourceMappingURL=unknown.js.map

package/dist/src/messaging/converters/unknown.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/unknown.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Fallback converter for unsupported message types.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { safeParse } from './utils';\n\nexport const convertUnknown: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw);\n  if (parsed != null && typeof parsed === 'object' && 'text' in parsed) {\n    const text = (parsed as Record<string, unknown>).text;\n    if (typeof text === 'string') return { content: text, resources: [] };\n  }\n  return { content: '[unsupported message]', resources: [] };\n};\n"],
+  "mappings": "AAQA,SAAS,iBAAiB;AAEnB,MAAM,iBAAqC,CAAC,QAAQ;AACzD,QAAM,SAAS,UAAU,GAAG;AAC5B,MAAI,UAAU,QAAQ,OAAO,WAAW,YAAY,UAAU,QAAQ;AACpE,UAAM,OAAQ,OAAmC;AACjD,QAAI,OAAO,SAAS,SAAU,QAAO,EAAE,SAAS,MAAM,WAAW,CAAC,EAAE;AAAA,EACtE;AACA,SAAO,EAAE,SAAS,yBAAyB,WAAW,CAAC,EAAE;AAC3D;",
+  "names": []
+}

package/dist/src/messaging/converters/utils.js

@@ -0,0 +1,35 @@
+function escapeRegExp(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function safeParse(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+}
+function formatDuration(ms) {
+  const seconds = ms / 1e3;
+  if (seconds < 1) return `${ms}ms`;
+  if (Number.isInteger(seconds)) return `${seconds}s`;
+  return `${seconds.toFixed(1)}s`;
+}
+function millisToDatetime(ms) {
+  const num = Number(ms);
+  if (!Number.isFinite(num)) return String(ms);
+  const utc8Offset = 8 * 60 * 60 * 1e3;
+  const d = new Date(num + utc8Offset);
+  const year = d.getUTCFullYear();
+  const month = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const day = String(d.getUTCDate()).padStart(2, "0");
+  const hour = String(d.getUTCHours()).padStart(2, "0");
+  const minute = String(d.getUTCMinutes()).padStart(2, "0");
+  return `${year}-${month}-${day} ${hour}:${minute}`;
+}
+export {
+  escapeRegExp,
+  formatDuration,
+  millisToDatetime,
+  safeParse
+};
+//# sourceMappingURL=utils.js.map

package/dist/src/messaging/converters/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/utils.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Shared utilities for content converters.\n */\n\n/** Escape a string for safe use inside a RegExp. */\nexport function escapeRegExp(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Safely parse a JSON string, returning undefined on failure.\n */\nexport function safeParse(raw: string): unknown | undefined {\n  try {\n    return JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Format a duration in milliseconds to a human-readable string.\n *\n * Examples: 1500 \u2192 \"1.5s\", 65000 \u2192 \"65s\"\n */\nexport function formatDuration(ms: number): string {\n  const seconds = ms / 1000;\n  if (seconds < 1) return `${ms}ms`;\n  if (Number.isInteger(seconds)) return `${seconds}s`;\n  return `${seconds.toFixed(1)}s`;\n}\n\n/**\n * Convert a millisecond timestamp to \"YYYY-MM-DD HH:mm\" in UTC+8 (Beijing time).\n */\nexport function millisToDatetime(ms: string | number): string {\n  const num = Number(ms);\n  if (!Number.isFinite(num)) return String(ms);\n\n  // UTC+8 offset in milliseconds\n  const utc8Offset = 8 * 60 * 60 * 1000;\n  const d = new Date(num + utc8Offset);\n\n  const year = d.getUTCFullYear();\n  const month = String(d.getUTCMonth() + 1).padStart(2, '0');\n  const day = String(d.getUTCDate()).padStart(2, '0');\n  const hour = String(d.getUTCHours()).padStart(2, '0');\n  const minute = String(d.getUTCMinutes()).padStart(2, '0');\n\n  return `${year}-${month}-${day} ${hour}:${minute}`;\n}\n"],
+  "mappings": "AAQO,SAAS,aAAa,KAAqB;AAChD,SAAO,IAAI,QAAQ,uBAAuB,MAAM;AAClD;AAKO,SAAS,UAAU,KAAkC;AAC1D,MAAI;AACF,WAAO,KAAK,MAAM,GAAG;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAOO,SAAS,eAAe,IAAoB;AACjD,QAAM,UAAU,KAAK;AACrB,MAAI,UAAU,EAAG,QAAO,GAAG,EAAE;AAC7B,MAAI,OAAO,UAAU,OAAO,EAAG,QAAO,GAAG,OAAO;AAChD,SAAO,GAAG,QAAQ,QAAQ,CAAC,CAAC;AAC9B;AAKO,SAAS,iBAAiB,IAA6B;AAC5D,QAAM,MAAM,OAAO,EAAE;AACrB,MAAI,CAAC,OAAO,SAAS,GAAG,EAAG,QAAO,OAAO,EAAE;AAG3C,QAAM,aAAa,IAAI,KAAK,KAAK;AACjC,QAAM,IAAI,IAAI,KAAK,MAAM,UAAU;AAEnC,QAAM,OAAO,EAAE,eAAe;AAC9B,QAAM,QAAQ,OAAO,EAAE,YAAY,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AACzD,QAAM,MAAM,OAAO,EAAE,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;AAClD,QAAM,OAAO,OAAO,EAAE,YAAY,CAAC,EAAE,SAAS,GAAG,GAAG;AACpD,QAAM,SAAS,OAAO,EAAE,cAAc,CAAC,EAAE,SAAS,GAAG,GAAG;AAExD,SAAO,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM;AAClD;",
+  "names": []
+}

package/dist/src/messaging/converters/video-chat.js

@@ -0,0 +1,21 @@
+import { safeParse, millisToDatetime } from "./utils";
+const convertVideoChat = (raw) => {
+  const parsed = safeParse(raw);
+  const topic = parsed?.topic ?? "";
+  const parts = [];
+  if (topic) {
+    parts.push(`\u{1F4F9} ${topic}`);
+  }
+  if (parsed?.start_time) {
+    parts.push(`\u{1F559} ${millisToDatetime(parsed.start_time)}`);
+  }
+  const inner = parts.join("\n") || "[video chat]";
+  return {
+    content: `<meeting>${inner}</meeting>`,
+    resources: []
+  };
+};
+export {
+  convertVideoChat
+};
+//# sourceMappingURL=video-chat.js.map

package/dist/src/messaging/converters/video-chat.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/video-chat.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"video_chat\" message type.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { safeParse, millisToDatetime } from './utils';\n\nexport const convertVideoChat: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as\n    | {\n        topic?: string;\n        start_time?: string;\n      }\n    | undefined;\n\n  const topic = parsed?.topic ?? '';\n  const parts: string[] = [];\n\n  if (topic) {\n    parts.push(`\uD83D\uDCF9 ${topic}`);\n  }\n\n  if (parsed?.start_time) {\n    parts.push(`\uD83D\uDD59 ${millisToDatetime(parsed.start_time)}`);\n  }\n\n  const inner = parts.join('\\n') || '[video chat]';\n\n  return {\n    content: `<meeting>${inner}</meeting>`,\n    resources: [],\n  };\n};\n"],
+  "mappings": "AAQA,SAAS,WAAW,wBAAwB;AAErC,MAAM,mBAAuC,CAAC,QAAQ;AAC3D,QAAM,SAAS,UAAU,GAAG;AAO5B,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,QAAkB,CAAC;AAEzB,MAAI,OAAO;AACT,UAAM,KAAK,aAAM,KAAK,EAAE;AAAA,EAC1B;AAEA,MAAI,QAAQ,YAAY;AACtB,UAAM,KAAK,aAAM,iBAAiB,OAAO,UAAU,CAAC,EAAE;AAAA,EACxD;AAEA,QAAM,QAAQ,MAAM,KAAK,IAAI,KAAK;AAElC,SAAO;AAAA,IACL,SAAS,YAAY,KAAK;AAAA,IAC1B,WAAW,CAAC;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/src/messaging/converters/video.js

@@ -0,0 +1,30 @@
+import { safeParse } from "./utils";
+import { formatDuration } from "./utils";
+const convertVideo = (raw) => {
+  const parsed = safeParse(raw);
+  const fileKey = parsed?.file_key;
+  if (!fileKey) {
+    return { content: "[video]", resources: [] };
+  }
+  const fileName = parsed?.file_name ?? "";
+  const duration = parsed?.duration;
+  const coverKey = parsed?.image_key;
+  const nameAttr = fileName ? ` name="${fileName}"` : "";
+  const durationAttr = duration != null ? ` duration="${formatDuration(duration)}"` : "";
+  return {
+    content: `<video key="${fileKey}"${nameAttr}${durationAttr}/>`,
+    resources: [
+      {
+        type: "video",
+        fileKey,
+        fileName: fileName || void 0,
+        duration: duration ?? void 0,
+        coverImageKey: coverKey ?? void 0
+      }
+    ]
+  };
+};
+export {
+  convertVideo
+};
+//# sourceMappingURL=video.js.map

package/dist/src/messaging/converters/video.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/video.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"video\" and \"media\" message types.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { safeParse } from './utils';\nimport { formatDuration } from './utils';\n\nexport const convertVideo: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as\n    | {\n        file_key?: string;\n        file_name?: string;\n        duration?: number;\n        image_key?: string;\n      }\n    | undefined;\n\n  const fileKey = parsed?.file_key;\n  if (!fileKey) {\n    return { content: '[video]', resources: [] };\n  }\n\n  const fileName = parsed?.file_name ?? '';\n  const duration = parsed?.duration;\n  const coverKey = parsed?.image_key;\n\n  const nameAttr = fileName ? ` name=\"${fileName}\"` : '';\n  const durationAttr = duration != null ? ` duration=\"${formatDuration(duration)}\"` : '';\n\n  return {\n    content: `<video key=\"${fileKey}\"${nameAttr}${durationAttr}/>`,\n    resources: [\n      {\n        type: 'video',\n        fileKey,\n        fileName: fileName || undefined,\n        duration: duration ?? undefined,\n        coverImageKey: coverKey ?? undefined,\n      },\n    ],\n  };\n};\n"],
+  "mappings": "AAQA,SAAS,iBAAiB;AAC1B,SAAS,sBAAsB;AAExB,MAAM,eAAmC,CAAC,QAAQ;AACvD,QAAM,SAAS,UAAU,GAAG;AAS5B,QAAM,UAAU,QAAQ;AACxB,MAAI,CAAC,SAAS;AACZ,WAAO,EAAE,SAAS,WAAW,WAAW,CAAC,EAAE;AAAA,EAC7C;AAEA,QAAM,WAAW,QAAQ,aAAa;AACtC,QAAM,WAAW,QAAQ;AACzB,QAAM,WAAW,QAAQ;AAEzB,QAAM,WAAW,WAAW,UAAU,QAAQ,MAAM;AACpD,QAAM,eAAe,YAAY,OAAO,cAAc,eAAe,QAAQ,CAAC,MAAM;AAEpF,SAAO;AAAA,IACL,SAAS,eAAe,OAAO,IAAI,QAAQ,GAAG,YAAY;AAAA,IAC1D,WAAW;AAAA,MACT;AAAA,QACE,MAAM;AAAA,QACN;AAAA,QACA,UAAU,YAAY;AAAA,QACtB,UAAU,YAAY;AAAA,QACtB,eAAe,YAAY;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/messaging/converters/vote.js

@@ -0,0 +1,24 @@
+import { safeParse } from "./utils";
+const convertVote = (raw) => {
+  const parsed = safeParse(raw);
+  const topic = parsed?.topic ?? "";
+  const options = parsed?.options ?? [];
+  const parts = [];
+  if (topic) {
+    parts.push(topic);
+  }
+  for (const opt of options) {
+    parts.push(`\u2022 ${opt}`);
+  }
+  const inner = parts.join("\n") || "[vote]";
+  return {
+    content: `<vote>
+${inner}
+</vote>`,
+    resources: []
+  };
+};
+export {
+  convertVote
+};
+//# sourceMappingURL=vote.js.map

package/dist/src/messaging/converters/vote.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/converters/vote.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * Converter for \"vote\" message type.\n */\n\nimport type { ContentConverterFn } from './types';\nimport { safeParse } from './utils';\n\nexport const convertVote: ContentConverterFn = (raw) => {\n  const parsed = safeParse(raw) as\n    | {\n        topic?: string;\n        options?: string[];\n      }\n    | undefined;\n\n  const topic = parsed?.topic ?? '';\n  const options = parsed?.options ?? [];\n\n  const parts: string[] = [];\n\n  if (topic) {\n    parts.push(topic);\n  }\n\n  for (const opt of options) {\n    parts.push(`\u2022 ${opt}`);\n  }\n\n  const inner = parts.join('\\n') || '[vote]';\n\n  return {\n    content: `<vote>\\n${inner}\\n</vote>`,\n    resources: [],\n  };\n};\n"],
+  "mappings": "AAQA,SAAS,iBAAiB;AAEnB,MAAM,cAAkC,CAAC,QAAQ;AACtD,QAAM,SAAS,UAAU,GAAG;AAO5B,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,UAAU,QAAQ,WAAW,CAAC;AAEpC,QAAM,QAAkB,CAAC;AAEzB,MAAI,OAAO;AACT,UAAM,KAAK,KAAK;AAAA,EAClB;AAEA,aAAW,OAAO,SAAS;AACzB,UAAM,KAAK,UAAK,GAAG,EAAE;AAAA,EACvB;AAEA,QAAM,QAAQ,MAAM,KAAK,IAAI,KAAK;AAElC,SAAO;AAAA,IACL,SAAS;AAAA,EAAW,KAAK;AAAA;AAAA,IACzB,WAAW,CAAC;AAAA,EACd;AACF;",
+  "names": []
+}

package/dist/src/messaging/inbound/dedup.js

@@ -0,0 +1,82 @@
+const DEFAULT_TTL_MS = 12 * 60 * 60 * 1e3;
+const DEFAULT_MAX_ENTRIES = 5e3;
+const SWEEP_INTERVAL_MS = 5 * 60 * 1e3;
+const DEFAULT_EXPIRY_MS = 30 * 60 * 1e3;
+function isMessageExpired(createTimeStr, expiryMs = DEFAULT_EXPIRY_MS) {
+  if (!createTimeStr) return false;
+  const createTime = parseInt(createTimeStr, 10);
+  if (Number.isNaN(createTime)) return false;
+  return Date.now() - createTime > expiryMs;
+}
+class MessageDedup {
+  store = /* @__PURE__ */ new Map();
+  ttlMs;
+  maxEntries;
+  sweepTimer;
+  constructor(opts = {}) {
+    this.ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+    this.maxEntries = opts.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    this.sweepTimer = setInterval(() => this.sweep(), SWEEP_INTERVAL_MS);
+    this.sweepTimer.unref();
+  }
+  /**
+   * Try to record a message ID.
+   *
+   * @param id   Unique message identifier (e.g. Feishu `message_id`).
+   * @param scope Optional scope prefix (e.g. accountId) to namespace IDs.
+   * @returns `true` if the message is **new**; `false` if it is a duplicate.
+   */
+  tryRecord(id, scope) {
+    const key = scope ? `${scope}:${id}` : id;
+    const now = Date.now();
+    const existing = this.store.get(key);
+    if (existing !== void 0) {
+      if (now - existing < this.ttlMs) {
+        return false;
+      }
+      this.store.delete(key);
+    }
+    if (this.store.size >= this.maxEntries) {
+      const oldest = this.store.keys().next().value;
+      if (oldest !== void 0) {
+        this.store.delete(oldest);
+      }
+    }
+    this.store.set(key, now);
+    return true;
+  }
+  /** Current number of tracked entries (for diagnostics). */
+  get size() {
+    return this.store.size;
+  }
+  /** Remove all entries and stop the periodic sweep. */
+  clear() {
+    clearInterval(this.sweepTimer);
+    this.store.clear();
+  }
+  /** Stop the periodic sweep timer and clear all tracked entries. */
+  dispose() {
+    clearInterval(this.sweepTimer);
+    this.store.clear();
+  }
+  // ---------------------------------------------------------------------------
+  // Internal
+  // ---------------------------------------------------------------------------
+  /**
+   * Sweep expired entries from the front of the map.
+   * Because entries are in insertion order (FIFO), we can stop as soon as
+   * we hit one that hasn't expired yet.
+   */
+  sweep() {
+    const now = Date.now();
+    for (const [key, ts] of this.store) {
+      if (now - ts < this.ttlMs) break;
+      this.store.delete(key);
+    }
+  }
+}
+export {
+  MessageDedup,
+  isMessageExpired
+};
+//# sourceMappingURL=dedup.js.map

package/dist/src/messaging/inbound/dedup.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/messaging/inbound/dedup.ts"],
+  "sourcesContent": ["/**\n * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates\n * SPDX-License-Identifier: MIT\n *\n * FIFO-based message deduplication.\n *\n * Feishu WebSocket connections may redeliver messages on reconnect.\n * This module tracks recently-seen message IDs and filters duplicates.\n *\n * Design choices:\n * - FIFO eviction (not LRU) \u2014 message IDs are write-once/check-once,\n *   no hot/cold access pattern.  FIFO naturally expires the oldest entry\n *   first, which matches the dedup semantics.\n * - ES2015 `Map` preserves insertion order, giving us FIFO for free.\n * - Periodic sweep leverages FIFO ordering: iterate from oldest and\n *   `break` at the first non-expired entry \u2192 O(expired), not O(n).\n */\n\nexport interface MessageDedupOpts {\n  /** Time-to-live for each entry in milliseconds (default: 5 min). */\n  ttlMs?: number;\n  /** Maximum number of tracked entries (default: 10 000). */\n  maxEntries?: number;\n}\n\nconst DEFAULT_TTL_MS = 12 * 60 * 60 * 1000; // 12 hours\nconst DEFAULT_MAX_ENTRIES = 5_000;\nconst SWEEP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes\n\n// ---------------------------------------------------------------------------\n// Message expiry check\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_EXPIRY_MS = 30 * 60 * 1000; // 30 minutes\n\n/**\n * Check whether a message is too old to process.\n *\n * Feishu message `create_time` is a millisecond Unix timestamp encoded\n * as a string.  When a WebSocket reconnects after a long outage, stale\n * messages may be redelivered \u2014 this function lets callers discard them\n * before entering the full handling pipeline.\n */\nexport function isMessageExpired(createTimeStr: string | undefined, expiryMs: number = DEFAULT_EXPIRY_MS): boolean {\n  if (!createTimeStr) return false;\n  const createTime = parseInt(createTimeStr, 10);\n  if (Number.isNaN(createTime)) return false;\n  return Date.now() - createTime > expiryMs;\n}\n\n// ---------------------------------------------------------------------------\n// Message deduplication\n// ---------------------------------------------------------------------------\n\nexport class MessageDedup {\n  private readonly store = new Map<string, number>();\n  private readonly ttlMs: number;\n  private readonly maxEntries: number;\n  private readonly sweepTimer: ReturnType<typeof setInterval>;\n\n  constructor(opts: MessageDedupOpts = {}) {\n    this.ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;\n    this.maxEntries = opts.maxEntries ?? DEFAULT_MAX_ENTRIES;\n\n    // Periodic sweep \u2014 relies on FIFO ordering so we can break early.\n    this.sweepTimer = setInterval(() => this.sweep(), SWEEP_INTERVAL_MS);\n    this.sweepTimer.unref();\n  }\n\n  /**\n   * Try to record a message ID.\n   *\n   * @param id   Unique message identifier (e.g. Feishu `message_id`).\n   * @param scope Optional scope prefix (e.g. accountId) to namespace IDs.\n   * @returns `true` if the message is **new**; `false` if it is a duplicate.\n   */\n  tryRecord(id: string, scope?: string): boolean {\n    const key = scope ? `${scope}:${id}` : id;\n    const now = Date.now();\n\n    const existing = this.store.get(key);\n    if (existing !== undefined) {\n      // Entry exists \u2014 check TTL.\n      if (now - existing < this.ttlMs) {\n        // Still within TTL \u2192 duplicate.\n        return false;\n      }\n      // Expired \u2014 remove so we can re-insert at the tail (refresh position).\n      this.store.delete(key);\n    }\n\n    // Enforce capacity via FIFO: drop the oldest entry.\n    if (this.store.size >= this.maxEntries) {\n      const oldest = this.store.keys().next().value;\n      if (oldest !== undefined) {\n        this.store.delete(oldest);\n      }\n    }\n\n    this.store.set(key, now);\n    return true;\n  }\n\n  /** Current number of tracked entries (for diagnostics). */\n  get size(): number {\n    return this.store.size;\n  }\n\n  /** Remove all entries and stop the periodic sweep. */\n  clear(): void {\n    clearInterval(this.sweepTimer);\n    this.store.clear();\n  }\n\n  /** Stop the periodic sweep timer and clear all tracked entries. */\n  dispose(): void {\n    clearInterval(this.sweepTimer);\n    this.store.clear();\n  }\n\n  // ---------------------------------------------------------------------------\n  // Internal\n  // ---------------------------------------------------------------------------\n\n  /**\n   * Sweep expired entries from the front of the map.\n   * Because entries are in insertion order (FIFO), we can stop as soon as\n   * we hit one that hasn't expired yet.\n   */\n  private sweep(): void {\n    const now = Date.now();\n    for (const [key, ts] of this.store) {\n      if (now - ts < this.ttlMs) break;\n      this.store.delete(key);\n    }\n  }\n}\n"],
+  "mappings": "AAyBA,MAAM,iBAAiB,KAAK,KAAK,KAAK;AACtC,MAAM,sBAAsB;AAC5B,MAAM,oBAAoB,IAAI,KAAK;AAMnC,MAAM,oBAAoB,KAAK,KAAK;AAU7B,SAAS,iBAAiB,eAAmC,WAAmB,mBAA4B;AACjH,MAAI,CAAC,cAAe,QAAO;AAC3B,QAAM,aAAa,SAAS,eAAe,EAAE;AAC7C,MAAI,OAAO,MAAM,UAAU,EAAG,QAAO;AACrC,SAAO,KAAK,IAAI,IAAI,aAAa;AACnC;AAMO,MAAM,aAAa;AAAA,EACP,QAAQ,oBAAI,IAAoB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,OAAyB,CAAC,GAAG;AACvC,SAAK,QAAQ,KAAK,SAAS;AAC3B,SAAK,aAAa,KAAK,cAAc;AAGrC,SAAK,aAAa,YAAY,MAAM,KAAK,MAAM,GAAG,iBAAiB;AACnE,SAAK,WAAW,MAAM;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,UAAU,IAAY,OAAyB;AAC7C,UAAM,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE,KAAK;AACvC,UAAM,MAAM,KAAK,IAAI;AAErB,UAAM,WAAW,KAAK,MAAM,IAAI,GAAG;AACnC,QAAI,aAAa,QAAW;AAE1B,UAAI,MAAM,WAAW,KAAK,OAAO;AAE/B,eAAO;AAAA,MACT;AAEA,WAAK,MAAM,OAAO,GAAG;AAAA,IACvB;AAGA,QAAI,KAAK,MAAM,QAAQ,KAAK,YAAY;AACtC,YAAM,SAAS,KAAK,MAAM,KAAK,EAAE,KAAK,EAAE;AACxC,UAAI,WAAW,QAAW;AACxB,aAAK,MAAM,OAAO,MAAM;AAAA,MAC1B;AAAA,IACF;AAEA,SAAK,MAAM,IAAI,KAAK,GAAG;AACvB,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,OAAe;AACjB,WAAO,KAAK,MAAM;AAAA,EACpB;AAAA;AAAA,EAGA,QAAc;AACZ,kBAAc,KAAK,UAAU;AAC7B,SAAK,MAAM,MAAM;AAAA,EACnB;AAAA;AAAA,EAGA,UAAgB;AACd,kBAAc,KAAK,UAAU;AAC7B,SAAK,MAAM,MAAM;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,QAAc;AACpB,UAAM,MAAM,KAAK,IAAI;AACrB,eAAW,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO;AAClC,UAAI,MAAM,KAAK,KAAK,MAAO;AAC3B,WAAK,MAAM,OAAO,GAAG;AAAA,IACvB;AAAA,EACF;AACF;",
+  "names": []
+}