fix: regenerate OpenAPI clients with TYPE_CHECKING imports for mypy

[jhamon]

Summary

• Regenerate all OpenAPI clients using updated Mustache templates that add TYPE_CHECKING blocks for static type analysis
• This fixes mypy errors in generated code where model references were not recognized
• The template submodule (codegen/python-oas-templates) has been updated to include proper TYPE_CHECKING imports

Problem

Generated OpenAPI code in pinecone/core/openapi/ had multiple mypy errors:

1. Missing type imports (Dict, Any from typing)
2. Undefined model references (SparseValues, ErrorResponseError, Document, etc.)
3. Return type annotation issues

Solution

Updated the Mustache templates to add TYPE_CHECKING blocks that allow mypy to see type annotations while avoiding circular import issues at runtime:

from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from .model.some_model import SomeModel

def lazy_import():
    from .model.some_model import SomeModel
    globals()["SomeModel"] = SomeModel

Verification

uv run mypy pinecone/core/openapi  # No errors in generated code

Notes

There are pre-existing issues on the fts branch where SDK code imports non-existent models (e.g., ConfigureIndexRequestEmbed, IndexSpec). These imports reference models that don't exist in the current API spec and are not caused by this change - they are a separate issue that pre-dates this PR.

Related

• Blocks: SDK-116 (Re-enable CI linting and unit tests for fts branch)
• Linear: https://linear.app/pinecone-io/issue/SDK-270

Made with Cursor

---

Note

Low Risk
Low risk because changes are confined to generated OpenAPI client/model code and mainly add cast/TYPE_CHECKING imports for static typing; runtime behavior should be unchanged aside from type-hint surfaces.

Overview
Regenerates the OpenAPI Python clients/models to be more mypy-friendly by adding TYPE_CHECKING import blocks for referenced models and tightening return type annotations via typing.cast (including ApplyResult[...] unions for async_req).

Also removes a few # type: ignore markers on _composed_schemas helpers and updates the generated APIS_REPO_SHA in openapi_support/api_version.py.

^{Written by Cursor Bugbot for commit d699e3c. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}