@linqapp/sdk 0.1.0 → 0.1.3

package/resources/chats/chats.d.mts

@@ -1,6 +1,8 @@
 import { APIResource } from "../../core/resource.mjs";
-import * as MessagesAPI from "./messages.mjs";
-import { MessageListParams, MessageListResponse, MessageSendParams, MessageSendResponse, Messages } from "./messages.mjs";
+import * as ChatsAPI from "./chats.mjs";
+import * as MessagesAPI from "../messages.mjs";
+import * as ChatsMessagesAPI from "./messages.mjs";
+import { MessageListParams, MessageListResponse, MessageSendParams, MessageSendResponse, Messages, SentMessage } from "./messages.mjs";
 import * as ParticipantsAPI from "./participants.mjs";
 import { ParticipantAddParams, ParticipantAddResponse, ParticipantRemoveParams, ParticipantRemoveResponse, Participants } from "./participants.mjs";
 import * as TypingAPI from "./typing.mjs";
@@ -10,7 +12,7 @@ import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class Chats extends APIResource {
     participants: ParticipantsAPI.Participants;
     typing: TypingAPI.Typing;
-    messages: MessagesAPI.Messages;
+    messages: ChatsMessagesAPI.Messages;
     /**
      * Create a new chat with specified participants and send an initial message. The
      * initial message is required when creating a chat.
@@ -56,7 +58,7 @@ export declare class Chats extends APIResource {
      * );
      * ```
      */
-    retrieve(chatID: string, options?: RequestOptions): APIPromise<ChatRetrieveResponse>;
+    retrieve(chatID: string, options?: RequestOptions): APIPromise<Chat>;
     /**
      * Update chat properties such as display name and group chat icon.
      *
@@ -68,7 +70,7 @@ export declare class Chats extends APIResource {
      * );
      * ```
      */
-    update(chatID: string, body: ChatUpdateParams, options?: RequestOptions): APIPromise<ChatUpdateResponse>;
+    update(chatID: string, body: ChatUpdateParams, options?: RequestOptions): APIPromise<Chat>;
     /**
      * Retrieves a paginated list of chats for the authenticated partner filtered by
      * phone number. Returns all chats involving the specified phone number with their
@@ -151,343 +153,7 @@ export declare class Chats extends APIResource {
      */
     shareContactCard(chatID: string, options?: RequestOptions): APIPromise<void>;
 }
-/**
- * Response for creating a new chat with an initial message
- */
-export interface ChatCreateResponse {
-    chat: ChatCreateResponse.Chat;
-}
-export declare namespace ChatCreateResponse {
-    interface Chat {
-        /**
-         * Unique identifier for the created chat (UUID)
-         */
-        id: string;
-        /**
-         * Display name for the chat. Defaults to a comma-separated list of recipient
-         * handles. Can be updated for group chats.
-         */
-        display_name: string | null;
-        /**
-         * List of participants in the chat. Always contains at least two handles (your
-         * phone number and the other participant).
-         */
-        handles: Array<Chat.Handle>;
-        /**
-         * Whether this is a group chat
-         */
-        is_group: boolean;
-        /**
-         * A message that was sent (used in CreateChat and SendMessage responses)
-         */
-        message: Chat.Message;
-        /**
-         * Messaging service type
-         */
-        service: 'iMessage' | 'SMS' | 'RCS';
-    }
-    namespace Chat {
-        interface Handle {
-            /**
-             * Unique identifier for this handle
-             */
-            id: string;
-            /**
-             * Phone number (E.164) or email address of the participant
-             */
-            handle: string;
-            /**
-             * When this participant joined the chat
-             */
-            joined_at: string;
-            /**
-             * Messaging service type
-             */
-            service: 'iMessage' | 'SMS' | 'RCS';
-            /**
-             * Whether this handle belongs to the sender (your phone number)
-             */
-            is_me?: boolean | null;
-            /**
-             * When they left (if applicable)
-             */
-            left_at?: string | null;
-            /**
-             * Participant status
-             */
-            status?: 'active' | 'left' | 'removed' | null;
-        }
-        /**
-         * A message that was sent (used in CreateChat and SendMessage responses)
-         */
-        interface Message {
-            /**
-             * Message identifier (UUID)
-             */
-            id: string;
-            /**
-             * Current delivery status of a message
-             */
-            delivery_status: 'pending' | 'queued' | 'sent' | 'delivered' | 'failed';
-            /**
-             * Whether the message has been read
-             */
-            is_read: boolean;
-            /**
-             * Message parts in order (text and media)
-             */
-            parts: Array<Message.TextPartResponse | Message.MediaPartResponse>;
-            /**
-             * When the message was sent
-             */
-            sent_at: string;
-            /**
-             * When the message was delivered
-             */
-            delivered_at?: string | null;
-            /**
-             * iMessage effect applied to a message (screen or bubble effect)
-             */
-            effect?: Message.Effect | null;
-            /**
-             * The sender of this message as a full handle object
-             */
-            from_handle?: Message.FromHandle | null;
-            /**
-             * Messaging service type
-             */
-            preferred_service?: 'iMessage' | 'SMS' | 'RCS' | null;
-            /**
-             * Indicates this message is a threaded reply to another message
-             */
-            reply_to?: Message.ReplyTo | null;
-            /**
-             * Messaging service type
-             */
-            service?: 'iMessage' | 'SMS' | 'RCS' | null;
-        }
-        namespace Message {
-            /**
-             * A text message part
-             */
-            interface TextPartResponse {
-                /**
-                 * Reactions on this message part
-                 */
-                reactions: Array<TextPartResponse.Reaction> | null;
-                /**
-                 * Indicates this is a text message part
-                 */
-                type: 'text';
-                /**
-                 * The text content
-                 */
-                value: string;
-            }
-            namespace TextPartResponse {
-                interface Reaction {
-                    handle: Reaction.Handle;
-                    /**
-                     * Whether this reaction is from the current user
-                     */
-                    is_me: boolean;
-                    /**
-                     * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-                     * emphasize, question. Custom emoji reactions have type "custom" with the actual
-                     * emoji in the custom_emoji field.
-                     */
-                    type: 'love' | 'like' | 'dislike' | 'laugh' | 'emphasize' | 'question' | 'custom';
-                    /**
-                     * Custom emoji if type is "custom", null otherwise
-                     */
-                    custom_emoji?: string | null;
-                }
-                namespace Reaction {
-                    interface Handle {
-                        /**
-                         * Unique identifier for this handle
-                         */
-                        id: string;
-                        /**
-                         * Phone number (E.164) or email address of the participant
-                         */
-                        handle: string;
-                        /**
-                         * When this participant joined the chat
-                         */
-                        joined_at: string;
-                        /**
-                         * Messaging service type
-                         */
-                        service: 'iMessage' | 'SMS' | 'RCS';
-                        /**
-                         * Whether this handle belongs to the sender (your phone number)
-                         */
-                        is_me?: boolean | null;
-                        /**
-                         * When they left (if applicable)
-                         */
-                        left_at?: string | null;
-                        /**
-                         * Participant status
-                         */
-                        status?: 'active' | 'left' | 'removed' | null;
-                    }
-                }
-            }
-            /**
-             * A media attachment part
-             */
-            interface MediaPartResponse {
-                /**
-                 * Unique attachment identifier
-                 */
-                id: string;
-                /**
-                 * Original filename
-                 */
-                filename: string;
-                /**
-                 * MIME type of the file
-                 */
-                mime_type: string;
-                /**
-                 * Reactions on this message part
-                 */
-                reactions: Array<MediaPartResponse.Reaction> | null;
-                /**
-                 * File size in bytes
-                 */
-                size_bytes: number;
-                /**
-                 * Indicates this is a media attachment part
-                 */
-                type: 'media';
-                /**
-                 * Presigned URL for downloading the attachment (expires in 1 hour).
-                 */
-                url: string;
-            }
-            namespace MediaPartResponse {
-                interface Reaction {
-                    handle: Reaction.Handle;
-                    /**
-                     * Whether this reaction is from the current user
-                     */
-                    is_me: boolean;
-                    /**
-                     * Type of reaction. Standard iMessage tapbacks are love, like, dislike, laugh,
-                     * emphasize, question. Custom emoji reactions have type "custom" with the actual
-                     * emoji in the custom_emoji field.
-                     */
-                    type: 'love' | 'like' | 'dislike' | 'laugh' | 'emphasize' | 'question' | 'custom';
-                    /**
-                     * Custom emoji if type is "custom", null otherwise
-                     */
-                    custom_emoji?: string | null;
-                }
-                namespace Reaction {
-                    interface Handle {
-                        /**
-                         * Unique identifier for this handle
-                         */
-                        id: string;
-                        /**
-                         * Phone number (E.164) or email address of the participant
-                         */
-                        handle: string;
-                        /**
-                         * When this participant joined the chat
-                         */
-                        joined_at: string;
-                        /**
-                         * Messaging service type
-                         */
-                        service: 'iMessage' | 'SMS' | 'RCS';
-                        /**
-                         * Whether this handle belongs to the sender (your phone number)
-                         */
-                        is_me?: boolean | null;
-                        /**
-                         * When they left (if applicable)
-                         */
-                        left_at?: string | null;
-                        /**
-                         * Participant status
-                         */
-                        status?: 'active' | 'left' | 'removed' | null;
-                    }
-                }
-            }
-            /**
-             * iMessage effect applied to a message (screen or bubble effect)
-             */
-            interface Effect {
-                /**
-                 * Name of the effect. Common values:
-                 *
-                 * - Screen effects: confetti, fireworks, lasers, sparkles, celebration, hearts,
-                 *   love, balloons, happy_birthday, echo, spotlight
-                 * - Bubble effects: slam, loud, gentle, invisible
-                 */
-                name?: string;
-                /**
-                 * Type of effect
-                 */
-                type?: 'screen' | 'bubble';
-            }
-            /**
-             * The sender of this message as a full handle object
-             */
-            interface FromHandle {
-                /**
-                 * Unique identifier for this handle
-                 */
-                id: string;
-                /**
-                 * Phone number (E.164) or email address of the participant
-                 */
-                handle: string;
-                /**
-                 * When this participant joined the chat
-                 */
-                joined_at: string;
-                /**
-                 * Messaging service type
-                 */
-                service: 'iMessage' | 'SMS' | 'RCS';
-                /**
-                 * Whether this handle belongs to the sender (your phone number)
-                 */
-                is_me?: boolean | null;
-                /**
-                 * When they left (if applicable)
-                 */
-                left_at?: string | null;
-                /**
-                 * Participant status
-                 */
-                status?: 'active' | 'left' | 'removed' | null;
-            }
-            /**
-             * Indicates this message is a threaded reply to another message
-             */
-            interface ReplyTo {
-                /**
-                 * The ID of the message to reply to
-                 */
-                message_id: string;
-                /**
-                 * The specific message part to reply to (0-based index). Defaults to 0 (first
-                 * part) if not provided. Use this when replying to a specific part of a multipart
-                 * message.
-                 */
-                part_index?: number;
-            }
-        }
-    }
-}
-export interface ChatRetrieveResponse {
+export interface Chat {
     /**
      * Unique identifier for the chat
      */
@@ -505,7 +171,7 @@ export interface ChatRetrieveResponse {
      * List of chat participants with full handle details. Always contains at least two
      * handles (your phone number and the other participant).
      */
-    handles: Array<ChatRetrieveResponse.Handle>;
+    handles: Array<MessagesAPI.ChatHandle>;
     /**
      * Whether the chat is archived
      */
@@ -521,189 +187,175 @@ export interface ChatRetrieveResponse {
     /**
      * Messaging service type
      */
-    service?: 'iMessage' | 'SMS' | 'RCS' | null;
-}
-export declare namespace ChatRetrieveResponse {
-    interface Handle {
-        /**
-         * Unique identifier for this handle
-         */
-        id: string;
-        /**
-         * Phone number (E.164) or email address of the participant
-         */
-        handle: string;
-        /**
-         * When this participant joined the chat
-         */
-        joined_at: string;
-        /**
-         * Messaging service type
-         */
-        service: 'iMessage' | 'SMS' | 'RCS';
-        /**
-         * Whether this handle belongs to the sender (your phone number)
-         */
-        is_me?: boolean | null;
-        /**
-         * When they left (if applicable)
-         */
-        left_at?: string | null;
-        /**
-         * Participant status
-         */
-        status?: 'active' | 'left' | 'removed' | null;
-    }
+    service?: ServiceType | null;
 }
-export interface ChatUpdateResponse {
-    /**
-     * Unique identifier for the chat
-     */
-    id: string;
-    /**
-     * When the chat was created
-     */
-    created_at: string;
-    /**
-     * Display name for the chat. Defaults to a comma-separated list of recipient
-     * handles. Can be updated for group chats.
-     */
-    display_name: string | null;
+/**
+ * Message content container. Groups all message-related fields together,
+ * separating the "what" (message content) from the "where" (routing fields like
+ * from/to).
+ */
+export interface MessageContent {
     /**
-     * List of chat participants with full handle details. Always contains at least two
-     * handles (your phone number and the other participant).
+     * Array of message parts. Each part can be either text or media. Parts are
+     * displayed in order. Text and media can be mixed.
+     *
+     * **Supported Media:**
+     *
+     * - Images: .jpg, .jpeg, .png, .gif, .heic, .heif, .tif, .tiff, .bmp
+     * - Videos: .mp4, .mov, .m4v, .mpeg, .mpg, .3gp
+     * - Audio: .m4a, .mp3, .aac, .caf, .wav, .aiff, .amr
+     * - Documents: .pdf, .txt, .rtf, .csv, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
+     *   .pages, .numbers, .key, .epub, .zip, .html, .htm
+     * - Contact & Calendar: .vcf, .ics
+     *
+     * **Audio:**
+     *
+     * - Audio files (.m4a, .mp3, .aac, .caf, .wav, .aiff, .amr) are fully supported as
+     *   media parts
+     * - To send audio as an **iMessage voice memo bubble** (inline playback UI), use
+     *   the dedicated `/v3/chats/{chatId}/voicememo` endpoint instead
+     *
+     * **Validation Rule:** Consecutive text parts are not allowed. Text parts must be
+     * separated by media parts. For example, [text, text] is invalid, but [text,
+     * media, text] is valid.
      */
-    handles: Array<ChatUpdateResponse.Handle>;
+    parts: Array<MessageContent.TextPart | MessageContent.MediaPart>;
     /**
-     * Whether the chat is archived
+     * iMessage effect to apply to this message (screen or bubble effect)
      */
-    is_archived: boolean;
+    effect?: MessagesAPI.MessageEffect;
     /**
-     * Whether this is a group chat
+     * Optional idempotency key for this message. Use this to prevent duplicate sends
+     * of the same message.
      */
-    is_group: boolean;
+    idempotency_key?: string;
     /**
-     * When the chat was last updated
+     * Messaging service type
      */
-    updated_at: string;
+    preferred_service?: ServiceType;
     /**
-     * Messaging service type
+     * Reply to another message to create a threaded conversation
      */
-    service?: 'iMessage' | 'SMS' | 'RCS' | null;
+    reply_to?: MessagesAPI.ReplyTo;
 }
-export declare namespace ChatUpdateResponse {
-    interface Handle {
+export declare namespace MessageContent {
+    interface TextPart {
         /**
-         * Unique identifier for this handle
+         * Indicates this is a text message part
          */
-        id: string;
+        type: 'text';
         /**
-         * Phone number (E.164) or email address of the participant
+         * The text content
          */
-        handle: string;
+        value: string;
         /**
-         * When this participant joined the chat
+         * Optional idempotency key for this specific message part. Use this to prevent
+         * duplicate sends of the same part.
          */
-        joined_at: string;
+        idempotency_key?: string;
+    }
+    interface MediaPart {
         /**
-         * Messaging service type
+         * Indicates this is a media attachment part
          */
-        service: 'iMessage' | 'SMS' | 'RCS';
+        type: 'media';
         /**
-         * Whether this handle belongs to the sender (your phone number)
+         * Reference to a file pre-uploaded via `POST /v3/attachments` (optional). The file
+         * is already stored, so sends using this ID skip the download step — useful when
+         * sending the same file to many recipients.
+         *
+         * Either `url` or `attachment_id` must be provided, but not both.
          */
-        is_me?: boolean | null;
+        attachment_id?: string;
         /**
-         * When they left (if applicable)
+         * Optional idempotency key for this specific message part. Use this to prevent
+         * duplicate sends of the same part.
          */
-        left_at?: string | null;
+        idempotency_key?: string;
         /**
-         * Participant status
+         * Any publicly accessible HTTPS URL to the media file. The server downloads and
+         * sends the file automatically — no pre-upload step required.
+         *
+         * **Size limit:** 10MB maximum for URL-based downloads. For larger files (up to
+         * 100MB), use the pre-upload flow: `POST /v3/attachments` to get a presigned URL,
+         * upload directly, then reference by `attachment_id`.
+         *
+         * **Requirements:**
+         *
+         * - URL must use HTTPS
+         * - File content must be a supported format (the server validates the actual file
+         *   content)
+         *
+         * **Supported formats:**
+         *
+         * - Images: .jpg, .jpeg, .png, .gif, .heic, .heif, .tif, .tiff, .bmp
+         * - Videos: .mp4, .mov, .m4v, .mpeg, .mpg, .3gp
+         * - Audio: .m4a, .mp3, .aac, .caf, .wav, .aiff, .amr
+         * - Documents: .pdf, .txt, .rtf, .csv, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
+         *   .pages, .numbers, .key, .epub, .zip, .html, .htm
+         * - Contact & Calendar: .vcf, .ics
+         *
+         * **Tip:** Audio sent here appears as a regular file attachment. To send audio as
+         * an iMessage voice memo bubble (with inline playback), use
+         * `/v3/chats/{chatId}/voicememo`. For repeated sends of the same file, use
+         * `attachment_id` to avoid redundant downloads.
+         *
+         * Either `url` or `attachment_id` must be provided, but not both.
          */
-        status?: 'active' | 'left' | 'removed' | null;
+        url?: string;
     }
 }
-export interface ChatListResponse {
-    /**
-     * List of chats
-     */
-    chats: Array<ChatListResponse.Chat>;
-    /**
-     * Cursor for fetching the next page of results. Null if there are no more results
-     * to fetch. Pass this value as the `cursor` parameter in the next request.
-     */
-    next_cursor?: string | null;
+/**
+ * Messaging service type
+ */
+export type ServiceType = 'iMessage' | 'SMS' | 'RCS';
+/**
+ * Response for creating a new chat with an initial message
+ */
+export interface ChatCreateResponse {
+    chat: ChatCreateResponse.Chat;
 }
-export declare namespace ChatListResponse {
+export declare namespace ChatCreateResponse {
     interface Chat {
         /**
-         * Unique identifier for the chat
+         * Unique identifier for the created chat (UUID)
          */
         id: string;
-        /**
-         * When the chat was created
-         */
-        created_at: string;
         /**
          * Display name for the chat. Defaults to a comma-separated list of recipient
          * handles. Can be updated for group chats.
          */
         display_name: string | null;
         /**
-         * List of chat participants with full handle details. Always contains at least two
-         * handles (your phone number and the other participant).
-         */
-        handles: Array<Chat.Handle>;
-        /**
-         * Whether the chat is archived
+         * List of participants in the chat. Always contains at least two handles (your
+         * phone number and the other participant).
          */
-        is_archived: boolean;
+        handles: Array<MessagesAPI.ChatHandle>;
         /**
          * Whether this is a group chat
          */
         is_group: boolean;
         /**
-         * When the chat was last updated
+         * A message that was sent (used in CreateChat and SendMessage responses)
          */
-        updated_at: string;
+        message: ChatsMessagesAPI.SentMessage;
         /**
          * Messaging service type
          */
-        service?: 'iMessage' | 'SMS' | 'RCS' | null;
-    }
-    namespace Chat {
-        interface Handle {
-            /**
-             * Unique identifier for this handle
-             */
-            id: string;
-            /**
-             * Phone number (E.164) or email address of the participant
-             */
-            handle: string;
-            /**
-             * When this participant joined the chat
-             */
-            joined_at: string;
-            /**
-             * Messaging service type
-             */
-            service: 'iMessage' | 'SMS' | 'RCS';
-            /**
-             * Whether this handle belongs to the sender (your phone number)
-             */
-            is_me?: boolean | null;
-            /**
-             * When they left (if applicable)
-             */
-            left_at?: string | null;
-            /**
-             * Participant status
-             */
-            status?: 'active' | 'left' | 'removed' | null;
-        }
+        service: ChatsAPI.ServiceType;
     }
 }
+export interface ChatListResponse {
+    /**
+     * List of chats
+     */
+    chats: Array<Chat>;
+    /**
+     * Cursor for fetching the next page of results. Null if there are no more results
+     * to fetch. Pass this value as the `cursor` parameter in the next request.
+     */
+    next_cursor?: string | null;
+}
 /**
  * Response for sending a voice memo to a chat
  */
@@ -737,7 +389,7 @@ export declare namespace ChatSendVoicememoResponse {
         /**
          * Messaging service type
          */
-        service?: 'iMessage' | 'SMS' | 'RCS' | null;
+        service?: ChatsAPI.ServiceType | null;
     }
     namespace VoiceMemo {
         interface Chat {
@@ -748,7 +400,7 @@ export declare namespace ChatSendVoicememoResponse {
             /**
              * Chat participants
              */
-            handles: Array<Chat.Handle>;
+            handles: Array<MessagesAPI.ChatHandle>;
             /**
              * Whether the chat is active
              */
@@ -760,39 +412,7 @@ export declare namespace ChatSendVoicememoResponse {
             /**
              * Messaging service type
              */
-            service: 'iMessage' | 'SMS' | 'RCS';
-        }
-        namespace Chat {
-            interface Handle {
-                /**
-                 * Unique identifier for this handle
-                 */
-                id: string;
-                /**
-                 * Phone number (E.164) or email address of the participant
-                 */
-                handle: string;
-                /**
-                 * When this participant joined the chat
-                 */
-                joined_at: string;
-                /**
-                 * Messaging service type
-                 */
-                service: 'iMessage' | 'SMS' | 'RCS';
-                /**
-                 * Whether this handle belongs to the sender (your phone number)
-                 */
-                is_me?: boolean | null;
-                /**
-                 * When they left (if applicable)
-                 */
-                left_at?: string | null;
-                /**
-                 * Participant status
-                 */
-                status?: 'active' | 'left' | 'removed' | null;
-            }
+            service: ChatsAPI.ServiceType;
         }
         interface VoiceMemo {
             /**
@@ -833,163 +453,13 @@ export interface ChatCreateParams {
      * separating the "what" (message content) from the "where" (routing fields like
      * from/to).
      */
-    message: ChatCreateParams.Message;
+    message: MessageContent;
     /**
      * Array of recipient handles (phone numbers in E.164 format or email addresses).
      * For individual chats, provide one recipient. For group chats, provide multiple.
      */
     to: Array<string>;
 }
-export declare namespace ChatCreateParams {
-    /**
-     * Message content container. Groups all message-related fields together,
-     * separating the "what" (message content) from the "where" (routing fields like
-     * from/to).
-     */
-    interface Message {
-        /**
-         * Array of message parts. Each part can be either text or media. Parts are
-         * displayed in order. Text and media can be mixed.
-         *
-         * **Supported Media:**
-         *
-         * - Images: .jpg, .jpeg, .png, .gif, .heic, .heif, .tif, .tiff, .bmp
-         * - Videos: .mp4, .mov, .m4v, .mpeg, .mpg, .3gp
-         * - Audio: .m4a, .mp3, .aac, .caf, .wav, .aiff, .amr
-         * - Documents: .pdf, .txt, .rtf, .csv, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
-         *   .pages, .numbers, .key, .epub, .zip, .html, .htm
-         * - Contact & Calendar: .vcf, .ics
-         *
-         * **Audio:**
-         *
-         * - Audio files (.m4a, .mp3, .aac, .caf, .wav, .aiff, .amr) are fully supported as
-         *   media parts
-         * - To send audio as an **iMessage voice memo bubble** (inline playback UI), use
-         *   the dedicated `/v3/chats/{chatId}/voicememo` endpoint instead
-         *
-         * **Validation Rule:** Consecutive text parts are not allowed. Text parts must be
-         * separated by media parts. For example, [text, text] is invalid, but [text,
-         * media, text] is valid.
-         */
-        parts: Array<Message.TextPart | Message.MediaPart>;
-        /**
-         * iMessage effect to apply to this message (screen or bubble effect)
-         */
-        effect?: Message.Effect;
-        /**
-         * Optional idempotency key for this message. Use this to prevent duplicate sends
-         * of the same message.
-         */
-        idempotency_key?: string;
-        /**
-         * Messaging service type
-         */
-        preferred_service?: 'iMessage' | 'SMS' | 'RCS';
-        /**
-         * Reply to another message to create a threaded conversation
-         */
-        reply_to?: Message.ReplyTo;
-    }
-    namespace Message {
-        interface TextPart {
-            /**
-             * Indicates this is a text message part
-             */
-            type: 'text';
-            /**
-             * The text content
-             */
-            value: string;
-            /**
-             * Optional idempotency key for this specific message part. Use this to prevent
-             * duplicate sends of the same part.
-             */
-            idempotency_key?: string;
-        }
-        interface MediaPart {
-            /**
-             * Indicates this is a media attachment part
-             */
-            type: 'media';
-            /**
-             * Reference to a file pre-uploaded via `POST /v3/attachments` (optional). The file
-             * is already stored, so sends using this ID skip the download step — useful when
-             * sending the same file to many recipients.
-             *
-             * Either `url` or `attachment_id` must be provided, but not both.
-             */
-            attachment_id?: string;
-            /**
-             * Optional idempotency key for this specific message part. Use this to prevent
-             * duplicate sends of the same part.
-             */
-            idempotency_key?: string;
-            /**
-             * Any publicly accessible HTTPS URL to the media file. The server downloads and
-             * sends the file automatically — no pre-upload step required.
-             *
-             * **Size limit:** 10MB maximum for URL-based downloads. For larger files (up to
-             * 100MB), use the pre-upload flow: `POST /v3/attachments` to get a presigned URL,
-             * upload directly, then reference by `attachment_id`.
-             *
-             * **Requirements:**
-             *
-             * - URL must use HTTPS
-             * - File content must be a supported format (the server validates the actual file
-             *   content)
-             *
-             * **Supported formats:**
-             *
-             * - Images: .jpg, .jpeg, .png, .gif, .heic, .heif, .tif, .tiff, .bmp
-             * - Videos: .mp4, .mov, .m4v, .mpeg, .mpg, .3gp
-             * - Audio: .m4a, .mp3, .aac, .caf, .wav, .aiff, .amr
-             * - Documents: .pdf, .txt, .rtf, .csv, .doc, .docx, .xls, .xlsx, .ppt, .pptx,
-             *   .pages, .numbers, .key, .epub, .zip, .html, .htm
-             * - Contact & Calendar: .vcf, .ics
-             *
-             * **Tip:** Audio sent here appears as a regular file attachment. To send audio as
-             * an iMessage voice memo bubble (with inline playback), use
-             * `/v3/chats/{chatId}/voicememo`. For repeated sends of the same file, use
-             * `attachment_id` to avoid redundant downloads.
-             *
-             * Either `url` or `attachment_id` must be provided, but not both.
-             */
-            url?: string;
-        }
-        /**
-         * iMessage effect to apply to this message (screen or bubble effect)
-         */
-        interface Effect {
-            /**
-             * Name of the effect. Common values:
-             *
-             * - Screen effects: confetti, fireworks, lasers, sparkles, celebration, hearts,
-             *   love, balloons, happy_birthday, echo, spotlight
-             * - Bubble effects: slam, loud, gentle, invisible
-             */
-            name?: string;
-            /**
-             * Type of effect
-             */
-            type?: 'screen' | 'bubble';
-        }
-        /**
-         * Reply to another message to create a threaded conversation
-         */
-        interface ReplyTo {
-            /**
-             * The ID of the message to reply to
-             */
-            message_id: string;
-            /**
-             * The specific message part to reply to (0-based index). Defaults to 0 (first
-             * part) if not provided. Use this when replying to a specific part of a multipart
-             * message.
-             */
-            part_index?: number;
-        }
-    }
-}
 export interface ChatUpdateParams {
     /**
      * New display name for the chat (group chats only)
@@ -1028,9 +498,9 @@ export interface ChatSendVoicememoParams {
     voice_memo_url: string;
 }
 export declare namespace Chats {
-    export { type ChatCreateResponse as ChatCreateResponse, type ChatRetrieveResponse as ChatRetrieveResponse, type ChatUpdateResponse as ChatUpdateResponse, type ChatListResponse as ChatListResponse, type ChatSendVoicememoResponse as ChatSendVoicememoResponse, type ChatCreateParams as ChatCreateParams, type ChatUpdateParams as ChatUpdateParams, type ChatListParams as ChatListParams, type ChatSendVoicememoParams as ChatSendVoicememoParams, };
+    export { type Chat as Chat, type MessageContent as MessageContent, type ServiceType as ServiceType, type ChatCreateResponse as ChatCreateResponse, type ChatListResponse as ChatListResponse, type ChatSendVoicememoResponse as ChatSendVoicememoResponse, type ChatCreateParams as ChatCreateParams, type ChatUpdateParams as ChatUpdateParams, type ChatListParams as ChatListParams, type ChatSendVoicememoParams as ChatSendVoicememoParams, };
     export { Participants as Participants, type ParticipantAddResponse as ParticipantAddResponse, type ParticipantRemoveResponse as ParticipantRemoveResponse, type ParticipantAddParams as ParticipantAddParams, type ParticipantRemoveParams as ParticipantRemoveParams, };
     export { Typing as Typing };
-    export { Messages as Messages, type MessageListResponse as MessageListResponse, type MessageSendResponse as MessageSendResponse, type MessageListParams as MessageListParams, type MessageSendParams as MessageSendParams, };
+    export { Messages as Messages, type SentMessage as SentMessage, type MessageListResponse as MessageListResponse, type MessageSendResponse as MessageSendResponse, type MessageListParams as MessageListParams, type MessageSendParams as MessageSendParams, };
 }
 //# sourceMappingURL=chats.d.mts.map