openapi: 3.1.0
info:
  title: OGX Specification - Experimental APIs
  description: |-
    This is the specification of the OGX that provides
                        a set of endpoints and their corresponding interfaces that are
        tailored to
                        best leverage Llama Models.

        **🧪 EXPERIMENTAL**: Pre-release APIs (v1alpha, v1beta) that may change before
        becoming stable.
  version: v1
servers:
- url: http://any-hosted-ogx.com
paths:
  /v1alpha/inference/rerank:
    post:
      responses:
        '200':
          description: RerankResponse with indices sorted by relevance score (descending).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RerankResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      tags:
      - Inference
      summary: Rerank documents based on relevance to a query.
      description: Rerank a list of documents based on their relevance to a query.
      operationId: rerank_v1alpha_inference_rerank_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RerankRequest'
        required: true
  /v1alpha/admin/providers:
    get:
      responses:
        '200':
          description: A list of provider information objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListProvidersResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      tags:
      - Admin
      summary: List all available providers
      description: List all available providers with their configuration and health status.
      operationId: list_providers_v1alpha_admin_providers_get
  /v1alpha/admin/providers/{provider_id}:
    get:
      responses:
        '200':
          description: The provider information object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProviderInfo'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
        '404':
          description: Provider not found.
      tags:
      - Admin
      summary: Get provider details
      description: Get detailed information about a specific provider.
      operationId: inspect_provider_v1alpha_admin_providers__provider_id__get
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          description: The ID of the provider to inspect.
          title: Provider Id
        description: The ID of the provider to inspect.
  /v1alpha/admin/inspect/routes:
    get:
      responses:
        '200':
          description: A list of route information objects.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListRoutesResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      tags:
      - Admin
      summary: List all available API routes
      description: List all available API routes with their methods and implementing providers.
      operationId: list_routes_v1alpha_admin_inspect_routes_get
      parameters:
      - name: api_filter
        in: query
        required: false
        schema:
          anyOf:
          - enum:
            - v1
            - v1alpha
            - v1beta
            - deprecated
            type: string
          - type: 'null'
          description: Filter to control which routes are returned. Can be an API level ('v1', 'v1alpha', 'v1beta') to show non-deprecated routes at that level, or 'deprecated' to show deprecated routes across all levels. If not specified, returns all non-deprecated routes.
          title: Api Filter
        description: Filter to control which routes are returned. Can be an API level ('v1', 'v1alpha', 'v1beta') to show non-deprecated routes at that level, or 'deprecated' to show deprecated routes across all levels. If not specified, returns all non-deprecated routes.
  /v1alpha/admin/health:
    get:
      responses:
        '200':
          description: Health information object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthInfo'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      tags:
      - Admin
      summary: Get service health status
      description: Get the current health status of the service.
      operationId: health_v1alpha_admin_health_get
  /v1alpha/admin/version:
    get:
      responses:
        '200':
          description: Version information object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionInfo'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      tags:
      - Admin
      summary: Get service version
      description: Get the version of the service.
      operationId: version_v1alpha_admin_version_get
  /v1alpha/file-processors/process:
    post:
      responses:
        '200':
          description: The processed file chunks.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProcessFileResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      tags:
      - File Processors
      summary: Process a file into chunks ready for vector database storage.
      description: Process a file into chunks ready for vector database storage. Supports direct upload via multipart form or processing files already uploaded to file storage via file_id. Exactly one of file or file_id must be provided.
      operationId: process_file_v1alpha_file_processors_process_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_process_file_v1alpha_file_processors_process_post'
  /v1beta/connectors:
    get:
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListConnectorsResponse'
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      tags:
      - Connectors
      summary: List all connectors.
      description: List all configured connectors.
      operationId: list_connectors_v1beta_connectors_get
  /v1beta/connectors/{connector_id}/tools/{tool_name}:
    get:
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ToolDef'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      tags:
      - Connectors
      summary: Get a tool by name from a connector.
      description: Get a tool definition by its name from a connector.
      operationId: get_connector_tool_v1beta_connectors__connector_id__tools__tool_name__get
      parameters:
      - name: connector_id
        in: path
        required: true
        schema:
          type: string
          description: Identifier for the connector
          title: Connector Id
        description: Identifier for the connector
      - name: tool_name
        in: path
        required: true
        schema:
          type: string
          description: Name of the tool
          title: Tool Name
        description: Name of the tool
      - name: authorization
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Authorization token
          title: Authorization
        description: Authorization token
  /v1beta/connectors/{connector_id}/tools:
    get:
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListToolsResponse'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      tags:
      - Connectors
      summary: List tools from a connector.
      description: List all tools available from a connector.
      operationId: list_connector_tools_v1beta_connectors__connector_id__tools_get
      parameters:
      - name: connector_id
        in: path
        required: true
        schema:
          type: string
          description: Identifier for the connector
          title: Connector Id
        description: Identifier for the connector
      - name: authorization
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Authorization token
          title: Authorization
        description: Authorization token
  /v1beta/connectors/{connector_id}:
    get:
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Connector'
        '400':
          $ref: '#/components/responses/BadRequest400'
          description: Bad Request
        '429':
          $ref: '#/components/responses/TooManyRequests429'
          description: Too Many Requests
        '500':
          $ref: '#/components/responses/InternalServerError500'
          description: Internal Server Error
        default:
          $ref: '#/components/responses/DefaultError'
          description: Default Response
      tags:
      - Connectors
      summary: Get a connector by its ID.
      description: Get a connector by its ID.
      operationId: get_connector_v1beta_connectors__connector_id__get
      parameters:
      - name: connector_id
        in: path
        required: true
        schema:
          type: string
          description: Identifier for the connector
          title: Connector Id
        description: Identifier for the connector
      - name: authorization
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Authorization token
          title: Authorization
        description: Authorization token
  /v1alpha/interactions:
    post:
      responses:
        '200':
          description: A GoogleInteractionResponse or a stream of Google SSE events.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleInteractionResponse'
            text/event-stream: {}
        '400':
          description: Bad Request
          $ref: '#/components/responses/BadRequest400'
        '429':
          description: Too Many Requests
          $ref: '#/components/responses/TooManyRequests429'
        '500':
          description: Internal Server Error
          $ref: '#/components/responses/InternalServerError500'
        default:
          description: Default Response
          $ref: '#/components/responses/DefaultError'
      tags:
      - Interactions
      summary: Create an interaction.
      description: Create an interaction using the Google Interactions API format.
      operationId: create_interaction_v1alpha_interactions_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCreateInteractionRequest'
        required: true
      x-codeSamples:
      - lang: Python
        label: Google GenAI
        source: |-
          from google import genai
          from google.genai import types

          client = genai.Client(
              api_key="fake",
              http_options=types.HttpOptions(
                  base_url="http://localhost:8321",
                  api_version="v1alpha",
              ),
          )
          interaction = client.interactions.create(
              model="meta-llama/Llama-3.1-8B-Instruct",
              input="What is the capital of France?",
          )
          print(interaction.outputs[0].text)
components:
  schemas:
    Error:
      description: Error response from the API. Roughly follows RFC 7807.
      properties:
        status:
          title: Status
          type: integer
        title:
          title: Title
          type: string
        detail:
          title: Detail
          type: string
        instance:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
      required:
      - status
      - title
      - detail
      title: Error
      type: object
    ListBatchesResponse:
      properties:
        object:
          type: string
          title: Object
          enum:
          - list
        data:
          items:
            $ref: '#/components/schemas/Batch'
          type: array
          title: Data
          description: List of batch objects
        first_id:
          anyOf:
          - type: string
          - type: 'null'
          description: ID of the first batch in the list
        last_id:
          anyOf:
          - type: string
          - type: 'null'
          description: ID of the last batch in the list
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more batches available
          default: false
      type: object
      required:
      - data
      title: ListBatchesResponse
      description: Response containing a list of batch objects.
    CreateBatchRequest:
      properties:
        input_file_id:
          type: string
          title: Input File Id
          description: The ID of an uploaded file containing requests for the batch.
        endpoint:
          type: string
          title: Endpoint
          description: The endpoint to be used for all requests in the batch.
        completion_window:
          type: string
          title: Completion Window
          description: The time window within which the batch should be processed.
          enum:
          - 24h
        metadata:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          description: Optional metadata for the batch.
        idempotency_key:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional idempotency key. When provided, enables idempotent behavior.
      type: object
      required:
      - input_file_id
      - endpoint
      - completion_window
      title: CreateBatchRequest
      description: Request model for creating a batch.
    Batch:
      properties:
        id:
          type: string
          title: Id
        completion_window:
          type: string
          title: Completion Window
        created_at:
          type: integer
          title: Created At
        endpoint:
          type: string
          title: Endpoint
        input_file_id:
          type: string
          title: Input File Id
        object:
          type: string
          title: Object
          enum:
          - batch
        status:
          type: string
          enum:
          - validating
          - failed
          - in_progress
          - finalizing
          - completed
          - expired
          - cancelling
          - cancelled
          title: Status
        cancelled_at:
          anyOf:
          - type: integer
          - type: 'null'
        cancelling_at:
          anyOf:
          - type: integer
          - type: 'null'
        completed_at:
          anyOf:
          - type: integer
          - type: 'null'
        error_file_id:
          anyOf:
          - type: string
          - type: 'null'
        errors:
          anyOf:
          - $ref: '#/components/schemas/Errors'
            title: Errors
          - type: 'null'
          title: Errors
        expired_at:
          anyOf:
          - type: integer
          - type: 'null'
        expires_at:
          anyOf:
          - type: integer
          - type: 'null'
        failed_at:
          anyOf:
          - type: integer
          - type: 'null'
        finalizing_at:
          anyOf:
          - type: integer
          - type: 'null'
        in_progress_at:
          anyOf:
          - type: integer
          - type: 'null'
        metadata:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
        model:
          anyOf:
          - type: string
          - type: 'null'
        output_file_id:
          anyOf:
          - type: string
          - type: 'null'
        request_counts:
          anyOf:
          - $ref: '#/components/schemas/BatchRequestCounts'
            title: BatchRequestCounts
          - type: 'null'
          title: BatchRequestCounts
        usage:
          anyOf:
          - $ref: '#/components/schemas/BatchUsage'
            title: BatchUsage
          - type: 'null'
          title: BatchUsage
      additionalProperties: true
      type: object
      required:
      - id
      - completion_window
      - created_at
      - endpoint
      - input_file_id
      - object
      - status
      title: Batch
    Order:
      type: string
      enum:
      - asc
      - desc
      title: Order
      description: Sort order for paginated responses.
    ListOpenAIChatCompletionResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/OpenAICompletionWithInputMessages'
          type: array
          title: Data
          description: List of chat completion objects with their input messages.
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more completions available beyond this list.
        first_id:
          type: string
          title: First Id
          description: ID of the first completion in this list.
        last_id:
          type: string
          title: Last Id
          description: ID of the last completion in this list.
        object:
          type: string
          title: Object
          description: Must be 'list' to identify this as a list response.
          enum:
          - list
          default: list
      type: object
      required:
      - data
      - has_more
      - first_id
      - last_id
      title: ListOpenAIChatCompletionResponse
      description: Response from listing OpenAI-compatible chat completions.
    OpenAIAssistantMessageParam:
      additionalProperties: true
      description: A message containing the model's (assistant) response in an OpenAI-compatible chat completion request.
      properties:
        role:
          description: Must be 'assistant' to identify this as the model's response.
          title: Role
          type: string
          enum:
          - assistant
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam]
          - type: 'null'
          description: The content of the model's response.
          title: string | list[OpenAIChatCompletionContentPartTextParam]
          nullable: true
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the assistant message participant.
          nullable: true
        tool_calls:
          anyOf:
          - items:
              $ref: '#/components/schemas/ChatCompletionMessageToolCall'
            type: array
          - type: 'null'
          description: List of tool calls. Each tool call is an OpenAIChatCompletionToolCall object.
          nullable: true
      title: OpenAIAssistantMessageParam
      type: object
    OpenAIChatCompletionContentPartImageParam:
      properties:
        type:
          type: string
          title: Type
          description: Must be 'image_url' to identify this as image content.
          enum:
          - image_url
        image_url:
          $ref: '#/components/schemas/OpenAIImageURL'
          description: Image URL specification and processing details.
      type: object
      required:
      - image_url
      title: OpenAIChatCompletionContentPartImageParam
      description: Image content part for OpenAI-compatible chat completion messages.
    OpenAIChatCompletionContentPartParam:
      discriminator:
        mapping:
          file: '#/components/schemas/OpenAIFile'
          image_url: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
          text: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
        title: OpenAIChatCompletionContentPartTextParam
      - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
        title: OpenAIChatCompletionContentPartImageParam
      - $ref: '#/components/schemas/OpenAIFile'
        title: OpenAIFile
      title: OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile
    OpenAIChatCompletionContentPartTextParam:
      properties:
        type:
          type: string
          title: Type
          description: Must be 'text' to identify this as text content.
          enum:
          - text
        text:
          type: string
          title: Text
          description: The text content of the message.
      type: object
      required:
      - text
      title: OpenAIChatCompletionContentPartTextParam
      description: Text content part for OpenAI-compatible chat completion messages.
    OpenAIChatCompletionToolCallFunction:
      properties:
        name:
          type: string
          title: Name
          description: Name of the function to call.
        arguments:
          type: string
          title: Arguments
          description: Arguments to pass to the function as a JSON string.
      type: object
      required:
      - name
      - arguments
      title: OpenAIChatCompletionToolCallFunction
      description: Function call details for OpenAI-compatible tool calls.
    OpenAIChatCompletionUsage:
      properties:
        prompt_tokens:
          type: integer
          minimum: 0.0
          title: Prompt Tokens
          description: Number of tokens in the prompt.
          default: 0
        completion_tokens:
          type: integer
          minimum: 0.0
          title: Completion Tokens
          description: Number of tokens in the completion.
          default: 0
        total_tokens:
          type: integer
          minimum: 0.0
          title: Total Tokens
          description: Total tokens used (prompt + completion).
          default: 0
        prompt_tokens_details:
          $ref: '#/components/schemas/OpenAIChatCompletionUsagePromptTokensDetails'
          description: Detailed breakdown of input token usage.
        completion_tokens_details:
          $ref: '#/components/schemas/OpenAIChatCompletionUsageCompletionTokensDetails'
          description: Detailed breakdown of output token usage.
      type: object
      title: OpenAIChatCompletionUsage
      description: Usage information for OpenAI chat completion.
    OpenAIChoice:
      properties:
        message:
          $ref: '#/components/schemas/OpenAIChatCompletionResponseMessage'
          description: The message from the model.
        finish_reason:
          type: string
          enum:
          - stop
          - length
          - tool_calls
          - content_filter
          - function_call
          title: Finish Reason
          description: The reason the model stopped generating.
        index:
          type: integer
          minimum: 0.0
          title: Index
          description: The index of the choice.
        logprobs:
          anyOf:
          - properties:
              content:
                anyOf:
                - items:
                    $ref: '#/components/schemas/OpenAITokenLogProb'
                  type: array
                - type: 'null'
                description: The log probabilities for the tokens in the message.
              refusal:
                anyOf:
                - items:
                    $ref: '#/components/schemas/OpenAITokenLogProb'
                  type: array
                - type: 'null'
                description: The log probabilities for the refusal tokens.
            type: object
          - type: 'null'
          description: The log probabilities for the tokens in the message.
      type: object
      required:
      - message
      - finish_reason
      - index
      title: OpenAIChoice
      description: A choice from an OpenAI-compatible chat completion response.
    OpenAIChoiceLogprobs:
      properties:
        content:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITokenLogProb'
            type: array
          - type: 'null'
          description: The log probabilities for the tokens in the message.
        refusal:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITokenLogProb'
            type: array
          - type: 'null'
          description: The log probabilities for the refusal tokens.
      type: object
      title: OpenAIChoiceLogprobs
      description: The log probabilities for the tokens in the message from an OpenAI-compatible chat completion response.
    OpenAIDeveloperMessageParam:
      properties:
        role:
          type: string
          title: Role
          description: Must be 'developer' to identify this as a developer message.
          enum:
          - developer
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam]
          title: string | list[OpenAIChatCompletionContentPartTextParam]
          description: The content of the developer message.
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the developer message participant.
      type: object
      required:
      - content
      title: OpenAIDeveloperMessageParam
      description: A message from the developer in an OpenAI-compatible chat completion request.
    OpenAIFile:
      properties:
        type:
          type: string
          title: Type
          description: Must be 'file' to identify this as file content.
          enum:
          - file
        file:
          $ref: '#/components/schemas/OpenAIFileFile'
          description: File specification.
      required:
      - file
      title: OpenAIFile
      description: File content part for OpenAI-compatible chat completion messages.
    OpenAIFileFile:
      properties:
        file_data:
          anyOf:
          - type: string
          - type: 'null'
          description: Base64-encoded file data.
        file_id:
          anyOf:
          - type: string
          - type: 'null'
          description: ID of an uploaded file.
        filename:
          anyOf:
          - type: string
          - type: 'null'
          description: Name of the file.
      type: object
      title: OpenAIFileFile
      description: File reference for OpenAI-compatible file content.
    OpenAIImageURL:
      properties:
        url:
          type: string
          title: Url
          description: URL of the image to include in the message.
        detail:
          anyOf:
          - type: string
            enum:
            - low
            - high
            - auto
          - type: 'null'
          description: Level of detail for image processing. Can be 'low', 'high', or 'auto'.
      type: object
      required:
      - url
      title: OpenAIImageURL
      description: Image URL specification for OpenAI-compatible chat completion messages.
    OpenAIMessageParam:
      discriminator:
        mapping:
          assistant: '#/components/schemas/OpenAIAssistantMessageParam'
          developer: '#/components/schemas/OpenAIDeveloperMessageParam'
          system: '#/components/schemas/OpenAISystemMessageParam'
          tool: '#/components/schemas/OpenAIToolMessageParam'
          user: '#/components/schemas/OpenAIUserMessageParam'
        propertyName: role
      oneOf:
      - $ref: '#/components/schemas/OpenAIUserMessageParam'
        title: OpenAIUserMessageParam
      - $ref: '#/components/schemas/OpenAISystemMessageParam'
        title: OpenAISystemMessageParam
      - $ref: '#/components/schemas/OpenAIAssistantMessageParam'
        title: OpenAIAssistantMessageParam
      - $ref: '#/components/schemas/OpenAIToolMessageParam'
        title: OpenAIToolMessageParam
      - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
        title: OpenAIDeveloperMessageParam
      title: OpenAIUserMessageParam | ... (5 variants)
    OpenAISystemMessageParam:
      properties:
        role:
          type: string
          title: Role
          description: Must be 'system' to identify this as a system message.
          enum:
          - system
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam]
          title: string | list[OpenAIChatCompletionContentPartTextParam]
          description: The content of the 'system prompt'. If multiple system messages are provided, they are concatenated.
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the system message participant.
      type: object
      required:
      - content
      title: OpenAISystemMessageParam
      description: A system message providing instructions or context to the model.
    OpenAITokenLogProb:
      properties:
        token:
          type: string
          title: Token
          description: The token.
        bytes:
          anyOf:
          - items:
              type: integer
            type: array
          - type: 'null'
          description: The bytes for the token.
        logprob:
          type: number
          title: Logprob
          description: The log probability of the token.
        top_logprobs:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITopLogProb'
            type: array
          - type: 'null'
          description: The top log probabilities for the token.
      type: object
      required:
      - token
      - logprob
      title: OpenAITokenLogProb
      description: The log probability for a token from an OpenAI-compatible chat completion response.
    OpenAIToolMessageParam:
      properties:
        role:
          type: string
          title: Role
          description: Must be 'tool' to identify this as a tool response.
          enum:
          - tool
        tool_call_id:
          type: string
          title: Tool Call Id
          description: Unique identifier for the tool call this response is for.
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam]
          title: string | list[OpenAIChatCompletionContentPartTextParam]
          description: The response content from the tool.
      type: object
      required:
      - tool_call_id
      - content
      title: OpenAIToolMessageParam
      description: A message representing the result of a tool invocation in an OpenAI-compatible chat completion request.
    OpenAITopLogProb:
      properties:
        token:
          type: string
          title: Token
          description: The token.
        bytes:
          anyOf:
          - items:
              type: integer
            type: array
          - type: 'null'
          description: The bytes for the token.
        logprob:
          type: number
          title: Logprob
          description: The log probability of the token.
      type: object
      required:
      - token
      - logprob
      title: OpenAITopLogProb
      description: The top log probability for a token from an OpenAI-compatible chat completion response.
    OpenAIUserMessageParam:
      description: A message from the user in an OpenAI-compatible chat completion request.
      properties:
        role:
          description: Must be 'user' to identify this as a user message.
          title: Role
          type: string
          enum:
          - user
        content:
          anyOf:
          - type: string
          - items:
              discriminator:
                mapping:
                  file: '#/components/schemas/OpenAIFile'
                  image_url: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                  text: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
                title: OpenAIChatCompletionContentPartTextParam
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                title: OpenAIChatCompletionContentPartImageParam
              - $ref: '#/components/schemas/OpenAIFile'
                title: OpenAIFile
              title: OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile]
          description: The content of the message, which can include text and other media.
          title: string | list[OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile]
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the user message participant.
          nullable: true
      required:
      - content
      title: OpenAIUserMessageParam
      type: object
    OpenAIJSONSchema:
      properties:
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
        strict:
          anyOf:
          - type: boolean
          - type: 'null'
        schema:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
      type: object
      title: OpenAIJSONSchema
      description: JSON schema specification for OpenAI-compatible structured response format.
    OpenAIResponseFormatJSONObject:
      properties:
        type:
          type: string
          title: Type
          description: Must be 'json_object' to indicate generic JSON object response format.
          enum:
          - json_object
      type: object
      title: OpenAIResponseFormatJSONObject
      description: JSON object response format for OpenAI-compatible chat completion requests.
    OpenAIResponseFormatJSONSchema:
      properties:
        type:
          type: string
          title: Type
          description: Must be 'json_schema' to indicate structured JSON response format.
          enum:
          - json_schema
        json_schema:
          $ref: '#/components/schemas/OpenAIJSONSchema'
          description: The JSON schema specification for the response.
      type: object
      required:
      - json_schema
      title: OpenAIResponseFormatJSONSchema
      description: JSON schema response format for OpenAI-compatible chat completion requests.
    OpenAIResponseFormatParam:
      discriminator:
        mapping:
          json_object: '#/components/schemas/OpenAIResponseFormatJSONObject'
          json_schema: '#/components/schemas/OpenAIResponseFormatJSONSchema'
          text: '#/components/schemas/OpenAIResponseFormatText'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseFormatText'
        title: OpenAIResponseFormatText
      - $ref: '#/components/schemas/OpenAIResponseFormatJSONSchema'
        title: OpenAIResponseFormatJSONSchema
      - $ref: '#/components/schemas/OpenAIResponseFormatJSONObject'
        title: OpenAIResponseFormatJSONObject
      title: OpenAIResponseFormatText | OpenAIResponseFormatJSONSchema | OpenAIResponseFormatJSONObject
    OpenAIResponseFormatText:
      properties:
        type:
          type: string
          title: Type
          description: Must be 'text' to indicate plain text response format.
          enum:
          - text
      type: object
      title: OpenAIResponseFormatText
      description: Text response format for OpenAI-compatible chat completion requests.
    OpenAIChatCompletionRequestWithExtraBody:
      properties:
        model:
          type: string
          title: Model
          description: The identifier of the model to use.
        messages:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIUserMessageParam-Input'
              title: OpenAIUserMessageParam-Input
            - $ref: '#/components/schemas/OpenAISystemMessageParam'
              title: OpenAISystemMessageParam
            - $ref: '#/components/schemas/OpenAIAssistantMessageParam-Input'
              title: OpenAIAssistantMessageParam-Input
            - $ref: '#/components/schemas/OpenAIToolMessageParam'
              title: OpenAIToolMessageParam
            - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
              title: OpenAIDeveloperMessageParam
            discriminator:
              propertyName: role
              mapping:
                assistant: '#/components/schemas/OpenAIAssistantMessageParam-Input'
                developer: '#/components/schemas/OpenAIDeveloperMessageParam'
                system: '#/components/schemas/OpenAISystemMessageParam'
                tool: '#/components/schemas/OpenAIToolMessageParam'
                user: '#/components/schemas/OpenAIUserMessageParam-Input'
            title: OpenAIUserMessageParam-Input | ... (5 variants)
          type: array
          minItems: 1
          title: Messages
          description: List of messages in the conversation.
        frequency_penalty:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: -2.0
          - type: 'null'
          description: The penalty for repeated tokens.
        function_call:
          anyOf:
          - type: string
          - additionalProperties: true
            type: object
          - type: 'null'
          title: string | object
          description: The function call to use.
        functions:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          description: List of functions to use.
        logit_bias:
          anyOf:
          - additionalProperties:
              type: number
            type: object
          - type: 'null'
          description: The logit bias to use.
        logprobs:
          anyOf:
          - type: boolean
          - type: 'null'
          description: The log probabilities to use.
        max_completion_tokens:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: The maximum number of tokens to generate.
        max_tokens:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: The maximum number of tokens to generate.
        n:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: The number of completions to generate.
        parallel_tool_calls:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Whether to parallelize tool calls.
        presence_penalty:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: -2.0
          - type: 'null'
          description: The penalty for repeated tokens.
        response_format:
          anyOf:
          - oneOf:
            - $ref: '#/components/schemas/OpenAIResponseFormatText'
              title: OpenAIResponseFormatText
            - $ref: '#/components/schemas/OpenAIResponseFormatJSONSchema'
              title: OpenAIResponseFormatJSONSchema
            - $ref: '#/components/schemas/OpenAIResponseFormatJSONObject'
              title: OpenAIResponseFormatJSONObject
            discriminator:
              propertyName: type
              mapping:
                json_object: '#/components/schemas/OpenAIResponseFormatJSONObject'
                json_schema: '#/components/schemas/OpenAIResponseFormatJSONSchema'
                text: '#/components/schemas/OpenAIResponseFormatText'
            title: OpenAIResponseFormatText | OpenAIResponseFormatJSONSchema | OpenAIResponseFormatJSONObject
          - type: 'null'
          title: Response Format
          description: The response format to use.
        seed:
          anyOf:
          - type: integer
          - type: 'null'
          description: The seed to use.
        stop:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
            title: list[string]
          - type: 'null'
          title: string | list[string]
          description: The stop tokens to use.
        stream:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Whether to stream the response.
        stream_options:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: The stream options to use.
        temperature:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: 0.0
          - type: 'null'
          description: The temperature to use.
        tool_choice:
          anyOf:
          - type: string
          - additionalProperties: true
            type: object
          - type: 'null'
          title: string | object
          description: The tool choice to use.
        tools:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          description: The tools to use.
        top_logprobs:
          anyOf:
          - type: integer
            maximum: 20.0
            minimum: 0.0
          - type: 'null'
          description: The number of most likely tokens to return at each position.
        top_p:
          anyOf:
          - type: number
            maximum: 1.0
            minimum: 0.0
          - type: 'null'
          description: The top p to use.
        user:
          anyOf:
          - type: string
          - type: 'null'
          description: The user to use.
        safety_identifier:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          description: A stable identifier used for safety monitoring and abuse detection.
        service_tier:
          anyOf:
          - $ref: '#/components/schemas/ServiceTier'
            title: ServiceTier
          - type: 'null'
          description: The service tier to use for this request.
          title: ServiceTier
        reasoning_effort:
          anyOf:
          - type: string
            enum:
            - none
            - minimal
            - low
            - medium
            - high
            - xhigh
          - type: 'null'
          description: The effort level for reasoning models.
        prompt_cache_key:
          anyOf:
          - type: string
            maxLength: 64
          - type: 'null'
          description: A key to use when reading from or writing to the prompt cache.
      additionalProperties: true
      type: object
      required:
      - model
      - messages
      title: OpenAIChatCompletionRequestWithExtraBody
      description: Request parameters for OpenAI-compatible chat completion endpoint.
    OpenAIChatCompletion:
      description: Response from an OpenAI-compatible chat completion request.
      properties:
        id:
          description: The ID of the chat completion.
          title: Id
          type: string
        choices:
          description: List of choices.
          items:
            $ref: '#/components/schemas/OpenAIChoice'
          minItems: 1
          title: Choices
          type: array
        object:
          description: The object type.
          title: Object
          type: string
          enum:
          - chat.completion
        created:
          description: The Unix timestamp in seconds when the chat completion was created.
          minimum: 0
          title: Created
          type: integer
        model:
          description: The model that was used to generate the chat completion.
          title: Model
          type: string
        service_tier:
          anyOf:
          - type: string
          - type: 'null'
          description: The service tier that was used for this response.
          nullable: true
        system_fingerprint:
          description: System fingerprint for this completion.
          title: System Fingerprint
          type: string
          nullable: true
        usage:
          $ref: '#/components/schemas/OpenAIChatCompletionUsage'
          description: Token usage information for the completion.
          nullable: true
      required:
      - id
      - choices
      - created
      - model
      title: OpenAIChatCompletion
      type: object
    OpenAIChatCompletionChunk:
      description: Chunk from a streaming response to an OpenAI-compatible chat completion request.
      properties:
        id:
          description: The ID of the chat completion.
          title: Id
          type: string
        choices:
          description: List of choices.
          items:
            $ref: '#/components/schemas/OpenAIChunkChoice'
          title: Choices
          type: array
        object:
          description: The object type.
          title: Object
          type: string
          enum:
          - chat.completion.chunk
        created:
          description: The Unix timestamp in seconds when the chat completion was created.
          minimum: 0
          title: Created
          type: integer
        model:
          description: The model that was used to generate the chat completion.
          title: Model
          type: string
        service_tier:
          anyOf:
          - type: string
          - type: 'null'
          description: The service tier that was used for this response.
          nullable: true
        system_fingerprint:
          description: System fingerprint for this completion chunk.
          title: System Fingerprint
          type: string
          nullable: true
        usage:
          $ref: '#/components/schemas/OpenAIChatCompletionUsage'
          description: Token usage information (typically included in final chunk with stream_options).
          nullable: true
      required:
      - id
      - choices
      - created
      - model
      title: OpenAIChatCompletionChunk
      type: object
    OpenAIChoiceDelta:
      description: A delta from an OpenAI-compatible chat completion streaming response.
      properties:
        content:
          anyOf:
          - type: string
          - type: 'null'
          description: The content of the delta.
          nullable: true
        refusal:
          anyOf:
          - type: string
          - type: 'null'
          description: The refusal of the delta.
          nullable: true
        role:
          description: The role of the delta.
          enum:
          - developer
          - system
          - user
          - assistant
          - tool
          title: Role
          type: string
          nullable: true
        tool_calls:
          description: The tool calls of the delta.
          items:
            $ref: '#/components/schemas/ChatCompletionMessageToolCall'
          title: Tool Calls
          type: array
          nullable: true
        reasoning_content:
          anyOf:
          - type: string
          - type: 'null'
          description: The reasoning content from the model (for o1/o3 models).
          nullable: true
      title: OpenAIChoiceDelta
      type: object
    OpenAIChunkChoice:
      description: A chunk choice from an OpenAI-compatible chat completion streaming response.
      properties:
        delta:
          $ref: '#/components/schemas/OpenAIChoiceDelta'
          description: The delta from the chunk.
        finish_reason:
          description: The reason the model stopped generating.
          enum:
          - stop
          - length
          - tool_calls
          - content_filter
          - function_call
          nullable: true
          title: Finish Reason
          type: string
        index:
          description: The index of the choice.
          minimum: 0
          title: Index
          type: integer
        logprobs:
          properties:
            content:
              anyOf:
              - items:
                  $ref: '#/components/schemas/OpenAITokenLogProb'
                type: array
              - type: 'null'
              description: The log probabilities for the tokens in the message.
            refusal:
              anyOf:
              - items:
                  $ref: '#/components/schemas/OpenAITokenLogProb'
                type: array
              - type: 'null'
              description: The log probabilities for the refusal tokens.
          type: object
          description: The log probabilities for the tokens in the message.
      required:
      - delta
      - index
      title: OpenAIChunkChoice
      type: object
    OpenAICompletionWithInputMessages:
      properties:
        id:
          type: string
          title: Id
          description: The ID of the chat completion.
        choices:
          items:
            $ref: '#/components/schemas/OpenAIChoice'
          type: array
          minItems: 1
          title: Choices
          description: List of choices.
        object:
          type: string
          title: Object
          description: The object type.
          enum:
          - chat.completion
        created:
          type: integer
          minimum: 0.0
          title: Created
          description: The Unix timestamp in seconds when the chat completion was created.
        model:
          type: string
          title: Model
          description: The model that was used to generate the chat completion.
        service_tier:
          anyOf:
          - type: string
          - type: 'null'
          description: The service tier that was used for this response.
        system_fingerprint:
          type: string
          title: System Fingerprint
          description: System fingerprint for this completion.
        usage:
          $ref: '#/components/schemas/OpenAIChatCompletionUsage'
          description: Token usage information for the completion.
        input_messages:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIUserMessageParam-Output'
              title: OpenAIUserMessageParam-Output
            - $ref: '#/components/schemas/OpenAISystemMessageParam'
              title: OpenAISystemMessageParam
            - $ref: '#/components/schemas/OpenAIAssistantMessageParam-Output'
              title: OpenAIAssistantMessageParam-Output
            - $ref: '#/components/schemas/OpenAIToolMessageParam'
              title: OpenAIToolMessageParam
            - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
              title: OpenAIDeveloperMessageParam
            discriminator:
              propertyName: role
              mapping:
                assistant: '#/components/schemas/OpenAIAssistantMessageParam-Output'
                developer: '#/components/schemas/OpenAIDeveloperMessageParam'
                system: '#/components/schemas/OpenAISystemMessageParam'
                tool: '#/components/schemas/OpenAIToolMessageParam'
                user: '#/components/schemas/OpenAIUserMessageParam-Output'
            title: OpenAIUserMessageParam-Output | ... (5 variants)
          type: array
          title: Input Messages
          description: The input messages used to generate this completion.
      type: object
      required:
      - id
      - choices
      - created
      - model
      - input_messages
      title: OpenAICompletionWithInputMessages
      description: Chat completion response extended with the original input messages.
    OpenAICompletionRequestWithExtraBody:
      properties:
        model:
          type: string
          title: Model
          description: The identifier of the model to use.
        prompt:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
            title: list[string]
          - items:
              type: integer
            type: array
            title: list[integer]
          - items:
              items:
                type: integer
              type: array
            type: array
            title: list[array]
          title: string | ... (4 variants)
          description: The prompt to generate a completion for.
        best_of:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: The number of completions to generate.
        echo:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Whether to echo the prompt.
        frequency_penalty:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: -2.0
          - type: 'null'
          description: The penalty for repeated tokens.
        logit_bias:
          anyOf:
          - additionalProperties:
              type: number
            type: object
          - type: 'null'
          description: The logit bias to use.
        logprobs:
          anyOf:
          - type: boolean
          - type: 'null'
          description: The log probabilities to use.
        max_tokens:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: The maximum number of tokens to generate.
        n:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: The number of completions to generate.
        presence_penalty:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: -2.0
          - type: 'null'
          description: The penalty for repeated tokens.
        seed:
          anyOf:
          - type: integer
          - type: 'null'
          description: The seed to use.
        stop:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
            title: list[string]
          - type: 'null'
          title: string | list[string]
          description: The stop tokens to use.
        stream:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Whether to stream the response.
        stream_options:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: The stream options to use.
        temperature:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: 0.0
          - type: 'null'
          description: The temperature to use.
        top_p:
          anyOf:
          - type: number
            maximum: 1.0
            minimum: 0.0
          - type: 'null'
          description: The top p to use.
        user:
          anyOf:
          - type: string
          - type: 'null'
          description: The user to use.
        suffix:
          anyOf:
          - type: string
          - type: 'null'
          description: The suffix that should be appended to the completion.
      additionalProperties: true
      type: object
      required:
      - model
      - prompt
      title: OpenAICompletionRequestWithExtraBody
      description: Request parameters for OpenAI-compatible completion endpoint.
    OpenAICompletion:
      description: Response from an OpenAI-compatible completion request.
      properties:
        id:
          description: The ID of the completion.
          title: Id
          type: string
        choices:
          description: List of choices.
          items:
            $ref: '#/components/schemas/OpenAICompletionChoice'
          minItems: 1
          title: Choices
          type: array
        created:
          description: The Unix timestamp in seconds when the completion was created.
          minimum: 0
          title: Created
          type: integer
        model:
          description: The model that was used to generate the completion.
          title: Model
          type: string
        object:
          description: The object type.
          title: Object
          type: string
          enum:
          - text_completion
      required:
      - id
      - choices
      - created
      - model
      title: OpenAICompletion
      type: object
    OpenAICompletionChoice:
      description: A choice from an OpenAI-compatible completion response.
      properties:
        finish_reason:
          description: The reason the model stopped generating.
          enum:
          - stop
          - length
          - tool_calls
          - content_filter
          - function_call
          title: Finish Reason
          type: string
        text:
          description: The text of the choice.
          title: Text
          type: string
        index:
          description: The index of the choice.
          minimum: 0
          title: Index
          type: integer
        logprobs:
          anyOf:
          - properties:
              content:
                anyOf:
                - items:
                    $ref: '#/components/schemas/OpenAITokenLogProb'
                  type: array
                - type: 'null'
                description: The log probabilities for the tokens in the message.
              refusal:
                anyOf:
                - items:
                    $ref: '#/components/schemas/OpenAITokenLogProb'
                  type: array
                - type: 'null'
                description: The log probabilities for the refusal tokens.
            type: object
          - type: 'null'
          description: The log probabilities for the tokens in the choice.
          nullable: true
      required:
      - finish_reason
      - text
      - index
      title: OpenAICompletionChoice
      type: object
    ConversationItem:
      discriminator:
        mapping:
          file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
          function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
          function_call_output: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
          mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          mcp_approval_response: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
          mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
          mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
          message: '#/components/schemas/OpenAIResponseMessage'
          reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
          web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseMessage'
        title: OpenAIResponseMessage
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
        title: OpenAIResponseOutputMessageWebSearchToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
        title: OpenAIResponseOutputMessageFileSearchToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
        title: OpenAIResponseOutputMessageFunctionToolCall
      - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
        title: OpenAIResponseInputFunctionToolCallOutput
      - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
        title: OpenAIResponseMCPApprovalRequest
      - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
        title: OpenAIResponseMCPApprovalResponse
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
        title: OpenAIResponseOutputMessageMCPCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
        title: OpenAIResponseOutputMessageMCPListTools
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
        title: OpenAIResponseOutputMessageReasoningItem
      title: OpenAIResponseMessage | ... (10 variants)
    OpenAIResponseAnnotationCitation:
      properties:
        type:
          type: string
          title: Type
          enum:
          - url_citation
        end_index:
          type: integer
          title: End Index
        start_index:
          type: integer
          title: Start Index
        title:
          type: string
          title: Title
        url:
          type: string
          title: Url
      type: object
      required:
      - end_index
      - start_index
      - title
      - url
      title: OpenAIResponseAnnotationCitation
      description: URL citation annotation for referencing external web resources.
    OpenAIResponseAnnotationContainerFileCitation:
      properties:
        type:
          type: string
          title: Type
          enum:
          - container_file_citation
        container_id:
          type: string
          title: Container Id
        end_index:
          type: integer
          title: End Index
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        start_index:
          type: integer
          title: Start Index
      type: object
      required:
      - container_id
      - end_index
      - file_id
      - filename
      - start_index
      title: OpenAIResponseAnnotationContainerFileCitation
      description: Container file citation annotation referencing a file within a container.
    OpenAIResponseAnnotationFileCitation:
      properties:
        type:
          type: string
          title: Type
          enum:
          - file_citation
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        index:
          type: integer
          title: Index
      type: object
      required:
      - file_id
      - filename
      - index
      title: OpenAIResponseAnnotationFileCitation
      description: File citation annotation for referencing specific files in response content.
    OpenAIResponseAnnotationFilePath:
      properties:
        type:
          type: string
          title: Type
          enum:
          - file_path
        file_id:
          type: string
          title: File Id
        index:
          type: integer
          title: Index
      type: object
      required:
      - file_id
      - index
      title: OpenAIResponseAnnotationFilePath
      description: File path annotation referencing a generated file in response content.
    OpenAIResponseAnnotations:
      discriminator:
        mapping:
          container_file_citation: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
          file_citation: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
          file_path: '#/components/schemas/OpenAIResponseAnnotationFilePath'
          url_citation: '#/components/schemas/OpenAIResponseAnnotationCitation'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
        title: OpenAIResponseAnnotationFileCitation
      - $ref: '#/components/schemas/OpenAIResponseAnnotationCitation'
        title: OpenAIResponseAnnotationCitation
      - $ref: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
        title: OpenAIResponseAnnotationContainerFileCitation
      - $ref: '#/components/schemas/OpenAIResponseAnnotationFilePath'
        title: OpenAIResponseAnnotationFilePath
      title: OpenAIResponseAnnotationFileCitation | ... (4 variants)
    OpenAIResponseContentPartRefusal:
      properties:
        type:
          type: string
          title: Type
          enum:
          - refusal
        refusal:
          type: string
          title: Refusal
      type: object
      required:
      - refusal
      title: OpenAIResponseContentPartRefusal
      description: Refusal content within a streamed response part.
    OpenAIResponseInputFunctionToolCallOutput:
      properties:
        call_id:
          type: string
          title: Call Id
        output:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
                title: OpenAIResponseInputMessageContentText
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                title: OpenAIResponseInputMessageContentImage
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                title: OpenAIResponseInputMessageContentFile
              discriminator:
                propertyName: type
                mapping:
                  input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                  input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                  input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
              title: OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile
            type: array
            title: list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile]
          title: string | list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile]
        type:
          type: string
          title: Type
          enum:
          - function_call_output
        id:
          anyOf:
          - type: string
          - type: 'null'
        status:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - call_id
      - output
      title: OpenAIResponseInputFunctionToolCallOutput
      description: This represents the output of a function call that gets passed back to the model.
    OpenAIResponseInputMessageContent:
      discriminator:
        mapping:
          input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
          input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
          input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
        title: OpenAIResponseInputMessageContentText
      - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
        title: OpenAIResponseInputMessageContentImage
      - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
        title: OpenAIResponseInputMessageContentFile
      title: OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile
    OpenAIResponseInputMessageContentFile:
      properties:
        type:
          type: string
          title: Type
          enum:
          - input_file
        file_data:
          anyOf:
          - type: string
          - type: 'null'
        file_id:
          anyOf:
          - type: string
          - type: 'null'
        file_url:
          anyOf:
          - type: string
          - type: 'null'
        filename:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      title: OpenAIResponseInputMessageContentFile
      description: File content for input messages in OpenAI response format.
    OpenAIResponseInputMessageContentImage:
      properties:
        detail:
          anyOf:
          - type: string
            enum:
            - low
          - type: string
            enum:
            - high
          - type: string
            enum:
            - auto
          title: string
          default: auto
        type:
          type: string
          title: Type
          enum:
          - input_image
        file_id:
          anyOf:
          - type: string
          - type: 'null'
        image_url:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      title: OpenAIResponseInputMessageContentImage
      description: Image content for input messages in OpenAI response format.
    OpenAIResponseInputMessageContentText:
      properties:
        text:
          type: string
          title: Text
        type:
          type: string
          title: Type
          enum:
          - input_text
      type: object
      required:
      - text
      title: OpenAIResponseInputMessageContentText
      description: Text content for input messages in OpenAI response format.
    OpenAIResponseMCPApprovalRequest:
      properties:
        arguments:
          type: string
          title: Arguments
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        server_label:
          type: string
          title: Server Label
        type:
          type: string
          title: Type
          enum:
          - mcp_approval_request
      type: object
      required:
      - arguments
      - id
      - name
      - server_label
      title: OpenAIResponseMCPApprovalRequest
      description: A request for human approval of a tool invocation.
    OpenAIResponseMCPApprovalResponse:
      properties:
        approval_request_id:
          type: string
          title: Approval Request Id
        approve:
          type: boolean
          title: Approve
        type:
          type: string
          title: Type
          enum:
          - mcp_approval_response
        id:
          anyOf:
          - type: string
          - type: 'null'
        reason:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - approval_request_id
      - approve
      title: OpenAIResponseMCPApprovalResponse
      description: A response to an MCP approval request.
    OpenAIResponseMessage:
      description: |-
        Corresponds to the various Message types in the Responses API.
        They are all under one type because the Responses API gives them all
        the same "type" value, and there is no way to tell them apart in certain
        scenarios.
      properties:
        content:
          anyOf:
          - type: string
          - items:
              discriminator:
                mapping:
                  input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                  input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                  input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
                title: OpenAIResponseInputMessageContentText
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                title: OpenAIResponseInputMessageContentImage
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                title: OpenAIResponseInputMessageContentFile
              title: OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile
            type: array
            title: list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile]
          - items:
              discriminator:
                mapping:
                  output_text: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
                  refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
                title: OpenAIResponseOutputMessageContentOutputText
              - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
                title: OpenAIResponseContentPartRefusal
              title: OpenAIResponseOutputMessageContentOutputText | OpenAIResponseContentPartRefusal
            type: array
            title: list[OpenAIResponseOutputMessageContentOutputText | OpenAIResponseContentPartRefusal]
          title: string | list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile] | list[OpenAIResponseOutputMessageContentOutputText | OpenAIResponseContentPartRefusal]
        role:
          anyOf:
          - type: string
            enum:
            - system
          - type: string
            enum:
            - developer
          - type: string
            enum:
            - user
          - type: string
            enum:
            - assistant
          title: string
        type:
          title: Type
          type: string
          enum:
          - message
        id:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        status:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
      required:
      - content
      - role
      title: OpenAIResponseMessage
      type: object
    OpenAIResponseOutputMessageContent:
      discriminator:
        mapping:
          output_text: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
          refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText'
        title: OpenAIResponseOutputMessageContentOutputText
      - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
        title: OpenAIResponseContentPartRefusal
      title: OpenAIResponseOutputMessageContentOutputText | OpenAIResponseContentPartRefusal
    OpenAIResponseOutputMessageContentOutputText:
      description: Text content within an output message of an OpenAI response.
      properties:
        text:
          title: Text
          type: string
        type:
          title: Type
          type: string
          enum:
          - output_text
        annotations:
          items:
            discriminator:
              mapping:
                container_file_citation: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
                file_citation: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
                file_path: '#/components/schemas/OpenAIResponseAnnotationFilePath'
                url_citation: '#/components/schemas/OpenAIResponseAnnotationCitation'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
              title: OpenAIResponseAnnotationFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationCitation'
              title: OpenAIResponseAnnotationCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
              title: OpenAIResponseAnnotationContainerFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFilePath'
              title: OpenAIResponseAnnotationFilePath
            title: OpenAIResponseAnnotationFileCitation | ... (4 variants)
          title: Annotations
          type: array
        logprobs:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITokenLogProb'
            type: array
          - type: 'null'
          nullable: true
      required:
      - text
      title: OpenAIResponseOutputMessageContentOutputText
      type: object
    OpenAIResponseOutputMessageFileSearchToolCall:
      properties:
        id:
          type: string
          title: Id
        queries:
          items:
            type: string
          type: array
          title: Queries
        status:
          type: string
          title: Status
        type:
          type: string
          title: Type
          enum:
          - file_search_call
        results:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCallResults'
            type: array
          - type: 'null'
      type: object
      required:
      - id
      - queries
      - status
      title: OpenAIResponseOutputMessageFileSearchToolCall
      description: File search tool call output message for OpenAI responses.
    OpenAIResponseOutputMessageFunctionToolCall:
      properties:
        call_id:
          type: string
          title: Call Id
        name:
          type: string
          title: Name
        arguments:
          type: string
          title: Arguments
        type:
          type: string
          title: Type
          enum:
          - function_call
        id:
          anyOf:
          - type: string
          - type: 'null'
        status:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - call_id
      - name
      - arguments
      title: OpenAIResponseOutputMessageFunctionToolCall
      description: Function tool call output message for OpenAI responses.
    OpenAIResponseOutputMessageMCPCall:
      properties:
        id:
          type: string
          title: Id
        type:
          type: string
          title: Type
          enum:
          - mcp_call
        arguments:
          type: string
          title: Arguments
        name:
          type: string
          title: Name
        server_label:
          type: string
          title: Server Label
        error:
          anyOf:
          - type: string
          - type: 'null'
        output:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - id
      - arguments
      - name
      - server_label
      title: OpenAIResponseOutputMessageMCPCall
      description: Model Context Protocol (MCP) call output message for OpenAI responses.
    OpenAIResponseOutputMessageMCPListTools:
      properties:
        id:
          type: string
          title: Id
        type:
          type: string
          title: Type
          enum:
          - mcp_list_tools
        server_label:
          type: string
          title: Server Label
        tools:
          items:
            $ref: '#/components/schemas/MCPListToolsTool'
          type: array
          title: Tools
      type: object
      required:
      - id
      - server_label
      - tools
      title: OpenAIResponseOutputMessageMCPListTools
      description: MCP list tools output message containing available tools from an MCP server.
    OpenAIResponseOutputMessageWebSearchToolCall:
      properties:
        id:
          type: string
          title: Id
        status:
          type: string
          title: Status
        type:
          type: string
          title: Type
          enum:
          - web_search_call
      type: object
      required:
      - id
      - status
      title: OpenAIResponseOutputMessageWebSearchToolCall
      description: Web search tool call output message for OpenAI responses.
    CreateConversationRequest:
      properties:
        items:
          anyOf:
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseMessage-Input'
                title: OpenAIResponseMessage-Input
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
                title: OpenAIResponseOutputMessageWebSearchToolCall
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
                title: OpenAIResponseOutputMessageFileSearchToolCall
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
                title: OpenAIResponseOutputMessageFunctionToolCall
              - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
                title: OpenAIResponseInputFunctionToolCallOutput
              - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
                title: OpenAIResponseMCPApprovalRequest
              - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
                title: OpenAIResponseMCPApprovalResponse
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
                title: OpenAIResponseOutputMessageMCPCall
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
                title: OpenAIResponseOutputMessageMCPListTools
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
                title: OpenAIResponseOutputMessageReasoningItem
              discriminator:
                propertyName: type
                mapping:
                  file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
                  function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
                  function_call_output: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
                  mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
                  mcp_approval_response: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
                  mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
                  mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
                  message: '#/components/schemas/OpenAIResponseMessage-Input'
                  reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
                  web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
              title: OpenAIResponseMessage-Input | ... (10 variants)
            type: array
          - type: 'null'
          description: Initial items to include in the conversation context.
        metadata:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          description: Set of key-value pairs that can be attached to an object.
      type: object
      title: CreateConversationRequest
      description: Request model for creating a conversation.
    Conversation:
      properties:
        id:
          type: string
          title: Id
          description: The unique ID of the conversation.
        object:
          type: string
          title: Object
          description: The object type, which is always conversation.
          enum:
          - conversation
          default: conversation
        created_at:
          type: integer
          title: Created At
          description: The time at which the conversation was created, measured in seconds since the Unix epoch.
        metadata:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
          description: Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard.
        items:
          anyOf:
          - items:
              additionalProperties: true
              type: object
            type: array
          - type: 'null'
          description: Initial items to include in the conversation context. You may add up to 20 items at a time.
      type: object
      required:
      - id
      - created_at
      title: Conversation
      description: OpenAI-compatible conversation object.
    UpdateConversationRequest:
      properties:
        metadata:
          additionalProperties:
            type: string
          type: object
          title: Metadata
          description: Set of key-value pairs that can be attached to an object.
      type: object
      required:
      - metadata
      title: UpdateConversationRequest
      description: Request model for updating a conversation's metadata.
    ConversationDeletedResource:
      properties:
        id:
          type: string
          title: Id
          description: The deleted conversation identifier
        object:
          type: string
          title: Object
          description: Object type
          default: conversation.deleted
        deleted:
          type: boolean
          title: Deleted
          description: Whether the object was deleted
          default: true
      type: object
      required:
      - id
      title: ConversationDeletedResource
      description: Response for deleted conversation.
    ConversationItemList:
      properties:
        object:
          type: string
          title: Object
          description: Object type
          default: list
        data:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseMessage-Output'
              title: OpenAIResponseMessage-Output
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
              title: OpenAIResponseOutputMessageWebSearchToolCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              title: OpenAIResponseOutputMessageFileSearchToolCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              title: OpenAIResponseOutputMessageFunctionToolCall
            - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
              title: OpenAIResponseInputFunctionToolCallOutput
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
              title: OpenAIResponseMCPApprovalRequest
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
              title: OpenAIResponseMCPApprovalResponse
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              title: OpenAIResponseOutputMessageMCPCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              title: OpenAIResponseOutputMessageMCPListTools
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
              title: OpenAIResponseOutputMessageReasoningItem
            discriminator:
              propertyName: type
              mapping:
                file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
                function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
                function_call_output: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
                mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
                mcp_approval_response: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
                mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
                mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
                message: '#/components/schemas/OpenAIResponseMessage-Output'
                reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
                web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            title: OpenAIResponseMessage-Output | ... (10 variants)
          type: array
          title: Data
          description: List of conversation items
        first_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The ID of the first item in the list
        last_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The ID of the last item in the list
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more items available
          default: false
      type: object
      required:
      - data
      title: ConversationItemList
      description: List of conversation items with pagination.
    AddItemsRequest:
      properties:
        items:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseMessage-Input'
              title: OpenAIResponseMessage-Input
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
              title: OpenAIResponseOutputMessageWebSearchToolCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              title: OpenAIResponseOutputMessageFileSearchToolCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              title: OpenAIResponseOutputMessageFunctionToolCall
            - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
              title: OpenAIResponseInputFunctionToolCallOutput
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
              title: OpenAIResponseMCPApprovalRequest
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
              title: OpenAIResponseMCPApprovalResponse
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              title: OpenAIResponseOutputMessageMCPCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              title: OpenAIResponseOutputMessageMCPListTools
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
              title: OpenAIResponseOutputMessageReasoningItem
            discriminator:
              propertyName: type
              mapping:
                file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
                function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
                function_call_output: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
                mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
                mcp_approval_response: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
                mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
                mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
                message: '#/components/schemas/OpenAIResponseMessage-Input'
                reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
                web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            title: OpenAIResponseMessage-Input | ... (10 variants)
          type: array
          maxItems: 20
          title: Items
          description: Items to include in the conversation context. You may add up to 20 items at a time.
      type: object
      required:
      - items
      title: AddItemsRequest
      description: Request model for adding items to a conversation.
    ConversationItemDeletedResource:
      properties:
        id:
          type: string
          title: Id
          description: The deleted item identifier
        object:
          type: string
          title: Object
          description: Object type
          default: conversation.item.deleted
        deleted:
          type: boolean
          title: Deleted
          description: Whether the object was deleted
          default: true
      type: object
      required:
      - id
      title: ConversationItemDeletedResource
      description: Response for deleted conversation item.
    OpenAIEmbeddingsRequestWithExtraBody:
      properties:
        model:
          type: string
          title: Model
          description: The identifier of the model to use.
        input:
          anyOf:
          - type: string
            title: string
          - items:
              type: string
            type: array
            maxItems: 2048
            minItems: 1
            title: Array of strings
          - items:
              type: integer
            type: array
            maxItems: 2048
            minItems: 1
            title: Array of tokens
          - items:
              items:
                type: integer
              type: array
              minItems: 1
            type: array
            maxItems: 2048
            minItems: 1
            title: Array of token arrays
          title: string | ... (4 variants)
          description: Input text to embed, encoded as a string or array of tokens.
        encoding_format:
          type: string
          enum:
          - float
          - base64
          title: Encoding Format
          description: The format to return the embeddings in.
          default: float
        dimensions:
          type: integer
          minimum: 1.0
          title: Dimensions
          description: The number of dimensions for output embeddings.
        user:
          type: string
          title: User
          description: A unique identifier representing your end-user.
      additionalProperties: true
      type: object
      required:
      - model
      - input
      title: OpenAIEmbeddingsRequestWithExtraBody
      description: Request parameters for OpenAI-compatible embeddings endpoint.
    OpenAIEmbeddingData:
      properties:
        object:
          type: string
          title: Object
          description: The object type.
          enum:
          - embedding
        embedding:
          anyOf:
          - items:
              type: number
            type: array
            title: list[number]
          - type: string
          title: list[number] | string
          description: The embedding vector as a list of floats (when encoding_format='float') or as a base64-encoded string.
        index:
          type: integer
          minimum: 0.0
          title: Index
          description: The index of the embedding in the input list.
      type: object
      required:
      - embedding
      - index
      title: OpenAIEmbeddingData
      description: A single embedding data object from an OpenAI-compatible embeddings response.
    OpenAIEmbeddingUsage:
      properties:
        prompt_tokens:
          type: integer
          title: Prompt Tokens
          description: The number of tokens in the input.
        total_tokens:
          type: integer
          title: Total Tokens
          description: The total number of tokens used.
      type: object
      required:
      - prompt_tokens
      - total_tokens
      title: OpenAIEmbeddingUsage
      description: Usage information for an OpenAI-compatible embeddings response.
    OpenAIEmbeddingsResponse:
      properties:
        object:
          type: string
          title: Object
          description: The object type.
          enum:
          - list
        data:
          items:
            $ref: '#/components/schemas/OpenAIEmbeddingData'
          type: array
          minItems: 1
          title: Data
          description: List of embedding data objects.
        model:
          type: string
          title: Model
          description: The model that was used to generate the embeddings.
        usage:
          $ref: '#/components/schemas/OpenAIEmbeddingUsage'
          description: Usage information.
      type: object
      required:
      - data
      - model
      - usage
      title: OpenAIEmbeddingsResponse
      description: Response from an OpenAI-compatible embeddings request.
    OpenAIFilePurpose:
      type: string
      enum:
      - assistants
      - batch
      title: OpenAIFilePurpose
      description: Valid purpose values for OpenAI Files API.
    ListOpenAIFileResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/OpenAIFileObject'
          type: array
          title: Data
          description: The list of files.
        has_more:
          type: boolean
          title: Has More
          description: Whether there are more files available beyond this page.
        first_id:
          type: string
          title: First Id
          description: The ID of the first file in the list for pagination.
        last_id:
          type: string
          title: Last Id
          description: The ID of the last file in the list for pagination.
        object:
          type: string
          title: Object
          description: The object type, which is always 'list'.
          enum:
          - list
      type: object
      required:
      - data
      - has_more
      - first_id
      - last_id
      title: ListOpenAIFileResponse
      description: Response for listing files in OpenAI Files API.
    OpenAIFileObject:
      properties:
        object:
          type: string
          title: Object
          description: The object type, which is always 'file'.
          enum:
          - file
        id:
          type: string
          title: Id
          description: The file identifier, which can be referenced in the API endpoints.
        bytes:
          type: integer
          title: Bytes
          description: The size of the file, in bytes.
        created_at:
          type: integer
          title: Created At
          description: The Unix timestamp (in seconds) for when the file was created.
        expires_at:
          anyOf:
          - type: integer
          - type: 'null'
          description: The Unix timestamp (in seconds) for when the file expires.
        filename:
          type: string
          title: Filename
          description: The name of the file.
        purpose:
          $ref: '#/components/schemas/OpenAIFilePurpose'
          description: The intended purpose of the file.
        status:
          type: string
          enum:
          - uploaded
          - processed
          - error
          title: Status
          description: Deprecated. The current status of the file.
          deprecated: true
        status_details:
          type: string
          title: Status Details
          description: Deprecated. For details on why a fine-tuning training file failed validation, see the error field on fine_tuning.job.
          deprecated: true
      required:
      - id
      - bytes
      - created_at
      - filename
      - purpose
      - status
      - status_details
      title: OpenAIFileObject
      description: OpenAI File object as defined in the OpenAI Files API.
    ExpiresAfter:
      properties:
        anchor:
          type: string
          title: Anchor
          description: The anchor point for expiration, must be 'created_at'.
          enum:
          - created_at
        seconds:
          type: integer
          maximum: 2592000.0
          minimum: 3600.0
          title: Seconds
          description: Seconds until expiration, between 3600 (1 hour) and 2592000 (30 days).
      type: object
      required:
      - anchor
      - seconds
      title: ExpiresAfter
      description: Control expiration of uploaded files.
    OpenAIFileDeleteResponse:
      properties:
        id:
          type: string
          title: Id
          description: The file identifier that was deleted.
        object:
          type: string
          title: Object
          description: The object type, which is always 'file'.
          enum:
          - file
        deleted:
          type: boolean
          title: Deleted
          description: Whether the file was successfully deleted.
      type: object
      required:
      - id
      - deleted
      title: OpenAIFileDeleteResponse
      description: Response for deleting a file in OpenAI Files API.
    HealthInfo:
      properties:
        status:
          $ref: '#/components/schemas/HealthStatus'
          description: The health status of the service
      type: object
      required:
      - status
      title: HealthInfo
      description: Health status information for the service.
    RouteInfo:
      properties:
        route:
          type: string
          title: Route
          description: The API route path
        method:
          type: string
          title: Method
          description: The HTTP method for the route
        provider_types:
          items:
            type: string
          type: array
          title: Provider Types
          description: List of provider types implementing this route
      type: object
      required:
      - route
      - method
      - provider_types
      title: RouteInfo
      description: Information about an API route including its path, method, and implementing providers.
    ListRoutesResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/RouteInfo'
          type: array
          title: Data
          description: List of available API routes
      type: object
      required:
      - data
      title: ListRoutesResponse
      description: Response containing a list of all available API routes.
    OpenAIModel:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          enum:
          - model
        created:
          type: integer
          title: Created
        owned_by:
          type: string
          title: Owned By
        custom_metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
      required:
      - id
      - created
      - owned_by
      title: OpenAIModel
      description: |-
        A model from OpenAI.

        :id: The ID of the model
        :object: The object type, which will be "model"
        :created: The Unix timestamp in seconds when the model was created
        :owned_by: The owner of the model
        :custom_metadata: OGX-specific metadata including model_type, provider info, and additional metadata
    OpenAIListModelsResponse:
      properties:
        object:
          type: string
          title: Object
          enum:
          - list
        data:
          items:
            $ref: '#/components/schemas/OpenAIModel'
          type: array
          title: Data
          description: List of OpenAI model objects.
      type: object
      required:
      - data
      title: OpenAIListModelsResponse
      description: Response containing a list of OpenAI model objects.
    Model:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in ogx
        provider_resource_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Unique identifier for this resource in the provider
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          title: Type
          enum:
          - model
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Any additional metadata for this model
        created:
          type: integer
          title: Created
          description: The Unix timestamp in seconds when the model was created.
        owned_by:
          type: string
          title: Owned By
          description: The owner of the model.
          default: ogx
        model_type:
          $ref: '#/components/schemas/ModelType'
          default: llm
        model_validation:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Enable model availability check during registration. When false (default), validation is deferred to runtime and model is preserved during provider refresh.
        id:
          type: string
          title: Id
          description: The model identifier (OpenAI-compatible alias for identifier).
          readOnly: true
        object:
          type: string
          title: Object
          description: The object type, always 'model'.
          readOnly: true
          enum:
          - model
      required:
      - identifier
      - provider_id
      - id
      - object
      title: Model
      description: A model resource representing an AI model registered in OGX.
    ModelType:
      type: string
      enum:
      - llm
      - embedding
      - rerank
      title: ModelType
      description: Enumeration of supported model types in OGX.
    RunModerationRequest:
      properties:
        input:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
            title: list[string]
          title: string | list[string]
          description: Input (or inputs) to classify. Can be a single string or an array of strings.
        model:
          anyOf:
          - type: string
          - type: 'null'
          description: The content moderation model to use. If not specified, the default shield will be used.
      type: object
      required:
      - input
      title: RunModerationRequest
      description: Request model for running content moderation.
    ModerationObject:
      properties:
        id:
          type: string
          title: Id
          description: The unique identifier for the moderation request
        model:
          type: string
          title: Model
          description: The model used to generate the moderation results
        results:
          items:
            $ref: '#/components/schemas/ModerationObjectResults'
          type: array
          title: Results
          description: A list of moderation result objects
      type: object
      required:
      - id
      - model
      - results
      title: ModerationObject
      description: A moderation object containing the results of content classification.
    ModerationObjectResults:
      properties:
        flagged:
          type: boolean
          title: Flagged
          description: Whether any of the below categories are flagged
        categories:
          anyOf:
          - additionalProperties:
              type: boolean
            type: object
          - type: 'null'
          description: A dictionary of the categories, and whether they are flagged or not
        category_applied_input_types:
          anyOf:
          - additionalProperties:
              items:
                type: string
              type: array
            type: object
          - type: 'null'
          description: A dictionary of the categories along with the input type(s) that the score applies to
        category_scores:
          anyOf:
          - additionalProperties:
              type: number
            type: object
          - type: 'null'
          description: A dictionary of the categories along with their scores as predicted by model
        user_message:
          anyOf:
          - type: string
          - type: 'null'
          description: A message to convey to the user about the moderation result
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Additional metadata about the moderation
      type: object
      required:
      - flagged
      title: ModerationObjectResults
      description: A moderation result object containing flagged status and category information.
    Prompt:
      properties:
        prompt:
          anyOf:
          - type: string
          - type: 'null'
          description: The system prompt with variable placeholders
        version:
          type: integer
          minimum: 1.0
          title: Version
          description: Version (integer starting at 1, incremented on save)
        prompt_id:
          type: string
          title: Prompt Id
          description: Unique identifier in format 'pmpt_<48-digit-hash>'
        variables:
          items:
            type: string
          type: array
          title: Variables
          description: List of variable names that can be used in the prompt template
        is_default:
          type: boolean
          title: Is Default
          description: Boolean indicating whether this version is the default version
          default: false
      type: object
      required:
      - version
      - prompt_id
      title: Prompt
      description: A prompt resource representing a stored OpenAI Compatible prompt template in OGX.
    ListPromptsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Prompt'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListPromptsResponse
      description: Response model to list prompts.
    CreatePromptRequest:
      properties:
        prompt:
          type: string
          title: Prompt
          description: The prompt text content with variable placeholders.
        variables:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: List of variable names that can be used in the prompt template.
      type: object
      required:
      - prompt
      title: CreatePromptRequest
      description: Request model for creating a new prompt.
    UpdatePromptRequest:
      description: Request model for updating a prompt (combines path and body parameters).
      properties:
        prompt_id:
          description: The identifier of the prompt to update.
          title: Prompt Id
          type: string
        prompt:
          description: The updated prompt text content.
          title: Prompt
          type: string
        version:
          description: The current version of the prompt being updated.
          title: Version
          type: integer
        variables:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: Updated list of variable names that can be used in the prompt template.
          nullable: true
        set_as_default:
          default: true
          description: Set the new version as the default (default=True).
          title: Set As Default
          type: boolean
      required:
      - prompt_id
      - prompt
      - version
      title: UpdatePromptRequest
      type: object
    SetDefaultVersionRequest:
      description: Request model for setting the default version of a prompt (combines path and body parameters).
      properties:
        prompt_id:
          description: The identifier of the prompt.
          title: Prompt Id
          type: string
        version:
          description: The version to set as default.
          title: Version
          type: integer
      required:
      - prompt_id
      - version
      title: SetDefaultVersionRequest
      type: object
    ProviderInfo:
      properties:
        api:
          type: string
          title: Api
          description: The API name this provider implements
        provider_id:
          type: string
          title: Provider Id
          description: Unique identifier for the provider
        provider_type:
          type: string
          title: Provider Type
          description: The type of provider implementation
        config:
          additionalProperties: true
          type: object
          title: Config
          description: Configuration parameters for the provider
        health:
          additionalProperties: true
          type: object
          title: Health
          description: Current health status of the provider
      type: object
      required:
      - api
      - provider_id
      - provider_type
      - config
      - health
      title: ProviderInfo
      description: Information about a registered provider including its configuration and health status.
    ListProvidersResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ProviderInfo'
          type: array
          title: Data
          description: List of provider information objects
      type: object
      required:
      - data
      title: ListProvidersResponse
      description: Response containing a list of all available providers.
    ListOpenAIResponseObject:
      properties:
        data:
          items:
            $ref: '#/components/schemas/OpenAIResponseObjectWithInput'
          type: array
          title: Data
        has_more:
          type: boolean
          title: Has More
        first_id:
          type: string
          title: First Id
        last_id:
          type: string
          title: Last Id
        object:
          type: string
          title: Object
          enum:
          - list
      type: object
      required:
      - data
      - has_more
      - first_id
      - last_id
      title: ListOpenAIResponseObject
      description: Paginated list of OpenAI response objects with navigation metadata.
    OpenAIResponseError:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
      type: object
      required:
      - code
      - message
      title: OpenAIResponseError
      description: Error details for failed OpenAI response requests.
    OpenAIResponseInput:
      anyOf:
      - discriminator:
          mapping:
            file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
            function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
            mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
            mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
            message: '#/components/schemas/OpenAIResponseMessage'
            reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
            web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
          propertyName: type
        oneOf:
        - $ref: '#/components/schemas/OpenAIResponseMessage'
          title: OpenAIResponseMessage
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
          title: OpenAIResponseOutputMessageWebSearchToolCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
          title: OpenAIResponseOutputMessageFileSearchToolCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
          title: OpenAIResponseOutputMessageFunctionToolCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
          title: OpenAIResponseOutputMessageMCPCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
          title: OpenAIResponseOutputMessageMCPListTools
        - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          title: OpenAIResponseMCPApprovalRequest
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
          title: OpenAIResponseOutputMessageReasoningItem
        title: OpenAIResponseMessage | ... (8 variants)
      - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
        title: OpenAIResponseInputFunctionToolCallOutput
      - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
        title: OpenAIResponseMCPApprovalResponse
      - $ref: '#/components/schemas/OpenAIResponseCompaction'
        title: OpenAIResponseCompaction
      - $ref: '#/components/schemas/OpenAIResponseMessage'
        title: OpenAIResponseMessage
      title: OpenAIResponseInputFunctionToolCallOutput | ... (4 variants)
    OpenAIResponseInputToolFileSearch:
      properties:
        type:
          type: string
          title: Type
          enum:
          - file_search
        vector_store_ids:
          items:
            type: string
          type: array
          title: Vector Store Ids
        filters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
        max_num_results:
          anyOf:
          - type: integer
            maximum: 50.0
            minimum: 1.0
          - type: 'null'
          default: 10
        ranking_options:
          anyOf:
          - $ref: '#/components/schemas/SearchRankingOptions'
            title: SearchRankingOptions
          - type: 'null'
          title: SearchRankingOptions
      type: object
      required:
      - vector_store_ids
      title: OpenAIResponseInputToolFileSearch
      description: File search tool configuration for OpenAI response inputs.
    OpenAIResponseInputToolFunction:
      properties:
        type:
          type: string
          title: Type
          enum:
          - function
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
        parameters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
        strict:
          anyOf:
          - type: boolean
          - type: 'null'
      type: object
      required:
      - name
      - parameters
      title: OpenAIResponseInputToolFunction
      description: Function tool configuration for OpenAI response inputs.
    OpenAIResponseInputToolWebSearch:
      properties:
        type:
          anyOf:
          - type: string
            enum:
            - web_search
          - type: string
            enum:
            - web_search_preview
          - type: string
            enum:
            - web_search_preview_2025_03_11
          - type: string
            enum:
            - web_search_2025_08_26
          title: string
          default: web_search
        search_context_size:
          anyOf:
          - type: string
            pattern: ^low|medium|high$
          - type: 'null'
          default: medium
      type: object
      title: OpenAIResponseInputToolWebSearch
      description: Web search tool configuration for OpenAI response inputs.
    OpenAIResponseObjectWithInput:
      properties:
        background:
          type: boolean
          title: Background
        created_at:
          type: integer
          title: Created At
        completed_at:
          anyOf:
          - type: integer
          - type: 'null'
        error:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseError'
            title: OpenAIResponseError
          - type: 'null'
          title: OpenAIResponseError
        frequency_penalty:
          type: number
          title: Frequency Penalty
        id:
          type: string
          title: Id
        incomplete_details:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseIncompleteDetails'
            title: OpenAIResponseIncompleteDetails
          - type: 'null'
          title: OpenAIResponseIncompleteDetails
        model:
          type: string
          title: Model
        object:
          type: string
          title: Object
          enum:
          - response
          default: response
        output:
          items:
            $ref: '#/components/schemas/OpenAIResponseOutputItem'
          type: array
          title: Output
        parallel_tool_calls:
          type: boolean
          title: Parallel Tool Calls
          default: true
        previous_response_id:
          anyOf:
          - type: string
          - type: 'null'
        prompt_cache_key:
          anyOf:
          - type: string
          - type: 'null'
        prompt:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponsePrompt'
            title: OpenAIResponsePrompt
          - type: 'null'
          title: OpenAIResponsePrompt
        status:
          type: string
          title: Status
        temperature:
          type: number
          title: Temperature
        text:
          $ref: '#/components/schemas/OpenAIResponseText'
          default:
            format:
              type: text
        top_p:
          type: number
          title: Top P
        top_logprobs:
          type: integer
          title: Top Logprobs
        tools:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseInputToolWebSearch'
              title: OpenAIResponseInputToolWebSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolFileSearch'
              title: OpenAIResponseInputToolFileSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolFunction'
              title: OpenAIResponseInputToolFunction
            - $ref: '#/components/schemas/OpenAIResponseToolMCP'
              title: OpenAIResponseToolMCP
            discriminator:
              propertyName: type
              mapping:
                file_search: '#/components/schemas/OpenAIResponseInputToolFileSearch'
                function: '#/components/schemas/OpenAIResponseInputToolFunction'
                mcp: '#/components/schemas/OpenAIResponseToolMCP'
                web_search: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_2025_08_26: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_preview: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolWebSearch'
            title: OpenAIResponseInputToolWebSearch | ... (4 variants)
          type: array
          title: Tools
        tool_choice:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceMode'
            title: OpenAIResponseInputToolChoiceMode
          - oneOf:
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceAllowedTools'
              title: OpenAIResponseInputToolChoiceAllowedTools
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceFileSearch'
              title: OpenAIResponseInputToolChoiceFileSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
              title: OpenAIResponseInputToolChoiceWebSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceFunctionTool'
              title: OpenAIResponseInputToolChoiceFunctionTool
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceMCPTool'
              title: OpenAIResponseInputToolChoiceMCPTool
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceCustomTool'
              title: OpenAIResponseInputToolChoiceCustomTool
            discriminator:
              propertyName: type
              mapping:
                allowed_tools: '#/components/schemas/OpenAIResponseInputToolChoiceAllowedTools'
                custom: '#/components/schemas/OpenAIResponseInputToolChoiceCustomTool'
                file_search: '#/components/schemas/OpenAIResponseInputToolChoiceFileSearch'
                function: '#/components/schemas/OpenAIResponseInputToolChoiceFunctionTool'
                mcp: '#/components/schemas/OpenAIResponseInputToolChoiceMCPTool'
                web_search: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
                web_search_2025_08_26: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
                web_search_preview: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
                web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
            title: OpenAIResponseInputToolChoiceAllowedTools | ... (6 variants)
          - type: 'null'
          title: OpenAIResponseInputToolChoiceMode
        truncation:
          anyOf:
          - type: string
          - type: 'null'
        usage:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseUsage'
            title: OpenAIResponseUsage
          - type: 'null'
          title: OpenAIResponseUsage
        instructions:
          anyOf:
          - type: string
          - type: 'null'
        max_tool_calls:
          anyOf:
          - type: integer
          - type: 'null'
        reasoning:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseReasoning'
            title: OpenAIResponseReasoning
          - type: 'null'
          title: OpenAIResponseReasoning
        max_output_tokens:
          anyOf:
          - type: integer
          - type: 'null'
        safety_identifier:
          anyOf:
          - type: string
          - type: 'null'
        service_tier:
          type: string
          title: Service Tier
        metadata:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
        presence_penalty:
          type: number
          title: Presence Penalty
        store:
          type: boolean
          title: Store
        input:
          items:
            $ref: '#/components/schemas/OpenAIResponseMessageOutputUnion'
          type: array
          title: Input
      type: object
      required:
      - created_at
      - id
      - model
      - output
      - status
      - store
      - input
      title: OpenAIResponseObjectWithInput
      description: OpenAI response object extended with input context information.
    OpenAIResponseOutput:
      discriminator:
        mapping:
          file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
          function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
          mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
          mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
          message: '#/components/schemas/OpenAIResponseMessage'
          reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
          web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseMessage'
        title: OpenAIResponseMessage
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
        title: OpenAIResponseOutputMessageWebSearchToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
        title: OpenAIResponseOutputMessageFileSearchToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
        title: OpenAIResponseOutputMessageFunctionToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
        title: OpenAIResponseOutputMessageMCPCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
        title: OpenAIResponseOutputMessageMCPListTools
      - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
        title: OpenAIResponseMCPApprovalRequest
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
        title: OpenAIResponseOutputMessageReasoningItem
      title: OpenAIResponseMessage | ... (8 variants)
    OpenAIResponsePrompt:
      properties:
        id:
          type: string
          title: Id
        variables:
          anyOf:
          - additionalProperties:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
                title: OpenAIResponseInputMessageContentText
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                title: OpenAIResponseInputMessageContentImage
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                title: OpenAIResponseInputMessageContentFile
              discriminator:
                propertyName: type
                mapping:
                  input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                  input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                  input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
              title: OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile
            type: object
          - type: 'null'
        version:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - id
      title: OpenAIResponsePrompt
      description: OpenAI compatible Prompt object that is used in OpenAI responses.
    OpenAIResponseText:
      properties:
        format:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseTextFormat'
            title: OpenAIResponseTextFormat
          - type: 'null'
          title: OpenAIResponseTextFormat
        verbosity:
          anyOf:
          - type: string
            enum:
            - low
            - medium
            - high
          - type: 'null'
      type: object
      title: OpenAIResponseText
      description: Text response configuration for OpenAI responses.
    OpenAIResponseTool:
      discriminator:
        mapping:
          file_search: '#/components/schemas/OpenAIResponseInputToolFileSearch'
          function: '#/components/schemas/OpenAIResponseInputToolFunction'
          mcp: '#/components/schemas/OpenAIResponseToolMCP'
          web_search: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          web_search_2025_08_26: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          web_search_preview: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolWebSearch'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseInputToolWebSearch'
        title: OpenAIResponseInputToolWebSearch
      - $ref: '#/components/schemas/OpenAIResponseInputToolFileSearch'
        title: OpenAIResponseInputToolFileSearch
      - $ref: '#/components/schemas/OpenAIResponseInputToolFunction'
        title: OpenAIResponseInputToolFunction
      - $ref: '#/components/schemas/OpenAIResponseToolMCP'
        title: OpenAIResponseToolMCP
      title: OpenAIResponseInputToolWebSearch | ... (4 variants)
    OpenAIResponseToolMCP:
      properties:
        type:
          type: string
          title: Type
          enum:
          - mcp
        server_label:
          type: string
          title: Server Label
        allowed_tools:
          anyOf:
          - items:
              type: string
            type: array
            title: list[string]
          - $ref: '#/components/schemas/AllowedToolsFilter'
            title: AllowedToolsFilter
          - type: 'null'
          title: list[string] | AllowedToolsFilter
      type: object
      required:
      - server_label
      title: OpenAIResponseToolMCP
      description: Model Context Protocol (MCP) tool configuration for OpenAI response object.
    OpenAIResponseUsage:
      properties:
        input_tokens:
          type: integer
          title: Input Tokens
        output_tokens:
          type: integer
          title: Output Tokens
        total_tokens:
          type: integer
          title: Total Tokens
        input_tokens_details:
          $ref: '#/components/schemas/OpenAIResponseUsageInputTokensDetails'
        output_tokens_details:
          $ref: '#/components/schemas/OpenAIResponseUsageOutputTokensDetails'
      type: object
      required:
      - input_tokens
      - output_tokens
      - total_tokens
      - input_tokens_details
      - output_tokens_details
      title: OpenAIResponseUsage
      description: Usage information for OpenAI response.
    OpenAIResponseInputTool:
      discriminator:
        mapping:
          file_search: '#/components/schemas/OpenAIResponseInputToolFileSearch'
          function: '#/components/schemas/OpenAIResponseInputToolFunction'
          mcp: '#/components/schemas/OpenAIResponseInputToolMCP'
          web_search: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          web_search_2025_08_26: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          web_search_preview: '#/components/schemas/OpenAIResponseInputToolWebSearch'
          web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolWebSearch'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseInputToolWebSearch'
        title: OpenAIResponseInputToolWebSearch
      - $ref: '#/components/schemas/OpenAIResponseInputToolFileSearch'
        title: OpenAIResponseInputToolFileSearch
      - $ref: '#/components/schemas/OpenAIResponseInputToolFunction'
        title: OpenAIResponseInputToolFunction
      - $ref: '#/components/schemas/OpenAIResponseInputToolMCP'
        title: OpenAIResponseInputToolMCP
      title: OpenAIResponseInputToolWebSearch | ... (4 variants)
    OpenAIResponseInputToolMCP:
      properties:
        type:
          type: string
          title: Type
          enum:
          - mcp
        server_label:
          type: string
          title: Server Label
        connector_id:
          anyOf:
          - type: string
          - type: 'null'
        server_url:
          anyOf:
          - type: string
          - type: 'null'
        headers:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
        authorization:
          anyOf:
          - type: string
          - type: 'null'
        require_approval:
          anyOf:
          - type: string
            enum:
            - always
          - type: string
            enum:
            - never
          - $ref: '#/components/schemas/ApprovalFilter'
            title: ApprovalFilter
          title: string | ApprovalFilter
          default: never
        allowed_tools:
          anyOf:
          - items:
              type: string
            type: array
            title: list[string]
          - $ref: '#/components/schemas/AllowedToolsFilter'
            title: AllowedToolsFilter
          - type: 'null'
          title: list[string] | AllowedToolsFilter
      type: object
      required:
      - server_label
      title: OpenAIResponseInputToolMCP
      description: Model Context Protocol (MCP) tool configuration for OpenAI response inputs.
    OpenAIResponseObject:
      properties:
        background:
          type: boolean
          title: Background
        created_at:
          type: integer
          title: Created At
        completed_at:
          anyOf:
          - type: integer
          - type: 'null'
        error:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseError'
            title: OpenAIResponseError
          - type: 'null'
          title: OpenAIResponseError
        frequency_penalty:
          type: number
          title: Frequency Penalty
        id:
          type: string
          title: Id
        incomplete_details:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseIncompleteDetails'
            title: OpenAIResponseIncompleteDetails
          - type: 'null'
          title: OpenAIResponseIncompleteDetails
        model:
          type: string
          title: Model
        object:
          type: string
          title: Object
          enum:
          - response
          default: response
        output:
          items:
            $ref: '#/components/schemas/OpenAIResponseOutputItem'
          type: array
          title: Output
        parallel_tool_calls:
          type: boolean
          title: Parallel Tool Calls
          default: true
        previous_response_id:
          anyOf:
          - type: string
          - type: 'null'
        prompt_cache_key:
          anyOf:
          - type: string
          - type: 'null'
        prompt:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponsePrompt'
            title: OpenAIResponsePrompt
          - type: 'null'
          title: OpenAIResponsePrompt
        status:
          type: string
          title: Status
        temperature:
          type: number
          title: Temperature
        text:
          $ref: '#/components/schemas/OpenAIResponseText'
          default:
            format:
              type: text
        top_p:
          type: number
          title: Top P
        top_logprobs:
          type: integer
          title: Top Logprobs
        tools:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseInputToolWebSearch'
              title: OpenAIResponseInputToolWebSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolFileSearch'
              title: OpenAIResponseInputToolFileSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolFunction'
              title: OpenAIResponseInputToolFunction
            - $ref: '#/components/schemas/OpenAIResponseToolMCP'
              title: OpenAIResponseToolMCP
            discriminator:
              propertyName: type
              mapping:
                file_search: '#/components/schemas/OpenAIResponseInputToolFileSearch'
                function: '#/components/schemas/OpenAIResponseInputToolFunction'
                mcp: '#/components/schemas/OpenAIResponseToolMCP'
                web_search: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_2025_08_26: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_preview: '#/components/schemas/OpenAIResponseInputToolWebSearch'
                web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolWebSearch'
            title: OpenAIResponseInputToolWebSearch | ... (4 variants)
          type: array
          title: Tools
        tool_choice:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceMode'
            title: OpenAIResponseInputToolChoiceMode
          - oneOf:
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceAllowedTools'
              title: OpenAIResponseInputToolChoiceAllowedTools
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceFileSearch'
              title: OpenAIResponseInputToolChoiceFileSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
              title: OpenAIResponseInputToolChoiceWebSearch
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceFunctionTool'
              title: OpenAIResponseInputToolChoiceFunctionTool
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceMCPTool'
              title: OpenAIResponseInputToolChoiceMCPTool
            - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceCustomTool'
              title: OpenAIResponseInputToolChoiceCustomTool
            discriminator:
              propertyName: type
              mapping:
                allowed_tools: '#/components/schemas/OpenAIResponseInputToolChoiceAllowedTools'
                custom: '#/components/schemas/OpenAIResponseInputToolChoiceCustomTool'
                file_search: '#/components/schemas/OpenAIResponseInputToolChoiceFileSearch'
                function: '#/components/schemas/OpenAIResponseInputToolChoiceFunctionTool'
                mcp: '#/components/schemas/OpenAIResponseInputToolChoiceMCPTool'
                web_search: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
                web_search_2025_08_26: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
                web_search_preview: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
                web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
            title: OpenAIResponseInputToolChoiceAllowedTools | ... (6 variants)
          - type: 'null'
          title: OpenAIResponseInputToolChoiceMode
        truncation:
          anyOf:
          - type: string
          - type: 'null'
        usage:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseUsage'
            title: OpenAIResponseUsage
          - type: 'null'
          title: OpenAIResponseUsage
        instructions:
          anyOf:
          - type: string
          - type: 'null'
        max_tool_calls:
          anyOf:
          - type: integer
          - type: 'null'
        reasoning:
          anyOf:
          - $ref: '#/components/schemas/OpenAIResponseReasoning'
            title: OpenAIResponseReasoning
          - type: 'null'
          title: OpenAIResponseReasoning
        max_output_tokens:
          anyOf:
          - type: integer
          - type: 'null'
        safety_identifier:
          anyOf:
          - type: string
          - type: 'null'
        service_tier:
          type: string
          title: Service Tier
        metadata:
          anyOf:
          - additionalProperties:
              type: string
            type: object
          - type: 'null'
        presence_penalty:
          type: number
          title: Presence Penalty
        store:
          type: boolean
          title: Store
      type: object
      required:
      - created_at
      - id
      - model
      - output
      - status
      - store
      title: OpenAIResponseObject
      description: Complete OpenAI response object containing generation results and metadata.
    OpenAIResponseContentPartOutputText:
      description: Text content within a streamed response part.
      properties:
        type:
          title: Type
          type: string
          enum:
          - output_text
        text:
          title: Text
          type: string
        annotations:
          items:
            discriminator:
              mapping:
                container_file_citation: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
                file_citation: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
                file_path: '#/components/schemas/OpenAIResponseAnnotationFilePath'
                url_citation: '#/components/schemas/OpenAIResponseAnnotationCitation'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
              title: OpenAIResponseAnnotationFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationCitation'
              title: OpenAIResponseAnnotationCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
              title: OpenAIResponseAnnotationContainerFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFilePath'
              title: OpenAIResponseAnnotationFilePath
            title: OpenAIResponseAnnotationFileCitation | ... (4 variants)
          title: Annotations
          type: array
        logprobs:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITokenLogProb'
            type: array
          - type: 'null'
          nullable: true
      required:
      - text
      title: OpenAIResponseContentPartOutputText
      type: object
    OpenAIResponseContentPartReasoningSummary:
      description: Reasoning summary part in a streamed response.
      properties:
        type:
          title: Type
          type: string
          enum:
          - summary_text
        text:
          title: Text
          type: string
      required:
      - text
      title: OpenAIResponseContentPartReasoningSummary
      type: object
    OpenAIResponseContentPartReasoningText:
      description: Reasoning text emitted as part of a streamed response.
      properties:
        type:
          title: Type
          type: string
          enum:
          - reasoning_text
        text:
          title: Text
          type: string
      required:
      - text
      title: OpenAIResponseContentPartReasoningText
      type: object
    OpenAIResponseObjectStream:
      discriminator:
        mapping:
          error: '#/components/schemas/OpenAIResponseObjectStreamError'
          response.completed: '#/components/schemas/OpenAIResponseObjectStreamResponseCompleted'
          response.content_part.added: '#/components/schemas/OpenAIResponseObjectStreamResponseContentPartAdded'
          response.content_part.done: '#/components/schemas/OpenAIResponseObjectStreamResponseContentPartDone'
          response.created: '#/components/schemas/OpenAIResponseObjectStreamResponseCreated'
          response.failed: '#/components/schemas/OpenAIResponseObjectStreamResponseFailed'
          response.file_search_call.completed: '#/components/schemas/OpenAIResponseObjectStreamResponseFileSearchCallCompleted'
          response.file_search_call.in_progress: '#/components/schemas/OpenAIResponseObjectStreamResponseFileSearchCallInProgress'
          response.file_search_call.searching: '#/components/schemas/OpenAIResponseObjectStreamResponseFileSearchCallSearching'
          response.function_call_arguments.delta: '#/components/schemas/OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta'
          response.function_call_arguments.done: '#/components/schemas/OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone'
          response.in_progress: '#/components/schemas/OpenAIResponseObjectStreamResponseInProgress'
          response.incomplete: '#/components/schemas/OpenAIResponseObjectStreamResponseIncomplete'
          response.mcp_call.arguments.delta: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta'
          response.mcp_call.arguments.done: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallArgumentsDone'
          response.mcp_call.completed: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallCompleted'
          response.mcp_call.failed: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallFailed'
          response.mcp_call.in_progress: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallInProgress'
          response.mcp_list_tools.completed: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpListToolsCompleted'
          response.mcp_list_tools.failed: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpListToolsFailed'
          response.mcp_list_tools.in_progress: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpListToolsInProgress'
          response.output_item.added: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputItemAdded'
          response.output_item.done: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputItemDone'
          response.output_text.annotation.added: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded'
          response.output_text.delta: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputTextDelta'
          response.output_text.done: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputTextDone'
          response.reasoning_summary_part.added: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded'
          response.reasoning_summary_part.done: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryPartDone'
          response.reasoning_summary_text.delta: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta'
          response.reasoning_summary_text.done: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryTextDone'
          response.reasoning_text.delta: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningTextDelta'
          response.reasoning_text.done: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningTextDone'
          response.refusal.delta: '#/components/schemas/OpenAIResponseObjectStreamResponseRefusalDelta'
          response.refusal.done: '#/components/schemas/OpenAIResponseObjectStreamResponseRefusalDone'
          response.web_search_call.completed: '#/components/schemas/OpenAIResponseObjectStreamResponseWebSearchCallCompleted'
          response.web_search_call.in_progress: '#/components/schemas/OpenAIResponseObjectStreamResponseWebSearchCallInProgress'
          response.web_search_call.searching: '#/components/schemas/OpenAIResponseObjectStreamResponseWebSearchCallSearching'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseCreated'
        title: OpenAIResponseObjectStreamResponseCreated
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseInProgress'
        title: OpenAIResponseObjectStreamResponseInProgress
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputItemAdded'
        title: OpenAIResponseObjectStreamResponseOutputItemAdded
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputItemDone'
        title: OpenAIResponseObjectStreamResponseOutputItemDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputTextDelta'
        title: OpenAIResponseObjectStreamResponseOutputTextDelta
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputTextDone'
        title: OpenAIResponseObjectStreamResponseOutputTextDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta'
        title: OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone'
        title: OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseWebSearchCallInProgress'
        title: OpenAIResponseObjectStreamResponseWebSearchCallInProgress
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseWebSearchCallSearching'
        title: OpenAIResponseObjectStreamResponseWebSearchCallSearching
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseWebSearchCallCompleted'
        title: OpenAIResponseObjectStreamResponseWebSearchCallCompleted
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpListToolsInProgress'
        title: OpenAIResponseObjectStreamResponseMcpListToolsInProgress
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpListToolsFailed'
        title: OpenAIResponseObjectStreamResponseMcpListToolsFailed
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpListToolsCompleted'
        title: OpenAIResponseObjectStreamResponseMcpListToolsCompleted
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta'
        title: OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallArgumentsDone'
        title: OpenAIResponseObjectStreamResponseMcpCallArgumentsDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallInProgress'
        title: OpenAIResponseObjectStreamResponseMcpCallInProgress
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallFailed'
        title: OpenAIResponseObjectStreamResponseMcpCallFailed
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseMcpCallCompleted'
        title: OpenAIResponseObjectStreamResponseMcpCallCompleted
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseContentPartAdded'
        title: OpenAIResponseObjectStreamResponseContentPartAdded
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseContentPartDone'
        title: OpenAIResponseObjectStreamResponseContentPartDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningTextDelta'
        title: OpenAIResponseObjectStreamResponseReasoningTextDelta
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningTextDone'
        title: OpenAIResponseObjectStreamResponseReasoningTextDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded'
        title: OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryPartDone'
        title: OpenAIResponseObjectStreamResponseReasoningSummaryPartDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta'
        title: OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseReasoningSummaryTextDone'
        title: OpenAIResponseObjectStreamResponseReasoningSummaryTextDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseRefusalDelta'
        title: OpenAIResponseObjectStreamResponseRefusalDelta
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseRefusalDone'
        title: OpenAIResponseObjectStreamResponseRefusalDone
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded'
        title: OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseFileSearchCallInProgress'
        title: OpenAIResponseObjectStreamResponseFileSearchCallInProgress
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseFileSearchCallSearching'
        title: OpenAIResponseObjectStreamResponseFileSearchCallSearching
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseFileSearchCallCompleted'
        title: OpenAIResponseObjectStreamResponseFileSearchCallCompleted
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseIncomplete'
        title: OpenAIResponseObjectStreamResponseIncomplete
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseFailed'
        title: OpenAIResponseObjectStreamResponseFailed
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamResponseCompleted'
        title: OpenAIResponseObjectStreamResponseCompleted
      - $ref: '#/components/schemas/OpenAIResponseObjectStreamError'
        title: OpenAIResponseObjectStreamError
      title: OpenAIResponseObjectStreamResponseCreated | ... (37 variants)
    OpenAIResponseObjectStreamResponseCompleted:
      description: Streaming event indicating a response has been completed.
      properties:
        response:
          $ref: '#/components/schemas/OpenAIResponseObject'
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.completed
      required:
      - response
      - sequence_number
      title: OpenAIResponseObjectStreamResponseCompleted
      type: object
    OpenAIResponseObjectStreamResponseContentPartAdded:
      description: Streaming event for when a new content part is added to a response item.
      properties:
        content_index:
          title: Content Index
          type: integer
        response_id:
          title: Response Id
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        part:
          discriminator:
            mapping:
              output_text: '#/components/schemas/OpenAIResponseContentPartOutputText'
              reasoning_text: '#/components/schemas/OpenAIResponseContentPartReasoningText'
              refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseContentPartOutputText'
            title: OpenAIResponseContentPartOutputText
          - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
            title: OpenAIResponseContentPartRefusal
          - $ref: '#/components/schemas/OpenAIResponseContentPartReasoningText'
            title: OpenAIResponseContentPartReasoningText
          title: OpenAIResponseContentPartOutputText | OpenAIResponseContentPartRefusal | OpenAIResponseContentPartReasoningText
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.content_part.added
      required:
      - content_index
      - response_id
      - item_id
      - output_index
      - part
      - sequence_number
      title: OpenAIResponseObjectStreamResponseContentPartAdded
      type: object
    OpenAIResponseObjectStreamResponseContentPartDone:
      description: Streaming event for when a content part is completed.
      properties:
        content_index:
          title: Content Index
          type: integer
        response_id:
          title: Response Id
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        part:
          discriminator:
            mapping:
              output_text: '#/components/schemas/OpenAIResponseContentPartOutputText'
              reasoning_text: '#/components/schemas/OpenAIResponseContentPartReasoningText'
              refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseContentPartOutputText'
            title: OpenAIResponseContentPartOutputText
          - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
            title: OpenAIResponseContentPartRefusal
          - $ref: '#/components/schemas/OpenAIResponseContentPartReasoningText'
            title: OpenAIResponseContentPartReasoningText
          title: OpenAIResponseContentPartOutputText | OpenAIResponseContentPartRefusal | OpenAIResponseContentPartReasoningText
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.content_part.done
      required:
      - content_index
      - response_id
      - item_id
      - output_index
      - part
      - sequence_number
      title: OpenAIResponseObjectStreamResponseContentPartDone
      type: object
    OpenAIResponseObjectStreamResponseCreated:
      description: Streaming event indicating a new response has been created.
      properties:
        response:
          $ref: '#/components/schemas/OpenAIResponseObject'
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.created
      required:
      - response
      - sequence_number
      title: OpenAIResponseObjectStreamResponseCreated
      type: object
    OpenAIResponseObjectStreamResponseFailed:
      description: Streaming event emitted when a response fails.
      properties:
        response:
          $ref: '#/components/schemas/OpenAIResponseObject'
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.failed
      required:
      - response
      - sequence_number
      title: OpenAIResponseObjectStreamResponseFailed
      type: object
    OpenAIResponseObjectStreamResponseFileSearchCallCompleted:
      description: Streaming event for completed file search calls.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.file_search_call.completed
      required:
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseFileSearchCallCompleted
      type: object
    OpenAIResponseObjectStreamResponseFileSearchCallInProgress:
      description: Streaming event for file search calls in progress.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.file_search_call.in_progress
      required:
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseFileSearchCallInProgress
      type: object
    OpenAIResponseObjectStreamResponseFileSearchCallSearching:
      description: Streaming event for file search currently searching.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.file_search_call.searching
      required:
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseFileSearchCallSearching
      type: object
    OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta:
      description: Streaming event for incremental function call argument updates.
      properties:
        delta:
          title: Delta
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.function_call_arguments.delta
      required:
      - delta
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseFunctionCallArgumentsDelta
      type: object
    OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone:
      description: Streaming event for when function call arguments are completed.
      properties:
        arguments:
          title: Arguments
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.function_call_arguments.done
      required:
      - arguments
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseFunctionCallArgumentsDone
      type: object
    OpenAIResponseObjectStreamResponseInProgress:
      description: Streaming event indicating the response remains in progress.
      properties:
        response:
          $ref: '#/components/schemas/OpenAIResponseObject'
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.in_progress
      required:
      - response
      - sequence_number
      title: OpenAIResponseObjectStreamResponseInProgress
      type: object
    OpenAIResponseObjectStreamResponseIncomplete:
      description: Streaming event emitted when a response ends in an incomplete state.
      properties:
        response:
          $ref: '#/components/schemas/OpenAIResponseObject'
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.incomplete
      required:
      - response
      - sequence_number
      title: OpenAIResponseObjectStreamResponseIncomplete
      type: object
    OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta:
      description: Streaming event for incremental MCP call argument updates.
      properties:
        delta:
          title: Delta
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_call.arguments.delta
      required:
      - delta
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpCallArgumentsDelta
      type: object
    OpenAIResponseObjectStreamResponseMcpCallArgumentsDone:
      description: Streaming event for completed MCP call arguments.
      properties:
        arguments:
          title: Arguments
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_call.arguments.done
      required:
      - arguments
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpCallArgumentsDone
      type: object
    OpenAIResponseObjectStreamResponseMcpCallCompleted:
      description: Streaming event for completed MCP calls.
      properties:
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_call.completed
      required:
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpCallCompleted
      type: object
    OpenAIResponseObjectStreamResponseMcpCallFailed:
      description: Streaming event for failed MCP calls.
      properties:
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_call.failed
      required:
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpCallFailed
      type: object
    OpenAIResponseObjectStreamResponseMcpCallInProgress:
      description: Streaming event for MCP calls in progress.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_call.in_progress
      required:
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpCallInProgress
      type: object
    OpenAIResponseObjectStreamResponseMcpListToolsCompleted:
      description: Streaming event for a completed MCP list tools operation.
      properties:
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_list_tools.completed
      required:
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpListToolsCompleted
      type: object
    OpenAIResponseObjectStreamResponseMcpListToolsFailed:
      description: Streaming event for a failed MCP list tools operation.
      properties:
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_list_tools.failed
      required:
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpListToolsFailed
      type: object
    OpenAIResponseObjectStreamResponseMcpListToolsInProgress:
      description: Streaming event for MCP list tools operation in progress.
      properties:
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.mcp_list_tools.in_progress
      required:
      - sequence_number
      title: OpenAIResponseObjectStreamResponseMcpListToolsInProgress
      type: object
    OpenAIResponseObjectStreamResponseOutputItemAdded:
      description: Streaming event for when a new output item is added to the response.
      properties:
        response_id:
          title: Response Id
          type: string
        item:
          discriminator:
            mapping:
              file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
              mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              message: '#/components/schemas/OpenAIResponseMessage'
              reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
              web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseMessage'
            title: OpenAIResponseMessage
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            title: OpenAIResponseOutputMessageWebSearchToolCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
            title: OpenAIResponseOutputMessageFileSearchToolCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
            title: OpenAIResponseOutputMessageFunctionToolCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
            title: OpenAIResponseOutputMessageMCPCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
            title: OpenAIResponseOutputMessageMCPListTools
          - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            title: OpenAIResponseMCPApprovalRequest
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
            title: OpenAIResponseOutputMessageReasoningItem
          title: OpenAIResponseMessage | ... (8 variants)
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.output_item.added
      required:
      - response_id
      - item
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseOutputItemAdded
      type: object
    OpenAIResponseObjectStreamResponseOutputItemDone:
      description: Streaming event for when an output item is completed.
      properties:
        response_id:
          title: Response Id
          type: string
        item:
          discriminator:
            mapping:
              file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
              mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              message: '#/components/schemas/OpenAIResponseMessage'
              reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
              web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseMessage'
            title: OpenAIResponseMessage
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
            title: OpenAIResponseOutputMessageWebSearchToolCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
            title: OpenAIResponseOutputMessageFileSearchToolCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
            title: OpenAIResponseOutputMessageFunctionToolCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
            title: OpenAIResponseOutputMessageMCPCall
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
            title: OpenAIResponseOutputMessageMCPListTools
          - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            title: OpenAIResponseMCPApprovalRequest
          - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
            title: OpenAIResponseOutputMessageReasoningItem
          title: OpenAIResponseMessage | ... (8 variants)
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.output_item.done
      required:
      - response_id
      - item
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseOutputItemDone
      type: object
    OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded:
      description: Streaming event for when an annotation is added to output text.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        content_index:
          title: Content Index
          type: integer
        annotation_index:
          title: Annotation Index
          type: integer
        annotation:
          discriminator:
            mapping:
              container_file_citation: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
              file_citation: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
              file_path: '#/components/schemas/OpenAIResponseAnnotationFilePath'
              url_citation: '#/components/schemas/OpenAIResponseAnnotationCitation'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
            title: OpenAIResponseAnnotationFileCitation
          - $ref: '#/components/schemas/OpenAIResponseAnnotationCitation'
            title: OpenAIResponseAnnotationCitation
          - $ref: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
            title: OpenAIResponseAnnotationContainerFileCitation
          - $ref: '#/components/schemas/OpenAIResponseAnnotationFilePath'
            title: OpenAIResponseAnnotationFilePath
          title: OpenAIResponseAnnotationFileCitation | ... (4 variants)
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.output_text.annotation.added
      required:
      - item_id
      - output_index
      - content_index
      - annotation_index
      - annotation
      - sequence_number
      title: OpenAIResponseObjectStreamResponseOutputTextAnnotationAdded
      type: object
    OpenAIResponseObjectStreamResponseOutputTextDelta:
      description: Streaming event for incremental text content updates.
      properties:
        content_index:
          title: Content Index
          type: integer
        delta:
          title: Delta
          type: string
        item_id:
          title: Item Id
          type: string
        logprobs:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITokenLogProb'
            type: array
          - type: 'null'
          nullable: true
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.output_text.delta
      required:
      - content_index
      - delta
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseOutputTextDelta
      type: object
    OpenAIResponseObjectStreamResponseOutputTextDone:
      description: Streaming event for when text output is completed.
      properties:
        content_index:
          title: Content Index
          type: integer
        text:
          title: Text
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.output_text.done
      required:
      - content_index
      - text
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseOutputTextDone
      type: object
    OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded:
      description: Streaming event for when a new reasoning summary part is added.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        part:
          $ref: '#/components/schemas/OpenAIResponseContentPartReasoningSummary'
        sequence_number:
          title: Sequence Number
          type: integer
        summary_index:
          title: Summary Index
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.reasoning_summary_part.added
      required:
      - item_id
      - output_index
      - part
      - sequence_number
      - summary_index
      title: OpenAIResponseObjectStreamResponseReasoningSummaryPartAdded
      type: object
    OpenAIResponseObjectStreamResponseReasoningSummaryPartDone:
      description: Streaming event for when a reasoning summary part is completed.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        part:
          $ref: '#/components/schemas/OpenAIResponseContentPartReasoningSummary'
        sequence_number:
          title: Sequence Number
          type: integer
        summary_index:
          title: Summary Index
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.reasoning_summary_part.done
      required:
      - item_id
      - output_index
      - part
      - sequence_number
      - summary_index
      title: OpenAIResponseObjectStreamResponseReasoningSummaryPartDone
      type: object
    OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta:
      description: Streaming event for incremental reasoning summary text updates.
      properties:
        delta:
          title: Delta
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        summary_index:
          title: Summary Index
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.reasoning_summary_text.delta
      required:
      - delta
      - item_id
      - output_index
      - sequence_number
      - summary_index
      title: OpenAIResponseObjectStreamResponseReasoningSummaryTextDelta
      type: object
    OpenAIResponseObjectStreamResponseReasoningSummaryTextDone:
      description: Streaming event for when reasoning summary text is completed.
      properties:
        text:
          title: Text
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        summary_index:
          title: Summary Index
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.reasoning_summary_text.done
      required:
      - text
      - item_id
      - output_index
      - sequence_number
      - summary_index
      title: OpenAIResponseObjectStreamResponseReasoningSummaryTextDone
      type: object
    OpenAIResponseObjectStreamResponseReasoningTextDelta:
      description: Streaming event for incremental reasoning text updates.
      properties:
        content_index:
          title: Content Index
          type: integer
        delta:
          title: Delta
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.reasoning_text.delta
      required:
      - content_index
      - delta
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseReasoningTextDelta
      type: object
    OpenAIResponseObjectStreamResponseReasoningTextDone:
      description: Streaming event for when reasoning text is completed.
      properties:
        content_index:
          title: Content Index
          type: integer
        text:
          title: Text
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.reasoning_text.done
      required:
      - content_index
      - text
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseReasoningTextDone
      type: object
    OpenAIResponseObjectStreamResponseRefusalDelta:
      description: Streaming event for incremental refusal text updates.
      properties:
        content_index:
          title: Content Index
          type: integer
        delta:
          title: Delta
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.refusal.delta
      required:
      - content_index
      - delta
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseRefusalDelta
      type: object
    OpenAIResponseObjectStreamResponseRefusalDone:
      description: Streaming event for when refusal text is completed.
      properties:
        content_index:
          title: Content Index
          type: integer
        refusal:
          title: Refusal
          type: string
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.refusal.done
      required:
      - content_index
      - refusal
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseRefusalDone
      type: object
    OpenAIResponseObjectStreamResponseWebSearchCallCompleted:
      description: Streaming event for completed web search calls.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.web_search_call.completed
      required:
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseWebSearchCallCompleted
      type: object
    OpenAIResponseObjectStreamResponseWebSearchCallInProgress:
      description: Streaming event for web search calls in progress.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.web_search_call.in_progress
      required:
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseWebSearchCallInProgress
      type: object
    OpenAIResponseObjectStreamResponseWebSearchCallSearching:
      description: Streaming event for web search calls currently searching.
      properties:
        item_id:
          title: Item Id
          type: string
        output_index:
          title: Output Index
          type: integer
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - response.web_search_call.searching
      required:
      - item_id
      - output_index
      - sequence_number
      title: OpenAIResponseObjectStreamResponseWebSearchCallSearching
      type: object
    OpenAIDeleteResponseObject:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          enum:
          - response
        deleted:
          type: boolean
          title: Deleted
          default: true
      type: object
      required:
      - id
      title: OpenAIDeleteResponseObject
      description: Response object confirming deletion of an OpenAI response.
    ListOpenAIResponseInputItem:
      properties:
        data:
          items:
            $ref: '#/components/schemas/OpenAIResponseMessageOutputUnion'
          type: array
          title: Data
        object:
          type: string
          title: Object
          enum:
          - list
      type: object
      required:
      - data
      title: ListOpenAIResponseInputItem
      description: List container for OpenAI response input items.
    RunShieldRequest:
      properties:
        shield_id:
          type: string
          minLength: 1
          title: Shield Id
          description: The identifier of the shield to run
        messages:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIUserMessageParam-Input'
              title: OpenAIUserMessageParam-Input
            - $ref: '#/components/schemas/OpenAISystemMessageParam'
              title: OpenAISystemMessageParam
            - $ref: '#/components/schemas/OpenAIAssistantMessageParam-Input'
              title: OpenAIAssistantMessageParam-Input
            - $ref: '#/components/schemas/OpenAIToolMessageParam'
              title: OpenAIToolMessageParam
            - $ref: '#/components/schemas/OpenAIDeveloperMessageParam'
              title: OpenAIDeveloperMessageParam
            discriminator:
              propertyName: role
              mapping:
                assistant: '#/components/schemas/OpenAIAssistantMessageParam-Input'
                developer: '#/components/schemas/OpenAIDeveloperMessageParam'
                system: '#/components/schemas/OpenAISystemMessageParam'
                tool: '#/components/schemas/OpenAIToolMessageParam'
                user: '#/components/schemas/OpenAIUserMessageParam-Input'
            title: OpenAIUserMessageParam-Input | ... (5 variants)
          type: array
          title: Messages
          description: The messages to run the shield on
      type: object
      required:
      - shield_id
      - messages
      title: RunShieldRequest
      description: Request model for running a safety shield.
    RunShieldResponse:
      properties:
        violation:
          anyOf:
          - $ref: '#/components/schemas/SafetyViolation'
            title: SafetyViolation
          - type: 'null'
          description: Safety violation detected by the shield, if any
          title: SafetyViolation
      type: object
      title: RunShieldResponse
      description: Response from running a safety shield.
    SafetyViolation:
      properties:
        violation_level:
          $ref: '#/components/schemas/ViolationLevel'
          description: Severity level of the violation
        user_message:
          anyOf:
          - type: string
          - type: 'null'
          description: Message to convey to the user about the violation
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Additional metadata including specific violation codes
      type: object
      required:
      - violation_level
      title: SafetyViolation
      description: Details of a safety violation detected by content moderation.
    ViolationLevel:
      type: string
      enum:
      - info
      - warn
      - error
      title: ViolationLevel
      description: Severity level of a safety violation.
    ArrayType:
      description: Parameter type for array values.
      properties:
        type:
          title: Type
          type: string
          enum:
          - array
      title: ArrayType
      type: object
    BooleanType:
      description: Parameter type for boolean values.
      properties:
        type:
          title: Type
          type: string
          enum:
          - boolean
      title: BooleanType
      type: object
    ChatCompletionInputType:
      description: Parameter type for chat completion input.
      properties:
        type:
          title: Type
          type: string
          enum:
          - chat_completion_input
      title: ChatCompletionInputType
      type: object
    CompletionInputType:
      description: Parameter type for completion input.
      properties:
        type:
          title: Type
          type: string
          enum:
          - completion_input
      title: CompletionInputType
      type: object
    JsonType:
      description: Parameter type for JSON values.
      properties:
        type:
          title: Type
          type: string
          enum:
          - json
      title: JsonType
      type: object
    NumberType:
      description: Parameter type for numeric values.
      properties:
        type:
          title: Type
          type: string
          enum:
          - number
      title: NumberType
      type: object
    ObjectType:
      description: Parameter type for object values.
      properties:
        type:
          title: Type
          type: string
          enum:
          - object
      title: ObjectType
      type: object
    StringType:
      description: Parameter type for string values.
      properties:
        type:
          title: Type
          type: string
          enum:
          - string
      title: StringType
      type: object
    UnionType:
      description: Parameter type for union values.
      properties:
        type:
          title: Type
          type: string
          enum:
          - union
      title: UnionType
      type: object
    Shield:
      properties:
        identifier:
          type: string
          title: Identifier
          description: Unique identifier for this resource in ogx
        provider_resource_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Unique identifier for this resource in the provider
        provider_id:
          type: string
          title: Provider Id
          description: ID of the provider that owns this resource
        type:
          type: string
          title: Type
          enum:
          - shield
        params:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
      type: object
      required:
      - identifier
      - provider_id
      title: Shield
      description: A safety shield resource that can be used to check content.
    ListShieldsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Shield'
          type: array
          title: Data
          description: List of shield objects
      type: object
      required:
      - data
      title: ListShieldsResponse
      description: Response containing a list of all shields.
    ImageContentItem:
      description: A image content item
      properties:
        type:
          title: Type
          type: string
          enum:
          - image
        image:
          $ref: '#/components/schemas/_URLOrData'
      required:
      - image
      title: ImageContentItem
      type: object
    InterleavedContent:
      anyOf:
      - type: string
      - discriminator:
          mapping:
            image: '#/components/schemas/ImageContentItem'
            text: '#/components/schemas/TextContentItem'
          propertyName: type
        oneOf:
        - $ref: '#/components/schemas/ImageContentItem'
          title: ImageContentItem
        - $ref: '#/components/schemas/TextContentItem'
          title: TextContentItem
        title: ImageContentItem | TextContentItem
      - items:
          discriminator:
            mapping:
              image: '#/components/schemas/ImageContentItem'
              text: '#/components/schemas/TextContentItem'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/ImageContentItem'
            title: ImageContentItem
          - $ref: '#/components/schemas/TextContentItem'
            title: TextContentItem
          title: ImageContentItem | TextContentItem
        type: array
        title: list[ImageContentItem | TextContentItem]
      title: string | list[ImageContentItem | TextContentItem]
    InterleavedContentItem:
      discriminator:
        mapping:
          image: '#/components/schemas/ImageContentItem'
          text: '#/components/schemas/TextContentItem'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/ImageContentItem'
        title: ImageContentItem
      - $ref: '#/components/schemas/TextContentItem'
        title: TextContentItem
      title: ImageContentItem | TextContentItem
    TextContentItem:
      properties:
        type:
          type: string
          title: Type
          enum:
          - text
        text:
          type: string
          title: Text
      type: object
      required:
      - text
      title: TextContentItem
      description: A text content item
    ToolInvocationResult:
      description: Result of a tool invocation.
      properties:
        content:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/components/schemas/ImageContentItem'
                text: '#/components/schemas/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
              title: ImageContentItem
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            title: ImageContentItem | TextContentItem
          - items:
              discriminator:
                mapping:
                  image: '#/components/schemas/ImageContentItem'
                  text: '#/components/schemas/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
                title: ImageContentItem
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              title: ImageContentItem | TextContentItem
            type: array
            title: list[ImageContentItem | TextContentItem]
          - type: 'null'
          description: The content returned by the tool.
          title: string | list[ImageContentItem | TextContentItem]
          nullable: true
        error_message:
          anyOf:
          - type: string
          - type: 'null'
          description: Error message if the tool invocation failed.
          nullable: true
        error_code:
          anyOf:
          - type: integer
          - type: 'null'
          description: Error code if the tool invocation failed.
          nullable: true
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Additional metadata returned by the tool invocation.
          nullable: true
      title: ToolInvocationResult
      type: object
    URL:
      properties:
        uri:
          type: string
          title: Uri
      type: object
      required:
      - uri
      title: URL
      description: A URL reference to external content.
    ToolDef:
      properties:
        toolgroup_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The ID of the tool group this tool belongs to.
        name:
          type: string
          title: Name
          description: The name of the tool.
        description:
          anyOf:
          - type: string
          - type: 'null'
          description: A human-readable description of what the tool does.
        input_schema:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: JSON Schema describing the tool's input parameters.
        output_schema:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: JSON Schema describing the tool's output format.
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Additional metadata associated with the tool.
      type: object
      required:
      - name
      title: ToolDef
      description: Tool definition used in runtime contexts.
    ListToolDefsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ToolDef'
          type: array
          title: Data
          description: List of tool definitions.
      type: object
      required:
      - data
      title: ListToolDefsResponse
      description: Response containing a list of tool definitions.
    ToolGroup:
      description: A group of related tools managed together.
      properties:
        identifier:
          description: Unique identifier for this resource in ogx
          title: Identifier
          type: string
        provider_resource_id:
          anyOf:
          - type: string
          - type: 'null'
          description: Unique identifier for this resource in the provider
          nullable: true
        provider_id:
          description: ID of the provider that owns this resource
          title: Provider Id
          type: string
        type:
          title: Type
          type: string
          enum:
          - tool_group
        mcp_endpoint:
          anyOf:
          - $ref: '#/components/schemas/URL'
            title: URL
          - type: 'null'
          description: Model Context Protocol endpoint URL for remote tool groups.
          nullable: true
          title: URL
        args:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Additional arguments for the tool group.
          nullable: true
      required:
      - identifier
      - provider_id
      title: ToolGroup
      type: object
    ListToolGroupsResponse:
      description: Response containing a list of tool groups.
      properties:
        data:
          description: List of tool groups.
          items:
            $ref: '#/components/schemas/ToolGroup'
          title: Data
          type: array
      required:
      - data
      title: ListToolGroupsResponse
      type: object
    Chunk:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
              title: ImageContentItem-Output
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
            title: ImageContentItem-Output | TextContentItem
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
                title: ImageContentItem-Output
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
              title: ImageContentItem-Output | TextContentItem
            type: array
            title: list[ImageContentItem-Output | TextContentItem]
          title: string | list[ImageContentItem-Output | TextContentItem]
        chunk_id:
          type: string
          title: Chunk Id
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        chunk_metadata:
          $ref: '#/components/schemas/ChunkMetadata'
      type: object
      required:
      - content
      - chunk_id
      - chunk_metadata
      title: Chunk
      description: A chunk of content from file processing.
    ChunkMetadata:
      properties:
        chunk_id:
          anyOf:
          - type: string
          - type: 'null'
        document_id:
          anyOf:
          - type: string
          - type: 'null'
        source:
          anyOf:
          - type: string
          - type: 'null'
        created_timestamp:
          anyOf:
          - type: integer
          - type: 'null'
        updated_timestamp:
          anyOf:
          - type: integer
          - type: 'null'
        chunk_window:
          anyOf:
          - type: string
          - type: 'null'
        chunk_tokenizer:
          anyOf:
          - type: string
          - type: 'null'
        content_token_count:
          anyOf:
          - type: integer
          - type: 'null'
        metadata_token_count:
          anyOf:
          - type: integer
          - type: 'null'
      type: object
      title: ChunkMetadata
      description: |-
        `ChunkMetadata` is backend metadata for a `Chunk` that is used to store additional information about the chunk that
            will not be used in the context during inference, but is required for backend functionality. The `ChunkMetadata`
            is set during chunk creation in `FileSearchToolRuntimeImpl().insert()`and is not expected to change after.
            Use `Chunk.metadata` for metadata that will be used in the context during inference.
    InsertChunksRequest:
      properties:
        vector_store_id:
          type: string
          title: Vector Store Id
          description: The ID of the vector store to insert chunks into.
        chunks:
          items:
            $ref: '#/components/schemas/EmbeddedChunk-Input'
          type: array
          title: Chunks
          description: The list of embedded chunks to insert.
        ttl_seconds:
          anyOf:
          - type: integer
          - type: 'null'
          description: Time-to-live in seconds for the inserted chunks.
      type: object
      required:
      - vector_store_id
      - chunks
      title: InsertChunksRequest
      description: Request body for inserting chunks into a vector store.
    QueryChunksRequest:
      properties:
        vector_store_id:
          type: string
          title: Vector Store Id
          description: The ID of the vector store to query.
        query:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Input'
              title: ImageContentItem-Input
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Input'
                text: '#/components/schemas/TextContentItem'
            title: ImageContentItem-Input | TextContentItem
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Input'
                title: ImageContentItem-Input
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Input'
                  text: '#/components/schemas/TextContentItem'
              title: ImageContentItem-Input | TextContentItem
            type: array
            title: list[ImageContentItem-Input | TextContentItem]
          title: string | list[ImageContentItem-Input | TextContentItem]
          description: The query content to search for.
        params:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Additional query parameters.
      type: object
      required:
      - vector_store_id
      - query
      title: QueryChunksRequest
      description: Request body for querying chunks from a vector store.
    QueryChunksResponse:
      properties:
        chunks:
          items:
            $ref: '#/components/schemas/EmbeddedChunk-Output'
          type: array
          title: Chunks
        scores:
          items:
            type: number
          type: array
          title: Scores
      type: object
      required:
      - chunks
      - scores
      title: QueryChunksResponse
      description: Response from querying chunks in a vector database.
    VectorStoreFileCounts:
      properties:
        completed:
          type: integer
          title: Completed
        cancelled:
          type: integer
          title: Cancelled
        failed:
          type: integer
          title: Failed
        in_progress:
          type: integer
          title: In Progress
        total:
          type: integer
          title: Total
      type: object
      required:
      - completed
      - cancelled
      - failed
      - in_progress
      - total
      title: VectorStoreFileCounts
      description: File processing status counts for a vector store.
    VectorStoreListResponse:
      properties:
        object:
          type: string
          title: Object
          enum:
          - list
        data:
          items:
            $ref: '#/components/schemas/VectorStoreObject'
          type: array
          title: Data
        first_id:
          type: string
          title: First Id
        last_id:
          type: string
          title: Last Id
        has_more:
          type: boolean
          title: Has More
      type: object
      required:
      - data
      - first_id
      - last_id
      - has_more
      title: VectorStoreListResponse
      description: Response from listing vector stores.
    VectorStoreObject:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          enum:
          - vector_store
        created_at:
          type: integer
          title: Created At
        name:
          type: string
          title: Name
          default: ''
        usage_bytes:
          type: integer
          title: Usage Bytes
          default: 0
        file_counts:
          $ref: '#/components/schemas/VectorStoreFileCounts'
        status:
          type: string
          enum:
          - expired
          - in_progress
          - completed
          title: Status
        expires_after:
          anyOf:
          - $ref: '#/components/schemas/VectorStoreExpirationAfter'
            title: VectorStoreExpirationAfter
          - type: 'null'
          title: VectorStoreExpirationAfter
        expires_at:
          anyOf:
          - type: integer
          - type: 'null'
        last_active_at:
          anyOf:
          - type: integer
          - type: 'null'
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
      type: object
      required:
      - id
      - created_at
      - file_counts
      - status
      title: VectorStoreObject
      description: OpenAI Vector Store object.
    VectorStoreChunkingStrategy:
      discriminator:
        mapping:
          auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
          contextual: '#/components/schemas/VectorStoreChunkingStrategyContextual'
          static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
        title: VectorStoreChunkingStrategyAuto
      - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
        title: VectorStoreChunkingStrategyStatic
      - $ref: '#/components/schemas/VectorStoreChunkingStrategyContextual'
        title: VectorStoreChunkingStrategyContextual
      title: VectorStoreChunkingStrategyAuto | VectorStoreChunkingStrategyStatic | VectorStoreChunkingStrategyContextual
    VectorStoreChunkingStrategyAuto:
      properties:
        type:
          type: string
          title: Type
          enum:
          - auto
      type: object
      title: VectorStoreChunkingStrategyAuto
      description: Automatic chunking strategy for vector store files.
    VectorStoreChunkingStrategyStatic:
      properties:
        type:
          type: string
          title: Type
          enum:
          - static
        static:
          $ref: '#/components/schemas/VectorStoreChunkingStrategyStaticConfig'
      type: object
      required:
      - static
      title: VectorStoreChunkingStrategyStatic
      description: Static chunking strategy with configurable parameters.
    VectorStoreChunkingStrategyStaticConfig:
      properties:
        chunk_overlap_tokens:
          type: integer
          title: Chunk Overlap Tokens
          default: 400
        max_chunk_size_tokens:
          type: integer
          maximum: 4096.0
          minimum: 100.0
          title: Max Chunk Size Tokens
          default: 800
      type: object
      title: VectorStoreChunkingStrategyStaticConfig
      description: Configuration for static chunking strategy.
    OpenAICreateVectorStoreRequestWithExtraBody:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
        description:
          anyOf:
          - type: string
          - type: 'null'
        file_ids:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
        expires_after:
          anyOf:
          - $ref: '#/components/schemas/VectorStoreExpirationAfter'
            title: VectorStoreExpirationAfter
          - type: 'null'
          title: VectorStoreExpirationAfter
        chunking_strategy:
          anyOf:
          - oneOf:
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              title: VectorStoreChunkingStrategyAuto
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
              title: VectorStoreChunkingStrategyStatic
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyContextual'
              title: VectorStoreChunkingStrategyContextual
            discriminator:
              propertyName: type
              mapping:
                auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
                contextual: '#/components/schemas/VectorStoreChunkingStrategyContextual'
                static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
            title: VectorStoreChunkingStrategyAuto | VectorStoreChunkingStrategyStatic | VectorStoreChunkingStrategyContextual
          - type: 'null'
          title: Chunking Strategy
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
      additionalProperties: true
      type: object
      title: OpenAICreateVectorStoreRequestWithExtraBody
      description: Request to create a vector store with extra_body support.
    VectorStoreDeleteResponse:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          enum:
          - vector_store.deleted
        deleted:
          type: boolean
          title: Deleted
      type: object
      required:
      - id
      - deleted
      title: VectorStoreDeleteResponse
      description: Response from deleting a vector store.
    OpenAICreateVectorStoreFileBatchRequestWithExtraBody:
      properties:
        file_ids:
          items:
            type: string
          type: array
          title: File Ids
        files:
          anyOf:
          - items:
              $ref: '#/components/schemas/VectorStoreFileBatchFileEntry'
            type: array
          - type: 'null'
        attributes:
          anyOf:
          - additionalProperties:
              anyOf:
              - type: string
                maxLength: 512
              - type: number
              - type: boolean
              title: string | number | boolean
            propertyNames:
              type: string
              maxLength: 64
            type: object
            maxProperties: 16
            description: Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers.
            x-oaiTypeLabel: map
          - type: 'null'
        chunking_strategy:
          anyOf:
          - oneOf:
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              title: VectorStoreChunkingStrategyAuto
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
              title: VectorStoreChunkingStrategyStatic
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyContextual'
              title: VectorStoreChunkingStrategyContextual
            discriminator:
              propertyName: type
              mapping:
                auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
                contextual: '#/components/schemas/VectorStoreChunkingStrategyContextual'
                static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
            title: VectorStoreChunkingStrategyAuto | VectorStoreChunkingStrategyStatic | VectorStoreChunkingStrategyContextual
          - type: 'null'
          title: Chunking Strategy
      additionalProperties: true
      type: object
      title: OpenAICreateVectorStoreFileBatchRequestWithExtraBody
      description: Request to create a vector store file batch with extra_body support.
    VectorStoreFileBatchObject:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          enum:
          - vector_store.files_batch
        created_at:
          type: integer
          title: Created At
        vector_store_id:
          type: string
          title: Vector Store Id
        status:
          type: string
          enum:
          - in_progress
          - completed
          - cancelled
          - failed
          title: Status
        file_counts:
          $ref: '#/components/schemas/VectorStoreFileCounts'
      type: object
      required:
      - id
      - created_at
      - vector_store_id
      - status
      - file_counts
      title: VectorStoreFileBatchObject
      description: OpenAI Vector Store File Batch object.
    VectorStoreFileStatus:
      enum:
      - in_progress
      - completed
      - cancelled
      - failed
      type: string
    VectorStoreFileLastError:
      properties:
        code:
          type: string
          enum:
          - server_error
          - unsupported_file
          - invalid_file
          title: Code
        message:
          type: string
          title: Message
      type: object
      required:
      - code
      - message
      title: VectorStoreFileLastError
      description: Error information for failed vector store file processing.
    VectorStoreFileObject:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          enum:
          - vector_store.file
        attributes:
          anyOf:
          - additionalProperties:
              anyOf:
              - type: string
                maxLength: 512
              - type: number
              - type: boolean
              title: string | number | boolean
            propertyNames:
              type: string
              maxLength: 64
            type: object
            maxProperties: 16
            description: Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers.
            x-oaiTypeLabel: map
          - type: 'null'
        chunking_strategy:
          oneOf:
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
            title: VectorStoreChunkingStrategyAuto
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
            title: VectorStoreChunkingStrategyStatic
          - $ref: '#/components/schemas/VectorStoreChunkingStrategyContextual'
            title: VectorStoreChunkingStrategyContextual
          title: VectorStoreChunkingStrategyAuto | VectorStoreChunkingStrategyStatic | VectorStoreChunkingStrategyContextual
          discriminator:
            propertyName: type
            mapping:
              auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              contextual: '#/components/schemas/VectorStoreChunkingStrategyContextual'
              static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
        created_at:
          type: integer
          title: Created At
        last_error:
          anyOf:
          - $ref: '#/components/schemas/VectorStoreFileLastError'
            title: VectorStoreFileLastError
          - type: 'null'
          title: VectorStoreFileLastError
        status:
          type: string
          enum:
          - in_progress
          - completed
          - cancelled
          - failed
          title: Status
        usage_bytes:
          type: integer
          title: Usage Bytes
          default: 0
        vector_store_id:
          type: string
          title: Vector Store Id
      type: object
      required:
      - id
      - chunking_strategy
      - created_at
      - status
      - vector_store_id
      title: VectorStoreFileObject
      description: OpenAI Vector Store File object.
    VectorStoreFilesListInBatchResponse:
      properties:
        object:
          type: string
          title: Object
          enum:
          - list
        data:
          items:
            $ref: '#/components/schemas/VectorStoreFileObject'
          type: array
          title: Data
        first_id:
          type: string
          title: First Id
        last_id:
          type: string
          title: Last Id
        has_more:
          type: boolean
          title: Has More
      type: object
      required:
      - data
      - first_id
      - last_id
      - has_more
      title: VectorStoreFilesListInBatchResponse
      description: Response from listing files in a vector store file batch.
    VectorStoreListFilesResponse:
      properties:
        object:
          type: string
          title: Object
          enum:
          - list
        data:
          items:
            $ref: '#/components/schemas/VectorStoreFileObject'
          type: array
          title: Data
        first_id:
          type: string
          title: First Id
        last_id:
          type: string
          title: Last Id
        has_more:
          type: boolean
          title: Has More
      type: object
      required:
      - data
      - first_id
      - last_id
      - has_more
      title: VectorStoreListFilesResponse
      description: Response from listing files in a vector store.
    VectorStoreFileDeleteResponse:
      properties:
        id:
          type: string
          title: Id
        object:
          type: string
          title: Object
          enum:
          - vector_store.file.deleted
        deleted:
          type: boolean
          title: Deleted
      type: object
      required:
      - id
      - deleted
      title: VectorStoreFileDeleteResponse
      description: Response from deleting a vector store file.
    VectorStoreContent:
      properties:
        type:
          type: string
          title: Type
          enum:
          - text
        text:
          type: string
          title: Text
        embedding:
          anyOf:
          - items:
              type: number
            type: array
          - type: 'null'
        chunk_metadata:
          anyOf:
          - $ref: '#/components/schemas/ChunkMetadata'
            title: ChunkMetadata
          - type: 'null'
          title: ChunkMetadata
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
      type: object
      required:
      - type
      - text
      title: VectorStoreContent
      description: Content item from a vector store file or search result.
    VectorStoreFileContentResponse:
      properties:
        object:
          type: string
          title: Object
          enum:
          - vector_store.file_content.page
        data:
          items:
            $ref: '#/components/schemas/VectorStoreContent'
          type: array
          title: Data
        has_more:
          type: boolean
          title: Has More
        next_page:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - data
      - has_more
      title: VectorStoreFileContentResponse
      description: Represents the parsed content of a vector store file.
    VectorStoreSearchResponse:
      properties:
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        score:
          type: number
          title: Score
        attributes:
          anyOf:
          - additionalProperties:
              anyOf:
              - type: string
              - type: number
              - type: boolean
              title: string | number | boolean
            type: object
          - type: 'null'
        content:
          items:
            $ref: '#/components/schemas/VectorStoreContent'
          type: array
          title: Content
      type: object
      required:
      - file_id
      - filename
      - score
      - content
      title: VectorStoreSearchResponse
      description: Response from searching a vector store.
    VectorStoreSearchResponsePage:
      properties:
        object:
          type: string
          title: Object
          enum:
          - vector_store.search_results.page
        search_query:
          items:
            type: string
          type: array
          title: Search Query
        data:
          items:
            $ref: '#/components/schemas/VectorStoreSearchResponse'
          type: array
          title: Data
        has_more:
          type: boolean
          title: Has More
        next_page:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - search_query
      - data
      - has_more
      title: VectorStoreSearchResponsePage
      description: Paginated response from searching a vector store.
    VersionInfo:
      properties:
        version:
          type: string
          title: Version
          description: The version string of the service
      type: object
      required:
      - version
      title: VersionInfo
      description: Version information for the service.
    RerankRequest:
      properties:
        model:
          type: string
          title: Model
          description: The identifier of the reranking model to use.
        query:
          anyOf:
          - type: string
          - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            title: OpenAIChatCompletionContentPartTextParam
          - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
            title: OpenAIChatCompletionContentPartImageParam
          title: string | OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam
          description: The search query to rank items against. Can be a string, text content part, or image content part.
        items:
          items:
            anyOf:
            - type: string
            - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
              title: OpenAIChatCompletionContentPartTextParam
            - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
              title: OpenAIChatCompletionContentPartImageParam
            title: string | OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam
          type: array
          minItems: 1
          title: Items
          description: List of items to rerank. Each item can be a string, text content part, or image content part.
        max_num_results:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: 'Maximum number of results to return. Default: returns all.'
      type: object
      required:
      - model
      - query
      - items
      title: RerankRequest
      description: Request model for reranking documents.
    RerankData:
      properties:
        index:
          type: integer
          minimum: 0.0
          title: Index
          description: The original index of the document in the input list.
        relevance_score:
          type: number
          title: Relevance Score
          description: The relevance score from the model output. Higher scores indicate greater relevance.
      type: object
      required:
      - index
      - relevance_score
      title: RerankData
      description: A single rerank result from a reranking response.
    RerankResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/RerankData'
          type: array
          title: Data
          description: List of rerank result objects, sorted by relevance score (descending).
      type: object
      required:
      - data
      title: RerankResponse
      description: Response from a reranking request.
    RegisterModelRequest:
      description: Request model for registering a model.
      properties:
        model_id:
          description: The identifier of the model to register.
          title: Model Id
          type: string
        provider_model_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The identifier of the model in the provider.
          nullable: true
        provider_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The identifier of the provider.
          nullable: true
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Any additional metadata for this model.
          nullable: true
        model_type:
          anyOf:
          - $ref: '#/components/schemas/ModelType'
            title: ModelType
          - type: 'null'
          description: The type of model to register.
          nullable: true
          title: ModelType
        model_validation:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Enable model availability check during registration. When false (default), validation is deferred to runtime and model is preserved during provider refresh.
          nullable: true
      required:
      - model_id
      title: RegisterModelRequest
      type: object
    ParamType:
      discriminator:
        mapping:
          array: '#/components/schemas/ArrayType'
          boolean: '#/components/schemas/BooleanType'
          chat_completion_input: '#/components/schemas/ChatCompletionInputType'
          completion_input: '#/components/schemas/CompletionInputType'
          json: '#/components/schemas/JsonType'
          number: '#/components/schemas/NumberType'
          object: '#/components/schemas/ObjectType'
          string: '#/components/schemas/StringType'
          union: '#/components/schemas/UnionType'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/StringType'
        title: StringType
      - $ref: '#/components/schemas/NumberType'
        title: NumberType
      - $ref: '#/components/schemas/BooleanType'
        title: BooleanType
      - $ref: '#/components/schemas/ArrayType'
        title: ArrayType
      - $ref: '#/components/schemas/ObjectType'
        title: ObjectType
      - $ref: '#/components/schemas/JsonType'
        title: JsonType
      - $ref: '#/components/schemas/UnionType'
        title: UnionType
      - $ref: '#/components/schemas/ChatCompletionInputType'
        title: ChatCompletionInputType
      - $ref: '#/components/schemas/CompletionInputType'
        title: CompletionInputType
      title: StringType | ... (9 variants)
    RegisterShieldRequest:
      properties:
        shield_id:
          type: string
          title: Shield Id
          description: The identifier of the shield to register.
        provider_shield_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The identifier of the shield in the provider.
        provider_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The identifier of the provider.
        params:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: The parameters of the shield.
      type: object
      required:
      - shield_id
      title: RegisterShieldRequest
      description: Request model for registering a shield.
    AllowedToolsFilter:
      properties:
        tool_names:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
      type: object
      title: AllowedToolsFilter
      description: Filter configuration for restricting which MCP tools can be used.
    ApprovalFilter:
      properties:
        always:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
        never:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
      type: object
      title: ApprovalFilter
      description: Filter configuration for MCP tool approval requirements.
    BatchError:
      properties:
        code:
          anyOf:
          - type: string
          - type: 'null'
        line:
          anyOf:
          - type: integer
          - type: 'null'
        message:
          anyOf:
          - type: string
          - type: 'null'
        param:
          anyOf:
          - type: string
          - type: 'null'
      additionalProperties: true
      type: object
      title: BatchError
    BatchRequestCounts:
      properties:
        completed:
          type: integer
          title: Completed
        failed:
          type: integer
          title: Failed
        total:
          type: integer
          title: Total
      additionalProperties: true
      type: object
      required:
      - completed
      - failed
      - total
      title: BatchRequestCounts
      description: The request counts for different statuses within the batch.
    BatchUsage:
      properties:
        input_tokens:
          type: integer
          title: Input Tokens
        input_tokens_details:
          $ref: '#/components/schemas/InputTokensDetails'
        output_tokens:
          type: integer
          title: Output Tokens
        output_tokens_details:
          $ref: '#/components/schemas/OutputTokensDetails'
        total_tokens:
          type: integer
          title: Total Tokens
      additionalProperties: true
      type: object
      required:
      - input_tokens
      - input_tokens_details
      - output_tokens
      - output_tokens_details
      - total_tokens
      title: BatchUsage
      description: |-
        Represents token usage details including input tokens, output tokens, a
        breakdown of output tokens, and the total tokens used. Only populated on
        batches created after September 7, 2025.
    Body_process_file_v1alpha_file_processors_process_post:
      properties:
        file:
          anyOf:
          - type: string
            format: binary
          - type: 'null'
          description: The File object to be uploaded and processed. Mutually exclusive with file_id.
        file_id:
          anyOf:
          - type: string
          - type: 'null'
          description: ID of file already uploaded to file storage. Mutually exclusive with file.
        options:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Optional processing options. Provider-specific parameters (e.g., OCR settings, output format).
        chunking_strategy:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional chunking strategy for splitting content into chunks. Must be valid JSON string.
      type: object
      title: Body_process_file_v1alpha_file_processors_process_post
    Connector:
      properties:
        connector_type:
          $ref: '#/components/schemas/ConnectorType'
          default: mcp
        connector_id:
          type: string
          title: Connector Id
          description: Identifier for the connector
        url:
          type: string
          title: Url
          description: URL of the connector
        server_label:
          anyOf:
          - type: string
          - type: 'null'
          description: Label of the server
        server_name:
          anyOf:
          - type: string
          - type: 'null'
          description: Name of the server
        server_description:
          anyOf:
          - type: string
          - type: 'null'
          description: Description of the server
        server_version:
          anyOf:
          - type: string
          - type: 'null'
          description: Version of the server
      type: object
      required:
      - connector_id
      - url
      title: Connector
      description: A connector registered in OGX
    ConnectorType:
      type: string
      enum:
      - mcp
      title: ConnectorType
      description: Type of connector.
    ConversationItemInclude:
      type: string
      enum:
      - web_search_call.action.sources
      - code_interpreter_call.outputs
      - computer_call_output.output.image_url
      - file_search_call.results
      - message.input_image.image_url
      - message.output_text.logprobs
      - reasoning.encrypted_content
      title: ConversationItemInclude
      description: Specify additional output data to include in the model response.
    EmbeddedChunk-Input:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Input'
              title: ImageContentItem-Input
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Input'
                text: '#/components/schemas/TextContentItem'
            title: ImageContentItem-Input | TextContentItem
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Input'
                title: ImageContentItem-Input
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Input'
                  text: '#/components/schemas/TextContentItem'
              title: ImageContentItem-Input | TextContentItem
            type: array
            title: list[ImageContentItem-Input | TextContentItem]
          title: string | list[ImageContentItem-Input | TextContentItem]
        chunk_id:
          type: string
          title: Chunk Id
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        chunk_metadata:
          $ref: '#/components/schemas/ChunkMetadata'
        embedding:
          items:
            type: number
          type: array
          title: Embedding
        embedding_model:
          type: string
          title: Embedding Model
        embedding_dimension:
          type: integer
          title: Embedding Dimension
      type: object
      required:
      - content
      - chunk_id
      - chunk_metadata
      - embedding
      - embedding_model
      - embedding_dimension
      title: EmbeddedChunk
      description: |-
        A chunk of content with its embedding vector for vector database operations.
        Inherits all fields from Chunk and adds embedding-related fields.
    EmbeddedChunk-Output:
      properties:
        content:
          anyOf:
          - type: string
          - oneOf:
            - $ref: '#/components/schemas/ImageContentItem-Output'
              title: ImageContentItem-Output
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            discriminator:
              propertyName: type
              mapping:
                image: '#/components/schemas/ImageContentItem-Output'
                text: '#/components/schemas/TextContentItem'
            title: ImageContentItem-Output | TextContentItem
          - items:
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem-Output'
                title: ImageContentItem-Output
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              discriminator:
                propertyName: type
                mapping:
                  image: '#/components/schemas/ImageContentItem-Output'
                  text: '#/components/schemas/TextContentItem'
              title: ImageContentItem-Output | TextContentItem
            type: array
            title: list[ImageContentItem-Output | TextContentItem]
          title: string | list[ImageContentItem-Output | TextContentItem]
        chunk_id:
          type: string
          title: Chunk Id
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
        chunk_metadata:
          $ref: '#/components/schemas/ChunkMetadata'
        embedding:
          items:
            type: number
          type: array
          title: Embedding
        embedding_model:
          type: string
          title: Embedding Model
        embedding_dimension:
          type: integer
          title: Embedding Dimension
      type: object
      required:
      - content
      - chunk_id
      - chunk_metadata
      - embedding
      - embedding_model
      - embedding_dimension
      title: EmbeddedChunk
      description: |-
        A chunk of content with its embedding vector for vector database operations.
        Inherits all fields from Chunk and adds embedding-related fields.
    Errors:
      properties:
        data:
          anyOf:
          - items:
              $ref: '#/components/schemas/BatchError'
            type: array
          - type: 'null'
        object:
          anyOf:
          - type: string
          - type: 'null'
      additionalProperties: true
      type: object
      title: Errors
    GoogleCreateInteractionRequest:
      properties:
        model:
          type: string
          title: Model
          description: The model to use for generation.
        input:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/GoogleInputTurn'
              description: A conversation turn.
            type: array
            title: list[GoogleInputTurn]
          title: string | list[GoogleInputTurn]
          description: Prompt string or list of conversation turns.
        system_instruction:
          anyOf:
          - type: string
          - type: 'null'
          description: System prompt.
        generation_config:
          anyOf:
          - $ref: '#/components/schemas/GoogleGenerationConfig'
            title: GoogleGenerationConfig
          - type: 'null'
          description: Generation parameters.
          title: GoogleGenerationConfig
        tools:
          anyOf:
          - items:
              $ref: '#/components/schemas/GoogleTool'
            type: array
          - type: 'null'
          description: Tools (function declarations) available to the model.
        stream:
          anyOf:
          - type: boolean
          - type: 'null'
          description: Whether to stream the response via SSE.
          default: false
        response_modalities:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: Accepted response modalities (e.g. ['TEXT']). Accepted for compatibility, ignored in v1.
      additionalProperties: true
      type: object
      required:
      - model
      - input
      title: GoogleCreateInteractionRequest
      description: Request body for POST /v1alpha/interactions.
    GoogleFunctionCallContent:
      properties:
        type:
          type: string
          title: Type
          enum:
          - function_call
        id:
          anyOf:
          - type: string
          - type: 'null'
          description: Unique identifier for this function call.
        name:
          type: string
          title: Name
          description: Name of the function to call.
        arguments:
          additionalProperties: true
          type: object
          title: Arguments
          description: Arguments for the function call.
      additionalProperties: true
      type: object
      required:
      - name
      title: GoogleFunctionCallContent
      description: A function call content item (model requesting a tool invocation).
    GoogleFunctionCallOutput:
      properties:
        type:
          type: string
          title: Type
          enum:
          - function_call
        id:
          anyOf:
          - type: string
          - type: 'null'
          description: Unique identifier for this function call.
        name:
          type: string
          title: Name
          description: Name of the function to call.
        arguments:
          additionalProperties: true
          type: object
          title: Arguments
          description: Arguments for the function call.
      additionalProperties: true
      type: object
      required:
      - name
      title: GoogleFunctionCallOutput
      description: A function call output item (model requesting a tool invocation).
    GoogleFunctionDeclaration:
      properties:
        name:
          type: string
          title: Name
          description: The name of the function.
        description:
          anyOf:
          - type: string
          - type: 'null'
          description: Description of the function.
        parameters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: JSON Schema for the function's input parameters.
      additionalProperties: true
      type: object
      required:
      - name
      title: GoogleFunctionDeclaration
      description: A function declaration for tool calling.
    GoogleFunctionResponseContent:
      properties:
        type:
          type: string
          enum:
          - function_response
          - function_result
          title: Type
          default: function_result
        call_id:
          anyOf:
          - type: string
          - type: 'null'
          description: ID of the function call this responds to.
        id:
          anyOf:
          - type: string
          - type: 'null'
          description: Deprecated alias for call_id.
        name:
          type: string
          title: Name
          description: Name of the function that was called.
        result:
          additionalProperties: true
          type: object
          title: Result
          description: The function's return value.
      additionalProperties: true
      type: object
      required:
      - name
      title: GoogleFunctionResponseContent
      description: |-
        A function response/result content item (user providing tool results).

        Accepts both 'function_response' (generateContent API) and 'function_result'
        (Interactions API) type values, and both 'response' and 'result' field names.
    GoogleGenerationConfig:
      properties:
        temperature:
          anyOf:
          - type: number
            maximum: 2.0
            minimum: 0.0
          - type: 'null'
          description: Sampling temperature.
        top_k:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: Top-k sampling parameter.
        top_p:
          anyOf:
          - type: number
            maximum: 1.0
            minimum: 0.0
          - type: 'null'
          description: Nucleus sampling parameter.
        max_output_tokens:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: Maximum number of tokens to generate.
      type: object
      title: GoogleGenerationConfig
      description: Generation parameters for the Interactions API.
    GoogleInputTurn:
      properties:
        role:
          type: string
          enum:
          - user
          - model
          title: Role
        content:
          anyOf:
          - type: string
          - items:
              anyOf:
              - $ref: '#/components/schemas/GoogleTextContent'
                title: GoogleTextContent
              - $ref: '#/components/schemas/GoogleFunctionCallContent'
                title: GoogleFunctionCallContent
              - $ref: '#/components/schemas/GoogleFunctionResponseContent'
                title: GoogleFunctionResponseContent
              title: GoogleTextContent | GoogleFunctionCallContent | GoogleFunctionResponseContent
            type: array
            title: list[GoogleTextContent | GoogleFunctionCallContent | GoogleFunctionResponseContent]
          title: string | list[GoogleTextContent | GoogleFunctionCallContent | GoogleFunctionResponseContent]
          description: Content items for this turn. Can be a plain string or a list of content items.
      type: object
      required:
      - role
      - content
      title: GoogleInputTurn
      description: A conversation turn in the input.
    GoogleInteractionResponse:
      properties:
        id:
          type: string
          title: Id
          description: Unique interaction ID.
        created:
          anyOf:
          - type: string
          - type: 'null'
          description: Creation timestamp.
        status:
          type: string
          title: Status
          enum:
          - completed
        updated:
          anyOf:
          - type: string
          - type: 'null'
          description: Last update timestamp.
        model:
          type: string
          title: Model
          description: Model used for generation.
        outputs:
          items:
            oneOf:
            - $ref: '#/components/schemas/GoogleTextOutput'
              title: GoogleTextOutput
            - $ref: '#/components/schemas/GoogleFunctionCallOutput'
              title: GoogleFunctionCallOutput
            - $ref: '#/components/schemas/GoogleThoughtOutput'
              title: GoogleThoughtOutput
            discriminator:
              propertyName: type
              mapping:
                function_call: '#/components/schemas/GoogleFunctionCallOutput'
                text: '#/components/schemas/GoogleTextOutput'
                thought: '#/components/schemas/GoogleThoughtOutput'
            title: GoogleTextOutput | GoogleFunctionCallOutput | GoogleThoughtOutput
          type: array
          title: Outputs
          description: Response output items.
        role:
          type: string
          title: Role
          enum:
          - model
        usage:
          $ref: '#/components/schemas/GoogleUsage'
        object:
          type: string
          title: Object
          enum:
          - interaction
      type: object
      required:
      - id
      - model
      - outputs
      title: GoogleInteractionResponse
      description: Response from POST /v1alpha/interactions (non-streaming).
    GoogleTextContent:
      properties:
        type:
          type: string
          title: Type
          enum:
          - text
        text:
          type: string
          title: Text
      type: object
      required:
      - text
      title: GoogleTextContent
      description: A text content item.
    GoogleTextOutput:
      properties:
        type:
          type: string
          title: Type
          enum:
          - text
        text:
          type: string
          title: Text
      type: object
      required:
      - text
      title: GoogleTextOutput
      description: A text output item.
    GoogleThoughtOutput:
      properties:
        type:
          type: string
          title: Type
          enum:
          - thought
        signature:
          anyOf:
          - type: string
          - type: 'null'
          description: Signature for the thought block.
      additionalProperties: true
      type: object
      title: GoogleThoughtOutput
      description: A thought/reasoning output item (model's internal reasoning).
    GoogleTool:
      properties:
        type:
          type: string
          title: Type
          description: Tool type.
          default: function
        function_declarations:
          items:
            $ref: '#/components/schemas/GoogleFunctionDeclaration'
          type: array
          title: Function Declarations
          description: List of function declarations.
      additionalProperties: true
      type: object
      required:
      - function_declarations
      title: GoogleTool
      description: A tool containing function declarations.
    GoogleUsage:
      properties:
        total_input_tokens:
          type: integer
          title: Total Input Tokens
          default: 0
        total_output_tokens:
          type: integer
          title: Total Output Tokens
          default: 0
        total_tokens:
          type: integer
          title: Total Tokens
          default: 0
      additionalProperties: true
      type: object
      title: GoogleUsage
      description: Token usage statistics.
    HealthStatus:
      type: string
      enum:
      - OK
      - Error
      - Not Implemented
      title: HealthStatus
      description: Health check status values for provider readiness.
    ImageContentItem-Input:
      properties:
        type:
          type: string
          title: Type
          enum:
          - image
        image:
          $ref: '#/components/schemas/_URLOrData'
      type: object
      required:
      - image
      title: ImageContentItem
      description: A image content item
    ImageContentItem-Output:
      properties:
        type:
          type: string
          title: Type
          enum:
          - image
        image:
          $ref: '#/components/schemas/_URLOrData'
      type: object
      required:
      - image
      title: ImageContentItem
      description: A image content item
    InputTokensDetails:
      properties:
        cached_tokens:
          type: integer
          title: Cached Tokens
      additionalProperties: true
      type: object
      required:
      - cached_tokens
      title: InputTokensDetails
      description: A detailed breakdown of the input tokens.
    ListConnectorsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/Connector'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListConnectorsResponse
      description: Response containing a list of configured connectors
    ListToolsResponse:
      properties:
        data:
          items:
            $ref: '#/components/schemas/ToolDef'
          type: array
          title: Data
      type: object
      required:
      - data
      title: ListToolsResponse
      description: Response containing a list of tools
    MCPListToolsTool:
      properties:
        input_schema:
          additionalProperties: true
          type: object
          title: Input Schema
        name:
          type: string
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - input_schema
      - name
      title: MCPListToolsTool
      description: Tool definition returned by MCP list tools operation.
    OpenAIAssistantMessageParam-Input:
      properties:
        role:
          type: string
          title: Role
          description: Must be 'assistant' to identify this as the model's response.
          enum:
          - assistant
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam]
          - type: 'null'
          title: string | list[OpenAIChatCompletionContentPartTextParam]
          description: The content of the model's response.
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the assistant message participant.
        tool_calls:
          anyOf:
          - items:
              $ref: '#/components/schemas/ChatCompletionMessageToolCall'
            type: array
          - type: 'null'
          description: List of tool calls. Each tool call is an OpenAIChatCompletionToolCall object.
      additionalProperties: true
      type: object
      title: OpenAIAssistantMessageParam
      description: A message containing the model's (assistant) response in an OpenAI-compatible chat completion request.
    OpenAIAssistantMessageParam-Output:
      properties:
        role:
          type: string
          title: Role
          description: Must be 'assistant' to identify this as the model's response.
          enum:
          - assistant
        content:
          anyOf:
          - type: string
          - items:
              $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam]
          - type: 'null'
          title: string | list[OpenAIChatCompletionContentPartTextParam]
          description: The content of the model's response.
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the assistant message participant.
        tool_calls:
          anyOf:
          - items:
              $ref: '#/components/schemas/ChatCompletionMessageToolCall'
            type: array
          - type: 'null'
          description: List of tool calls. Each tool call is an OpenAIChatCompletionToolCall object.
      additionalProperties: true
      type: object
      title: OpenAIAssistantMessageParam
      description: A message containing the model's (assistant) response in an OpenAI-compatible chat completion request.
    OpenAIAttachFileRequest:
      properties:
        file_id:
          type: string
          title: File Id
          description: The ID of the file to attach.
        attributes:
          anyOf:
          - additionalProperties:
              anyOf:
              - type: string
                maxLength: 512
              - type: number
              - type: boolean
              title: string | number | boolean
            propertyNames:
              type: string
              maxLength: 64
            type: object
            maxProperties: 16
            description: Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers.
            x-oaiTypeLabel: map
          - type: 'null'
          description: Attributes to associate with the file.
        chunking_strategy:
          anyOf:
          - oneOf:
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              title: VectorStoreChunkingStrategyAuto
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
              title: VectorStoreChunkingStrategyStatic
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyContextual'
              title: VectorStoreChunkingStrategyContextual
            discriminator:
              propertyName: type
              mapping:
                auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
                contextual: '#/components/schemas/VectorStoreChunkingStrategyContextual'
                static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
            title: VectorStoreChunkingStrategyAuto | VectorStoreChunkingStrategyStatic | VectorStoreChunkingStrategyContextual
          - type: 'null'
          title: Chunking Strategy
          description: Strategy for chunking the file content.
      type: object
      required:
      - file_id
      title: OpenAIAttachFileRequest
      description: Request body for attaching a file to a vector store.
    OpenAIChatCompletionCustomToolCallFunction:
      properties:
        name:
          type: string
          title: Name
          description: The name of the custom tool to call.
        input:
          type: string
          title: Input
          description: The input for the custom tool call generated by the model.
      type: object
      required:
      - name
      - input
      title: OpenAIChatCompletionCustomToolCallFunction
      description: Custom tool call details for OpenAI-compatible tool calls.
    OpenAIChatCompletionResponseMessage:
      properties:
        role:
          type: string
          title: Role
          description: The role of the message author, always 'assistant' in responses.
          enum:
          - assistant
        content:
          anyOf:
          - type: string
          - type: 'null'
          description: The content of the message.
        tool_calls:
          items:
            anyOf:
            - $ref: '#/components/schemas/ChatCompletionMessageToolCall'
              title: ChatCompletionMessageToolCall
            - $ref: '#/components/schemas/ChatCompletionMessageCustomToolCall'
              title: ChatCompletionMessageCustomToolCall
            discriminator:
              propertyName: type
            title: ChatCompletionMessageToolCall | ChatCompletionMessageCustomToolCall
          type: array
          title: Tool Calls
          description: The tool calls generated by the model.
        refusal:
          anyOf:
          - type: string
          - type: 'null'
          description: The refusal message generated by the model.
        function_call:
          properties:
            name:
              type: string
              title: Name
              description: Name of the function to call.
            arguments:
              type: string
              title: Arguments
              description: Arguments to pass to the function as a JSON string.
          type: object
          required:
          - name
          - arguments
          description: 'Deprecated: the name and arguments of a function that should be called.'
        annotations:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Annotations
          description: Annotations for the message, when applicable.
        audio:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Audio response data when using audio output modality.
      type: object
      title: OpenAIChatCompletionResponseMessage
      description: An assistant message returned in a chat completion response.
    OpenAIChatCompletionUsageCompletionTokensDetails:
      properties:
        reasoning_tokens:
          type: integer
          minimum: 0.0
          title: Reasoning Tokens
          description: Number of tokens used for reasoning (o1/o3 models).
          default: 0
      type: object
      title: OpenAIChatCompletionUsageCompletionTokensDetails
      description: Token details for output tokens in OpenAI chat completion usage.
    OpenAIChatCompletionUsagePromptTokensDetails:
      properties:
        cached_tokens:
          type: integer
          minimum: 0.0
          title: Cached Tokens
          description: Number of tokens retrieved from cache.
          default: 0
      type: object
      title: OpenAIChatCompletionUsagePromptTokensDetails
      description: Token details for prompt tokens in OpenAI chat completion usage.
    OpenAICompactedResponse:
      properties:
        id:
          type: string
          title: Id
        created_at:
          type: integer
          title: Created At
        object:
          type: string
          title: Object
          enum:
          - response.compaction
          default: response.compaction
        output:
          items:
            $ref: '#/components/schemas/OpenAIResponseMessageOutputUnion'
          type: array
          title: Output
        usage:
          $ref: '#/components/schemas/OpenAIResponseUsage'
      type: object
      required:
      - id
      - created_at
      - output
      - usage
      title: OpenAICompactedResponse
      description: Response from compacting a conversation.
    OpenAIResponseCompaction:
      properties:
        type:
          type: string
          title: Type
          enum:
          - compaction
        encrypted_content:
          type: string
          title: Encrypted Content
        id:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - encrypted_content
      title: OpenAIResponseCompaction
      description: A compaction item that summarizes prior conversation context.
    OpenAIResponseIncompleteDetails:
      properties:
        reason:
          type: string
          title: Reason
      type: object
      required:
      - reason
      title: OpenAIResponseIncompleteDetails
      description: Details explaining why a response was incomplete.
    OpenAIResponseInputToolChoiceAllowedTools:
      properties:
        mode:
          type: string
          enum:
          - auto
          - required
          title: Mode
          default: auto
        tools:
          items:
            additionalProperties:
              type: string
            type: object
          type: array
          title: Tools
        type:
          type: string
          title: Type
          enum:
          - allowed_tools
      type: object
      required:
      - tools
      title: OpenAIResponseInputToolChoiceAllowedTools
      description: Constrains the tools available to the model to a pre-defined set.
    OpenAIResponseInputToolChoiceCustomTool:
      properties:
        type:
          type: string
          title: Type
          enum:
          - custom
        name:
          type: string
          title: Name
      type: object
      required:
      - name
      title: OpenAIResponseInputToolChoiceCustomTool
      description: Forces the model to call a custom tool.
    OpenAIResponseInputToolChoiceFileSearch:
      properties:
        type:
          type: string
          title: Type
          enum:
          - file_search
      type: object
      title: OpenAIResponseInputToolChoiceFileSearch
      description: Indicates that the model should use file search to generate a response.
    OpenAIResponseInputToolChoiceFunctionTool:
      properties:
        name:
          type: string
          title: Name
        type:
          type: string
          title: Type
          enum:
          - function
      type: object
      required:
      - name
      title: OpenAIResponseInputToolChoiceFunctionTool
      description: Forces the model to call a specific function.
    OpenAIResponseInputToolChoiceMCPTool:
      properties:
        server_label:
          type: string
          title: Server Label
        type:
          type: string
          title: Type
          enum:
          - mcp
        name:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - server_label
      title: OpenAIResponseInputToolChoiceMCPTool
      description: Forces the model to call a specific tool on a remote MCP server
    OpenAIResponseInputToolChoiceMode:
      type: string
      enum:
      - auto
      - required
      - none
      title: OpenAIResponseInputToolChoiceMode
      description: Enumeration of simple tool choice modes for response generation.
    OpenAIResponseInputToolChoiceWebSearch:
      properties:
        type:
          anyOf:
          - type: string
            enum:
            - web_search
          - type: string
            enum:
            - web_search_preview
          - type: string
            enum:
            - web_search_preview_2025_03_11
          - type: string
            enum:
            - web_search_2025_08_26
          title: string
          default: web_search
      type: object
      title: OpenAIResponseInputToolChoiceWebSearch
      description: Indicates that the model should use web search to generate a response
    OpenAIResponseMessage-Input:
      properties:
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
                title: OpenAIResponseInputMessageContentText
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                title: OpenAIResponseInputMessageContentImage
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                title: OpenAIResponseInputMessageContentFile
              discriminator:
                propertyName: type
                mapping:
                  input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                  input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                  input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
              title: OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile
            type: array
            title: list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile]
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText-Input'
                title: OpenAIResponseOutputMessageContentOutputText-Input
              - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
                title: OpenAIResponseContentPartRefusal
              discriminator:
                propertyName: type
                mapping:
                  output_text: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText-Input'
                  refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
              title: OpenAIResponseOutputMessageContentOutputText-Input | OpenAIResponseContentPartRefusal
            type: array
            title: list[OpenAIResponseOutputMessageContentOutputText-Input | OpenAIResponseContentPartRefusal]
          title: string | list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile] | list[OpenAIResponseOutputMessageContentOutputText-Input | OpenAIResponseContentPartRefusal]
        role:
          anyOf:
          - type: string
            enum:
            - system
          - type: string
            enum:
            - developer
          - type: string
            enum:
            - user
          - type: string
            enum:
            - assistant
          title: string
        type:
          type: string
          title: Type
          enum:
          - message
        id:
          anyOf:
          - type: string
          - type: 'null'
        status:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - content
      - role
      title: OpenAIResponseMessage
      description: |-
        Corresponds to the various Message types in the Responses API.
        They are all under one type because the Responses API gives them all
        the same "type" value, and there is no way to tell them apart in certain
        scenarios.
    OpenAIResponseMessage-Output:
      properties:
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentText'
                title: OpenAIResponseInputMessageContentText
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                title: OpenAIResponseInputMessageContentImage
              - $ref: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                title: OpenAIResponseInputMessageContentFile
              discriminator:
                propertyName: type
                mapping:
                  input_file: '#/components/schemas/OpenAIResponseInputMessageContentFile'
                  input_image: '#/components/schemas/OpenAIResponseInputMessageContentImage'
                  input_text: '#/components/schemas/OpenAIResponseInputMessageContentText'
              title: OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile
            type: array
            title: list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile]
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText-Output'
                title: OpenAIResponseOutputMessageContentOutputText-Output
              - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
                title: OpenAIResponseContentPartRefusal
              discriminator:
                propertyName: type
                mapping:
                  output_text: '#/components/schemas/OpenAIResponseOutputMessageContentOutputText-Output'
                  refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
              title: OpenAIResponseOutputMessageContentOutputText-Output | OpenAIResponseContentPartRefusal
            type: array
            title: list[OpenAIResponseOutputMessageContentOutputText-Output | OpenAIResponseContentPartRefusal]
          title: string | list[OpenAIResponseInputMessageContentText | OpenAIResponseInputMessageContentImage | OpenAIResponseInputMessageContentFile] | list[OpenAIResponseOutputMessageContentOutputText-Output | OpenAIResponseContentPartRefusal]
        role:
          anyOf:
          - type: string
            enum:
            - system
          - type: string
            enum:
            - developer
          - type: string
            enum:
            - user
          - type: string
            enum:
            - assistant
          title: string
        type:
          type: string
          title: Type
          enum:
          - message
        id:
          anyOf:
          - type: string
          - type: 'null'
        status:
          anyOf:
          - type: string
          - type: 'null'
      type: object
      required:
      - content
      - role
      title: OpenAIResponseMessage
      description: |-
        Corresponds to the various Message types in the Responses API.
        They are all under one type because the Responses API gives them all
        the same "type" value, and there is no way to tell them apart in certain
        scenarios.
    OpenAIResponseOutputMessageContentOutputText-Input:
      properties:
        text:
          type: string
          title: Text
        type:
          type: string
          title: Type
          enum:
          - output_text
        annotations:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
              title: OpenAIResponseAnnotationFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationCitation'
              title: OpenAIResponseAnnotationCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
              title: OpenAIResponseAnnotationContainerFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFilePath'
              title: OpenAIResponseAnnotationFilePath
            discriminator:
              propertyName: type
              mapping:
                container_file_citation: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
                file_citation: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
                file_path: '#/components/schemas/OpenAIResponseAnnotationFilePath'
                url_citation: '#/components/schemas/OpenAIResponseAnnotationCitation'
            title: OpenAIResponseAnnotationFileCitation | ... (4 variants)
          type: array
          title: Annotations
        logprobs:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITokenLogProb'
            type: array
          - type: 'null'
      type: object
      required:
      - text
      title: OpenAIResponseOutputMessageContentOutputText
      description: Text content within an output message of an OpenAI response.
    OpenAIResponseOutputMessageContentOutputText-Output:
      properties:
        text:
          type: string
          title: Text
        type:
          type: string
          title: Type
          enum:
          - output_text
        annotations:
          items:
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
              title: OpenAIResponseAnnotationFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationCitation'
              title: OpenAIResponseAnnotationCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
              title: OpenAIResponseAnnotationContainerFileCitation
            - $ref: '#/components/schemas/OpenAIResponseAnnotationFilePath'
              title: OpenAIResponseAnnotationFilePath
            discriminator:
              propertyName: type
              mapping:
                container_file_citation: '#/components/schemas/OpenAIResponseAnnotationContainerFileCitation'
                file_citation: '#/components/schemas/OpenAIResponseAnnotationFileCitation'
                file_path: '#/components/schemas/OpenAIResponseAnnotationFilePath'
                url_citation: '#/components/schemas/OpenAIResponseAnnotationCitation'
            title: OpenAIResponseAnnotationFileCitation | ... (4 variants)
          type: array
          title: Annotations
        logprobs:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAITokenLogProb'
            type: array
          - type: 'null'
      type: object
      required:
      - text
      title: OpenAIResponseOutputMessageContentOutputText
      description: Text content within an output message of an OpenAI response.
    OpenAIResponseOutputMessageFileSearchToolCallResults:
      properties:
        attributes:
          additionalProperties: true
          type: object
          title: Attributes
        file_id:
          type: string
          title: File Id
        filename:
          type: string
          title: Filename
        score:
          type: number
          title: Score
        text:
          type: string
          title: Text
      type: object
      required:
      - attributes
      - file_id
      - filename
      - score
      - text
      title: OpenAIResponseOutputMessageFileSearchToolCallResults
      description: Search results returned by the file search operation.
    OpenAIResponseOutputMessageReasoningContent:
      properties:
        text:
          type: string
          title: Text
          description: The reasoning text content from the model.
        type:
          type: string
          title: Type
          description: The type identifier, always 'reasoning_text'.
          enum:
          - reasoning_text
      type: object
      required:
      - text
      title: OpenAIResponseOutputMessageReasoningContent
      description: Reasoning text from the model.
    OpenAIResponseOutputMessageReasoningItem:
      properties:
        id:
          type: string
          title: Id
          description: Unique identifier for the reasoning output item.
        summary:
          items:
            $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningSummary'
          type: array
          title: Summary
          description: Summary of the reasoning output.
        type:
          type: string
          title: Type
          description: The type identifier, always 'reasoning'.
          enum:
          - reasoning
        content:
          anyOf:
          - items:
              $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningContent'
            type: array
          - type: 'null'
          description: The reasoning content from the model.
        status:
          anyOf:
          - type: string
            enum:
            - in_progress
            - completed
            - incomplete
          - type: 'null'
          description: The status of the reasoning output.
      type: object
      required:
      - id
      - summary
      title: OpenAIResponseOutputMessageReasoningItem
      description: Reasoning output from the model, representing the model's thinking process.
    OpenAIResponseOutputMessageReasoningSummary:
      properties:
        text:
          type: string
          title: Text
          description: The summary text of the reasoning output.
        type:
          type: string
          title: Type
          description: The type identifier, always 'summary_text'.
          enum:
          - summary_text
      type: object
      required:
      - text
      title: OpenAIResponseOutputMessageReasoningSummary
      description: A summary of reasoning output from the model.
    OpenAIResponseReasoning:
      properties:
        effort:
          anyOf:
          - type: string
            enum:
            - none
            - minimal
            - low
            - medium
            - high
            - xhigh
          - type: 'null'
        summary:
          anyOf:
          - type: string
            enum:
            - auto
            - concise
            - detailed
          - type: 'null'
          description: Summary mode for reasoning output. One of 'auto', 'concise', or 'detailed'.
      type: object
      title: OpenAIResponseReasoning
      description: |-
        Configuration for reasoning effort in OpenAI responses.

        Controls how much reasoning the model performs before generating a response.
    OpenAIResponseTextFormat:
      properties:
        type:
          anyOf:
          - type: string
            enum:
            - text
          - type: string
            enum:
            - json_schema
          - type: string
            enum:
            - json_object
          title: string
        name:
          anyOf:
          - type: string
          - type: 'null'
        schema:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
        description:
          anyOf:
          - type: string
          - type: 'null'
        strict:
          anyOf:
          - type: boolean
          - type: 'null'
      type: object
      title: OpenAIResponseTextFormat
      description: Configuration for Responses API text format.
    OpenAIResponseUsageInputTokensDetails:
      properties:
        cached_tokens:
          type: integer
          title: Cached Tokens
      type: object
      required:
      - cached_tokens
      title: OpenAIResponseUsageInputTokensDetails
      description: Token details for input tokens in OpenAI response usage.
    OpenAIResponseUsageOutputTokensDetails:
      properties:
        reasoning_tokens:
          type: integer
          title: Reasoning Tokens
      type: object
      required:
      - reasoning_tokens
      title: OpenAIResponseUsageOutputTokensDetails
      description: Token details for output tokens in OpenAI response usage.
    OpenAISearchVectorStoreRequest:
      properties:
        query:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
            title: list[string]
          title: string | list[string]
          description: The search query string or list of query strings.
        filters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Filters to apply to the search.
        max_num_results:
          type: integer
          maximum: 50.0
          minimum: 1.0
          title: Max Num Results
          description: Maximum number of results to return.
          default: 10
        ranking_options:
          anyOf:
          - $ref: '#/components/schemas/SearchRankingOptions'
            title: SearchRankingOptions
          - type: 'null'
          description: Options for ranking results.
          title: SearchRankingOptions
        rewrite_query:
          type: boolean
          title: Rewrite Query
          description: Whether to rewrite the query for better results.
          default: false
        search_mode:
          anyOf:
          - type: string
          - type: 'null'
          description: The search mode to use (e.g., 'vector', 'keyword').
          default: vector
      type: object
      required:
      - query
      title: OpenAISearchVectorStoreRequest
      description: Request body for searching a vector store.
    OpenAIUpdateVectorStoreFileRequest:
      properties:
        attributes:
          additionalProperties: true
          type: object
          title: Attributes
          description: The new attributes for the file.
      type: object
      required:
      - attributes
      title: OpenAIUpdateVectorStoreFileRequest
      description: Request body for updating a vector store file.
    OpenAIUpdateVectorStoreRequest:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The new name for the vector store.
        expires_after:
          anyOf:
          - $ref: '#/components/schemas/VectorStoreExpirationAfter'
            title: VectorStoreExpirationAfter
          - type: 'null'
          description: Expiration policy for the vector store.
          title: VectorStoreExpirationAfter
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Metadata to associate with the vector store.
      type: object
      title: OpenAIUpdateVectorStoreRequest
      description: Request body for updating a vector store.
    OpenAIUserMessageParam-Input:
      properties:
        role:
          type: string
          title: Role
          description: Must be 'user' to identify this as a user message.
          enum:
          - user
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
                title: OpenAIChatCompletionContentPartTextParam
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                title: OpenAIChatCompletionContentPartImageParam
              - $ref: '#/components/schemas/OpenAIFile'
                title: OpenAIFile
              discriminator:
                propertyName: type
                mapping:
                  file: '#/components/schemas/OpenAIFile'
                  image_url: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                  text: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
              title: OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile]
          title: string | list[OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile]
          description: The content of the message, which can include text and other media.
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the user message participant.
      type: object
      required:
      - content
      title: OpenAIUserMessageParam
      description: A message from the user in an OpenAI-compatible chat completion request.
    OpenAIUserMessageParam-Output:
      properties:
        role:
          type: string
          title: Role
          description: Must be 'user' to identify this as a user message.
          enum:
          - user
        content:
          anyOf:
          - type: string
          - items:
              oneOf:
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
                title: OpenAIChatCompletionContentPartTextParam
              - $ref: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                title: OpenAIChatCompletionContentPartImageParam
              - $ref: '#/components/schemas/OpenAIFile'
                title: OpenAIFile
              discriminator:
                propertyName: type
                mapping:
                  file: '#/components/schemas/OpenAIFile'
                  image_url: '#/components/schemas/OpenAIChatCompletionContentPartImageParam'
                  text: '#/components/schemas/OpenAIChatCompletionContentPartTextParam'
              title: OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile
            type: array
            title: list[OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile]
          title: string | list[OpenAIChatCompletionContentPartTextParam | OpenAIChatCompletionContentPartImageParam | OpenAIFile]
          description: The content of the message, which can include text and other media.
        name:
          anyOf:
          - type: string
          - type: 'null'
          description: The name of the user message participant.
      type: object
      required:
      - content
      title: OpenAIUserMessageParam
      description: A message from the user in an OpenAI-compatible chat completion request.
    OutputTokensDetails:
      properties:
        reasoning_tokens:
          type: integer
          title: Reasoning Tokens
      additionalProperties: true
      type: object
      required:
      - reasoning_tokens
      title: OutputTokensDetails
      description: A detailed breakdown of the output tokens.
    ProcessFileResponse:
      properties:
        chunks:
          items:
            $ref: '#/components/schemas/Chunk'
          type: array
          title: Chunks
          description: Processed chunks from the file. Always returns at least one chunk.
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Processing-run metadata such as processor name/version, processing_time_ms, page_count, extraction_method (e.g. docling/pypdf/ocr), confidence scores, plus provider-specific fields.
      type: object
      required:
      - chunks
      - metadata
      title: ProcessFileResponse
      description: |-
        Response model for file processing operation.

        Returns a list of chunks ready for storage in vector databases.
        Each chunk contains the content and metadata.
    SearchRankingOptions:
      properties:
        ranker:
          anyOf:
          - type: string
          - type: 'null'
        score_threshold:
          anyOf:
          - type: number
          - type: 'null'
          default: 0.0
        alpha:
          anyOf:
          - type: number
            maximum: 1.0
            minimum: 0.0
          - type: 'null'
          description: Weight factor for weighted ranker
        impact_factor:
          anyOf:
          - type: number
            minimum: 0.0
          - type: 'null'
          description: Impact factor for RRF algorithm
        weights:
          anyOf:
          - additionalProperties:
              type: number
            type: object
          - type: 'null'
          description: "Weights for combining vector, keyword, and neural scores. Keys: 'vector', 'keyword', 'neural'"
        model:
          anyOf:
          - type: string
          - type: 'null'
          description: Model identifier for neural reranker
      type: object
      title: SearchRankingOptions
      description: |-
        Options for ranking and filtering search results.

        This class configures how search results are ranked and filtered. You can use algorithm-based
        rerankers (weighted, RRF) or neural rerankers. Defaults from VectorStoresConfig are
        used when parameters are not provided.

        Examples:
            # Weighted ranker with custom alpha
            SearchRankingOptions(ranker="weighted", alpha=0.7)

            # RRF ranker with custom impact factor
            SearchRankingOptions(ranker="rrf", impact_factor=50.0)

            # Use config defaults (just specify ranker type)
            SearchRankingOptions(ranker="weighted")  # Uses alpha from VectorStoresConfig

            # Score threshold filtering
            SearchRankingOptions(ranker="weighted", score_threshold=0.5)
    ServiceTier:
      type: string
      enum:
      - auto
      - default
      - flex
      - priority
      title: ServiceTier
      description: The service tier for the request.
    SetDefaultVersionBodyRequest:
      properties:
        version:
          type: integer
          title: Version
          description: The version to set as default.
      type: object
      required:
      - version
      title: SetDefaultVersionBodyRequest
      description: Request body model for setting the default version of a prompt.
    UpdatePromptBodyRequest:
      properties:
        prompt:
          type: string
          title: Prompt
          description: The updated prompt text content.
        version:
          type: integer
          title: Version
          description: The current version of the prompt being updated.
        variables:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: Updated list of variable names that can be used in the prompt template.
        set_as_default:
          type: boolean
          title: Set As Default
          description: Set the new version as the default (default=True).
          default: true
      type: object
      required:
      - prompt
      - version
      title: UpdatePromptBodyRequest
      description: Request body model for updating a prompt.
    VectorStoreChunkingStrategyContextual:
      properties:
        type:
          type: string
          title: Type
          description: Strategy type identifier.
          enum:
          - contextual
        contextual:
          $ref: '#/components/schemas/VectorStoreChunkingStrategyContextualConfig'
          description: Configuration for contextual chunking.
      type: object
      required:
      - contextual
      title: VectorStoreChunkingStrategyContextual
      description: Contextual chunking strategy that uses an LLM to situate chunks within the document.
    VectorStoreChunkingStrategyContextualConfig:
      properties:
        model_id:
          anyOf:
          - type: string
            minLength: 1
          - type: 'null'
          description: LLM model for generating context. Falls back to VectorStoresConfig.contextual_retrieval_params.model if not provided.
        context_prompt:
          type: string
          title: Context Prompt
          description: Prompt template for contextual retrieval. Uses WHOLE_DOCUMENT and CHUNK_CONTENT placeholders wrapped in double curly braces.
        max_chunk_size_tokens:
          type: integer
          maximum: 4096.0
          minimum: 100.0
          title: Max Chunk Size Tokens
          description: Maximum tokens per chunk. Suggested ~700 to allow room for prepended context.
          default: 700
        chunk_overlap_tokens:
          type: integer
          minimum: 0.0
          title: Chunk Overlap Tokens
          description: Tokens to overlap between adjacent chunks. Must be less than max_chunk_size_tokens.
          default: 400
        timeout_seconds:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: Timeout per LLM call in seconds. Falls back to config default if not provided.
        max_concurrency:
          anyOf:
          - type: integer
            minimum: 1.0
          - type: 'null'
          description: Maximum concurrent LLM calls. Falls back to config default if not provided.
      type: object
      title: VectorStoreChunkingStrategyContextualConfig
      description: Configuration for contextual chunking that uses an LLM to situate chunks within the document.
    VectorStoreExpirationAfter:
      properties:
        anchor:
          type: string
          title: Anchor
          description: Anchor timestamp after which the expiration policy applies.
          enum:
          - last_active_at
        days:
          type: integer
          maximum: 365.0
          minimum: 1.0
          title: Days
          description: The number of days after the anchor time that the vector store will expire.
      type: object
      required:
      - anchor
      - days
      title: VectorStoreExpirationAfter
      description: Expiration policy for a vector store.
    VectorStoreFileBatchFileEntry:
      properties:
        file_id:
          type: string
          title: File Id
        chunking_strategy:
          anyOf:
          - oneOf:
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              title: VectorStoreChunkingStrategyAuto
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
              title: VectorStoreChunkingStrategyStatic
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyContextual'
              title: VectorStoreChunkingStrategyContextual
            discriminator:
              propertyName: type
              mapping:
                auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
                contextual: '#/components/schemas/VectorStoreChunkingStrategyContextual'
                static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
            title: VectorStoreChunkingStrategyAuto | VectorStoreChunkingStrategyStatic | VectorStoreChunkingStrategyContextual
          - type: 'null'
          title: Chunking Strategy
        attributes:
          anyOf:
          - additionalProperties:
              anyOf:
              - type: string
                maxLength: 512
              - type: number
              - type: boolean
              title: string | number | boolean
            propertyNames:
              type: string
              maxLength: 64
            type: object
            maxProperties: 16
            description: Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters, booleans, or numbers.
            x-oaiTypeLabel: map
          - type: 'null'
      type: object
      required:
      - file_id
      title: VectorStoreFileBatchFileEntry
      description: A file entry for creating a vector store file batch with per-file options.
    _URLOrData:
      properties:
        url:
          anyOf:
          - $ref: '#/components/schemas/URL'
            title: URL
          - type: 'null'
          title: URL
        data:
          anyOf:
          - type: string
          - type: 'null'
          contentEncoding: base64
      type: object
      title: _URLOrData
      description: A URL or a base64 encoded string
    GreedySamplingStrategy:
      description: Greedy sampling strategy that selects the highest probability token at each step.
      properties:
        type:
          description: Must be 'greedy' to identify this sampling strategy.
          title: Type
          type: string
          enum:
          - greedy
      title: GreedySamplingStrategy
      type: object
    TopKSamplingStrategy:
      description: Top-k sampling strategy that restricts sampling to the k most likely tokens.
      properties:
        type:
          description: Must be 'top_k' to identify this sampling strategy.
          title: Type
          type: string
          enum:
          - top_k
        top_k:
          description: Number of top tokens to consider for sampling. Must be at least 1.
          minimum: 1
          title: Top K
          type: integer
      required:
      - top_k
      title: TopKSamplingStrategy
      type: object
    TopPSamplingStrategy:
      description: Top-p (nucleus) sampling strategy that samples from the smallest set of tokens with cumulative probability >= p.
      properties:
        type:
          description: Must be 'top_p' to identify this sampling strategy.
          title: Type
          type: string
          enum:
          - top_p
        temperature:
          description: Controls randomness in sampling. Higher values increase randomness.
          maximum: 2.0
          title: Temperature
          type: number
          minimum: 0.0
        top_p:
          default: 0.95
          description: Cumulative probability threshold for nucleus sampling.
          maximum: 1.0
          minimum: 0.0
          title: Top P
          type: number
      required:
      - temperature
      title: TopPSamplingStrategy
      type: object
    SamplingStrategy:
      discriminator:
        mapping:
          greedy: '#/components/schemas/GreedySamplingStrategy'
          top_k: '#/components/schemas/TopKSamplingStrategy'
          top_p: '#/components/schemas/TopPSamplingStrategy'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/GreedySamplingStrategy'
        title: GreedySamplingStrategy
      - $ref: '#/components/schemas/TopPSamplingStrategy'
        title: TopPSamplingStrategy
      - $ref: '#/components/schemas/TopKSamplingStrategy'
        title: TopKSamplingStrategy
      title: GreedySamplingStrategy | TopPSamplingStrategy | TopKSamplingStrategy
    GrammarResponseFormat:
      description: Configuration for grammar-guided response generation.
      properties:
        type:
          description: Must be 'grammar' to identify this format type.
          title: Type
          type: string
          enum:
          - grammar
        bnf:
          additionalProperties: true
          description: The BNF grammar specification the response should conform to.
          title: Bnf
          type: object
      required:
      - bnf
      title: GrammarResponseFormat
      type: object
    JsonSchemaResponseFormat:
      description: Configuration for JSON schema-guided response generation.
      properties:
        type:
          description: Must be 'json_schema' to identify this format type.
          title: Type
          type: string
          enum:
          - json_schema
        json_schema:
          additionalProperties: true
          description: The JSON schema the response should conform to.
          title: Json Schema
          type: object
      required:
      - json_schema
      title: JsonSchemaResponseFormat
      type: object
    ResponseFormat:
      discriminator:
        mapping:
          grammar: '#/components/schemas/GrammarResponseFormat'
          json_schema: '#/components/schemas/JsonSchemaResponseFormat'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/JsonSchemaResponseFormat'
        title: JsonSchemaResponseFormat
      - $ref: '#/components/schemas/GrammarResponseFormat'
        title: GrammarResponseFormat
      title: JsonSchemaResponseFormat | GrammarResponseFormat
    AllowedToolsConfig:
      description: Configuration specifying which tools are allowed and their selection mode.
      properties:
        tools:
          description: List of allowed tools.
          items:
            additionalProperties: true
            type: object
          title: Tools
          type: array
        mode:
          description: Mode for allowed tools.
          enum:
          - auto
          - required
          title: Mode
          type: string
      required:
      - tools
      - mode
      title: AllowedToolsConfig
      type: object
    CustomToolConfig:
      description: Custom tool configuration for OpenAI-compatible chat completion requests.
      properties:
        name:
          description: Name of the custom tool.
          title: Name
          type: string
      required:
      - name
      title: CustomToolConfig
      type: object
    FunctionToolConfig:
      description: Configuration for a function tool specifying the function name.
      properties:
        name:
          description: Name of the function.
          title: Name
          type: string
      required:
      - name
      title: FunctionToolConfig
      type: object
    OpenAIChatCompletionToolChoiceAllowedTools:
      description: Allowed tools response format for OpenAI-compatible chat completion requests.
      properties:
        type:
          description: Must be 'allowed_tools' to indicate allowed tools response format.
          title: Type
          type: string
          enum:
          - allowed_tools
        allowed_tools:
          $ref: '#/components/schemas/AllowedToolsConfig'
          description: Allowed tools configuration.
      required:
      - allowed_tools
      title: OpenAIChatCompletionToolChoiceAllowedTools
      type: object
    OpenAIChatCompletionToolChoiceCustomTool:
      description: Custom tool choice for OpenAI-compatible chat completion requests.
      properties:
        type:
          description: Must be 'custom' to indicate custom tool choice.
          title: Type
          type: string
          enum:
          - custom
        custom:
          $ref: '#/components/schemas/CustomToolConfig'
          description: Custom tool configuration.
      required:
      - custom
      title: OpenAIChatCompletionToolChoiceCustomTool
      type: object
    OpenAIChatCompletionToolChoiceFunctionTool:
      description: Function tool choice for OpenAI-compatible chat completion requests.
      properties:
        type:
          description: Must be 'function' to indicate function tool choice.
          title: Type
          type: string
          enum:
          - function
        function:
          $ref: '#/components/schemas/FunctionToolConfig'
          description: The function tool configuration.
      required:
      - function
      title: OpenAIChatCompletionToolChoiceFunctionTool
      type: object
    OpenAIChatCompletionToolChoice:
      discriminator:
        mapping:
          allowed_tools: '#/components/schemas/OpenAIChatCompletionToolChoiceAllowedTools'
          custom: '#/components/schemas/OpenAIChatCompletionToolChoiceCustomTool'
          function: '#/components/schemas/OpenAIChatCompletionToolChoiceFunctionTool'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIChatCompletionToolChoiceAllowedTools'
        title: OpenAIChatCompletionToolChoiceAllowedTools
      - $ref: '#/components/schemas/OpenAIChatCompletionToolChoiceFunctionTool'
        title: OpenAIChatCompletionToolChoiceFunctionTool
      - $ref: '#/components/schemas/OpenAIChatCompletionToolChoiceCustomTool'
        title: OpenAIChatCompletionToolChoiceCustomTool
      title: OpenAIChatCompletionToolChoiceAllowedTools | OpenAIChatCompletionToolChoiceFunctionTool | OpenAIChatCompletionToolChoiceCustomTool
    OpenAIFinishReason:
      enum:
      - stop
      - length
      - tool_calls
      - content_filter
      - function_call
      type: string
    VectorStoreStatus:
      enum:
      - expired
      - in_progress
      - completed
      type: string
    OpenAIResponseInputToolChoice:
      anyOf:
      - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceMode'
        title: OpenAIResponseInputToolChoiceMode
      - discriminator:
          mapping:
            allowed_tools: '#/components/schemas/OpenAIResponseInputToolChoiceAllowedTools'
            custom: '#/components/schemas/OpenAIResponseInputToolChoiceCustomTool'
            file_search: '#/components/schemas/OpenAIResponseInputToolChoiceFileSearch'
            function: '#/components/schemas/OpenAIResponseInputToolChoiceFunctionTool'
            mcp: '#/components/schemas/OpenAIResponseInputToolChoiceMCPTool'
            web_search: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
            web_search_2025_08_26: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
            web_search_preview: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
            web_search_preview_2025_03_11: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
          propertyName: type
        oneOf:
        - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceAllowedTools'
          title: OpenAIResponseInputToolChoiceAllowedTools
        - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceFileSearch'
          title: OpenAIResponseInputToolChoiceFileSearch
        - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceWebSearch'
          title: OpenAIResponseInputToolChoiceWebSearch
        - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceFunctionTool'
          title: OpenAIResponseInputToolChoiceFunctionTool
        - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceMCPTool'
          title: OpenAIResponseInputToolChoiceMCPTool
        - $ref: '#/components/schemas/OpenAIResponseInputToolChoiceCustomTool'
          title: OpenAIResponseInputToolChoiceCustomTool
        title: OpenAIResponseInputToolChoiceAllowedTools | ... (6 variants)
      title: OpenAIResponseInputToolChoiceMode
    OpenAIResponseContentPart:
      discriminator:
        mapping:
          output_text: '#/components/schemas/OpenAIResponseContentPartOutputText'
          reasoning_text: '#/components/schemas/OpenAIResponseContentPartReasoningText'
          refusal: '#/components/schemas/OpenAIResponseContentPartRefusal'
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseContentPartOutputText'
        title: OpenAIResponseContentPartOutputText
      - $ref: '#/components/schemas/OpenAIResponseContentPartRefusal'
        title: OpenAIResponseContentPartRefusal
      - $ref: '#/components/schemas/OpenAIResponseContentPartReasoningText'
        title: OpenAIResponseContentPartReasoningText
      title: OpenAIResponseContentPartOutputText | OpenAIResponseContentPartRefusal | OpenAIResponseContentPartReasoningText
    OpenAIResponseObjectStreamError:
      description: |-
        Standalone error event emitted during streaming when an error occurs.

        This is distinct from response.failed which is a response lifecycle event.
        The error event signals transport/infrastructure-level errors to the client.
      properties:
        code:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        message:
          title: Message
          type: string
        param:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        sequence_number:
          title: Sequence Number
          type: integer
        type:
          title: Type
          type: string
          enum:
          - error
      required:
      - message
      - sequence_number
      title: OpenAIResponseObjectStreamError
      type: object
    ListModelsResponse:
      description: Response containing a list of model objects.
      properties:
        data:
          description: List of model objects.
          items:
            $ref: '#/components/schemas/Model'
          title: Data
          type: array
      required:
      - data
      title: ListModelsResponse
      type: object
    GetModelRequest:
      description: Request model for getting a model by ID.
      properties:
        model_id:
          description: The ID of the model to get.
          title: Model Id
          type: string
      required:
      - model_id
      title: GetModelRequest
      type: object
    UnregisterModelRequest:
      description: Request model for unregistering a model.
      properties:
        model_id:
          description: The ID of the model to unregister.
          title: Model Id
          type: string
      required:
      - model_id
      title: UnregisterModelRequest
      type: object
    GetShieldRequest:
      description: Request model for getting a shield by identifier.
      properties:
        identifier:
          description: The identifier of the shield to get.
          title: Identifier
          type: string
      required:
      - identifier
      title: GetShieldRequest
      type: object
    UnregisterShieldRequest:
      description: Request model for unregistering a shield.
      properties:
        identifier:
          description: The identifier of the shield to unregister.
          title: Identifier
          type: string
      required:
      - identifier
      title: UnregisterShieldRequest
      type: object
    TextDelta:
      description: A text content delta for streaming responses.
      properties:
        type:
          title: Type
          type: string
          enum:
          - text
        text:
          title: Text
          type: string
      required:
      - text
      title: TextDelta
      type: object
    ImageDelta:
      description: An image content delta for streaming responses.
      properties:
        type:
          title: Type
          type: string
          enum:
          - image
        image:
          format: binary
          title: Image
          type: string
      required:
      - image
      title: ImageDelta
      type: object
    ToolGroupInput:
      description: Input data for registering a tool group.
      properties:
        toolgroup_id:
          description: The unique identifier for the tool group.
          title: Toolgroup Id
          type: string
        provider_id:
          description: The ID of the provider that serves this tool group.
          title: Provider Id
          type: string
        args:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Additional arguments to pass to the provider.
          nullable: true
        mcp_endpoint:
          anyOf:
          - $ref: '#/components/schemas/URL'
            title: URL
          - type: 'null'
          description: Model Context Protocol endpoint URL for remote tool groups.
          nullable: true
          title: URL
      required:
      - toolgroup_id
      - provider_id
      title: ToolGroupInput
      type: object
    ListToolsRequest:
      description: Request model for listing tools.
      properties:
        toolgroup_id:
          anyOf:
          - type: string
          - type: 'null'
          description: The ID of the tool group to filter tools by.
          nullable: true
      title: ListToolsRequest
      type: object
    Api:
      description: Enumeration of all available APIs in the OGX system.
      enum:
      - providers
      - inference
      - safety
      - responses
      - batches
      - vector_io
      - tool_runtime
      - models
      - shields
      - vector_stores
      - tool_groups
      - files
      - file_processors
      - prompts
      - conversations
      - connectors
      - messages
      - interactions
      - inspect
      - admin
      title: Api
      type: string
    ProviderSpec:
      description: Base specification for a OGX provider including its config and dependencies.
      properties:
        api:
          $ref: '#/components/schemas/Api'
        provider_type:
          title: Provider Type
          type: string
        config_class:
          description: Fully-qualified classname of the config for this provider
          title: Config Class
          type: string
        api_dependencies:
          description: Higher-level API surfaces may depend on other providers to provide their functionality
          items:
            $ref: '#/components/schemas/Api'
          title: Api Dependencies
          type: array
        optional_api_dependencies:
          items:
            $ref: '#/components/schemas/Api'
          title: Optional Api Dependencies
          type: array
        deprecation_warning:
          anyOf:
          - type: string
          - type: 'null'
          description: If this provider is deprecated, specify the warning message here
          nullable: true
        deprecation_error:
          anyOf:
          - type: string
          - type: 'null'
          description: If this provider is deprecated and does NOT work, specify the error message here
          nullable: true
        module:
          anyOf:
          - type: string
          - type: 'null'
          description: |2-

             Fully-qualified name of the module to import. The module is expected to have:

              - `get_adapter_impl(config, deps)`: returns the adapter implementation

              Example: `module: ramalama_stack`

          nullable: true
        pip_packages:
          description: The pip dependencies needed for this implementation
          items:
            type: string
          title: Pip Packages
          type: array
        provider_data_validator:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        is_external:
          default: false
          description: Notes whether this provider is an external provider.
          title: Is External
          type: boolean
        toolgroup_id:
          anyOf:
          - type: string
          - type: 'null'
          description: For tool_runtime providers, the built-in tool group ID this provider serves (e.g. 'builtin::websearch').
          nullable: true
        deps__:
          items:
            type: string
          title: Deps
          type: array
      required:
      - api
      - provider_type
      - config_class
      title: ProviderSpec
      type: object
    InlineProviderSpec:
      description: Provider specification for inline (built-in) providers with optional container support.
      properties:
        api:
          $ref: '#/components/schemas/Api'
        provider_type:
          title: Provider Type
          type: string
        config_class:
          description: Fully-qualified classname of the config for this provider
          title: Config Class
          type: string
        api_dependencies:
          description: Higher-level API surfaces may depend on other providers to provide their functionality
          items:
            $ref: '#/components/schemas/Api'
          title: Api Dependencies
          type: array
        optional_api_dependencies:
          items:
            $ref: '#/components/schemas/Api'
          title: Optional Api Dependencies
          type: array
        deprecation_warning:
          anyOf:
          - type: string
          - type: 'null'
          description: If this provider is deprecated, specify the warning message here
          nullable: true
        deprecation_error:
          anyOf:
          - type: string
          - type: 'null'
          description: If this provider is deprecated and does NOT work, specify the error message here
          nullable: true
        module:
          anyOf:
          - type: string
          - type: 'null'
          description: |2-

             Fully-qualified name of the module to import. The module is expected to have:

              - `get_adapter_impl(config, deps)`: returns the adapter implementation

              Example: `module: ramalama_stack`

          nullable: true
        pip_packages:
          description: The pip dependencies needed for this implementation
          items:
            type: string
          title: Pip Packages
          type: array
        provider_data_validator:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        is_external:
          default: false
          description: Notes whether this provider is an external provider.
          title: Is External
          type: boolean
        toolgroup_id:
          anyOf:
          - type: string
          - type: 'null'
          description: For tool_runtime providers, the built-in tool group ID this provider serves (e.g. 'builtin::websearch').
          nullable: true
        deps__:
          items:
            type: string
          title: Deps
          type: array
        container_image:
          anyOf:
          - type: string
          - type: 'null'
          description: |2

            The container image to use for this implementation. If one is provided, pip_packages will be ignored.
            If a provider depends on other providers, the dependencies MUST NOT specify a container image.
          nullable: true
        description:
          anyOf:
          - type: string
          - type: 'null'
          description: |2

            A description of the provider. This is used to display in the documentation.
          nullable: true
      required:
      - api
      - provider_type
      - config_class
      title: InlineProviderSpec
      type: object
    RemoteProviderSpec:
      description: Provider specification for remote providers accessed via an adapter.
      properties:
        api:
          $ref: '#/components/schemas/Api'
        provider_type:
          title: Provider Type
          type: string
        config_class:
          description: Fully-qualified classname of the config for this provider
          title: Config Class
          type: string
        api_dependencies:
          description: Higher-level API surfaces may depend on other providers to provide their functionality
          items:
            $ref: '#/components/schemas/Api'
          title: Api Dependencies
          type: array
        optional_api_dependencies:
          items:
            $ref: '#/components/schemas/Api'
          title: Optional Api Dependencies
          type: array
        deprecation_warning:
          anyOf:
          - type: string
          - type: 'null'
          description: If this provider is deprecated, specify the warning message here
          nullable: true
        deprecation_error:
          anyOf:
          - type: string
          - type: 'null'
          description: If this provider is deprecated and does NOT work, specify the error message here
          nullable: true
        module:
          anyOf:
          - type: string
          - type: 'null'
          description: |2-

             Fully-qualified name of the module to import. The module is expected to have:

              - `get_adapter_impl(config, deps)`: returns the adapter implementation

              Example: `module: ramalama_stack`

          nullable: true
        pip_packages:
          description: The pip dependencies needed for this implementation
          items:
            type: string
          title: Pip Packages
          type: array
        provider_data_validator:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        is_external:
          default: false
          description: Notes whether this provider is an external provider.
          title: Is External
          type: boolean
        toolgroup_id:
          anyOf:
          - type: string
          - type: 'null'
          description: For tool_runtime providers, the built-in tool group ID this provider serves (e.g. 'builtin::websearch').
          nullable: true
        deps__:
          items:
            type: string
          title: Deps
          type: array
        adapter_type:
          description: Unique identifier for this adapter
          title: Adapter Type
          type: string
        description:
          anyOf:
          - type: string
          - type: 'null'
          description: |2

            A description of the provider. This is used to display in the documentation.
          nullable: true
      required:
      - api
      - provider_type
      - config_class
      - adapter_type
      title: RemoteProviderSpec
      type: object
    ListRoutesRequest:
      description: Request to list API routes.
      properties:
        api_filter:
          anyOf:
          - enum:
            - v1
            - v1alpha
            - v1beta
            - deprecated
            type: string
          - type: 'null'
          description: Filter to control which routes are returned. Can be an API level ('v1', 'v1alpha', 'v1beta') to show non-deprecated routes at that level, or 'deprecated' to show deprecated routes across all levels. If not specified, returns all non-deprecated routes.
          nullable: true
      title: ListRoutesRequest
      type: object
    InspectProviderRequest:
      description: Request to inspect a specific provider.
      properties:
        provider_id:
          description: The ID of the provider to inspect.
          title: Provider Id
          type: string
      required:
      - provider_id
      title: InspectProviderRequest
      type: object
    PaginatedResponse:
      description: A generic paginated response that follows a simple format.
      properties:
        data:
          items:
            additionalProperties: true
            type: object
          title: Data
          type: array
        has_more:
          title: Has More
          type: boolean
        url:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
      required:
      - data
      - has_more
      title: PaginatedResponse
      type: object
    MetricInResponse:
      description: A metric value included in API responses.
      properties:
        metric:
          title: Metric
          type: string
        value:
          anyOf:
          - type: integer
          - type: number
          title: integer | number
        unit:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
      required:
      - metric
      - value
      title: MetricInResponse
      type: object
    SamplingParams:
      description: Sampling parameters for text generation.
      properties:
        strategy:
          description: The sampling strategy to use.
          discriminator:
            mapping:
              greedy: '#/components/schemas/GreedySamplingStrategy'
              top_k: '#/components/schemas/TopKSamplingStrategy'
              top_p: '#/components/schemas/TopPSamplingStrategy'
            propertyName: type
          oneOf:
          - $ref: '#/components/schemas/GreedySamplingStrategy'
            title: GreedySamplingStrategy
          - $ref: '#/components/schemas/TopPSamplingStrategy'
            title: TopPSamplingStrategy
          - $ref: '#/components/schemas/TopKSamplingStrategy'
            title: TopKSamplingStrategy
          title: GreedySamplingStrategy | TopPSamplingStrategy | TopKSamplingStrategy
        max_tokens:
          anyOf:
          - minimum: 1
            type: integer
          - type: 'null'
          description: The maximum number of tokens that can be generated in the completion. The token count of your prompt plus max_tokens cannot exceed the model's context length.
          nullable: true
        repetition_penalty:
          anyOf:
          - maximum: 2.0
            minimum: -2.0
            type: number
          - type: 'null'
          default: 1.0
          description: Number between -2.0 and 2.0. Positive values penalize new tokens based on whether they appear in the text so far.
        stop:
          anyOf:
          - items:
              type: string
            maxItems: 4
            type: array
          - type: 'null'
          description: Up to 4 sequences where the API will stop generating further tokens. The returned text will not contain the stop sequence.
          nullable: true
      title: SamplingParams
      type: object
    Fp8QuantizationConfig:
      description: Configuration for 8-bit floating point quantization.
      properties:
        type:
          description: Must be 'fp8_mixed' to identify this quantization type.
          title: Type
          type: string
          enum:
          - fp8_mixed
      title: Fp8QuantizationConfig
      type: object
    Bf16QuantizationConfig:
      description: Configuration for BFloat16 precision (typically no quantization).
      properties:
        type:
          description: Must be 'bf16' to identify this quantization type.
          title: Type
          type: string
          enum:
          - bf16
      title: Bf16QuantizationConfig
      type: object
    Int4QuantizationConfig:
      description: Configuration for 4-bit integer quantization.
      properties:
        type:
          description: Must be 'int4' to identify this quantization type.
          title: Type
          type: string
          enum:
          - int4_mixed
        scheme:
          anyOf:
          - type: string
          - type: 'null'
          default: int4_weight_int8_dynamic_activation
          description: Quantization scheme to use.
      title: Int4QuantizationConfig
      type: object
    UserMessage:
      description: A message from the user in a chat conversation.
      properties:
        role:
          description: Must be 'user' to identify this as a user message.
          title: Role
          type: string
          enum:
          - user
        content:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/components/schemas/ImageContentItem'
                text: '#/components/schemas/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
              title: ImageContentItem
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            title: ImageContentItem | TextContentItem
          - items:
              discriminator:
                mapping:
                  image: '#/components/schemas/ImageContentItem'
                  text: '#/components/schemas/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
                title: ImageContentItem
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              title: ImageContentItem | TextContentItem
            type: array
            title: list[ImageContentItem | TextContentItem]
          description: The content of the message, which can include text and other media.
          title: string | list[ImageContentItem | TextContentItem]
        context:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/components/schemas/ImageContentItem'
                text: '#/components/schemas/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
              title: ImageContentItem
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            title: ImageContentItem | TextContentItem
          - items:
              discriminator:
                mapping:
                  image: '#/components/schemas/ImageContentItem'
                  text: '#/components/schemas/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
                title: ImageContentItem
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              title: ImageContentItem | TextContentItem
            type: array
            title: list[ImageContentItem | TextContentItem]
          - type: 'null'
          description: This field is used internally by OGX to pass RAG context. This field may be removed in the API in the future.
          title: string | list[ImageContentItem | TextContentItem]
          nullable: true
      required:
      - content
      title: UserMessage
      type: object
    SystemMessage:
      description: A system message providing instructions or context to the model.
      properties:
        role:
          description: Must be 'system' to identify this as a system message.
          title: Role
          type: string
          enum:
          - system
        content:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/components/schemas/ImageContentItem'
                text: '#/components/schemas/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
              title: ImageContentItem
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            title: ImageContentItem | TextContentItem
          - items:
              discriminator:
                mapping:
                  image: '#/components/schemas/ImageContentItem'
                  text: '#/components/schemas/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
                title: ImageContentItem
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              title: ImageContentItem | TextContentItem
            type: array
            title: list[ImageContentItem | TextContentItem]
          description: The content of the 'system prompt'. If multiple system messages are provided, they are concatenated. The underlying OGX code may also add other system messages.
          title: string | list[ImageContentItem | TextContentItem]
      required:
      - content
      title: SystemMessage
      type: object
    ToolResponseMessage:
      description: A message representing the result of a tool invocation.
      properties:
        role:
          description: Must be 'tool' to identify this as a tool response.
          title: Role
          type: string
          enum:
          - tool
        call_id:
          description: Unique identifier for the tool call this response is for.
          title: Call Id
          type: string
        content:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/components/schemas/ImageContentItem'
                text: '#/components/schemas/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
              title: ImageContentItem
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            title: ImageContentItem | TextContentItem
          - items:
              discriminator:
                mapping:
                  image: '#/components/schemas/ImageContentItem'
                  text: '#/components/schemas/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
                title: ImageContentItem
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              title: ImageContentItem | TextContentItem
            type: array
            title: list[ImageContentItem | TextContentItem]
          description: The response content from the tool.
          title: string | list[ImageContentItem | TextContentItem]
      required:
      - call_id
      - content
      title: ToolResponseMessage
      type: object
    TokenLogProbs:
      description: Log probabilities for generated tokens.
      properties:
        logprobs_by_token:
          additionalProperties:
            type: number
          description: Dictionary mapping tokens to their log probabilities.
          title: Logprobs By Token
          type: object
      required:
      - logprobs_by_token
      title: TokenLogProbs
      type: object
    EmbeddingsResponse:
      description: Response containing generated embeddings.
      properties:
        embeddings:
          description: List of embedding vectors, one per input content. Each embedding is a list of floats. The dimensionality is model-specific.
          items:
            items:
              type: number
            type: array
          title: Embeddings
          type: array
      required:
      - embeddings
      title: EmbeddingsResponse
      type: object
    OpenAICompletionLogprobs:
      description: The log probabilities for the tokens from an OpenAI-compatible completion response.
      properties:
        text_offset:
          anyOf:
          - items:
              type: integer
            type: array
          - type: 'null'
          description: The offset of the token in the text.
          nullable: true
        token_logprobs:
          anyOf:
          - items:
              type: number
            type: array
          - type: 'null'
          description: The log probabilities for the tokens.
          nullable: true
        tokens:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          description: The tokens.
          nullable: true
        top_logprobs:
          anyOf:
          - items:
              additionalProperties:
                type: number
              type: object
            type: array
          - type: 'null'
          description: The top log probabilities for the tokens.
          nullable: true
      title: OpenAICompletionLogprobs
      type: object
    ListChatCompletionsRequest:
      description: Request model for listing chat completions.
      properties:
        after:
          anyOf:
          - type: string
          - type: 'null'
          description: The ID of the last chat completion to return.
          nullable: true
        limit:
          anyOf:
          - minimum: 1
            type: integer
          - type: 'null'
          default: 20
          description: The maximum number of chat completions to return.
        model:
          anyOf:
          - type: string
          - type: 'null'
          description: The model to filter by.
          nullable: true
        order:
          anyOf:
          - $ref: '#/components/schemas/Order'
            title: Order
          - type: 'null'
          default: desc
          description: 'The order to sort the chat completions by: "asc" or "desc". Defaults to "desc".'
          title: Order
      title: ListChatCompletionsRequest
      type: object
    GetChatCompletionRequest:
      description: Request model for getting a chat completion.
      properties:
        completion_id:
          description: ID of the chat completion.
          title: Completion Id
          type: string
      required:
      - completion_id
      title: GetChatCompletionRequest
      type: object
    EmbeddedChunk:
      description: |-
        A chunk of content with its embedding vector for vector database operations.
        Inherits all fields from Chunk and adds embedding-related fields.
      properties:
        content:
          anyOf:
          - type: string
          - discriminator:
              mapping:
                image: '#/components/schemas/ImageContentItem'
                text: '#/components/schemas/TextContentItem'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/ImageContentItem'
              title: ImageContentItem
            - $ref: '#/components/schemas/TextContentItem'
              title: TextContentItem
            title: ImageContentItem | TextContentItem
          - items:
              discriminator:
                mapping:
                  image: '#/components/schemas/ImageContentItem'
                  text: '#/components/schemas/TextContentItem'
                propertyName: type
              oneOf:
              - $ref: '#/components/schemas/ImageContentItem'
                title: ImageContentItem
              - $ref: '#/components/schemas/TextContentItem'
                title: TextContentItem
              title: ImageContentItem | TextContentItem
            type: array
            title: list[ImageContentItem | TextContentItem]
          title: string | list[ImageContentItem | TextContentItem]
        chunk_id:
          title: Chunk Id
          type: string
        metadata:
          additionalProperties: true
          title: Metadata
          type: object
        chunk_metadata:
          $ref: '#/components/schemas/ChunkMetadata'
        embedding:
          items:
            type: number
          title: Embedding
          type: array
        embedding_model:
          title: Embedding Model
          type: string
        embedding_dimension:
          title: Embedding Dimension
          type: integer
      required:
      - content
      - chunk_id
      - chunk_metadata
      - embedding
      - embedding_model
      - embedding_dimension
      title: EmbeddedChunk
      type: object
    VectorStoreCreateRequest:
      description: Request to create a vector store.
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        description:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        file_ids:
          items:
            type: string
          title: File Ids
          type: array
        expires_after:
          anyOf:
          - $ref: '#/components/schemas/VectorStoreExpirationAfter'
            title: VectorStoreExpirationAfter
          - type: 'null'
          nullable: true
          title: VectorStoreExpirationAfter
        chunking_strategy:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          nullable: true
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          nullable: true
      title: VectorStoreCreateRequest
      type: object
    VectorStoreModifyRequest:
      description: Request to modify a vector store.
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          nullable: true
        expires_after:
          anyOf:
          - $ref: '#/components/schemas/VectorStoreExpirationAfter'
            title: VectorStoreExpirationAfter
          - type: 'null'
          nullable: true
          title: VectorStoreExpirationAfter
        metadata:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          nullable: true
      title: VectorStoreModifyRequest
      type: object
    VectorStoreSearchRequest:
      description: Request to search a vector store.
      properties:
        query:
          anyOf:
          - type: string
          - items:
              type: string
            type: array
            title: list[string]
          title: string | list[string]
        filters:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          nullable: true
        max_num_results:
          default: 10
          maximum: 50
          minimum: 1
          title: Max Num Results
          type: integer
        ranking_options:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          nullable: true
        rewrite_query:
          default: false
          title: Rewrite Query
          type: boolean
      required:
      - query
      title: VectorStoreSearchRequest
      type: object
    ChunkForDeletion:
      description: Information needed to delete a chunk from a vector store.
      properties:
        chunk_id:
          title: Chunk Id
          type: string
        document_id:
          title: Document Id
          type: string
      required:
      - chunk_id
      - document_id
      title: ChunkForDeletion
      type: object
    DeleteChunksRequest:
      description: Request body for deleting chunks from a vector store.
      properties:
        vector_store_id:
          description: The ID of the vector store to delete chunks from.
          title: Vector Store Id
          type: string
        chunks:
          description: The list of chunks to delete.
          items:
            $ref: '#/components/schemas/ChunkForDeletion'
          title: Chunks
          type: array
      required:
      - vector_store_id
      - chunks
      title: DeleteChunksRequest
      type: object
    ListBatchesRequest:
      description: Request model for listing batches.
      properties:
        after:
          anyOf:
          - type: string
          - type: 'null'
          description: Optional cursor for pagination. Returns batches after this ID.
          nullable: true
        limit:
          default: 20
          description: Maximum number of batches to return. Defaults to 20.
          title: Limit
          type: integer
      title: ListBatchesRequest
      type: object
    RetrieveBatchRequest:
      description: Request model for retrieving a batch.
      properties:
        batch_id:
          description: The ID of the batch to retrieve.
          title: Batch Id
          type: string
      required:
      - batch_id
      title: RetrieveBatchRequest
      type: object
    CancelBatchRequest:
      description: Request model for canceling a batch.
      properties:
        batch_id:
          description: The ID of the batch to cancel.
          title: Batch Id
          type: string
      required:
      - batch_id
      title: CancelBatchRequest
      type: object
    JobStatus:
      description: Status of a job execution.
      enum:
      - completed
      - in_progress
      - failed
      - scheduled
      - cancelled
      title: JobStatus
      type: string
    Job:
      description: A job execution instance with status tracking.
      properties:
        job_id:
          title: Job Id
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
      required:
      - job_id
      - status
      title: Job
      type: object
    DialogType:
      description: Parameter type for dialog data with semantic output labels.
      properties:
        type:
          title: Type
          type: string
          enum:
          - dialog
      title: DialogType
      type: object
    ConnectorInput:
      description: Input for creating a connector
      properties:
        connector_type:
          $ref: '#/components/schemas/ConnectorType'
          default: mcp
        connector_id:
          description: Identifier for the connector
          title: Connector Id
          type: string
        url:
          description: URL of the connector
          title: Url
          type: string
        server_label:
          anyOf:
          - type: string
          - type: 'null'
          description: Label of the server
          nullable: true
      required:
      - connector_id
      - url
      title: ConnectorInput
      type: object
    GetConnectorRequest:
      description: Request model for getting a connector by ID.
      properties:
        connector_id:
          description: Identifier for the connector
          title: Connector Id
          type: string
      required:
      - connector_id
      title: GetConnectorRequest
      type: object
    ListConnectorToolsRequest:
      description: Request model for listing tools from a connector.
      properties:
        connector_id:
          description: Identifier for the connector
          title: Connector Id
          type: string
      required:
      - connector_id
      title: ListConnectorToolsRequest
      type: object
    GetConnectorToolRequest:
      description: Request model for getting a tool from a connector.
      properties:
        connector_id:
          description: Identifier for the connector
          title: Connector Id
          type: string
        tool_name:
          description: Name of the tool
          title: Tool Name
          type: string
      required:
      - connector_id
      - tool_name
      title: GetConnectorToolRequest
      type: object
    ConversationMessage:
      description: OpenAI-compatible message item for conversations.
      properties:
        id:
          description: unique identifier for this message
          title: Id
          type: string
        content:
          description: message content
          items:
            additionalProperties: true
            type: object
          title: Content
          type: array
        role:
          description: message role
          title: Role
          type: string
        status:
          description: message status
          title: Status
          type: string
        type:
          title: Type
          type: string
          enum:
          - message
        object:
          title: Object
          type: string
          enum:
          - message
      required:
      - id
      - content
      - role
      - status
      title: ConversationMessage
      type: object
    ConversationItemCreateRequest:
      description: Request body for creating conversation items.
      properties:
        items:
          description: Items to include in the conversation context. You may add up to 20 items at a time.
          items:
            discriminator:
              mapping:
                file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
                function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
                function_call_output: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
                mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
                mcp_approval_response: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
                mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
                mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
                message: '#/components/schemas/OpenAIResponseMessage'
                reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
                web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/OpenAIResponseMessage'
              title: OpenAIResponseMessage
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
              title: OpenAIResponseOutputMessageWebSearchToolCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
              title: OpenAIResponseOutputMessageFileSearchToolCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
              title: OpenAIResponseOutputMessageFunctionToolCall
            - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
              title: OpenAIResponseInputFunctionToolCallOutput
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
              title: OpenAIResponseMCPApprovalRequest
            - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
              title: OpenAIResponseMCPApprovalResponse
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
              title: OpenAIResponseOutputMessageMCPCall
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
              title: OpenAIResponseOutputMessageMCPListTools
            - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
              title: OpenAIResponseOutputMessageReasoningItem
            title: OpenAIResponseMessage | ... (10 variants)
          maxItems: 20
          title: Items
          type: array
      required:
      - items
      title: ConversationItemCreateRequest
      type: object
    GetConversationRequest:
      description: Request model for getting a conversation by ID.
      properties:
        conversation_id:
          description: The conversation identifier.
          title: Conversation Id
          type: string
      required:
      - conversation_id
      title: GetConversationRequest
      type: object
    DeleteConversationRequest:
      description: Request model for deleting a conversation.
      properties:
        conversation_id:
          description: The conversation identifier.
          title: Conversation Id
          type: string
      required:
      - conversation_id
      title: DeleteConversationRequest
      type: object
    RetrieveItemRequest:
      description: Request model for retrieving a conversation item.
      properties:
        conversation_id:
          description: The conversation identifier.
          title: Conversation Id
          type: string
        item_id:
          description: The item identifier.
          title: Item Id
          type: string
      required:
      - conversation_id
      - item_id
      title: RetrieveItemRequest
      type: object
    ListItemsRequest:
      description: Request model for listing items in a conversation.
      properties:
        conversation_id:
          description: The conversation identifier.
          title: Conversation Id
          type: string
        after:
          anyOf:
          - type: string
          - type: 'null'
          description: An item ID to list items after, used in pagination.
          nullable: true
        include:
          anyOf:
          - items:
              $ref: '#/components/schemas/ConversationItemInclude'
            type: array
          - type: 'null'
          description: Specify additional output data to include in the response.
          nullable: true
        limit:
          anyOf:
          - type: integer
          - type: 'null'
          description: A limit on the number of objects to be returned (1-100, default 20).
          nullable: true
        order:
          anyOf:
          - enum:
            - asc
            - desc
            type: string
          - type: 'null'
          description: The order to return items in (asc or desc, default desc).
          nullable: true
      required:
      - conversation_id
      title: ListItemsRequest
      type: object
    DeleteItemRequest:
      description: Request model for deleting a conversation item.
      properties:
        conversation_id:
          description: The conversation identifier.
          title: Conversation Id
          type: string
        item_id:
          description: The item identifier.
          title: Item Id
          type: string
      required:
      - conversation_id
      - item_id
      title: DeleteItemRequest
      type: object
    ProcessFileRequest:
      description: |-
        Request model for file processing operation.

        Wraps the serializable parameters for process_file. The UploadFile parameter
        is kept separate (not serializable), following the same pattern as
        UploadFileRequest in the Files API.
      properties:
        file_id:
          anyOf:
          - type: string
          - type: 'null'
          description: ID of file already uploaded to file storage. Mutually exclusive with file.
          nullable: true
        options:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          description: Optional processing options. Provider-specific parameters (e.g., OCR settings, output format).
          nullable: true
        chunking_strategy:
          anyOf:
          - discriminator:
              mapping:
                auto: '#/components/schemas/VectorStoreChunkingStrategyAuto'
                contextual: '#/components/schemas/VectorStoreChunkingStrategyContextual'
                static: '#/components/schemas/VectorStoreChunkingStrategyStatic'
              propertyName: type
            oneOf:
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyAuto'
              title: VectorStoreChunkingStrategyAuto
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyStatic'
              title: VectorStoreChunkingStrategyStatic
            - $ref: '#/components/schemas/VectorStoreChunkingStrategyContextual'
              title: VectorStoreChunkingStrategyContextual
            title: VectorStoreChunkingStrategyAuto | VectorStoreChunkingStrategyStatic | VectorStoreChunkingStrategyContextual
          - type: 'null'
          description: Optional chunking strategy for splitting content into chunks.
          title: Chunking Strategy
          nullable: true
      title: ProcessFileRequest
      type: object
    ComparisonFilter:
      description: A filter that compares a metadata field against a value.
      properties:
        type:
          enum:
          - eq
          - ne
          - gt
          - gte
          - lt
          - lte
          - in
          - nin
          title: Type
          type: string
        key:
          title: Key
          type: string
        value:
          title: Value
      required:
      - type
      - key
      - value
      title: ComparisonFilter
      type: object
    CompoundFilter:
      description: A filter that combines multiple filters with a logical operator.
      properties:
        type:
          enum:
          - and
          - or
          title: Type
          type: string
        filters:
          items: {}
          title: Filters
          type: array
      required:
      - type
      - filters
      title: CompoundFilter
      type: object
    ListFilesRequest:
      description: Request model for listing files.
      properties:
        after:
          anyOf:
          - type: string
          - type: 'null'
          description: A cursor for pagination. Returns files after this ID.
          nullable: true
        limit:
          anyOf:
          - type: integer
          - type: 'null'
          default: 10000
          description: Maximum number of files to return (1-10,000).
        order:
          anyOf:
          - $ref: '#/components/schemas/Order'
            title: Order
          - type: 'null'
          default: desc
          description: Sort order by created_at timestamp ('asc' or 'desc').
          title: Order
        purpose:
          anyOf:
          - $ref: '#/components/schemas/OpenAIFilePurpose'
            title: OpenAIFilePurpose
          - type: 'null'
          description: Filter files by purpose.
          nullable: true
          title: OpenAIFilePurpose
      title: ListFilesRequest
      type: object
    RetrieveFileRequest:
      description: Request model for retrieving a file.
      properties:
        file_id:
          description: The ID of the file to retrieve.
          title: File Id
          type: string
      required:
      - file_id
      title: RetrieveFileRequest
      type: object
    DeleteFileRequest:
      description: Request model for deleting a file.
      properties:
        file_id:
          description: The ID of the file to delete.
          title: File Id
          type: string
      required:
      - file_id
      title: DeleteFileRequest
      type: object
    RetrieveFileContentRequest:
      description: Request model for retrieving file content.
      properties:
        file_id:
          description: The ID of the file to retrieve content from.
          title: File Id
          type: string
      required:
      - file_id
      title: RetrieveFileContentRequest
      type: object
    UploadFileRequest:
      description: Request model for uploading a file.
      properties:
        purpose:
          $ref: '#/components/schemas/OpenAIFilePurpose'
          description: The intended purpose of the uploaded file.
        expires_after:
          anyOf:
          - $ref: '#/components/schemas/ExpiresAfter'
            title: ExpiresAfter
          - type: 'null'
          description: Optional expiration settings for the file.
          nullable: true
          title: ExpiresAfter
      required:
      - purpose
      title: UploadFileRequest
      type: object
    ListPromptVersionsRequest:
      description: Request model for listing all versions of a prompt.
      properties:
        prompt_id:
          description: The identifier of the prompt to list versions for.
          title: Prompt Id
          type: string
      required:
      - prompt_id
      title: ListPromptVersionsRequest
      type: object
    GetPromptRequest:
      description: Request model for getting a prompt by ID and optional version.
      properties:
        prompt_id:
          description: The identifier of the prompt to get.
          title: Prompt Id
          type: string
        version:
          anyOf:
          - type: integer
          - type: 'null'
          description: The version of the prompt to get (defaults to latest).
          nullable: true
      required:
      - prompt_id
      title: GetPromptRequest
      type: object
    DeletePromptRequest:
      description: Request model for deleting a prompt.
      properties:
        prompt_id:
          description: The identifier of the prompt to delete.
          title: Prompt Id
          type: string
      required:
      - prompt_id
      title: DeletePromptRequest
      type: object
    OpenAIResponseMessageOutputUnion:
      anyOf:
      - oneOf:
        - $ref: '#/components/schemas/OpenAIResponseMessage-Output'
          title: OpenAIResponseMessage-Output
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
          title: OpenAIResponseOutputMessageWebSearchToolCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
          title: OpenAIResponseOutputMessageFileSearchToolCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
          title: OpenAIResponseOutputMessageFunctionToolCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
          title: OpenAIResponseOutputMessageMCPCall
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
          title: OpenAIResponseOutputMessageMCPListTools
        - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          title: OpenAIResponseMCPApprovalRequest
        - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
          title: OpenAIResponseOutputMessageReasoningItem
        discriminator:
          propertyName: type
          mapping:
            file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
            function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
            mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
            mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
            mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
            message: '#/components/schemas/OpenAIResponseMessage-Output'
            reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
            web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
        x-stainless-naming: OpenAIResponseMessageOutputOneOf
        title: OpenAIResponseMessage-Output | ... (8 variants)
      - $ref: '#/components/schemas/OpenAIResponseInputFunctionToolCallOutput'
        title: OpenAIResponseInputFunctionToolCallOutput
      - $ref: '#/components/schemas/OpenAIResponseMCPApprovalResponse'
        title: OpenAIResponseMCPApprovalResponse
      - $ref: '#/components/schemas/OpenAIResponseCompaction'
        title: OpenAIResponseCompaction
      title: OpenAIResponseInputFunctionToolCallOutput | OpenAIResponseMCPApprovalResponse | OpenAIResponseCompaction
      x-stainless-naming: OpenAIResponseMessageOutputUnion
    OpenAIResponseOutputItem:
      oneOf:
      - $ref: '#/components/schemas/OpenAIResponseMessage-Output'
        title: OpenAIResponseMessage-Output
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
        title: OpenAIResponseOutputMessageWebSearchToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
        title: OpenAIResponseOutputMessageFileSearchToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
        title: OpenAIResponseOutputMessageFunctionToolCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
        title: OpenAIResponseOutputMessageMCPCall
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
        title: OpenAIResponseOutputMessageMCPListTools
      - $ref: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
        title: OpenAIResponseMCPApprovalRequest
      - $ref: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
        title: OpenAIResponseOutputMessageReasoningItem
      discriminator:
        propertyName: type
        mapping:
          file_search_call: '#/components/schemas/OpenAIResponseOutputMessageFileSearchToolCall'
          function_call: '#/components/schemas/OpenAIResponseOutputMessageFunctionToolCall'
          mcp_approval_request: '#/components/schemas/OpenAIResponseMCPApprovalRequest'
          mcp_call: '#/components/schemas/OpenAIResponseOutputMessageMCPCall'
          mcp_list_tools: '#/components/schemas/OpenAIResponseOutputMessageMCPListTools'
          message: '#/components/schemas/OpenAIResponseMessage-Output'
          reasoning: '#/components/schemas/OpenAIResponseOutputMessageReasoningItem'
          web_search_call: '#/components/schemas/OpenAIResponseOutputMessageWebSearchToolCall'
      x-stainless-naming: OpenAIResponseOutputItem
      title: OpenAIResponseMessage-Output | ... (8 variants)
    ChatCompletionMessageToolCall:
      properties:
        id:
          type: string
          description: Unique identifier for the tool call.
        type:
          type: string
          description: Must be 'function' to identify this as a function call.
          enum:
          - function
        function:
          properties:
            name:
              type: string
              title: Name
              description: Name of the function to call.
            arguments:
              type: string
              title: Arguments
              description: Arguments to pass to the function as a JSON string.
          type: object
          required:
          - name
          - arguments
          description: Function call details.
      type: object
      description: Tool call specification for OpenAI-compatible chat completion responses.
      required:
      - id
      - type
      - function
    ChatCompletionMessageCustomToolCall:
      properties:
        id:
          type: string
          description: The ID of the tool call.
        type:
          type: string
          description: The type of the tool. Always 'custom'.
          enum:
          - custom
        custom:
          properties:
            name:
              type: string
              title: Name
              description: The name of the custom tool to call.
            input:
              type: string
              title: Input
              description: The input for the custom tool call generated by the model.
          type: object
          required:
          - name
          - input
          description: The custom tool that the model called.
      type: object
      required:
      - id
      - type
      - custom
      description: A call to a custom tool created by the model.
  responses:
    BadRequest400:
      description: The request was invalid or malformed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 400
            title: Bad Request
            detail: The request was invalid or malformed
    TooManyRequests429:
      description: The client has sent too many requests in a given amount of time
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 429
            title: Too Many Requests
            detail: You have exceeded the rate limit. Please try again later.
    InternalServerError500:
      description: The server encountered an unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            status: 500
            title: Internal Server Error
            detail: An unexpected error occurred
    DefaultError:
      description: An error occurred
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
tags:
- description: Administrative APIs for inspecting providers, routes, health, and version.
  name: Admin
  x-displayName: Admin
- description: APIs for creating and interacting with agentic systems.
  name: Agents
  x-displayName: Agents
- description: |-
    The API is designed to allow use of openai client libraries for seamless integration.

    This API provides the following extensions:
     - idempotent batch creation

    Note: This API is currently under active development and may undergo changes.
  name: Batches
  x-displayName: Batches
- description: External tool and service connectors.
  name: Connectors
  x-displayName: Connectors
- description: Protocol for conversation management operations.
  name: Conversations
  x-displayName: Conversations
- description: Document ingestion and chunking.
  name: File Processors
  x-displayName: File Processors
- description: This API is used to upload documents that can be used with other OGX APIs.
  name: Files
  x-displayName: Files
- description: |-
    OGX Inference API for generating completions, chat completions, and embeddings.

    This API provides the raw interface to the underlying models. Three kinds of models are supported:
    - LLM models: these models generate "raw" and "chat" (conversational) completions.
    - Embedding models: these models generate embeddings to be used for semantic search.
    - Rerank models: these models reorder the documents based on their relevance to a query.
  name: Inference
  x-displayName: Inference
- description: APIs for inspecting the OGX service, including health status, available API routes with methods and implementing providers.
  name: Inspect
  x-displayName: Inspect
- description: Google Interactions API compatibility layer.
  name: Interactions
  x-displayName: Interactions
- description: Anthropic Messages API compatibility layer for creating messages and counting tokens.
  name: Messages
  x-displayName: Messages
- description: ''
  name: Models
- description: Protocol for prompt management operations.
  name: Prompts
  x-displayName: Prompts
- description: Providers API for inspecting, listing, and modifying providers and their configurations.
  name: Providers
  x-displayName: Providers
- description: OpenAI-compatible Moderations API.
  name: Safety
  x-displayName: Safety
- description: ''
  name: Shields
- description: ''
  name: ToolGroups
- description: ''
  name: ToolRuntime
- description: Tool listing and management.
  name: Tools
  x-displayName: Tools
- description: ''
  name: VectorIO
- description: OpenAI Responses API for agent orchestration with tool use, multi-turn conversations, and background processing.
  name: Responses
  x-displayName: Responses
x-tagGroups:
- name: Operations
  tags:
  - Admin
  - Agents
  - Batches
  - Connectors
  - Conversations
  - File Processors
  - Files
  - Inference
  - Inspect
  - Interactions
  - Messages
  - Models
  - Prompts
  - Providers
  - Responses
  - Safety
  - Shields
  - ToolGroups
  - ToolRuntime
  - Tools
  - VectorIO
security:
- Default: []