package com.openai.models.responses

import com.openai.core.JsonValue
import com.openai.errors.OpenAIInvalidDataException
import java.util.Objects
import java.util.Optional
import kotlin.jvm.optionals.getOrElse
import kotlin.jvm.optionals.getOrNull

/**
 * A wrapper for [ResponseOutputItem] that provides type-safe access to the [message] when using the
 * _Structured Outputs_ feature to deserialize a JSON response to an instance of an arbitrary class.
 * See the SDK documentation for more details on _Structured Outputs_.
 *
 * @param T The type of the class to which the JSON data in the content will be deserialized when
 *   [message] is called.
 */
class StructuredResponseOutputItem<T : Any>(
    @get:JvmName("responseType") val responseType: Class<T>,
    @get:JvmName("rawOutputItem") val rawOutputItem: ResponseOutputItem,
) {
    private val message by lazy {
        rawOutputItem.message().map { StructuredResponseOutputMessage<T>(responseType, it) }
    }

    /** @see ResponseOutputItem.message */
    fun message(): Optional<StructuredResponseOutputMessage<T>> = message

    /** @see ResponseOutputItem.fileSearchCall */
    fun fileSearchCall(): Optional<ResponseFileSearchToolCall> = rawOutputItem.fileSearchCall()

    /** @see ResponseOutputItem.functionCall */
    fun functionCall(): Optional<ResponseFunctionToolCall> = rawOutputItem.functionCall()

    /** @see ResponseOutputItem.functionCallOutput */
    fun functionCallOutput(): Optional<ResponseFunctionToolCallOutputItem> =
        rawOutputItem.functionCallOutput()

    /** @see ResponseOutputItem.toolSearchCall */
    fun toolSearchCall(): Optional<ResponseToolSearchCall> = rawOutputItem.toolSearchCall()

    /** @see ResponseOutputItem.toolSearchOutput */
    fun toolSearchOutput(): Optional<ResponseToolSearchOutputItem> =
        rawOutputItem.toolSearchOutput()

    /** @see ResponseOutputItem.webSearchCall */
    fun webSearchCall(): Optional<ResponseFunctionWebSearch> = rawOutputItem.webSearchCall()

    /** @see ResponseOutputItem.computerCall */
    fun computerCall(): Optional<ResponseComputerToolCall> = rawOutputItem.computerCall()

    /** @see ResponseOutputItem.computerCallOutput */
    fun computerCallOutput(): Optional<ResponseComputerToolCallOutputItem> =
        rawOutputItem.computerCallOutput()

    /** @see ResponseOutputItem.reasoning */
    fun reasoning(): Optional<ResponseReasoningItem> = rawOutputItem.reasoning()

    /** @see ResponseOutputItem.compaction */
    fun compaction(): Optional<ResponseCompactionItem> = rawOutputItem.compaction()

    /** @see ResponseOutputItem.codeInterpreterCall */
    fun codeInterpreterCall(): Optional<ResponseCodeInterpreterToolCall> =
        rawOutputItem.codeInterpreterCall()

    /** @see ResponseOutputItem.imageGenerationCall */
    fun imageGenerationCall(): Optional<ResponseOutputItem.ImageGenerationCall> =
        rawOutputItem.imageGenerationCall()

    /** @see ResponseOutputItem.localShellCall */
    fun localShellCall(): Optional<ResponseOutputItem.LocalShellCall> =
        rawOutputItem.localShellCall()

    /** @see ResponseOutputItem.localShellCallOutput */
    fun localShellCallOutput(): Optional<ResponseOutputItem.LocalShellCallOutput> =
        rawOutputItem.localShellCallOutput()

    /** @see ResponseOutputItem.shellCall */
    fun shellCall(): Optional<ResponseFunctionShellToolCall> = rawOutputItem.shellCall()

    /** @see ResponseOutputItem.shellCallOutput */
    fun shellCallOutput(): Optional<ResponseFunctionShellToolCallOutput> =
        rawOutputItem.shellCallOutput()

    /** @see ResponseOutputItem.applyPatchCall */
    fun applyPatchCall(): Optional<ResponseApplyPatchToolCall> = rawOutputItem.applyPatchCall()

    /** @see ResponseOutputItem.applyPatchCallOutput */
    fun applyPatchCallOutput(): Optional<ResponseApplyPatchToolCallOutput> =
        rawOutputItem.applyPatchCallOutput()

    /** @see ResponseOutputItem.mcpApprovalRequest */
    fun mcpApprovalRequest(): Optional<ResponseOutputItem.McpApprovalRequest> =
        rawOutputItem.mcpApprovalRequest()

    /** @see ResponseOutputItem.mcpApprovalResponse */
    fun mcpApprovalResponse(): Optional<ResponseOutputItem.McpApprovalResponse> =
        rawOutputItem.mcpApprovalResponse()

    /** @see ResponseOutputItem.mcpCall */
    fun mcpCall(): Optional<ResponseOutputItem.McpCall> = rawOutputItem.mcpCall()

    /** @see ResponseOutputItem.mcpListTools */
    fun mcpListTools(): Optional<ResponseOutputItem.McpListTools> = rawOutputItem.mcpListTools()

    /** @see ResponseOutputItem.customToolCall */
    fun customToolCall(): Optional<ResponseCustomToolCall> = rawOutputItem.customToolCall()

    /** @see ResponseOutputItem.customToolCallOutput */
    fun customToolCallOutput(): Optional<ResponseCustomToolCallOutputItem> =
        rawOutputItem.customToolCallOutput()

    /** @see ResponseOutputItem.isMessage */
    fun isMessage(): Boolean = message().isPresent

    /** @see ResponseOutputItem.isFileSearchCall */
    fun isFileSearchCall(): Boolean = rawOutputItem.isFileSearchCall()

    /** @see ResponseOutputItem.isFunctionCall */
    fun isFunctionCall(): Boolean = rawOutputItem.isFunctionCall()

    /** @see ResponseOutputItem.isFunctionCallOutput */
    fun isFunctionCallOutput(): Boolean = rawOutputItem.isFunctionCallOutput()

    /** @see ResponseOutputItem.isToolSearchCall */
    fun isToolSearchCall(): Boolean = rawOutputItem.isToolSearchCall()

    /** @see ResponseOutputItem.isToolSearchOutput */
    fun isToolSearchOutput(): Boolean = rawOutputItem.isToolSearchOutput()

    /** @see ResponseOutputItem.isWebSearchCall */
    fun isWebSearchCall(): Boolean = rawOutputItem.isWebSearchCall()

    /** @see ResponseOutputItem.isComputerCall */
    fun isComputerCall(): Boolean = rawOutputItem.isComputerCall()

    /** @see ResponseOutputItem.isComputerCallOutput */
    fun isComputerCallOutput(): Boolean = rawOutputItem.isComputerCallOutput()

    /** @see ResponseOutputItem.isReasoning */
    fun isReasoning(): Boolean = rawOutputItem.isReasoning()

    /** @see ResponseOutputItem.isCompaction */
    fun isCompaction(): Boolean = rawOutputItem.isCompaction()

    /** @see ResponseOutputItem.isCodeInterpreterCall */
    fun isCodeInterpreterCall(): Boolean = rawOutputItem.isCodeInterpreterCall()

    /** @see ResponseOutputItem.isImageGenerationCall */
    fun isImageGenerationCall(): Boolean = rawOutputItem.isImageGenerationCall()

    /** @see ResponseOutputItem.isLocalShellCall */
    fun isLocalShellCall(): Boolean = rawOutputItem.isLocalShellCall()

    /** @see ResponseOutputItem.isLocalShellCallOutput */
    fun isLocalShellCallOutput(): Boolean = rawOutputItem.isLocalShellCallOutput()

    /** @see ResponseOutputItem.isShellCall */
    fun isShellCall(): Boolean = rawOutputItem.isShellCall()

    /** @see ResponseOutputItem.isShellCallOutput */
    fun isShellCallOutput(): Boolean = rawOutputItem.isShellCallOutput()

    /** @see ResponseOutputItem.isApplyPatchCall */
    fun isApplyPatchCall(): Boolean = rawOutputItem.isApplyPatchCall()

    /** @see ResponseOutputItem.isApplyPatchCallOutput */
    fun isApplyPatchCallOutput(): Boolean = rawOutputItem.isApplyPatchCallOutput()

    /** @see ResponseOutputItem.isMcpApprovalRequest */
    fun isMcpApprovalRequest(): Boolean = rawOutputItem.isMcpApprovalRequest()

    /** @see ResponseOutputItem.isMcpApprovalResponse */
    fun isMcpApprovalResponse(): Boolean = rawOutputItem.isMcpApprovalResponse()

    /** @see ResponseOutputItem.isMcpCall */
    fun isMcpCall(): Boolean = rawOutputItem.isMcpCall()

    /** @see ResponseOutputItem.isMcpListTools */
    fun isMcpListTools(): Boolean = rawOutputItem.isMcpListTools()

    /** @see ResponseOutputItem.isCustomToolCall */
    fun isCustomToolCall(): Boolean = rawOutputItem.isCustomToolCall()

    /** @see ResponseOutputItem.isCustomToolCallOutput */
    fun isCustomToolCallOutput(): Boolean = rawOutputItem.isCustomToolCallOutput()

    /** @see ResponseOutputItem.asMessage */
    fun asMessage(): StructuredResponseOutputMessage<T> =
        message.getOrElse {
            // Same behavior as `com.openai.core.getOrThrow` used by the delegate class.
            throw OpenAIInvalidDataException("`message` is not present")
        }

    /** @see ResponseOutputItem.asFileSearchCall */
    fun asFileSearchCall(): ResponseFileSearchToolCall = rawOutputItem.asFileSearchCall()

    /** @see ResponseOutputItem.asFunctionCall */
    fun asFunctionCall(): ResponseFunctionToolCall = rawOutputItem.asFunctionCall()

    /** @see ResponseOutputItem.asFunctionCallOutput */
    fun asFunctionCallOutput(): ResponseFunctionToolCallOutputItem =
        rawOutputItem.asFunctionCallOutput()

    /** @see ResponseOutputItem.asToolSearchCall */
    fun asToolSearchCall(): ResponseToolSearchCall = rawOutputItem.asToolSearchCall()

    /** @see ResponseOutputItem.asToolSearchOutput */
    fun asToolSearchOutput(): ResponseToolSearchOutputItem = rawOutputItem.asToolSearchOutput()

    /** @see ResponseOutputItem.asWebSearchCall */
    fun asWebSearchCall(): ResponseFunctionWebSearch = rawOutputItem.asWebSearchCall()

    /** @see ResponseOutputItem.asComputerCall */
    fun asComputerCall(): ResponseComputerToolCall = rawOutputItem.asComputerCall()

    /** @see ResponseOutputItem.asComputerCallOutput */
    fun asComputerCallOutput(): ResponseComputerToolCallOutputItem =
        rawOutputItem.asComputerCallOutput()

    /** @see ResponseOutputItem.asReasoning */
    fun asReasoning(): ResponseReasoningItem = rawOutputItem.asReasoning()

    /** @see ResponseOutputItem.asCompaction */
    fun asCompaction(): ResponseCompactionItem = rawOutputItem.asCompaction()

    /** @see ResponseOutputItem.asCodeInterpreterCall */
    fun asCodeInterpreterCall(): ResponseCodeInterpreterToolCall =
        rawOutputItem.asCodeInterpreterCall()

    /** @see ResponseOutputItem.asImageGenerationCall */
    fun asImageGenerationCall(): ResponseOutputItem.ImageGenerationCall =
        rawOutputItem.asImageGenerationCall()

    /** @see ResponseOutputItem.asLocalShellCall */
    fun asLocalShellCall(): ResponseOutputItem.LocalShellCall = rawOutputItem.asLocalShellCall()

    /** @see ResponseOutputItem.asLocalShellCallOutput */
    fun asLocalShellCallOutput(): ResponseOutputItem.LocalShellCallOutput =
        rawOutputItem.asLocalShellCallOutput()

    /** @see ResponseOutputItem.asShellCall */
    fun asShellCall(): ResponseFunctionShellToolCall = rawOutputItem.asShellCall()

    /** @see ResponseOutputItem.asShellCallOutput */
    fun asShellCallOutput(): ResponseFunctionShellToolCallOutput = rawOutputItem.asShellCallOutput()

    /** @see ResponseOutputItem.asApplyPatchCall */
    fun asApplyPatchCall(): ResponseApplyPatchToolCall = rawOutputItem.asApplyPatchCall()

    /** @see ResponseOutputItem.asApplyPatchCallOutput */
    fun asApplyPatchCallOutput(): ResponseApplyPatchToolCallOutput =
        rawOutputItem.asApplyPatchCallOutput()

    /** @see ResponseOutputItem.asMcpApprovalRequest */
    fun asMcpApprovalRequest(): ResponseOutputItem.McpApprovalRequest =
        rawOutputItem.asMcpApprovalRequest()

    /** @see ResponseOutputItem.asMcpApprovalResponse */
    fun asMcpApprovalResponse(): ResponseOutputItem.McpApprovalResponse =
        rawOutputItem.asMcpApprovalResponse()

    /** @see ResponseOutputItem.asMcpCall */
    fun asMcpCall(): ResponseOutputItem.McpCall = rawOutputItem.asMcpCall()

    /** @see ResponseOutputItem.asMcpListTools */
    fun asMcpListTools(): ResponseOutputItem.McpListTools = rawOutputItem.asMcpListTools()

    /** @see ResponseOutputItem.asCustomToolCall */
    fun asCustomToolCall(): ResponseCustomToolCall = rawOutputItem.asCustomToolCall()

    /** @see ResponseOutputItem.asCustomToolCallOutput */
    fun asCustomToolCallOutput(): ResponseCustomToolCallOutputItem =
        rawOutputItem.asCustomToolCallOutput()

    /** @see ResponseOutputItem._json */
    fun _json(): Optional<JsonValue> = rawOutputItem._json()

    /** @see ResponseOutputItem.accept */
    fun <R> accept(visitor: Visitor<T, R>): R =
        when {
            isMessage() -> visitor.visitMessage(asMessage())
            isFileSearchCall() -> visitor.visitFileSearchCall(asFileSearchCall())
            isFunctionCall() -> visitor.visitFunctionCall(asFunctionCall())
            isFunctionCallOutput() -> visitor.visitFunctionCallOutput(asFunctionCallOutput())
            isToolSearchCall() -> visitor.visitToolSearchCall(asToolSearchCall())
            isToolSearchOutput() -> visitor.visitToolSearchOutput(asToolSearchOutput())
            isWebSearchCall() -> visitor.visitWebSearchCall(asWebSearchCall())
            isComputerCall() -> visitor.visitComputerCall(asComputerCall())
            isComputerCallOutput() -> visitor.visitComputerCallOutput(asComputerCallOutput())
            isReasoning() -> visitor.visitReasoning(asReasoning())
            isCompaction() -> visitor.visitCompaction(asCompaction())
            isCodeInterpreterCall() -> visitor.visitCodeInterpreterCall(asCodeInterpreterCall())
            isImageGenerationCall() -> visitor.visitImageGenerationCall(asImageGenerationCall())
            isLocalShellCall() -> visitor.visitLocalShellCall(asLocalShellCall())
            isLocalShellCallOutput() -> visitor.visitLocalShellCallOutput(asLocalShellCallOutput())
            isShellCall() -> visitor.visitShellCall(asShellCall())
            isShellCallOutput() -> visitor.visitShellCallOutput(asShellCallOutput())
            isApplyPatchCall() -> visitor.visitApplyPatchCall(asApplyPatchCall())
            isApplyPatchCallOutput() -> visitor.visitApplyPatchCallOutput(asApplyPatchCallOutput())
            isMcpApprovalRequest() -> visitor.visitMcpApprovalRequest(asMcpApprovalRequest())
            isMcpApprovalResponse() -> visitor.visitMcpApprovalResponse(asMcpApprovalResponse())
            isMcpCall() -> visitor.visitMcpCall(asMcpCall())
            isMcpListTools() -> visitor.visitMcpListTools(asMcpListTools())
            isCustomToolCall() -> visitor.visitCustomToolCall(asCustomToolCall())
            isCustomToolCallOutput() -> visitor.visitCustomToolCallOutput(asCustomToolCallOutput())
            else -> visitor.unknown(_json().getOrNull())
        }

    private var validated: Boolean = false

    /** @see ResponseOutputItem.validate */
    fun validate(): StructuredResponseOutputItem<T> = apply {
        if (validated) {
            return@apply
        }

        accept(
            object : Visitor<T, Unit> {
                override fun visitMessage(message: StructuredResponseOutputMessage<T>) {
                    message.validate()
                }

                override fun visitFileSearchCall(fileSearchCall: ResponseFileSearchToolCall) {
                    fileSearchCall.validate()
                }

                override fun visitFunctionCall(functionCall: ResponseFunctionToolCall) {
                    functionCall.validate()
                }

                override fun visitFunctionCallOutput(
                    functionCallOutput: ResponseFunctionToolCallOutputItem
                ) {
                    functionCallOutput.validate()
                }

                override fun visitToolSearchCall(toolSearchCall: ResponseToolSearchCall) {
                    toolSearchCall.validate()
                }

                override fun visitToolSearchOutput(toolSearchOutput: ResponseToolSearchOutputItem) {
                    toolSearchOutput.validate()
                }

                override fun visitWebSearchCall(webSearchCall: ResponseFunctionWebSearch) {
                    webSearchCall.validate()
                }

                override fun visitComputerCall(computerCall: ResponseComputerToolCall) {
                    computerCall.validate()
                }

                override fun visitComputerCallOutput(
                    computerCallOutput: ResponseComputerToolCallOutputItem
                ) {
                    computerCallOutput.validate()
                }

                override fun visitReasoning(reasoning: ResponseReasoningItem) {
                    reasoning.validate()
                }

                override fun visitCompaction(compaction: ResponseCompactionItem) {
                    compaction.validate()
                }

                override fun visitCodeInterpreterCall(
                    codeInterpreterCall: ResponseCodeInterpreterToolCall
                ) {
                    codeInterpreterCall.validate()
                }

                override fun visitImageGenerationCall(
                    imageGenerationCall: ResponseOutputItem.ImageGenerationCall
                ) {
                    imageGenerationCall.validate()
                }

                override fun visitLocalShellCall(
                    localShellCall: ResponseOutputItem.LocalShellCall
                ) {
                    localShellCall.validate()
                }

                override fun visitLocalShellCallOutput(
                    localShellCallOutput: ResponseOutputItem.LocalShellCallOutput
                ) {
                    localShellCallOutput.validate()
                }

                override fun visitShellCall(shellCall: ResponseFunctionShellToolCall) {
                    shellCall.validate()
                }

                override fun visitShellCallOutput(
                    shellCallOutput: ResponseFunctionShellToolCallOutput
                ) {
                    shellCallOutput.validate()
                }

                override fun visitApplyPatchCall(applyPatchCall: ResponseApplyPatchToolCall) {
                    applyPatchCall.validate()
                }

                override fun visitApplyPatchCallOutput(
                    applyPatchCallOutput: ResponseApplyPatchToolCallOutput
                ) {
                    applyPatchCallOutput.validate()
                }

                override fun visitMcpApprovalRequest(
                    mcpApprovalRequest: ResponseOutputItem.McpApprovalRequest
                ) {
                    mcpApprovalRequest.validate()
                }

                override fun visitMcpApprovalResponse(
                    mcpApprovalResponse: ResponseOutputItem.McpApprovalResponse
                ) {
                    mcpApprovalResponse.validate()
                }

                override fun visitMcpCall(mcpCall: ResponseOutputItem.McpCall) {
                    mcpCall.validate()
                }

                override fun visitMcpListTools(mcpListTools: ResponseOutputItem.McpListTools) {
                    mcpListTools.validate()
                }

                override fun visitCustomToolCall(customToolCall: ResponseCustomToolCall) {
                    customToolCall.validate()
                }

                override fun visitCustomToolCallOutput(
                    customToolCallOutput: ResponseCustomToolCallOutputItem
                ) {
                    customToolCallOutput.validate()
                }
            }
        )
        validated = true
    }

    /** @see ResponseOutputItem.isValid */
    fun isValid(): Boolean =
        try {
            validate()
            true
        } catch (_: OpenAIInvalidDataException) {
            false
        }

    override fun equals(other: Any?): Boolean {
        if (this === other) {
            return true
        }

        return other is StructuredResponseOutputItem<*> &&
            responseType == other.responseType &&
            rawOutputItem == other.rawOutputItem
    }

    override fun hashCode(): Int = Objects.hash(responseType, rawOutputItem)

    override fun toString(): String =
        "${javaClass.simpleName}{responseType=$responseType, rawOutputItem=$rawOutputItem}"

    /** @see ResponseOutputItem.Visitor */
    // In keeping with the delegate's `Visitor<T>`, `T` is used to refer to the return type of each
    // function. `R` (for "Response") is used to refer to the response type, which is otherwise
    // named `T` in the outer class, but confusion here is probably preferable to confusion there.
    interface Visitor<R : Any, out T> {
        /** @see ResponseOutputItem.Visitor.visitMessage */
        fun visitMessage(message: StructuredResponseOutputMessage<R>): T

        /** @see ResponseOutputItem.Visitor.visitFileSearchCall */
        fun visitFileSearchCall(fileSearchCall: ResponseFileSearchToolCall): T

        /** @see ResponseOutputItem.Visitor.visitFunctionCall */
        fun visitFunctionCall(functionCall: ResponseFunctionToolCall): T

        /** @see ResponseOutputItem.Visitor.visitFunctionCallOutput */
        fun visitFunctionCallOutput(functionCallOutput: ResponseFunctionToolCallOutputItem): T

        /** @see ResponseOutputItem.Visitor.visitToolSearchCall */
        fun visitToolSearchCall(toolSearchCall: ResponseToolSearchCall): T

        /** @see ResponseOutputItem.Visitor.visitToolSearchOutput */
        fun visitToolSearchOutput(toolSearchOutput: ResponseToolSearchOutputItem): T

        /** @see ResponseOutputItem.Visitor.visitWebSearchCall */
        fun visitWebSearchCall(webSearchCall: ResponseFunctionWebSearch): T

        /** @see ResponseOutputItem.Visitor.visitComputerCall */
        fun visitComputerCall(computerCall: ResponseComputerToolCall): T

        /** @see ResponseOutputItem.Visitor.visitComputerCallOutput */
        fun visitComputerCallOutput(computerCallOutput: ResponseComputerToolCallOutputItem): T

        /** @see ResponseOutputItem.Visitor.visitReasoning */
        fun visitReasoning(reasoning: ResponseReasoningItem): T

        /** @see ResponseOutputItem.Visitor.visitCompaction */
        fun visitCompaction(compaction: ResponseCompactionItem): T

        /** @see ResponseOutputItem.Visitor.visitCodeInterpreterCall */
        fun visitCodeInterpreterCall(codeInterpreterCall: ResponseCodeInterpreterToolCall): T

        /** @see ResponseOutputItem.Visitor.visitImageGenerationCall */
        fun visitImageGenerationCall(imageGenerationCall: ResponseOutputItem.ImageGenerationCall): T

        /** @see ResponseOutputItem.Visitor.visitLocalShellCall */
        fun visitLocalShellCall(localShellCall: ResponseOutputItem.LocalShellCall): T

        /** @see ResponseOutputItem.Visitor.visitLocalShellCallOutput */
        fun visitLocalShellCallOutput(
            localShellCallOutput: ResponseOutputItem.LocalShellCallOutput
        ): T

        /** @see ResponseOutputItem.Visitor.visitShellCall */
        fun visitShellCall(shellCall: ResponseFunctionShellToolCall): T

        /** @see ResponseOutputItem.Visitor.visitShellCallOutput */
        fun visitShellCallOutput(shellCallOutput: ResponseFunctionShellToolCallOutput): T

        /** @see ResponseOutputItem.Visitor.visitApplyPatchCall */
        fun visitApplyPatchCall(applyPatchCall: ResponseApplyPatchToolCall): T

        /** @see ResponseOutputItem.Visitor.visitApplyPatchCallOutput */
        fun visitApplyPatchCallOutput(applyPatchCallOutput: ResponseApplyPatchToolCallOutput): T

        /** @see ResponseOutputItem.Visitor.visitMcpApprovalRequest */
        fun visitMcpApprovalRequest(mcpApprovalRequest: ResponseOutputItem.McpApprovalRequest): T

        /** @see ResponseOutputItem.Visitor.visitMcpApprovalResponse */
        fun visitMcpApprovalResponse(mcpApprovalResponse: ResponseOutputItem.McpApprovalResponse): T

        /** @see ResponseOutputItem.Visitor.visitMcpCall */
        fun visitMcpCall(mcpCall: ResponseOutputItem.McpCall): T

        /** @see ResponseOutputItem.Visitor.visitMcpListTools */
        fun visitMcpListTools(mcpListTools: ResponseOutputItem.McpListTools): T

        /** @see ResponseOutputItem.Visitor.visitCustomToolCall */
        fun visitCustomToolCall(customToolCall: ResponseCustomToolCall): T

        /** @see ResponseOutputItem.Visitor.visitCustomToolCallOutput */
        fun visitCustomToolCallOutput(customToolCallOutput: ResponseCustomToolCallOutputItem): T

        /** @see ResponseOutputItem.Visitor.unknown */
        fun unknown(json: JsonValue?): T {
            throw OpenAIInvalidDataException("Unknown ResponseOutputItem: $json")
        }
    }
}
