chat 4.31.0 → 4.33.0

package/README.md

@@ -2,8 +2,8 @@
 
 > npm package: [`chat`](https://www.npmjs.com/package/chat)
 
-[![npm version](https://img.shields.io/npm/v/chat)](https://www.npmjs.com/package/chat)
-[![npm downloads](https://img.shields.io/npm/dm/chat)](https://www.npmjs.com/package/chat)
+[![Agent Stack](https://img.shields.io/badge/Agent%20Stack-000?style=flat-square&logo=vercel&logoColor=FFF&labelColor=000&color=000)](https://vercel.com/kb/agent-stack)
+[![MIT License](https://img.shields.io/badge/License-MIT-000?style=flat-square&logo=opensourceinitiative&logoColor=white&labelColor=000&color=000)](../../LICENSE)
 
 Universal TypeScript SDK for building multi-platform chat bots and AI agents on Slack, Teams, Google Chat, Discord, WhatsApp, and more. Provides the `Chat` class, event handlers, JSX cards, emoji helpers, and type-safe message formatting.
 

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";
@@ -273,6 +302,20 @@ declare const ADAPTERS: {
         readonly slug: "linear";
         readonly type: "platform";
     };
+    readonly linq: {
+        readonly description: "iMessage and SMS adapter for Chat SDK, built and maintained by Linq.";
+        readonly env: {
+            readonly config: readonly ["baseURL"];
+            readonly required: readonly [EnvVar, EnvVar];
+        };
+        readonly factoryExport: "createLinqAdapter";
+        readonly group: "vendor-official";
+        readonly name: "Linq";
+        readonly packageName: "@linqapp/chat-sdk-adapter";
+        readonly peerDeps: readonly [];
+        readonly slug: "linq";
+        readonly type: "platform";
+    };
     readonly liveblocks: {
         readonly description: "Liveblocks Comments adapter for building conversational bots on top of Liveblocks rooms, threads, and comments.";
         readonly env: {
@@ -335,6 +378,41 @@ declare const ADAPTERS: {
         readonly slug: "messenger";
         readonly type: "platform";
     };
+    readonly novu: {
+        readonly description: "Multi-channel agents with one-click channel setup, identity and multi-tenancy";
+        readonly env: {
+            readonly optional: readonly [EnvVar];
+            readonly required: readonly [EnvVar, EnvVar];
+        };
+        readonly factoryExport: "createNovuAdapter";
+        readonly group: "vendor-official";
+        readonly name: "Novu";
+        readonly packageName: "@novu/chat-sdk-adapter";
+        readonly peerDeps: readonly [];
+        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: {
@@ -474,7 +552,7 @@ declare const ADAPTERS: {
         readonly type: "platform";
     };
     readonly velt: {
-        readonly description: "Velt Comments adapter for building bots that read and respond in Velt comment threads on documents, text editors, and canvases.";
+        readonly description: "Velt Comments adapter for bots that read, reply, mention, and start threads in anchored comments across documents, rich-text editors, canvases, PDFs, and video. Includes per-comment document context and an AI streaming-reply sample app.";
         readonly env: {
             readonly config: readonly ["botUserId", "botUserName", "webhookVersion", "resolveUsers", "selfHostingConfig"];
             readonly optional: readonly [EnvVar, EnvVar];
@@ -516,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.")]
@@ -281,6 +333,26 @@ var ADAPTERS = {
     slug: "linear",
     type: "platform"
   },
+  linq: {
+    description: "iMessage and SMS adapter for Chat SDK, built and maintained by Linq.",
+    env: {
+      config: ["baseURL"],
+      required: [
+        secretEnv("LINQ_API_KEY", "Linq API key for outbound API calls."),
+        secretEnv(
+          "LINQ_WEBHOOK_SECRET",
+          "Webhook signing secret used to verify inbound HMAC-SHA256 signatures."
+        )
+      ]
+    },
+    factoryExport: "createLinqAdapter",
+    group: "vendor-official",
+    name: "Linq",
+    packageName: "@linqapp/chat-sdk-adapter",
+    peerDeps: [],
+    slug: "linq",
+    type: "platform"
+  },
   liveblocks: {
     description: "Liveblocks Comments adapter for building conversational bots on top of Liveblocks rooms, threads, and comments.",
     env: {
@@ -391,6 +463,86 @@ var ADAPTERS = {
     slug: "messenger",
     type: "platform"
   },
+  novu: {
+    description: "Multi-channel agents with one-click channel setup, identity and multi-tenancy",
+    env: {
+      optional: [
+        urlEnv(
+          "NOVU_API_BASE_URL",
+          "API base URL. Defaults to https://api.novu.co."
+        )
+      ],
+      required: [
+        secretEnv(
+          "NOVU_SECRET_KEY",
+          "Novu API key that authorizes replies and verifies the inbound HMAC. Set automatically by npx novu connect."
+        ),
+        env(
+          "NOVU_AGENT_IDENTIFIER",
+          "Bridge agent ID set automatically by npx novu connect."
+        )
+      ]
+    },
+    factoryExport: "createNovuAdapter",
+    group: "vendor-official",
+    name: "Novu",
+    packageName: "@novu/chat-sdk-adapter",
+    peerDeps: [],
+    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: {
@@ -616,7 +768,7 @@ var ADAPTERS = {
     type: "platform"
   },
   velt: {
-    description: "Velt Comments adapter for building bots that read and respond in Velt comment threads on documents, text editors, and canvases.",
+    description: "Velt Comments adapter for bots that read, reply, mention, and start threads in anchored comments across documents, rich-text editors, canvases, PDFs, and video. Includes per-comment document context and an AI streaming-reply sample app.",
     env: {
       config: [
         "botUserId",
@@ -687,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-BjhJs_sP.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-BjhJs_sP.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-BjhJs_sP.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-BjhJs_sP.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';
 
 /**
@@ -53,6 +53,8 @@ interface StartPlanOptions {
     initialMessage: PlanContent;
 }
 interface AddTaskOptions {
+    /** When true (default), mark existing in_progress tasks complete before adding. */
+    autoCompletePrevious?: boolean;
     /** Task details/substeps. */
     children?: PlanContent;
     title: PlanContent;
@@ -74,6 +76,7 @@ interface CompletePlanOptions {
  *
  * Create a plan with `new Plan({ initialMessage: "..." })` and post it with `thread.post(plan)`.
  * After posting, use methods like `addTask()`, `updateTask()`, and `complete()` to update it.
+ * For parallel steps, pass `autoCompletePrevious: false` to `addTask()` and use `updateTask({ id })` to update individual tasks.
  *
  * @example
  * ```typescript
@@ -351,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 {
   /**
@@ -3020,7 +3020,7 @@ var Chat = class {
       author: event.user,
       metadata: { dateSent: /* @__PURE__ */ new Date(), edited: false },
       attachments: []
-    }) : {};
+    }) : void 0;
     const thread = event.threadId ? await this.createThread(
       event.adapter,
       event.threadId,
@@ -3140,7 +3140,7 @@ var Chat = class {
     const thread = await this.createThread(
       event.adapter,
       event.threadId,
-      event.message ?? {},
+      event.message,
       isSubscribed
     );
     const fullEvent = {
@@ -3228,7 +3228,7 @@ var Chat = class {
       );
     }
     const threadId = await adapter.openDM(userId);
-    return this.createThread(adapter, threadId, {}, false);
+    return this.createThread(adapter, threadId, void 0, false);
   }
   /**
    * Look up user information by user ID.
@@ -3333,7 +3333,7 @@ var Chat = class {
         "ADAPTER_NOT_FOUND"
       );
     }
-    return this.createThread(adapter, threadId, {}, false);
+    return this.createThread(adapter, threadId, void 0, false);
   }
   /**
    * Infer which adapter to use based on the userId format.
@@ -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;
     }
   }
@@ -3754,7 +3771,7 @@ var Chat = class {
    * subscription status, mention detection, and pattern matching.
    */
   async dispatchToHandlers(adapter, threadId, message, context) {
-    message.isMention = message.isMention || this.detectMention(adapter, message);
+    const hasMention = this.setMentionFlags(adapter, message, context);
     const isSubscribed = await this._stateAdapter.isSubscribed(threadId);
     this.logger.debug("Subscription check", {
       threadId,
@@ -3814,7 +3831,7 @@ var Chat = class {
       );
       return;
     }
-    if (message.isMention) {
+    if (message.isMention || hasMention && this.mentionHandlers.length > 0) {
       this.logger.debug("Bot mentioned", {
         threadId,
         text: message.text.slice(0, 100)
@@ -3850,6 +3867,15 @@ var Chat = class {
       });
     }
   }
+  setMentionFlags(adapter, message, context) {
+    message.isMention = message.isMention || this.detectMention(adapter, message);
+    let hasMention = message.isMention === true;
+    for (const skipped of context?.skipped ?? []) {
+      skipped.isMention = skipped.isMention || this.detectMention(adapter, skipped);
+      hasMention = hasMention || skipped.isMention === true;
+    }
+    return hasMention;
+  }
   createThread(adapter, threadId, initialMessage, isSubscribedContext = false) {
     const channelId = adapter.channelIdFromThreadId(threadId);
     const isDM = adapter.isDM?.(threadId) ?? false;
@@ -4064,9 +4090,12 @@ var Plan = class {
       return null;
     }
     const title = contentToPlainText(options.title) || "Task";
-    for (const task of this._model.tasks) {
-      if (task.status === "in_progress") {
-        task.status = "complete";
+    const autoCompletePrevious = options.autoCompletePrevious ?? true;
+    if (autoCompletePrevious) {
+      for (const task of this._model.tasks) {
+        if (task.status === "in_progress") {
+          task.status = "complete";
+        }
       }
     }
     const nextTask = {
@@ -4474,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);
     }