chat 4.27.0 → 4.28.1

package/dist/{chunk-AN7MRAVW.js → chunk-V25FKIIL.js}

@@ -354,7 +354,8 @@ function Button(options) {
     style: options.style,
     value: options.value,
     disabled: options.disabled,
-    actionType: options.actionType
+    actionType: options.actionType,
+    callbackUrl: options.callbackUrl
   };
 }
 function LinkButton(options) {
@@ -607,6 +608,7 @@ function Modal(options) {
   return {
     type: "modal",
     callbackId: options.callbackId,
+    callbackUrl: options.callbackUrl,
     title: options.title,
     submitLabel: options.submitLabel,
     closeLabel: options.closeLabel,
@@ -881,6 +883,7 @@ function resolveJSXElement(element) {
       style: props.style,
       value: props.value,
       actionType: props.actionType,
+      callbackUrl: props.callbackUrl,
       disabled: props.disabled
     });
   }
@@ -929,6 +932,7 @@ function resolveJSXElement(element) {
     }
     return Modal({
       callbackId: props.callbackId,
+      callbackUrl: props.callbackUrl,
       title: props.title,
       submitLabel: props.submitLabel,
       closeLabel: props.closeLabel,

package/dist/index.d.ts

@@ -1,27 +1,30 @@
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 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 { C as ChatElement, a as CardElement, M as ModalElement, S as SelectOptionElement, b as CardChild, A as ActionsComponent, B as ButtonComponent, c as CardComponent, d as cardChildToFallbackText$1, e as CardLinkComponent, T as TextComponent, D as DividerComponent, F as FieldComponent, f as FieldsComponent, g as fromReactElement$1, I as ImageComponent, i as isCardElement$1, h as isJSX$1, L as LinkButtonComponent, j as SectionComponent, k as Table$2, t as toCardElement$1, l as toModalElement$1, m as fromReactModalElement$1, n as isModalElement$1, E as ExternalSelectComponent, o as ModalComponent, R as RadioSelectComponent, p as SelectComponent, q as SelectOptionComponent, r as TextInputComponent } from './jsx-runtime-Co9uV6l7.js';
-export { s as ActionsElement, u as ButtonElement, v as ButtonOptions, X as ButtonProps, w as ButtonStyle, Y as CardJSXElement, Z as CardJSXProps, _ as CardLinkProps, x as CardOptions, $ as CardProps, a0 as ContainerProps, y as DividerElement, a1 as DividerProps, ab as ExternalSelectElement, ac as ExternalSelectOptions, a2 as ExternalSelectProps, z as FieldElement, a3 as FieldProps, G as FieldsElement, H as ImageElement, a4 as ImageProps, J as LinkButtonElement, K as LinkButtonOptions, a5 as LinkButtonProps, N as LinkElement, ad as ModalChild, ae as ModalOptions, a6 as ModalProps, af as RadioSelectElement, ag as RadioSelectOptions, O as SectionElement, ah as SelectElement, a7 as SelectOptionProps, ai as SelectOptions, a8 as SelectProps, P as TableAlignment, Q as TableElement, U as TableOptions, V as TextElement, aj as TextInputElement, ak as TextInputOptions, a9 as TextInputProps, aa as TextProps, W as TextStyle } from './jsx-runtime-Co9uV6l7.js';
+import { C as ChatElement, a as CardElement, M as ModalElement, S as SelectOptionElement, b as CardChild, A as ActionsComponent, B as ButtonComponent, c as CardComponent, d as cardChildToFallbackText$1, e as CardLinkComponent, T as TextComponent, D as DividerComponent, F as FieldComponent, f as FieldsComponent, g as fromReactElement$1, I as ImageComponent, i as isCardElement$1, h as isJSX$1, L as LinkButtonComponent, j as SectionComponent, k as Table$2, t as toCardElement$1, l as toModalElement$1, m as fromReactModalElement$1, n as isModalElement$1, E as ExternalSelectComponent, o as ModalComponent, R as RadioSelectComponent, p as SelectComponent, q as SelectOptionComponent, r as TextInputComponent } from './jsx-runtime-DxGwoLu2.js';
+export { s as ActionsElement, u as ButtonElement, v as ButtonOptions, X as ButtonProps, w as ButtonStyle, Y as CardJSXElement, Z as CardJSXProps, _ as CardLinkProps, x as CardOptions, $ as CardProps, a0 as ContainerProps, y as DividerElement, a1 as DividerProps, ab as ExternalSelectElement, ac as ExternalSelectOptions, a2 as ExternalSelectProps, z as FieldElement, a3 as FieldProps, G as FieldsElement, H as ImageElement, a4 as ImageProps, J as LinkButtonElement, K as LinkButtonOptions, a5 as LinkButtonProps, N as LinkElement, ad as ModalChild, ae as ModalOptions, a6 as ModalProps, af as RadioSelectElement, ag as RadioSelectOptions, O as SectionElement, ah as SelectElement, a7 as SelectOptionProps, ai as SelectOptions, a8 as SelectProps, P as TableAlignment, Q as TableElement, U as TableOptions, V as TextElement, aj as TextInputElement, ak as TextInputOptions, a9 as TextInputProps, aa as TextProps, W as TextStyle } from './jsx-runtime-DxGwoLu2.js';
 
-interface MessageHistoryConfig {
+interface ThreadHistoryConfig {
     /** Maximum messages to keep per thread (default: 100) */
     maxMessages?: number;
     /** TTL for cached history in milliseconds (default: 7 days) */
     ttlMs?: number;
 }
 /**
- * Persistent message history cache backed by the StateAdapter.
+ * Persistent per-thread history cache backed by the StateAdapter.
  *
- * Used by adapters that lack server-side message history APIs (e.g., WhatsApp, Telegram).
- * Messages are atomically appended via `state.appendToList()`, which is safe
- * without holding a thread lock.
+ * Used by adapters that lack server-side message history APIs (e.g. WhatsApp,
+ * Telegram). Messages are atomically appended via `state.appendToList()`,
+ * which is safe without holding a thread lock.
+ *
+ * Distinct from the cross-platform per-user {@link TranscriptsApi} (see
+ * `transcripts.ts`) — this cache is keyed by thread, not user.
  */
-declare class MessageHistoryCache {
+declare class ThreadHistoryCache {
     private readonly state;
     private readonly maxMessages;
     private readonly ttlMs;
-    constructor(state: StateAdapter, config?: MessageHistoryConfig);
+    constructor(state: StateAdapter, config?: ThreadHistoryConfig);
     /**
      * Atomically append a message to the history for a thread.
      * Trims to maxMessages (keeps newest) and refreshes TTL.
@@ -54,8 +57,8 @@ interface ChannelImplConfigWithAdapter {
     channelVisibility?: ChannelVisibility;
     id: string;
     isDM?: boolean;
-    messageHistory?: MessageHistoryCache;
     stateAdapter: StateAdapter;
+    threadHistory?: ThreadHistoryCache;
 }
 /**
  * Config for creating a ChannelImpl with lazy adapter resolution.
@@ -75,7 +78,7 @@ declare class ChannelImpl<TState = Record<string, unknown>> implements Channel<T
     private readonly _adapterName?;
     private _stateAdapterInstance?;
     private _name;
-    private readonly _messageHistory?;
+    private readonly _threadHistory?;
     constructor(config: ChannelImplConfig);
     get adapter(): Adapter;
     private get _stateAdapter();
@@ -103,6 +106,7 @@ declare class ChannelImpl<TState = Record<string, unknown>> implements Channel<T
     schedule(message: AdapterPostableMessage | ChatElement, options: {
         postAt: Date;
     }): Promise<ScheduledMessage>;
+    private processCallbackUrls;
     startTyping(status?: string): Promise<void>;
     mentionUser(userId: string): string;
     toJSON(): SerializedChannel;
@@ -206,9 +210,9 @@ interface ThreadImplConfigWithAdapter {
     isDM?: boolean;
     isSubscribedContext?: boolean;
     logger?: Logger;
-    messageHistory?: MessageHistoryCache;
     stateAdapter: StateAdapter;
     streamingUpdateIntervalMs?: number;
+    threadHistory?: ThreadHistoryCache;
 }
 /**
  * Config for creating a ThreadImpl with lazy adapter resolution.
@@ -249,8 +253,8 @@ declare class ThreadImpl<TState = Record<string, unknown>> implements Thread<TSt
     private readonly _fallbackStreamingPlaceholderText;
     /** Cached channel instance */
     private _channel?;
-    /** Message history cache (set only for adapters with persistMessageHistory) */
-    private readonly _messageHistory?;
+    /** Thread history cache (set only for adapters with persistThreadHistory) */
+    private readonly _threadHistory?;
     private readonly _logger?;
     constructor(config: ThreadImplConfig);
     /**
@@ -296,13 +300,14 @@ declare class ThreadImpl<TState = Record<string, unknown>> implements Thread<TSt
     post(message: string | AdapterPostableMessage | AsyncIterable<string> | ChatElement): Promise<SentMessage>;
     private handlePostableObject;
     postEphemeral(user: string | Author, message: AdapterPostableMessage | ChatElement, options: PostEphemeralOptions): Promise<EphemeralMessage | null>;
+    private processCallbackUrls;
     schedule(message: AdapterPostableMessage | ChatElement, options: {
         postAt: Date;
     }): Promise<ScheduledMessage>;
     /**
      * Handle streaming from an AsyncIterable.
      * Normalizes the stream (supports both textStream and fullStream from AI SDK),
-     * then uses adapter's native streaming if available, otherwise falls back to post+edit.
+     * then uses the adapter's stream implementation if available, otherwise falls back to post+edit.
      */
     private handleStream;
     /**
@@ -512,6 +517,14 @@ interface ChatConfig<TAdapters extends Record<string, Adapter> = Record<string,
      * wait until some real text has been streamed before creating the message.
      */
     fallbackStreamingPlaceholderText?: string | null;
+    /**
+     * Resolves a stable cross-platform user key from inbound messages.
+     *
+     * Required when `transcripts` is configured. Called once per inbound
+     * message during dispatch; the result is attached to the Message
+     * instance as `message.userKey` for handlers to use.
+     */
+    identity?: IdentityResolver;
     /**
      * Lock scope determines which messages contend for the same lock.
      *
@@ -529,13 +542,12 @@ interface ChatConfig<TAdapters extends Record<string, Adapter> = Record<string,
      */
     logger?: Logger | LogLevel;
     /**
-     * Configuration for persistent message history.
-     * Only used by adapters that set `persistMessageHistory: true`.
+     * @deprecated Renamed to {@link ChatConfig.threadHistory}. Both fields are
+     * read for backwards compatibility; `threadHistory` takes precedence when
+     * both are set.
      */
     messageHistory?: {
-        /** Maximum messages to store per thread (default: 100) */
         maxMessages?: number;
-        /** TTL for cached history in milliseconds (default: 7 days) */
         ttlMs?: number;
     };
     /**
@@ -559,6 +571,28 @@ interface ChatConfig<TAdapters extends Record<string, Adapter> = Record<string,
      * Defaults to 500ms. Lower values provide smoother updates but may hit rate limits.
      */
     streamingUpdateIntervalMs?: number;
+    /**
+     * Configuration for persistent per-thread message history backfill.
+     *
+     * Only used by adapters that set `persistThreadHistory: true` (e.g.
+     * Telegram, WhatsApp). Distinct from `transcripts` (the cross-platform
+     * per-user Transcripts API).
+     */
+    threadHistory?: {
+        /** Maximum messages to store per thread (default: 100) */
+        maxMessages?: number;
+        /** TTL for cached history in milliseconds (default: 7 days) */
+        ttlMs?: number;
+    };
+    /**
+     * Cross-platform per-user message persistence.
+     *
+     * When set, `chat.transcripts` is available for append/list/count/delete
+     * keyed by a resolved cross-platform user key.
+     *
+     * Requires `identity` to also be set; the constructor throws otherwise.
+     */
+    transcripts?: TranscriptsConfig;
     /** Default bot username across all adapters */
     userName: string;
 }
@@ -681,6 +715,7 @@ interface Adapter<TThreadId = unknown, TRawMessage = unknown> {
      * ```
      */
     fetchMessages(threadId: string, options?: FetchOptions): Promise<FetchResult<TRawMessage>>;
+    fetchSubject?(raw: TRawMessage): Promise<MessageSubject | null>;
     /** Fetch thread metadata */
     fetchThread(threadId: string): Promise<ThreadInfo>;
     /**
@@ -759,10 +794,17 @@ interface Adapter<TThreadId = unknown, TRawMessage = unknown> {
     /** Parse platform message format to normalized format */
     parseMessage(raw: TRawMessage): Message<TRawMessage>;
     /**
-     * When true, the SDK persists message history in the state adapter for this platform.
-     * Use this for platforms that lack server-side message history APIs (e.g., WhatsApp, Telegram).
+     * @deprecated Renamed to {@link Adapter.persistThreadHistory}. Both flags
+     * are read for backwards compatibility; either being `true` enables
+     * persistence.
      */
     readonly persistMessageHistory?: boolean;
+    /**
+     * When true, the SDK persists per-thread message history in the state
+     * adapter for this platform. Use for platforms that lack server-side
+     * message history APIs (e.g. WhatsApp, Telegram).
+     */
+    readonly persistThreadHistory?: boolean;
     /**
      * Post a message to channel top-level (not in a thread).
      */
@@ -916,7 +958,7 @@ interface ChatInstance {
      * @param message - Either a parsed message, or a factory function for lazy async parsing
      * @param options - Webhook options including waitUntil
      */
-    processMessage(adapter: Adapter, threadId: string, message: Message | (() => Promise<Message>), options?: WebhookOptions): void;
+    processMessage(adapter: Adapter, threadId: string, message: Message | (() => Promise<Message>), options?: WebhookOptions): Promise<void>;
     /**
      * Process a modal close event from an adapter.
      *
@@ -959,6 +1001,12 @@ interface ChatInstance {
         adapter: Adapter;
         channelId: string;
     }, options: WebhookOptions | undefined): void;
+    /**
+     * Cross-platform per-user transcript store. Throws on access when
+     * `transcripts` is not configured on the Chat instance — callers should
+     * check `ChatConfig.transcripts` if they need a no-throw guard.
+     */
+    readonly transcripts: TranscriptsApi;
 }
 /** Lock scope determines which messages contend for the same lock. */
 type LockScope = "thread" | "channel";
@@ -1390,6 +1438,24 @@ interface Thread<TState = Record<string, unknown>, TRawMessage = unknown> extend
     unsubscribe(): Promise<void>;
 }
 
+interface MessageSubject {
+    assignee?: {
+        id: string;
+        name: string;
+    };
+    author?: {
+        id: string;
+        name: string;
+    };
+    description?: string;
+    id: string;
+    labels?: string[];
+    raw: unknown;
+    status?: string;
+    title?: string;
+    type: string;
+    url?: string;
+}
 interface ThreadInfo {
     channelId: string;
     channelName?: string;
@@ -1519,7 +1585,7 @@ interface MessageMetadata {
     /** When the message was last edited */
     editedAt?: Date;
 }
-interface SentMessage<TRawMessage = unknown> extends Message<TRawMessage> {
+interface SentMessage<TRawMessage = unknown> extends Omit<Message<TRawMessage>, "subject"> {
     /** Add a reaction to this message */
     addReaction(emoji: EmojiValue | string): Promise<void>;
     /** Delete this message */
@@ -1596,14 +1662,14 @@ type PostableMessage = AdapterPostableMessage | AsyncIterable<string | StreamChu
 /**
  * Duck-typed stream event compatible with AI SDK's `fullStream`.
  * - `text-delta` events are extracted as text output.
- * - `step-finish` events trigger paragraph separators between steps.
+ * - `finish-step` events trigger paragraph separators between steps.
  * - All other event types (tool-call, tool-result, etc.) are silently skipped.
  */
 type StreamEvent = {
     textDelta: string;
     type: "text-delta";
 } | {
-    type: "step-finish";
+    type: "finish-step";
 } | {
     type: string;
 };
@@ -2189,6 +2255,141 @@ interface MemberJoinedChannelEvent {
     userId: string;
 }
 type MemberJoinedChannelHandler = (event: MemberJoinedChannelEvent) => void | Promise<void>;
+/**
+ * Resolves a stable, cross-platform user key from an inbound message context.
+ *
+ * Return `null` to skip persistence for this event (unknown user, system
+ * message, or the bot itself). The SDK fails loudly rather than silently
+ * falling back to a platform-specific ID.
+ */
+type IdentityResolver = (context: IdentityContext) => string | null | Promise<string | null>;
+interface IdentityContext {
+    /** Adapter name (e.g. "slack", "discord"). */
+    adapter: string;
+    author: Author;
+    message: Message;
+}
+/**
+ * Role tag on a stored message.
+ *
+ * - `user`: produced by the resolved end-user
+ * - `assistant`: produced by this bot
+ * - `system`: SDK-injected marker (handoff, summary). Adapters never produce it.
+ */
+type TranscriptRole = "user" | "assistant" | "system";
+interface TranscriptEntry {
+    /** mdast AST. Only present when `transcripts.storeFormatted` is true. */
+    formatted?: FormattedContent;
+    /**
+     * UUID assigned by the SDK at append time. Opaque — not lexicographically
+     * sortable. Entries are returned by `list()` in append order (the underlying
+     * list semantics of `state.appendToList`); use `timestamp` to reason about
+     * ordering across stores.
+     */
+    id: string;
+    /** Originating adapter name. */
+    platform: string;
+    /** Platform-native message ID, when known. */
+    platformMessageId?: string;
+    role: TranscriptRole;
+    /** Plain-text body — canonical field for prompt building. */
+    text: string;
+    /** Originating thread ID. */
+    threadId: string;
+    /** ms-since-epoch, set at append time on the SDK side. */
+    timestamp: number;
+    /** Cross-platform user key from the IdentityResolver. */
+    userKey: string;
+}
+/** Duration shorthand: e.g. `"7d"`, `"30m"`, `"2h"`, `"45s"`. */
+type DurationString = `${number}${"s" | "m" | "h" | "d"}`;
+interface TranscriptsConfig {
+    /** Hard cap; older messages evicted on append. Default 200. */
+    maxPerUser?: number;
+    /**
+     * Default retention applied as the list TTL. Refreshed on every append
+     * (matches `appendToList` semantics). Omit for no expiry.
+     */
+    retention?: number | DurationString;
+    /** Persist `formatted` (mdast). Default false to keep storage small. */
+    storeFormatted?: boolean;
+}
+/**
+ * Input shape for appending a non-Message (e.g. an assistant reply you
+ * just posted via `thread.post()`).
+ */
+interface AppendInput {
+    formatted?: FormattedContent;
+    platformMessageId?: string;
+    role: TranscriptRole;
+    text: string;
+}
+interface AppendOptions {
+    /**
+     * Required when appending an `AppendInput` (assistant/system role) — the
+     * SDK has no Message instance from which to read the resolved key.
+     *
+     * Ignored when appending a Message; the Message's own `userKey` is used.
+     */
+    userKey?: string;
+}
+interface ListQuery {
+    /** Newest N kept (still returned in chronological order). Default 50. */
+    limit?: number;
+    /** Filter to a subset of adapter names. */
+    platforms?: string[];
+    /** Filter to specific roles. Default: all. */
+    roles?: TranscriptRole[];
+    /** Filter to a single thread. */
+    threadId?: string;
+    userKey: string;
+}
+/**
+ * Target for {@link TranscriptsApi.delete}. Wipes every stored message under
+ * the given user key.
+ */
+interface DeleteTarget {
+    userKey: string;
+}
+/** Query shape for {@link TranscriptsApi.count}. */
+interface CountQuery {
+    userKey: string;
+}
+/**
+ * Cross-platform per-user message store.
+ *
+ * Distinct from the existing per-thread `threadHistory` config (which exists
+ * to backfill thread context for adapters that lack server-side history APIs).
+ * The Transcripts API is keyed by a resolved cross-platform user key and is
+ * intended for transcript-style use cases (LLM context building, audit).
+ */
+interface TranscriptsApi {
+    /**
+     * Persist a Message (or AppendInput) under the user key.
+     *
+     * - For Message: `userKey` is read from the Message instance (set by the
+     *   SDK during inbound dispatch via the configured IdentityResolver).
+     *   No-op if the Message has no `userKey` (resolver returned null).
+     * - For AppendInput: `options.userKey` is required.
+     */
+    append<TState = Record<string, unknown>, TRawMessage = unknown>(thread: Postable<TState, TRawMessage>, message: Message | AppendInput, options?: AppendOptions): Promise<TranscriptEntry | null>;
+    /** Total stored count for a user key. */
+    count(query: CountQuery): Promise<number>;
+    /** GDPR / DSR delete — wipes every stored message under the user key. */
+    delete(target: DeleteTarget): Promise<{
+        deleted: number;
+    }>;
+    /**
+     * Returns the most recent entries in chronological order (oldest first),
+     * capped at `query.limit` (default 50).
+     *
+     * Pagination is intentionally not supported — the store keeps at most
+     * `transcripts.maxPerUser` entries per user. To widen the window, raise
+     * `maxPerUser`; to fetch a different slice, narrow with `threadId` /
+     * `platforms` / `roles`.
+     */
+    list(query: ListQuery): Promise<TranscriptEntry[]>;
+}
 
 /**
  * Message class with serialization support for workflow engines.
@@ -2321,8 +2522,20 @@ declare class Message<TRawMessage = unknown> {
      * ```
      */
     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.
@@ -2486,6 +2699,14 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
      * ```
      */
     registerSingleton(): this;
+    /**
+     * Cross-platform per-user transcript store.
+     *
+     * Available only when `transcripts` is configured on the Chat instance
+     * (and an `identity` resolver is set). Throws on access otherwise so
+     * callers fail loudly rather than silently no-op'ing.
+     */
+    get transcripts(): TranscriptsApi;
     /**
      * Get the registered singleton Chat instance.
      * Throws if no singleton has been registered.
@@ -2503,7 +2724,9 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
     private readonly _fallbackStreamingPlaceholderText;
     private readonly _dedupeTtlMs;
     private readonly _onLockConflict;
-    private readonly _messageHistory;
+    private readonly _threadHistory;
+    private readonly _identity;
+    private readonly _transcripts;
     private readonly _concurrencyStrategy;
     private readonly _concurrencyConfig;
     private readonly _concurrentSlots;
@@ -2811,7 +3034,7 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
      * Handles waitUntil registration and error catching internally.
      * Adapters should call this instead of handleIncomingMessage directly.
      */
-    processMessage(adapter: Adapter, threadId: string, messageOrFactory: Message | (() => Promise<Message>), options?: WebhookOptions): void;
+    processMessage(adapter: Adapter, threadId: string, messageOrFactory: Message | (() => Promise<Message>), options?: WebhookOptions): Promise<void>;
     /**
      * Process an incoming reaction event from an adapter.
      * Handles waitUntil registration and error catching internally.
@@ -2827,7 +3050,7 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
         adapter: Adapter;
     }, options: WebhookOptions | undefined): Promise<void>;
     processOptionsLoad(event: OptionsLoadEvent, _options?: WebhookOptions): Promise<OptionsLoadResult | undefined>;
-    processModalSubmit(event: Omit<ModalSubmitEvent, "relatedThread" | "relatedMessage" | "relatedChannel">, contextId?: string, _options?: WebhookOptions): Promise<ModalResponse | undefined>;
+    processModalSubmit(event: Omit<ModalSubmitEvent, "relatedThread" | "relatedMessage" | "relatedChannel">, contextId?: string, options?: WebhookOptions): Promise<ModalResponse | undefined>;
     processModalClose(event: Omit<ModalCloseEvent, "relatedThread" | "relatedMessage" | "relatedChannel">, contextId?: string, options?: WebhookOptions): void;
     /**
      * Process an incoming slash command from an adapter.
@@ -3042,6 +3265,21 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
  */
 declare function fromFullStream(stream: AsyncIterable<unknown>): AsyncIterable<string | StreamChunk>;
 
+/**
+ * @deprecated Renamed — import from `./thread-history` instead.
+ *
+ * This module is preserved for backwards compatibility and re-exports the
+ * new names under the old identifiers. New code should use `ThreadHistoryCache`
+ * and `ThreadHistoryConfig` directly.
+ */
+
+/** @deprecated Use `ThreadHistoryConfig` from `./thread-history` instead. */
+type MessageHistoryConfig = ThreadHistoryConfig;
+/** @deprecated Use `ThreadHistoryCache` from `./thread-history` instead. */
+declare const MessageHistoryCache: typeof ThreadHistoryCache;
+/** @deprecated Use `ThreadHistoryCache` from `./thread-history` instead. */
+type MessageHistoryCache = ThreadHistoryCache;
+
 /**
  * Standalone JSON reviver for Chat SDK objects.
  *
@@ -3128,7 +3366,7 @@ interface StreamingPlanOptions {
     groupTasks?: "plan" | "timeline";
     /**
      * Minimum interval between updates in ms (default: 500).
-     * Used for fallback mode (post+edit on adapters without native streaming).
+     * Used by post+edit streaming paths.
      */
     updateIntervalMs?: number;
 }
@@ -3250,7 +3488,7 @@ declare const defaultEmojiResolver: EmojiResolver;
  * // Returns: "Thanks! 👍"
  * ```
  */
-declare function convertEmojiPlaceholders(text: string, platform: "slack" | "gchat" | "teams" | "discord" | "github" | "linear" | "whatsapp", resolver?: EmojiResolver): string;
+declare function convertEmojiPlaceholders(text: string, platform: "slack" | "gchat" | "teams" | "discord" | "messenger" | "github" | "linear" | "whatsapp", resolver?: EmojiResolver): string;
 /** Base emoji object with well-known emoji as EmojiValue singletons */
 type BaseEmojiHelper = {
     [K in WellKnownEmoji]: EmojiValue;
@@ -3610,4 +3848,4 @@ declare const Select: SelectComponent;
 declare const SelectOption: SelectOptionComponent;
 declare const TextInput: TextInputComponent;
 
-export { type ActionEvent, type ActionHandler, Actions, ActionsComponent, type Adapter, type AdapterPostableMessage, type AddTaskOptions, type AiAssistantMessage, type AiFilePart, type AiImagePart, type AiMessage, type AiMessagePart, type AiTextPart, type AiUserMessage, type AppHomeOpenedEvent, type AppHomeOpenedHandler, type AssistantContextChangedEvent, type AssistantContextChangedHandler, type AssistantThreadStartedEvent, type AssistantThreadStartedHandler, type Attachment, type Author, BaseFormatConverter, Button, ButtonComponent, Card, CardChild, CardComponent, CardElement, CardLink, CardLinkComponent, CardText, type Channel, ChannelImpl, type ChannelInfo, type ChannelVisibility, Chat, type ChatConfig, ChatElement, ChatError, type ChatInstance, type CompletePlanOptions, type ConcurrencyConfig, type ConcurrencyStrategy, ConsoleLogger, type CustomEmojiMap, DEFAULT_EMOJI_MAP, type DirectMessageHandler, Divider, DividerComponent, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type EphemeralMessage, ExternalSelect, ExternalSelectComponent, type FetchDirection, type FetchOptions, type FetchResult, Field, FieldComponent, Fields, FieldsComponent, type FileUpload, type FormatConverter, type FormattedContent, Image, ImageComponent, LinkButton, LinkButtonComponent, type LinkPreview, type ListThreadsOptions, type ListThreadsResult, type Lock, LockError, type LockScope, type LockScopeContext, type LogLevel, type Logger, type MarkdownConverter, type MarkdownTextChunk, type MemberJoinedChannelEvent, type MemberJoinedChannelHandler, type MentionHandler, Message, type MessageContext, type MessageData, type MessageHandler, MessageHistoryCache, type MessageHistoryConfig, type MessageMetadata, Modal, type ModalClearResponse, type ModalCloseEvent, type ModalCloseHandler, type ModalCloseResponse, ModalComponent, ModalElement, type ModalErrorsResponse, type ModalPushResponse, type ModalResponse, type ModalSubmitEvent, type ModalSubmitHandler, type ModalUpdateResponse, NotImplementedError, type OptionsLoadEvent, type OptionsLoadGroup, type OptionsLoadHandler, type OptionsLoadResult, Plan, type PlanContent, type PlanModel, type PlanModelTask, type PlanTask, type PlanTaskStatus, type PlanUpdateChunk, type PostEphemeralOptions, type Postable, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableObject, type PostableObjectContext, type PostableRaw, type QueueEntry, RadioSelect, RadioSelectComponent, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, type ScheduledMessage, Section, SectionComponent, Select, SelectComponent, SelectOption, SelectOptionComponent, SelectOptionElement, type SentMessage, type SerializedChannel, type SerializedMessage, type SerializedThread, type SlashCommandEvent, type SlashCommandHandler, type StartPlanOptions, type StateAdapter, type StreamChunk, type StreamEvent, type StreamOptions, StreamingMarkdownRenderer, StreamingPlan, type StreamingPlanData, type StreamingPlanOptions, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, Table, type TaskUpdateChunk, TextComponent, TextInput, TextInputComponent, type Thread, ThreadImpl, type ThreadInfo, type ThreadSummary, type UpdateTaskInput, type UserInfo, type WebhookOptions, type WellKnownEmoji, blockquote, cardChildToFallbackText, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, deriveChannelId, emoji, emphasis, fromFullStream, fromReactElement, fromReactModalElement, getEmoji, getNodeChildren, getNodeValue, inlineCode, isBlockquoteNode, isCardElement, isCodeNode, isDeleteNode, isEmphasisNode, isInlineCodeNode, isJSX, isLinkNode, isListItemNode, isListNode, isModalElement, isParagraphNode, isPostableObject, isStrongNode, isTableCellNode, isTableNode, isTableRowNode, isTextNode, link, markdownToPlainText, paragraph, parseMarkdown, reviver, root, strikethrough, stringifyMarkdown, strong, tableElementToAscii, tableToAscii, text, toAiMessages, toCardElement, toModalElement, toPlainText, walkAst };
+export { type ActionEvent, type ActionHandler, Actions, ActionsComponent, type Adapter, type AdapterPostableMessage, type AddTaskOptions, type AiAssistantMessage, type AiFilePart, type AiImagePart, type AiMessage, type AiMessagePart, type AiTextPart, type AiUserMessage, type AppHomeOpenedEvent, type AppHomeOpenedHandler, type AppendInput, type AppendOptions, type AssistantContextChangedEvent, type AssistantContextChangedHandler, type AssistantThreadStartedEvent, type AssistantThreadStartedHandler, type Attachment, type Author, BaseFormatConverter, Button, ButtonComponent, Card, CardChild, CardComponent, CardElement, CardLink, CardLinkComponent, CardText, type Channel, ChannelImpl, type ChannelInfo, type ChannelVisibility, Chat, type ChatConfig, ChatElement, ChatError, type ChatInstance, type CompletePlanOptions, type ConcurrencyConfig, type ConcurrencyStrategy, ConsoleLogger, type CountQuery, type CustomEmojiMap, DEFAULT_EMOJI_MAP, type DeleteTarget, type DirectMessageHandler, Divider, DividerComponent, type DurationString, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type EphemeralMessage, ExternalSelect, ExternalSelectComponent, type FetchDirection, type FetchOptions, type FetchResult, Field, FieldComponent, Fields, FieldsComponent, type FileUpload, type FormatConverter, type FormattedContent, type IdentityContext, type IdentityResolver, Image, ImageComponent, LinkButton, LinkButtonComponent, type LinkPreview, type ListQuery, type ListThreadsOptions, type ListThreadsResult, type Lock, LockError, type LockScope, type LockScopeContext, type LogLevel, type Logger, type MarkdownConverter, type MarkdownTextChunk, type MemberJoinedChannelEvent, type MemberJoinedChannelHandler, type MentionHandler, Message, type MessageContext, type MessageData, type MessageHandler, MessageHistoryCache, type MessageHistoryConfig, type MessageMetadata, type MessageSubject, Modal, type ModalClearResponse, type ModalCloseEvent, type ModalCloseHandler, type ModalCloseResponse, ModalComponent, ModalElement, type ModalErrorsResponse, type ModalPushResponse, type ModalResponse, type ModalSubmitEvent, type ModalSubmitHandler, type ModalUpdateResponse, NotImplementedError, type OptionsLoadEvent, type OptionsLoadGroup, type OptionsLoadHandler, type OptionsLoadResult, Plan, type PlanContent, type PlanModel, type PlanModelTask, type PlanTask, type PlanTaskStatus, type PlanUpdateChunk, type PostEphemeralOptions, type Postable, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableObject, type PostableObjectContext, type PostableRaw, type QueueEntry, RadioSelect, RadioSelectComponent, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, type ScheduledMessage, Section, SectionComponent, Select, SelectComponent, SelectOption, SelectOptionComponent, SelectOptionElement, type SentMessage, type SerializedChannel, type SerializedMessage, type SerializedThread, type SlashCommandEvent, type SlashCommandHandler, type StartPlanOptions, type StateAdapter, type StreamChunk, type StreamEvent, type StreamOptions, StreamingMarkdownRenderer, StreamingPlan, type StreamingPlanData, type StreamingPlanOptions, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, Table, type TaskUpdateChunk, TextComponent, TextInput, TextInputComponent, type Thread, ThreadHistoryCache, type ThreadHistoryConfig, ThreadImpl, type ThreadInfo, type ThreadSummary, type TranscriptEntry, type TranscriptRole, type TranscriptsApi, type TranscriptsConfig, type UpdateTaskInput, type UserInfo, type WebhookOptions, type WellKnownEmoji, blockquote, cardChildToFallbackText, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, deriveChannelId, emoji, emphasis, fromFullStream, fromReactElement, fromReactModalElement, getEmoji, getNodeChildren, getNodeValue, inlineCode, isBlockquoteNode, isCardElement, isCodeNode, isDeleteNode, isEmphasisNode, isInlineCodeNode, isJSX, isLinkNode, isListItemNode, isListNode, isModalElement, isParagraphNode, isPostableObject, isStrongNode, isTableCellNode, isTableNode, isTableRowNode, isTextNode, link, markdownToPlainText, paragraph, parseMarkdown, reviver, root, strikethrough, stringifyMarkdown, strong, tableElementToAscii, tableToAscii, text, toAiMessages, toCardElement, toModalElement, toPlainText, walkAst };