synth-ai 0.18.2.dev600__tar.gz → 0.18.2.dev602__tar.gz

{synth_ai-0.18.2.dev600/synth_ai.egg-info → synth_ai-0.18.2.dev602}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.18.2.dev600
+Version: 0.18.2.dev602
 Summary: Python SDK and CLI for Synth Managed Research and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev602}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.18.2.dev600"
+version = "0.18.2.dev602"
 description = "Python SDK and CLI for Synth Managed Research and Research Factory"
 authors = [{name = "Synth AI", email = "josh@usesynth.ai"}]
 license = "MIT"

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev602}/synth_ai/mcp/research/README.md

@@ -80,6 +80,40 @@ Noun reads and run-control tools below need
 `research_branch_run_from_checkpoint`, for exact branches and
 branch-with-message, is in the stable subset.
 
+Sync Intern control plane:
+- `intern_sync_create`, `intern_sync_list`, and `intern_sync_get` address
+  durable operator-present sessions
+- `intern_sync_send`, `intern_sync_intervene`, `intern_sync_answer`,
+  `intern_sync_pause`, `intern_sync_resume`, and `intern_sync_close` are typed
+  generation-fenced controls over the same command inbox
+- `intern_sync_command` preserves the exact command envelope, while
+  `intern_sync_events` and `intern_sync_tail` provide reconnectable ledger access
+
+These tools are thin adapters over `client.intern.sync_`. Sync session identity
+and event cursors are explicit because one organization may have multiple Sync
+sessions; they never address the singleton Async resource implicitly.
+
+Async Intern control plane:
+- `intern_async_ensure` and `intern_async_get` address the organization's one
+  long-lived Async Intern runtime
+- `intern_async_command` preserves the exact durable command envelope
+- `intern_async_send`, `intern_async_intervene`,
+  `intern_async_redirect_objective`, and `intern_async_request_checkpoint`
+  submit typed instructions to the same backend inbox
+- `intern_async_pause`, `intern_async_resume`, `intern_async_cancel`, and
+  `intern_async_provide_input` expose explicit state-machine controls
+- `intern_async_events` replays a bounded event page and `intern_async_tail`
+  waits for a bounded number of SSE events
+
+These tools are thin adapters over `client.intern.async_`; they do not call
+HTTP directly and do not contain reducer logic. A command receipt proves
+durable admission, not completion. Callers retain command/idempotency identity
+across retries and use the event cursor for progress after disconnecting. This
+MCP surface is the external client control plane. The Intern's own
+capability-gated Factory/Swarm MCP execution happens behind Temporal and is not
+routed through these tools. Manderqueue remains actor transport for a bound Run
+and is never the client mailbox.
+
 Provider-wrapper note:
 - OpenRouter, Tinker, and Modal wrapper usage should still be read through canonical
   run usage and actor-usage surfaces, not wrapper-specific payloads

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev602}/synth_ai/mcp/research/request_models.py

@@ -40,6 +40,15 @@ def require_string(payload: JSONDict, key: str) -> str:
     return value.strip()
 
 
+def require_int(payload: JSONDict, key: str) -> int:
+    if key not in payload or payload.get(key) is None:
+        raise ValueError(f"'{key}' is required and must be an integer")
+    value = payload[key]
+    if isinstance(value, bool) or not isinstance(value, int):
+        raise ValueError(f"'{key}' is required and must be an integer")
+    return value
+
+
 def optional_string(payload: JSONDict, key: str) -> str | None:
     value = payload.get(key)
     if value is None:

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev602}/synth_ai/mcp/research/server.py

@@ -95,6 +95,31 @@ def _optional_int_default(args: JSONDict, name: str, default: int) -> int:
 
 _STABLE_TOOL_NAMES = frozenset(
     {
+        "intern_async_cancel",
+        "intern_async_command",
+        "intern_async_ensure",
+        "intern_async_events",
+        "intern_async_get",
+        "intern_async_intervene",
+        "intern_async_pause",
+        "intern_async_provide_input",
+        "intern_async_redirect_objective",
+        "intern_async_request_checkpoint",
+        "intern_async_resume",
+        "intern_async_send",
+        "intern_async_tail",
+        "intern_sync_answer",
+        "intern_sync_close",
+        "intern_sync_command",
+        "intern_sync_create",
+        "intern_sync_events",
+        "intern_sync_get",
+        "intern_sync_intervene",
+        "intern_sync_list",
+        "intern_sync_pause",
+        "intern_sync_resume",
+        "intern_sync_send",
+        "intern_sync_tail",
         "research_append_research_intern_event",
         "research_archive_factory",
         "research_archive_project",