telnyx 7.22.0 → 7.24.0

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

@@ -29,6 +29,7 @@ export {
   type ImportMetadata,
   type InferenceEmbedding,
   type InferenceEmbeddingInterruptionSettings,
+  type InferenceEmbeddingVoiceSettings,
   type InferenceEmbeddingWebhookToolParams,
   type InsightSettings,
   type MessagingSettings,

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

@@ -242,10 +242,10 @@ export interface UpdateAssistant {
   /**
    * Configuration for post-conversation processing. When enabled, the assistant
    * receives one additional LLM turn after the conversation ends, allowing it to
-   * execute tool calls such as logging to a CRM or sending a summary. The assistant
-   * can execute multiple parallel or sequential tools during this phase.
-   * Telephony-control tools (e.g. hangup, transfer) are unavailable
-   * post-conversation. Beta feature.
+   * execute final tool calls such as sending a summary or updating a record via
+   * webhook or function tools. Integration and MCP server tools are not available
+   * post-conversation; call-control tools (e.g. hangup, transfer) are also
+   * unavailable. Beta feature.
    */
   post_conversation_settings?: AssistantsAPI.PostConversationSettingsReq;
 
@@ -261,14 +261,25 @@ export interface UpdateAssistant {
 
   /**
    * IDs of shared tools to attach to the assistant. New integrations should prefer
-   * `tool_ids` over inline `tools`.
+   * `tool_ids` over inline `tools`. On update, a sent `tool_ids` array fully
+   * replaces the assistant's attached shared tools; omit the field to leave them
+   * unchanged. Single-instance tool types are counted across inline `tools` and
+   * `tool_ids` combined, so attaching a shared tool of such a type when an instance
+   * already exists returns HTTP 400 with error code 10015.
    */
   tool_ids?: Array<string>;
 
   /**
    * Deprecated for new integrations. Inline tool definitions available to the
    * assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-   * endpoints.
+   * endpoints. On update, a sent `tools` array fully replaces the assistant's inline
+   * tools; omit the field to leave the inline tools unchanged. Each tool type except
+   * `function`, `webhook`, and `client_side_tool` allows at most one instance per
+   * assistant, counted across inline `tools` and shared `tool_ids` combined —
+   * sending a duplicate of such a type returns HTTP 400 with error code 10015.
+   * Responses merge shared tools into `tools` with `shared: true`; when updating,
+   * omit those tools from the `tools` array and manage them through `tool_ids`
+   * instead.
    */
   tools?: Array<AssistantsAPI.AssistantTool>;
 
@@ -279,7 +290,7 @@ export interface UpdateAssistant {
    */
   version_name?: string;
 
-  voice_settings?: AssistantsAPI.VoiceSettings;
+  voice_settings?: AssistantsAPI.InferenceEmbeddingVoiceSettings;
 
   /**
    * Configuration settings for the assistant's web widget.
@@ -463,10 +474,10 @@ export interface VersionUpdateParams {
   /**
    * Body param: Configuration for post-conversation processing. When enabled, the
    * assistant receives one additional LLM turn after the conversation ends, allowing
-   * it to execute tool calls such as logging to a CRM or sending a summary. The
-   * assistant can execute multiple parallel or sequential tools during this phase.
-   * Telephony-control tools (e.g. hangup, transfer) are unavailable
-   * post-conversation. Beta feature.
+   * it to execute final tool calls such as sending a summary or updating a record
+   * via webhook or function tools. Integration and MCP server tools are not
+   * available post-conversation; call-control tools (e.g. hangup, transfer) are also
+   * unavailable. Beta feature.
    */
   post_conversation_settings?: AssistantsAPI.PostConversationSettingsReq;
 
@@ -488,14 +499,25 @@ export interface VersionUpdateParams {
 
   /**
    * Body param: IDs of shared tools to attach to the assistant. New integrations
-   * should prefer `tool_ids` over inline `tools`.
+   * should prefer `tool_ids` over inline `tools`. On update, a sent `tool_ids` array
+   * fully replaces the assistant's attached shared tools; omit the field to leave
+   * them unchanged. Single-instance tool types are counted across inline `tools` and
+   * `tool_ids` combined, so attaching a shared tool of such a type when an instance
+   * already exists returns HTTP 400 with error code 10015.
    */
   tool_ids?: Array<string>;
 
   /**
    * Body param: Deprecated for new integrations. Inline tool definitions available
    * to the assistant. Prefer `tool_ids` to attach shared tools created with the AI
-   * Tools endpoints.
+   * Tools endpoints. On update, a sent `tools` array fully replaces the assistant's
+   * inline tools; omit the field to leave the inline tools unchanged. Each tool type
+   * except `function`, `webhook`, and `client_side_tool` allows at most one instance
+   * per assistant, counted across inline `tools` and shared `tool_ids` combined —
+   * sending a duplicate of such a type returns HTTP 400 with error code 10015.
+   * Responses merge shared tools into `tools` with `shared: true`; when updating,
+   * omit those tools from the `tools` array and manage them through `tool_ids`
+   * instead.
    */
   tools?: Array<AssistantsAPI.AssistantTool>;
 
@@ -512,7 +534,7 @@ export interface VersionUpdateParams {
   /**
    * Body param
    */
-  voice_settings?: AssistantsAPI.VoiceSettings;
+  voice_settings?: AssistantsAPI.InferenceEmbeddingVoiceSettings;
 
   /**
    * Body param: Configuration settings for the assistant's web widget.

package/src/resources/ai/audio.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as AudioAPI from './audio';
 import { APIPromise } from '../../core/api-promise';
 import { type Uploadable } from '../../core/uploads';
 import { RequestOptions } from '../../internal/request-options';
@@ -27,12 +28,56 @@ export class Audio extends APIResource {
   }
 }
 
+/**
+ * Word-level timing detail. Only present when using a `deepgram/*` model with
+ * `model_config` options that enable word timestamps.
+ */
+export interface AudioTranscriptionResponseWord {
+  /**
+   * End time of the word in seconds.
+   */
+  end: number;
+
+  /**
+   * Start time of the word in seconds.
+   */
+  start: number;
+
+  /**
+   * The transcribed word.
+   */
+  word: string;
+
+  /**
+   * Confidence score for the word (0.0 to 1.0).
+   */
+  confidence?: number;
+
+  /**
+   * The transcribed word with punctuation and capitalisation applied. Only present
+   * when `punctuate` or `smart_format` is enabled via `model_config`.
+   */
+  punctuated_word?: string;
+
+  /**
+   * Speaker index. Only present when diarization is enabled via `model_config`.
+   */
+  speaker?: number;
+
+  /**
+   * Confidence score for the speaker assignment (0.0 to 1.0). Only present when
+   * diarization is enabled via `model_config`.
+   */
+  speaker_confidence?: number;
+}
+
 /**
  * Response fields vary by model. `distil-whisper/distil-large-v2` returns `text`,
  * `duration`, and `segments` in `verbose_json` mode.
- * `openai/whisper-large-v3-turbo` returns `text` only. `deepgram/nova-3` returns
- * `text` and, depending on `model_config`, may include `words` with per-word
- * timestamps and speaker labels.
+ * `openai/whisper-large-v3-turbo` returns `text` only. The `deepgram/*` models
+ * return `text` and, depending on `model_config`, may include `words` with
+ * per-word timestamps and speaker labels. The Parakeet models
+ * (`nvidia/parakeet-v3`, `omi-health/omi-med-stt-v1`) return `text` only.
  */
 export interface AudioTranscribeResponse {
   /**
@@ -42,23 +87,25 @@ export interface AudioTranscribeResponse {
 
   /**
    * The duration of the audio file in seconds. Returned by
-   * `distil-whisper/distil-large-v2` and `deepgram/nova-3` when `response_format` is
-   * `verbose_json`. Not returned by `openai/whisper-large-v3-turbo`.
+   * `distil-whisper/distil-large-v2` and the `deepgram/*` models when
+   * `response_format` is `verbose_json`. Not returned by
+   * `openai/whisper-large-v3-turbo`.
    */
   duration?: number;
 
   /**
    * Segments of the transcribed text and their corresponding details. Returned by
-   * `distil-whisper/distil-large-v2` when `response_format` is `verbose_json`. Not
-   * returned by `openai/whisper-large-v3-turbo`.
+   * `distil-whisper/distil-large-v2` and the `deepgram/*` models when
+   * `response_format` is `verbose_json`; Deepgram segments also carry nested `words`
+   * and `speakers`. Not returned by `openai/whisper-large-v3-turbo`.
    */
   segments?: Array<AudioTranscribeResponse.Segment>;
 
   /**
-   * Word-level timestamps and optional speaker labels. Only returned by
-   * `deepgram/nova-3` when word-level output is enabled via `model_config`.
+   * Word-level timestamps and optional speaker labels. Only returned by the
+   * `deepgram/*` models when word-level output is enabled via `model_config`.
    */
-  words?: Array<AudioTranscribeResponse.Word>;
+  words?: Array<AudioTranscriptionResponseWord>;
 }
 
 export namespace AudioTranscribeResponse {
@@ -82,37 +129,18 @@ export namespace AudioTranscribeResponse {
      * Text content of the segment.
      */
     text: string;
-  }
-
-  /**
-   * Word-level timing detail. Only present when using `deepgram/nova-3` with
-   * `model_config` options that enable word timestamps.
-   */
-  export interface Word {
-    /**
-     * End time of the word in seconds.
-     */
-    end: number;
-
-    /**
-     * Start time of the word in seconds.
-     */
-    start: number;
-
-    /**
-     * The transcribed word.
-     */
-    word: string;
 
     /**
-     * Confidence score for the word (0.0 to 1.0).
+     * Speaker indices heard in this segment. Returned by the `deepgram/*` models when
+     * `diarize` is enabled via `model_config`.
      */
-    confidence?: number;
+    speakers?: Array<number>;
 
     /**
-     * Speaker index. Only present when diarization is enabled via `model_config`.
+     * Word-level timing detail for this segment. Returned by the `deepgram/*` models
+     * when word-level output is enabled via `model_config`.
      */
-    speaker?: number;
+    words?: Array<AudioAPI.AudioTranscriptionResponseWord>;
   }
 }
 
@@ -120,37 +148,56 @@ export interface AudioTranscribeParams {
   /**
    * ID of the model to use. `distil-whisper/distil-large-v2` is lower latency but
    * English-only. `openai/whisper-large-v3-turbo` is multi-lingual but slightly
-   * higher latency. `deepgram/nova-3` supports English variants (en, en-US, en-GB,
-   * en-AU, en-NZ, en-IN) and only accepts mp3/wav files.
+   * higher latency. The `deepgram/*` models only accept mp3/wav files:
+   * `deepgram/nova-3` covers ~49 languages plus `multi` and `deepgram/nova-2` covers
+   * ~33, while the `-medical` variants are tuned for clinical vocabulary and accept
+   * English only (`en` and its regional variants, e.g. `en-US`, `en-GB`).
+   * `nvidia/parakeet-v3` is multilingual with automatic language detection;
+   * `omi-health/omi-med-stt-v1` is a medical model, English only.
    */
-  model: 'distil-whisper/distil-large-v2' | 'openai/whisper-large-v3-turbo' | 'deepgram/nova-3';
+  model:
+    | 'distil-whisper/distil-large-v2'
+    | 'openai/whisper-large-v3-turbo'
+    | 'deepgram/nova-2'
+    | 'deepgram/nova-2-medical'
+    | 'deepgram/nova-3'
+    | 'deepgram/nova-3-medical'
+    | 'nvidia/parakeet-v3'
+    | 'omi-health/omi-med-stt-v1';
 
   /**
    * The audio file object to transcribe, in one of these formats: flac, mp3, mp4,
    * mpeg, mpga, m4a, ogg, wav, or webm. File uploads are limited to 100 MB. Cannot
-   * be used together with `file_url`. Note: `deepgram/nova-3` only supports mp3 and
-   * wav formats.
+   * be used together with `file_url`. Note: the `deepgram/*` models only support mp3
+   * and wav formats.
    */
   file?: Uploadable;
 
   /**
    * Link to audio file in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a,
    * ogg, wav, or webm. Support for hosted files is limited to 100MB. Cannot be used
-   * together with `file`. Note: `deepgram/nova-3` only supports mp3 and wav formats.
+   * together with `file`. Note: the `deepgram/*` models only support mp3 and wav
+   * formats.
    */
   file_url?: string;
 
   /**
-   * The language of the audio to be transcribed. For `deepgram/nova-3`, only English
-   * variants are supported: `en`, `en-US`, `en-GB`, `en-AU`, `en-NZ`, `en-IN`. For
+   * The language of the audio to be transcribed. `deepgram/nova-3` supports ~49
+   * languages plus `multi`, and `deepgram/nova-2` supports ~33 plus `multi`; the
+   * `-medical` variants are English only (`en` and its regional variants, e.g.
+   * `en-US`, `en-GB`). Deepgram models validate on the base language and forward the
+   * full tag, so regional variants such as `de-CH` and `pt-BR` are accepted where
+   * the base language is supported; an unsupported language returns a 400. For
    * `openai/whisper-large-v3-turbo`, supports multiple languages.
    * `distil-whisper/distil-large-v2` does not support language parameter.
+   * `nvidia/parakeet-v3` detects the language automatically;
+   * `omi-health/omi-med-stt-v1` is English only.
    */
   language?: string;
 
   /**
-   * Additional model-specific configuration parameters. Only allowed with
-   * `deepgram/nova-3` model. Can include Deepgram-specific options such as
+   * Additional model-specific configuration parameters. Only allowed with the
+   * `deepgram/*` models. Can include Deepgram-specific options such as
    * `smart_format`, `punctuate`, `diarize`, `utterance`, `numerals`, and `language`.
    * If `language` is provided both as a top-level parameter and in `model_config`,
    * the top-level parameter takes precedence.
@@ -173,6 +220,7 @@ export interface AudioTranscribeParams {
 
 export declare namespace Audio {
   export {
+    type AudioTranscriptionResponseWord as AudioTranscriptionResponseWord,
     type AudioTranscribeResponse as AudioTranscribeResponse,
     type AudioTranscribeParams as AudioTranscribeParams,
   };

package/src/resources/ai/chat.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../core/resource';
 import * as ChatAPI from './chat';
+import * as OpenAIChatAPI from './openai/chat';
 
 export class Chat extends APIResource {}
 
@@ -282,21 +283,11 @@ export namespace ChatCompletionRequest {
   }
 
   export interface Function {
-    function: Function.Function;
+    function: OpenAIChatAPI.FunctionDefinition;
 
     type: 'function';
   }
 
-  export namespace Function {
-    export interface Function {
-      name: string;
-
-      description?: string;
-
-      parameters?: { [key: string]: unknown };
-    }
-  }
-
   export interface Retrieval {
     retrieval: ChatAPI.BucketIDs;
 

package/src/resources/ai/collections/collections.ts

@@ -13,6 +13,7 @@ import {
 } from './settings';
 import * as SourcesAPI from './sources';
 import {
+  CollectionsSource,
   Source,
   SourceCreateParams,
   SourceCreateResponse,
@@ -166,7 +167,7 @@ export interface Collection {
 
   slug?: string;
 
-  sources?: Array<SourcesAPI.Source>;
+  sources?: Array<SourcesAPI.CollectionsSource>;
 
   status?: string;
 
@@ -239,6 +240,7 @@ export declare namespace Collections {
 
   export {
     Sources as Sources,
+    type CollectionsSource as CollectionsSource,
     type Source as Source,
     type SourceRequest as SourceRequest,
     type SourceType as SourceType,

package/src/resources/ai/collections/index.ts

@@ -20,6 +20,7 @@ export {
 } from './settings';
 export {
   Sources,
+  type CollectionsSource,
   type Source,
   type SourceRequest,
   type SourceType,
@@ -29,4 +30,5 @@ export {
   type SourceCreateParams,
   type SourceReplaceParams,
   type SourceDeleteParams,
+  type SourcesDefaultFlatPagination,
 } from './sources';

package/src/resources/ai/collections/sources.ts

@@ -2,6 +2,7 @@
 
 import { APIResource } from '../../../core/resource';
 import { APIPromise } from '../../../core/api-promise';
+import { DefaultFlatPagination } from '../../../core/pagination';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
@@ -81,7 +82,9 @@ export class Sources extends APIResource {
   }
 }
 
-export interface Source {
+export type SourcesDefaultFlatPagination = DefaultFlatPagination<Source>;
+
+export interface CollectionsSource {
   id?: string;
 
   /**
@@ -106,6 +109,36 @@ export interface Source {
   status?: string;
 }
 
+export interface Source {
+  /**
+   * 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;
+
+  /**
+   * 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 SourceRequest {
   /**
    * The type of Telnyx data attached as a source. `bucket` requires an additional
@@ -132,15 +165,15 @@ export type SourceType = 'voice' | 'meeting_bot' | 'message' | 'bucket';
  * Envelope containing a single collection source.
  */
 export interface SourceCreateResponse {
-  data?: Source;
+  data?: CollectionsSource;
 }
 
 export interface SourceListResponse {
-  data?: Array<Source>;
+  data?: Array<CollectionsSource>;
 }
 
 export interface SourceReplaceResponse {
-  data?: Array<Source>;
+  data?: Array<CollectionsSource>;
 
   /**
    * Reports which source IDs were added, retained, and removed by a replace
@@ -191,6 +224,7 @@ export interface SourceDeleteParams {
 
 export declare namespace Sources {
   export {
+    type CollectionsSource as CollectionsSource,
     type Source as Source,
     type SourceRequest as SourceRequest,
     type SourceType as SourceType,

package/src/resources/ai/index.ts

@@ -40,6 +40,7 @@ export {
   type ImportMetadata,
   type InferenceEmbedding,
   type InferenceEmbeddingInterruptionSettings,
+  type InferenceEmbeddingVoiceSettings,
   type InferenceEmbeddingWebhookToolParams,
   type InsightSettings,
   type MessagingSettings,
@@ -77,7 +78,12 @@ export {
   type AssistantCloneParams,
   type AssistantSendSMSParams,
 } from './assistants/index';
-export { Audio, type AudioTranscribeResponse, type AudioTranscribeParams } from './audio';
+export {
+  Audio,
+  type AudioTranscriptionResponseWord,
+  type AudioTranscribeResponse,
+  type AudioTranscribeParams,
+} from './audio';
 export { Chat, type BucketIDs, type ChatCompletionRequest } from './chat';
 export {
   Clusters,
@@ -135,6 +141,7 @@ export {
   type McpServerUpdateParams,
   type McpServersDefaultFlatPaginationTopLevelArray,
 } from './mcp-servers';
+export { Memory } from './memory/index';
 export {
   Missions,
   type EventsListResponse,
@@ -160,3 +167,4 @@ export {
   type ToolUpdateParams,
   type SharedToolResponsesDefaultFlatPagination,
 } from './tools';
+export { Typesafe } from './typesafe/index';

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

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Memory } from './memory';
+export { Namespaces, type NamespaceRetrieveResponse, type NamespaceRetrieveParams } from './namespaces/index';

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

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as NamespacesAPI from './namespaces/namespaces';
+import { NamespaceRetrieveParams, NamespaceRetrieveResponse, Namespaces } from './namespaces/namespaces';
+
+export class Memory extends APIResource {
+  namespaces: NamespacesAPI.Namespaces = new NamespacesAPI.Namespaces(this._client);
+}
+
+Memory.Namespaces = Namespaces;
+
+export declare namespace Memory {
+  export {
+    Namespaces as Namespaces,
+    type NamespaceRetrieveResponse as NamespaceRetrieveResponse,
+    type NamespaceRetrieveParams as NamespaceRetrieveParams,
+  };
+}

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

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Namespaces, type NamespaceRetrieveResponse, type NamespaceRetrieveParams } from './namespaces';
+export {
+  Profiles,
+  type PageMeta,
+  type ProfileListResponse,
+  type ProfileDeleteResponse,
+  type ProfileIngestResponse,
+  type ProfileRecallResponse,
+  type ProfileRememberResponse,
+  type ProfileRetrieveSummaryResponse,
+  type ProfileListParams,
+  type ProfileDeleteParams,
+  type ProfileIngestParams,
+  type ProfileRecallParams,
+  type ProfileRememberParams,
+  type ProfileRetrieveSummaryParams,
+  type ProfileListResponsesDefaultFlatPagination,
+} from './profiles/index';
+export { Settings, type NamespaceSettingsResponse, type SettingPatchAllParams } from './settings';