chat 4.20.1 → 4.21.0

package/dist/index.d.ts

@@ -1,8 +1,114 @@
 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, Paragraph, Root, Strong, TableCell, TableRow, Text } from 'mdast';
-import { C as CardElement, M as ModalElement, a as ChatElement, 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, S as SectionComponent, j as Table$2, t as toCardElement$1, k as toModalElement$1, l as fromReactModalElement$1, m as isModalElement$1, n as ModalComponent, R as RadioSelectComponent, o as SelectComponent, p as SelectOptionComponent, q as TextInputComponent } from './jsx-runtime-C2ATKxHQ.js';
-export { r as ActionsElement, s as ButtonElement, u as ButtonOptions, V as ButtonProps, v as ButtonStyle, W as CardJSXElement, X as CardJSXProps, Y as CardLinkProps, w as CardOptions, Z as CardProps, _ as ContainerProps, x as DividerElement, $ as DividerProps, y as FieldElement, a0 as FieldProps, z as FieldsElement, E as ImageElement, a1 as ImageProps, G as LinkButtonElement, H as LinkButtonOptions, a2 as LinkButtonProps, J as LinkElement, a8 as ModalChild, a9 as ModalOptions, a3 as ModalProps, aa as RadioSelectElement, ab as RadioSelectOptions, K as SectionElement, ac as SelectElement, ad as SelectOptionElement, a4 as SelectOptionProps, ae as SelectOptions, a5 as SelectProps, N as TableAlignment, O as TableElement, P as TableOptions, Q as TextElement, af as TextInputElement, ag as TextInputOptions, a6 as TextInputProps, a7 as TextProps, U as TextStyle } from './jsx-runtime-C2ATKxHQ.js';
+import { C as ChatElement, a as CardElement, M as ModalElement, 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, S as SectionComponent, j as Table$2, t as toCardElement$1, k as toModalElement$1, l as fromReactModalElement$1, m as isModalElement$1, n as ModalComponent, R as RadioSelectComponent, o as SelectComponent, p as SelectOptionComponent, q as TextInputComponent } from './jsx-runtime-DraWieqP.js';
+export { r as ActionsElement, s as ButtonElement, u as ButtonOptions, V as ButtonProps, v as ButtonStyle, W as CardJSXElement, X as CardJSXProps, Y as CardLinkProps, w as CardOptions, Z as CardProps, _ as ContainerProps, x as DividerElement, $ as DividerProps, y as FieldElement, a0 as FieldProps, z as FieldsElement, E as ImageElement, a1 as ImageProps, G as LinkButtonElement, H as LinkButtonOptions, a2 as LinkButtonProps, J as LinkElement, a8 as ModalChild, a9 as ModalOptions, a3 as ModalProps, aa as RadioSelectElement, ab as RadioSelectOptions, K as SectionElement, ac as SelectElement, ad as SelectOptionElement, a4 as SelectOptionProps, ae as SelectOptions, a5 as SelectProps, N as TableAlignment, O as TableElement, P as TableOptions, Q as TextElement, af as TextInputElement, ag as TextInputOptions, a6 as TextInputProps, a7 as TextProps, U as TextStyle } from './jsx-runtime-DraWieqP.js';
+
+interface MessageHistoryConfig {
+    /** 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.
+ *
+ * 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.
+ */
+declare class MessageHistoryCache {
+    private readonly state;
+    private readonly maxMessages;
+    private readonly ttlMs;
+    constructor(state: StateAdapter, config?: MessageHistoryConfig);
+    /**
+     * Atomically append a message to the history for a thread.
+     * Trims to maxMessages (keeps newest) and refreshes TTL.
+     */
+    append(threadId: string, message: Message): Promise<void>;
+    /**
+     * Get messages for a thread in chronological order (oldest first).
+     *
+     * @param threadId - The thread ID
+     * @param limit - Optional limit on number of messages to return (returns newest N)
+     */
+    getMessages(threadId: string, limit?: number): Promise<Message[]>;
+}
+
+/**
+ * Serialized channel data for passing to external systems (e.g., workflow engines).
+ */
+interface SerializedChannel {
+    _type: "chat:Channel";
+    adapterName: string;
+    id: string;
+    isDM: boolean;
+}
+/**
+ * Config for creating a ChannelImpl with explicit adapter/state instances.
+ */
+interface ChannelImplConfigWithAdapter {
+    adapter: Adapter;
+    id: string;
+    isDM?: boolean;
+    messageHistory?: MessageHistoryCache;
+    stateAdapter: StateAdapter;
+}
+/**
+ * Config for creating a ChannelImpl with lazy adapter resolution.
+ */
+interface ChannelImplConfigLazy {
+    adapterName: string;
+    id: string;
+    isDM?: boolean;
+}
+type ChannelImplConfig = ChannelImplConfigWithAdapter | ChannelImplConfigLazy;
+declare class ChannelImpl<TState = Record<string, unknown>> implements Channel<TState> {
+    readonly id: string;
+    readonly isDM: boolean;
+    private _adapter?;
+    private readonly _adapterName?;
+    private _stateAdapterInstance?;
+    private _name;
+    private readonly _messageHistory?;
+    constructor(config: ChannelImplConfig);
+    get adapter(): Adapter;
+    private get _stateAdapter();
+    get name(): string | null;
+    get state(): Promise<TState | null>;
+    setState(newState: Partial<TState>, options?: {
+        replace?: boolean;
+    }): Promise<void>;
+    /**
+     * Iterate messages newest first (backward from most recent).
+     * Uses adapter.fetchChannelMessages if available, otherwise falls back
+     * to adapter.fetchMessages with the channel ID.
+     */
+    get messages(): AsyncIterable<Message>;
+    /**
+     * Iterate threads in this channel, most recently active first.
+     */
+    threads(): AsyncIterable<ThreadSummary>;
+    fetchMetadata(): Promise<ChannelInfo>;
+    post(message: string | PostableMessage | ChatElement): Promise<SentMessage>;
+    private postSingleMessage;
+    postEphemeral(user: string | Author, message: AdapterPostableMessage | ChatElement, options: PostEphemeralOptions): Promise<EphemeralMessage | null>;
+    schedule(message: AdapterPostableMessage | ChatElement, options: {
+        postAt: Date;
+    }): Promise<ScheduledMessage>;
+    startTyping(status?: string): Promise<void>;
+    mentionUser(userId: string): string;
+    toJSON(): SerializedChannel;
+    static fromJSON<TState = Record<string, unknown>>(json: SerializedChannel, adapter?: Adapter): ChannelImpl<TState>;
+    static [WORKFLOW_SERIALIZE](instance: ChannelImpl): SerializedChannel;
+    static [WORKFLOW_DESERIALIZE](data: SerializedChannel): ChannelImpl;
+    private createSentMessage;
+}
+/**
+ * Derive the channel ID from a thread ID.
+ */
+declare function deriveChannelId(adapter: Adapter, threadId: string): string;
 
 /**
  * Logger types and implementations for chat-sdk
@@ -31,6 +137,178 @@ declare class ConsoleLogger implements Logger {
     error(message: string, ...args: unknown[]): void;
 }
 
+/**
+ * Serialized thread data for passing to external systems (e.g., workflow engines).
+ */
+interface SerializedThread {
+    _type: "chat:Thread";
+    adapterName: string;
+    channelId: string;
+    currentMessage?: SerializedMessage;
+    id: string;
+    isDM: boolean;
+}
+/**
+ * Config for creating a ThreadImpl with explicit adapter/state instances.
+ */
+interface ThreadImplConfigWithAdapter {
+    adapter: Adapter;
+    channelId: string;
+    currentMessage?: Message;
+    fallbackStreamingPlaceholderText?: string | null;
+    id: string;
+    initialMessage?: Message;
+    isDM?: boolean;
+    isSubscribedContext?: boolean;
+    logger?: Logger;
+    messageHistory?: MessageHistoryCache;
+    stateAdapter: StateAdapter;
+    streamingUpdateIntervalMs?: number;
+}
+/**
+ * Config for creating a ThreadImpl with lazy adapter resolution.
+ * The adapter will be looked up from the Chat singleton on first access.
+ */
+interface ThreadImplConfigLazy {
+    adapterName: string;
+    channelId: string;
+    currentMessage?: Message;
+    fallbackStreamingPlaceholderText?: string | null;
+    id: string;
+    initialMessage?: Message;
+    isDM?: boolean;
+    isSubscribedContext?: boolean;
+    logger?: Logger;
+    streamingUpdateIntervalMs?: number;
+}
+type ThreadImplConfig = ThreadImplConfigWithAdapter | ThreadImplConfigLazy;
+declare class ThreadImpl<TState = Record<string, unknown>> implements Thread<TState> {
+    readonly id: string;
+    readonly channelId: string;
+    readonly isDM: boolean;
+    /** Direct adapter instance (if provided) */
+    private _adapter?;
+    /** Adapter name for lazy resolution */
+    private readonly _adapterName?;
+    /** Direct state adapter instance (if provided) */
+    private _stateAdapterInstance?;
+    private _recentMessages;
+    private readonly _isSubscribedContext;
+    /** Current message context for streaming - provides userId/teamId */
+    private readonly _currentMessage?;
+    /** Update interval for fallback streaming */
+    private readonly _streamingUpdateIntervalMs;
+    /** Placeholder text for fallback streaming (post + edit) */
+    private readonly _fallbackStreamingPlaceholderText;
+    /** Cached channel instance */
+    private _channel?;
+    /** Message history cache (set only for adapters with persistMessageHistory) */
+    private readonly _messageHistory?;
+    private readonly _logger?;
+    constructor(config: ThreadImplConfig);
+    /**
+     * Get the adapter for this thread.
+     * If created with lazy config, resolves from Chat singleton on first access.
+     */
+    get adapter(): Adapter;
+    /**
+     * Get the state adapter for this thread.
+     * If created with lazy config, resolves from Chat singleton on first access.
+     */
+    private get _stateAdapter();
+    get recentMessages(): Message[];
+    set recentMessages(messages: Message[]);
+    /**
+     * Get the current thread state.
+     * Returns null if no state has been set.
+     */
+    get state(): Promise<TState | null>;
+    /**
+     * Set the thread state. Merges with existing state by default.
+     * State is persisted for 30 days.
+     */
+    setState(newState: Partial<TState>, options?: {
+        replace?: boolean;
+    }): Promise<void>;
+    /**
+     * Get the Channel containing this thread.
+     * Lazy-created and cached.
+     */
+    get channel(): Channel<TState>;
+    /**
+     * Iterate messages newest first (backward from most recent).
+     * Auto-paginates lazily.
+     */
+    get messages(): AsyncIterable<Message>;
+    get allMessages(): AsyncIterable<Message>;
+    isSubscribed(): Promise<boolean>;
+    subscribe(): Promise<void>;
+    unsubscribe(): Promise<void>;
+    post(message: string | PostableMessage | ChatElement): Promise<SentMessage>;
+    postEphemeral(user: string | Author, message: AdapterPostableMessage | ChatElement, options: PostEphemeralOptions): Promise<EphemeralMessage | null>;
+    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.
+     */
+    private handleStream;
+    startTyping(status?: string): Promise<void>;
+    /**
+     * Fallback streaming implementation using post + edit.
+     * Used when adapter doesn't support native streaming.
+     * Uses recursive setTimeout to send updates every intervalMs (default 500ms).
+     * Schedules next update only after current edit completes to avoid overwhelming slow services.
+     */
+    private fallbackStream;
+    refresh(): Promise<void>;
+    mentionUser(userId: string): string;
+    /**
+     * Serialize the thread to a plain JSON object.
+     * Use this to pass thread data to external systems like workflow engines.
+     *
+     * @example
+     * ```typescript
+     * // Pass to a workflow
+     * await workflow.start("my-workflow", {
+     *   thread: thread.toJSON(),
+     *   message: serializeMessage(message),
+     * });
+     * ```
+     */
+    toJSON(): SerializedThread;
+    /**
+     * Reconstruct a Thread from serialized JSON data.
+     *
+     * Reconstructs a ThreadImpl from serialized data.
+     * Uses lazy resolution from Chat.getSingleton() for adapter and state.
+     *
+     * @param json - Serialized thread data
+     * @requires Call `chat.registerSingleton()` before deserializing threads
+     *
+     * @example
+     * ```typescript
+     * const thread = ThreadImpl.fromJSON(serializedThread);
+     * ```
+     */
+    static fromJSON<TState = Record<string, unknown>>(json: SerializedThread, adapter?: Adapter): ThreadImpl<TState>;
+    /**
+     * Serialize a ThreadImpl instance for @workflow/serde.
+     * This static method is automatically called by workflow serialization.
+     */
+    static [WORKFLOW_SERIALIZE](instance: ThreadImpl): SerializedThread;
+    /**
+     * Deserialize a ThreadImpl from @workflow/serde.
+     * Uses lazy adapter resolution from Chat.getSingleton().
+     * Requires chat.registerSingleton() to have been called.
+     */
+    static [WORKFLOW_DESERIALIZE](data: SerializedThread): ThreadImpl;
+    private createSentMessage;
+    createSentMessageFromMessage(message: Message): SentMessage;
+}
+
 /**
  * Error types for chat-sdk
  */
@@ -149,6 +427,8 @@ interface Adapter<TThreadId = unknown, TRawMessage = unknown> {
     decodeThreadId(threadId: string): TThreadId;
     /** Delete a message */
     deleteMessage(threadId: string, messageId: string): Promise<void>;
+    /** Cleanup hook called when Chat instance is shutdown */
+    disconnect?(): Promise<void>;
     /** Edit an existing message */
     editMessage(threadId: string, messageId: string, message: AdapterPostableMessage): Promise<RawMessage<TRawMessage>>;
     /** Encode platform-specific data into a thread ID string */
@@ -566,6 +846,11 @@ interface Channel<TState = Record<string, unknown>, TRawMessage = unknown> exten
      * Empty iterable on threadless platforms.
      */
     threads(): AsyncIterable<ThreadSummary<TRawMessage>>;
+    /**
+     * Serialize the channel to a plain JSON object.
+     * Use this to pass channel data to external systems like workflow engines.
+     */
+    toJSON(): SerializedChannel;
 }
 /**
  * Lightweight summary of a thread within a channel.
@@ -738,6 +1023,11 @@ interface Thread<TState = Record<string, unknown>, TRawMessage = unknown> extend
      * ```
      */
     subscribe(): Promise<void>;
+    /**
+     * Serialize the thread to a plain JSON object.
+     * Use this to pass thread data to external systems like workflow engines.
+     */
+    toJSON(): SerializedThread;
     /**
      * Unsubscribe from this thread.
      *
@@ -1688,161 +1978,55 @@ type AiMessagePart = AiTextPart | AiImagePart | AiFilePart;
  */
 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[]>;
-
-interface MessageHistoryConfig {
-    /** 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.
- *
- * 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.
- */
-declare class MessageHistoryCache {
-    private readonly state;
-    private readonly maxMessages;
-    private readonly ttlMs;
-    constructor(state: StateAdapter, config?: MessageHistoryConfig);
-    /**
-     * Atomically append a message to the history for a thread.
-     * Trims to maxMessages (keeps newest) and refreshes TTL.
-     */
-    append(threadId: string, message: Message): Promise<void>;
-    /**
-     * Get messages for a thread in chronological order (oldest first).
-     *
-     * @param threadId - The thread ID
-     * @param limit - Optional limit on number of messages to return (returns newest N)
-     */
-    getMessages(threadId: string, limit?: number): Promise<Message[]>;
-}
-
-/**
- * Serialized channel data for passing to external systems (e.g., workflow engines).
- */
-interface SerializedChannel {
-    _type: "chat:Channel";
-    adapterName: string;
-    id: string;
-    isDM: boolean;
-}
-/**
- * Config for creating a ChannelImpl with explicit adapter/state instances.
- */
-interface ChannelImplConfigWithAdapter {
-    adapter: Adapter;
-    id: string;
-    isDM?: boolean;
-    messageHistory?: MessageHistoryCache;
-    stateAdapter: StateAdapter;
+    content: string | AiMessagePart[];
+    role: "user";
+}
+interface AiAssistantMessage {
+    content: string;
+    role: "assistant";
 }
 /**
- * Config for creating a ChannelImpl with lazy adapter resolution.
+ * Options for converting messages to AI SDK format.
  */
-interface ChannelImplConfigLazy {
-    adapterName: string;
-    id: string;
-    isDM?: boolean;
-}
-type ChannelImplConfig = ChannelImplConfigWithAdapter | ChannelImplConfigLazy;
-declare class ChannelImpl<TState = Record<string, unknown>> implements Channel<TState> {
-    readonly id: string;
-    readonly isDM: boolean;
-    private _adapter?;
-    private readonly _adapterName?;
-    private _stateAdapterInstance?;
-    private _name;
-    private readonly _messageHistory?;
-    constructor(config: ChannelImplConfig);
-    get adapter(): Adapter;
-    private get _stateAdapter();
-    get name(): string | null;
-    get state(): Promise<TState | null>;
-    setState(newState: Partial<TState>, options?: {
-        replace?: boolean;
-    }): Promise<void>;
+interface ToAiMessagesOptions {
+    /** When true, prefixes user messages with "[username]: " for multi-user context */
+    includeNames?: boolean;
     /**
-     * Iterate messages newest first (backward from most recent).
-     * Uses adapter.fetchChannelMessages if available, otherwise falls back
-     * to adapter.fetchMessages with the channel ID.
+     * Called when an attachment type is not supported (video, audio).
+     * Defaults to `console.warn`.
      */
-    get messages(): AsyncIterable<Message>;
+    onUnsupportedAttachment?: (attachment: Attachment, message: Message) => void;
     /**
-     * Iterate threads in this channel, most recently active first.
+     * 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
      */
-    threads(): AsyncIterable<ThreadSummary>;
-    fetchMetadata(): Promise<ChannelInfo>;
-    post(message: string | PostableMessage | ChatElement): Promise<SentMessage>;
-    private postSingleMessage;
-    postEphemeral(user: string | Author, message: AdapterPostableMessage | ChatElement, options: PostEphemeralOptions): Promise<EphemeralMessage | null>;
-    schedule(message: AdapterPostableMessage | ChatElement, options: {
-        postAt: Date;
-    }): Promise<ScheduledMessage>;
-    startTyping(status?: string): Promise<void>;
-    mentionUser(userId: string): string;
-    toJSON(): SerializedChannel;
-    static fromJSON<TState = Record<string, unknown>>(json: SerializedChannel, adapter?: Adapter): ChannelImpl<TState>;
-    static [WORKFLOW_SERIALIZE](instance: ChannelImpl): SerializedChannel;
-    static [WORKFLOW_DESERIALIZE](data: SerializedChannel): ChannelImpl;
-    private createSentMessage;
+    transformMessage?: (aiMessage: AiMessage, source: Message) => AiMessage | null | Promise<AiMessage | null>;
 }
 /**
- * Derive the channel ID from a thread ID.
+ * 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 deriveChannelId(adapter: Adapter, threadId: string): string;
+declare function toAiMessages(messages: Message[], options?: ToAiMessagesOptions): Promise<AiMessage[]>;
 
 /** Filter can be EmojiValue objects, emoji names, or raw emoji formats */
 type EmojiFilter = EmojiValue | string;
@@ -2374,178 +2558,6 @@ declare class StreamingMarkdownRenderer {
     finish(): string;
 }
 
-/**
- * Serialized thread data for passing to external systems (e.g., workflow engines).
- */
-interface SerializedThread {
-    _type: "chat:Thread";
-    adapterName: string;
-    channelId: string;
-    currentMessage?: SerializedMessage;
-    id: string;
-    isDM: boolean;
-}
-/**
- * Config for creating a ThreadImpl with explicit adapter/state instances.
- */
-interface ThreadImplConfigWithAdapter {
-    adapter: Adapter;
-    channelId: string;
-    currentMessage?: Message;
-    fallbackStreamingPlaceholderText?: string | null;
-    id: string;
-    initialMessage?: Message;
-    isDM?: boolean;
-    isSubscribedContext?: boolean;
-    logger?: Logger;
-    messageHistory?: MessageHistoryCache;
-    stateAdapter: StateAdapter;
-    streamingUpdateIntervalMs?: number;
-}
-/**
- * Config for creating a ThreadImpl with lazy adapter resolution.
- * The adapter will be looked up from the Chat singleton on first access.
- */
-interface ThreadImplConfigLazy {
-    adapterName: string;
-    channelId: string;
-    currentMessage?: Message;
-    fallbackStreamingPlaceholderText?: string | null;
-    id: string;
-    initialMessage?: Message;
-    isDM?: boolean;
-    isSubscribedContext?: boolean;
-    logger?: Logger;
-    streamingUpdateIntervalMs?: number;
-}
-type ThreadImplConfig = ThreadImplConfigWithAdapter | ThreadImplConfigLazy;
-declare class ThreadImpl<TState = Record<string, unknown>> implements Thread<TState> {
-    readonly id: string;
-    readonly channelId: string;
-    readonly isDM: boolean;
-    /** Direct adapter instance (if provided) */
-    private _adapter?;
-    /** Adapter name for lazy resolution */
-    private readonly _adapterName?;
-    /** Direct state adapter instance (if provided) */
-    private _stateAdapterInstance?;
-    private _recentMessages;
-    private readonly _isSubscribedContext;
-    /** Current message context for streaming - provides userId/teamId */
-    private readonly _currentMessage?;
-    /** Update interval for fallback streaming */
-    private readonly _streamingUpdateIntervalMs;
-    /** Placeholder text for fallback streaming (post + edit) */
-    private readonly _fallbackStreamingPlaceholderText;
-    /** Cached channel instance */
-    private _channel?;
-    /** Message history cache (set only for adapters with persistMessageHistory) */
-    private readonly _messageHistory?;
-    private readonly _logger?;
-    constructor(config: ThreadImplConfig);
-    /**
-     * Get the adapter for this thread.
-     * If created with lazy config, resolves from Chat singleton on first access.
-     */
-    get adapter(): Adapter;
-    /**
-     * Get the state adapter for this thread.
-     * If created with lazy config, resolves from Chat singleton on first access.
-     */
-    private get _stateAdapter();
-    get recentMessages(): Message[];
-    set recentMessages(messages: Message[]);
-    /**
-     * Get the current thread state.
-     * Returns null if no state has been set.
-     */
-    get state(): Promise<TState | null>;
-    /**
-     * Set the thread state. Merges with existing state by default.
-     * State is persisted for 30 days.
-     */
-    setState(newState: Partial<TState>, options?: {
-        replace?: boolean;
-    }): Promise<void>;
-    /**
-     * Get the Channel containing this thread.
-     * Lazy-created and cached.
-     */
-    get channel(): Channel<TState>;
-    /**
-     * Iterate messages newest first (backward from most recent).
-     * Auto-paginates lazily.
-     */
-    get messages(): AsyncIterable<Message>;
-    get allMessages(): AsyncIterable<Message>;
-    isSubscribed(): Promise<boolean>;
-    subscribe(): Promise<void>;
-    unsubscribe(): Promise<void>;
-    post(message: string | PostableMessage | ChatElement): Promise<SentMessage>;
-    postEphemeral(user: string | Author, message: AdapterPostableMessage | ChatElement, options: PostEphemeralOptions): Promise<EphemeralMessage | null>;
-    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.
-     */
-    private handleStream;
-    startTyping(status?: string): Promise<void>;
-    /**
-     * Fallback streaming implementation using post + edit.
-     * Used when adapter doesn't support native streaming.
-     * Uses recursive setTimeout to send updates every intervalMs (default 500ms).
-     * Schedules next update only after current edit completes to avoid overwhelming slow services.
-     */
-    private fallbackStream;
-    refresh(): Promise<void>;
-    mentionUser(userId: string): string;
-    /**
-     * Serialize the thread to a plain JSON object.
-     * Use this to pass thread data to external systems like workflow engines.
-     *
-     * @example
-     * ```typescript
-     * // Pass to a workflow
-     * await workflow.start("my-workflow", {
-     *   thread: thread.toJSON(),
-     *   message: serializeMessage(message),
-     * });
-     * ```
-     */
-    toJSON(): SerializedThread;
-    /**
-     * Reconstruct a Thread from serialized JSON data.
-     *
-     * Reconstructs a ThreadImpl from serialized data.
-     * Uses lazy resolution from Chat.getSingleton() for adapter and state.
-     *
-     * @param json - Serialized thread data
-     * @requires Call `chat.registerSingleton()` before deserializing threads
-     *
-     * @example
-     * ```typescript
-     * const thread = ThreadImpl.fromJSON(serializedThread);
-     * ```
-     */
-    static fromJSON<TState = Record<string, unknown>>(json: SerializedThread, adapter?: Adapter): ThreadImpl<TState>;
-    /**
-     * Serialize a ThreadImpl instance for @workflow/serde.
-     * This static method is automatically called by workflow serialization.
-     */
-    static [WORKFLOW_SERIALIZE](instance: ThreadImpl): SerializedThread;
-    /**
-     * Deserialize a ThreadImpl from @workflow/serde.
-     * Uses lazy adapter resolution from Chat.getSingleton().
-     * Requires chat.registerSingleton() to have been called.
-     */
-    static [WORKFLOW_DESERIALIZE](data: SerializedThread): ThreadImpl;
-    private createSentMessage;
-    createSentMessageFromMessage(message: Message): SentMessage;
-}
-
 /**
  * Get or create an immutable singleton EmojiValue.
  *