feat(openai): add support for the “text_verbosity” parameter in structured output

[Jimerson21]

Hello,

Currently, responses with structured output do not allow you to configure the “verbosity” parameter.

/**
     * @param  array{type: 'json_schema', name: string, schema: array<mixed>, strict?: bool}|array{type: 'json_object'}  $responseFormat
     */
    protected function sendRequest(Request $request, array $responseFormat): ClientResponse
    {
        /** @var ClientResponse $response */
        $response = $this->client->post(
            'responses',
            array_merge([
                'model' => $request->model(),
                'input' => (new MessageMap($request->messages(), $request->systemPrompts()))(),
            ], Arr::whereNotNull([
                'max_output_tokens' => $request->maxTokens(),
                'temperature' => $request->temperature(),
                'top_p' => $request->topP(),
                'metadata' => $request->providerOptions('metadata'),
                'tools' => $this->buildTools($request),
                'tool_choice' => ToolChoiceMap::map($request->toolChoice()),
                'parallel_tool_calls' => $request->providerOptions('parallel_tool_calls') ?? false,
                'previous_response_id' => $request->providerOptions('previous_response_id'),
                'service_tier' => $request->providerOptions('service_tier'),
                'truncation' => $request->providerOptions('truncation'),
                'reasoning' => $request->providerOptions('reasoning'),
                'store' => $request->providerOptions('store'),
                'text' => [
                    'format' => $responseFormat,
                    // here: verbosity
                ],
            ]))
        );

        return $response;
    }

[wishborn]

Fixed in the maintained fork particle-academy/prism as of v0.109.1 (drop-in, Prism\Prism namespace unchanged):

Added — text_verbosity now maps through OpenAI structured output and both chat/completions paths (it was previously only on the Responses text path). Set it via ->withProviderOptions(['text_verbosity' => 'low']).

composer require particle-academy/prism