synth-ai 0.18.2.dev603__tar.gz → 0.18.2.dev606__tar.gz

{synth_ai-0.18.2.dev603/synth_ai.egg-info → synth_ai-0.18.2.dev606}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.18.2.dev603
+Version: 0.18.2.dev606
 Summary: Python SDK and CLI for Synth Managed Research and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT
@@ -27,7 +27,7 @@ Dynamic: license-file
 
 # Synth AI SDK
 
-<!-- CI release pins: PyPI-0.18.1-orange synth-ai==0.18.1 -->
+<!-- CI release pins: PyPI-0.18.2-orange synth-ai==0.18.2 -->
 
 [![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/)

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/README.md

@@ -1,6 +1,6 @@
 # Synth AI SDK
 
-<!-- CI release pins: PyPI-0.18.1-orange synth-ai==0.18.1 -->
+<!-- CI release pins: PyPI-0.18.2-orange synth-ai==0.18.2 -->
 
 [![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/)

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.18.2.dev603"
+version = "0.18.2.dev606"
 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.dev603 → synth_ai-0.18.2.dev606}/synth_ai/client.py

@@ -34,10 +34,12 @@ class SynthClient:
         api_key: str | None = None,
         base_url: str | None = None,
         timeout_seconds: float = 30.0,
+        allow_legacy_intern_sessions: bool = False,
     ) -> None:
         self.api_key = _resolve_api_key(api_key)
         self.base_url = _resolve_base_url(base_url)
         self.timeout_seconds = timeout_seconds
+        self.allow_legacy_intern_sessions = allow_legacy_intern_sessions
         self._research_client: ResearchClient | None = None
 
     @property
@@ -50,6 +52,7 @@ class SynthClient:
                 api_key=self.api_key,
                 base_url=self.base_url,
                 timeout_seconds=self.timeout_seconds,
+                allow_legacy_intern_sessions=self.allow_legacy_intern_sessions,
             )
         return self._research_client
 
@@ -75,10 +78,12 @@ class AsyncSynthClient:
         api_key: str | None = None,
         base_url: str | None = None,
         timeout_seconds: float = 30.0,
+        allow_legacy_intern_sessions: bool = False,
     ) -> None:
         self.api_key = _resolve_api_key(api_key)
         self.base_url = _resolve_base_url(base_url)
         self.timeout_seconds = timeout_seconds
+        self.allow_legacy_intern_sessions = allow_legacy_intern_sessions
         self._async_research_client: AsyncResearchClient | None = None
 
     @property
@@ -91,6 +96,7 @@ class AsyncSynthClient:
                 api_key=self.api_key,
                 base_url=self.base_url,
                 timeout_seconds=self.timeout_seconds,
+                allow_legacy_intern_sessions=self.allow_legacy_intern_sessions,
             )
         return self._async_research_client
 

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/synth_ai/mcp/research/tools/research_intern.py

@@ -12,7 +12,12 @@ from synth_ai.mcp.research.registry import (
     ToolDefinition,
     tool_schema,
 )
-from synth_ai.mcp.research.request_models import optional_int, optional_string, require_int, require_string
+from synth_ai.mcp.research.request_models import (
+    optional_int,
+    optional_string,
+    require_int,
+    require_string,
+)
 from synth_ai.sdk.research.client import Client as ResearchClient
 from synth_ai.sdk.research.contracts.research_intern import (
     InternAsyncCommandKind,
@@ -35,11 +40,35 @@ from synth_ai.sdk.research.contracts.research_intern import (
     ResearchInternTracePublicationRequest,
     ResearchInternTurnRequest,
 )
-from synth_ai.sdk.research.research_intern import ResearchInternEventCursor
+from synth_ai.sdk.research.research_intern import (
+    ResearchInternEventCursor,
+    legacy_intern_sessions_enabled,
+)
 
 CoreClientFactory = Callable[[JSONDict], ResearchClient]
 _RESEARCH_INTERN_EVENT_SEQUENCE_MAX = 2**31 - 1
 
+#: MCP tools that drive the legacy ``/smr/research-intern/sessions`` plane.
+#: They are excluded from registration unless the environment explicitly opts
+#: in via ``SYNTH_ALLOW_LEGACY_INTERN_SESSIONS=1``; QA treats any legacy
+#: ``/sessions`` hit as a hard fail, so the default surface is sync-sessions
+#: only (``intern_sync_*`` / ``intern_async_*``).
+LEGACY_INTERN_SESSION_TOOL_NAMES = frozenset(
+    {
+        "research_append_research_intern_event",
+        "research_close_research_intern_session",
+        "research_create_research_intern_session",
+        "research_exchange_research_intern_turn",
+        "research_get_research_intern_session",
+        "research_list_research_intern_events",
+        "research_list_research_intern_sessions",
+        "research_publish_research_intern_session_trace",
+        "research_run_research_intern_turn",
+        "research_sync_research_intern_session",
+        "research_watch_research_intern_events",
+    }
+)
+
 
 def _request_payload(args: JSONDict, names: tuple[str, ...]) -> JSONDict:
     return {name: args[name] for name in names if name in args}
@@ -725,7 +754,7 @@ def build_research_intern_tools(
     sync_selector: JSONDict = {
         "sync_session_id": {"type": "string", "minLength": 1},
     }
-    return [
+    tools = [
         ToolDefinition(
             name="intern_sync_create",
             description="Create or replay one durable operator-present Sync session.",
@@ -1598,6 +1627,9 @@ def build_research_intern_tools(
             required_scopes=READ_SCOPES,
         ),
     ]
+    if not legacy_intern_sessions_enabled():
+        tools = [tool for tool in tools if tool.name not in LEGACY_INTERN_SESSION_TOOL_NAMES]
+    return tools
 
 
-__all__ = ["build_research_intern_tools"]
+__all__ = ["LEGACY_INTERN_SESSION_TOOL_NAMES", "build_research_intern_tools"]

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/synth_ai/sdk/research/client.py

@@ -45,6 +45,7 @@ class Client:
         api_key: str | None = None,
         base_url: str | None = None,
         timeout_seconds: float = 30.0,
+        allow_legacy_intern_sessions: bool = False,
     ) -> None:
         self._credential = resolve_api_credential(api_key)
         self._transport = HttpTransport(
@@ -53,7 +54,10 @@ class Client:
             timeout_seconds=timeout_seconds,
         )
         self.projects = ProjectsAPI(self._transport)
-        self.intern = ResearchInternAPI(self._transport)
+        self.intern = ResearchInternAPI(
+            self._transport,
+            allow_legacy_intern_sessions=allow_legacy_intern_sessions,
+        )
         self.swarms = SwarmsAPI(self._transport)
         self.factories = FactoriesAPI(self._transport)
         self.environments = EnvironmentsAPI(self._transport)
@@ -115,6 +119,7 @@ class AsyncClient:
         api_key: str | None = None,
         base_url: str | None = None,
         timeout_seconds: float = 30.0,
+        allow_legacy_intern_sessions: bool = False,
     ) -> None:
         self._credential = resolve_api_credential(api_key)
         self._transport = AsyncHttpTransport(
@@ -123,7 +128,10 @@ class AsyncClient:
             timeout_seconds=timeout_seconds,
         )
         self.projects = AsyncProjectsAPI(self._transport)
-        self.intern = AsyncResearchInternAPI(self._transport)
+        self.intern = AsyncResearchInternAPI(
+            self._transport,
+            allow_legacy_intern_sessions=allow_legacy_intern_sessions,
+        )
         self.swarms = AsyncSwarmsAPI(self._transport)
         self.factories = AsyncFactoriesAPI(self._transport)
         self.environments = AsyncEnvironmentsAPI(self._transport)

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/synth_ai/sdk/research/contracts/__init__.py

@@ -348,6 +348,15 @@ from synth_ai.sdk.research.contracts.research_intern import (
     ResearchInternTurnRequest,
     ResearchInternTurnResponse,
     ResearchInternTurnStatus,
+    SyncKitAssociatedFile,
+    SyncKitAssociationReceipt,
+    SyncKitIngressKind,
+    SyncKitIngressObservation,
+    SyncKitIngressSource,
+    SyncKitReadiness,
+    SyncTemplateProvisionedResource,
+    SyncTemplateProvisioningReceipt,
+    SyncTracePublicationReceipt,
 )
 from synth_ai.sdk.research.contracts.runtime_stream import (
     SwarmEvent,
@@ -921,6 +930,15 @@ __all__ = [
     "SwarmTerminalOutcomeMissingError",
     "SwarmEnvironment",
     "SwarmUsage",
+    "SyncKitAssociatedFile",
+    "SyncKitAssociationReceipt",
+    "SyncKitIngressKind",
+    "SyncKitIngressObservation",
+    "SyncKitIngressSource",
+    "SyncKitReadiness",
+    "SyncTemplateProvisionedResource",
+    "SyncTemplateProvisioningReceipt",
+    "SyncTracePublicationReceipt",
     "TaskId",
     "TranscriptCursor",
     "TranscriptCursorKind",

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/synth_ai/sdk/research/contracts/research_intern.py

@@ -184,6 +184,129 @@ class InternSyncSessionCreateRequest(_StrictContract):
     metadata: dict[str, Any] = Field(default_factory=dict)
 
 
+class SyncTemplateProvisionedResource(_StrictContract):
+    """One resource decision made while provisioning a task template."""
+
+    resource_kind: Literal[
+        "project",
+        "factory",
+        "factory_project_link",
+        "effort",
+        "intern_factory_membership",
+        "run",
+    ]
+    status: Literal["created", "reused", "unsupported"]
+    resource_id: str | None = None
+    error_code: str | None = None
+
+
+class SyncTemplateProvisioningReceipt(_StrictContract):
+    """Durable record of what starting from a task template provisioned.
+
+    The backend mints this receipt inside the session-create transaction and
+    stamps it into the session projection; the SDK only ever observes it.
+    """
+
+    schema_version: Literal["smr.intern-sync-template-provisioning.v1"]
+    task_template: str
+    binding: InternRuntimeBinding
+    resources: tuple[SyncTemplateProvisionedResource, ...]
+    provisioned_at: datetime
+
+
+class SyncTracePublicationReceipt(_StrictContract):
+    """Read-only receipt for the server-side terminal Trace V5 publication.
+
+    The backend publishes the durable Sync event chain as genuine Trace V5 as
+    an effect of the session reaching a terminal state. Clients never mint
+    this record; they observe it on the session projection after close.
+    """
+
+    schema_version: Literal["smr.intern-sync-trace-publication.v1"]
+    status: Literal["published", "failed"]
+    sync_session_id: str
+    runtime_kind: Literal["sync"]
+    state_generation: int = Field(ge=1)
+    event_count: int | None = Field(default=None, ge=1)
+    trace_id: str | None = None
+    trace_digest: str | None = Field(default=None, pattern=r"^sha256:[0-9a-f]{64}$")
+    capture_id: str | None = None
+    bundle_id: str | None = None
+    manifest_digest: str | None = Field(default=None, pattern=r"^sha256:[0-9a-f]{64}$")
+    publication_id: str | None = None
+    error_code: str | None = None
+    attempted_at: datetime
+    published_at: datetime | None = None
+
+
+SyncKitIngressKind = Literal[
+    "website_upload",
+    "sdk_upload",
+    "git_push",
+    "project_files",
+]
+
+SyncKitIngressObservation = Literal[
+    "stored_file_write",
+    "push_confirmation",
+    "upload_url_issuance",
+]
+
+
+class SyncKitAssociatedFile(_StrictContract):
+    """One file observed in a kit ingress, with whatever identity was available."""
+
+    path: str
+    digest: str | None = Field(default=None, pattern=r"^sha256:[0-9a-f]{64}$")
+    size_bytes: int | None = Field(default=None, ge=0)
+    stored_file_id: str | None = None
+
+
+class SyncKitIngressSource(_StrictContract):
+    """Source identity of one kit ingress, per ingress kind."""
+
+    commit_sha: str | None = None
+    archive_key: str | None = None
+    workspace_archive_id: str | None = None
+    push_confirmation_receipt_id: str | None = None
+    upload_batch_id: str | None = None
+    dataset_ref: str | None = None
+    stored_file_ids: tuple[str, ...] = ()
+
+
+class SyncKitAssociationReceipt(_StrictContract):
+    """Durable record that a kit ingress landed while this session was open.
+
+    The backend mints this receipt as a server-side effect of observing an
+    upload, push, or file write on a project bound to an open Sync session.
+    Clients never mint it; they observe it on the session projection.
+    """
+
+    schema_version: Literal["smr.intern-sync-kit-association.v1"]
+    receipt_id: str
+    sync_session_id: str
+    project_id: str
+    ingress_kind: SyncKitIngressKind
+    observed_via: SyncKitIngressObservation
+    files: tuple[SyncKitAssociatedFile, ...] = ()
+    source: SyncKitIngressSource
+    open_session_count: int = Field(ge=1)
+    associated_at: datetime
+
+
+class SyncKitReadiness(_StrictContract):
+    """Read-only kit completeness projection for a template-bound session."""
+
+    schema_version: Literal["smr.intern-sync-kit-readiness.v1"]
+    status: Literal["ready", "incomplete"]
+    task_template: str
+    kit_contract: str
+    required_files: tuple[str, ...]
+    present_files: tuple[str, ...] = ()
+    missing_files: tuple[str, ...] = ()
+    checked_at: datetime
+
+
 class InternSyncSession(_StrictContract):
     schema_version: Literal["smr.intern-sync-session.v1"]
     sync_session_id: str
@@ -200,6 +323,14 @@ class InternSyncSession(_StrictContract):
     outcome: InternRuntimeOutcome | None = None
     failure_code: str | None = None
     temporal_workflow_id: str
+    # Server-minted projection stamps. Old backends omit them entirely; new
+    # backends stamp them once the corresponding effect lands. The SDK only
+    # observes these receipts — the backend remains the minting authority.
+    task_template: str | None = None
+    provisioning: SyncTemplateProvisioningReceipt | None = None
+    trace_publication: SyncTracePublicationReceipt | None = None
+    kit_associations: tuple[SyncKitAssociationReceipt, ...] = ()
+    kit_readiness: SyncKitReadiness | None = None
     created_at: datetime
     updated_at: datetime
     closed_at: datetime | None = None

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/synth_ai/sdk/research/facade.py

@@ -115,6 +115,7 @@ class Client:
         api_key: str,
         base_url: str,
         timeout_seconds: float = 120.0,
+        allow_legacy_intern_sessions: bool = False,
     ) -> None:
         self.api_key = api_key
         self.base_url = base_url
@@ -123,6 +124,7 @@ class Client:
             api_key=api_key,
             base_url=base_url,
             timeout_seconds=timeout_seconds,
+            allow_legacy_intern_sessions=allow_legacy_intern_sessions,
         )
         self._session: ResearchSession | None = None
         self._advanced: ResearchAdvancedAPI | None = None

{synth_ai-0.18.2.dev603 → synth_ai-0.18.2.dev606}/synth_ai/sdk/research/public.py

@@ -297,6 +297,15 @@ from synth_ai.sdk.research.contracts import (
     SwarmTranscriptEvent,
     SwarmTranscriptPage,
     SwarmUsage,
+    SyncKitAssociatedFile,
+    SyncKitAssociationReceipt,
+    SyncKitIngressKind,
+    SyncKitIngressObservation,
+    SyncKitIngressSource,
+    SyncKitReadiness,
+    SyncTemplateProvisionedResource,
+    SyncTemplateProvisioningReceipt,
+    SyncTracePublicationReceipt,
     TaskId,
     TokenCounts,
     TokenUsage,
@@ -413,6 +422,7 @@ from synth_ai.sdk.research.research_intern import (
     AsyncResearchInternReactiveSession,
     AsyncResearchInternSessionsAPI,
     AsyncResearchInternSyncRuntimeAPI,
+    LegacyInternSessionsDisabledError,
     ProjectComputerAPI,
     ProjectDataBindingsAPI,
     ResearchInternAcceptanceReceiptsAPI,
@@ -489,6 +499,7 @@ __all__ = [
     "InternSyncSession",
     "InternSyncSessionCreateRequest",
     "InternSyncStatus",
+    "LegacyInternSessionsDisabledError",
     "FactoryStorageAuthorityResponse",
     "MAGI_CANONICAL_USER_BY_MODE",
     "MagiActuationStatus",
@@ -754,6 +765,15 @@ __all__ = [
     "SwarmTranscriptEvent",
     "SwarmTranscriptPage",
     "SwarmUsage",
+    "SyncKitAssociatedFile",
+    "SyncKitAssociationReceipt",
+    "SyncKitIngressKind",
+    "SyncKitIngressObservation",
+    "SyncKitIngressSource",
+    "SyncKitReadiness",
+    "SyncTemplateProvisionedResource",
+    "SyncTemplateProvisioningReceipt",
+    "SyncTracePublicationReceipt",
     "TaskId",
     "ToolProvider",
     "TokenCounts",