@linqapp/sdk 0.1.0 → 0.1.4

package/src/resources/chats/chats.ts

@@ -1,13 +1,16 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
-import * as MessagesAPI from './messages';
+import * as MessagesAPI from '../messages';
+import * as Shared from '../shared';
+import * as ChatsMessagesAPI from './messages';
 import {
   MessageListParams,
   MessageListResponse,
   MessageSendParams,
   MessageSendResponse,
   Messages,
+  SentMessage,
 } from './messages';
 import * as ParticipantsAPI from './participants';
 import {
@@ -27,7 +30,7 @@ import { path } from '../../internal/utils/path';
 export class Chats extends APIResource {
   participants: ParticipantsAPI.Participants = new ParticipantsAPI.Participants(this._client);
   typing: TypingAPI.Typing = new TypingAPI.Typing(this._client);
-  messages: MessagesAPI.Messages = new MessagesAPI.Messages(this._client);
+  messages: ChatsMessagesAPI.Messages = new ChatsMessagesAPI.Messages(this._client);
 
   /**
    * Create a new chat with specified participants and send an initial message. The
@@ -77,7 +80,7 @@ export class Chats extends APIResource {
    * );
    * ```
    */
-  retrieve(chatID: string, options?: RequestOptions): APIPromise<ChatRetrieveResponse> {
+  retrieve(chatID: string, options?: RequestOptions): APIPromise<Chat> {
     return this._client.get(path`/v3/chats/${chatID}`, options);
   }
 
@@ -92,7 +95,7 @@ export class Chats extends APIResource {
    * );
    * ```
    */
-  update(chatID: string, body: ChatUpdateParams, options?: RequestOptions): APIPromise<ChatUpdateResponse> {
+  update(chatID: string, body: ChatUpdateParams, options?: RequestOptions): APIPromise<Chat> {
     return this._client.put(path`/v3/chats/${chatID}`, { body, ...options });
   }
 
@@ -200,411 +203,7 @@ export class Chats extends APIResource {
   }
 }
 
-/**
- * Response for creating a new chat with an initial message
- */
-export interface ChatCreateResponse {
-  chat: ChatCreateResponse.Chat;
-}
-
-export namespace ChatCreateResponse {
-  export 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';
-  }
-
-  export namespace Chat {
-    export 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)
-     */
-    export 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;
-    }
-
-    export namespace Message {
-      /**
-       * A text message part
-       */
-      export 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;
-      }
-
-      export namespace TextPartResponse {
-        export 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;
-        }
-
-        export namespace Reaction {
-          export 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
-       */
-      export 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;
-      }
-
-      export namespace MediaPartResponse {
-        export 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;
-        }
-
-        export namespace Reaction {
-          export 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)
-       */
-      export 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
-       */
-      export 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
-       */
-      export 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
    */
@@ -625,7 +224,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
@@ -645,156 +244,151 @@ export interface ChatRetrieveResponse {
   /**
    * Messaging service type
    */
-  service?: 'iMessage' | 'SMS' | 'RCS' | null;
-}
-
-export namespace ChatRetrieveResponse {
-  export 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?: Shared.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?: Shared.ServiceType;
 
   /**
-   * Messaging service type
+   * Reply to another message to create a threaded conversation
    */
-  service?: 'iMessage' | 'SMS' | 'RCS' | null;
+  reply_to?: MessagesAPI.ReplyTo;
 }
 
-export namespace ChatUpdateResponse {
-  export interface Handle {
+export namespace MessageContent {
+  export 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;
+  }
 
+  export 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;
+/**
+ * Response for creating a new chat with an initial message
+ */
+export interface ChatCreateResponse {
+  chat: ChatCreateResponse.Chat;
 }
 
-export namespace ChatListResponse {
+export namespace ChatCreateResponse {
   export 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.
@@ -802,15 +396,10 @@ export namespace ChatListResponse {
     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
@@ -818,54 +407,28 @@ export namespace ChatListResponse {
     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;
+    service: Shared.ServiceType;
   }
+}
 
-  export namespace Chat {
-    export 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;
+export interface ChatListResponse {
+  /**
+   * List of chats
+   */
+  chats: Array<Chat>;
 
-      /**
-       * Participant status
-       */
-      status?: 'active' | 'left' | 'removed' | null;
-    }
-  }
+  /**
+   * 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;
 }
 
 /**
@@ -909,7 +472,7 @@ export namespace ChatSendVoicememoResponse {
     /**
      * Messaging service type
      */
-    service?: 'iMessage' | 'SMS' | 'RCS' | null;
+    service?: Shared.ServiceType | null;
   }
 
   export namespace VoiceMemo {
@@ -922,7 +485,7 @@ export namespace ChatSendVoicememoResponse {
       /**
        * Chat participants
        */
-      handles: Array<Chat.Handle>;
+      handles: Array<MessagesAPI.ChatHandle>;
 
       /**
        * Whether the chat is active
@@ -937,46 +500,7 @@ export namespace ChatSendVoicememoResponse {
       /**
        * Messaging service type
        */
-      service: 'iMessage' | 'SMS' | 'RCS';
-    }
-
-    export namespace Chat {
-      export 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: Shared.ServiceType;
     }
 
     export interface VoiceMemo {
@@ -1025,7 +549,7 @@ 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).
@@ -1034,172 +558,6 @@ export interface ChatCreateParams {
   to: Array<string>;
 }
 
-export namespace ChatCreateParams {
-  /**
-   * Message content container. Groups all message-related fields together,
-   * separating the "what" (message content) from the "where" (routing fields like
-   * from/to).
-   */
-  export 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;
-  }
-
-  export namespace Message {
-    export 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;
-    }
-
-    export 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)
-     */
-    export 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
-     */
-    export 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)
@@ -1250,9 +608,9 @@ Chats.Messages = Messages;
 
 export declare namespace Chats {
   export {
+    type Chat as Chat,
+    type MessageContent as MessageContent,
     type ChatCreateResponse as ChatCreateResponse,
-    type ChatRetrieveResponse as ChatRetrieveResponse,
-    type ChatUpdateResponse as ChatUpdateResponse,
     type ChatListResponse as ChatListResponse,
     type ChatSendVoicememoResponse as ChatSendVoicememoResponse,
     type ChatCreateParams as ChatCreateParams,
@@ -1273,6 +631,7 @@ export declare namespace Chats {
 
   export {
     Messages as Messages,
+    type SentMessage as SentMessage,
     type MessageListResponse as MessageListResponse,
     type MessageSendResponse as MessageSendResponse,
     type MessageListParams as MessageListParams,