telnyx 6.68.0 → 6.70.0

package/resources/voice-sdk-call-reports.d.ts

@@ -0,0 +1,438 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { DefaultFlatPagination, type DefaultFlatPaginationParams, PagePromise } from "../core/pagination.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Retrieve raw Voice SDK call report stats payloads for WebRTC call troubleshooting.
+ */
+export declare class VoiceSDKCallReports extends APIResource {
+    /**
+     * Returns raw call report stats JSON payloads stored for the authenticated user
+     * and `call_id`. The user is derived from Telnyx authentication, not from request
+     * parameters.
+     */
+    retrieve(callID: string, options?: RequestOptions): APIPromise<VoiceSDKCallReportRetrieveResponse>;
+    /**
+     * Returns paginated raw call report stats JSON payloads stored for the
+     * authenticated user. The user is derived from Telnyx authentication, not from
+     * request parameters.
+     */
+    list(query?: VoiceSDKCallReportListParams | null | undefined, options?: RequestOptions): PagePromise<VoiceSDKCallReportListResponsesDefaultFlatPagination, VoiceSDKCallReportListResponse>;
+}
+export type VoiceSDKCallReportListResponsesDefaultFlatPagination = DefaultFlatPagination<VoiceSDKCallReportListResponse>;
+/**
+ * Raw Voice SDK call report stats payloads as stored by voice-sdk-debug.
+ */
+export type VoiceSDKCallReportRetrieveResponse = Array<VoiceSDKCallReportRetrieveResponse.VoiceSDKCallReportRetrieveResponseItem>;
+export declare namespace VoiceSDKCallReportRetrieveResponse {
+    /**
+     * A raw call report stats JSON payload. The schema is intentionally permissive
+     * because Voice SDK clients can add fields over time.
+     */
+    interface VoiceSDKCallReportRetrieveResponseItem {
+        /**
+         * Unique call identifier.
+         */
+        call_id?: string;
+        /**
+         * User-scoped storage grouping identifier derived from the authenticated user.
+         * This is not a unique per-call report identifier and may be shared by multiple
+         * calls for the same user.
+         */
+        call_report_id?: string;
+        /**
+         * Creation timestamp when present.
+         */
+        created_at?: string;
+        /**
+         * Reason the SDK flushed this stats report segment, for example an intermediate
+         * socket-close flush.
+         */
+        flushReason?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Raw logs payload emitted by the Voice SDK and stored without normalization. Live
+         * responses commonly return an array of log entries, but object-shaped log
+         * payloads are also allowed for compatibility.
+         */
+        logs?: Array<VoiceSDKCallReportRetrieveResponseItem.UnionMember0> | VoiceSDKCallReportRetrieveResponseItem.Entries;
+        /**
+         * Organization associated with the stored call report when provided by the Voice
+         * SDK reporting path.
+         */
+        organization_id?: string;
+        /**
+         * Zero-based stats segment index when the SDK sends segmented or intermediate
+         * reports.
+         */
+        segment?: number;
+        /**
+         * Raw stats payload emitted by the Voice SDK and stored without normalization. The
+         * exact shape can vary by SDK platform and version. Live responses commonly return
+         * an array of interval snapshots, but object-shaped stats payloads are also
+         * allowed for compatibility.
+         */
+        stats?: Array<{
+            [key: string]: unknown;
+        }> | VoiceSDKCallReportRetrieveResponseItem.UnionMember1;
+        /**
+         * Time when the call report was stored.
+         */
+        stored_at?: string;
+        /**
+         * High-level call metadata.
+         */
+        summary?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Telnyx call leg identifier for correlating the report with call-control, SIP,
+         * and media troubleshooting data.
+         */
+        telnyx_leg_id?: string;
+        /**
+         * Telnyx RTC session identifier for correlating the report with Voice SDK
+         * signaling and media-session logs.
+         */
+        telnyx_session_id?: string;
+        /**
+         * Voice SDK user agent string reported by the client. This is the preferred
+         * SDK/platform/version dimension when present.
+         */
+        user_agent?: string;
+        /**
+         * Authenticated user that owns the call report.
+         */
+        user_id?: string;
+        /**
+         * Legacy SDK version value when the client reports one separately from the user
+         * agent.
+         */
+        version?: string;
+        /**
+         * Voice SDK instance identifier.
+         */
+        voice_sdk_id?: string;
+        /**
+         * Decoded Voice SDK identifier metadata emitted by voice-sdk-proxy when available.
+         */
+        voice_sdk_id_decoded?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Voice SDK session correlation identifier used to group stats segments for the
+         * same SDK session.
+         */
+        voice_sdk_session_id?: string;
+        [k: string]: unknown;
+    }
+    namespace VoiceSDKCallReportRetrieveResponseItem {
+        /**
+         * A raw Voice SDK log entry. Additional SDK-specific fields may be present.
+         */
+        interface UnionMember0 {
+            /**
+             * Raw structured context attached to the log entry.
+             */
+            context?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Log level emitted by the SDK.
+             */
+            level?: 'debug' | 'info' | 'warn' | 'error';
+            /**
+             * Log message.
+             */
+            message?: string;
+            /**
+             * Time when the log entry was emitted.
+             */
+            timestamp?: string;
+            [k: string]: unknown;
+        }
+        /**
+         * Raw logs object emitted by the Voice SDK when logs are grouped under an entries
+         * field.
+         */
+        interface Entries {
+            /**
+             * Raw log entries when the SDK groups logs under an entries field.
+             */
+            entries?: Array<Entries.Entry>;
+            [k: string]: unknown;
+        }
+        namespace Entries {
+            /**
+             * A raw Voice SDK log entry. Additional SDK-specific fields may be present.
+             */
+            interface Entry {
+                /**
+                 * Raw structured context attached to the log entry.
+                 */
+                context?: {
+                    [key: string]: unknown;
+                };
+                /**
+                 * Log level emitted by the SDK.
+                 */
+                level?: 'debug' | 'info' | 'warn' | 'error';
+                /**
+                 * Log message.
+                 */
+                message?: string;
+                /**
+                 * Time when the log entry was emitted.
+                 */
+                timestamp?: string;
+                [k: string]: unknown;
+            }
+        }
+        /**
+         * Raw stats object emitted by the Voice SDK.
+         */
+        interface UnionMember1 {
+            /**
+             * Raw audio stats such as inbound/outbound packet, byte, jitter, packet-loss,
+             * bitrate, and audio-level metrics.
+             */
+            audio?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Raw connection stats such as round-trip time, packets, and bytes sent or
+             * received.
+             */
+            connection?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Raw ICE candidate-pair information, including selected pair, local/remote
+             * candidates, state, and nomination data when provided by the SDK.
+             */
+            ice?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Raw transport stats such as ICE state, DTLS state, SRTP cipher, TLS version, and
+             * selected-candidate-pair changes.
+             */
+            transport?: {
+                [key: string]: unknown;
+            };
+            [k: string]: unknown;
+        }
+    }
+}
+/**
+ * A raw call report stats JSON payload. The schema is intentionally permissive
+ * because Voice SDK clients can add fields over time.
+ */
+export interface VoiceSDKCallReportListResponse {
+    /**
+     * Unique call identifier.
+     */
+    call_id?: string;
+    /**
+     * User-scoped storage grouping identifier derived from the authenticated user.
+     * This is not a unique per-call report identifier and may be shared by multiple
+     * calls for the same user.
+     */
+    call_report_id?: string;
+    /**
+     * Creation timestamp when present.
+     */
+    created_at?: string;
+    /**
+     * Reason the SDK flushed this stats report segment, for example an intermediate
+     * socket-close flush.
+     */
+    flushReason?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Raw logs payload emitted by the Voice SDK and stored without normalization. Live
+     * responses commonly return an array of log entries, but object-shaped log
+     * payloads are also allowed for compatibility.
+     */
+    logs?: Array<VoiceSDKCallReportListResponse.UnionMember0> | VoiceSDKCallReportListResponse.Entries;
+    /**
+     * Organization associated with the stored call report when provided by the Voice
+     * SDK reporting path.
+     */
+    organization_id?: string;
+    /**
+     * Zero-based stats segment index when the SDK sends segmented or intermediate
+     * reports.
+     */
+    segment?: number;
+    /**
+     * Raw stats payload emitted by the Voice SDK and stored without normalization. The
+     * exact shape can vary by SDK platform and version. Live responses commonly return
+     * an array of interval snapshots, but object-shaped stats payloads are also
+     * allowed for compatibility.
+     */
+    stats?: Array<{
+        [key: string]: unknown;
+    }> | VoiceSDKCallReportListResponse.UnionMember1;
+    /**
+     * Time when the call report was stored.
+     */
+    stored_at?: string;
+    /**
+     * High-level call metadata.
+     */
+    summary?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Telnyx call leg identifier for correlating the report with call-control, SIP,
+     * and media troubleshooting data.
+     */
+    telnyx_leg_id?: string;
+    /**
+     * Telnyx RTC session identifier for correlating the report with Voice SDK
+     * signaling and media-session logs.
+     */
+    telnyx_session_id?: string;
+    /**
+     * Voice SDK user agent string reported by the client. This is the preferred
+     * SDK/platform/version dimension when present.
+     */
+    user_agent?: string;
+    /**
+     * Authenticated user that owns the call report.
+     */
+    user_id?: string;
+    /**
+     * Legacy SDK version value when the client reports one separately from the user
+     * agent.
+     */
+    version?: string;
+    /**
+     * Voice SDK instance identifier.
+     */
+    voice_sdk_id?: string;
+    /**
+     * Decoded Voice SDK identifier metadata emitted by voice-sdk-proxy when available.
+     */
+    voice_sdk_id_decoded?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Voice SDK session correlation identifier used to group stats segments for the
+     * same SDK session.
+     */
+    voice_sdk_session_id?: string;
+    [k: string]: unknown;
+}
+export declare namespace VoiceSDKCallReportListResponse {
+    /**
+     * A raw Voice SDK log entry. Additional SDK-specific fields may be present.
+     */
+    interface UnionMember0 {
+        /**
+         * Raw structured context attached to the log entry.
+         */
+        context?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Log level emitted by the SDK.
+         */
+        level?: 'debug' | 'info' | 'warn' | 'error';
+        /**
+         * Log message.
+         */
+        message?: string;
+        /**
+         * Time when the log entry was emitted.
+         */
+        timestamp?: string;
+        [k: string]: unknown;
+    }
+    /**
+     * Raw logs object emitted by the Voice SDK when logs are grouped under an entries
+     * field.
+     */
+    interface Entries {
+        /**
+         * Raw log entries when the SDK groups logs under an entries field.
+         */
+        entries?: Array<Entries.Entry>;
+        [k: string]: unknown;
+    }
+    namespace Entries {
+        /**
+         * A raw Voice SDK log entry. Additional SDK-specific fields may be present.
+         */
+        interface Entry {
+            /**
+             * Raw structured context attached to the log entry.
+             */
+            context?: {
+                [key: string]: unknown;
+            };
+            /**
+             * Log level emitted by the SDK.
+             */
+            level?: 'debug' | 'info' | 'warn' | 'error';
+            /**
+             * Log message.
+             */
+            message?: string;
+            /**
+             * Time when the log entry was emitted.
+             */
+            timestamp?: string;
+            [k: string]: unknown;
+        }
+    }
+    /**
+     * Raw stats object emitted by the Voice SDK.
+     */
+    interface UnionMember1 {
+        /**
+         * Raw audio stats such as inbound/outbound packet, byte, jitter, packet-loss,
+         * bitrate, and audio-level metrics.
+         */
+        audio?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Raw connection stats such as round-trip time, packets, and bytes sent or
+         * received.
+         */
+        connection?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Raw ICE candidate-pair information, including selected pair, local/remote
+         * candidates, state, and nomination data when provided by the SDK.
+         */
+        ice?: {
+            [key: string]: unknown;
+        };
+        /**
+         * Raw transport stats such as ICE state, DTLS state, SRTP cipher, TLS version, and
+         * selected-candidate-pair changes.
+         */
+        transport?: {
+            [key: string]: unknown;
+        };
+        [k: string]: unknown;
+    }
+}
+export interface VoiceSDKCallReportListParams extends DefaultFlatPaginationParams {
+    /**
+     * Set the order of the results by creation date. `asc` and `created_at` sort
+     * oldest reports first; `desc` and `-created_at` sort newest reports first. If not
+     * given, results are sorted by creation date in descending order.
+     */
+    sort?: 'asc' | 'desc' | 'created_at' | '-created_at';
+}
+export declare namespace VoiceSDKCallReports {
+    export { type VoiceSDKCallReportRetrieveResponse as VoiceSDKCallReportRetrieveResponse, type VoiceSDKCallReportListResponse as VoiceSDKCallReportListResponse, type VoiceSDKCallReportListResponsesDefaultFlatPagination as VoiceSDKCallReportListResponsesDefaultFlatPagination, type VoiceSDKCallReportListParams as VoiceSDKCallReportListParams, };
+}
+//# sourceMappingURL=voice-sdk-call-reports.d.ts.map

package/resources/voice-sdk-call-reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-sdk-call-reports.d.ts","sourceRoot":"","sources":["../src/resources/voice-sdk-call-reports.ts"],"names":[],"mappings":"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"}

package/resources/voice-sdk-call-reports.js

@@ -0,0 +1,30 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoiceSDKCallReports = void 0;
+const resource_1 = require("../core/resource.js");
+const pagination_1 = require("../core/pagination.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Retrieve raw Voice SDK call report stats payloads for WebRTC call troubleshooting.
+ */
+class VoiceSDKCallReports extends resource_1.APIResource {
+    /**
+     * Returns raw call report stats JSON payloads stored for the authenticated user
+     * and `call_id`. The user is derived from Telnyx authentication, not from request
+     * parameters.
+     */
+    retrieve(callID, options) {
+        return this._client.get((0, path_1.path) `/voice_sdk_call_reports/${callID}`, options);
+    }
+    /**
+     * Returns paginated raw call report stats JSON payloads stored for the
+     * authenticated user. The user is derived from Telnyx authentication, not from
+     * request parameters.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/voice_sdk_call_reports', (pagination_1.DefaultFlatPagination), { query, ...options });
+    }
+}
+exports.VoiceSDKCallReports = VoiceSDKCallReports;
+//# sourceMappingURL=voice-sdk-call-reports.js.map

package/resources/voice-sdk-call-reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-sdk-call-reports.js","sourceRoot":"","sources":["../src/resources/voice-sdk-call-reports.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAE/C,sDAA0G;AAE1G,oDAA8C;AAE9C;;GAEG;AACH,MAAa,mBAAoB,SAAQ,sBAAW;IAClD;;;;OAIG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,2BAA2B,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;OAIG;IACH,IAAI,CACF,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,yBAAyB,EACzB,CAAA,kCAAqD,CAAA,EACrD,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;CACF;AAzBD,kDAyBC"}

package/resources/voice-sdk-call-reports.mjs

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { DefaultFlatPagination } from "../core/pagination.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Retrieve raw Voice SDK call report stats payloads for WebRTC call troubleshooting.
+ */
+export class VoiceSDKCallReports extends APIResource {
+    /**
+     * Returns raw call report stats JSON payloads stored for the authenticated user
+     * and `call_id`. The user is derived from Telnyx authentication, not from request
+     * parameters.
+     */
+    retrieve(callID, options) {
+        return this._client.get(path `/voice_sdk_call_reports/${callID}`, options);
+    }
+    /**
+     * Returns paginated raw call report stats JSON payloads stored for the
+     * authenticated user. The user is derived from Telnyx authentication, not from
+     * request parameters.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/voice_sdk_call_reports', (DefaultFlatPagination), { query, ...options });
+    }
+}
+//# sourceMappingURL=voice-sdk-call-reports.mjs.map

package/resources/voice-sdk-call-reports.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-sdk-call-reports.mjs","sourceRoot":"","sources":["../src/resources/voice-sdk-call-reports.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAE/C,OAAO,EAAE,qBAAqB,EAAiD,+BAA2B;AAE1G,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD;;;;OAIG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,2BAA2B,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;OAIG;IACH,IAAI,CACF,QAAyD,EAAE,EAC3D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,yBAAyB,EACzB,CAAA,qBAAqD,CAAA,EACrD,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;CACF"}

package/src/client.ts

@@ -958,6 +958,13 @@ import {
   VoiceDesignRetrieveResponse,
   VoiceDesigns,
 } from './resources/voice-designs';
+import {
+  VoiceSDKCallReportListParams,
+  VoiceSDKCallReportListResponse,
+  VoiceSDKCallReportListResponsesDefaultFlatPagination,
+  VoiceSDKCallReportRetrieveResponse,
+  VoiceSDKCallReports,
+} from './resources/voice-sdk-call-reports';
 import {
   Attempt,
   HTTP,
@@ -2969,6 +2976,10 @@ export class Telnyx {
    * UAC connection operations
    */
   uacConnections: API.UacConnections = new API.UacConnections(this);
+  /**
+   * Retrieve raw Voice SDK call report stats payloads for WebRTC call troubleshooting.
+   */
+  voiceSDKCallReports: API.VoiceSDKCallReports = new API.VoiceSDKCallReports(this);
 }
 
 Telnyx.Legacy = Legacy;
@@ -3135,6 +3146,7 @@ Telnyx.Reputation = Reputation;
 Telnyx.TermsOfService = TermsOfService;
 Telnyx.PronunciationDicts = PronunciationDicts;
 Telnyx.UacConnections = UacConnections;
+Telnyx.VoiceSDKCallReports = VoiceSDKCallReports;
 
 export declare namespace Telnyx {
   export type RequestOptions = Opts.RequestOptions;
@@ -4915,6 +4927,14 @@ export declare namespace Telnyx {
     type UacConnectionListParams as UacConnectionListParams,
   };
 
+  export {
+    VoiceSDKCallReports as VoiceSDKCallReports,
+    type VoiceSDKCallReportRetrieveResponse as VoiceSDKCallReportRetrieveResponse,
+    type VoiceSDKCallReportListResponse as VoiceSDKCallReportListResponse,
+    type VoiceSDKCallReportListResponsesDefaultFlatPagination as VoiceSDKCallReportListResponsesDefaultFlatPagination,
+    type VoiceSDKCallReportListParams as VoiceSDKCallReportListParams,
+  };
+
   export type APIError = API.APIError;
   export type AvailablePhoneNumbersMetadata = API.AvailablePhoneNumbersMetadata;
   export type AzureVoiceSettings = API.AzureVoiceSettings;

package/src/resources/ai/assistants/assistants.ts

@@ -1608,6 +1608,13 @@ export namespace TelephonySettings {
      * The format of the recording file.
      */
     format?: 'wav' | 'mp3';
+
+    /**
+     * When enabled, the call recording will stop when the conversation ends (for
+     * example, when the assistant hangs up or the call is transferred). When disabled,
+     * recording continues until the call itself ends.
+     */
+    stop_on_conversation_end?: boolean;
   }
 
   /**

package/src/resources/calls/actions.ts

@@ -3028,8 +3028,8 @@ export interface ActionGatherUsingSpeakParams {
    *   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
    *   to configure speed, volume, pitch, and language_boost.
    * - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-   *   Supported model_ids: `Arcana`, `Mist`. Use `voice_settings` to configure
-   *   voice_speed.
+   *   Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
+   *   `voice_settings` to configure voice_speed.
    * - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
    *   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
    *   `voice_settings` to configure precision, sample_rate, and format.
@@ -3438,8 +3438,8 @@ export interface ActionSpeakParams {
    *   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
    *   to configure speed, volume, pitch, and language_boost.
    * - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-   *   Supported model_ids: `Arcana`, `Mist`. Use `voice_settings` to configure
-   *   voice_speed.
+   *   Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
+   *   `voice_settings` to configure voice_speed.
    * - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
    *   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
    *   `voice_settings` to configure precision, sample_rate, and format.

package/src/resources/conferences/actions.ts

@@ -933,8 +933,8 @@ export interface ActionSpeakParams {
    *   `speech-02-hd`, `speech-2.6-turbo`, `speech-2.8-turbo`. Use `voice_settings`
    *   to configure speed, volume, pitch, and language_boost.
    * - **Rime:** Use `Rime.<model_id>.<voice_id>` (e.g., `Rime.Arcana.cove`).
-   *   Supported model_ids: `Arcana`, `Mist`. Use `voice_settings` to configure
-   *   voice_speed.
+   *   Supported model_ids: `Arcana`, `Mist`, `ArcanaV3`, `Coda`. Use
+   *   `voice_settings` to configure voice_speed.
    * - **Resemble:** Use `Resemble.Turbo.<voice_id>` (e.g.,
    *   `Resemble.Turbo.my_voice`). Only `Turbo` model is supported. Use
    *   `voice_settings` to configure precision, sample_rate, and format.

package/src/resources/index.ts

@@ -1362,6 +1362,13 @@ export {
   type VoiceDesignRenameParams,
   type VoiceDesignListResponsesDefaultFlatPagination,
 } from './voice-designs';
+export {
+  VoiceSDKCallReports,
+  type VoiceSDKCallReportRetrieveResponse,
+  type VoiceSDKCallReportListResponse,
+  type VoiceSDKCallReportListParams,
+  type VoiceSDKCallReportListResponsesDefaultFlatPagination,
+} from './voice-sdk-call-reports';
 export {
   WebhookDeliveries,
   type Attempt,

package/src/resources/messages/messages.ts

@@ -293,6 +293,11 @@ export interface OutboundMessagePayload {
    */
   messaging_profile_id?: string;
 
+  /**
+   * The number of characters in the message text
+   */
+  num_chars?: number;
+
   /**
    * The id of the organization the messaging profile belongs to.
    */
@@ -1304,6 +1309,11 @@ export interface MessageCancelScheduledResponse {
    */
   messaging_profile_id?: string;
 
+  /**
+   * The number of characters in the message text
+   */
+  num_chars?: number;
+
   /**
    * The id of the organization the messaging profile belongs to.
    */

package/src/resources/shared.ts

@@ -400,6 +400,11 @@ export interface InboundMessagePayload {
    */
   messaging_profile_id?: string;
 
+  /**
+   * The number of characters in the message text
+   */
+  num_chars?: number;
+
   /**
    * Unique identifier for a messaging profile.
    */