synth-ai 0.22.2.dev681__tar.gz → 0.22.2.dev682__tar.gz

{synth_ai-0.22.2.dev681/synth_ai.egg-info → synth_ai-0.22.2.dev682}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.22.2.dev681
+Version: 0.22.2.dev682
 Summary: Python SDK, CLI and MCP servers for Synth Index search and Swarms
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT

{synth_ai-0.22.2.dev681 → synth_ai-0.22.2.dev682}/openapi/research-v1.json

@@ -1274,6 +1274,15 @@
           "binding": {
             "$ref": "#/components/schemas/RuntimeBinding"
           },
+          "bootstrap_mode": {
+            "default": "autonomous",
+            "enum": [
+              "autonomous",
+              "observe_existing_run"
+            ],
+            "title": "Bootstrap Mode",
+            "type": "string"
+          },
           "budget": {
             "$ref": "#/components/schemas/AsyncRuntimeBudget"
           },
@@ -2132,7 +2141,7 @@
       "Body_publish_project_visual_smr_projects__project_id__visuals_post": {
         "properties": {
           "html": {
-            "contentMediaType": "application/octet-stream",
+            "format": "binary",
             "title": "Html",
             "type": "string"
           },
@@ -2144,7 +2153,7 @@
           "preview_png": {
             "anyOf": [
               {
-                "contentMediaType": "application/octet-stream",
+                "format": "binary",
                 "type": "string"
               },
               {
@@ -2204,7 +2213,7 @@
       "Body_publish_run_visual_smr_runs__run_id__visuals_post": {
         "properties": {
           "html": {
-            "contentMediaType": "application/octet-stream",
+            "format": "binary",
             "title": "Html",
             "type": "string"
           },
@@ -2216,7 +2225,7 @@
           "preview_png": {
             "anyOf": [
               {
-                "contentMediaType": "application/octet-stream",
+                "format": "binary",
                 "type": "string"
               },
               {
@@ -5081,6 +5090,127 @@
         "title": "HTTPValidationError",
         "type": "object"
       },
+      "HistoryDecision": {
+        "additionalProperties": false,
+        "properties": {
+          "events_digest": {
+            "pattern": "^[0-9a-f]{64}$",
+            "title": "Events Digest",
+            "type": "string"
+          },
+          "input_digest": {
+            "pattern": "^[0-9a-f]{64}$",
+            "title": "Input Digest",
+            "type": "string"
+          },
+          "intents_digest": {
+            "pattern": "^[0-9a-f]{64}$",
+            "title": "Intents Digest",
+            "type": "string"
+          },
+          "reason": {
+            "minLength": 1,
+            "title": "Reason",
+            "type": "string"
+          },
+          "sequence": {
+            "maximum": 1.8446744073709552e+19,
+            "minimum": 0.0,
+            "title": "Sequence",
+            "type": "integer"
+          },
+          "state_after_digest": {
+            "pattern": "^[0-9a-f]{64}$",
+            "title": "State After Digest",
+            "type": "string"
+          },
+          "state_before_digest": {
+            "pattern": "^[0-9a-f]{64}$",
+            "title": "State Before Digest",
+            "type": "string"
+          },
+          "wakes_digest": {
+            "pattern": "^[0-9a-f]{64}$",
+            "title": "Wakes Digest",
+            "type": "string"
+          }
+        },
+        "required": [
+          "sequence",
+          "reason",
+          "input_digest",
+          "state_before_digest",
+          "state_after_digest",
+          "intents_digest",
+          "events_digest",
+          "wakes_digest"
+        ],
+        "title": "HistoryDecision",
+        "type": "object"
+      },
+      "HistoryEntry": {
+        "additionalProperties": false,
+        "properties": {
+          "causation_id": {
+            "minLength": 1,
+            "title": "Causation Id",
+            "type": "string"
+          },
+          "command_id": {
+            "minLength": 1,
+            "title": "Command Id",
+            "type": "string"
+          },
+          "decision": {
+            "$ref": "#/components/schemas/HistoryDecision"
+          },
+          "generation": {
+            "maximum": 1.8446744073709552e+19,
+            "minimum": 0.0,
+            "title": "Generation",
+            "type": "integer"
+          },
+          "input": {
+            "additionalProperties": {
+              "$ref": "#/components/schemas/JsonValue"
+            },
+            "title": "Input",
+            "type": "object"
+          },
+          "occurred_at_ms": {
+            "title": "Occurred At Ms",
+            "type": "integer"
+          },
+          "recorded_at_ms": {
+            "title": "Recorded At Ms",
+            "type": "integer"
+          },
+          "sequence": {
+            "maximum": 1.8446744073709552e+19,
+            "minimum": 0.0,
+            "title": "Sequence",
+            "type": "integer"
+          },
+          "source_id": {
+            "minLength": 1,
+            "title": "Source Id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "sequence",
+          "generation",
+          "command_id",
+          "causation_id",
+          "source_id",
+          "occurred_at_ms",
+          "recorded_at_ms",
+          "input",
+          "decision"
+        ],
+        "title": "HistoryEntry",
+        "type": "object"
+      },
       "ImageReleaseArtifact": {
         "additionalProperties": false,
         "properties": {
@@ -13774,6 +13904,63 @@
         "title": "ResumeKind",
         "type": "string"
       },
+      "RunHistoryPage": {
+        "additionalProperties": false,
+        "properties": {
+          "after": {
+            "maximum": 1.8446744073709552e+19,
+            "minimum": 0.0,
+            "title": "After",
+            "type": "integer"
+          },
+          "entries": {
+            "items": {
+              "$ref": "#/components/schemas/HistoryEntry"
+            },
+            "maxItems": 256,
+            "title": "Entries",
+            "type": "array"
+          },
+          "head_sequence": {
+            "maximum": 1.8446744073709552e+19,
+            "minimum": 0.0,
+            "title": "Head Sequence",
+            "type": "integer"
+          },
+          "next_after": {
+            "anyOf": [
+              {
+                "maximum": 1.8446744073709552e+19,
+                "minimum": 0.0,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next After"
+          },
+          "run_id": {
+            "title": "Run Id",
+            "type": "string"
+          },
+          "schema_version": {
+            "const": "orchestra.journal_inspection.v1",
+            "title": "Schema Version",
+            "type": "string"
+          }
+        },
+        "required": [
+          "schema_version",
+          "run_id",
+          "head_sequence",
+          "after",
+          "entries",
+          "next_after"
+        ],
+        "title": "RunHistoryPage",
+        "type": "object"
+      },
       "RunLifecycleEnqueueStatus": {
         "description": "Public route acknowledgement status, not run lifecycle authority.",
         "enum": [
@@ -14386,6 +14573,7 @@
       },
       "SmrAgentModel": {
         "enum": [
+          "openrouter/openai/gpt-6-luna",
           "openrouter/openai/gpt-5.6-luna",
           "openai-api/gpt-5.6-luna",
           "openai-api/gpt-6-luna",
@@ -15674,6 +15862,7 @@
         "type": "object"
       },
       "SmrDeploymentPinRequest": {
+        "additionalProperties": false,
         "description": "One repository's resolved deployment receipt for run provenance.\n\nMirrors ``packages.smr.run_provenance.DeploymentPin``; validated and\ndigest-stamped at launch by the provenance binding authority.",
         "properties": {
           "artifact_digest": {
@@ -21582,6 +21771,30 @@
         "title": "SmrInlineExternalRepositoryBindingRequest",
         "type": "object"
       },
+      "SmrLaunchHoldRequirementsResponse": {
+        "properties": {
+          "minimum_run_ceiling_micros": {
+            "minimum": 1.0,
+            "title": "Minimum Run Ceiling Micros",
+            "type": "integer"
+          },
+          "roles": {
+            "items": {
+              "$ref": "#/components/schemas/SmrLaunchRoleHoldResponse"
+            },
+            "maxItems": 3,
+            "minItems": 3,
+            "title": "Roles",
+            "type": "array"
+          }
+        },
+        "required": [
+          "roles",
+          "minimum_run_ceiling_micros"
+        ],
+        "title": "SmrLaunchHoldRequirementsResponse",
+        "type": "object"
+      },
       "SmrLaunchPreflightCheckResponse": {
         "properties": {
           "code": {
@@ -21662,6 +21875,18 @@
             ],
             "title": "Blocked Reason"
           },
+          "delivery_limits": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Delivery Limits"
+          },
           "inline_repository_names": {
             "items": {
               "type": "string"
@@ -21676,6 +21901,13 @@
             "title": "Missing Credential Ref Ids",
             "type": "array"
           },
+          "missing_model_file_ids": {
+            "items": {
+              "type": "string"
+            },
+            "title": "Missing Model File Ids",
+            "type": "array"
+          },
           "missing_repository_ids": {
             "items": {
               "type": "string"
@@ -21694,6 +21926,13 @@
             "title": "Selected Credential Ref Ids",
             "type": "array"
           },
+          "selected_model_file_ids": {
+            "items": {
+              "type": "string"
+            },
+            "title": "Selected Model File Ids",
+            "type": "array"
+          },
           "selected_repository_ids": {
             "items": {
               "type": "string"
@@ -21801,6 +22040,16 @@
             ],
             "title": "Effective Plan"
           },
+          "hold_requirements": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/SmrLaunchHoldRequirementsResponse"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "launch_mode": {
             "anyOf": [
               {
@@ -21998,6 +22247,30 @@
         "title": "SmrLaunchPreflightRuntimeReadinessResponse",
         "type": "object"
       },
+      "SmrLaunchRoleHoldResponse": {
+        "properties": {
+          "hold_micros": {
+            "minimum": 1.0,
+            "title": "Hold Micros",
+            "type": "integer"
+          },
+          "role": {
+            "enum": [
+              "orchestrator",
+              "reviewer",
+              "worker"
+            ],
+            "title": "Role",
+            "type": "string"
+          }
+        },
+        "required": [
+          "role",
+          "hold_micros"
+        ],
+        "title": "SmrLaunchRoleHoldResponse",
+        "type": "object"
+      },
       "SmrLocalExecutionRequest": {
         "properties": {
           "dispatch_pool": {
@@ -23325,7 +23598,7 @@
                 "type": "null"
               }
             ],
-            "description": "Override one shared agent model for this run. Shared top-level values are 'baseten/moonshotai/Kimi-K3', 'baseten/zai-org/GLM-5.2', 'cursor/composer-2.5', 'deepseek/deepseek-v4-flash', 'deepseek/deepseek-v4-flash-direct', 'deepseek/deepseek-v4-pro', 'deepseek/deepseek-v4-pro-direct', 'gpt-5.4', 'gpt-5.4-mini', 'gpt-5.5', 'gpt-5.6-luna', 'modal/moonshotai/Kimi-K3', 'openai-api/gpt-5.6-luna', 'openai-api/gpt-6-luna', 'openrouter/openai/gpt-5.6-luna', 'openrouter/poolside/laguna-s-2.1', 'poolside/laguna-s-2.1', 'synth_internal/laguna-s-2.1-nvfp4'. Use actor_model_overrides for actor-specific model selection."
+            "description": "Override one shared agent model for this run. Shared top-level values are 'baseten/moonshotai/Kimi-K3', 'baseten/zai-org/GLM-5.2', 'cursor/composer-2.5', 'deepseek/deepseek-v4-flash', 'deepseek/deepseek-v4-flash-direct', 'deepseek/deepseek-v4-pro', 'deepseek/deepseek-v4-pro-direct', 'gpt-5.4', 'gpt-5.4-mini', 'gpt-5.5', 'gpt-5.6-luna', 'modal/moonshotai/Kimi-K3', 'openai-api/gpt-5.6-luna', 'openai-api/gpt-6-luna', 'openrouter/openai/gpt-5.6-luna', 'openrouter/openai/gpt-6-luna', 'openrouter/poolside/laguna-s-2.1', 'poolside/laguna-s-2.1', 'synth_internal/laguna-s-2.1-nvfp4'. Use actor_model_overrides for actor-specific model selection."
           },
           "agent_model_params": {
             "anyOf": [
@@ -23366,19 +23639,13 @@
             "title": "Ai Cache"
           },
           "deployment_pins": {
-            "anyOf": [
-              {
-                "items": {
-                  "$ref": "#/components/schemas/SmrDeploymentPinRequest"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Resolved deployment receipts binding this run to exact frozen deployments (one pin per participating repository). Required when provenance_mode is set; placeholder pins are refused in live mode.",
-            "title": "Deployment Pins"
+            "description": "Resolved deployment receipts binding this run to exact frozen deployments (one pin per participating repository). Non-empty pins are required in both modes; placeholders are refused in live mode.",
+            "items": {
+              "$ref": "#/components/schemas/SmrDeploymentPinRequest"
+            },
+            "minItems": 1,
+            "title": "Deployment Pins",
+            "type": "array"
           },
           "dev_environment_id": {
             "anyOf": [
@@ -23632,20 +23899,13 @@
             ]
           },
           "provenance_mode": {
-            "anyOf": [
-              {
-                "enum": [
-                  "live",
-                  "dry_run"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
+            "description": "Run provenance posture; required. 'live' requires non-placeholder deployment_pins and a provisioned Factory trace store; 'dry_run' validates pin shape and still requires a Factory-linked run's trace store. Omitted refuses provenance_unbound.",
+            "enum": [
+              "live",
+              "dry_run"
             ],
-            "description": "Sealed-run provenance posture. 'live' requires non-placeholder deployment_pins and a provisioned Factory trace store; 'dry_run' validates shape only. Omit for ordinary (non-sealed) runs.",
-            "title": "Provenance Mode"
+            "title": "Provenance Mode",
+            "type": "string"
           },
           "provider": {
             "anyOf": [
@@ -23696,14 +23956,7 @@
             "type": "array"
           },
           "resource_bindings": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/SmrRunResourceBindingsRequest"
-              },
-              {
-                "type": "null"
-              }
-            ]
+            "$ref": "#/components/schemas/SmrRunResourceBindingsRequest"
           },
           "roles": {
             "anyOf": [
@@ -23842,6 +24095,11 @@
             "title": "Worker Pool Id"
           }
         },
+        "required": [
+          "deployment_pins",
+          "provenance_mode",
+          "resource_bindings"
+        ],
         "title": "SmrProjectTriggerRequest",
         "type": "object"
       },
@@ -27859,8 +28117,20 @@
             },
             "title": "External Repository Ids",
             "type": "array"
+          },
+          "model_file_ids": {
+            "items": {
+              "type": "string"
+            },
+            "title": "Model File Ids",
+            "type": "array"
           }
         },
+        "required": [
+          "model_file_ids",
+          "external_repository_ids",
+          "credential_ref_ids"
+        ],
         "title": "SmrRunResourceBindingsRequest",
         "type": "object"
       },
@@ -29625,6 +29895,19 @@
             "title": "Execution Policy",
             "type": "object"
           },
+          "idempotency_key": {
+            "anyOf": [
+              {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Idempotency Key"
+          },
           "integrations": {
             "additionalProperties": true,
             "title": "Integrations",
@@ -38570,13 +38853,6 @@
       },
       "ValidationError": {
         "properties": {
-          "ctx": {
-            "title": "Context",
-            "type": "object"
-          },
-          "input": {
-            "title": "Input"
-          },
           "loc": {
             "items": {
               "anyOf": [
@@ -45472,7 +45748,7 @@
     },
     "/smr/projects/{project_id}/launch-preflight": {
       "post": {
-        "description": "Canonical launch-preflight evaluation for a concrete project-scoped run request.",
+        "description": "Canonical launch-preflight evaluation for a concrete project-scoped run request. Against a slot_authority placement it resolves the placement the trigger will redeem, so it requires the trigger's idempotency_key_run_create (or idempotency_key); without one it refuses 422 placement_operation_id_required.",
         "operationId": "preflight_project_run",
         "parameters": [
           {
@@ -51548,6 +51824,72 @@
         ]
       }
     },
+    "/smr/runs/{run_id}/history": {
+      "get": {
+        "operationId": "retrieve_swarm_history",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "run_id",
+            "required": true,
+            "schema": {
+              "title": "Run Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "query",
+            "name": "after",
+            "required": false,
+            "schema": {
+              "default": 0,
+              "maximum": 18446744073709551615,
+              "minimum": 0,
+              "title": "After",
+              "type": "integer"
+            }
+          },
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "default": 100,
+              "maximum": 256,
+              "minimum": 1,
+              "title": "Limit",
+              "type": "integer"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RunHistoryPage"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "summary": "Read Run History",
+        "tags": [
+          "smr"
+        ]
+      }
+    },
     "/smr/runs/{run_id}/limit-evidence": {
       "get": {
         "description": "Return allow-listed durable warning, enforcement, and extension evidence.",

{synth_ai-0.22.2.dev681 → synth_ai-0.22.2.dev682}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.22.2.dev681"
+version = "0.22.2.dev682"
 description = "Python SDK, CLI and MCP servers for Synth Index search and Swarms"
 keywords = ["synth", "index", "search", "citations", "research", "swarms", "mcp", "sdk"]
 authors = [{name = "Synth AI", email = "josh@usesynth.ai"}]
@@ -117,6 +117,7 @@ dev = [
     "build>=1.2.2.post1",
     "twine>=4.0.0",
     "keyring>=24.0.0",
+    "jsonschema>=4.18,<5",
     "pytest>=8.3.3",
     "pytest-xdist>=3.6.1",
     "pytest-timeout>=2.3.1",

{synth_ai-0.22.2.dev681 → synth_ai-0.22.2.dev682}/synth_ai/core/http/retry.py

@@ -92,6 +92,9 @@ def should_retry_failure(
     ):
         return False
     if isinstance(error, SynthError):
+        if error.failure is not None:
+            # The first-class directive is authoritative, including an explicit false.
+            return error.failure.retry.retryable
         if error.retryable:
             return True
         status = None

{synth_ai-0.22.2.dev681 → synth_ai-0.22.2.dev682}/synth_ai/mcp/research/registry.py

@@ -112,9 +112,6 @@ _DEFAULT_REQUIRED_SCOPES_BY_TOOL_NAME: dict[str, tuple[str, ...]] = {
     "research_download_raw_trace": READ_SCOPES,
     "research_get_run_actor_usage": READ_SCOPES,
     "research_control_project_run_actor": WRITE_SCOPES,
-    "research_list_run_participants": READ_SCOPES,
-    "research_get_run_artifact_progress": READ_SCOPES,
-    "research_list_run_actor_logs": READ_SCOPES,
     "research_list_tasks": READ_SCOPES,
     "research_create_task": WRITE_SCOPES,
     "research_update_task": WRITE_SCOPES,