synth-ai 0.18.2.dev607__tar.gz → 0.18.2.dev609__tar.gz

{synth_ai-0.18.2.dev607/synth_ai.egg-info → synth_ai-0.18.2.dev609}/PKG-INFO

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

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

@@ -277,6 +277,7 @@ def build_factory_tools(server: Any) -> list[ToolDefinition]:
             return client.factories.wake_due(
                 str(args["factory_id"]),
                 launch_request=args.get("launch_request"),
+                effort_ids=tuple(str(value) for value in args.get("effort_ids") or []),
                 limit=int(args.get("limit") or 10),
                 allow_overlap=bool(args.get("allow_overlap") or False),
                 dry_run=True,
@@ -765,6 +766,13 @@ def build_factory_tools(server: Any) -> list[ToolDefinition]:
                         "type": "object",
                         "description": "Optional default launch request.",
                     },
+                    "effort_ids": {
+                        "type": "array",
+                        "items": {"type": "string"},
+                        "maxItems": 100,
+                        "uniqueItems": True,
+                        "description": "Optional exact Effort scope for the preview.",
+                    },
                     "limit": {
                         "type": "integer",
                         "description": "Maximum due Efforts to evaluate.",

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609}/synth_ai/sdk/research/advanced_factories.py

@@ -287,6 +287,7 @@ class ResearchFactoriesAPI:
         factory_id: str,
         *,
         launch_request: Mapping[str, Any] | dict[str, Any] | None = None,
+        effort_ids: tuple[str, ...] = (),
         limit: int = 10,
         allow_overlap: bool = False,
         continue_on_error: bool = True,
@@ -295,6 +296,7 @@ class ResearchFactoriesAPI:
         return self._session.factories.wake_due(
             factory_id,
             launch_request=launch_request,
+            effort_ids=effort_ids,
             limit=limit,
             allow_overlap=allow_overlap,
             dry_run=True,
@@ -322,6 +324,7 @@ class ResearchFactoriesAPI:
         result = self._session.factories.wake_due(
             factory_id,
             launch_request=contract.launch_request,
+            effort_ids=contract.effort_ids,
             limit=contract.limit,
             allow_overlap=contract.allow_overlap,
             dry_run=False,

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609}/synth_ai/sdk/research/contracts/__init__.py

@@ -296,6 +296,8 @@ from synth_ai.sdk.research.contracts.research_intern import (
     InternSyncCommandKind,
     InternSyncCommandReceipt,
     InternSyncCommandRequest,
+    InternSyncDeployPacket,
+    InternSyncDeployPacketEndpoint,
     InternSyncEvent,
     InternSyncEventPage,
     InternSyncEventStreamEnvelope,
@@ -842,6 +844,8 @@ __all__ = [
     "InternSyncCommandKind",
     "InternSyncCommandReceipt",
     "InternSyncCommandRequest",
+    "InternSyncDeployPacket",
+    "InternSyncDeployPacketEndpoint",
     "InternSyncEvent",
     "InternSyncEventPage",
     "InternSyncEventStreamEnvelope",

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609}/synth_ai/sdk/research/contracts/factory_operations.py

@@ -2150,6 +2150,7 @@ class FactoryStatus:
 @dataclass(frozen=True)
 class FactoryWakeDueRequest:
     launch_request: dict[str, Any] | None = None
+    effort_ids: tuple[str, ...] = ()
     limit: int = 10
     allow_overlap: bool = False
     dry_run: bool = False
@@ -2163,6 +2164,7 @@ class FactoryWakeDueRequest:
         mapping = _require_mapping(payload, label="factory wake request contract")
         allowed_keys = {
             "launch_request",
+            "effort_ids",
             "limit",
             "allow_overlap",
             "continue_on_error",
@@ -2194,12 +2196,21 @@ class FactoryWakeDueRequest:
         if not 1 <= limit <= 100:
             raise ValueError("factory wake limit must be between 1 and 100")
         continue_on_error = _optional_bool(mapping, "continue_on_error")
+        raw_effort_ids = mapping.get("effort_ids") or ()
+        if not isinstance(raw_effort_ids, (list, tuple)):
+            raise ValueError("factory wake effort_ids must be an array")
+        effort_ids = tuple(str(value).strip() for value in raw_effort_ids)
+        if any(not value for value in effort_ids) or len(set(effort_ids)) != len(effort_ids):
+            raise ValueError("factory wake effort_ids must be unique non-empty strings")
+        if len(effort_ids) > 100:
+            raise ValueError("factory wake effort_ids must contain at most 100 entries")
         return cls(
             launch_request=(
                 _optional_object_dict(launch_request, label="factory wake launch_request")
                 if launch_request is not None
                 else None
             ),
+            effort_ids=effort_ids,
             limit=limit,
             allow_overlap=bool(_optional_bool(mapping, "allow_overlap")),
             dry_run=bool(_optional_bool(mapping, "dry_run")),
@@ -2214,6 +2225,7 @@ class FactoryWakeDueRequest:
             "launch_request": (
                 dict(self.launch_request) if self.launch_request is not None else None
             ),
+            "effort_ids": list(self.effort_ids),
             "limit": self.limit,
             "allow_overlap": self.allow_overlap,
             "continue_on_error": self.continue_on_error,
@@ -2222,6 +2234,7 @@ class FactoryWakeDueRequest:
 
     def to_wire(self) -> dict[str, Any]:
         payload: dict[str, Any] = {
+            "effort_ids": list(self.effort_ids),
             "limit": self.limit,
             "allow_overlap": self.allow_overlap,
             "dry_run": self.dry_run,

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609}/synth_ai/sdk/research/contracts/research_intern.py

@@ -164,7 +164,12 @@ class InternSyncStatus(StrEnum):
 
 class InternRuntimeOutcome(StrEnum):
     COMPLETED = "completed"
+    PARTIAL = "partial"
+    BLOCKED = "blocked"
     CANCELLED = "cancelled"
+    CANCELED = "canceled"
+    STOPPED = "stopped"
+    ARCHIVED = "archived"
     FAILED = "failed"
 
 
@@ -182,6 +187,9 @@ class InternSyncSessionCreateRequest(_StrictContract):
     idempotency_key: str = Field(min_length=1, max_length=512)
     binding: InternRuntimeBinding = Field(default_factory=InternRuntimeBinding)
     metadata: dict[str, Any] = Field(default_factory=dict)
+    execution_mode: Literal["fast", "standard", "deep"] = "standard"
+    task_template: str | None = Field(default=None, min_length=1, max_length=128)
+    objective_bounds: dict[str, Any] | None = None
 
 
 class SyncTemplateProvisionedResource(_StrictContract):
@@ -317,12 +325,16 @@ class InternSyncSession(_StrictContract):
     state_generation: int = Field(ge=0)
     last_event_sequence: int = Field(ge=0)
     binding: InternRuntimeBinding
+    metadata: dict[str, Any] = Field(default_factory=dict)
+    objective_bounds: dict[str, Any] | None = None
     pending_turn_id: str | None = None
     pending_action_id: str | None = None
     pending_interaction_id: str | None = None
     outcome: InternRuntimeOutcome | None = None
     failure_code: str | None = None
     temporal_workflow_id: str
+    execution_mode: Literal["fast", "standard", "deep"] = "standard"
+    execution_profile_id: Literal["intern_sync"] = "intern_sync"
     # 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.
@@ -331,6 +343,10 @@ class InternSyncSession(_StrictContract):
     trace_publication: SyncTracePublicationReceipt | None = None
     kit_associations: tuple[SyncKitAssociationReceipt, ...] = ()
     kit_readiness: SyncKitReadiness | None = None
+    visuals: tuple[dict[str, Any], ...] = ()
+    kit_state_receipts: tuple[dict[str, Any], ...] = ()
+    experiments: tuple[dict[str, Any], ...] = ()
+    harness_bundle_available: bool = False
     created_at: datetime
     updated_at: datetime
     closed_at: datetime | None = None
@@ -342,6 +358,10 @@ class InternSyncCommandRequest(_StrictContract):
     expected_generation: int = Field(ge=0)
     command_kind: InternSyncCommandKind
     payload: dict[str, Any] = Field(default_factory=dict)
+    execution_mode: Literal["fast", "standard", "deep"] = "standard"
+    visual_selection: dict[str, Any] | None = None
+    mode: Literal["sync", "async"] = "sync"
+    evidence_refs: tuple[str, ...] = Field(default=(), max_length=128)
 
     @model_validator(mode="after")
     def validate_command_payload(self) -> InternSyncCommandRequest:
@@ -370,6 +390,32 @@ class InternSyncCommandRequest(_StrictContract):
         return self
 
 
+class InternSyncDeployPacketEndpoint(_StrictContract):
+    purpose: Literal[
+        "upload_files",
+        "upload_workspace",
+        "confirm_push",
+        "assign_container",
+        "container_health",
+    ]
+    method: Literal["GET", "POST"]
+    path: str
+
+
+class InternSyncDeployPacket(_StrictContract):
+    schema_version: Literal["smr.intern-sync-deploy-packet.v1"]
+    sync_session_id: str
+    project_id: str
+    task_template: str | None = None
+    auth_scheme: Literal["bearer"]
+    auth_env_var: Literal["SYNTH_API_KEY"]
+    required_paths: tuple[str, ...] = ()
+    endpoints: tuple[InternSyncDeployPacketEndpoint, ...]
+    done_signal: Literal["workspace_confirm_push"]
+    image_kind: Literal["craftax_eval"]
+    instructions: str
+
+
 class InternSyncCommandReceipt(_StrictContract):
     schema_version: Literal["smr.intern-runtime-command-receipt.v1"]
     command_id: str

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609}/synth_ai/sdk/research/public.py

@@ -166,6 +166,8 @@ from synth_ai.sdk.research.contracts import (
     InternSyncCommandKind,
     InternSyncCommandReceipt,
     InternSyncCommandRequest,
+    InternSyncDeployPacket,
+    InternSyncDeployPacketEndpoint,
     InternSyncEvent,
     InternSyncEventPage,
     InternSyncEventStreamEnvelope,
@@ -493,6 +495,8 @@ __all__ = [
     "InternSyncCommandKind",
     "InternSyncCommandReceipt",
     "InternSyncCommandRequest",
+    "InternSyncDeployPacket",
+    "InternSyncDeployPacketEndpoint",
     "InternSyncEvent",
     "InternSyncEventPage",
     "InternSyncEventStreamEnvelope",

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609}/synth_ai/sdk/research/research_intern.py

@@ -60,6 +60,7 @@ from synth_ai.sdk.research.contracts.research_intern import (
     InternSyncCommandKind,
     InternSyncCommandReceipt,
     InternSyncCommandRequest,
+    InternSyncDeployPacket,
     InternSyncEvent,
     InternSyncEventPage,
     InternSyncEventStreamEnvelope,
@@ -2134,6 +2135,19 @@ class ResearchInternSyncRuntimeAPI:
             raise ValueError("Sync Intern session identity drifted")
         return session
 
+    def deploy_packet(self, sync_session_id: str) -> InternSyncDeployPacket:
+        packet = InternSyncDeployPacket.from_wire(
+            self._transport.execute(
+                _request(
+                    "get_intern_sync_deploy_packet",
+                    f"{self._PATH}/{sync_session_id}/deploy-packet",
+                )
+            )
+        )
+        if packet.sync_session_id != sync_session_id:
+            raise ValueError("Sync Intern deploy packet identity drifted")
+        return packet
+
     def command(
         self,
         sync_session_id: str,
@@ -2562,6 +2576,25 @@ class ResearchInternAsyncRuntimeAPI:
             after_sequence=after_sequence,
         )
 
+    def mcp_actions(self, *, limit: int = 100) -> tuple[JsonObject, ...]:
+        """Read the shared runtime MCP-action ledger for this Async Intern."""
+
+        runtime_id = self.get().async_runtime_id
+        response = self._transport.execute(
+            _request(
+                "list_intern_async_runtime_mcp_actions",
+                f"/smr/research-intern/runtimes/async/{runtime_id}/mcp-actions",
+                query={"limit": _bounded_limit(limit)},
+            )
+        )
+        items = array_value(
+            cast(JsonValue, response),
+            operation_id="list_intern_async_runtime_mcp_actions",
+        )
+        if any(not isinstance(item, dict) for item in items):
+            raise ValueError("Async Intern MCP-action ledger must contain objects")
+        return tuple(cast(JsonObject, item) for item in items)
+
     def stream_events(
         self,
         *,

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609}/synth_ai/sdk/research/session/factories.py

@@ -219,6 +219,7 @@ def _wake_due_preview_kwargs(plan: Mapping[str, Any]) -> dict[str, Any]:
             field="wake_due.launch_request",
         )
         or None,
+        "effort_ids": tuple(str(value) for value in wake_due.get("effort_ids") or []),
         "limit": int(wake_due.get("limit") or 10),
         "allow_overlap": bool(wake_due.get("allow_overlap") or False),
         "continue_on_error": bool(wake_due.get("continue_on_error", True)),
@@ -1170,6 +1171,7 @@ class FactoriesAPI(_ClientNamespace):
         factory_id: str,
         *,
         launch_request: Mapping[str, Any] | dict[str, Any] | None = None,
+        effort_ids: tuple[str, ...] = (),
         limit: int = 10,
         allow_overlap: bool = False,
         dry_run: bool = False,
@@ -1190,6 +1192,7 @@ class FactoriesAPI(_ClientNamespace):
                 factory_id,
                 FactoryWakeDueRequest(
                     launch_request=dict(launch_request) if launch_request else None,
+                    effort_ids=effort_ids,
                     limit=limit,
                     allow_overlap=allow_overlap,
                     dry_run=dry_run,

{synth_ai-0.18.2.dev607 → synth_ai-0.18.2.dev609/synth_ai.egg-info}/PKG-INFO

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