polygres-sdk 0.4.0__tar.gz → 0.4.1__tar.gz

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/CONTRIBUTING.md

@@ -60,7 +60,7 @@ Release rehearsal happens first on TestPyPI:
    /tmp/polygres-sdk-testpypi/bin/python -m pip install \
      --index-url https://test.pypi.org/simple/ \
      --extra-index-url https://pypi.org/simple/ \
-     polygres-sdk==0.4.0
+     polygres-sdk==0.4.1
    /tmp/polygres-sdk-testpypi/bin/python - <<'PY'
    import importlib.metadata
    from polygres import Polygres
@@ -74,8 +74,8 @@ Publish to PyPI only after the same commit has passed TestPyPI validation. Push
 a release tag from the public repository:
 
 ```bash
-git tag polygres-sdk-v0.4.0
-git push origin polygres-sdk-v0.4.0
+git tag polygres-sdk-v0.4.1
+git push origin polygres-sdk-v0.4.1
 ```
 
 The `pypi` GitHub environment must be approved before the upload proceeds.

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: polygres-sdk
-Version: 0.4.0
+Version: 0.4.1
 Summary: Python SDK for Polygres
 Project-URL: Homepage, https://polygres.com
 Project-URL: Documentation, https://docs.polygres.com/sdk
@@ -365,11 +365,11 @@ payload and idempotency key.
 
 ## Version and support
 
-Package version: [`0.4.0`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0).
+Package version: [`0.4.1`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.1).
 
 When contacting support, include the installed SDK version and the request ID.
 
-See the [SDK 0.4.0 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0) for release changes.
+See the [SDK 0.4.1 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.1) for release changes.
 
 ## Optional Agent Skill
 

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/README.md

@@ -323,11 +323,11 @@ payload and idempotency key.
 
 ## Version and support
 
-Package version: [`0.4.0`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0).
+Package version: [`0.4.1`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.1).
 
 When contacting support, include the installed SDK version and the request ID.
 
-See the [SDK 0.4.0 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0) for release changes.
+See the [SDK 0.4.1 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.1) for release changes.
 
 ## Optional Agent Skill
 

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/docs/reference-v1.md

@@ -2,7 +2,7 @@
 
 This file is generated. Edit Python method metadata, docstrings, or the Runtime OpenAPI contract instead.
 
-- SDK package version: `0.4.0`
+- SDK package version: `0.4.1`
 - HTTP API family: `v1`
 - Default API behavior version: `2026-08-04`
 - Method specification schema: `1`

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "polygres-sdk"
-version = "0.4.0"
+version = "0.4.1"
 description = "Python SDK for Polygres"
 readme = "README.md"
 requires-python = ">=3.10"

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/src/polygres/_vendor/polygres_lib/auth/enums.py

@@ -257,6 +257,16 @@ class ProjectMode(str, Enum):
     SYNCED = "synced"
 
 
+class ProjectDataSource(str, Enum):
+    """The data-source option selected when a project is created."""
+
+    NEON = "neon"
+    SUPABASE = "supabase"
+    PLANETSCALE = "planetscale"
+    POSTGRES = "postgres"
+    POLYGRES = "polygres"
+
+
 class ProjectApiKeyScope(str, Enum):
     PROJECT_FULL = "project_full"
     SYNCED_PROJECT = "synced_project"
@@ -377,6 +387,7 @@ class PolicyId(str, Enum):
     PORTAL_SESSION = "portal_session"
     DASHBOARD_ONLY = "dashboard_only"
     DASHBOARD_OR_CLI = "dashboard_or_cli"
+    CLI_ACCESS_USER = "cli_access_user"
     ACTIVE_ACCOUNT = "active_account"
     ADMIN_OPERATOR = "admin_operator"
     ORGANIZATION_MEMBER = "organization_member"

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/src/polygres/_vendor/polygres_lib/errors/generated.py

@@ -1037,6 +1037,20 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'reset_class': 'none',
   'cli_exit_code': 2,
   'variants': {}},
+ {'code': 'CONTEXT_COLLECTION_SYNC_FAILED',
+  'family': 'context',
+  'category': 'dependency',
+  'kind': ['public', 'persisted_operation'],
+  'visibility': 'public',
+  'http_status': 500,
+  'message': 'Context collection sync failed. Retry the operation. If it fails again, contact '
+             'support with the operation ID.',
+  'message_key': 'polygres.error.context_collection_sync_failed',
+  'safe_detail_fields': ['failure_stage', 'operation_id', 'underlying_code'],
+  'retry_class': 'after_delay',
+  'reset_class': 'none',
+  'cli_exit_code': 8,
+  'variants': {}},
  {'code': 'CONTEXT_COLLECTION_TARGET_MISMATCH',
   'family': 'context',
   'category': 'validation',
@@ -1306,12 +1320,12 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
  {'code': 'CONTEXT_HNSW_UNSUPPORTED',
   'family': 'context',
   'category': 'conflict',
-  'kind': ['public'],
+  'kind': ['public', 'persisted_operation'],
   'visibility': 'public',
   'http_status': 409,
   'message': 'Hnsw unsupported.',
   'message_key': 'polygres.error.context_hnsw_unsupported',
-  'safe_detail_fields': ['field'],
+  'safe_detail_fields': ['failure_stage', 'field', 'operation_id'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
@@ -1372,6 +1386,34 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
                                                                           'constraint and cannot '
                                                                           'be converted safely.',
                                                                'http_status': 409}}},
+ {'code': 'CONTEXT_INDEX_CORRUPT',
+  'family': 'context',
+  'category': 'dependency',
+  'kind': ['public', 'persisted_operation'],
+  'visibility': 'public',
+  'http_status': 500,
+  'message': 'The Context index failed its integrity check. Rebuild the index. If rebuilding '
+             'fails, contact support with the operation ID.',
+  'message_key': 'polygres.error.context_index_corrupt',
+  'safe_detail_fields': ['failure_stage', 'operation_id'],
+  'retry_class': 'after_user_action',
+  'reset_class': 'none',
+  'cli_exit_code': 8,
+  'variants': {}},
+ {'code': 'CONTEXT_INDEX_MEMORY_BUDGET_EXCEEDED',
+  'family': 'context',
+  'category': 'conflict',
+  'kind': ['public', 'persisted_operation'],
+  'visibility': 'public',
+  'http_status': 409,
+  'message': 'The HNSW index needs more build memory than this project currently allows. Contact '
+             'support with the operation ID to increase the index-build budget, then retry.',
+  'message_key': 'polygres.error.context_index_memory_budget_exceeded',
+  'safe_detail_fields': ['failure_stage', 'operation_id'],
+  'retry_class': 'after_user_action',
+  'reset_class': 'none',
+  'cli_exit_code': 6,
+  'variants': {}},
  {'code': 'CONTEXT_INDEX_MISSING',
   'family': 'context',
   'category': 'conflict',
@@ -1397,7 +1439,7 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'http_status': 409,
   'message': 'Context index not ready.',
   'message_key': 'polygres.error.context_index_not_ready',
-  'safe_detail_fields': [],
+  'safe_detail_fields': ['failure_stage', 'operation_id'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
@@ -1449,7 +1491,7 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'http_status': 400,
   'message': 'Context request exceeds a limit.',
   'message_key': 'polygres.error.context_limit_exceeded',
-  'safe_detail_fields': ['field', 'limit'],
+  'safe_detail_fields': ['failure_stage', 'field', 'limit', 'operation_id'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 2,
@@ -1462,18 +1504,24 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
  {'code': 'CONTEXT_MEMORY_PRESSURE',
   'family': 'context',
   'category': 'conflict',
-  'kind': ['public'],
+  'kind': ['public', 'persisted_operation'],
   'visibility': 'public',
   'http_status': 409,
   'message': 'Memory pressure.',
   'message_key': 'polygres.error.context_memory_pressure',
-  'safe_detail_fields': ['field', 'project_id'],
+  'safe_detail_fields': ['failure_stage', 'field', 'operation_id', 'project_id'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
   'variants': {'context_heavy_work_blocked_by_project': {'message': 'Context heavy work is blocked '
                                                                     'by project memory pressure.',
-                                                         'http_status': 409}}},
+                                                         'http_status': 409},
+               'context_operation_database_memory_exhausted': {'message': 'The Context operation '
+                                                                          'stopped because the '
+                                                                          'project database ran '
+                                                                          'out of available '
+                                                                          'memory.',
+                                                               'http_status': 503}}},
  {'code': 'CONTEXT_ONBOARDING_NOT_AVAILABLE',
   'family': 'context',
   'category': 'conflict',
@@ -1612,7 +1660,7 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'http_status': 500,
   'message': 'The Context operation could not be completed.',
   'message_key': 'polygres.error.context_operation_failed',
-  'safe_detail_fields': ['operation_id', 'underlying_code'],
+  'safe_detail_fields': ['failure_stage', 'operation_id', 'underlying_code'],
   'retry_class': 'after_delay',
   'reset_class': 'none',
   'cli_exit_code': 8,
@@ -1699,6 +1747,19 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
                'dispatch_attempts_exhausted': {'message': 'The Context operation could not be '
                                                           'scheduled after several attempts.',
                                                'http_status': 500}}},
+ {'code': 'CONTEXT_OPERATION_TIMED_OUT',
+  'family': 'context',
+  'category': 'dependency',
+  'kind': ['public', 'persisted_operation'],
+  'visibility': 'public',
+  'http_status': 504,
+  'message': 'The Context operation exceeded the processing time limit. Retry the operation.',
+  'message_key': 'polygres.error.context_operation_timed_out',
+  'safe_detail_fields': ['failure_stage', 'operation_id'],
+  'retry_class': 'after_delay',
+  'reset_class': 'none',
+  'cli_exit_code': 8,
+  'variants': {}},
  {'code': 'CONTEXT_OUTBOX_PUBLICATION_FAILED',
   'family': 'context',
   'category': 'dependency',
@@ -1945,7 +2006,7 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'http_status': 409,
   'message': 'Result column invalid.',
   'message_key': 'polygres.error.context_result_column_invalid',
-  'safe_detail_fields': ['field'],
+  'safe_detail_fields': ['failure_stage', 'field', 'operation_id'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
@@ -2167,7 +2228,7 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'message': 'Polygres does not have the source-table permissions required to read data and '
              'install synchronization triggers.',
   'message_key': 'polygres.error.context_source_privilege_required',
-  'safe_detail_fields': ['field'],
+  'safe_detail_fields': ['failure_stage', 'field', 'operation_id'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
@@ -2207,7 +2268,7 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'http_status': 409,
   'message': 'The Context collection source table is unavailable.',
   'message_key': 'polygres.error.context_source_unavailable',
-  'safe_detail_fields': ['reason', 'schema', 'table'],
+  'safe_detail_fields': ['failure_stage', 'operation_id', 'reason', 'schema', 'table'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
@@ -2219,16 +2280,29 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
  {'code': 'CONTEXT_SOURCE_VECTOR_INVALID',
   'family': 'context',
   'category': 'conflict',
-  'kind': ['public'],
+  'kind': ['public', 'persisted_operation'],
   'visibility': 'public',
   'http_status': 409,
   'message': 'One or more source vectors are invalid.',
   'message_key': 'polygres.error.context_source_vector_invalid',
-  'safe_detail_fields': ['collection_id', 'count', 'reason'],
+  'safe_detail_fields': ['collection_id', 'count', 'failure_stage', 'operation_id', 'reason'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
   'variants': {}},
+ {'code': 'CONTEXT_STORAGE_PRESSURE',
+  'family': 'context',
+  'category': 'dependency',
+  'kind': ['public', 'persisted_operation'],
+  'visibility': 'public',
+  'http_status': 503,
+  'message': 'The Context operation stopped because the project database ran out of storage.',
+  'message_key': 'polygres.error.context_storage_pressure',
+  'safe_detail_fields': ['failure_stage', 'operation_id'],
+  'retry_class': 'after_user_action',
+  'reset_class': 'none',
+  'cli_exit_code': 8,
+  'variants': {}},
  {'code': 'CONTEXT_SYNC_TRIGGER_UNAVAILABLE',
   'family': 'context',
   'category': 'conflict',
@@ -2372,7 +2446,7 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'message': 'The vector column type is not supported for this collection. Use a native pgContext '
              'vector or a compatible pgvector column.',
   'message_key': 'polygres.error.context_vector_type_unsupported',
-  'safe_detail_fields': ['field'],
+  'safe_detail_fields': ['failure_stage', 'field', 'operation_id'],
   'retry_class': 'after_user_action',
   'reset_class': 'none',
   'cli_exit_code': 6,
@@ -3031,7 +3105,9 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'message_key': 'polygres.error.data_plane_connection_failed',
   'safe_detail_fields': ['connection',
                          'database',
+                         'failure_stage',
                          'host',
+                         'operation_id',
                          'port',
                          'project_external_id',
                          'reason',
@@ -3040,7 +3116,11 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'retry_class': 'after_delay',
   'reset_class': 'none',
   'cli_exit_code': 8,
-  'variants': {}},
+  'variants': {'context_operation_connection_lost': {'message': 'Connection to the project '
+                                                                'database was lost during the '
+                                                                'Context operation. Retry the '
+                                                                'operation.',
+                                                     'http_status': 503}}},
  {'code': 'DATA_PLANE_CONNECTION_INVALID',
   'family': 'data_plane',
   'category': 'dependency',
@@ -7401,6 +7481,19 @@ ERROR_CATALOG_DATA: tuple[dict[str, object], ...] = tuple([{'code': 'ACCOUNT_CRE
   'reset_class': 'none',
   'cli_exit_code': 8,
   'variants': {}},
+ {'code': 'RUNTIME_JOINT_QUERY_BUSY',
+  'family': 'runtime',
+  'category': 'dependency',
+  'kind': ['public'],
+  'visibility': 'public',
+  'http_status': 503,
+  'message': 'Hybrid retrieval is busy. Try again shortly.',
+  'message_key': 'polygres.error.runtime_joint_query_busy',
+  'safe_detail_fields': ['retry_after_seconds'],
+  'retry_class': 'after_delay',
+  'reset_class': 'none',
+  'cli_exit_code': 8,
+  'variants': {}},
  {'code': 'RUNTIME_KEY_SYNC_FAILED',
   'family': 'runtime',
   'category': 'dependency',

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/src/polygres/spec/python-sdk-v1.methods.json

@@ -8079,5 +8079,5 @@
   "openapi_sha256": "db23d7178d295d7bac0b5168061c59fcbcf6eb96e1e12bc2e21670452b8cb506",
   "schema_version": 1,
   "sdk": "polygres-sdk",
-  "sdk_version": "0.4.0"
+  "sdk_version": "0.4.1"
 }

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/tests/test_release_workflow.py

@@ -95,11 +95,11 @@ def test_publish_workflow_creates_release_after_pypi() -> None:
     assert "releases/latest" in workflow
 
 
-def test_publish_workflow_checks_the_0_4_0_release_against_0_3_0() -> None:
+def test_publish_workflow_checks_the_0_4_1_release_against_0_3_0() -> None:
     workflow = (ROOT / ".github" / "workflows" / "publish-python-sdk.yml").read_text(
         encoding="utf-8"
     )
 
     assert "--baseline compatibility/0.3.0/python-sdk-v1.methods.json" in workflow
-    assert "--expect-current-version 0.4.0" in workflow
+    assert "--expect-current-version 0.4.1" in workflow
     assert "--baseline compatibility/0.2.1/python-sdk-v1.methods.json" not in workflow

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/tests/test_version.py

@@ -26,12 +26,12 @@ def test_release_metadata_and_documentation_name_current_sdk_version() -> None:
         )
     )
 
-    assert __version__ == "0.4.0"
-    assert methods["sdk_version"] == "0.4.0"
-    assert "Package version: [`0.4.0`]" in readme
-    assert "polygres-sdk-v0.4.0" in readme
-    assert "SDK 0.4.0 release notes" in readme
-    assert "## 0.4.0 - 2026-08-16" in changelog
+    assert __version__ == "0.4.1"
+    assert methods["sdk_version"] == "0.4.1"
+    assert "Package version: [`0.4.1`]" in readme
+    assert "polygres-sdk-v0.4.1" in readme
+    assert "SDK 0.4.1 release notes" in readme
+    assert "## 0.4.1 - 2026-08-25" in changelog
 
 
 def test_uninstalled_source_uses_non_release_fallback(monkeypatch: pytest.MonkeyPatch) -> None:

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/tests/test_version_notices.py

@@ -207,4 +207,4 @@ def test_sdk_does_not_emit_notice_from_an_intermediate_retry(
 
 
 def test_public_sdk_version_matches_current_release() -> None:
-    assert __version__ == "0.4.0"
+    assert __version__ == "0.4.1"

{polygres_sdk-0.4.0 → polygres_sdk-0.4.1}/tools/check_pgcontext_compatibility.py

@@ -40,14 +40,16 @@ def _load_json(path: Path) -> dict[str, Any]:
 def _arguments() -> argparse.Namespace:
     package_root = Path(__file__).resolve().parents[1]
     repository_root = package_root.parents[1]
+    packaged_manifest = package_root / "src/polygres/spec/pgcontext-0.2.0-compatibility.json"
+    repository_manifest = (
+        repository_root
+        / "packages/polygres-lib/contracts/context/pgcontext-0.2.0-compatibility.json"
+    )
     parser = argparse.ArgumentParser()
     parser.add_argument(
         "--manifest",
         type=Path,
-        default=(
-            repository_root
-            / "packages/polygres-lib/contracts/context/pgcontext-0.2.0-compatibility.json"
-        ),
+        default=(repository_manifest if repository_manifest.exists() else packaged_manifest),
     )
     parser.add_argument(
         "--method-spec",
@@ -57,7 +59,7 @@ def _arguments() -> argparse.Namespace:
     parser.add_argument(
         "--packaged-manifest",
         type=Path,
-        default=package_root / "src/polygres/spec/pgcontext-0.2.0-compatibility.json",
+        default=packaged_manifest,
     )
     return parser.parse_args()