synth-ai 0.20.0.dev633__tar.gz → 0.20.0.dev635__tar.gz

{synth_ai-0.20.0.dev633/synth_ai.egg-info → synth_ai-0.20.0.dev635}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.20.0.dev633
-Summary: Python SDK and CLI for Synth Managed Research and Research Factory
+Version: 0.20.0.dev635
+Summary: Python SDK and CLI for Synth Index, Managed Research, and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/synth-laboratories/synth-ai
@@ -208,11 +208,39 @@ Use `SynthClient` as the front door:
 
 | Surface | Client namespace | Use it for |
 | --- | --- | --- |
+| **Index** | `client.index` | Authenticated, funded FAST/DEEP Search and Contribution lifecycle. |
 | **Research / Factory** | `client.research` | Typed hosted projects, swarms, Factory lifecycles, and Efforts. |
-| CLI | `synth-ai` | Terminal access to Research commands. |
+| CLI / MCP | `synth-ai`, `synth-ai-index-mcp` | Terminal commands and an Index-only coding-agent server. |
 
-There are no infrastructure client namespaces (containers, tunnels, pools) on
-`SynthClient`; the package is Research-only as of 0.18.0.
+Index is an API/MCP product, not a browser search page. Anonymous public
+catalog and known-ID Contribution reads use `PublicIndexClient`; even a
+public-scope Search requires an API key, an authorized organization, and
+funding. An Index-only MCP server starts read-only, advertising public browse
+without a key and Search only when a key is configured. Contribution writes
+require a separate explicit opt-in and grant.
+
+```python
+from uuid import uuid4
+
+from synth_ai import SynthClient
+from synth_ai.sdk.index import SearchBillingConstraints
+
+request_key = str(uuid4())  # Persist this before sending; reuse it on uncertain retry.
+with SynthClient() as synth:  # Reads SYNTH_API_KEY.
+    result = synth.index.search(
+        query="What evidence supports the retrieval design?",
+        mode="fast",
+        billing=SearchBillingConstraints(allow_wallet=True, max_charge_cents=5),
+        idempotency_key=request_key,
+    )
+    print(result.response, result.usage)
+```
+
+FAST's five-cent ceiling is explicit wallet consent, not a claim that DEEP has
+the same price. See the [Index SDK guide](synth_ai/sdk/index/README.md) for
+DEEP's durable Search ID, reconnect/cancel, private collections, receipts, and
+coding-agent MCP setup. These calls require a deployed Index API; installing
+the SDK alone does not make a Search available.
 
 Use [Managed Research](https://docs.usesynth.ai/managed-research/intro) when you
 want hosted research workers, repo runs, evidence, checkpoints, MCP, or final

{synth_ai-0.20.0.dev633 → synth_ai-0.20.0.dev635}/README.md

@@ -179,11 +179,39 @@ Use `SynthClient` as the front door:
 
 | Surface | Client namespace | Use it for |
 | --- | --- | --- |
+| **Index** | `client.index` | Authenticated, funded FAST/DEEP Search and Contribution lifecycle. |
 | **Research / Factory** | `client.research` | Typed hosted projects, swarms, Factory lifecycles, and Efforts. |
-| CLI | `synth-ai` | Terminal access to Research commands. |
+| CLI / MCP | `synth-ai`, `synth-ai-index-mcp` | Terminal commands and an Index-only coding-agent server. |
 
-There are no infrastructure client namespaces (containers, tunnels, pools) on
-`SynthClient`; the package is Research-only as of 0.18.0.
+Index is an API/MCP product, not a browser search page. Anonymous public
+catalog and known-ID Contribution reads use `PublicIndexClient`; even a
+public-scope Search requires an API key, an authorized organization, and
+funding. An Index-only MCP server starts read-only, advertising public browse
+without a key and Search only when a key is configured. Contribution writes
+require a separate explicit opt-in and grant.
+
+```python
+from uuid import uuid4
+
+from synth_ai import SynthClient
+from synth_ai.sdk.index import SearchBillingConstraints
+
+request_key = str(uuid4())  # Persist this before sending; reuse it on uncertain retry.
+with SynthClient() as synth:  # Reads SYNTH_API_KEY.
+    result = synth.index.search(
+        query="What evidence supports the retrieval design?",
+        mode="fast",
+        billing=SearchBillingConstraints(allow_wallet=True, max_charge_cents=5),
+        idempotency_key=request_key,
+    )
+    print(result.response, result.usage)
+```
+
+FAST's five-cent ceiling is explicit wallet consent, not a claim that DEEP has
+the same price. See the [Index SDK guide](synth_ai/sdk/index/README.md) for
+DEEP's durable Search ID, reconnect/cancel, private collections, receipts, and
+coding-agent MCP setup. These calls require a deployed Index API; installing
+the SDK alone does not make a Search available.
 
 Use [Managed Research](https://docs.usesynth.ai/managed-research/intro) when you
 want hosted research workers, repo runs, evidence, checkpoints, MCP, or final

{synth_ai-0.20.0.dev633 → synth_ai-0.20.0.dev635}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "synth-ai"
-version = "0.20.0.dev633"
-description = "Python SDK and CLI for Synth Managed Research and Research Factory"
+version = "0.20.0.dev635"
+description = "Python SDK and CLI for Synth Index, Managed Research, and Research Factory"
 authors = [{name = "Synth AI", email = "josh@usesynth.ai"}]
 license = "MIT"
 license-files = ["LICENSE"]

{synth_ai-0.20.0.dev633 → synth_ai-0.20.0.dev635}/synth_ai/client.py

@@ -7,6 +7,7 @@ from typing import TYPE_CHECKING
 
 from synth_ai.core.auth.credentials import resolve_api_credential
 from synth_ai.core.utils.urls import BACKEND_URL_BASE, normalize_backend_base
+from synth_ai.sdk.index.timeouts import INDEX_TRANSPORT_TIMEOUT_SECONDS
 
 if TYPE_CHECKING:
     from synth_ai.core.http.async_transport import AsyncHttpTransport
@@ -39,11 +40,14 @@ class SynthClient:
         *,
         api_key: str | None = None,
         base_url: str | None = None,
-        timeout_seconds: float = 30.0,
+        timeout_seconds: float | None = None,
     ) -> None:
         self.api_key = _resolve_api_key(api_key)
         self.base_url = _resolve_base_url(base_url)
-        self.timeout_seconds = timeout_seconds
+        self.timeout_seconds = 30.0 if timeout_seconds is None else timeout_seconds
+        self._index_timeout_seconds = (
+            INDEX_TRANSPORT_TIMEOUT_SECONDS if timeout_seconds is None else timeout_seconds
+        )
         self._research_client: ResearchClient | None = None
         self._optimizers_client: OptimizersClient | None = None
         self._index_api: IndexAPI | None = None
@@ -60,7 +64,7 @@ class SynthClient:
             self._index_transport = HttpTransport(
                 base_url=self.base_url,
                 headers={"Authorization": f"Bearer {self.api_key}"},
-                timeout_seconds=self.timeout_seconds,
+                timeout_seconds=self._index_timeout_seconds,
             )
             self._index_api = IndexAPI(self._index_transport)
         return self._index_api
@@ -135,11 +139,14 @@ class AsyncSynthClient:
         *,
         api_key: str | None = None,
         base_url: str | None = None,
-        timeout_seconds: float = 30.0,
+        timeout_seconds: float | None = None,
     ) -> None:
         self.api_key = _resolve_api_key(api_key)
         self.base_url = _resolve_base_url(base_url)
-        self.timeout_seconds = timeout_seconds
+        self.timeout_seconds = 30.0 if timeout_seconds is None else timeout_seconds
+        self._index_timeout_seconds = (
+            INDEX_TRANSPORT_TIMEOUT_SECONDS if timeout_seconds is None else timeout_seconds
+        )
         self._async_research_client: AsyncResearchClient | None = None
         self._async_optimizers_client: AsyncOptimizersClient | None = None
         self._index_api: AsyncIndexAPI | None = None
@@ -157,7 +164,7 @@ class AsyncSynthClient:
             self._index_transport = AsyncHttpTransport(
                 base_url=self.base_url,
                 headers={"Authorization": f"Bearer {self.api_key}"},
-                timeout_seconds=self.timeout_seconds,
+                timeout_seconds=self._index_timeout_seconds,
             )
             self._index_api = AsyncIndexAPI(self._index_transport)
         return self._index_api

{synth_ai-0.20.0.dev633 → synth_ai-0.20.0.dev635}/synth_ai/mcp/research/server.py

@@ -70,6 +70,7 @@ from synth_ai.mcp.research.tools.trained_models import build_trained_model_tools
 from synth_ai.mcp.research.tools.usage import build_usage_tools
 from synth_ai.mcp.research.tools.visuals import build_visual_tools
 from synth_ai.mcp.research.tools.workspace_inputs import build_workspace_input_tools
+from synth_ai.sdk.index.timeouts import INDEX_TRANSPORT_TIMEOUT_SECONDS
 from synth_ai.sdk.research.auth import get_api_key
 from synth_ai.sdk.research.client import Client as CoreResearchClient
 from synth_ai.sdk.research.contracts.activity import ActivityWindow
@@ -91,7 +92,7 @@ MCP_CLIENT_TIMEOUT_SECONDS = 30.0
 # stdio Index calls aligned with PublicIndexClient's 120-second transport bound;
 # an MCP timeout must not prematurely turn a valid monitored response into an
 # ambiguous retry. Research tools retain their separate 30-second default.
-INDEX_MCP_CLIENT_TIMEOUT_SECONDS = 120.0
+INDEX_MCP_CLIENT_TIMEOUT_SECONDS = INDEX_TRANSPORT_TIMEOUT_SECONDS
 
 # The stdio entrypoint advertises the stable subset. Set this to 1/true/yes to
 # advertise the full built tree instead; without it the advanced tools are not

{synth_ai-0.20.0.dev633 → synth_ai-0.20.0.dev635}/synth_ai/sdk/index/public.py

@@ -13,11 +13,7 @@ from synth_ai.core.http.transport import HttpTransport
 from synth_ai.core.utils.urls import BACKEND_URL_BASE, normalize_backend_base
 
 from .client import AsyncPublicIndexAPI, PublicIndexAPI
-
-# See the joined candidate's RUNTIME_DEADLINES.md: the 31.7-second public
-# search wrapper precedes a separately bounded monitor (up to 60 seconds).
-# Explicit caller timeouts still win; disconnect never cancels server state.
-_PUBLIC_INDEX_TIMEOUT_SECONDS = 120.0
+from .timeouts import INDEX_TRANSPORT_TIMEOUT_SECONDS
 
 
 class PublicIndexClient(PublicIndexAPI):
@@ -27,7 +23,7 @@ class PublicIndexClient(PublicIndexAPI):
         self,
         *,
         base_url: str | None = None,
-        timeout_seconds: float = _PUBLIC_INDEX_TIMEOUT_SECONDS,
+        timeout_seconds: float = INDEX_TRANSPORT_TIMEOUT_SECONDS,
     ) -> None:
         transport = HttpTransport(
             base_url=normalize_backend_base(base_url or BACKEND_URL_BASE),
@@ -58,7 +54,7 @@ class AsyncPublicIndexClient(AsyncPublicIndexAPI):
         self,
         *,
         base_url: str | None = None,
-        timeout_seconds: float = _PUBLIC_INDEX_TIMEOUT_SECONDS,
+        timeout_seconds: float = INDEX_TRANSPORT_TIMEOUT_SECONDS,
     ) -> None:
         transport = AsyncHttpTransport(
             base_url=normalize_backend_base(base_url or BACKEND_URL_BASE),

synth_ai-0.20.0.dev635/synth_ai/sdk/index/timeouts.py

@@ -0,0 +1,6 @@
+"""Transport bound shared by direct Index and Index-only MCP clients."""
+
+# The backend's bounded retrieval can be followed by separately bounded
+# monitor delivery. A 30-second Research transport default is too short for
+# a valid monitored Index response. Explicit caller timeouts still win.
+INDEX_TRANSPORT_TIMEOUT_SECONDS = 120.0

{synth_ai-0.20.0.dev633 → synth_ai-0.20.0.dev635/synth_ai.egg-info}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.20.0.dev633
-Summary: Python SDK and CLI for Synth Managed Research and Research Factory
+Version: 0.20.0.dev635
+Summary: Python SDK and CLI for Synth Index, Managed Research, and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/synth-laboratories/synth-ai
@@ -208,11 +208,39 @@ Use `SynthClient` as the front door:
 
 | Surface | Client namespace | Use it for |
 | --- | --- | --- |
+| **Index** | `client.index` | Authenticated, funded FAST/DEEP Search and Contribution lifecycle. |
 | **Research / Factory** | `client.research` | Typed hosted projects, swarms, Factory lifecycles, and Efforts. |
-| CLI | `synth-ai` | Terminal access to Research commands. |
+| CLI / MCP | `synth-ai`, `synth-ai-index-mcp` | Terminal commands and an Index-only coding-agent server. |
 
-There are no infrastructure client namespaces (containers, tunnels, pools) on
-`SynthClient`; the package is Research-only as of 0.18.0.
+Index is an API/MCP product, not a browser search page. Anonymous public
+catalog and known-ID Contribution reads use `PublicIndexClient`; even a
+public-scope Search requires an API key, an authorized organization, and
+funding. An Index-only MCP server starts read-only, advertising public browse
+without a key and Search only when a key is configured. Contribution writes
+require a separate explicit opt-in and grant.
+
+```python
+from uuid import uuid4
+
+from synth_ai import SynthClient
+from synth_ai.sdk.index import SearchBillingConstraints
+
+request_key = str(uuid4())  # Persist this before sending; reuse it on uncertain retry.
+with SynthClient() as synth:  # Reads SYNTH_API_KEY.
+    result = synth.index.search(
+        query="What evidence supports the retrieval design?",
+        mode="fast",
+        billing=SearchBillingConstraints(allow_wallet=True, max_charge_cents=5),
+        idempotency_key=request_key,
+    )
+    print(result.response, result.usage)
+```
+
+FAST's five-cent ceiling is explicit wallet consent, not a claim that DEEP has
+the same price. See the [Index SDK guide](synth_ai/sdk/index/README.md) for
+DEEP's durable Search ID, reconnect/cancel, private collections, receipts, and
+coding-agent MCP setup. These calls require a deployed Index API; installing
+the SDK alone does not make a Search available.
 
 Use [Managed Research](https://docs.usesynth.ai/managed-research/intro) when you
 want hosted research workers, repo runs, evidence, checkpoints, MCP, or final

{synth_ai-0.20.0.dev633 → synth_ai-0.20.0.dev635}/synth_ai.egg-info/SOURCES.txt

@@ -106,6 +106,7 @@ synth_ai/sdk/index/public.py
 synth_ai/sdk/index/research_intake.py
 synth_ai/sdk/index/search.py
 synth_ai/sdk/index/submission.py
+synth_ai/sdk/index/timeouts.py
 synth_ai/sdk/index/transfer.py
 synth_ai/sdk/index/usage_accounting.py
 synth_ai/sdk/messaging/README.md