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

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

@@ -23,7 +23,7 @@ python tools/generate_runtime_openapi_snapshot.py --check
 python tools/generate_sdk_method_spec.py --check
 python tools/generate_sdk_method_spec.py --validate-only
 python tools/check_sdk_compatibility.py \
-  --baseline compatibility/0.2.1/python-sdk-v1.methods.json
+  --baseline compatibility/0.3.0/python-sdk-v1.methods.json
 python -m build
 python tools/verify_distribution.py dist/*.whl dist/*.tar.gz
 ```
@@ -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.3.0
+     polygres-sdk==0.4.0
    /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.3.0
-git push origin polygres-sdk-v0.3.0
+git tag polygres-sdk-v0.4.0
+git push origin polygres-sdk-v0.4.0
 ```
 
 The `pypi` GitHub environment must be approved before the upload proceeds.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: polygres-sdk
-Version: 0.3.0
+Version: 0.4.0
 Summary: Python SDK for Polygres
 Project-URL: Homepage, https://polygres.com
 Project-URL: Documentation, https://docs.polygres.com/sdk
@@ -81,6 +81,23 @@ print(readiness.graph, readiness.vector, readiness.hybrid)
 
 Use the Runtime API URL with the SDK. Do not use a direct or pooled PostgreSQL connection string.
 
+## Synchronized PostgreSQL projects
+
+For a synchronized project, the Runtime does not expose connection information.
+That surface raises `PolygresPermissionError` with code
+`SYNCED_PROJECT_SURFACE_UNAVAILABLE`. Readiness, `project.vector`,
+`project.hybrid`, graph, text-search, and pgContext remain available after
+synchronization is ready.
+
+If your application already has the authoritative control-plane project payload,
+pass its mode to the SDK to reject a connection-information call before building
+a Runtime request. The Runtime enforces the same boundary when no mode hint is
+supplied.
+
+```python
+project = client.project(project_mode="synced")
+```
+
 ## Choose a retrieval method
 
 | Need | Method |
@@ -97,6 +114,41 @@ New vector setup uses `project.context.create_collection()` with a native
 `pgcontext.vector` column. Existing `project.vector` retrieval methods remain available
 for applications using previously registered vector configurations.
 
+## pgContext-aligned names
+
+SDK 0.4.0 adds pgContext 0.2.0 terminology while keeping every SDK 0.3.0
+Context method available. Existing applications can upgrade without changing
+their calls.
+
+The stable pgContext 0.2.0 inventory is fully classified and has no missing SDK
+entries. Database-native vector operators remain SQL-only, and five
+backend-wide or privileged instrumentation functions remain available through
+direct SQL rather than the project-scoped Runtime API. See the
+[migration and coverage notes](migrations/pgcontext-0.2.0-names.md).
+
+```python
+operation = project.context.register_vector(
+    collection_id,
+    "title_embedding",
+    768,
+)
+project.context.register_filter_column(
+    collection_id,
+    "tenant_id",
+    "tenant_id",
+)
+results = project.context.query(
+    "support_docs",
+    query_embedding,
+    query="refund policy",
+)
+```
+
+The earlier `add_vector()`, `add_filter_column()`, and `text_hybrid()` names
+remain silent compatibility aliases with unchanged behavior. See the
+[pgContext naming migration](migrations/pgcontext-0.2.0-names.md) for the full
+mapping.
+
 ## Vector retrieval
 
 Generate the query embedding with the same model and dimensions used by the saved vector configuration.
@@ -274,7 +326,9 @@ Keep the request ID when reporting a problem. Never log or send the Project API
 
 ## Connection information
 
-`connection_info()` returns project hosts and passwordless connection strings. It never returns the database password.
+For a standard project, `connection_info()` returns project hosts and passwordless
+connection strings. It never returns the database password. It raises
+`PolygresPermissionError` for a synchronized project.
 
 ```python
 connection = project.connection_info()
@@ -311,11 +365,11 @@ payload and idempotency key.
 
 ## Version and support
 
-Package version: [`0.3.0`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.3.0).
+Package version: [`0.4.0`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0).
 
 When contacting support, include the installed SDK version and the request ID.
 
-See the [SDK 0.3.0 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.3.0) for release changes.
+See the [SDK 0.4.0 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0) for release changes.
 
 ## Optional Agent Skill
 

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

@@ -39,6 +39,23 @@ print(readiness.graph, readiness.vector, readiness.hybrid)
 
 Use the Runtime API URL with the SDK. Do not use a direct or pooled PostgreSQL connection string.
 
+## Synchronized PostgreSQL projects
+
+For a synchronized project, the Runtime does not expose connection information.
+That surface raises `PolygresPermissionError` with code
+`SYNCED_PROJECT_SURFACE_UNAVAILABLE`. Readiness, `project.vector`,
+`project.hybrid`, graph, text-search, and pgContext remain available after
+synchronization is ready.
+
+If your application already has the authoritative control-plane project payload,
+pass its mode to the SDK to reject a connection-information call before building
+a Runtime request. The Runtime enforces the same boundary when no mode hint is
+supplied.
+
+```python
+project = client.project(project_mode="synced")
+```
+
 ## Choose a retrieval method
 
 | Need | Method |
@@ -55,6 +72,41 @@ New vector setup uses `project.context.create_collection()` with a native
 `pgcontext.vector` column. Existing `project.vector` retrieval methods remain available
 for applications using previously registered vector configurations.
 
+## pgContext-aligned names
+
+SDK 0.4.0 adds pgContext 0.2.0 terminology while keeping every SDK 0.3.0
+Context method available. Existing applications can upgrade without changing
+their calls.
+
+The stable pgContext 0.2.0 inventory is fully classified and has no missing SDK
+entries. Database-native vector operators remain SQL-only, and five
+backend-wide or privileged instrumentation functions remain available through
+direct SQL rather than the project-scoped Runtime API. See the
+[migration and coverage notes](migrations/pgcontext-0.2.0-names.md).
+
+```python
+operation = project.context.register_vector(
+    collection_id,
+    "title_embedding",
+    768,
+)
+project.context.register_filter_column(
+    collection_id,
+    "tenant_id",
+    "tenant_id",
+)
+results = project.context.query(
+    "support_docs",
+    query_embedding,
+    query="refund policy",
+)
+```
+
+The earlier `add_vector()`, `add_filter_column()`, and `text_hybrid()` names
+remain silent compatibility aliases with unchanged behavior. See the
+[pgContext naming migration](migrations/pgcontext-0.2.0-names.md) for the full
+mapping.
+
 ## Vector retrieval
 
 Generate the query embedding with the same model and dimensions used by the saved vector configuration.
@@ -232,7 +284,9 @@ Keep the request ID when reporting a problem. Never log or send the Project API
 
 ## Connection information
 
-`connection_info()` returns project hosts and passwordless connection strings. It never returns the database password.
+For a standard project, `connection_info()` returns project hosts and passwordless
+connection strings. It never returns the database password. It raises
+`PolygresPermissionError` for a synchronized project.
 
 ```python
 connection = project.connection_info()
@@ -269,11 +323,11 @@ payload and idempotency key.
 
 ## Version and support
 
-Package version: [`0.3.0`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.3.0).
+Package version: [`0.4.0`](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0).
 
 When contacting support, include the installed SDK version and the request ID.
 
-See the [SDK 0.3.0 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.3.0) for release changes.
+See the [SDK 0.4.0 release notes](https://github.com/Evokoa/polygres-sdk/releases/tag/polygres-sdk-v0.4.0) for release changes.
 
 ## Optional Agent Skill
 

polygres_sdk-0.4.0/compatibility/0.3.0/README.md

@@ -0,0 +1,10 @@
+# SDK compatibility baseline 0.3.0
+
+`python-sdk-v1.methods.json` is the explicit released SDK 0.3.0 public network
+surface. It is copied byte-for-byte from the generated method contract at the
+0.3.0 release boundary.
+
+SDK 0.4.0 compatibility and release checks must name this file with
+`--baseline`. The compatibility tool must classify the pgContext-aligned method
+names as additive and must report no removals or breaking changes to this
+baseline.