synth-ai 0.19.0.dev623__tar.gz → 0.20.0.dev628__tar.gz

{synth_ai-0.19.0.dev623 → synth_ai-0.20.0.dev628}/MANIFEST.in

@@ -1,5 +1,8 @@
 include README.md
 include LICENSE
+include openapi/index-v1.json
+include openapi/research-v1.json
+include openapi/messaging-v1.json
 recursive-include synth_ai *.py
 recursive-include synth_ai *.md
 # Prune heavy example/demo/test/data trees from the sdist (keep code)

{synth_ai-0.19.0.dev623/synth_ai.egg-info → synth_ai-0.20.0.dev628}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.19.0.dev623
+Version: 0.20.0.dev628
 Summary: Python SDK and CLI for Synth Managed Research and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT
@@ -14,6 +14,8 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pynacl>=1.5.0
 Requires-Dist: click<8.2,>=8.1.7
 Requires-Dist: httpx>=0.28.1
+Provides-Extra: pools
+Requires-Dist: synth-containers<0.5,>=0.4.3.dev2026091126; extra == "pools"
 Provides-Extra: dev
 Requires-Dist: build>=1.2.2.post1; extra == "dev"
 Requires-Dist: twine>=4.0.0; extra == "dev"
@@ -27,7 +29,7 @@ Dynamic: license-file
 
 # Synth AI SDK
 
-<!-- CI release pins: PyPI-0.19.0-orange synth-ai==0.19.0 -->
+<!-- CI release pins: PyPI-0.20.0-orange synth-ai==0.20.0 -->
 
 [![PyPI version](https://img.shields.io/pypi/v/synth-ai.svg)](https://pypi.org/project/synth-ai/)
 [![License](https://img.shields.io/pypi/l/synth-ai.svg)](https://pypi.org/project/synth-ai/)
@@ -167,6 +169,32 @@ CLI discovery:
 synth-ai research --help
 ```
 
+Project creation also accepts the backend-owned `ProjectSpec.policy` mapping.
+For example, a server-enabled fresh project can request
+`policy={"host_resource_custody_mode": "horizons_docker_sessions_only"}`.
+The backend validates this restricted mode and owns its immutable resource
+binding; SDK serialization does not grant additional authority.
+
+## Container pools
+
+The optional `synth-ai[pools]` extra exposes the canonical `synth-containers`
+client through `AsyncSynthClient.pools`. It uses the same configured backend
+credential and keeps hosted admission, resource ownership, and recovery in the
+backend. The enclosing async client closes the pool transport.
+
+```python
+from synth_ai import AsyncSynthClient
+
+async def inspect_lease(lease_id: str, task_id: str):
+    async with AsyncSynthClient() as client:
+        return await client.pools.get_lease_interactive(lease_id, task_id=task_id)
+```
+
+For explicit lifetime management, `from synth_ai.pools import PoolClient`
+re-exports the same implementation. Research-only installations do not import
+this optional dependency. Development candidates must install the exact pinned
+containers wheel; an unpublished candidate extra is not a release claim.
+
 ## CLI
 
 ```bash

{synth_ai-0.19.0.dev623 → synth_ai-0.20.0.dev628}/README.md

@@ -1,6 +1,6 @@
 # Synth AI SDK
 
-<!-- CI release pins: PyPI-0.19.0-orange synth-ai==0.19.0 -->
+<!-- CI release pins: PyPI-0.20.0-orange synth-ai==0.20.0 -->
 
 [![PyPI version](https://img.shields.io/pypi/v/synth-ai.svg)](https://pypi.org/project/synth-ai/)
 [![License](https://img.shields.io/pypi/l/synth-ai.svg)](https://pypi.org/project/synth-ai/)
@@ -140,6 +140,32 @@ CLI discovery:
 synth-ai research --help
 ```
 
+Project creation also accepts the backend-owned `ProjectSpec.policy` mapping.
+For example, a server-enabled fresh project can request
+`policy={"host_resource_custody_mode": "horizons_docker_sessions_only"}`.
+The backend validates this restricted mode and owns its immutable resource
+binding; SDK serialization does not grant additional authority.
+
+## Container pools
+
+The optional `synth-ai[pools]` extra exposes the canonical `synth-containers`
+client through `AsyncSynthClient.pools`. It uses the same configured backend
+credential and keeps hosted admission, resource ownership, and recovery in the
+backend. The enclosing async client closes the pool transport.
+
+```python
+from synth_ai import AsyncSynthClient
+
+async def inspect_lease(lease_id: str, task_id: str):
+    async with AsyncSynthClient() as client:
+        return await client.pools.get_lease_interactive(lease_id, task_id=task_id)
+```
+
+For explicit lifetime management, `from synth_ai.pools import PoolClient`
+re-exports the same implementation. Research-only installations do not import
+this optional dependency. Development candidates must install the exact pinned
+containers wheel; an unpublished candidate extra is not a release claim.
+
 ## CLI
 
 ```bash