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

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

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

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

@@ -212,8 +212,7 @@ def build_workspace_input_tools(
                 "Confirm an already-pushed workspace commit through project "
                 "authority and return the typed WorkspacePushConfirmationReceipt "
                 "-- the done signal for coding agents driving workspace ingress "
-                "over MCP. If the project is bound to an open Sync session, the "
-                "backend also auto-records a kit-association receipt server-side."
+                "over MCP."
             ),
             input_schema=tool_schema(
                 {

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

@@ -350,15 +350,10 @@ from synth_ai.sdk.research.contracts.research_intern import (
     ResearchInternTurnRequest,
     ResearchInternTurnResponse,
     ResearchInternTurnStatus,
-    SyncKitAssociatedFile,
-    SyncKitAssociationReceipt,
-    SyncKitIngressKind,
-    SyncKitIngressObservation,
-    SyncKitIngressSource,
-    SyncKitReadiness,
-    SyncTemplateProvisionedResource,
-    SyncTemplateProvisioningReceipt,
     SyncTracePublicationReceipt,
+    SyncWorkspaceRunReceipt,
+    SyncWorkspaceSnapshotIdentity,
+    SyncWorkspaceSnapshotKind,
 )
 from synth_ai.sdk.research.contracts.runtime_stream import (
     SwarmEvent,
@@ -934,15 +929,10 @@ __all__ = [
     "SwarmTerminalOutcomeMissingError",
     "SwarmEnvironment",
     "SwarmUsage",
-    "SyncKitAssociatedFile",
-    "SyncKitAssociationReceipt",
-    "SyncKitIngressKind",
-    "SyncKitIngressObservation",
-    "SyncKitIngressSource",
-    "SyncKitReadiness",
-    "SyncTemplateProvisionedResource",
-    "SyncTemplateProvisioningReceipt",
     "SyncTracePublicationReceipt",
+    "SyncWorkspaceRunReceipt",
+    "SyncWorkspaceSnapshotIdentity",
+    "SyncWorkspaceSnapshotKind",
     "TaskId",
     "TranscriptCursor",
     "TranscriptCursorKind",

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

@@ -188,40 +188,9 @@ class InternSyncSessionCreateRequest(_StrictContract):
     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):
-    """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.
 
@@ -247,76 +216,59 @@ class SyncTracePublicationReceipt(_StrictContract):
     published_at: datetime | None = None
 
 
-SyncKitIngressKind = Literal[
-    "website_upload",
-    "sdk_upload",
-    "git_push",
-    "project_files",
+SyncWorkspaceSnapshotKind = Literal[
+    "internal_git_head",
+    "stored_file_digest_set",
+    "internal_git_head_with_stored_files",
 ]
 
-SyncKitIngressObservation = Literal[
-    "stored_file_write",
-    "push_confirmation",
-    "upload_url_issuance",
-]
 
+class SyncWorkspaceSnapshotIdentity(_StrictContract):
+    """Provable project workspace identity captured when a run is triggered."""
 
-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."""
-
+    schema_version: Literal["smr.intern-sync-workspace-snapshot.v1"] = (
+        "smr.intern-sync-workspace-snapshot.v1"
+    )
+    kind: SyncWorkspaceSnapshotKind
     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, ...] = ()
+    inventory_digest: str | None = Field(default=None, pattern=r"^sha256:[0-9a-f]{64}$")
+    file_count: int | None = Field(default=None, ge=1)
+    captured_at: datetime
 
+    @model_validator(mode="after")
+    def require_identity_per_kind(self) -> SyncWorkspaceSnapshotIdentity:
+        if self.kind == "internal_git_head" and not self.commit_sha:
+            raise ValueError("internal_git_head snapshot requires commit_sha")
+        if self.kind == "stored_file_digest_set" and (
+            not self.inventory_digest or not self.file_count
+        ):
+            raise ValueError(
+                "stored_file_digest_set snapshot requires the inventory digest and file count"
+            )
+        if self.kind == "internal_git_head_with_stored_files" and (
+            not self.commit_sha or not self.inventory_digest or not self.file_count
+        ):
+            raise ValueError(
+                "internal_git_head_with_stored_files snapshot requires commit_sha, "
+                "the inventory digest, and file count"
+            )
+        return self
 
-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.
-    """
+class SyncWorkspaceRunReceipt(_StrictContract):
+    """Server-minted proof of the project workspace used to trigger one run."""
 
-    schema_version: Literal["smr.intern-sync-kit-association.v1"]
-    receipt_id: str
+    schema_version: Literal["smr.intern-sync-workspace-run.v1"] = "smr.intern-sync-workspace-run.v1"
+    run_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
+    experiment_id: str | None = None
+    workspace: SyncWorkspaceSnapshotIdentity
+    recorded_at: datetime
 
 
 class InternSyncSession(_StrictContract):
-    schema_version: Literal["smr.intern-sync-session.v1"]
+    schema_version: Literal["smr.intern-sync-session.v1"] = "smr.intern-sync-session.v1"
     sync_session_id: str
     research_intern_id: str
     org_id: str
@@ -333,18 +285,11 @@ class InternSyncSession(_StrictContract):
     outcome: InternRuntimeOutcome | None = None
     failure_code: str | None = None
     temporal_workflow_id: str
-    execution_mode: Literal["fast", "standard", "deep"] = "standard"
+    execution_mode: Literal["fast", "standard", "deep"]
     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.
-    task_template: str | None = None
-    provisioning: SyncTemplateProvisioningReceipt | None = None
     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], ...] = ()
+    workspace_run_receipts: tuple[SyncWorkspaceRunReceipt, ...] = ()
     experiments: tuple[dict[str, Any], ...] = ()
     harness_bundle_available: bool = False
     created_at: datetime
@@ -406,13 +351,11 @@ 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"]
+    image_kind: Literal["project_default"]
     instructions: str
 
 
@@ -560,6 +503,10 @@ class InternAsyncRuntime(_StrictContract):
     pending_interaction_id: str | None = None
     pending_action_id: str | None = None
     pending_actor_message_id: str | None = None
+    # A successful Manderqueue publish is not an actor reply. These identities
+    # stay projected until reconciliation observes a correlated response.
+    awaiting_actor_reply_message_id: str | None = None
+    awaiting_actor_reply_thread_id: str | None = None
     pending_instruction_count: int = Field(default=0, ge=0, le=32)
     binding: InternRuntimeBinding
     external_execution_status: InternAsyncExternalExecutionStatus
@@ -583,6 +530,11 @@ class InternAsyncRuntime(_StrictContract):
             and self.evidence_readiness is not InternAsyncEvidenceReadiness.READY
         ):
             raise ValueError("completed Async Intern requires ready evidence")
+        if self.status is InternAsyncStatus.COMPLETED and (
+            self.awaiting_actor_reply_message_id is not None
+            or self.awaiting_actor_reply_thread_id is not None
+        ):
+            raise ValueError("completed Async Intern cannot await an actor reply")
         return self
 
 

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

@@ -299,15 +299,10 @@ from synth_ai.sdk.research.contracts import (
     SwarmTranscriptEvent,
     SwarmTranscriptPage,
     SwarmUsage,
-    SyncKitAssociatedFile,
-    SyncKitAssociationReceipt,
-    SyncKitIngressKind,
-    SyncKitIngressObservation,
-    SyncKitIngressSource,
-    SyncKitReadiness,
-    SyncTemplateProvisionedResource,
-    SyncTemplateProvisioningReceipt,
     SyncTracePublicationReceipt,
+    SyncWorkspaceRunReceipt,
+    SyncWorkspaceSnapshotIdentity,
+    SyncWorkspaceSnapshotKind,
     TaskId,
     TokenCounts,
     TokenUsage,
@@ -769,15 +764,10 @@ __all__ = [
     "SwarmTranscriptEvent",
     "SwarmTranscriptPage",
     "SwarmUsage",
-    "SyncKitAssociatedFile",
-    "SyncKitAssociationReceipt",
-    "SyncKitIngressKind",
-    "SyncKitIngressObservation",
-    "SyncKitIngressSource",
-    "SyncKitReadiness",
-    "SyncTemplateProvisionedResource",
-    "SyncTemplateProvisioningReceipt",
     "SyncTracePublicationReceipt",
+    "SyncWorkspaceRunReceipt",
+    "SyncWorkspaceSnapshotIdentity",
+    "SyncWorkspaceSnapshotKind",
     "TaskId",
     "ToolProvider",
     "TokenCounts",

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

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