synth-ai 0.22.2.dev682__tar.gz → 0.22.2.dev684__tar.gz

{synth_ai-0.22.2.dev682/synth_ai.egg-info → synth_ai-0.22.2.dev684}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.22.2.dev682
+Version: 0.22.2.dev684
 Summary: Python SDK, CLI and MCP servers for Synth Index search and Swarms
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT
@@ -15,6 +15,7 @@ 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
+Requires-Dist: jsonschema<5,>=4.18
 Provides-Extra: pools
 Requires-Dist: synth-containers<0.5,>=0.4.3.dev2026091126; extra == "pools"
 Provides-Extra: dev
@@ -192,6 +193,23 @@ synth-ai index --help      # Synth Index Search and research intake
 synth-ai research --help   # Swarms and Research projects
 ```
 
+Swarm launches take explicit deployment receipts, provenance mode, resource
+inventory and a finite budget limit:
+
+```bash
+synth-ai research swarms start --objective "Review the retained research" \
+  --deployment-pins deployment-pins.json --provenance-mode live \
+  --resource-bindings resource-bindings.json --budget-limit-usd 2
+```
+
+`deployment-pins.json` contains exactly `{"deployment_pins": [...]}`, with
+receipts from the deployed services (`DeploymentPin.to_wire()`).
+`resource-bindings.json` contains the three explicit arrays `model_file_ids`,
+`external_repository_ids` and `credential_ref_ids`; empty arrays select none.
+Files are limited to 64 KiB. Duplicate or unknown fields, unqualified timestamps,
+and invalid budget values refuse before a client opens. `dry_run` remains an
+explicit provenance mode; the backend validates the authority of every receipt.
+
 ## Synth Index
 
 Index Search returns a cited `response` plus the exact Contribution revisions it

{synth_ai-0.22.2.dev682 → synth_ai-0.22.2.dev684}/README.md

@@ -162,6 +162,23 @@ synth-ai index --help      # Synth Index Search and research intake
 synth-ai research --help   # Swarms and Research projects
 ```
 
+Swarm launches take explicit deployment receipts, provenance mode, resource
+inventory and a finite budget limit:
+
+```bash
+synth-ai research swarms start --objective "Review the retained research" \
+  --deployment-pins deployment-pins.json --provenance-mode live \
+  --resource-bindings resource-bindings.json --budget-limit-usd 2
+```
+
+`deployment-pins.json` contains exactly `{"deployment_pins": [...]}`, with
+receipts from the deployed services (`DeploymentPin.to_wire()`).
+`resource-bindings.json` contains the three explicit arrays `model_file_ids`,
+`external_repository_ids` and `credential_ref_ids`; empty arrays select none.
+Files are limited to 64 KiB. Duplicate or unknown fields, unqualified timestamps,
+and invalid budget values refuse before a client opens. `dry_run` remains an
+explicit provenance mode; the backend validates the authority of every receipt.
+
 ## Synth Index
 
 Index Search returns a cited `response` plus the exact Contribution revisions it