feat: Add metadata field to request and response

[abhibongale]

This changes adds Optional metadata field to OpenAI compatible request and response object.

fixes: #3564

[github-actions]

✱ Stainless preview builds

This PR will update the llama-stack-client SDKs with the following commit message.

feat: Add metadata field to request and response

Edit this comment to update it. It will appear in the SDK's changelogs.

✅ llama-stack-client-node studio · code · diff

Your SDK built successfully.
generate ❗ → build ✅ → lint ✅ → test ✅

npm install https://pkg.stainless.com/s/llama-stack-client-node/012a118ee248f3baa076145fd6670fafcab20750/dist.tar.gz

New diagnostics (18 note)

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

✅ llama-stack-client-kotlin studio · code · diff

Your SDK built successfully.
generate ❗ → lint ✅ → test ❗

New diagnostics (18 note)

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

✅ llama-stack-client-go studio · code · diff

Your SDK built successfully.
generate ❗ → lint ❗ → test ❗

go get github.com/stainless-sdks/llama-stack-client-go@885a14006a90a5237fcac50f397a17f24531f9ad

New diagnostics (18 note)

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

✅ llama-stack-client-python studio · code · diff

Your SDK built successfully.
generate ❗ → build ⏳ → lint ⏳ → test ⏳

New diagnostics (18 note)

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

💡 Schema/ArrayMissingItems: Schema has `type: array` but is missing an items definition

💡 Schema/ObjectHasNoProperties: This schema has neither `properties` nor `additionalProperties` so its type has been interpreted as `unknown`.

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
Last updated: 2025-11-12 14:57:56 UTC

[mattf]

@abhibongale which llm did you use for this?

the linked issue (#3564) correctly states the Responses API supports a metadata param.

this patch adds a metadata param to /v1/completions, /v1/chat/completions, and /v1/embeddings, of which only chat accepts a metadata param. it fails to add metadata to the /v1/responses api.

please use a prompt like -

add a metadata param to the /v1/responses api that accepts a dict[str, str]. the responses api is defined under agents in src/llama_stack/apis/agents/agents.py and implemented by src/llama_stack/providers/inline/agents/meta_reference/agents.py

[abhibongale]

@mattf Thank you — I’ll make the changes. I used Gemini and ChatGPT’s research features to explain and suggest code changes. I guess I’ll use documentation rather than relying solely on LLMs.

[mergify]

This pull request has merge conflicts that must be resolved before it can be merged. @abhibongale please rebase it. https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork