Add typed metadata property builder

[YuqiGuo105]

Summary

• add a typed Metadata.Builder.putProperty(String, String) helper for Responses
• expose the same helper for the Beta Responses API
• preserve putAdditionalProperty(String, JsonValue) as the escape hatch for undocumented values
• add regression tests that verify string values are stored as JSON strings

Motivation

The API only accepts string values for metadata, but the existing builder exposes only the raw JsonValue method. This allows values such as JSON numbers to compile and fail later with a 400 response. The typed helper provides a straightforward, API-aligned path while keeping the existing low-level method backward compatible.

Testing

• targeted stable and Beta ResponseCreateParamsTest tests
• :openai-java-core:lintKotlin
• full offline build with mock-server-dependent tests skipped
• Castiron custom-code budget check (1886 / 2000)

Closes #338

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-02T18:30:10.986425Z	1790828	PR opened
🔒 Security Review	✅ Completed 2026-09-02T18:29:28.640336Z	1790828	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[sylvesterkaczmarek]

This is a useful API-level narrowing over the raw additional-properties escape hatch. The helper guarantees metadata values are serialized as JSON strings, which matches the service contract and avoids callers accidentally sending numeric JSON for numeric-looking IDs. Mirroring it in both stable and beta response params keeps the two surfaces consistent.

[dpiet-oai]

Thanks, @YuqiGuo105, for proposing the typed metadata helper and adding regression coverage. The putProperty(String, String) helper is now available in both stable and beta Responses metadata builders in v4.80.0, with putAdditionalProperty(String, JsonValue) preserved.

We've closed #338 as completed. Closing this PR as superseded by the released implementation. Thank you for helping improve the SDK!