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

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

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

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

@@ -39,6 +39,7 @@ except _PackageNotFoundError:
 __all__ = [
     "AsyncResearchInternReactiveSession",
     "AsyncSynthClient",
+    "AsyncOptimizersClient",
     "DataBindingCreateRequest",
     "DatasetRevisionCreateRequest",
     "DatasetRevisionFinalizeRequest",
@@ -99,9 +100,30 @@ __all__ = [
     "ResearchVisualPromotionRequest",
     "ResearchVisualVersions",
     "SynthClient",
+    "OptimizersClient",
+    "OptimizerRunOutputs",
+    "SavedLoraCheckpoint",
+    "SavedLoraCheckpointPage",
+    "SavedLoraLineage",
+    "SavedLoraRunPage",
+    "HostedTrainingModelCatalog",
 ]
 
 _EXPORTS: dict[str, tuple[str, str]] = {
+    "AsyncOptimizersClient": ("synth_ai.sdk.optimizers", "AsyncOptimizersClient"),
+    "HostedTrainingModelCatalog": (
+        "synth_ai.sdk.optimizers",
+        "HostedTrainingModelCatalog",
+    ),
+    "OptimizersClient": ("synth_ai.sdk.optimizers", "OptimizersClient"),
+    "OptimizerRunOutputs": ("synth_ai.sdk.optimizers", "OptimizerRunOutputs"),
+    "SavedLoraCheckpoint": ("synth_ai.sdk.optimizers", "SavedLoraCheckpoint"),
+    "SavedLoraCheckpointPage": (
+        "synth_ai.sdk.optimizers",
+        "SavedLoraCheckpointPage",
+    ),
+    "SavedLoraLineage": ("synth_ai.sdk.optimizers", "SavedLoraLineage"),
+    "SavedLoraRunPage": ("synth_ai.sdk.optimizers", "SavedLoraRunPage"),
     "AsyncResearchInternReactiveSession": (
         "synth_ai.sdk.research.research_intern",
         "AsyncResearchInternReactiveSession",

{synth_ai-0.18.2.dev613 → synth_ai-0.18.2.dev615}/synth_ai/client.py

@@ -9,6 +9,7 @@ from synth_ai.core.auth.credentials import resolve_api_credential
 from synth_ai.core.utils.urls import BACKEND_URL_BASE, normalize_backend_base
 
 if TYPE_CHECKING:
+    from synth_ai.sdk.optimizers import AsyncOptimizersClient, OptimizersClient
     from synth_ai.sdk.research import AsyncResearchClient
     from synth_ai.sdk.research.facade import ResearchClient
 
@@ -22,10 +23,10 @@ def _resolve_base_url(base_url: str | None) -> str:
 
 
 class SynthClient:
-    """Sync client for Managed Research.
+    """Sync client for Managed Research and hosted optimizers.
 
     Use ``research`` for hosted projects, swarms, and Factory lifecycles. That
-    is the whole client: there is no container, tunnel, or pool namespace.
+    Use ``optimizers`` for hosted training model discovery and saved LoRAs.
     """
 
     def __init__(
@@ -41,6 +42,7 @@ class SynthClient:
         self.timeout_seconds = timeout_seconds
         self.allow_legacy_intern_sessions = allow_legacy_intern_sessions
         self._research_client: ResearchClient | None = None
+        self._optimizers_client: OptimizersClient | None = None
 
     @property
     def research(self) -> ResearchClient:
@@ -61,6 +63,22 @@ class SynthClient:
         if self._research_client is not None:
             self._research_client.close()
             self._research_client = None
+        if self._optimizers_client is not None:
+            self._optimizers_client.close()
+            self._optimizers_client = None
+
+    @property
+    def optimizers(self) -> OptimizersClient:
+        """Hosted training models and searchable saved-LoRA lineage."""
+        if self._optimizers_client is None:
+            from synth_ai.sdk.optimizers import OptimizersClient
+
+            self._optimizers_client = OptimizersClient(
+                api_key=self.api_key,
+                base_url=self.base_url,
+                timeout_seconds=self.timeout_seconds,
+            )
+        return self._optimizers_client
 
     def __enter__(self) -> SynthClient:
         return self
@@ -70,7 +88,7 @@ class SynthClient:
 
 
 class AsyncSynthClient:
-    """Async client for Managed Research."""
+    """Async client for Managed Research and hosted optimizers."""
 
     def __init__(
         self,
@@ -85,6 +103,7 @@ class AsyncSynthClient:
         self.timeout_seconds = timeout_seconds
         self.allow_legacy_intern_sessions = allow_legacy_intern_sessions
         self._async_research_client: AsyncResearchClient | None = None
+        self._async_optimizers_client: AsyncOptimizersClient | None = None
 
     @property
     def research(self) -> AsyncResearchClient:
@@ -115,6 +134,22 @@ class AsyncSynthClient:
         if self._async_research_client is not None:
             await self._async_research_client.close()
             self._async_research_client = None
+        if self._async_optimizers_client is not None:
+            await self._async_optimizers_client.close()
+            self._async_optimizers_client = None
+
+    @property
+    def optimizers(self) -> AsyncOptimizersClient:
+        """Native asynchronous hosted optimizer namespace."""
+        if self._async_optimizers_client is None:
+            from synth_ai.sdk.optimizers import AsyncOptimizersClient
+
+            self._async_optimizers_client = AsyncOptimizersClient(
+                api_key=self.api_key,
+                base_url=self.base_url,
+                timeout_seconds=self.timeout_seconds,
+            )
+        return self._async_optimizers_client
 
     async def __aenter__(self) -> AsyncSynthClient:
         return self

{synth_ai-0.18.2.dev613 → synth_ai-0.18.2.dev615}/synth_ai/mcp/research/README.md

@@ -95,16 +95,53 @@ sessions; they never address the singleton Async resource implicitly.
 
 Async Intern control plane:
 - `intern_async_ensure` and `intern_async_get` address the organization's one
-  long-lived Async Intern runtime
-- `intern_async_command` preserves the exact durable command envelope
+  long-lived Async Intern runtime. Ensure accepts day/month spend ceilings via
+  `budget.maximum_daily_cost_cents` / `budget.maximum_monthly_cost_cents` or
+  top-level kwargs of the same names; omitted ceilings get server defaults.
+- `intern_async_command` preserves the exact durable command envelope (including
+  `request_spine_handoff` / `advance_spine`)
 - `intern_async_send`, `intern_async_intervene`,
   `intern_async_redirect_objective`, and `intern_async_request_checkpoint`
   submit typed instructions to the same backend inbox
 - `intern_async_pause`, `intern_async_resume`, `intern_async_cancel`, and
-  `intern_async_provide_input` expose explicit state-machine controls
+  `intern_async_provide_input` expose explicit state-machine controls. Pause
+  frees the sticky exe.dev host lease; resume reacquires it.
+- `intern_async_get` projections include `open_judgment_items` and `effort_work`
+  (ask-and-continue asks and per-Effort work summaries), plus `spend` and
+  `host_lease`. The spend totals are the same ones the capability gate and the
+  spend sweeper read, host idle cost included, so what a caller sees is what
+  actually blocks work; `host_lease.reused` distinguishes a lease reacquired on
+  resume from a freshly provisioned host
 - `intern_async_events` replays a bounded event page and `intern_async_tail`
   waits for a bounded number of SSE events
 
+Intern research program (Effort-first):
+- `intern_effort_board` lists Efforts as board rows -- the Effort plus its open
+  objective/task/question counts -- and `intern_effort_detail` rolls one Effort
+  up into Progress / Results / Experiments / Knowledge. The runtime block on the
+  detail is secondary ops chrome (cycle, wake, cursor, spend, host lease), not
+  the product surface.
+- `intern_objective_list` / `_create` / `_get` / `_update`,
+  `intern_milestone_list` / `_create` / `_transition`, and
+  `intern_task_list` / `_create` / `_update` address the Intern's own
+  Effort-bound planner store. The Effort is a required argument on every create:
+  a row cannot exist without its binding, and the binding is immutable.
+- `intern_progress_claim_create` folds a finished run's result back into the
+  objective that motivated it; `intern_objective_link_create` records a
+  *reference* from an Intern objective to an SMR-owned run, report, work
+  product, or experiment. Neither writes the target.
+- Effort lifecycle itself is not duplicated here. Use the existing
+  `research_list_factory_efforts`, `research_get_effort`, and
+  `research_patch_effort`; these are the Async program verbs.
+- `intern_memory_search` / `intern_memory_get` read the Intern's own history.
+  They return the retrieval payload with no wrapper, field for field with the
+  Intern's own memory tools -- so an operator inspecting memory sees exactly
+  what the Intern saw, rather than a second description of the same records.
+- The Intern is a client of the swarm plane, never its owner. Kickoff and poll
+  stay on `research_trigger_run` / `research_get_run` / `research_get_swarm_*`.
+  No tool here plans a swarm's task graph, and none should be added that does --
+  `synth_ai.sdk.research.intern_grants` refuses those names outright.
+
 These tools are thin adapters over `client.intern.async_`; they do not call
 HTTP directly and do not contain reducer logic. A command receipt proves
 durable admission, not completion. Callers retain command/idempotency identity

{synth_ai-0.18.2.dev613 → synth_ai-0.18.2.dev615}/synth_ai/mcp/research/server.py

@@ -47,6 +47,7 @@ from synth_ai.mcp.research.tools.factory_results import (
 from synth_ai.mcp.research.tools.files import build_file_tools
 from synth_ai.mcp.research.tools.image_releases import build_image_release_tools
 from synth_ai.mcp.research.tools.integrations import build_integration_tools
+from synth_ai.mcp.research.tools.intern_program import build_intern_program_tools
 from synth_ai.mcp.research.tools.logs import build_log_tools
 from synth_ai.mcp.research.tools.models import build_model_tools
 from synth_ai.mcp.research.tools.outputs import build_output_tools
@@ -480,6 +481,7 @@ class ResearchMcpServer:
             *build_output_tools(self),
             *build_readiness_tools(self),
             *build_research_intern_tools(self._core_client_from_args),
+            *build_intern_program_tools(self._core_client_from_args),
             *build_resource_tools(self),
             *build_run_tools(self),
             *build_progress_tools(self),

{synth_ai-0.18.2.dev613 → synth_ai-0.18.2.dev615}/synth_ai/mcp/research/tools/__init__.py

@@ -6,6 +6,7 @@ from synth_ai.mcp.research.tools.exports import build_export_tools
 from synth_ai.mcp.research.tools.factories import build_factory_tools
 from synth_ai.mcp.research.tools.files import build_file_tools
 from synth_ai.mcp.research.tools.image_releases import build_image_release_tools
+from synth_ai.mcp.research.tools.intern_program import build_intern_program_tools
 from synth_ai.mcp.research.tools.models import build_model_tools
 from synth_ai.mcp.research.tools.outputs import build_output_tools
 from synth_ai.mcp.research.tools.progress import build_progress_tools
@@ -26,6 +27,7 @@ __all__ = [
     "build_factory_tools",
     "build_file_tools",
     "build_image_release_tools",
+    "build_intern_program_tools",
     "build_model_tools",
     "build_output_tools",
     "build_progress_tools",