telnyx 7.21.0 → 7.23.0

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

@@ -4,6 +4,7 @@ export {
   Assistants,
   type ArithmeticExpression,
   type Assistant,
+  type AssistantA2AAgent,
   type AssistantIntegration,
   type AssistantMcpServer,
   type AssistantTool,

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

@@ -117,6 +117,19 @@ export class Versions extends APIResource {
 }
 
 export interface UpdateAssistant {
+  /**
+   * A2A agents this assistant can delegate to. Tools are not stored here: at the
+   * start of every conversation each agent's card is fetched and one tool is derived
+   * per skill the card advertises, named `a2a_<name>_<skill_id>`. The following
+   * limits are not enforced when the assistant is saved, and anything past them is
+   * dropped when the conversation starts: 64 agents per assistant, 64 skills per
+   * card, 128 derived tools per assistant, and a 6 second budget for all card
+   * fetches combined. An agent whose card cannot be fetched costs the assistant that
+   * capability for the conversation; it does not fail the call. Omit this field to
+   * leave the assistant's agents unchanged; send an empty array to remove them all.
+   */
+  a2a_agents?: Array<AssistantsAPI.AssistantA2AAgent>;
+
   /**
    * Conversation flow as supplied by API clients (create / update).
    *
@@ -229,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;
 
@@ -248,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>;
 
@@ -299,6 +323,20 @@ export interface VersionUpdateParams {
    */
   assistant_id: string;
 
+  /**
+   * Body param: A2A agents this assistant can delegate to. Tools are not stored
+   * here: at the start of every conversation each agent's card is fetched and one
+   * tool is derived per skill the card advertises, named `a2a_<name>_<skill_id>`.
+   * The following limits are not enforced when the assistant is saved, and anything
+   * past them is dropped when the conversation starts: 64 agents per assistant, 64
+   * skills per card, 128 derived tools per assistant, and a 6 second budget for all
+   * card fetches combined. An agent whose card cannot be fetched costs the assistant
+   * that capability for the conversation; it does not fail the call. Omit this field
+   * to leave the assistant's agents unchanged; send an empty array to remove them
+   * all.
+   */
+  a2a_agents?: Array<AssistantsAPI.AssistantA2AAgent>;
+
   /**
    * Body param: Conversation flow as supplied by API clients (create / update).
    *
@@ -436,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;
 
@@ -461,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>;
 

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 {}
 
@@ -58,22 +59,6 @@ export interface ChatCompletionRequest {
    */
   frequency_penalty?: number;
 
-  /**
-   * If specified, the output will be exactly one of the choices.
-   */
-  guided_choice?: Array<string>;
-
-  /**
-   * Must be a valid JSON schema. If specified, the output will follow the JSON
-   * schema.
-   */
-  guided_json?: { [key: string]: unknown };
-
-  /**
-   * If specified, the output will follow the regex pattern.
-   */
-  guided_regex?: string;
-
   /**
    * This is used with `use_beam_search` to prefer shorter or longer completions.
    */
@@ -141,10 +126,15 @@ export interface ChatCompletionRequest {
   region?: 'USA' | 'EU' | 'AUS' | 'UAE';
 
   /**
-   * Use this is you want to guarantee a JSON output without defining a schema. For
-   * control over the schema, use `guided_json`.
+   * Controls the format of the model output. `json_object` guarantees valid JSON
+   * output without defining a schema; `json_schema` constrains the output to the
+   * JSON schema you supply via the `json_schema` property and is the supported way
+   * to get guaranteed structured output on Telnyx-hosted models.
    */
-  response_format?: ChatCompletionRequest.ResponseFormat;
+  response_format?:
+    | ChatCompletionRequest.ResponseFormatText
+    | ChatCompletionRequest.ResponseFormatJsonObject
+    | ChatCompletionRequest.ResponseFormatJsonSchemaParam;
 
   /**
    * If specified, the system will make a best effort to sample deterministically,
@@ -228,29 +218,76 @@ export namespace ChatCompletionRequest {
   }
 
   /**
-   * Use this is you want to guarantee a JSON output without defining a schema. For
-   * control over the schema, use `guided_json`.
+   * Plain text output.
    */
-  export interface ResponseFormat {
-    type: 'text' | 'json_object';
+  export interface ResponseFormatText {
+    type: 'text';
   }
 
-  export interface Function {
-    function: Function.Function;
+  /**
+   * JSON mode: the model output is valid JSON, without a schema.
+   */
+  export interface ResponseFormatJsonObject {
+    type: 'json_object';
+  }
 
-    type: 'function';
+  /**
+   * Structured output: the model output is constrained to the JSON schema supplied
+   * in `json_schema`.
+   */
+  export interface ResponseFormatJsonSchemaParam {
+    /**
+     * The JSON schema configuration, required when `type` is `json_schema`. Matches
+     * the
+     * [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     * `json_schema` response format.
+     */
+    json_schema: ResponseFormatJsonSchemaParam.JsonSchema;
+
+    type: 'json_schema';
   }
 
-  export namespace Function {
-    export interface Function {
+  export namespace ResponseFormatJsonSchemaParam {
+    /**
+     * The JSON schema configuration, required when `type` is `json_schema`. Matches
+     * the
+     * [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     * `json_schema` response format.
+     */
+    export interface JsonSchema {
+      /**
+       * The name of the response format. Used for clarity only.
+       */
       name: string;
 
+      /**
+       * A description of what the response format is for, typically used to guide the
+       * model.
+       */
       description?: string;
 
-      parameters?: { [key: string]: unknown };
+      /**
+       * The JSON schema the model output must conform to. A valid
+       * [JSON Schema](https://json-schema.org) object, e.g. a Pydantic
+       * `model_json_schema()` export.
+       */
+      schema?: { [key: string]: unknown };
+
+      /**
+       * Enables strict schema adherence when supported by the model. If the generated
+       * output does not match the provided schema, the request fails instead of
+       * returning non-conformant output.
+       */
+      strict?: boolean;
     }
   }
 
+  export interface Function {
+    function: OpenAIChatAPI.FunctionDefinition;
+
+    type: 'function';
+  }
+
   export interface Retrieval {
     retrieval: ChatAPI.BucketIDs;
 

package/src/resources/ai/index.ts

@@ -15,6 +15,7 @@ export {
   Assistants,
   type ArithmeticExpression,
   type Assistant,
+  type AssistantA2AAgent,
   type AssistantIntegration,
   type AssistantMcpServer,
   type AssistantTool,
@@ -76,7 +77,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,
@@ -159,3 +165,4 @@ export {
   type ToolUpdateParams,
   type SharedToolResponsesDefaultFlatPagination,
 } from './tools';
+export { Typesafe } from './typesafe/index';

package/src/resources/ai/openai/chat.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 OpenAIChatAPI from './chat';
 import * as ChatAPI from '../chat';
 import { APIPromise } from '../../../core/api-promise';
 import { RequestOptions } from '../../../internal/request-options';
@@ -34,6 +35,14 @@ export class Chat extends APIResource {
   }
 }
 
+export interface FunctionDefinition {
+  name: string;
+
+  description?: string;
+
+  parameters?: { [key: string]: unknown };
+}
+
 export type ChatCreateCompletionResponse = { [key: string]: unknown };
 
 export interface ChatCreateCompletionParams {
@@ -75,22 +84,6 @@ export interface ChatCreateCompletionParams {
    */
   frequency_penalty?: number;
 
-  /**
-   * If specified, the output will be exactly one of the choices.
-   */
-  guided_choice?: Array<string>;
-
-  /**
-   * Must be a valid JSON schema. If specified, the output will follow the JSON
-   * schema.
-   */
-  guided_json?: { [key: string]: unknown };
-
-  /**
-   * If specified, the output will follow the regex pattern.
-   */
-  guided_regex?: string;
-
   /**
    * This is used with `use_beam_search` to prefer shorter or longer completions.
    */
@@ -158,10 +151,15 @@ export interface ChatCreateCompletionParams {
   region?: 'USA' | 'EU' | 'AUS' | 'UAE';
 
   /**
-   * Use this is you want to guarantee a JSON output without defining a schema. For
-   * control over the schema, use `guided_json`.
+   * Controls the format of the model output. `json_object` guarantees valid JSON
+   * output without defining a schema; `json_schema` constrains the output to the
+   * JSON schema you supply via the `json_schema` property and is the supported way
+   * to get guaranteed structured output on Telnyx-hosted models.
    */
-  response_format?: ChatCreateCompletionParams.ResponseFormat;
+  response_format?:
+    | ChatCreateCompletionParams.ResponseFormatText
+    | ChatCreateCompletionParams.ResponseFormatJsonObject
+    | ChatCreateCompletionParams.ResponseFormatJsonSchemaParam;
 
   /**
    * If specified, the system will make a best effort to sample deterministically,
@@ -245,29 +243,76 @@ export namespace ChatCreateCompletionParams {
   }
 
   /**
-   * Use this is you want to guarantee a JSON output without defining a schema. For
-   * control over the schema, use `guided_json`.
+   * Plain text output.
    */
-  export interface ResponseFormat {
-    type: 'text' | 'json_object';
+  export interface ResponseFormatText {
+    type: 'text';
   }
 
-  export interface Function {
-    function: Function.Function;
+  /**
+   * JSON mode: the model output is valid JSON, without a schema.
+   */
+  export interface ResponseFormatJsonObject {
+    type: 'json_object';
+  }
 
-    type: 'function';
+  /**
+   * Structured output: the model output is constrained to the JSON schema supplied
+   * in `json_schema`.
+   */
+  export interface ResponseFormatJsonSchemaParam {
+    /**
+     * The JSON schema configuration, required when `type` is `json_schema`. Matches
+     * the
+     * [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     * `json_schema` response format.
+     */
+    json_schema: ResponseFormatJsonSchemaParam.JsonSchema;
+
+    type: 'json_schema';
   }
 
-  export namespace Function {
-    export interface Function {
+  export namespace ResponseFormatJsonSchemaParam {
+    /**
+     * The JSON schema configuration, required when `type` is `json_schema`. Matches
+     * the
+     * [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     * `json_schema` response format.
+     */
+    export interface JsonSchema {
+      /**
+       * The name of the response format. Used for clarity only.
+       */
       name: string;
 
+      /**
+       * A description of what the response format is for, typically used to guide the
+       * model.
+       */
       description?: string;
 
-      parameters?: { [key: string]: unknown };
+      /**
+       * The JSON schema the model output must conform to. A valid
+       * [JSON Schema](https://json-schema.org) object, e.g. a Pydantic
+       * `model_json_schema()` export.
+       */
+      schema?: { [key: string]: unknown };
+
+      /**
+       * Enables strict schema adherence when supported by the model. If the generated
+       * output does not match the provided schema, the request fails instead of
+       * returning non-conformant output.
+       */
+      strict?: boolean;
     }
   }
 
+  export interface Function {
+    function: OpenAIChatAPI.FunctionDefinition;
+
+    type: 'function';
+  }
+
   export interface Retrieval {
     retrieval: ChatAPI.BucketIDs;
 
@@ -277,6 +322,7 @@ export namespace ChatCreateCompletionParams {
 
 export declare namespace Chat {
   export {
+    type FunctionDefinition as FunctionDefinition,
     type ChatCreateCompletionResponse as ChatCreateCompletionResponse,
     type ChatCreateCompletionParams as ChatCreateCompletionParams,
   };