telnyx 7.23.0 → 7.24.0

package/src/resources/ai/memory/namespaces/profiles/sources.ts

@@ -0,0 +1,226 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../../core/resource';
+import * as SourcesAPI from '../../../collections/sources';
+import { SourcesDefaultFlatPagination } from '../../../collections/sources';
+import { APIPromise } from '../../../../../core/api-promise';
+import {
+  DefaultFlatPagination,
+  type DefaultFlatPaginationParams,
+  PagePromise,
+} from '../../../../../core/pagination';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
+
+/**
+ * What a profile stored, and what its memories came from.
+ */
+export class Sources extends APIResource {
+  /**
+   * Everything a profile has stored and extracts memories from: each ingested
+   * session, and each remembered fact, which has no session. Content is not listed;
+   * read one source for it. A source whose ingest is still queued is not here yet.
+   * Re-ingesting a session moves it to the front, so a listing paged while sessions
+   * are written can repeat or miss one at a page boundary. A `session_id` narrows
+   * the listing to the source that session was stored as: one source or none, and
+   * none -- an empty page, not a 404 -- for a session never ingested, still queued,
+   * or another profile's.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const source of client.ai.memory.namespaces.profiles.sources.list(
+   *   'profile_id',
+   *   { namespace: 'namespace' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    profileID: string,
+    params: SourceListParams,
+    options?: RequestOptions,
+  ): PagePromise<SourcesDefaultFlatPagination, SourcesAPI.Source> {
+    const { namespace, ...query } = params;
+    return this._client.getAPIList(
+      path`/ai/memory/namespaces/${namespace}/profiles/${profileID}/sources`,
+      DefaultFlatPagination<SourcesAPI.Source>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Deletes one source -- an ingested session or a remembered fact -- together with
+   * the memories derived from it. A memory derived from this source and others is
+   * deleted too, and derived again from what remains in the background. It answers
+   * only once the source is gone. A source that is not there -- never stored,
+   * another profile's, or already deleted -- answers 404, so on a `502` or a `504`
+   * repeat the identical request and read a 404 as done. An ingest of the same
+   * session that is still queued is not cancelled, and stores the session again when
+   * it runs. Nothing here can be undone.
+   *
+   * @example
+   * ```ts
+   * const source =
+   *   await client.ai.memory.namespaces.profiles.sources.delete(
+   *     'source_id',
+   *     { namespace: 'namespace', profile_id: 'profile_id' },
+   *   );
+   * ```
+   */
+  delete(
+    sourceID: string,
+    params: SourceDeleteParams,
+    options?: RequestOptions,
+  ): APIPromise<SourceDeleteResponse> {
+    const { namespace, profile_id } = params;
+    return this._client.delete(
+      path`/ai/memory/namespaces/${namespace}/profiles/${profile_id}/sources/${sourceID}`,
+      options,
+    );
+  }
+
+  /**
+   * One source and its content, as it was stored: an ingested session's payload or a
+   * remembered fact. A source whose ingest is still queued answers 404 until it has
+   * been stored.
+   *
+   * @example
+   * ```ts
+   * const source =
+   *   await client.ai.memory.namespaces.profiles.sources.retrieve(
+   *     'source_id',
+   *     { namespace: 'namespace', profile_id: 'profile_id' },
+   *   );
+   * ```
+   */
+  retrieve(
+    sourceID: string,
+    params: SourceRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<SourceRetrieveResponse> {
+    const { namespace, profile_id } = params;
+    return this._client.get(
+      path`/ai/memory/namespaces/${namespace}/profiles/${profile_id}/sources/${sourceID}`,
+      options,
+    );
+  }
+}
+
+export interface SourceRetrieveResponse {
+  data: SourceRetrieveResponse.Data;
+}
+
+export namespace SourceRetrieveResponse {
+  export interface Data {
+    /**
+     * Identifies one source within its profile: an ingested session, or one remembered
+     * fact. Returned by `ingest` and `remember` when the write is accepted.
+     * Re-ingesting a session keeps its source id.
+     */
+    id: string;
+
+    /**
+     * What was stored, in the shape it was sent: an ingested JSON body as JSON, a
+     * string body or a remembered fact as a string. A session ingested before formats
+     * were recorded is returned as the text it was stored as.
+     */
+    content: { [key: string]: unknown } | Array<unknown> | string | number | boolean;
+
+    /**
+     * Memories extracted from this source. A memory derived from several sources is
+     * not counted here.
+     */
+    memory_count: number;
+
+    /**
+     * The session this source was ingested as. Null for a remembered fact.
+     */
+    session_id: string | null;
+
+    /**
+     * When the source was first stored.
+     */
+    created_at?: string | null;
+
+    /**
+     * When the source was last written; re-ingesting moves it.
+     */
+    updated_at?: string | null;
+  }
+}
+
+export interface SourceDeleteResponse {
+  data: SourceDeleteResponse.Data;
+}
+
+export namespace SourceDeleteResponse {
+  export interface Data {
+    /**
+     * Memories the profile held and no longer does, counted before and after across
+     * the whole profile: it includes memories derived from this source together with
+     * others, and anything else the profile lost in between. A report rather than an
+     * audit. The status carries the outcome.
+     */
+    memories_deleted: number;
+
+    profile_id: string;
+
+    /**
+     * Identifies one source within its profile: an ingested session, or one remembered
+     * fact. Returned by `ingest` and `remember` when the write is accepted.
+     * Re-ingesting a session keeps its source id.
+     */
+    source_id: string;
+  }
+}
+
+export interface SourceListParams extends DefaultFlatPaginationParams {
+  /**
+   * Path param
+   */
+  namespace: string;
+
+  /**
+   * Query param: An ingested session, by the `session_id` it was ingested with.
+   * Narrows the request to the source that session was stored as.
+   */
+  session_id?: string | null;
+}
+
+export interface SourceDeleteParams {
+  /**
+   * The namespace. `default` exists for every organization.
+   */
+  namespace: string;
+
+  /**
+   * The profile: your identifier for the user, caller or agent this memory is about.
+   */
+  profile_id: string;
+}
+
+export interface SourceRetrieveParams {
+  /**
+   * The namespace. `default` exists for every organization.
+   */
+  namespace: string;
+
+  /**
+   * The profile: your identifier for the user, caller or agent this memory is about.
+   */
+  profile_id: string;
+}
+
+export declare namespace Sources {
+  export {
+    type SourceRetrieveResponse as SourceRetrieveResponse,
+    type SourceDeleteResponse as SourceDeleteResponse,
+    type SourceListParams as SourceListParams,
+    type SourceDeleteParams as SourceDeleteParams,
+    type SourceRetrieveParams as SourceRetrieveParams,
+  };
+}
+
+export { type SourcesDefaultFlatPagination };

package/src/resources/ai/memory/namespaces/profiles.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './profiles/index';

package/src/resources/ai/memory/namespaces/settings.ts

@@ -0,0 +1,129 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import { APIPromise } from '../../../../core/api-promise';
+import { RequestOptions } from '../../../../internal/request-options';
+import { path } from '../../../../internal/utils/path';
+
+/**
+ * How a namespace's summaries are written.
+ */
+export class Settings extends APIResource {
+  /**
+   * What is currently set for this namespace. `instructions: null` means none are
+   * set and summaries use the neutral default.
+   *
+   * @example
+   * ```ts
+   * const namespaceSettingsResponse =
+   *   await client.ai.memory.namespaces.settings.list(
+   *     'namespace',
+   *   );
+   * ```
+   */
+  list(namespace: string, options?: RequestOptions): APIPromise<NamespaceSettingsResponse> {
+    return this._client.get(path`/ai/memory/namespaces/${namespace}/settings`, options);
+  }
+
+  /**
+   * Only the fields you send are changed; anything omitted is left as it is, so `{}`
+   * changes nothing. Sending `instructions: null`, or an empty or whitespace-only
+   * string, clears them and returns summaries to the neutral default.
+   *
+   * Instructions are capped at 2000 characters. A longer note is refused rather than
+   * truncated, because a note cut mid-sentence is a worse steer than none. A change
+   * reaches each summary the next time that summary is regenerated, not immediately.
+   *
+   * @example
+   * ```ts
+   * const namespaceSettingsResponse =
+   *   await client.ai.memory.namespaces.settings.patchAll(
+   *     'namespace',
+   *     {
+   *       summary: {
+   *         instructions:
+   *           "Lead with the customer's plan tier. Keep it under 100 words.",
+   *       },
+   *     },
+   *   );
+   * ```
+   */
+  patchAll(
+    namespace: string,
+    body: SettingPatchAllParams,
+    options?: RequestOptions,
+  ): APIPromise<NamespaceSettingsResponse> {
+    return this._client.patch(path`/ai/memory/namespaces/${namespace}/settings`, { body, ...options });
+  }
+}
+
+export interface NamespaceSettingsResponse {
+  /**
+   * A namespace's settings, grouped by what they affect.
+   */
+  data: NamespaceSettingsResponse.Data;
+}
+
+export namespace NamespaceSettingsResponse {
+  /**
+   * A namespace's settings, grouped by what they affect.
+   */
+  export interface Data {
+    /**
+     * Settings that shape this namespace's summaries.
+     */
+    summary?: Data.Summary;
+  }
+
+  export namespace Data {
+    /**
+     * Settings that shape this namespace's summaries.
+     */
+    export interface Summary {
+      /**
+       * Free-form instructions that influence how this namespace's summaries are
+       * written, shared by every profile in the namespace. How you use them is up to you
+       * -- they steer the outcome, so try a phrasing and see how the summary comes out.
+       * Advisory: they steer the summary but never override or deny a profile's own
+       * facts, and they do not affect recall. Null or empty means none are set, and
+       * summaries use the neutral default. A change reaches each summary the next time
+       * it is regenerated.
+       */
+      instructions?: string | null;
+    }
+  }
+}
+
+export interface SettingPatchAllParams {
+  /**
+   * A partial update to a namespace's summary settings.
+   *
+   * Only the fields present in the request are changed; the rest are left as they
+   * are. Sending `instructions: null` (or empty) clears the instructions.
+   */
+  summary?: SettingPatchAllParams.Summary | null;
+}
+
+export namespace SettingPatchAllParams {
+  /**
+   * A partial update to a namespace's summary settings.
+   *
+   * Only the fields present in the request are changed; the rest are left as they
+   * are. Sending `instructions: null` (or empty) clears the instructions.
+   */
+  export interface Summary {
+    /**
+     * Replace the namespace's summary instructions. Null or empty clears them and
+     * returns to the neutral default. Omit the field to leave the current instructions
+     * unchanged.
+     */
+    instructions?: string | null;
+  }
+}
+
+export declare namespace Settings {
+  export {
+    type NamespaceSettingsResponse as NamespaceSettingsResponse,
+    type SettingPatchAllParams as SettingPatchAllParams,
+  };
+}

package/src/resources/ai/memory/namespaces.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './namespaces/index';

package/src/resources/ai/memory.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './memory/index';

package/src/resources/ai/typesafe/v1.ts

@@ -5,29 +5,33 @@ import { APIPromise } from '../../../core/api-promise';
 import { RequestOptions } from '../../../internal/request-options';
 
 /**
- * Beta API for evaluating shared context with typed questions and structured answers. Telnyx manages model selection.
+ * Beta API for evaluating shared context with typed questions and structured answers using Flash or Pro.
  */
 export class V1 extends APIResource {
   /**
-   * **Beta API.** Telnyx controls model selection.
+   * **Beta API.** Choose telnyx/decision-flash for the lowest cost and latency, or
+   * telnyx/decision-pro for decisions that require long context, including inputs
+   * beyond Jev’s 32k per-decision limit. Omitted model defaults to
+   * telnyx/decision-flash.
    *
    * Evaluate shared context using named choice, noul (yes/no), and score questions.
-   * Returns TypeSafe System One-compatible answer shapes, an opaque compatibility
-   * identifier, and token usage. See the
+   * Returns TypeSafe System One-compatible answer shapes, the selected public model
+   * alias, and token usage. See the
    * [decision model guide](https://developers.telnyx.com/docs/inference/decision-models)
    * for examples and compatibility limits.
    *
    * The supported request subset requires instructions for every question, string
    * descriptions for criteria (or null for choice descriptions), 1–64 questions, and
-   * 2–64 options for choice and score questions. The SDK-supplied model value is
-   * ignored and cannot select a model. Other unknown fields are rejected. The
-   * endpoint is synchronous and does not stream.
+   * 2–64 options for choice and score questions. The model field accepts only
+   * telnyx/decision-flash or telnyx/decision-pro. Unsupported model values and
+   * unknown fields are rejected. The endpoint is synchronous and does not stream.
    *
    * Use the TypeSafe Python SDK with base_url set to
    * https://api.telnyx.com/v2/ai/typesafe and a Telnyx API key. The SDK appends
-   * /v1/systemone. Compatibility covers this operation and the documented request
-   * subset; it does not include TypeSafe model listing. Scores describe relative
-   * preference, not calibrated correctness.
+   * /v1/systemone; explicitly set model to a supported Telnyx alias because its own
+   * default model is not supported. Compatibility covers this operation and the
+   * documented request subset; it does not include TypeSafe model listing. Scores
+   * describe relative preference, not calibrated correctness.
    *
    * @example
    * ```ts
@@ -57,6 +61,7 @@ export class V1 extends APIResource {
    *   },
    *   state:
    *     'Our production calls are failing. Every customer is affected.',
+   *   model: 'telnyx/decision-flash',
    * });
    * ```
    */
@@ -82,11 +87,10 @@ export interface V1SystemoneResponse {
   };
 
   /**
-   * Opaque Telnyx-controlled identifier retained for TypeSafe SDK response
-   * compatibility. It is not a selectable model name or a guarantee of a particular
-   * underlying model.
+   * Public model alias used to evaluate the request. Returns telnyx/decision-flash
+   * when model was omitted. The underlying model is managed by Telnyx.
    */
-  model: string;
+  model: 'telnyx/decision-flash' | 'telnyx/decision-pro';
 
   /**
    * Token usage for the completed evaluation.
@@ -208,6 +212,14 @@ export interface V1SystemoneParams {
    * Shared context evaluated by every question.
    */
   state: string | { [key: string]: unknown } | Array<unknown>;
+
+  /**
+   * Public model alias. telnyx/decision-flash offers the lowest cost and latency;
+   * telnyx/decision-pro supports decisions that require long context, including
+   * inputs beyond Jev’s 32k per-decision limit. Applies to every question in the
+   * request. Other values are rejected.
+   */
+  model?: 'telnyx/decision-flash' | 'telnyx/decision-pro';
 }
 
 export namespace V1SystemoneParams {

package/src/resources/calls/actions.ts

@@ -1483,6 +1483,23 @@ export namespace PayPromptValue {
   }
 }
 
+export interface SonioxVoiceSettings {
+  /**
+   * Voice settings provider type
+   */
+  type: 'soniox';
+
+  /**
+   * Shortens the pauses between words.
+   */
+  reduce_silence?: boolean;
+
+  /**
+   * Speaking rate. 1.0 is normal speed.
+   */
+  speed?: number;
+}
+
 export interface StopRecordingRequest {
   /**
    * Use this field to add state to every subsequent webhook. It must be a valid
@@ -3276,6 +3293,12 @@ export interface ActionGatherUsingAIParams {
    * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
    *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
    *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+   * - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+   *   Supported model: `tts-rt-v2`. Browse the catalog via the
+   *   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+   *   Every voice speaks all supported languages; set `language` to the two-letter
+   *   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+   *   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    * - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -3294,7 +3317,8 @@ export interface ActionGatherUsingAIParams {
     | AwsVoiceSettings
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | SonioxVoiceSettings;
 }
 
 export namespace ActionGatherUsingAIParams {
@@ -3447,6 +3471,12 @@ export interface ActionGatherUsingSpeakParams {
    * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
    *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
    *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+   * - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+   *   Supported model: `tts-rt-v2`. Browse the catalog via the
+   *   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+   *   Every voice speaks all supported languages; set `language` to the two-letter
+   *   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+   *   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    * - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -3576,7 +3606,8 @@ export interface ActionGatherUsingSpeakParams {
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | SonioxVoiceSettings;
 }
 
 export interface ActionHangupParams {
@@ -4337,6 +4368,12 @@ export interface ActionSpeakParams {
    * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
    *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
    *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+   * - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+   *   Supported model: `tts-rt-v2`. Browse the catalog via the
+   *   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+   *   Every voice speaks all supported languages; set `language` to the two-letter
+   *   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+   *   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    * - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -4438,7 +4475,8 @@ export interface ActionSpeakParams {
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | SonioxVoiceSettings;
 }
 
 export interface ActionStartStreamingParams {
@@ -5375,6 +5413,12 @@ export interface ActionStartConversationRelayParams {
    * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
    *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
    *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+   * - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+   *   Supported model: `tts-rt-v2`. Browse the catalog via the
+   *   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+   *   Every voice speaks all supported languages; set `language` to the two-letter
+   *   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+   *   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    * - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -5395,7 +5439,8 @@ export interface ActionStartConversationRelayParams {
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | SonioxVoiceSettings;
 }
 
 export namespace ActionStartConversationRelayParams {
@@ -5624,6 +5669,7 @@ export declare namespace Actions {
     type InterruptionSettings as InterruptionSettings,
     type Loopcount as Loopcount,
     type PayPromptValue as PayPromptValue,
+    type SonioxVoiceSettings as SonioxVoiceSettings,
     type StopRecordingRequest as StopRecordingRequest,
     type SystemMessage as SystemMessage,
     type TelnyxTranscriptionLanguage as TelnyxTranscriptionLanguage,

package/src/resources/calls/calls.ts

@@ -101,6 +101,7 @@ import {
   InterruptionSettings,
   Loopcount,
   PayPromptValue,
+  SonioxVoiceSettings,
   StopRecordingRequest,
   SystemMessage,
   TelnyxTranscriptionLanguage,
@@ -536,6 +537,12 @@ export interface ConversationRelayEmbeddedConfig {
    * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
    *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
    *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+   * - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+   *   Supported model: `tts-rt-v2`. Browse the catalog via the
+   *   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+   *   Every voice speaks all supported languages; set `language` to the two-letter
+   *   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+   *   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    * - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -556,7 +563,8 @@ export interface ConversationRelayEmbeddedConfig {
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | ActionsAPI.SonioxVoiceSettings;
 }
 
 /**
@@ -661,7 +669,8 @@ export interface ConversationRelayLanguage {
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | ActionsAPI.SonioxVoiceSettings;
 }
 
 export interface CustomSipHeader {
@@ -1602,6 +1611,7 @@ export declare namespace Calls {
     type InterruptionSettings as InterruptionSettings,
     type Loopcount as Loopcount,
     type PayPromptValue as PayPromptValue,
+    type SonioxVoiceSettings as SonioxVoiceSettings,
     type StopRecordingRequest as StopRecordingRequest,
     type SystemMessage as SystemMessage,
     type TelnyxTranscriptionLanguage as TelnyxTranscriptionLanguage,

package/src/resources/calls/index.ts

@@ -16,6 +16,7 @@ export {
   type InterruptionSettings,
   type Loopcount,
   type PayPromptValue,
+  type SonioxVoiceSettings,
   type StopRecordingRequest,
   type SystemMessage,
   type TelnyxTranscriptionLanguage,

package/src/resources/conferences/actions.ts

@@ -797,6 +797,12 @@ export interface ActionSpeakParams {
    * - **Fish Audio:** Use `FishAudio.<ModelId>.<VoiceId>` (e.g.,
    *   `FishAudio.s2.1-pro.<reference_id>`). Supported models: `s2.1-pro`, `s2-pro`,
    *   `s1`. `VoiceId` is a Fish Voice-Library reference ID.
+   * - **Soniox:** Use `Soniox.<ModelId>.<VoiceId>` (e.g., `Soniox.tts-rt-v2.Emma`).
+   *   Supported model: `tts-rt-v2`. Browse the catalog via the
+   *   [Voices API](https://developers.telnyx.com/api-reference/text-to-speech-commands/list-available-voices).
+   *   Every voice speaks all supported languages; set `language` to the two-letter
+   *   ISO 639-1 code of the text, for example `it`. SSML is not supported. Use
+   *   `voice_settings` to configure `speed` (0.7 to 1.3) and `reduce_silence`.
    * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
    *   `ara`, `rex`, `sal`, `leo`.
    * - **Humain:** Use `Humain.<VoiceId>` (e.g., `Humain.sara-ar`). Available voices:
@@ -880,7 +886,8 @@ export interface ActionSpeakParams {
     | Shared.AzureVoiceSettings
     | Shared.ResembleVoiceSettings
     | Shared.InworldVoiceSettings
-    | Shared.XaiVoiceSettings;
+    | Shared.XaiVoiceSettings
+    | ActionsAPI.SonioxVoiceSettings;
 }
 
 export interface ActionStopParams {