fix: improve Vector Stores OpenAI API conformance

[leseb]

Summary

Fix schema issues in the Vector Stores API to improve OpenAI conformance from 61.3% to ~87%.

Supersedes #5394 (which was too broad, mixing embeddings + vector stores + OpenAPI generator changes).

Key changes

• Add VectorStoreExpirationAfter model with anchor/days fields
• Add VectorStoreStatus literal type and VectorStoreFileBatchFileEntry model
• Make required fields non-optional to match OpenAI spec (name, usage_bytes, status, has_more)
• Fix object fields to use Literal types with correct values
• Add missing error codes (unsupported_file, invalid_file)
• Make metadata nullable to match OpenAI spec
• Add description field to vector store create request

Files changed (6 source + regenerated specs)

• src/llama_stack_api/vector_io/models.py - schema fixes
• src/llama_stack/core/routers/vector_io.py - pass newly required fields
• src/llama_stack/providers/utils/memory/openai_vector_store_mixin.py - pass newly required fields
• 3 test files updated for new required fields

Test plan

• Unit tests pass (27 tests)
• Mypy passes
• Pre-commit passes
• API spec codegen clean

🤖 Generated with Claude Code

[github-actions]

✱ Stainless preview builds

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

fix: improve Vector Stores OpenAI API conformance

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

✅ llama-stack-client-go studio · conflict

Your SDK build had at least one new note diagnostic, which is a regression from the base state.

New diagnostics (13 note)

💡 Model/Recommended: `#/components/schemas/VectorStoreExpirationAfter` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/vector_stores`.

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

💡 Schema/EnumHasOneMember: This enum schema has just one member, so it could be defined using [`const`](https://json-schema.org/understanding-json-schema/reference/const).

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

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️ → build ✅ → lint ✅ → test ✅

pip install https://pkg.stainless.com/s/llama-stack-client-python/81c0134b4b95d2069e775ea4912070d1fa8ebd02/llama_stack_client-0.7.0a2-py3-none-any.whl

New diagnostics (1 note)

💡 Model/Recommended: `#/components/schemas/VectorStoreExpirationAfter` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/vector_stores`.

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

Your SDK build had at least one "warning" diagnostic, but this did not represent a regression.
generate ⚠️

New diagnostics (1 note)

💡 Model/Recommended: `#/components/schemas/VectorStoreExpirationAfter` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/vector_stores`.

✅ llama-stack-client-node studio · conflict

Your SDK build had at least one new note diagnostic, which is a regression from the base state.

New diagnostics (1 note)

💡 Model/Recommended: `#/components/schemas/VectorStoreExpirationAfter` could potentially be defined as a [model](https://www.stainless.com/docs/guides/configure#models) within `#/resources/vector_stores`.

---

This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
If you push custom code to the preview branch, re-run this workflow to update the comment.
Last updated: 2026-04-02 09:11:40 UTC

[franciscojavierarceo]

Nice