feat(namespace): expose ScoredVector from top-level pinecone namespace

Adds ScoredVector to the three required places in pinecone/__init__.py
(TYPE_CHECKING import, __all__, and _LAZY_IMPORTS) so that
`from pinecone import ScoredVector` works without importing the internal
module path. Adds TestScoredVectorTopLevelExport unit tests to verify
the re-export is identity-preserving and visible via __all__ and dir().

Closes BCG-011.

Author: jhamon

pinecone/__init__.py

@@ -198,7 +198,7 @@
         SearchUsage,
     )
     from pinecone.models.vectors.sparse import SparseValues
-    from pinecone.models.vectors.vector import Vector
+    from pinecone.models.vectors.vector import ScoredVector, Vector
     from pinecone.utils.filter_builder import Field, FilterBuilder
 
 __version__ = "8.1.2"
@@ -322,6 +322,7 @@
     "RestoreJobList",
     "RestoreJobModel",
     "RetryConfig",
+    "ScoredVector",
     "SearchInputs",
     "SearchQuery",
     "SearchRecordsResponse",
@@ -514,6 +515,7 @@
     "SearchRerank": ("pinecone.db_data.dataclasses.search_rerank", "SearchRerank"),
     "SearchResult": ("pinecone.models.vectors.search", "SearchResult"),
     "SearchUsage": ("pinecone.models.vectors.search", "SearchUsage"),
+    "ScoredVector": ("pinecone.models.vectors.vector", "ScoredVector"),
     "ServerlessSpec": ("pinecone.models.indexes.specs", "ServerlessSpec"),
     "ServerlessSpecInfo": ("pinecone.models.indexes.index", "ServerlessSpecInfo"),
     "SparseEmbedding": ("pinecone.models.inference.embed", "SparseEmbedding"),

tests/unit/test_backcompat_shims.py

@@ -117,6 +117,29 @@ def test_list_response_with_pagination(self) -> None:
         assert lr.pagination.next == "t"
 
 
+class TestScoredVectorTopLevelExport:
+    def test_importable(self) -> None:
+        from pinecone import ScoredVector
+
+        assert ScoredVector.__name__ == "ScoredVector"
+
+    def test_is_canonical_class(self) -> None:
+        import pinecone
+        import pinecone.models.vectors.vector as canonical
+
+        assert pinecone.ScoredVector is canonical.ScoredVector
+
+    def test_in_all(self) -> None:
+        import pinecone
+
+        assert "ScoredVector" in pinecone.__all__
+
+    def test_in_dir(self) -> None:
+        import pinecone
+
+        assert "ScoredVector" in dir(pinecone)
+
+
 class TestDbDataDataclassesPackage:
     def test_package_exports_all_symbols(self) -> None:
         import pinecone.db_data.dataclasses as pkg