docs(responses): trim the field-copy comment per review

Keeps the two comments carrying non-obvious facts (the json_schema
nesting difference between the two APIs, and type_to_response_format_param
passing a dict through unchanged) and drops the one restating the copy.
This commit is contained in:
MHammett 2026-08-16 21:10:35 -05:00
parent da207f1f4c
commit c5d0800004

View file

@ -959,8 +959,8 @@ class ResponsesAPIRequestUtils:
return {"format": {"type": format_type}}
json_schema: Final = converted.get("json_schema") or {}
# `name`/`schema` are required by the API and `strict`/`description` are optional,
# so copy whatever was supplied and let the provider reject a malformed schema.
# Only `strict`/`description` are optional; a missing `name`/`schema` is the
# provider's error to report, not ours to guess at.
schema_fields: Final = {
key: json_schema[key]
for key in ("name", "schema", "strict", "description")