chat 4.32.0 → 4.33.0

package/dist/adapters/index.d.ts

@@ -148,6 +148,35 @@ declare const ADAPTERS: {
         readonly slug: "agentphone";
         readonly type: "platform";
     };
+    readonly "cloudflare-agents": {
+        readonly description: "Cloudflare Agents state adapter for Chat SDK. Stores subscriptions, locks, queues, and history in Durable Object SQLite via ChatSdkStateAgent sub-agents.";
+        readonly env: {
+            readonly config: readonly ["parent", "agent", "name", "shardKey", "keyShard"];
+            readonly notes: "No environment variables are required. State is stored in Durable Object SQLite via ChatSdkStateAgent sub-agents; add the parent Agent to your Durable Object migration and re-export ChatSdkStateAgent from the Worker entry point.";
+        };
+        readonly factoryExport: "createChatSdkState";
+        readonly group: "vendor-official";
+        readonly name: "Cloudflare Agents";
+        readonly packageName: "agents";
+        readonly peerDeps: readonly [];
+        readonly slug: "cloudflare-agents";
+        readonly type: "state";
+    };
+    readonly dial: {
+        readonly description: "SMS, MMS, iMessage, and inbound voice-call transcripts for Chat SDK, built and maintained by Dial. One handler answers phone traffic the same way it answers Slack/Teams/Discord, with HMAC-signed webhooks and replies over @getdial/sdk.";
+        readonly env: {
+            readonly config: readonly ["apiBaseUrl", "botName", "logger"];
+            readonly optional: readonly [EnvVar, EnvVar, EnvVar];
+            readonly required: readonly [EnvVar, EnvVar];
+        };
+        readonly factoryExport: "createDialAdapter";
+        readonly group: "vendor-official";
+        readonly name: "Dial";
+        readonly packageName: "@getdial/chat-sdk-adapter";
+        readonly peerDeps: readonly [];
+        readonly slug: "dial";
+        readonly type: "platform";
+    };
     readonly discord: {
         readonly description: "Create Discord bots with slash commands, threads, and rich embeds.";
         readonly env: {
@@ -172,7 +201,7 @@ declare const ADAPTERS: {
                 readonly label: "GitHub App";
                 readonly vars: readonly [EnvVar, EnvVar];
             }];
-            readonly optional: readonly [EnvVar, EnvVar, EnvVar];
+            readonly optional: readonly [EnvVar, EnvVar, EnvVar, EnvVar];
             readonly required: readonly [EnvVar];
         };
         readonly factoryExport: "createGitHubAdapter";
@@ -363,6 +392,27 @@ declare const ADAPTERS: {
         readonly slug: "novu";
         readonly type: "platform";
     };
+    readonly photon: {
+        readonly description: "iMessage adapter for Chat SDK, built and maintained by Photon. Cloud, self-hosted, and on-device (macOS) iMessage over spectrum-ts.";
+        readonly env: {
+            readonly config: readonly ["clients", "logger"];
+            readonly credentialModes: readonly [{
+                readonly label: "Spectrum Cloud";
+                readonly vars: readonly [EnvVar, EnvVar];
+            }, {
+                readonly label: "Self-hosted";
+                readonly vars: readonly [EnvVar, EnvVar];
+            }];
+            readonly optional: readonly [EnvVar, EnvVar, EnvVar];
+        };
+        readonly factoryExport: "createiMessageAdapter";
+        readonly group: "vendor-official";
+        readonly name: "Photon";
+        readonly packageName: "@photon-ai/chat-adapter-imessage";
+        readonly peerDeps: readonly [];
+        readonly slug: "photon";
+        readonly type: "platform";
+    };
     readonly postgres: {
         readonly description: "Production state adapter using PostgreSQL for persistence and distributed locking.";
         readonly env: {
@@ -544,6 +594,27 @@ declare const ADAPTERS: {
         readonly slug: "whatsapp";
         readonly type: "platform";
     };
+    readonly x: {
+        readonly description: "Reply to public mentions and hold direct message conversations on X (Twitter) with the X API v2.";
+        readonly env: {
+            readonly credentialModes: readonly [{
+                readonly label: "Static access token";
+                readonly vars: readonly [EnvVar];
+            }, {
+                readonly label: "Managed OAuth refresh";
+                readonly vars: readonly [EnvVar, EnvVar];
+            }];
+            readonly optional: readonly [EnvVar, EnvVar, EnvVar, EnvVar, EnvVar];
+            readonly required: readonly [EnvVar];
+        };
+        readonly factoryExport: "createXAdapter";
+        readonly group: "official";
+        readonly name: "X";
+        readonly packageName: "@chat-adapter/x";
+        readonly peerDeps: readonly [];
+        readonly slug: "x";
+        readonly type: "platform";
+    };
     readonly zernio: {
         readonly description: "Unified social media DM adapter covering Instagram, Facebook, Telegram, WhatsApp, X/Twitter, Bluesky, and Reddit through a single integration.";
         readonly env: {

package/dist/adapters/index.js

@@ -40,6 +40,54 @@ var ADAPTERS = {
     slug: "agentphone",
     type: "platform"
   },
+  "cloudflare-agents": {
+    description: "Cloudflare Agents state adapter for Chat SDK. Stores subscriptions, locks, queues, and history in Durable Object SQLite via ChatSdkStateAgent sub-agents.",
+    env: {
+      config: ["parent", "agent", "name", "shardKey", "keyShard"],
+      notes: "No environment variables are required. State is stored in Durable Object SQLite via ChatSdkStateAgent sub-agents; add the parent Agent to your Durable Object migration and re-export ChatSdkStateAgent from the Worker entry point."
+    },
+    factoryExport: "createChatSdkState",
+    group: "vendor-official",
+    name: "Cloudflare Agents",
+    packageName: "agents",
+    peerDeps: [],
+    slug: "cloudflare-agents",
+    type: "state"
+  },
+  dial: {
+    description: "SMS, MMS, iMessage, and inbound voice-call transcripts for Chat SDK, built and maintained by Dial. One handler answers phone traffic the same way it answers Slack/Teams/Discord, with HMAC-signed webhooks and replies over @getdial/sdk.",
+    env: {
+      config: ["apiBaseUrl", "botName", "logger"],
+      optional: [
+        secretEnv(
+          "DIAL_WEBHOOK_SECRET",
+          "HMAC-SHA256 signing secret from the Dial webhook subscription; enables signature verification of inbound requests."
+        ),
+        env(
+          "DIAL_API_URL",
+          "Override the Dial API host. Defaults to https://api.getdial.ai."
+        ),
+        env(
+          "BOT_USERNAME",
+          'Display name Chat SDK uses for the bot. Defaults to "bot".'
+        )
+      ],
+      required: [
+        secretEnv("DIAL_API_KEY", "Dial API key (sk_live_\u2026)."),
+        env(
+          "DIAL_FROM_NUMBER_ID",
+          "Dial's ID of the phone number the bot sends from."
+        )
+      ]
+    },
+    factoryExport: "createDialAdapter",
+    group: "vendor-official",
+    name: "Dial",
+    packageName: "@getdial/chat-sdk-adapter",
+    peerDeps: [],
+    slug: "dial",
+    type: "platform"
+  },
   discord: {
     description: "Create Discord bots with slash commands, threads, and rich embeds.",
     env: {
@@ -86,6 +134,10 @@ var ADAPTERS = {
           "Installation ID for single-installation app deployments."
         ),
         env("GITHUB_BOT_USERNAME", "Bot username for mention detection."),
+        env(
+          "GITHUB_BOT_USER_ID",
+          "Numeric bot user ID for self-message detection; recommended on serverless and with Vercel Connect to prevent reply loops."
+        ),
         urlEnv("GITHUB_API_URL", "Override the GitHub API base URL.")
       ],
       required: [secretEnv("GITHUB_WEBHOOK_SECRET", "Webhook signing secret.")]
@@ -439,6 +491,58 @@ var ADAPTERS = {
     slug: "novu",
     type: "platform"
   },
+  photon: {
+    description: "iMessage adapter for Chat SDK, built and maintained by Photon. Cloud, self-hosted, and on-device (macOS) iMessage over spectrum-ts.",
+    env: {
+      config: ["clients", "logger"],
+      credentialModes: [
+        {
+          label: "Spectrum Cloud",
+          vars: [
+            env("IMESSAGE_PROJECT_ID", "Spectrum Cloud project ID."),
+            secretEnv(
+              "IMESSAGE_PROJECT_SECRET",
+              "Spectrum Cloud project secret."
+            )
+          ]
+        },
+        {
+          label: "Self-hosted",
+          vars: [
+            urlEnv(
+              "IMESSAGE_SERVER_URL",
+              "gRPC host:port of a self-hosted iMessage server (not an https URL)."
+            ),
+            secretEnv(
+              "IMESSAGE_API_KEY",
+              "Auth token for the self-hosted server."
+            )
+          ]
+        }
+      ],
+      optional: [
+        env(
+          "IMESSAGE_LOCAL",
+          'Set to "false" for cloud/self-host; on-device (local, macOS) mode is the default.'
+        ),
+        secretEnv(
+          "IMESSAGE_WEBHOOK_SECRET",
+          "Per-webhook signing secret for verifying Spectrum Cloud deliveries."
+        ),
+        env(
+          "IMESSAGE_PHONE",
+          "Routing/identity phone for multi-number setups."
+        )
+      ]
+    },
+    factoryExport: "createiMessageAdapter",
+    group: "vendor-official",
+    name: "Photon",
+    packageName: "@photon-ai/chat-adapter-imessage",
+    peerDeps: [],
+    slug: "photon",
+    type: "platform"
+  },
   postgres: {
     description: "Production state adapter using PostgreSQL for persistence and distributed locking.",
     env: {
@@ -735,6 +839,64 @@ var ADAPTERS = {
     slug: "whatsapp",
     type: "platform"
   },
+  x: {
+    description: "Reply to public mentions and hold direct message conversations on X (Twitter) with the X API v2.",
+    env: {
+      credentialModes: [
+        {
+          label: "Static access token",
+          vars: [
+            secretEnv(
+              "X_USER_ACCESS_TOKEN",
+              "OAuth 2.0 user-context access token for outbound API calls."
+            )
+          ]
+        },
+        {
+          label: "Managed OAuth refresh",
+          vars: [
+            env("X_CLIENT_ID", "OAuth 2.0 client ID."),
+            secretEnv(
+              "X_REFRESH_TOKEN",
+              "OAuth 2.0 refresh token (requires the offline.access scope)."
+            )
+          ]
+        }
+      ],
+      optional: [
+        secretEnv(
+          "X_CLIENT_SECRET",
+          "OAuth 2.0 client secret for confidential clients."
+        ),
+        secretEnv(
+          "X_ENCRYPTION_KEY",
+          "AES-256-GCM key for encrypting stored OAuth tokens."
+        ),
+        env(
+          "X_USER_ID",
+          "Bot account user ID. Fetched from /2/users/me when omitted."
+        ),
+        env(
+          "X_USERNAME",
+          "Bot account handle used for mention detection. Fetched when omitted."
+        ),
+        urlEnv("X_API_BASE_URL", "Override the X API base URL.")
+      ],
+      required: [
+        secretEnv(
+          "X_CONSUMER_SECRET",
+          "App API key secret used for webhook CRC and signature verification."
+        )
+      ]
+    },
+    factoryExport: "createXAdapter",
+    group: "official",
+    name: "X",
+    packageName: "@chat-adapter/x",
+    peerDeps: [],
+    slug: "x",
+    type: "platform"
+  },
   zernio: {
     description: "Unified social media DM adapter covering Instagram, Facebook, Telegram, WhatsApp, X/Twitter, Bluesky, and Reddit through a single integration.",
     env: {

package/dist/ai/index.d.ts

@@ -1,10 +1,10 @@
-import { x as Chat, w as ChannelVisibility } from '../chat-Dm1vQU3i.js';
-export { d as AiAssistantMessage, e as AiFilePart, f as AiImagePart, g as AiMessage, h as AiMessagePart, i as AiTextPart, j as AiUserMessage, aZ as ToAiMessagesOptions, b7 as toAiMessages } from '../chat-Dm1vQU3i.js';
+import { C as Chat, a as ChannelVisibility } from '../messages-x-XVhW8B.js';
+export { A as AiAssistantMessage, b as AiFilePart, c as AiImagePart, d as AiMessage, e as AiMessagePart, f as AiTextPart, g as AiUserMessage, T as ToAiMessagesOptions, t as toAiMessages } from '../messages-x-XVhW8B.js';
 import * as ai from 'ai';
 import { Tool } from 'ai';
 import '@workflow/serde';
 import 'mdast';
-import '../jsx-runtime-CzthIo1o.js';
+import '../jsx-runtime-LBOLBP4o.js';
 
 /**
  * The Chat instance used by all tools to dispatch operations.

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { ay as PostableObject, b as Adapter, az as PostableObjectContext, aN as StreamChunk, aU as ThreadHistoryCache, aV as ThreadHistoryConfig, aO as StreamEvent, L as EmojiFormats, M as EmojiMapConfig, N as EmojiValue, b4 as WellKnownEmoji, G as CustomEmojiMap, c as AdapterPostableMessage } from './chat-Dm1vQU3i.js';
-export { A as ActionEvent, a as ActionHandler, d as AiAssistantMessage, e as AiFilePart, f as AiImagePart, g as AiMessage, h as AiMessagePart, i as AiTextPart, j as AiUserMessage, k as AppHomeOpenedEvent, l as AppHomeOpenedHandler, m as AppendInput, n as AppendOptions, o as AssistantContextChangedEvent, p as AssistantContextChangedHandler, q as AssistantThreadStartedEvent, r as AssistantThreadStartedHandler, s as Attachment, t as Author, C as Channel, u as ChannelImpl, v as ChannelInfo, w as ChannelVisibility, x as Chat, y as ChatConfig, z as ChatInstance, B as ConcurrencyConfig, D as ConcurrencyStrategy, E as ConsoleLogger, F as CountQuery, H as DeleteTarget, I as DirectMessageHandler, J as DurationString, K as Emoji, O as EphemeralMessage, P as FetchDirection, Q as FetchOptions, R as FetchResult, S as FileUpload, T as FormattedContent, U as IdentityContext, V as IdentityResolver, W as LinkPreview, X as ListQuery, Y as ListThreadsOptions, Z as ListThreadsResult, _ as Lock, $ as LockScope, a0 as LockScopeContext, a1 as LogLevel, a2 as Logger, a3 as MarkdownTextChunk, a4 as MemberJoinedChannelEvent, a5 as MemberJoinedChannelHandler, a6 as MentionHandler, a7 as Message, a8 as MessageContext, a9 as MessageData, aa as MessageHandler, ab as MessageMetadata, ac as MessageSubject, ad as ModalClearResponse, ae as ModalCloseEvent, af as ModalCloseHandler, ag as ModalCloseResponse, ah as ModalErrorsResponse, ai as ModalPushResponse, aj as ModalResponse, ak as ModalSubmitEvent, al as ModalSubmitHandler, am as ModalUpdateResponse, an as OptionsLoadEvent, ao as OptionsLoadGroup, ap as OptionsLoadHandler, aq as OptionsLoadResult, ar as PlanUpdateChunk, as as PostEphemeralOptions, at as Postable, au as PostableAst, av as PostableCard, aw as PostableMarkdown, ax as PostableMessage, aA as PostableRaw, aB as QueueEntry, aC as RawMessage, aD as ReactionEvent, aE as ReactionHandler, aF as ScheduledMessage, aG as SentMessage, aH as SerializedChannel, aI as SerializedMessage, aJ as SerializedThread, aK as SlashCommandEvent, aL as SlashCommandHandler, aM as StateAdapter, aP as StreamOptions, aQ as SubscribedMessageHandler, aR as THREAD_STATE_TTL_MS, aS as TaskUpdateChunk, aT as Thread, aW as ThreadImpl, aX as ThreadInfo, aY as ThreadSummary, aZ as ToAiMessagesOptions, a_ as TranscriptEntry, a$ as TranscriptRole, b0 as TranscriptsApi, b1 as TranscriptsConfig, b2 as UserInfo, b3 as WebhookOptions, b5 as deriveChannelId, b6 as isPostableObject, b7 as toAiMessages } from './chat-Dm1vQU3i.js';
+import { P as PostableObject, h as Adapter, i as PostableObjectContext, S as StreamChunk, j as ThreadHistoryCache, k as ThreadHistoryConfig, l as StreamEvent, E as EmojiFormats, m as EmojiMapConfig, n as EmojiValue, W as WellKnownEmoji, o as CustomEmojiMap, p as AdapterPostableMessage } from './messages-x-XVhW8B.js';
+export { q as ActionEvent, r as ActionHandler, A as AiAssistantMessage, b as AiFilePart, c as AiImagePart, d as AiMessage, e as AiMessagePart, f as AiTextPart, g as AiUserMessage, s as AppHomeOpenedEvent, u as AppHomeOpenedHandler, v as AppendInput, w as AppendOptions, x as AssistantContextChangedEvent, y as AssistantContextChangedHandler, z as AssistantThreadStartedEvent, B as AssistantThreadStartedHandler, D as Attachment, F as Author, G as Channel, H as ChannelImpl, I as ChannelInfo, a as ChannelVisibility, C as Chat, J as ChatConfig, K as ChatInstance, L as ConcurrencyConfig, M as ConcurrencyStrategy, N as ConsoleLogger, O as CountQuery, Q as DeleteTarget, R as DirectMessageHandler, U as DurationString, V as Emoji, X as EphemeralMessage, Y as FetchDirection, Z as FetchOptions, _ as FetchResult, $ as FileUpload, a0 as FormattedContent, a1 as IdentityContext, a2 as IdentityResolver, a3 as LinkPreview, a4 as ListQuery, a5 as ListThreadsOptions, a6 as ListThreadsResult, a7 as Lock, a8 as LockScope, a9 as LockScopeContext, aa as LogLevel, ab as Logger, ac as MarkdownTextChunk, ad as MemberJoinedChannelEvent, ae as MemberJoinedChannelHandler, af as MentionHandler, ag as Message, ah as MessageContext, ai as MessageData, aj as MessageHandler, ak as MessageMetadata, al as MessageSubject, am as ModalClearResponse, an as ModalCloseEvent, ao as ModalCloseHandler, ap as ModalCloseResponse, aq as ModalErrorsResponse, ar as ModalPushResponse, as as ModalResponse, at as ModalSubmitEvent, au as ModalSubmitHandler, av as ModalUpdateResponse, aw as OptionsLoadEvent, ax as OptionsLoadGroup, ay as OptionsLoadHandler, az as OptionsLoadResult, aA as PlanUpdateChunk, aB as PostEphemeralOptions, aC as Postable, aD as PostableAst, aE as PostableCard, aF as PostableMarkdown, aG as PostableMessage, aH as PostableRaw, aI as QueueEntry, aJ as RawMessage, aK as ReactionEvent, aL as ReactionHandler, aM as ScheduledMessage, aN as SentMessage, aO as SerializedChannel, aP as SerializedMessage, aQ as SerializedThread, aR as SlashCommandEvent, aS as SlashCommandHandler, aT as StateAdapter, aU as StreamOptions, aV as SubscribedMessageHandler, aW as THREAD_STATE_TTL_MS, aX as TaskUpdateChunk, aY as Thread, aZ as ThreadImpl, a_ as ThreadInfo, a$ as ThreadSummary, T as ToAiMessagesOptions, b0 as TranscriptEntry, b1 as TranscriptRole, b2 as TranscriptsApi, b3 as TranscriptsConfig, b4 as UserInfo, b5 as WebhookOptions, b6 as deriveChannelId, b7 as isPostableObject, t as toAiMessages } from './messages-x-XVhW8B.js';
 import { Root, List, Content, Blockquote, Code, Emphasis, InlineCode, Delete, Link, ListItem, Paragraph, Strong, TableCell, Table as Table$1, TableRow, Text } from 'mdast';
 export { Blockquote, Code, Content, Delete, Emphasis, InlineCode, Link, List, ListItem, Table as MdastTable, Nodes, Paragraph, Root, Strong, TableCell, TableRow, Text } from 'mdast';
-import { g as CardElement, C as CardChild, A as ActionsComponent, B as ButtonComponent, f as CardComponent, j as CardLinkComponent, a9 as TextComponent, D as DividerComponent, E as ExternalSelectComponent, F as FieldComponent, w as FieldsComponent, I as ImageComponent, L as LinkButtonComponent, P as ModalComponent, T as RadioSelectComponent, W as SectionComponent, Y as SelectComponent, _ as SelectOptionComponent, a3 as Table$2, ab as TextInputComponent, ah as cardChildToFallbackText$1, ai as fromReactElement$1, aj as fromReactModalElement$1, ak as isCardElement$1, am as isJSX$1, an as isModalElement$1, ar as toCardElement$1, as as toModalElement$1 } from './jsx-runtime-CzthIo1o.js';
-export { a as ActionsElement, b as ButtonElement, c as ButtonOptions, d as ButtonProps, e as ButtonStyle, h as CardJSXElement, i as CardJSXProps, k as CardLinkProps, l as CardOptions, m as CardProps, n as ChatElement, o as ContainerProps, p as DividerElement, q as DividerProps, r as ExternalSelectElement, s as ExternalSelectOptions, t as ExternalSelectProps, u as FieldElement, v as FieldProps, x as FieldsElement, z as ImageElement, G as ImageProps, H as LinkButtonElement, K as LinkButtonOptions, M as LinkButtonProps, N as LinkElement, O as ModalChild, Q as ModalElement, R as ModalOptions, S as ModalProps, U as RadioSelectElement, V as RadioSelectOptions, X as SectionElement, Z as SelectElement, $ as SelectOptionElement, a0 as SelectOptionProps, a1 as SelectOptions, a2 as SelectProps, a4 as TableAlignment, a6 as TableElement, a7 as TableOptions, aa as TextElement, ac as TextInputElement, ad as TextInputOptions, ae as TextInputProps, af as TextProps, ag as TextStyle } from './jsx-runtime-CzthIo1o.js';
+import { C as CardElement, a as CardChild, A as ActionsComponent, B as ButtonComponent, b as CardComponent, c as CardLinkComponent, T as TextComponent, D as DividerComponent, E as ExternalSelectComponent, F as FieldComponent, d as FieldsComponent, I as ImageComponent, L as LinkButtonComponent, M as ModalComponent, R as RadioSelectComponent, S as SectionComponent, e as SelectComponent, f as SelectOptionComponent, g as Table$2, h as TextInputComponent, i as cardChildToFallbackText$1, j as fromReactElement$1, k as fromReactModalElement$1, l as isCardElement$1, m as isJSX$1, n as isModalElement$1, t as toCardElement$1, o as toModalElement$1 } from './jsx-runtime-LBOLBP4o.js';
+export { p as ActionsElement, q as ButtonElement, r as ButtonOptions, s as ButtonProps, u as ButtonStyle, v as CardJSXElement, w as CardJSXProps, x as CardLinkProps, y as CardOptions, z as CardProps, G as ChatElement, H as ContainerProps, J as DividerElement, K as DividerProps, N as ExternalSelectElement, O as ExternalSelectOptions, P as ExternalSelectProps, Q as FieldElement, U as FieldProps, V as FieldsElement, W as ImageElement, X as ImageProps, Y as LinkButtonElement, Z as LinkButtonOptions, _ as LinkButtonProps, $ as LinkElement, a0 as ModalChild, a1 as ModalElement, a2 as ModalOptions, a3 as ModalProps, a4 as RadioSelectElement, a5 as RadioSelectOptions, a6 as SectionElement, a7 as SelectElement, a8 as SelectOptionElement, a9 as SelectOptionProps, aa as SelectOptions, ab as SelectProps, ac as TableAlignment, ad as TableElement, ae as TableOptions, af as TextElement, ag as TextInputElement, ah as TextInputOptions, ai as TextInputProps, aj as TextProps, ak as TextStyle } from './jsx-runtime-LBOLBP4o.js';
 import '@workflow/serde';
 
 /**
@@ -354,7 +354,7 @@ declare const defaultEmojiResolver: EmojiResolver;
  * // Returns: "Thanks! 👍"
  * ```
  */
-declare function convertEmojiPlaceholders(text: string, platform: "slack" | "gchat" | "teams" | "discord" | "messenger" | "github" | "linear" | "whatsapp", resolver?: EmojiResolver): string;
+declare function convertEmojiPlaceholders(text: string, platform: "slack" | "gchat" | "teams" | "discord" | "messenger" | "github" | "linear" | "whatsapp" | "x", resolver?: EmojiResolver): string;
 /** Base emoji object with well-known emoji as EmojiValue singletons */
 type BaseEmojiHelper = {
     [K in WellKnownEmoji]: EmojiValue;

package/dist/index.js

@@ -2119,7 +2119,7 @@ var SLACK_USER_ID_REGEX = /^[UW][A-Z0-9]+$/;
 var DISCORD_SNOWFLAKE_REGEX = /^\d{17,19}$/;
 var LINEAR_UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var NUMERIC_REGEX = /^\d+$/;
-var DEDUPE_TTL_MS = 5 * 60 * 1e3;
+var DEDUPE_TTL_MS = 10 * 60 * 1e3;
 var MODAL_CONTEXT_TTL_MS = 24 * 60 * 60 * 1e3;
 var Chat = class {
   /**
@@ -3535,7 +3535,7 @@ var Chat = class {
       DEFAULT_LOCK_TTL_MS
     );
     if (!lock) {
-      const effectiveMaxSize = strategy === "debounce" ? 1 : maxQueueSize;
+      const effectiveMaxSize = maxQueueSize;
       const depth = await this._stateAdapter.queueDepth(lockKey);
       if (depth >= effectiveMaxSize && strategy !== "debounce" && onQueueFull === "drop-newest") {
         this.logger.info("message-dropped", {
@@ -3580,7 +3580,7 @@ var Chat = class {
             enqueuedAt: Date.now(),
             expiresAt: Date.now() + queueEntryTtlMs
           },
-          1
+          maxQueueSize
         );
         this.logger.info("message-debouncing", {
           threadId,
@@ -3623,37 +3623,54 @@ var Chat = class {
    */
   async debounceLoop(lock, adapter, threadId, lockKey) {
     const { debounceMs } = this._concurrencyConfig;
+    const skipped = [];
     while (true) {
       await sleep(debounceMs);
       await this._stateAdapter.extendLock(lock, DEFAULT_LOCK_TTL_MS);
-      const entry = await this._stateAdapter.dequeue(lockKey);
-      if (!entry) {
+      const pending = [];
+      while (true) {
+        const entry = await this._stateAdapter.dequeue(lockKey);
+        if (!entry) {
+          break;
+        }
+        const msg = this.rehydrateMessage(entry.message, adapter);
+        if (Date.now() <= entry.expiresAt) {
+          pending.push({ message: msg, expiresAt: entry.expiresAt });
+        } else {
+          this.logger.info("message-expired", {
+            threadId,
+            lockKey,
+            messageId: msg.id
+          });
+        }
+      }
+      if (pending.length === 0) {
         break;
       }
-      const msg = this.rehydrateMessage(entry.message, adapter);
-      if (Date.now() > entry.expiresAt) {
-        this.logger.info("message-expired", {
-          threadId,
-          lockKey,
-          messageId: msg.id
-        });
-        continue;
+      const latest = pending.at(-1);
+      if (!latest) {
+        break;
       }
+      skipped.push(...pending.slice(0, -1).map((entry) => entry.message));
       const depth = await this._stateAdapter.queueDepth(lockKey);
       if (depth > 0) {
+        skipped.push(latest.message);
         this.logger.info("message-superseded", {
           threadId,
           lockKey,
-          droppedId: msg.id
+          droppedId: latest.message.id
         });
         continue;
       }
       this.logger.info("message-dequeued", {
         threadId,
         lockKey,
-        messageId: msg.id
+        messageId: latest.message.id
+      });
+      await this.dispatchToHandlers(adapter, threadId, latest.message, {
+        skipped,
+        totalSinceLastHandler: skipped.length + 1
       });
-      await this.dispatchToHandlers(adapter, threadId, msg);
       break;
     }
   }
@@ -3814,7 +3831,7 @@ var Chat = class {
       );
       return;
     }
-    if (message.isMention || hasMention) {
+    if (message.isMention || hasMention && this.mentionHandlers.length > 0) {
       this.logger.debug("Bot mentioned", {
         threadId,
         text: message.text.slice(0, 100)
@@ -4486,6 +4503,8 @@ function convertEmojiPlaceholders(text2, platform, resolver = defaultEmojiResolv
         return resolver.toGChat(emojiName);
       case "whatsapp":
         return resolver.toGChat(emojiName);
+      case "x":
+        return resolver.toGChat(emojiName);
       default:
         return resolver.toGChat(emojiName);
     }

package/dist/{jsx-runtime-CzthIo1o.d.ts → jsx-runtime-LBOLBP4o.d.ts}

@@ -784,4 +784,4 @@ declare namespace JSX {
     }
 }
 
-export { type SelectOptionElement as $, type ActionsComponent as A, type ButtonComponent as B, type CardChild as C, type DividerComponent as D, type ExternalSelectComponent as E, type FieldComponent as F, type ImageProps as G, type LinkButtonElement as H, type ImageComponent as I, JSX as J, type LinkButtonOptions as K, type LinkButtonComponent as L, type LinkButtonProps as M, type LinkElement as N, type ModalChild as O, type ModalComponent as P, type ModalElement as Q, type ModalOptions as R, type ModalProps as S, type RadioSelectComponent as T, type RadioSelectElement as U, type RadioSelectOptions as V, type SectionComponent as W, type SectionElement as X, type SelectComponent as Y, type SelectElement as Z, type SelectOptionComponent as _, type ActionsElement as a, type SelectOptionProps as a0, type SelectOptions as a1, type SelectProps as a2, Table as a3, type TableAlignment as a4, type TableComponent as a5, type TableElement as a6, type TableOptions as a7, type TableProps as a8, type TextComponent as a9, type TextElement as aa, type TextInputComponent as ab, type TextInputElement as ac, type TextInputOptions as ad, type TextInputProps as ae, type TextProps as af, type TextStyle as ag, cardChildToFallbackText as ah, fromReactElement as ai, fromReactModalElement as aj, isCardElement as ak, isCardLinkProps as al, isJSX as am, isModalElement as an, jsx as ao, jsxDEV as ap, jsxs as aq, toCardElement as ar, toModalElement as as, type ButtonElement as b, type ButtonOptions as c, type ButtonProps as d, type ButtonStyle as e, type CardComponent as f, type CardElement as g, type CardJSXElement as h, type CardJSXProps as i, type CardLinkComponent as j, type CardLinkProps as k, type CardOptions as l, type CardProps as m, type ChatElement as n, type ContainerProps as o, type DividerElement as p, type DividerProps as q, type ExternalSelectElement as r, type ExternalSelectOptions as s, type ExternalSelectProps as t, type FieldElement as u, type FieldProps as v, type FieldsComponent as w, type FieldsElement as x, Fragment as y, type ImageElement as z };
+export { type LinkElement as $, type ActionsComponent as A, type ButtonComponent as B, type CardElement as C, type DividerComponent as D, type ExternalSelectComponent as E, type FieldComponent as F, type ChatElement as G, type ContainerProps as H, type ImageComponent as I, type DividerElement as J, type DividerProps as K, type LinkButtonComponent as L, type ModalComponent as M, type ExternalSelectElement as N, type ExternalSelectOptions as O, type ExternalSelectProps as P, type FieldElement as Q, type RadioSelectComponent as R, type SectionComponent as S, type TextComponent as T, type FieldProps as U, type FieldsElement as V, type ImageElement as W, type ImageProps as X, type LinkButtonElement as Y, type LinkButtonOptions as Z, type LinkButtonProps as _, type CardChild as a, type ModalChild as a0, type ModalElement as a1, type ModalOptions as a2, type ModalProps as a3, type RadioSelectElement as a4, type RadioSelectOptions as a5, type SectionElement as a6, type SelectElement as a7, type SelectOptionElement as a8, type SelectOptionProps as a9, type SelectOptions as aa, type SelectProps as ab, type TableAlignment as ac, type TableElement as ad, type TableOptions as ae, type TextElement as af, type TextInputElement as ag, type TextInputOptions as ah, type TextInputProps as ai, type TextProps as aj, type TextStyle as ak, Fragment as al, JSX as am, type TableComponent as an, type TableProps as ao, isCardLinkProps as ap, jsx as aq, jsxDEV as ar, jsxs as as, type CardComponent as b, type CardLinkComponent as c, type FieldsComponent as d, type SelectComponent as e, type SelectOptionComponent as f, Table as g, type TextInputComponent as h, cardChildToFallbackText as i, fromReactElement as j, fromReactModalElement as k, isCardElement as l, isJSX as m, isModalElement as n, toModalElement as o, type ActionsElement as p, type ButtonElement as q, type ButtonOptions as r, type ButtonProps as s, toCardElement as t, type ButtonStyle as u, type CardJSXElement as v, type CardJSXProps as w, type CardLinkProps as x, type CardOptions as y, type CardProps as z };

package/dist/jsx-runtime.d.ts

@@ -1 +1 @@
-export { A as ActionsComponent, B as ButtonComponent, d as ButtonProps, f as CardComponent, h as CardJSXElement, i as CardJSXProps, j as CardLinkComponent, k as CardLinkProps, m as CardProps, n as ChatElement, o as ContainerProps, D as DividerComponent, q as DividerProps, E as ExternalSelectComponent, t as ExternalSelectProps, F as FieldComponent, v as FieldProps, w as FieldsComponent, y as Fragment, I as ImageComponent, G as ImageProps, J as JSX, L as LinkButtonComponent, M as LinkButtonProps, P as ModalComponent, S as ModalProps, T as RadioSelectComponent, W as SectionComponent, Y as SelectComponent, _ as SelectOptionComponent, a0 as SelectOptionProps, a2 as SelectProps, a5 as TableComponent, a8 as TableProps, a9 as TextComponent, ab as TextInputComponent, ae as TextInputProps, af as TextProps, al as isCardLinkProps, am as isJSX, ao as jsx, ap as jsxDEV, aq as jsxs, ar as toCardElement, as as toModalElement } from './jsx-runtime-CzthIo1o.js';
+export { A as ActionsComponent, B as ButtonComponent, s as ButtonProps, b as CardComponent, v as CardJSXElement, w as CardJSXProps, c as CardLinkComponent, x as CardLinkProps, z as CardProps, G as ChatElement, H as ContainerProps, D as DividerComponent, K as DividerProps, E as ExternalSelectComponent, P as ExternalSelectProps, F as FieldComponent, U as FieldProps, d as FieldsComponent, al as Fragment, I as ImageComponent, X as ImageProps, am as JSX, L as LinkButtonComponent, _ as LinkButtonProps, M as ModalComponent, a3 as ModalProps, R as RadioSelectComponent, S as SectionComponent, e as SelectComponent, f as SelectOptionComponent, a9 as SelectOptionProps, ab as SelectProps, an as TableComponent, ao as TableProps, T as TextComponent, h as TextInputComponent, ai as TextInputProps, aj as TextProps, ap as isCardLinkProps, m as isJSX, aq as jsx, ar as jsxDEV, as as jsxs, t as toCardElement, o as toModalElement } from './jsx-runtime-LBOLBP4o.js';

package/dist/{chat-Dm1vQU3i.d.ts → messages-x-XVhW8B.d.ts}

@@ -1,6 +1,177 @@
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 import { Root } from 'mdast';
-import { n as ChatElement, g as CardElement, Q as ModalElement, $ as SelectOptionElement } from './jsx-runtime-CzthIo1o.js';
+import { G as ChatElement, C as CardElement, a1 as ModalElement, a8 as SelectOptionElement } from './jsx-runtime-LBOLBP4o.js';
+
+/**
+ * Message class with serialization support for workflow engines.
+ */
+
+/**
+ * Input data for creating a Message instance.
+ * Use this interface when constructing Message objects.
+ */
+interface MessageData<TRawMessage = unknown> {
+    /** Attachments */
+    attachments: Attachment[];
+    /** Message author */
+    author: Author;
+    /** Structured formatting as an AST (mdast Root) */
+    formatted: FormattedContent;
+    /** Unique message ID */
+    id: string;
+    /** Whether the bot is @-mentioned in this message */
+    isMention?: boolean;
+    /** Links found in the message */
+    links?: LinkPreview[];
+    /** Message metadata */
+    metadata: MessageMetadata;
+    /** Platform-specific raw payload (escape hatch) */
+    raw: TRawMessage;
+    /** Plain text content (all formatting stripped) */
+    text: string;
+    /** Thread this message belongs to */
+    threadId: string;
+}
+/**
+ * Serialized message data for passing to external systems (e.g., workflow engines).
+ * Dates are converted to ISO strings, and non-serializable fields are omitted.
+ */
+interface SerializedMessage {
+    _type: "chat:Message";
+    attachments: Array<{
+        type: "image" | "file" | "video" | "audio";
+        url?: string;
+        name?: string;
+        mimeType?: string;
+        size?: number;
+        width?: number;
+        height?: number;
+        fetchMetadata?: Record<string, string>;
+    }>;
+    author: {
+        userId: string;
+        userName: string;
+        fullName: string;
+        isBot: boolean | "unknown";
+        isMe: boolean;
+    };
+    formatted: Root;
+    id: string;
+    isMention?: boolean;
+    links?: Array<{
+        url: string;
+        title?: string;
+        description?: string;
+        imageUrl?: string;
+        siteName?: string;
+    }>;
+    metadata: {
+        dateSent: string;
+        edited: boolean;
+        editedAt?: string;
+    };
+    raw: unknown;
+    text: string;
+    threadId: string;
+}
+/**
+ * A chat message with serialization support for workflow engines.
+ *
+ * @example
+ * ```typescript
+ * // Create a message
+ * const message = new Message({
+ *   id: "msg-1",
+ *   threadId: "slack:C123:1234.5678",
+ *   text: "Hello world",
+ *   formatted: parseMarkdown("Hello world"),
+ *   raw: {},
+ *   author: { userId: "U123", userName: "user", fullName: "User", isBot: false, isMe: false },
+ *   metadata: { dateSent: new Date(), edited: false },
+ *   attachments: [],
+ * });
+ *
+ * // Serialize for workflow
+ * const serialized = message.toJSON();
+ * ```
+ */
+declare class Message<TRawMessage = unknown> {
+    /** Unique message ID */
+    readonly id: string;
+    /** Thread this message belongs to */
+    readonly threadId: string;
+    /** Plain text content (all formatting stripped) */
+    text: string;
+    /**
+     * Structured formatting as an AST (mdast Root).
+     * This is the canonical representation - use this for processing.
+     * Use `stringifyMarkdown(message.formatted)` to get markdown string.
+     */
+    formatted: FormattedContent;
+    /** Platform-specific raw payload (escape hatch) */
+    raw: TRawMessage;
+    /** Message author */
+    author: Author;
+    /** Message metadata */
+    metadata: MessageMetadata;
+    /** Attachments */
+    attachments: Attachment[];
+    /**
+     * Whether the bot is @-mentioned in this message.
+     *
+     * This is set by the Chat SDK before passing the message to handlers.
+     * It checks for `@username` in the message text using the adapter's
+     * configured `userName` and optional `botUserId`.
+     *
+     * @example
+     * ```typescript
+     * chat.onSubscribedMessage(async (thread, message) => {
+     *   if (message.isMention) {
+     *     await thread.post("You mentioned me!");
+     *   }
+     * });
+     * ```
+     */
+    isMention?: boolean;
+    /**
+     * Cross-platform user key for this message's author.
+     *
+     * Set by the Chat SDK before passing the message to handlers, when
+     * `ChatConfig.identity` is configured. `undefined` if no resolver is
+     * configured; `undefined` (i.e. absent) when the resolver returned null.
+     *
+     * Used by the Transcripts API to look up / append per-user transcripts.
+     */
+    userKey?: string;
+    /** Links found in the message */
+    links: LinkPreview[];
+    private _subjectPromise?;
+    get subject(): Promise<MessageSubject | null>;
+    constructor(data: MessageData<TRawMessage>);
+    /**
+     * Serialize the message to a plain JSON object.
+     * Use this to pass message data to external systems like workflow engines.
+     *
+     * Note: Attachment `data` (Buffer) and `fetchData` (function) are omitted
+     * as they're not serializable.
+     */
+    toJSON(): SerializedMessage;
+    /**
+     * Reconstruct a Message from serialized JSON data.
+     * Converts ISO date strings back to Date objects.
+     */
+    static fromJSON<TRawMessage = unknown>(json: SerializedMessage): Message<TRawMessage>;
+    /**
+     * Serialize a Message instance for @workflow/serde.
+     * This static method is automatically called by workflow serialization.
+     */
+    static [WORKFLOW_SERIALIZE](instance: Message): SerializedMessage;
+    /**
+     * Deserialize a Message from @workflow/serde.
+     * This static method is automatically called by workflow deserialization.
+     */
+    static [WORKFLOW_DESERIALIZE](data: SerializedMessage): Message;
+}
 
 interface ThreadHistoryConfig {
     /** Maximum messages to keep per thread (default: 100) */
@@ -2298,259 +2469,6 @@ interface TranscriptsApi {
     list(query: ListQuery): Promise<TranscriptEntry[]>;
 }
 
-/**
- * Message class with serialization support for workflow engines.
- */
-
-/**
- * Input data for creating a Message instance.
- * Use this interface when constructing Message objects.
- */
-interface MessageData<TRawMessage = unknown> {
-    /** Attachments */
-    attachments: Attachment[];
-    /** Message author */
-    author: Author;
-    /** Structured formatting as an AST (mdast Root) */
-    formatted: FormattedContent;
-    /** Unique message ID */
-    id: string;
-    /** Whether the bot is @-mentioned in this message */
-    isMention?: boolean;
-    /** Links found in the message */
-    links?: LinkPreview[];
-    /** Message metadata */
-    metadata: MessageMetadata;
-    /** Platform-specific raw payload (escape hatch) */
-    raw: TRawMessage;
-    /** Plain text content (all formatting stripped) */
-    text: string;
-    /** Thread this message belongs to */
-    threadId: string;
-}
-/**
- * Serialized message data for passing to external systems (e.g., workflow engines).
- * Dates are converted to ISO strings, and non-serializable fields are omitted.
- */
-interface SerializedMessage {
-    _type: "chat:Message";
-    attachments: Array<{
-        type: "image" | "file" | "video" | "audio";
-        url?: string;
-        name?: string;
-        mimeType?: string;
-        size?: number;
-        width?: number;
-        height?: number;
-        fetchMetadata?: Record<string, string>;
-    }>;
-    author: {
-        userId: string;
-        userName: string;
-        fullName: string;
-        isBot: boolean | "unknown";
-        isMe: boolean;
-    };
-    formatted: Root;
-    id: string;
-    isMention?: boolean;
-    links?: Array<{
-        url: string;
-        title?: string;
-        description?: string;
-        imageUrl?: string;
-        siteName?: string;
-    }>;
-    metadata: {
-        dateSent: string;
-        edited: boolean;
-        editedAt?: string;
-    };
-    raw: unknown;
-    text: string;
-    threadId: string;
-}
-/**
- * A chat message with serialization support for workflow engines.
- *
- * @example
- * ```typescript
- * // Create a message
- * const message = new Message({
- *   id: "msg-1",
- *   threadId: "slack:C123:1234.5678",
- *   text: "Hello world",
- *   formatted: parseMarkdown("Hello world"),
- *   raw: {},
- *   author: { userId: "U123", userName: "user", fullName: "User", isBot: false, isMe: false },
- *   metadata: { dateSent: new Date(), edited: false },
- *   attachments: [],
- * });
- *
- * // Serialize for workflow
- * const serialized = message.toJSON();
- * ```
- */
-declare class Message<TRawMessage = unknown> {
-    /** Unique message ID */
-    readonly id: string;
-    /** Thread this message belongs to */
-    readonly threadId: string;
-    /** Plain text content (all formatting stripped) */
-    text: string;
-    /**
-     * Structured formatting as an AST (mdast Root).
-     * This is the canonical representation - use this for processing.
-     * Use `stringifyMarkdown(message.formatted)` to get markdown string.
-     */
-    formatted: FormattedContent;
-    /** Platform-specific raw payload (escape hatch) */
-    raw: TRawMessage;
-    /** Message author */
-    author: Author;
-    /** Message metadata */
-    metadata: MessageMetadata;
-    /** Attachments */
-    attachments: Attachment[];
-    /**
-     * Whether the bot is @-mentioned in this message.
-     *
-     * This is set by the Chat SDK before passing the message to handlers.
-     * It checks for `@username` in the message text using the adapter's
-     * configured `userName` and optional `botUserId`.
-     *
-     * @example
-     * ```typescript
-     * chat.onSubscribedMessage(async (thread, message) => {
-     *   if (message.isMention) {
-     *     await thread.post("You mentioned me!");
-     *   }
-     * });
-     * ```
-     */
-    isMention?: boolean;
-    /**
-     * Cross-platform user key for this message's author.
-     *
-     * Set by the Chat SDK before passing the message to handlers, when
-     * `ChatConfig.identity` is configured. `undefined` if no resolver is
-     * configured; `undefined` (i.e. absent) when the resolver returned null.
-     *
-     * Used by the Transcripts API to look up / append per-user transcripts.
-     */
-    userKey?: string;
-    /** Links found in the message */
-    links: LinkPreview[];
-    private _subjectPromise?;
-    get subject(): Promise<MessageSubject | null>;
-    constructor(data: MessageData<TRawMessage>);
-    /**
-     * Serialize the message to a plain JSON object.
-     * Use this to pass message data to external systems like workflow engines.
-     *
-     * Note: Attachment `data` (Buffer) and `fetchData` (function) are omitted
-     * as they're not serializable.
-     */
-    toJSON(): SerializedMessage;
-    /**
-     * Reconstruct a Message from serialized JSON data.
-     * Converts ISO date strings back to Date objects.
-     */
-    static fromJSON<TRawMessage = unknown>(json: SerializedMessage): Message<TRawMessage>;
-    /**
-     * Serialize a Message instance for @workflow/serde.
-     * This static method is automatically called by workflow serialization.
-     */
-    static [WORKFLOW_SERIALIZE](instance: Message): SerializedMessage;
-    /**
-     * Deserialize a Message from @workflow/serde.
-     * This static method is automatically called by workflow deserialization.
-     */
-    static [WORKFLOW_DESERIALIZE](data: SerializedMessage): Message;
-}
-
-/**
- * Content part types structurally identical to AI SDK's TextPart, ImagePart,
- * FilePart so that AiMessage[] is directly assignable to ModelMessage[].
- * @see https://ai-sdk.dev/docs/reference/ai-sdk-core/model-message
- */
-/** Matches AI SDK's DataContent */
-type DataContent = string | Uint8Array | ArrayBuffer | Buffer;
-interface AiTextPart {
-    text: string;
-    type: "text";
-}
-interface AiImagePart {
-    image: DataContent | URL;
-    mediaType?: string;
-    type: "image";
-}
-interface AiFilePart {
-    data: DataContent | URL;
-    filename?: string;
-    mediaType: string;
-    type: "file";
-}
-type AiMessagePart = AiTextPart | AiImagePart | AiFilePart;
-/**
- * A message formatted for AI SDK consumption.
- *
- * This is a discriminated union matching AI SDK's ModelMessage type:
- * - User messages can have text, image, and file parts
- * - Assistant messages have string content only
- */
-type AiMessage = AiUserMessage | AiAssistantMessage;
-interface AiUserMessage {
-    content: string | AiMessagePart[];
-    role: "user";
-}
-interface AiAssistantMessage {
-    content: string;
-    role: "assistant";
-}
-/**
- * Options for converting messages to AI SDK format.
- */
-interface ToAiMessagesOptions {
-    /** When true, prefixes user messages with "[username]: " for multi-user context */
-    includeNames?: boolean;
-    /**
-     * Called when an attachment type is not supported (video, audio).
-     * Defaults to `console.warn`.
-     */
-    onUnsupportedAttachment?: (attachment: Attachment, message: Message) => void;
-    /**
-     * Called for each message after default processing (text, links, attachments).
-     * Return the message (modified or as-is) to include it, or `null` to skip it.
-     *
-     * @param aiMessage - The processed AI message
-     * @param source - The original chat Message
-     * @returns The message to include, or null to skip
-     */
-    transformMessage?: (aiMessage: AiMessage, source: Message) => AiMessage | null | Promise<AiMessage | null>;
-}
-/**
- * Convert chat SDK messages to AI SDK conversation format.
- *
- * - Filters out messages with empty/whitespace-only text
- * - Maps `author.isMe === true` to `"assistant"`, otherwise `"user"`
- * - Uses `message.text` for content
- * - Appends link metadata when available
- * - Includes image attachments and text files as `FilePart`
- * - Uses `fetchData()` when available to include attachment data inline (base64)
- * - Warns on unsupported attachment types (video, audio)
- *
- * Works with `FetchResult.messages`, `thread.recentMessages`, or collected iterables.
- *
- * @example
- * ```typescript
- * const result = await thread.adapter.fetchMessages(thread.id, { limit: 20 });
- * const history = await toAiMessages(result.messages);
- * const response = await agent.stream({ prompt: history });
- * ```
- */
-declare function toAiMessages(messages: Message[], options?: ToAiMessagesOptions): Promise<AiMessage[]>;
-
 /** Filter can be EmojiValue objects, emoji names, or raw emoji formats */
 type EmojiFilter = EmojiValue | string;
 /**
@@ -3156,4 +3074,86 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
     private runHandlers;
 }
 
-export { type LockScope as $, type ActionEvent as A, type ConcurrencyConfig as B, type Channel as C, type ConcurrencyStrategy as D, ConsoleLogger as E, type CountQuery as F, type CustomEmojiMap as G, type DeleteTarget as H, type DirectMessageHandler as I, type DurationString as J, type Emoji as K, type EmojiFormats as L, type EmojiMapConfig as M, type EmojiValue as N, type EphemeralMessage as O, type FetchDirection as P, type FetchOptions as Q, type FetchResult as R, type FileUpload as S, type FormattedContent as T, type IdentityContext as U, type IdentityResolver as V, type LinkPreview as W, type ListQuery as X, type ListThreadsOptions as Y, type ListThreadsResult as Z, type Lock as _, type ActionHandler as a, type TranscriptRole as a$, type LockScopeContext as a0, type LogLevel as a1, type Logger as a2, type MarkdownTextChunk as a3, type MemberJoinedChannelEvent as a4, type MemberJoinedChannelHandler as a5, type MentionHandler as a6, Message as a7, type MessageContext as a8, type MessageData as a9, type PostableRaw as aA, type QueueEntry as aB, type RawMessage as aC, type ReactionEvent as aD, type ReactionHandler as aE, type ScheduledMessage as aF, type SentMessage as aG, type SerializedChannel as aH, type SerializedMessage as aI, type SerializedThread as aJ, type SlashCommandEvent as aK, type SlashCommandHandler as aL, type StateAdapter as aM, type StreamChunk as aN, type StreamEvent as aO, type StreamOptions as aP, type SubscribedMessageHandler as aQ, THREAD_STATE_TTL_MS as aR, type TaskUpdateChunk as aS, type Thread as aT, ThreadHistoryCache as aU, type ThreadHistoryConfig as aV, ThreadImpl as aW, type ThreadInfo as aX, type ThreadSummary as aY, type ToAiMessagesOptions as aZ, type TranscriptEntry as a_, type MessageHandler as aa, type MessageMetadata as ab, type MessageSubject as ac, type ModalClearResponse as ad, type ModalCloseEvent as ae, type ModalCloseHandler as af, type ModalCloseResponse as ag, type ModalErrorsResponse as ah, type ModalPushResponse as ai, type ModalResponse as aj, type ModalSubmitEvent as ak, type ModalSubmitHandler as al, type ModalUpdateResponse as am, type OptionsLoadEvent as an, type OptionsLoadGroup as ao, type OptionsLoadHandler as ap, type OptionsLoadResult as aq, type PlanUpdateChunk as ar, type PostEphemeralOptions as as, type Postable as at, type PostableAst as au, type PostableCard as av, type PostableMarkdown as aw, type PostableMessage as ax, type PostableObject as ay, type PostableObjectContext as az, type Adapter as b, type TranscriptsApi as b0, type TranscriptsConfig as b1, type UserInfo as b2, type WebhookOptions as b3, type WellKnownEmoji as b4, deriveChannelId as b5, isPostableObject as b6, toAiMessages as b7, type AdapterPostableMessage as c, type AiAssistantMessage as d, type AiFilePart as e, type AiImagePart as f, type AiMessage as g, type AiMessagePart as h, type AiTextPart as i, type AiUserMessage as j, type AppHomeOpenedEvent as k, type AppHomeOpenedHandler as l, type AppendInput as m, type AppendOptions as n, type AssistantContextChangedEvent as o, type AssistantContextChangedHandler as p, type AssistantThreadStartedEvent as q, type AssistantThreadStartedHandler as r, type Attachment as s, type Author as t, ChannelImpl as u, type ChannelInfo as v, type ChannelVisibility as w, Chat as x, type ChatConfig as y, type ChatInstance as z };
+/**
+ * Content part types structurally identical to AI SDK's TextPart, ImagePart,
+ * FilePart so that AiMessage[] is directly assignable to ModelMessage[].
+ * @see https://ai-sdk.dev/docs/reference/ai-sdk-core/model-message
+ */
+/** Matches AI SDK's DataContent */
+type DataContent = string | Uint8Array | ArrayBuffer | Buffer;
+interface AiTextPart {
+    text: string;
+    type: "text";
+}
+interface AiImagePart {
+    image: DataContent | URL;
+    mediaType?: string;
+    type: "image";
+}
+interface AiFilePart {
+    data: DataContent | URL;
+    filename?: string;
+    mediaType: string;
+    type: "file";
+}
+type AiMessagePart = AiTextPart | AiImagePart | AiFilePart;
+/**
+ * A message formatted for AI SDK consumption.
+ *
+ * This is a discriminated union matching AI SDK's ModelMessage type:
+ * - User messages can have text, image, and file parts
+ * - Assistant messages have string content only
+ */
+type AiMessage = AiUserMessage | AiAssistantMessage;
+interface AiUserMessage {
+    content: string | AiMessagePart[];
+    role: "user";
+}
+interface AiAssistantMessage {
+    content: string;
+    role: "assistant";
+}
+/**
+ * Options for converting messages to AI SDK format.
+ */
+interface ToAiMessagesOptions {
+    /** When true, prefixes user messages with "[username]: " for multi-user context */
+    includeNames?: boolean;
+    /**
+     * Called when an attachment type is not supported (video, audio).
+     * Defaults to `console.warn`.
+     */
+    onUnsupportedAttachment?: (attachment: Attachment, message: Message) => void;
+    /**
+     * Called for each message after default processing (text, links, attachments).
+     * Return the message (modified or as-is) to include it, or `null` to skip it.
+     *
+     * @param aiMessage - The processed AI message
+     * @param source - The original chat Message
+     * @returns The message to include, or null to skip
+     */
+    transformMessage?: (aiMessage: AiMessage, source: Message) => AiMessage | null | Promise<AiMessage | null>;
+}
+/**
+ * Convert chat SDK messages to AI SDK conversation format.
+ *
+ * - Filters out messages with empty/whitespace-only text
+ * - Maps `author.isMe === true` to `"assistant"`, otherwise `"user"`
+ * - Uses `message.text` for content
+ * - Appends link metadata when available
+ * - Includes image attachments and text files as `FilePart`
+ * - Uses `fetchData()` when available to include attachment data inline (base64)
+ * - Warns on unsupported attachment types (video, audio)
+ *
+ * Works with `FetchResult.messages`, `thread.recentMessages`, or collected iterables.
+ *
+ * @example
+ * ```typescript
+ * const result = await thread.adapter.fetchMessages(thread.id, { limit: 20 });
+ * const history = await toAiMessages(result.messages);
+ * const response = await agent.stream({ prompt: history });
+ * ```
+ */
+declare function toAiMessages(messages: Message[], options?: ToAiMessagesOptions): Promise<AiMessage[]>;
+
+export { type FileUpload as $, type AiAssistantMessage as A, type AssistantThreadStartedHandler as B, Chat as C, type Attachment as D, type EmojiFormats as E, type Author as F, type Channel as G, ChannelImpl as H, type ChannelInfo as I, type ChatConfig as J, type ChatInstance as K, type ConcurrencyConfig as L, type ConcurrencyStrategy as M, ConsoleLogger as N, type CountQuery as O, type PostableObject as P, type DeleteTarget as Q, type DirectMessageHandler as R, type StreamChunk as S, type ToAiMessagesOptions as T, type DurationString as U, type Emoji as V, type WellKnownEmoji as W, type EphemeralMessage as X, type FetchDirection as Y, type FetchOptions as Z, type FetchResult as _, type ChannelVisibility as a, type ThreadSummary as a$, type FormattedContent as a0, type IdentityContext as a1, type IdentityResolver as a2, type LinkPreview as a3, type ListQuery as a4, type ListThreadsOptions as a5, type ListThreadsResult as a6, type Lock as a7, type LockScope as a8, type LockScopeContext as a9, type PlanUpdateChunk as aA, type PostEphemeralOptions as aB, type Postable as aC, type PostableAst as aD, type PostableCard as aE, type PostableMarkdown as aF, type PostableMessage as aG, type PostableRaw as aH, type QueueEntry as aI, type RawMessage as aJ, type ReactionEvent as aK, type ReactionHandler as aL, type ScheduledMessage as aM, type SentMessage as aN, type SerializedChannel as aO, type SerializedMessage as aP, type SerializedThread as aQ, type SlashCommandEvent as aR, type SlashCommandHandler as aS, type StateAdapter as aT, type StreamOptions as aU, type SubscribedMessageHandler as aV, THREAD_STATE_TTL_MS as aW, type TaskUpdateChunk as aX, type Thread as aY, ThreadImpl as aZ, type ThreadInfo as a_, type LogLevel as aa, type Logger as ab, type MarkdownTextChunk as ac, type MemberJoinedChannelEvent as ad, type MemberJoinedChannelHandler as ae, type MentionHandler as af, Message as ag, type MessageContext as ah, type MessageData as ai, type MessageHandler as aj, type MessageMetadata as ak, type MessageSubject as al, type ModalClearResponse as am, type ModalCloseEvent as an, type ModalCloseHandler as ao, type ModalCloseResponse as ap, type ModalErrorsResponse as aq, type ModalPushResponse as ar, type ModalResponse as as, type ModalSubmitEvent as at, type ModalSubmitHandler as au, type ModalUpdateResponse as av, type OptionsLoadEvent as aw, type OptionsLoadGroup as ax, type OptionsLoadHandler as ay, type OptionsLoadResult as az, type AiFilePart as b, type TranscriptEntry as b0, type TranscriptRole as b1, type TranscriptsApi as b2, type TranscriptsConfig as b3, type UserInfo as b4, type WebhookOptions as b5, deriveChannelId as b6, isPostableObject as b7, type AiImagePart as c, type AiMessage as d, type AiMessagePart as e, type AiTextPart as f, type AiUserMessage as g, type Adapter as h, type PostableObjectContext as i, ThreadHistoryCache as j, type ThreadHistoryConfig as k, type StreamEvent as l, type EmojiMapConfig as m, type EmojiValue as n, type CustomEmojiMap as o, type AdapterPostableMessage as p, type ActionEvent as q, type ActionHandler as r, type AppHomeOpenedEvent as s, toAiMessages as t, type AppHomeOpenedHandler as u, type AppendInput as v, type AppendOptions as w, type AssistantContextChangedEvent as x, type AssistantContextChangedHandler as y, type AssistantThreadStartedEvent as z };

package/docs/api/chat.mdx

@@ -27,9 +27,9 @@ const bot = new Chat(config);
       type: 'Record<string, Adapter>',
     },
     dedupeTtlMs: {
-      description: 'TTL for message deduplication entries in milliseconds. Increase if webhook cold starts cause platform retries after the default window.',
+      description: 'TTL for message deduplication entries in milliseconds. The default outlives the last Slack event retry (~5 minutes after original delivery); increase it if your platform redelivers later than that.',
       type: 'number',
-      default: '300000',
+      default: '600000',
     },
     state: {
       description: 'State adapter for subscriptions, locking, and caching.',

package/docs/create-chat-sdk.mdx

@@ -98,6 +98,20 @@ When the [Web adapter](/adapters/official/web) is selected, the CLI also creates
 
 When the [Discord adapter](/adapters/official/discord) is selected, the CLI also creates a Gateway listener at `/api/discord/gateway` and a `vercel.json` cron that calls it. Discord delivers slash commands and button clicks to the webhook route, but regular messages and reactions only arrive over the Gateway WebSocket, so the cron keeps that connection alive and forwards events to `/api/webhooks/discord`. Set a `CRON_SECRET` environment variable to authenticate the cron requests. The generated serverless Gateway cron requires [Vercel Pro or Enterprise](https://vercel.com/docs/cron-jobs/usage-and-pricing) because it runs every nine minutes.
 
+## Vercel Connect
+
+[Vercel Connect](/docs/vercel-connect) lets the Slack, GitHub, and Linear adapters authenticate with a connector instead of stored provider secrets. Pass `--connect` — or choose **Vercel Connect** at the interactive auth-mode prompt — to scaffold Connect wiring for any selected Slack, GitHub, or Linear adapter:
+
+```bash
+npm create chat-sdk@latest -- my-bot --adapter slack --connect -y
+```
+
+The generated `src/lib/bot.ts` spreads the matching helper from `@vercel/connect/chat` into the adapter factory, `@vercel/connect` is added to dependencies, and `.env.example` lists each connector UID (for example `SLACK_CONNECTOR`) in place of native secrets.
+
+<Callout type="info">
+  Vercel Connect provides `VERCEL_OIDC_TOKEN` at runtime. For local development, run `vercel link` then `vercel env pull` to populate it. Connect forwards inbound webhooks only to deployed URLs, so test webhook delivery against a Vercel deployment (such as a preview) rather than localhost.
+</Callout>
+
 ## Reference
 
 | Option | Description |
@@ -106,6 +120,7 @@ When the [Discord adapter](/adapters/official/discord) is selected, the CLI also
 | `-d, --description <text>` | Project description. |
 | `--adapter <values...>` | Platform or state adapters to include. |
 | `--vendor` | List only vendor-official adapters in the interactive prompt. |
+| `--connect` | Authenticate Slack, GitHub, and Linear adapters with Vercel Connect. |
 | `--pm <manager>` | Package manager to use: `npm`, `yarn`, `pnpm`, or `bun`. |
 | `-y, --yes` | Skip prompts and accept defaults. |
 | `--interactive` | Always prompt, even when a coding agent environment is detected. |

package/docs/meta.json

@@ -9,6 +9,7 @@
     "threads-messages-channels",
     "handling-events",
     "posting-messages",
+    "vercel-connect",
     "error-handling",
     "testing",
     "---AI---",

package/docs/usage.mdx

@@ -71,7 +71,7 @@ Your event handlers work identically across all registered adapters — the SDK
 | `adapters` | `Record<string, Adapter>` | *required* | Map of adapter name to adapter instance |
 | `state` | `StateAdapter` | *required* | State adapter for subscriptions and locking |
 | `logger` | `Logger \| LogLevel` | `"info"` | Logger instance or log level (`"debug"`, `"info"`, `"warn"`, `"error"`, `"silent"`) |
-| `dedupeTtlMs` | `number` | `300000` | TTL in ms for message deduplication (5 minutes) |
+| `dedupeTtlMs` | `number` | `600000` | TTL in ms for message deduplication (10 minutes) |
 | `concurrency` | `"drop" \| "queue" \| "debounce" \| "burst" \| "concurrent" \| ConcurrencyConfig` | `"drop"` | Strategy for overlapping messages on the same thread |
 | `streamingUpdateIntervalMs` | `number` | `500` | Update interval in ms for post+edit streaming |
 | `fallbackStreamingPlaceholderText` | `string \| null` | `"..."` | Placeholder text while streaming starts. Set to `null` to skip |

package/docs/vercel-connect.mdx

@@ -0,0 +1,162 @@
+---
+title: Vercel Connect
+description: Authenticate Slack, GitHub, and Linear adapters with Vercel Connect — short-lived runtime tokens for outbound calls and OIDC-verified inbound webhooks, with no stored provider secrets.
+type: overview
+related:
+  - /docs/usage
+  - /adapters/official/slack
+  - /adapters/official/github
+  - /adapters/official/linear
+---
+
+[Vercel Connect](https://vercel.com/docs/connect) lets your bot use a registered connector for adapter authentication instead of storing long-lived provider secrets. You register a connector once, link it to your project and environments, and your code requests scoped, short-lived tokens at runtime.
+
+The `@vercel/connect/chat` subpath ships a helper per platform that you spread into the matching `create*Adapter` factory:
+
+- `connectSlackAdapter`
+- `connectGitHubAdapter`
+- `connectLinearAdapter`
+
+Each helper wires both directions of traffic:
+
+- **Outbound** (your bot calls the provider API) — a function-form token field that resolves a fresh, short-lived token per call via `getToken`.
+- **Inbound** (the provider calls your bot) — a `webhookVerifier` that validates the Vercel OIDC token Connect attaches to [trigger-forwarded](https://vercel.com/docs/connect/concepts/triggers) webhooks, replacing the provider's native signature check.
+
+<Callout type="info">
+  Vercel Connect is in beta. Features and behavior, including available connectors and trigger forwarding, may change before general availability.
+</Callout>
+
+## Install
+
+```bash
+pnpm add @vercel/connect
+```
+
+`@vercel/connect` reads the deployment's OIDC token automatically. For local development, run `vercel link` followed by `vercel env pull` to download a short-lived token into `.env.local`.
+
+## Adapter support
+
+| Adapter | Helper | Outbound field |
+|---------|--------|----------------|
+| [Slack](/adapters/official/slack) | `connectSlackAdapter` | `botToken` |
+| [GitHub](/adapters/official/github) | `connectGitHubAdapter` | `installationToken` |
+| [Linear](/adapters/official/linear) | `connectLinearAdapter` | `accessToken` |
+
+Each helper accepts `(connector, params?, options?)`, where `params` is the [`getToken`](https://vercel.com/docs/connect/ts-sdk-reference) parameters minus `subject` (pinned to `{ type: "app" }`), letting you pass through `installationId`, `scopes`, or `validityBufferMs`.
+
+## Set up a connector
+
+1. Create a connector for the provider in the [Vercel dashboard](https://vercel.com/d?to=%2F%5Bteam%5D%2F~%2Fconnect) or with the CLI, enabling trigger forwarding so inbound webhooks reach your project:
+
+```bash
+vercel connect create slack --name acme-slack --triggers
+```
+
+2. Attach your project and register your Chat SDK webhook route (`/api/webhooks/{platform}`) as the trigger destination:
+
+```bash
+vercel connect attach slack/acme-slack \
+  --project my-bot --environment production \
+  --triggers --trigger-path /api/webhooks/slack
+```
+
+3. Pull a development token locally (deployments get `VERCEL_OIDC_TOKEN` automatically):
+
+```bash
+vercel link
+vercel env pull
+```
+
+## Wire up the adapter
+
+Spread the helper into the adapter factory. The webhook route is unchanged — Connect forwards verified events to the same handler.
+
+```typescript title="lib/bot.ts" lineNumbers
+import { Chat } from "chat";
+import { createSlackAdapter } from "@chat-adapter/slack";
+import { createRedisState } from "@chat-adapter/state-redis";
+import { connectSlackAdapter } from "@vercel/connect/chat";
+
+export const bot = new Chat({
+  userName: "mybot",
+  adapters: {
+    slack: createSlackAdapter({
+      ...connectSlackAdapter("slack/acme-slack"),
+    }),
+  },
+  state: createRedisState(),
+});
+```
+
+Replace `slack/acme-slack` with your connector UID from the Connect dashboard or `vercel connect list`. Omit `signingSecret` / `SLACK_SIGNING_SECRET` when using the helper — the OIDC `webhookVerifier` is the freshness boundary.
+
+### GitHub
+
+```typescript title="lib/bot.ts" lineNumbers
+import { createGitHubAdapter } from "@chat-adapter/github";
+import { connectGitHubAdapter } from "@vercel/connect/chat";
+
+createGitHubAdapter({
+  ...connectGitHubAdapter("github/acme-github"),
+  userName: "my-bot[bot]",
+});
+```
+
+`installationToken` is the installation access token a GitHub App would normally mint via its private-key JWT exchange — the adapter uses it directly and skips that exchange.
+
+### Linear
+
+```typescript title="lib/bot.ts" lineNumbers
+import { createLinearAdapter } from "@chat-adapter/linear";
+import { connectLinearAdapter } from "@vercel/connect/chat";
+
+createLinearAdapter({
+  ...connectLinearAdapter("linear/acme-linear"),
+  mode: "agent-sessions",
+});
+```
+
+Use `mode: "agent-sessions"` for app-actor installs. For outbound calls outside webhook handling (cron jobs, workflows), wrap them in `withInstallation()` so a request-scoped client is bound:
+
+```typescript title="lib/jobs.ts" lineNumbers
+await linear.withInstallation("org-id", async () => {
+  await linear.postMessage("linear:issue-id", "Hello from a background job");
+});
+```
+
+## Custom webhook verification
+
+Each helper attaches a default verifier that matches the deployment's project and environment automatically (`projectId` defaults to `VERCEL_PROJECT_ID`, `environment` to `VERCEL_TARGET_ENV` then `VERCEL_ENV`), so production, preview, and development each accept only their own tokens. Verification fails closed — if those values are absent, every request is rejected, and the issuer is pinned to `https://oidc.vercel.com`.
+
+To add constraints (for example to accept multiple environments), build a verifier with `createConnectWebhookVerifier` and override the field:
+
+```typescript title="lib/bot.ts" lineNumbers
+import {
+  connectSlackAdapter,
+  createConnectWebhookVerifier,
+} from "@vercel/connect/chat";
+
+createSlackAdapter({
+  ...connectSlackAdapter("slack/acme-slack"),
+  webhookVerifier: createConnectWebhookVerifier({
+    environment: ["production", "preview"],
+  }),
+});
+```
+
+<Callout type="warn">
+  Avoid hardcoding `environment: "production"` unless you only forward to production — it would reject preview and development deployments.
+</Callout>
+
+## Notes and limitations
+
+- **App-scoped tokens.** The helpers act as the application itself (`subject: { type: "app" }`). End-user OAuth is a separate concern.
+- **Freshness and replay.** OIDC verification replaces each provider's native signature (and timestamp) check, so request freshness relies on the short-lived OIDC token's expiry rather than a signed timestamp, and there is no built-in delivery de-duplication. Keep your webhook handlers idempotent.
+- **Socket Mode is incompatible.** Connect trigger forwarding is HTTP-only; it doesn't apply to the Slack adapter's Socket Mode.
+- **Testing.** Connect forwards to deployed URLs, not `localhost` — test against a preview or development deployment.
+
+## Related resources
+
+- [Vercel Connect overview](https://vercel.com/docs/connect)
+- [Vercel Connect triggers](https://vercel.com/docs/connect/concepts/triggers)
+- [`@vercel/connect` SDK reference](https://vercel.com/docs/connect/ts-sdk-reference)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat",
-  "version": "4.32.0",
+  "version": "4.33.0",
   "description": "Chat SDK — universal TypeScript toolkit for building multi-platform chat bots and AI agents on Slack, Teams, Google Chat, Discord, WhatsApp, and more",
   "type": "module",
   "engines": {