@ai-sdk/openai 3.0.0-beta.77 → 3.0.0-beta.78

package/dist/internal/index.mjs

@@ -3264,7 +3264,18 @@ var openaiResponsesModelIds = [
 var openaiResponsesProviderOptionsSchema = lazySchema14(
   () => zodSchema14(
     z16.object({
+      /**
+       * The ID of the OpenAI Conversation to continue.
+       * You must create a conversation first via the OpenAI API.
+       * Cannot be used in conjunction with `previousResponseId`.
+       * Defaults to `undefined`.
+       * @see https://platform.openai.com/docs/api-reference/conversations/create
+       */
       conversation: z16.string().nullish(),
+      /**
+       * The set of extra fields to include in the response (advanced, usually not needed).
+       * Example values: 'reasoning.encrypted_content', 'file_search_call.results', 'message.output_text.logprobs'.
+       */
       include: z16.array(
         z16.enum([
           "reasoning.encrypted_content",
@@ -3273,9 +3284,16 @@ var openaiResponsesProviderOptionsSchema = lazySchema14(
           "message.output_text.logprobs"
         ])
       ).nullish(),
+      /**
+       * Instructions for the model.
+       * They can be used to change the system or developer message when continuing a conversation using the `previousResponseId` option.
+       * Defaults to `undefined`.
+       */
       instructions: z16.string().nullish(),
       /**
-       * Return the log probabilities of the tokens.
+       * Return the log probabilities of the tokens. Including logprobs will increase
+       * the response size and can slow down response times. However, it can
+       * be useful to better understand how the model is behaving.
        *
        * Setting to true will return the log probabilities of the tokens that
        * were generated.
@@ -3293,9 +3311,22 @@ var openaiResponsesProviderOptionsSchema = lazySchema14(
        * Any further attempts to call a tool by the model will be ignored.
        */
       maxToolCalls: z16.number().nullish(),
+      /**
+       * Additional metadata to store with the generation.
+       */
       metadata: z16.any().nullish(),
+      /**
+       * Whether to use parallel tool calls. Defaults to `true`.
+       */
       parallelToolCalls: z16.boolean().nullish(),
+      /**
+       * The ID of the previous response. You can use it to continue a conversation.
+       * Defaults to `undefined`.
+       */
       previousResponseId: z16.string().nullish(),
+      /**
+       * Sets a cache key to tie this prompt to cached prefixes for better caching performance.
+       */
       promptCacheKey: z16.string().nullish(),
       /**
        * The retention policy for the prompt cache.
@@ -3306,14 +3337,60 @@ var openaiResponsesProviderOptionsSchema = lazySchema14(
        * @default 'in_memory'
        */
       promptCacheRetention: z16.enum(["in_memory", "24h"]).nullish(),
+      /**
+       * Reasoning effort for reasoning models. Defaults to `medium`. If you use
+       * `providerOptions` to set the `reasoningEffort` option, this model setting will be ignored.
+       * Valid values: 'none' | 'minimal' | 'low' | 'medium' | 'high'
+       *
+       * Note: The 'none' type for `reasoningEffort` is only available for OpenAI's GPT-5.1
+       * models. Setting `reasoningEffort` to 'none' with other models will result in
+       * an error.
+       */
       reasoningEffort: z16.string().nullish(),
+      /**
+       * Controls reasoning summary output from the model.
+       * Set to "auto" to automatically receive the richest level available,
+       * or "detailed" for comprehensive summaries.
+       */
       reasoningSummary: z16.string().nullish(),
+      /**
+       * The identifier for safety monitoring and tracking.
+       */
       safetyIdentifier: z16.string().nullish(),
+      /**
+       * Service tier for the request.
+       * Set to 'flex' for 50% cheaper processing at the cost of increased latency (available for o3, o4-mini, and gpt-5 models).
+       * Set to 'priority' for faster processing with Enterprise access (available for gpt-4, gpt-5, gpt-5-mini, o3, o4-mini; gpt-5-nano is not supported).
+       *
+       * Defaults to 'auto'.
+       */
       serviceTier: z16.enum(["auto", "flex", "priority", "default"]).nullish(),
+      /**
+       * Whether to store the generation. Defaults to `true`.
+       */
       store: z16.boolean().nullish(),
+      /**
+       * Whether to use strict JSON schema validation.
+       * Defaults to `true`.
+       */
       strictJsonSchema: z16.boolean().nullish(),
+      /**
+       * Controls the verbosity of the model's responses. Lower values ('low') will result
+       * in more concise responses, while higher values ('high') will result in more verbose responses.
+       * Valid values: 'low', 'medium', 'high'.
+       */
       textVerbosity: z16.enum(["low", "medium", "high"]).nullish(),
+      /**
+       * Controls output truncation. 'auto' (default) performs truncation automatically;
+       * 'disabled' turns truncation off.
+       */
       truncation: z16.enum(["auto", "disabled"]).nullish(),
+      /**
+       * A unique identifier representing your end-user, which can help OpenAI to
+       * monitor and detect abuse.
+       * Defaults to `undefined`.
+       * @see https://platform.openai.com/docs/guides/safety-best-practices/end-user-ids
+       */
       user: z16.string().nullish()
     })
   )