synth-ai 0.18.2.dev611__tar.gz → 0.18.2.dev613__tar.gz

{synth_ai-0.18.2.dev611/synth_ai.egg-info → synth_ai-0.18.2.dev613}/PKG-INFO

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

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.18.2.dev611"
+version = "0.18.2.dev613"
 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.dev611 → synth_ai-0.18.2.dev613}/synth_ai/mcp/research/tools/research_intern.py

@@ -25,6 +25,7 @@ from synth_ai.sdk.research.contracts.research_intern import (
     InternAsyncEnsureRequest,
     InternAsyncInstructionKind,
     InternAsyncInstructionRequest,
+    InternCrossMetaThreadMessageCreateRequest,
     InternRuntimeOutcome,
     InternSyncCommandKind,
     InternSyncCommandRequest,
@@ -140,7 +141,52 @@ def build_research_intern_tools(
 
     def intern_sync_list(args: JSONDict) -> list[JSONDict]:
         with client_from_args(args) as client:
-            return _wire_list(client.intern.sync_.list(limit=optional_int(args, "limit") or 100))
+            return _wire_list(client.intern.sync_.branches())
+
+    def intern_sync_branches(args: JSONDict) -> list[JSONDict]:
+        with client_from_args(args) as client:
+            return _wire_list(client.intern.sync_.branches())
+
+    def intern_meta_threads(args: JSONDict) -> list[JSONDict]:
+        with client_from_args(args) as client:
+            return _wire_list(client.intern.meta_threads.list())
+
+    def intern_meta_segments(args: JSONDict) -> list[JSONDict]:
+        with client_from_args(args) as client:
+            return _wire_list(
+                client.intern.meta_threads.segments(require_string(args, "meta_thread_id"))
+            )
+
+    def intern_meta_messages(args: JSONDict) -> list[JSONDict]:
+        with client_from_args(args) as client:
+            return _wire_list(
+                client.intern.meta_threads.messages(
+                    require_string(args, "meta_thread_id"),
+                    limit=optional_int(args, "limit") or 200,
+                )
+            )
+
+    def intern_meta_send(args: JSONDict) -> JSONDict:
+        request = InternCrossMetaThreadMessageCreateRequest.model_validate(
+            _request_payload(
+                args,
+                (
+                    "message_id",
+                    "source_meta_thread_id",
+                    "destination_meta_thread_id",
+                    "kind",
+                    "idempotency_key",
+                    "payload",
+                    "linked_message_id",
+                    "sync_session_id",
+                    "segment_id",
+                    "resolution",
+                    "summary",
+                ),
+            )
+        )
+        with client_from_args(args) as client:
+            return client.intern.meta_threads.send(request).to_wire()
 
     def intern_sync_get(args: JSONDict) -> JSONDict:
         with client_from_args(args) as client:
@@ -755,6 +801,76 @@ def build_research_intern_tools(
         "sync_session_id": {"type": "string", "minLength": 1},
     }
     tools = [
+        ToolDefinition(
+            name="intern_meta_threads",
+            description="List the Intern's one Sync and one Async meta-thread.",
+            input_schema=tool_schema({}, required=[]),
+            handler=intern_meta_threads,
+            required_scopes=READ_SCOPES,
+        ),
+        ToolDefinition(
+            name="intern_meta_segments",
+            description="List head, live, and sealed segments for one meta-thread.",
+            input_schema=tool_schema(
+                {"meta_thread_id": {"type": "string", "minLength": 1}},
+                required=["meta_thread_id"],
+            ),
+            handler=intern_meta_segments,
+            required_scopes=READ_SCOPES,
+        ),
+        ToolDefinition(
+            name="intern_meta_messages",
+            description="List durable cross-lane messages visible to one meta-thread.",
+            input_schema=tool_schema(
+                {
+                    "meta_thread_id": {"type": "string", "minLength": 1},
+                    "limit": {"type": "integer", "minimum": 1, "maximum": 500},
+                },
+                required=["meta_thread_id"],
+            ),
+            handler=intern_meta_messages,
+            required_scopes=READ_SCOPES,
+        ),
+        ToolDefinition(
+            name="intern_meta_send",
+            description="Send one exact durable Sync-to-Async protocol object.",
+            input_schema=tool_schema(
+                {
+                    "message_id": {"type": "string", "minLength": 1},
+                    "source_meta_thread_id": {"type": "string", "minLength": 1},
+                    "destination_meta_thread_id": {"type": "string", "minLength": 1},
+                    "kind": {
+                        "type": "string",
+                        "enum": [
+                            "request_decision",
+                            "open_branch_ack",
+                            "decision_resolved",
+                            "steer",
+                            "note",
+                        ],
+                    },
+                    "idempotency_key": {"type": "string", "minLength": 1},
+                    "payload": {"type": "object"},
+                    "linked_message_id": {"type": "string"},
+                    "sync_session_id": {"type": "string"},
+                    "segment_id": {"type": "string"},
+                    "resolution": {
+                        "type": "string",
+                        "enum": ["completed", "denied", "superseded"],
+                    },
+                    "summary": {"type": "string", "maxLength": 4000},
+                },
+                required=[
+                    "message_id",
+                    "source_meta_thread_id",
+                    "destination_meta_thread_id",
+                    "kind",
+                    "idempotency_key",
+                ],
+            ),
+            handler=intern_meta_send,
+            required_scopes=WRITE_SCOPES,
+        ),
         ToolDefinition(
             name="intern_sync_create",
             description="Create or replay one durable operator-present Sync session.",
@@ -774,13 +890,17 @@ def build_research_intern_tools(
             handler=intern_sync_create,
             required_scopes=WRITE_SCOPES,
         ),
+        ToolDefinition(
+            name="intern_sync_branches",
+            description="List the Sync head plus every live or sealed branch.",
+            input_schema=tool_schema({}, required=[]),
+            handler=intern_sync_branches,
+            required_scopes=READ_SCOPES,
+        ),
         ToolDefinition(
             name="intern_sync_list",
-            description="List a bounded page of durable Sync Intern sessions.",
-            input_schema=tool_schema(
-                {"limit": {"type": "integer", "minimum": 1, "maximum": 500}},
-                required=[],
-            ),
+            description="Compatibility alias of intern_sync_branches.",
+            input_schema=tool_schema({}, required=[]),
             handler=intern_sync_list,
             required_scopes=READ_SCOPES,
         ),

{synth_ai-0.18.2.dev611 → synth_ai-0.18.2.dev613}/synth_ai/sdk/research/contracts/__init__.py

@@ -275,6 +275,7 @@ from synth_ai.sdk.research.contracts.research_intern import (
     DataBindingResponse,
     DatasetRevisionCreateRequest,
     DatasetRevisionResponse,
+    InternAgentConfig,
     InternAsyncBlocker,
     InternAsyncCheckpoint,
     InternAsyncCommandKind,
@@ -291,6 +292,17 @@ from synth_ai.sdk.research.contracts.research_intern import (
     InternAsyncRuntime,
     InternAsyncRuntimeBudget,
     InternAsyncStatus,
+    InternCrossMetaThreadMessage,
+    InternCrossMetaThreadMessageCreateRequest,
+    InternCrossMetaThreadMessageKind,
+    InternCrossMetaThreadMessageResolution,
+    InternMetaHandoff,
+    InternMetaHandoffStatus,
+    InternMetaThread,
+    InternMetaThreadKind,
+    InternMetaThreadLifecycle,
+    InternMetaThreadSegment,
+    InternMetaThreadSegmentStatus,
     InternRuntimeBinding,
     InternRuntimeOutcome,
     InternSyncCommandKind,
@@ -834,6 +846,18 @@ __all__ = [
     "InternAsyncRuntime",
     "InternAsyncRuntimeBudget",
     "InternAsyncStatus",
+    "InternAgentConfig",
+    "InternCrossMetaThreadMessage",
+    "InternCrossMetaThreadMessageCreateRequest",
+    "InternCrossMetaThreadMessageKind",
+    "InternCrossMetaThreadMessageResolution",
+    "InternMetaHandoff",
+    "InternMetaHandoffStatus",
+    "InternMetaThread",
+    "InternMetaThreadKind",
+    "InternMetaThreadLifecycle",
+    "InternMetaThreadSegment",
+    "InternMetaThreadSegmentStatus",
     "InternRuntimeBinding",
     "InternRuntimeOutcome",
     "InternSyncCommandKind",

{synth_ai-0.18.2.dev611 → synth_ai-0.18.2.dev613}/synth_ai/sdk/research/contracts/evidence.py

@@ -326,6 +326,11 @@ class SwarmEvidence:
                     "project_id",
                     "artifacts",
                     "work_products",
+                    # Backend may include inline selected contents / Trace V5
+                    # publications; accept them without requiring callers to
+                    # consume them yet.
+                    "selected_artifact_contents",
+                    "trace_publications",
                     "freshness",
                 }
             ),
@@ -359,6 +364,8 @@ class SwarmEvidence:
             "project_id": self.project_id,
             "artifacts": [artifact.to_wire() for artifact in self.artifacts],
             "work_products": [item.to_wire() for item in self.work_products],
+            "selected_artifact_contents": [],
+            "trace_publications": [],
             "freshness": self.freshness.to_wire(),
         }
 

{synth_ai-0.18.2.dev611 → synth_ai-0.18.2.dev613}/synth_ai/sdk/research/contracts/research_intern.py

@@ -144,6 +144,128 @@ class ResearchInternResponse(_StrictContract):
     updated_at: datetime
 
 
+class InternMetaThreadKind(StrEnum):
+    SYNC = "sync"
+    ASYNC = "async"
+
+
+class InternMetaThreadLifecycle(StrEnum):
+    ACTIVE = "active"
+    ARCHIVED = "archived"
+
+
+class InternMetaThreadSegmentStatus(StrEnum):
+    LIVE = "live"
+    SEALED = "sealed"
+
+
+class InternMetaHandoffStatus(StrEnum):
+    SEALED = "sealed"
+    MERGED = "merged"
+
+
+class InternCrossMetaThreadMessageKind(StrEnum):
+    REQUEST_DECISION = "request_decision"
+    OPEN_BRANCH_ACK = "open_branch_ack"
+    DECISION_RESOLVED = "decision_resolved"
+    STEER = "steer"
+    NOTE = "note"
+
+
+class InternCrossMetaThreadMessageResolution(StrEnum):
+    COMPLETED = "completed"
+    DENIED = "denied"
+    SUPERSEDED = "superseded"
+
+
+class InternAgentConfig(_StrictContract):
+    agent_role: str
+    harness: str
+    model: str
+    reasoning_effort: str
+    segment_role: str | None = None
+    harness_command: str | None = None
+    workspace_root: str | None = None
+
+
+class InternMetaThread(_StrictContract):
+    schema_version: Literal["smr.meta-thread.v1"]
+    meta_thread_id: str
+    organization_id: str
+    research_intern_id: str
+    kind: InternMetaThreadKind
+    lifecycle: InternMetaThreadLifecycle
+    head_segment_id: str
+    created_at: datetime
+    updated_at: datetime
+
+
+class InternMetaThreadSegment(_StrictContract):
+    schema_version: Literal["smr.meta-thread-segment.v1"]
+    segment_id: str
+    meta_thread_id: str
+    parent_segment_id: str | None = None
+    lane_runtime_id: str | None = None
+    agent_config: InternAgentConfig | None = None
+    status: InternMetaThreadSegmentStatus
+    opened_at: datetime
+    sealed_at: datetime | None = None
+    linked_message_id: str | None = None
+    handoff_id: str | None = None
+    is_head: bool = False
+
+
+class InternMetaHandoff(_StrictContract):
+    schema_version: Literal["smr.meta-handoff.v1"]
+    handoff_id: str
+    meta_thread_id: str
+    source_segment_id: str
+    summary: str
+    evidence_references: tuple[str, ...] = ()
+    agent_config: InternAgentConfig | None = None
+    status: InternMetaHandoffStatus
+    created_at: datetime
+    sealed_at: datetime
+    merged_at: datetime | None = None
+
+
+class InternCrossMetaThreadMessageCreateRequest(_StrictContract):
+    schema_version: Literal["smr.cross-meta-thread-message-create.v1"] = (
+        "smr.cross-meta-thread-message-create.v1"
+    )
+    message_id: str = Field(min_length=1, max_length=512)
+    source_meta_thread_id: str = Field(min_length=1, max_length=512)
+    destination_meta_thread_id: str = Field(min_length=1, max_length=512)
+    kind: InternCrossMetaThreadMessageKind
+    idempotency_key: str = Field(min_length=1, max_length=512)
+    payload: dict[str, Any] = Field(default_factory=dict)
+    linked_message_id: str | None = None
+    sync_session_id: str | None = None
+    segment_id: str | None = None
+    resolution: InternCrossMetaThreadMessageResolution | None = None
+    summary: str | None = Field(default=None, max_length=4_000)
+
+
+class InternCrossMetaThreadMessage(_StrictContract):
+    schema_version: Literal["smr.cross-meta-thread-message.v1"]
+    message_id: str
+    organization_id: str
+    research_intern_id: str
+    source_meta_thread_id: str
+    source_kind: InternMetaThreadKind
+    destination_meta_thread_id: str
+    destination_kind: InternMetaThreadKind
+    kind: InternCrossMetaThreadMessageKind
+    idempotency_key: str
+    payload: dict[str, Any] = Field(default_factory=dict)
+    linked_message_id: str | None = None
+    sync_session_id: str | None = None
+    segment_id: str | None = None
+    resolution: InternCrossMetaThreadMessageResolution | None = None
+    summary: str | None = None
+    created_at: datetime
+
+
 class InternRuntimeBinding(_StrictContract):
     factory_id: str | None = None
     project_id: str | None = None

{synth_ai-0.18.2.dev611 → synth_ai-0.18.2.dev613}/synth_ai/sdk/research/operations.py

@@ -97,6 +97,43 @@ RESEARCH_OPERATIONS = {
             mutation=True,
             idempotent=True,
         ),
+        _operation(
+            "list_intern_meta_threads",
+            HttpMethod.GET,
+            "/smr/research-intern/meta-threads",
+            idempotent=True,
+        ),
+        _operation(
+            "get_intern_meta_thread",
+            HttpMethod.GET,
+            "/smr/research-intern/meta-threads/{meta_thread_id}",
+            idempotent=True,
+        ),
+        _operation(
+            "list_intern_meta_thread_segments",
+            HttpMethod.GET,
+            "/smr/research-intern/meta-threads/{meta_thread_id}/segments",
+            idempotent=True,
+        ),
+        _operation(
+            "list_intern_meta_thread_handoffs",
+            HttpMethod.GET,
+            "/smr/research-intern/meta-threads/{meta_thread_id}/handoffs",
+            idempotent=True,
+        ),
+        _operation(
+            "list_intern_meta_thread_messages",
+            HttpMethod.GET,
+            "/smr/research-intern/meta-threads/{meta_thread_id}/messages",
+            idempotent=True,
+        ),
+        _operation(
+            "create_intern_meta_thread_message",
+            HttpMethod.POST,
+            "/smr/research-intern/meta-threads/messages",
+            mutation=True,
+            idempotent=True,
+        ),
         _operation(
             "list_intern_runtime_events",
             HttpMethod.GET,

{synth_ai-0.18.2.dev611 → synth_ai-0.18.2.dev613}/synth_ai/sdk/research/public.py

@@ -145,6 +145,7 @@ from synth_ai.sdk.research.contracts import (
     ImageReleaseUploadResponse,
     ImageUploadId,
     InferenceProvider,
+    InternAgentConfig,
     InternAsyncBlocker,
     InternAsyncCheckpoint,
     InternAsyncCommandKind,
@@ -161,6 +162,17 @@ from synth_ai.sdk.research.contracts import (
     InternAsyncRuntime,
     InternAsyncRuntimeBudget,
     InternAsyncStatus,
+    InternCrossMetaThreadMessage,
+    InternCrossMetaThreadMessageCreateRequest,
+    InternCrossMetaThreadMessageKind,
+    InternCrossMetaThreadMessageResolution,
+    InternMetaHandoff,
+    InternMetaHandoffStatus,
+    InternMetaThread,
+    InternMetaThreadKind,
+    InternMetaThreadLifecycle,
+    InternMetaThreadSegment,
+    InternMetaThreadSegmentStatus,
     InternRuntimeBinding,
     InternRuntimeOutcome,
     InternSyncCommandKind,
@@ -416,6 +428,7 @@ from synth_ai.sdk.research.research_intern import (
     AsyncResearchInternAsyncRuntimeAPI,
     AsyncResearchInternDecisionsAPI,
     AsyncResearchInternFactoriesAPI,
+    AsyncResearchInternMetaThreadsAPI,
     AsyncResearchInternReactiveSession,
     AsyncResearchInternSessionsAPI,
     AsyncResearchInternSyncRuntimeAPI,
@@ -431,6 +444,7 @@ from synth_ai.sdk.research.research_intern import (
     ResearchInternEventStreamObservation,
     ResearchInternExchange,
     ResearchInternFactoriesAPI,
+    ResearchInternMetaThreadsAPI,
     ResearchInternOperatorTurn,
     ResearchInternPollingTimeoutError,
     ResearchInternReactiveSession,
@@ -453,6 +467,7 @@ __all__ = [
     "AsyncResearchInternSyncRuntimeAPI",
     "AsyncResearchInternDecisionsAPI",
     "AsyncResearchInternFactoriesAPI",
+    "AsyncResearchInternMetaThreadsAPI",
     "AsyncResearchInternReactiveSession",
     "AsyncResearchInternSessionsAPI",
     "DataBindingCreateRequest",
@@ -713,6 +728,19 @@ __all__ = [
     "ResearchInternEventStreamPayload",
     "ResearchInternExchange",
     "ResearchInternFactoriesAPI",
+    "ResearchInternMetaThreadsAPI",
+    "InternAgentConfig",
+    "InternCrossMetaThreadMessage",
+    "InternCrossMetaThreadMessageCreateRequest",
+    "InternCrossMetaThreadMessageKind",
+    "InternCrossMetaThreadMessageResolution",
+    "InternMetaHandoff",
+    "InternMetaHandoffStatus",
+    "InternMetaThread",
+    "InternMetaThreadKind",
+    "InternMetaThreadLifecycle",
+    "InternMetaThreadSegment",
+    "InternMetaThreadSegmentStatus",
     "ResearchInternFactoryMembershipResponse",
     "ResearchInternOperatorTurn",
     "ResearchInternPatchRequest",