synth-ai 0.18.1.dev596__tar.gz → 0.18.1.dev597__tar.gz

{synth_ai-0.18.1.dev596/synth_ai.egg-info → synth_ai-0.18.1.dev597}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.18.1.dev596
+Version: 0.18.1.dev597
 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.1.dev596 → synth_ai-0.18.1.dev597}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.18.1.dev596"
+version = "0.18.1.dev597"
 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.1.dev596 → synth_ai-0.18.1.dev597}/synth_ai/__init__.py

@@ -37,6 +37,7 @@ except _PackageNotFoundError:
 
 
 __all__ = [
+    "AsyncResearchInternReactiveSession",
     "AsyncSynthClient",
     "DataBindingCreateRequest",
     "DatasetRevisionCreateRequest",
@@ -52,6 +53,8 @@ __all__ = [
     "FactoryRoleReceiptRuntimeEvidence",
     "FactoryStorageAuthorityResponse",
     "ResearchApiError",
+    "MagiDecisionKind",
+    "MagiDecisionReceiptResponse",
     "MagiDecisionRequest",
     "MagiMode",
     "ProjectComputerCleanupReceiptResponse",
@@ -69,14 +72,29 @@ __all__ = [
     "ResearchConcurrentRunLimitExceededError",
     "ResearchInsufficientCreditsError",
     "ResearchLimitExceededError",
+    "ResearchLimitExtensionGuardedResumeBlockedError",
+    "ResearchLimitExtensionIdempotencyConflictError",
+    "ResearchLimitRevisionConflictError",
     "ResearchProjectCreateRequest",
     "ResearchInternProvisionRequest",
+    "ResearchInternReactiveSession",
+    "ResearchInternEventStreamCursor",
+    "ResearchInternEventStreamEvent",
+    "ResearchInternEventStreamHeartbeat",
     "ResearchInternResponse",
+    "ResearchInternSessionCreateRequest",
+    "ResearchInternSessionResponse",
     "ResearchInternStatus",
+    "ResearchInternTracePublicationRequest",
+    "ResearchInternTracePublicationResponse",
+    "ResearchInternTurnControl",
+    "ResearchInternTurnRequest",
+    "ResearchInternTurnResponse",
     "ResearchSwarmLaunchRequest",
     "ResearchSwarmState",
     "ResearchVisual",
     "ResearchVisualPage",
+    "ResearchUnsafeLimitExtensionError",
     "ResearchVisualPatchRequest",
     "ResearchVisualPromotionRequest",
     "ResearchVisualVersions",
@@ -84,6 +102,10 @@ __all__ = [
 ]
 
 _EXPORTS: dict[str, tuple[str, str]] = {
+    "AsyncResearchInternReactiveSession": (
+        "synth_ai.sdk.research.research_intern",
+        "AsyncResearchInternReactiveSession",
+    ),
     "DataBindingCreateRequest": (
         "synth_ai.sdk.research.contracts",
         "DataBindingCreateRequest",
@@ -140,6 +162,14 @@ _EXPORTS: dict[str, tuple[str, str]] = {
         "synth_ai.sdk.research.contracts",
         "MagiDecisionRequest",
     ),
+    "MagiDecisionKind": (
+        "synth_ai.sdk.research.contracts",
+        "MagiDecisionKind",
+    ),
+    "MagiDecisionReceiptResponse": (
+        "synth_ai.sdk.research.contracts",
+        "MagiDecisionReceiptResponse",
+    ),
     "MagiMode": ("synth_ai.sdk.research.contracts", "MagiMode"),
     "ProjectComputerCleanupReceiptResponse": (
         "synth_ai.sdk.research.contracts",
@@ -195,6 +225,22 @@ _EXPORTS: dict[str, tuple[str, str]] = {
         "ResearchInsufficientCreditsError",
     ),
     "ResearchLimitExceededError": ("synth_ai.sdk.research.errors", "ResearchLimitExceededError"),
+    "ResearchLimitExtensionGuardedResumeBlockedError": (
+        "synth_ai.sdk.research.errors",
+        "ResearchLimitExtensionGuardedResumeBlockedError",
+    ),
+    "ResearchLimitExtensionIdempotencyConflictError": (
+        "synth_ai.sdk.research.errors",
+        "ResearchLimitExtensionIdempotencyConflictError",
+    ),
+    "ResearchLimitRevisionConflictError": (
+        "synth_ai.sdk.research.errors",
+        "ResearchLimitRevisionConflictError",
+    ),
+    "ResearchUnsafeLimitExtensionError": (
+        "synth_ai.sdk.research.errors",
+        "ResearchUnsafeLimitExtensionError",
+    ),
     "SmrApiError": ("synth_ai.sdk.research.errors", "ResearchApiError"),
     "SmrConcurrentRunLimitExceededError": (
         "synth_ai.sdk.research.errors",
@@ -214,14 +260,58 @@ _EXPORTS: dict[str, tuple[str, str]] = {
         "synth_ai.sdk.research.contracts",
         "ResearchInternProvisionRequest",
     ),
+    "ResearchInternReactiveSession": (
+        "synth_ai.sdk.research.research_intern",
+        "ResearchInternReactiveSession",
+    ),
+    "ResearchInternEventStreamCursor": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternEventStreamCursor",
+    ),
+    "ResearchInternEventStreamEvent": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternEventStreamEvent",
+    ),
+    "ResearchInternEventStreamHeartbeat": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternEventStreamHeartbeat",
+    ),
     "ResearchInternResponse": (
         "synth_ai.sdk.research.contracts",
         "ResearchInternResponse",
     ),
+    "ResearchInternSessionCreateRequest": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternSessionCreateRequest",
+    ),
+    "ResearchInternSessionResponse": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternSessionResponse",
+    ),
     "ResearchInternStatus": (
         "synth_ai.sdk.research.contracts",
         "ResearchInternStatus",
     ),
+    "ResearchInternTracePublicationRequest": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternTracePublicationRequest",
+    ),
+    "ResearchInternTracePublicationResponse": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternTracePublicationResponse",
+    ),
+    "ResearchInternTurnControl": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternTurnControl",
+    ),
+    "ResearchInternTurnRequest": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternTurnRequest",
+    ),
+    "ResearchInternTurnResponse": (
+        "synth_ai.sdk.research.contracts",
+        "ResearchInternTurnResponse",
+    ),
     "ResearchSwarmLaunchRequest": (
         "synth_ai.sdk.research.contracts",
         "ResearchSwarmLaunchRequest",

{synth_ai-0.18.1.dev596 → synth_ai-0.18.1.dev597}/synth_ai/mcp/research/server.py

@@ -6,6 +6,8 @@ import json
 import os
 import sys
 from dataclasses import asdict, is_dataclass
+from datetime import date, datetime, time
+from enum import Enum
 from typing import Any
 
 from synth_ai.core.errors import SynthError
@@ -54,6 +56,7 @@ from synth_ai.mcp.research.tools.projects import build_project_tools
 from synth_ai.mcp.research.tools.prs import build_pr_tools
 from synth_ai.mcp.research.tools.readiness import build_readiness_tools
 from synth_ai.mcp.research.tools.repos import build_repo_tools
+from synth_ai.mcp.research.tools.research_intern import build_research_intern_tools
 from synth_ai.mcp.research.tools.resources import build_resource_tools
 from synth_ai.mcp.research.tools.runs import build_run_tools
 from synth_ai.mcp.research.tools.trained_models import build_trained_model_tools
@@ -92,6 +95,7 @@ def _optional_int_default(args: JSONDict, name: str, default: int) -> int:
 
 _STABLE_TOOL_NAMES = frozenset(
     {
+        "research_append_research_intern_event",
         "research_archive_factory",
         "research_archive_project",
         "research_branch_run_from_checkpoint",
@@ -156,6 +160,27 @@ _STABLE_TOOL_NAMES = frozenset(
         "research_upload_workspace_files",
         "research_watch_run_events",
         "research_attach_source_repo",
+        "research_attach_research_intern_factory",
+        "research_close_research_intern_session",
+        "research_create_research_intern_session",
+        "research_exchange_research_intern_turn",
+        "research_get_research_intern",
+        "research_get_research_intern_acceptance_receipt",
+        "research_get_research_intern_decision",
+        "research_get_research_intern_session",
+        "research_list_research_intern_acceptance_receipts",
+        "research_list_research_intern_decisions",
+        "research_list_research_intern_events",
+        "research_list_research_intern_factories",
+        "research_list_research_intern_sessions",
+        "research_provision_research_intern",
+        "research_publish_research_intern_acceptance_receipt",
+        "research_publish_research_intern_session_trace",
+        "research_record_research_intern_decision",
+        "research_run_research_intern_turn",
+        "research_sync_research_intern_session",
+        "research_update_research_intern",
+        "research_watch_research_intern_events",
     }
 )
 
@@ -285,13 +310,26 @@ def _optional_string_tuple_arg(args: JSONDict, key: str) -> tuple[str, ...]:
 
 def _mcp_jsonable(value: Any) -> Any:
     if is_dataclass(value):
-        return asdict(value)
-    if isinstance(value, list):
-        return [_mcp_jsonable(item) for item in value]
-    if isinstance(value, tuple):
+        return _mcp_jsonable(asdict(value))
+    if isinstance(value, Enum):
+        return _mcp_jsonable(value.value)
+    if isinstance(value, (datetime, date, time)):
+        return value.isoformat()
+    if isinstance(value, (list, tuple)):
         return [_mcp_jsonable(item) for item in value]
     if isinstance(value, dict):
         return {str(key): _mcp_jsonable(item) for key, item in value.items()}
+    if isinstance(value, (set, frozenset)):
+        normalized = [_mcp_jsonable(item) for item in value]
+        return sorted(
+            normalized,
+            key=lambda item: json.dumps(
+                item,
+                ensure_ascii=False,
+                sort_keys=True,
+                separators=(",", ":"),
+            ),
+        )
     return value
 
 
@@ -411,6 +449,7 @@ class ResearchMcpServer:
             *build_model_tools(self),
             *build_output_tools(self),
             *build_readiness_tools(self),
+            *build_research_intern_tools(self._core_client_from_args),
             *build_resource_tools(self),
             *build_run_tools(self),
             *build_progress_tools(self),
@@ -1326,9 +1365,13 @@ class ResearchMcpServer:
             )
         limit_value = self._optional_float_arg(args, "limit_value")
         additional_value = self._optional_float_arg(args, "additional_value")
-        resolve_blockers = optional_bool(args, "resolve_blockers", default=True)
-        resume = optional_bool(args, "resume", default=True)
+        expected_revision = optional_int(args, "expected_revision")
+        if expected_revision is None or expected_revision < 1:
+            raise ValueError("expected_revision must be an integer greater than or equal to 1")
+        resolve_blockers = optional_bool(args, "resolve_blockers", default=False)
+        resume = optional_bool(args, "resume", default=False)
         kwargs = {
+            "expected_revision": expected_revision,
             "limit_value": limit_value,
             "additional_value": additional_value,
             "reason": optional_string(args, "reason"),
@@ -2722,7 +2765,7 @@ class ResearchMcpServer:
                 arguments = params.get("arguments")
                 if arguments is not None and not isinstance(arguments, dict):
                     raise RpcError(-32602, "tools/call arguments must be an object")
-                result = self.call_tool(tool_name, arguments)
+                result = _mcp_jsonable(self.call_tool(tool_name, arguments))
                 return {
                     "jsonrpc": "2.0",
                     "id": request_id,

{synth_ai-0.18.1.dev596 → synth_ai-0.18.1.dev597}/synth_ai/mcp/research/tools/__init__.py

@@ -13,6 +13,7 @@ from synth_ai.mcp.research.tools.project_data import build_project_data_tools
 from synth_ai.mcp.research.tools.projects import build_project_tools
 from synth_ai.mcp.research.tools.prs import build_pr_tools
 from synth_ai.mcp.research.tools.readiness import build_readiness_tools
+from synth_ai.mcp.research.tools.research_intern import build_research_intern_tools
 from synth_ai.mcp.research.tools.repos import build_repo_tools
 from synth_ai.mcp.research.tools.runs import build_run_tools
 from synth_ai.mcp.research.tools.visuals import build_visual_tools
@@ -32,6 +33,7 @@ __all__ = [
     "build_project_tools",
     "build_pr_tools",
     "build_readiness_tools",
+    "build_research_intern_tools",
     "build_repo_tools",
     "build_run_tools",
     "build_visual_tools",