telnyx 7.21.0 → 7.23.0

package/src/resources/calls/actions.ts

@@ -1680,7 +1680,8 @@ export interface TranscriptionConfig {
    * hints `en`, `es`, `fr`, `de`, `hi`, `ru`, `pt`, `ja`, `it`, and `nl`. For
    * `soniox/stt-rt-v4`, `auto` omits the language hint and lets Soniox auto-detect;
    * ISO 639-1 codes (e.g. `en`, `es`) bias detection toward that language. For
-   * `assemblyai/universal-streaming`, `auto` (or unset) enables native multilingual
+   * `assemblyai/universal-3-5-pro` (and its legacy alias
+   * `assemblyai/universal-streaming`), `auto` (or unset) enables native multilingual
    * code-switching; ISO 639-1 codes (`en`, `es`, `de`, `fr`, `pt`, `it`, `tr`, `nl`,
    * `sv`, `no`, `da`, `fi`, `hi`, `vi`, `ar`, `he`, `ja`, `zh`) bias the session to
    * that language. For `humain/realtime`, supported values are `ar`, `en`,
@@ -1703,12 +1704,16 @@ export interface TranscriptionConfig {
    * - `deepgram/nova-3` and `deepgram/nova-2` for live streaming transcription.
    * - `speechmatics/standard` and `speechmatics/enhanced` for live streaming
    *   transcription.
-   * - `assemblyai/universal-streaming` for live streaming transcription.
+   * - `assemblyai/universal-3-5-pro` for live streaming transcription. The legacy
+   *   alias `assemblyai/universal-streaming` is still accepted and resolves to the
+   *   same model.
    * - `xai/grok-stt` for live streaming transcription.
    * - `soniox/stt-rt-v4` for live streaming multilingual transcription with
    *   automatic language detection.
    * - `nvidia/parakeet-v3` for multilingual transcription with automatic language
    *   detection.
+   * - `omi-health/omi-med-stt-v1` for English-only medical transcription
+   *   (Parakeet-based).
    * - `humain/realtime` for live streaming transcription with native Arabic and
    *   Arabic/English code-switching support.
    * - `reson8/turns` for live streaming turn-based transcription of 10 European
@@ -1729,10 +1734,12 @@ export interface TranscriptionConfig {
     | 'deepgram/nova-2'
     | 'speechmatics/standard'
     | 'speechmatics/enhanced'
+    | 'assemblyai/universal-3-5-pro'
     | 'assemblyai/universal-streaming'
     | 'xai/grok-stt'
     | 'soniox/stt-rt-v4'
     | 'nvidia/parakeet-v3'
+    | 'omi-health/omi-med-stt-v1'
     | 'humain/realtime'
     | 'reson8/turns'
     | 'cohere/ar-stt'
@@ -1833,9 +1840,10 @@ export interface TranscriptionEngineAssemblyaiConfig {
   transcription_engine?: 'AssemblyAI';
 
   /**
-   * The model to use for transcription.
+   * The model to use for transcription. `assemblyai/universal-streaming` is a legacy
+   * alias of `assemblyai/universal-3-5-pro` and resolves to the same model.
    */
-  transcription_model?: 'assemblyai/universal-streaming';
+  transcription_model?: 'assemblyai/universal-3-5-pro' | 'assemblyai/universal-streaming';
 }
 
 export interface TranscriptionEngineAzureConfig {
@@ -2085,7 +2093,7 @@ export interface TranscriptionEngineParakeetConfig {
   /**
    * The model to use for transcription.
    */
-  transcription_model?: 'nvidia/parakeet-v3';
+  transcription_model?: 'nvidia/parakeet-v3' | 'omi-health/omi-med-stt-v1';
 }
 
 export interface TranscriptionEngineReson8Config {
@@ -4792,11 +4800,12 @@ export interface ActionTransferParams {
   custom_headers?: Array<CallsAPI.CustomSipHeader>;
 
   /**
-   * The number the inbound call being transferred was originally received on, in
-   * +E164 format. Supplying it lets an unverified non-Telnyx `from` be used as the
-   * caller id, provided that number is still on an active inbound call to this
-   * `diversion` number for your account. The `diversion` number itself must be one
-   * you own or have verified.
+   * The `to` number of an active inbound call, in +E164 format. Telnyx checks
+   * whether there is currently an active inbound call where `to` matches this
+   * `diversion` value and `from` matches the `from` number supplied for this
+   * request. If such a call exists, the `from` number is treated as verified (since
+   * it is already on an active inbound call to you) and can be used as the caller id
+   * for this outbound call.
    */
   diversion?: string;
 
@@ -5046,6 +5055,52 @@ export namespace ActionTransferParams {
      */
     beep_detection_profile?: 'both' | 'freq_only';
 
+    /**
+     * Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+     * Only used when beep detection is active.
+     */
+    beep_max_frequency_hz?: number;
+
+    /**
+     * Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+     * it above 480 excludes North American ringback (440 + 480 Hz), which can
+     * otherwise be reported as a beep when the `freq_only` profile is in use. Only
+     * used when beep detection is active.
+     */
+    beep_min_frequency_hz?: number;
+
+    /**
+     * Shortest tone, in milliseconds, that can be treated as a beep. Raising it
+     * rejects brief tones such as call-progress blips. Only used when beep detection
+     * is active.
+     */
+    beep_min_tone_duration_millis?: number;
+
+    /**
+     * When enabled, a candidate beep must pass an additional spectral check before it
+     * is reported. Only used when beep detection is active.
+     */
+    beep_spectral_confirmation?: boolean;
+
+    /**
+     * Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep.
+     * Raising it rejects mixed tones such as ringback, which combines two frequencies.
+     * Only used when beep detection is active.
+     */
+    beep_spectral_min_purity?: number;
+
+    /**
+     * When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+     * used when beep detection is active.
+     */
+    beep_spectral_reject_fax_cng?: boolean;
+
+    /**
+     * Length of the spectral confirmation window, in milliseconds. Only used when beep
+     * detection is active.
+     */
+    beep_spectral_window_millis?: number;
+
     /**
      * Maximum threshold for silence between words.
      */

package/src/resources/calls/calls.ts

@@ -1006,11 +1006,12 @@ export interface CallDialParams {
   dialogflow_config?: DialogflowConfig;
 
   /**
-   * The number the inbound call being transferred was originally received on, in
-   * +E164 format. Supplying it lets an unverified non-Telnyx `from` be used as the
-   * caller id, provided that number is still on an active inbound call to this
-   * `diversion` number for your account. The `diversion` number itself must be one
-   * you own or have verified.
+   * The `to` number of an active inbound call, in +E164 format. Telnyx checks
+   * whether there is currently an active inbound call where `to` matches this
+   * `diversion` value and `from` matches the `from` number supplied for this
+   * request. If such a call exists, the `from` number is treated as verified (since
+   * it is already on an active inbound call to you) and can be used as the caller id
+   * for this outbound call.
    */
   diversion?: string;
 
@@ -1335,6 +1336,52 @@ export namespace CallDialParams {
      */
     beep_detection_profile?: 'both' | 'freq_only';
 
+    /**
+     * Highest frequency, in Hz, that a tone can reach and still be treated as a beep.
+     * Only used when beep detection is active.
+     */
+    beep_max_frequency_hz?: number;
+
+    /**
+     * Lowest frequency, in Hz, that a tone must reach to be treated as a beep. Raising
+     * it above 480 excludes North American ringback (440 + 480 Hz), which can
+     * otherwise be reported as a beep when the `freq_only` profile is in use. Only
+     * used when beep detection is active.
+     */
+    beep_min_frequency_hz?: number;
+
+    /**
+     * Shortest tone, in milliseconds, that can be treated as a beep. Raising it
+     * rejects brief tones such as call-progress blips. Only used when beep detection
+     * is active.
+     */
+    beep_min_tone_duration_millis?: number;
+
+    /**
+     * When enabled, a candidate beep must pass an additional spectral check before it
+     * is reported. Only used when beep detection is active.
+     */
+    beep_spectral_confirmation?: boolean;
+
+    /**
+     * Minimum spectral purity, from 0 to 1, for a tone to be treated as a beep.
+     * Raising it rejects mixed tones such as ringback, which combines two frequencies.
+     * Only used when beep detection is active.
+     */
+    beep_spectral_min_purity?: number;
+
+    /**
+     * When enabled, the fax CNG tone is rejected rather than reported as a beep. Only
+     * used when beep detection is active.
+     */
+    beep_spectral_reject_fax_cng?: boolean;
+
+    /**
+     * Length of the spectral confirmation window, in milliseconds. Only used when beep
+     * detection is active.
+     */
+    beep_spectral_window_millis?: number;
+
     /**
      * Maximum threshold for silence between words.
      */

package/src/resources/compute/compute.ts

@@ -0,0 +1,37 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as FuncsAPI from './funcs/funcs';
+import {
+  FuncRetrieveLogsParams,
+  FuncRetrieveLogsResponse,
+  FuncRetrieveMetricAggregatesParams,
+  FuncRetrieveMetricAggregatesResponse,
+  FuncRetrieveRevisionsParams,
+  FuncRetrieveRevisionsResponse,
+  FuncRetrieveShipInspectionResponse,
+  Funcs,
+  FunctionsObservabilityPaginationMeta,
+  LogsMeta,
+} from './funcs/funcs';
+
+export class Compute extends APIResource {
+  funcs: FuncsAPI.Funcs = new FuncsAPI.Funcs(this._client);
+}
+
+Compute.Funcs = Funcs;
+
+export declare namespace Compute {
+  export {
+    Funcs as Funcs,
+    type FunctionsObservabilityPaginationMeta as FunctionsObservabilityPaginationMeta,
+    type LogsMeta as LogsMeta,
+    type FuncRetrieveLogsResponse as FuncRetrieveLogsResponse,
+    type FuncRetrieveMetricAggregatesResponse as FuncRetrieveMetricAggregatesResponse,
+    type FuncRetrieveRevisionsResponse as FuncRetrieveRevisionsResponse,
+    type FuncRetrieveShipInspectionResponse as FuncRetrieveShipInspectionResponse,
+    type FuncRetrieveLogsParams as FuncRetrieveLogsParams,
+    type FuncRetrieveMetricAggregatesParams as FuncRetrieveMetricAggregatesParams,
+    type FuncRetrieveRevisionsParams as FuncRetrieveRevisionsParams,
+  };
+}

package/src/resources/compute/funcs/export.ts

@@ -0,0 +1,156 @@
+// 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 { buildHeaders } from '../../../internal/headers';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Export extends APIResource {
+  /**
+   * Stops exporting a function's logs and removes its destination configuration.
+   * Idempotent: deleting when nothing is configured succeeds.
+   *
+   * @example
+   * ```ts
+   * await client.compute.funcs.export.deleteAll('id');
+   * ```
+   */
+  deleteAll(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/compute/funcs/${id}/logs/export`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Returns the function's configured log export destination and which log types are
+   * exported. Headers are never returned. Returns 404 (error code 10005) when no
+   * destination is configured for the function.
+   *
+   * @example
+   * ```ts
+   * const funcLogExportConfigResponse =
+   *   await client.compute.funcs.export.list('id');
+   * ```
+   */
+  list(id: string, options?: RequestOptions): APIPromise<FuncLogExportConfigResponse> {
+    return this._client.get(path`/compute/funcs/${id}/logs/export`, options);
+  }
+
+  /**
+   * Configures the external OTLP endpoint a function's runtime and/or invocation
+   * logs are pushed to as they happen. This operation is a **full replace, not a
+   * patch**: `endpoint`, `headers`, `runtime_export_enabled`, and
+   * `invocation_export_enabled` are all required on every call — omitting any of
+   * them is a 422, not "keep the current value". Headers are encrypted at rest and
+   * never returned in any response.
+   *
+   * The endpoint must be an HTTPS URL. When export is configured, new log records
+   * are converted to OTLP log records and delivered continuously; export never
+   * bypasses platform log storage, and delivery retries with a bounded policy while
+   * the destination is unreachable. Only logs generated after configuration are
+   * exported — there is no historical replay.
+   *
+   * @example
+   * ```ts
+   * const funcLogExportConfigResponse =
+   *   await client.compute.funcs.export.create('id', {
+   *     endpoint: 'https://api.honeycomb.io/v1/logs',
+   *     headers: { 'x-honeycomb-team': 'abc123' },
+   *     invocation_export_enabled: true,
+   *     runtime_export_enabled: true,
+   *   });
+   * ```
+   */
+  create(
+    id: string,
+    body: ExportCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<FuncLogExportConfigResponse> {
+    return this._client.put(path`/compute/funcs/${id}/logs/export`, { body, ...options });
+  }
+}
+
+export interface FuncLogExportConfigResponse {
+  /**
+   * Metadata-only view of a function's log export destination. Header values are
+   * write-only (encrypted server-side) and never appear in any response.
+   */
+  data?: FuncLogExportConfigResponse.Data;
+}
+
+export namespace FuncLogExportConfigResponse {
+  /**
+   * Metadata-only view of a function's log export destination. Header values are
+   * write-only (encrypted server-side) and never appear in any response.
+   */
+  export interface Data {
+    /**
+     * Configuration record ID
+     */
+    id?: string;
+
+    created_at?: string;
+
+    /**
+     * Whether export is enabled for this function
+     */
+    enabled?: boolean;
+
+    /**
+     * HTTPS OTLP endpoint URL logs are pushed to
+     */
+    endpoint?: string;
+
+    /**
+     * Function ID this configuration belongs to
+     */
+    func_id?: string;
+
+    /**
+     * Whether invocation records (one per HTTP request) are exported
+     */
+    invocation_export_enabled?: boolean;
+
+    record_type?: 'compute_func_log_export_config';
+
+    /**
+     * Whether runtime logs (function stdout/stderr) are exported
+     */
+    runtime_export_enabled?: boolean;
+
+    updated_at?: string;
+  }
+}
+
+export interface ExportCreateParams {
+  /**
+   * HTTPS URL to push logs to
+   */
+  endpoint: string;
+
+  /**
+   * Headers attached to every export push, as key-value pairs (e.g. an auth token
+   * the collector expects). Required even when empty — {} means "no headers".
+   * Encrypted at rest; never returned.
+   */
+  headers: { [key: string]: string };
+
+  /**
+   * Export invocation records (one per HTTP request) to this destination
+   */
+  invocation_export_enabled: boolean;
+
+  /**
+   * Export runtime logs (function stdout/stderr) to this destination
+   */
+  runtime_export_enabled: boolean;
+}
+
+export declare namespace Export {
+  export {
+    type FuncLogExportConfigResponse as FuncLogExportConfigResponse,
+    type ExportCreateParams as ExportCreateParams,
+  };
+}