chore(cli): sync package

Source: https://github.com/Evokoa/polygres-private/commit/cc9f39ab681118fb8571a207f9a21950ce6c5be8

Author: github-actions[bot]

CHANGELOG.md

@@ -2,7 +2,14 @@
 
 All notable changes to `polygres-cli` are documented in this file.
 
-## 0.2.0 - 2026-08-06
+## Unreleased
+
+### Changed
+
+- `polygres vector configs create` now returns a migration error directing users to
+  `polygres context collections create`.
+
+## 0.2.0 - 2026-08-08
 
 ### Added
 

README.md

@@ -55,9 +55,56 @@ polygres vector configs list
 polygres text configs list
 ```
 
+Creating new pgvector configurations is retired. Use
+`polygres context collections create` to create a pgContext collection and native
+`pgcontext.vector` column. Existing vector configuration list, retrieval, and lifecycle
+commands remain available for previously registered columns.
+
+### Work with pgContext AI Search
+
+pgContext uses named collections and is the supported path for new vector setup.
+
+```bash
+polygres context capabilities
+polygres context sources discover
+polygres context collections create support_docs \
+  --source new-table \
+  --table support_docs \
+  --dimensions 768
+polygres context search support_docs \
+  --embedding-file query-embedding.json
+```
+
+Commands that change a collection wait for the server operation to finish by default. Use `--no-wait` to return as soon as the operation is accepted.
+
+Global options must come before the command namespace:
+
+```bash
+polygres --project <project-id> --json context collections list
+```
+
+## Use additional API routes
+
+The `api` commands give automation access to supported project-management routes that do not yet have a dedicated high-level command.
+
+```bash
+polygres api routes
+polygres --json api routes --method GET
+polygres --json --project <project-id> api request \
+  /projects/{project_id} \
+  --method GET \
+  --dry-run
+```
+
+The CLI validates the route, HTTP method, parameters, and JSON body against its bundled API specification before sending the request. Run with `--dry-run` to inspect a request without executing it.
+
+## Notices and automation
+
+Service and release notices are written to standard error, so standard output and `--json` remain safe for scripts. The CLI never sends command arguments or command output when checking for notices.
+
 ## Version and support
 
-The current published CLI release is [`0.1.2`](https://github.com/Evokoa/polygres-cli/releases/tag/python-cli-v0.1.2).
+Package version: [`0.2.0`](https://github.com/Evokoa/polygres-cli/releases/tag/python-cli-v0.2.0).
 
 Useful commands:
 
@@ -76,4 +123,4 @@ Users of the former combined `polygres` package should install both packages sep
 
 ## Changelog
 
-See the [CLI 0.1.2 release notes](https://github.com/Evokoa/polygres-cli/releases/tag/python-cli-v0.1.2) for published changes.
+See the [CLI 0.2.0 release notes](https://github.com/Evokoa/polygres-cli/releases/tag/python-cli-v0.2.0) for release changes.

src/polygres_cli/_vendor/polygres_lib/context/enums.py

@@ -88,6 +88,7 @@ class ContextOperationKind(str, Enum):
     COLLECTION_UPDATE = "collection_update"
     COLLECTION_DELETE = "collection_delete"
     COLLECTION_REINDEX = "collection_reindex"
+    VECTOR_ADD = "vector_add"
     FILTER_ADD_COLUMN = "filter_add_column"
     FILTER_ADD_JSONB_PATH = "filter_add_jsonb_path"
     POINTS_UPSERT = "points_upsert"
@@ -178,6 +179,18 @@ class ContextRecommendedAction(str, Enum):
         "failed",
         "cancelled",
     ),
+    ContextOperationKind.VECTOR_ADD: (
+        "queued",
+        "validating_vector",
+        "creating_vector_column",
+        "registering_vector",
+        "building_index",
+        "attaching_index",
+        "verifying",
+        "ready",
+        "failed",
+        "cancelled",
+    ),
     ContextOperationKind.COLLECTION_UPDATE: (
         "queued",
         "validating_config",

src/polygres_cli/_vendor/polygres_lib/context/models.py

@@ -106,17 +106,25 @@ def _mode_shape(self) -> ContextSourceRequest:
 
 
 class ContextVectorRequest(ContextRequest):
+    name: str | None = None
     column_name: str = "embedding"
     dimensions: int = Field(ge=1, le=16_000)
     metric: ContextMetric = ContextMetric.COSINE
 
-    @field_validator("column_name")
+    @field_validator("name", "column_name")
     @classmethod
-    def _column(cls, value: str) -> str:
-        require_valid(validate_identifier(value, field="column_name"))
+    def _column(cls, value: str | None, info) -> str | None:
+        if value is not None:
+            require_valid(validate_identifier(value, field=info.field_name))
         return value
 
 
+class ContextVectorCreateRequest(ContextVectorRequest):
+    mode: Literal["existing", "add_column"] = "existing"
+    index_kind: ContextIndexKind = ContextIndexKind.HNSW
+    set_default: bool = False
+
+
 class JsonbFilterPathRequest(ContextRequest):
     key: str
     column: str
@@ -185,6 +193,7 @@ class CollectionUpdateRequest(ContextRequest):
     text_column: str | None = None
     result_columns: list[str] | None = Field(default=None, max_length=32)
     max_search_limit: int | None = Field(default=None, ge=1, le=1_000)
+    default_vector_name: str | None = None
 
     @field_validator("text_column")
     @classmethod
@@ -193,6 +202,13 @@ def _text_column(cls, value: str | None) -> str | None:
             require_valid(validate_identifier(value, field="text_column"))
         return value
 
+    @field_validator("default_vector_name")
+    @classmethod
+    def _default_vector_name(cls, value: str | None) -> str | None:
+        if value is not None:
+            require_valid(validate_identifier(value, field="default_vector_name"))
+        return value
+
     @field_validator("result_columns")
     @classmethod
     def _result_columns(cls, value: list[str] | None) -> list[str] | None:
@@ -271,6 +287,7 @@ def _field(cls, value: str) -> str:
 
 
 class DenseSearchRequest(CountRequest):
+    vector_name: str | None = None
     embedding: list[float]
     limit: int = Field(default=10, ge=1, le=MAX_RANKED_LIMIT)
 
@@ -280,9 +297,17 @@ def _embedding(cls, value: list[float]) -> list[float]:
         require_valid(validate_embedding(value))
         return value
 
+    @field_validator("vector_name")
+    @classmethod
+    def _vector_name(cls, value: str | None) -> str | None:
+        if value is not None:
+            require_valid(validate_identifier(value, field="vector_name"))
+        return value
+
 
 class GroupedSearchRequest(ContextRequest):
     collection: str
+    vector_name: str | None = None
     embedding: list[float]
     group_by: str
     group_limit: int = Field(default=1, ge=1, le=MAX_RANKED_LIMIT)
@@ -300,6 +325,13 @@ def _group(cls, value: str) -> str:
         require_valid(validate_identifier(value, field="group_by"))
         return value
 
+    @field_validator("vector_name")
+    @classmethod
+    def _vector_name(cls, value: str | None) -> str | None:
+        if value is not None:
+            require_valid(validate_identifier(value, field="vector_name"))
+        return value
+
 
 class RecallCheckRequest(DenseSearchRequest):
     minimum_recall: float = 0.95
@@ -313,6 +345,7 @@ def _recall(cls, value: float) -> float:
 
 class TextHybridSearchRequest(ContextRequest):
     collection: str
+    vector_name: str | None = None
     embedding: list[float]
     query: str = Field(min_length=1)
     limit: int = Field(default=10, ge=1, le=MAX_RANKED_LIMIT)
@@ -323,6 +356,13 @@ def _embedding(cls, value: list[float]) -> list[float]:
         require_valid(validate_embedding(value))
         return value
 
+    @field_validator("vector_name")
+    @classmethod
+    def _vector_name(cls, value: str | None) -> str | None:
+        if value is not None:
+            require_valid(validate_identifier(value, field="vector_name"))
+        return value
+
 
 class GraphStart(ContextRequest):
     schema_name: str = Field(alias="schema")
@@ -639,6 +679,25 @@ class PreflightResponse(ContextResponse):
     ownership: PreflightOwnership
 
 
+class ContextCollectionVector(ContextResponse):
+    id: UUID
+    name: str
+    column_name: str
+    is_default: bool
+    owns_vector_column: bool
+    vector_type_owner: Literal["pgcontext", "pgvector"] = "pgcontext"
+    dimensions: int
+    metric: ContextMetric
+    index_kind: ContextIndexKind
+    index_name: str | None
+    owns_index: bool
+    index_status: ContextIndexStatus | str
+    last_error_code: str | None
+    last_error_stage: str | None
+    created_at: datetime
+    updated_at: datetime
+
+
 class ContextCollection(ContextResponse):
     id: UUID
     project_id: str
@@ -651,21 +710,13 @@ class ContextCollection(ContextResponse):
     source_key_type: str
     source_mode: ContextSourceMode
     owns_source_table: bool
-    owns_vector_column: bool
-    vector_name: str
-    vector_column: str
-    vector_type_owner: Literal["pgcontext", "pgvector"] = "pgcontext"
-    dimensions: int
-    metric: ContextMetric
+    default_vector_name: str
+    vectors: list[ContextCollectionVector]
     max_search_limit: int
     text_column: str | None
     result_columns: list[str]
     filter_columns: list[str]
     jsonb_filter_paths: list[dict[str, Any]]
-    index_kind: ContextIndexKind
-    index_name: str | None
-    owns_index: bool
-    index_status: ContextIndexStatus | str
     point_reconciliation_status: ContextPointReconciliationStatus | str
     mapped_point_count: int | None
     last_reconciled_at: datetime | None
@@ -684,9 +735,9 @@ class CollectionListResponse(ContextResponse):
 
 class DeletionPlan(ContextResponse):
     pgcontext_collection: str
-    drop_owned_index: str | None
+    drop_owned_indexes: list[str]
     preserve_source_table: str
-    preserve_source_column: str
+    preserve_source_columns: list[str]
     preserve_indexes: list[str]
 
 
@@ -738,7 +789,7 @@ class CollectionStatusResponse(ContextResponse):
     collection_name: str
     status: ContextCollectionStatus | str
     serving_status: ContextServingStatus | str
-    index_status: ContextIndexStatus | str
+    vectors: list[ContextCollectionVector]
     point_reconciliation_status: ContextPointReconciliationStatus | str
     mapped_point_count: int | None
     last_reconciled_at: datetime | None
@@ -1089,6 +1140,7 @@ class RecallCheckResponse(ContextResponse):
     DiscoveryRequest,
     ContextSourceRequest,
     ContextVectorRequest,
+    ContextVectorCreateRequest,
     JsonbFilterPathRequest,
     CollectionCreateRequest,
     CollectionSetDefaultRequest,
@@ -1155,6 +1207,7 @@ class RecallCheckResponse(ContextResponse):
     PreflightCheck,
     PreflightBlocker,
     PreflightOwnership,
+    ContextCollectionVector,
     DeletionPlan,
     ContextOperationFailure,
     VerificationCheck,