synth-ai 0.17.5.dev589__tar.gz → 0.18.0.dev590__tar.gz

{synth_ai-0.17.5.dev589 → synth_ai-0.18.0.dev590}/MANIFEST.in

@@ -1,8 +1,7 @@
 include README.md
 include LICENSE
 recursive-include synth_ai *.py
-# Only include lightweight config/data files from core packages
-recursive-include synth_ai *.toml
+recursive-include synth_ai *.md
 # Prune heavy example/demo/test/data trees from the sdist (keep code)
 prune tests
 prune private_tests
@@ -23,12 +22,6 @@ recursive-exclude synth_ai *.pth
 recursive-exclude synth_ai *.bin
 recursive-exclude synth_ai *.zip
 recursive-exclude synth_ai *.tar
-# The built-in Factory standup plans are lightweight runtime resources. Keep
-# them in source and wheel distributions after excluding other JSON datasets.
-recursive-include synth_ai/managed_research/factory_plans *.json
-# The backend-authored public model registry is part of the vendored Research
-# contract and must remain inspectable from an installed SDK.
-include synth_ai/managed_research/schemas/public_models.json
 global-exclude *.pyc
 global-exclude __pycache__
 global-exclude .DS_Store

{synth_ai-0.17.5.dev589/synth_ai.egg-info → synth_ai-0.18.0.dev590}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.17.5.dev589
-Summary: Python-only SDK for Synth containers, tunnels, pools, and Research
+Version: 0.18.0.dev590
+Summary: Python SDK and CLI for Synth Managed Research and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT
 Project-URL: Homepage, https://github.com/synth-laboratories/synth-ai
@@ -14,10 +14,6 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: pynacl>=1.5.0
 Requires-Dist: click<8.2,>=8.1.7
 Requires-Dist: httpx>=0.28.1
-Provides-Extra: schemas
-Provides-Extra: providers
-Requires-Dist: anthropic>=0.42.0; extra == "providers"
-Requires-Dist: google-genai>=1.26.0; extra == "providers"
 Provides-Extra: dev
 Requires-Dist: build>=1.2.2.post1; extra == "dev"
 Requires-Dist: twine>=4.0.0; extra == "dev"
@@ -26,17 +22,12 @@ Requires-Dist: ruff>=0.1.0; extra == "dev"
 Requires-Dist: papermill>=2.6.0; extra == "dev"
 Requires-Dist: nest_asyncio>=1.6.0; extra == "dev"
 Requires-Dist: mdxify>=0.2.0; extra == "dev"
-Provides-Extra: all
-Requires-Dist: anthropic>=0.42.0; extra == "all"
-Requires-Dist: google-genai>=1.26.0; extra == "all"
-Provides-Extra: analytics
-Requires-Dist: pandas>=2.2.3; extra == "analytics"
 Provides-Extra: research
 Dynamic: license-file
 
 # Synth AI SDK
 
-<!-- CI release pins: PyPI-0.17.5-orange synth-ai==0.17.5 -->
+<!-- CI release pins: PyPI-0.18.0-orange synth-ai==0.18.0 -->
 
 [![PyPI version](https://img.shields.io/pypi/v/synth-ai.svg)](https://pypi.org/project/synth-ai/)
 [![License](https://img.shields.io/pypi/l/synth-ai.svg)](https://pypi.org/project/synth-ai/)
@@ -85,7 +76,7 @@ The CLI also reads `SYNTH_BACKEND_URL` and accepts `--backend-url`.
 
 ```python
 from synth_ai import SynthClient
-from synth_ai.core.research.public import SwarmSpec
+from synth_ai.sdk.research.public import SwarmSpec
 
 with SynthClient() as client:
     swarm = client.research.swarms.create(
@@ -126,7 +117,7 @@ Create a durable project when work needs reusable configuration:
 
 ```python
 from synth_ai import SynthClient
-from synth_ai.core.research.public import EnvironmentKind, ProjectSpec, RuntimeKind, SwarmSpec
+from synth_ai.sdk.research.public import EnvironmentKind, ProjectSpec, RuntimeKind, SwarmSpec
 
 with SynthClient() as client:
     project = client.research.projects.create(
@@ -151,7 +142,7 @@ parity:
 
 ```python
 from synth_ai import SynthClient
-from synth_ai.core.research.public import EffortSpec, FactorySpec, ProjectId
+from synth_ai.sdk.research.public import EffortSpec, FactorySpec, ProjectId
 
 with SynthClient() as client:
     factory = client.research.factories.create(
@@ -194,8 +185,8 @@ Use `SynthClient` as the front door:
 | **Research / Factory** | `client.research` | Typed hosted projects, swarms, Factory lifecycles, and Efforts. |
 | CLI | `synth-ai` | Terminal access to Research commands. |
 
-Infrastructure clients (containers, tunnels, pools) are parked under `old/` for
-later restoration and are not composed on `SynthClient` right now.
+There are no infrastructure client namespaces (containers, tunnels, pools) on
+`SynthClient`; the package is Research-only as of 0.18.0.
 
 Use [Managed Research](https://docs.usesynth.ai/managed-research/intro) when you
 want hosted research workers, repo runs, evidence, checkpoints, MCP, or final

{synth_ai-0.17.5.dev589 → synth_ai-0.18.0.dev590}/README.md

@@ -1,6 +1,6 @@
 # Synth AI SDK
 
-<!-- CI release pins: PyPI-0.17.5-orange synth-ai==0.17.5 -->
+<!-- CI release pins: PyPI-0.18.0-orange synth-ai==0.18.0 -->
 
 [![PyPI version](https://img.shields.io/pypi/v/synth-ai.svg)](https://pypi.org/project/synth-ai/)
 [![License](https://img.shields.io/pypi/l/synth-ai.svg)](https://pypi.org/project/synth-ai/)
@@ -49,7 +49,7 @@ The CLI also reads `SYNTH_BACKEND_URL` and accepts `--backend-url`.
 
 ```python
 from synth_ai import SynthClient
-from synth_ai.core.research.public import SwarmSpec
+from synth_ai.sdk.research.public import SwarmSpec
 
 with SynthClient() as client:
     swarm = client.research.swarms.create(
@@ -90,7 +90,7 @@ Create a durable project when work needs reusable configuration:
 
 ```python
 from synth_ai import SynthClient
-from synth_ai.core.research.public import EnvironmentKind, ProjectSpec, RuntimeKind, SwarmSpec
+from synth_ai.sdk.research.public import EnvironmentKind, ProjectSpec, RuntimeKind, SwarmSpec
 
 with SynthClient() as client:
     project = client.research.projects.create(
@@ -115,7 +115,7 @@ parity:
 
 ```python
 from synth_ai import SynthClient
-from synth_ai.core.research.public import EffortSpec, FactorySpec, ProjectId
+from synth_ai.sdk.research.public import EffortSpec, FactorySpec, ProjectId
 
 with SynthClient() as client:
     factory = client.research.factories.create(
@@ -158,8 +158,8 @@ Use `SynthClient` as the front door:
 | **Research / Factory** | `client.research` | Typed hosted projects, swarms, Factory lifecycles, and Efforts. |
 | CLI | `synth-ai` | Terminal access to Research commands. |
 
-Infrastructure clients (containers, tunnels, pools) are parked under `old/` for
-later restoration and are not composed on `SynthClient` right now.
+There are no infrastructure client namespaces (containers, tunnels, pools) on
+`SynthClient`; the package is Research-only as of 0.18.0.
 
 Use [Managed Research](https://docs.usesynth.ai/managed-research/intro) when you
 want hosted research workers, repo runs, evidence, checkpoints, MCP, or final

{synth_ai-0.17.5.dev589 → synth_ai-0.18.0.dev590}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "synth-ai"
-version = "0.17.5.dev589"
-description = "Python-only SDK for Synth containers, tunnels, pools, and Research"
+version = "0.18.0.dev590"
+description = "Python SDK and CLI for Synth Managed Research and Research Factory"
 authors = [{name = "Synth AI", email = "josh@usesynth.ai"}]
 license = "MIT"
 license-files = ["LICENSE"]
@@ -18,15 +18,8 @@ dependencies = [
 [project.scripts]
 synth-ai = "synth_ai.cli:cli"
 synth-ai-research-mcp = "synth_ai.mcp.research.server:main"
-synth-ai-research-factory-standup = "synth_ai.cli.research_factory_standup:main"
 
 [project.optional-dependencies]
-schemas = []
-providers = [
-    # Optional LLM providers (lazy-loaded when used)
-    "anthropic>=0.42.0",
-    "google-genai>=1.26.0",
-]
 dev = [
     "build>=1.2.2.post1",
     "twine>=4.0.0",
@@ -36,14 +29,6 @@ dev = [
     "nest_asyncio>=1.6.0",
     "mdxify>=0.2.0",
 ]
-all = [
-    # Include providers
-    "anthropic>=0.42.0",
-    "google-genai>=1.26.0",
-]
-analytics = [
-    "pandas>=2.2.3",
-]
 research = [
     # Compatibility extra retained so `synth-ai[research]` remains valid.
 ]
@@ -73,8 +58,6 @@ include-package-data = true
 
 [tool.setuptools.exclude-package-data]
 "synth_ai" = [
-    # Exclude heavy data inside agent_demos/old/tests
-    "**/agent_demos/**",
     "**/tests/**",
     "**/units/**",
 ]
@@ -82,12 +65,6 @@ include-package-data = true
 [tool.setuptools.package-data]
 "synth_ai" = [
     "py.typed",
-    # Research moved core/research -> sdk/research (see unify_sdk_layering.md).
-    # These globs are the only thing that puts the factory plans and vendored
-    # schemas into the wheel; a stale path here ships a package that imports and
-    # then fails at runtime looking for data files.
-    "sdk/research/factory_plans/*.json",
-    "sdk/research/schemas/*",
 ]
 
 [tool.ruff]
@@ -124,19 +101,11 @@ ignore = [
 ]
 
 [tool.ruff.lint.per-file-ignores]
-"synth_ai/http.py" = ["F403"]
 "**/__init__.py" = ["N999"]
 "**/__main__.py" = ["N999"]
 
-[tool.ty.src]
-include = ["synth_ai"]
-
-# The _legacy tree this override named was deleted when the compatibility
-# packages were retired; check_research_migration_boundaries.py now asserts its
-# absence. Nothing to override.
-
-[tool.ty.rules]
-possibly-missing-attribute = "ignore"
+# Type-check configuration lives in ty.toml, which takes precedence over any
+# [tool.ty.*] here.
 
 [dependency-groups]
 dev = [

synth_ai-0.18.0.dev590/synth_ai/README.md

@@ -0,0 +1,87 @@
+# `synth_ai` Package
+
+Runtime package for the public Synth AI SDK and CLI.
+
+The public first-mile surface is intentionally small:
+
+- `SynthClient`
+- `AsyncSynthClient`
+- `client.research`
+- `synth-ai` CLI
+
+Public docs live at https://docs.usesynth.ai/sdk/overview.
+
+## Package Structure
+
+```text
+synth_ai/
+├── client.py       # SynthClient and AsyncSynthClient composition layer
+├── sdk/            # Research + shared pagination plumbing
+├── core/           # Shared runtime helpers and errors
+├── cli/            # CLI commands for research (and local helpers)
+└── __init__.py     # Package version and top-level exports
+```
+
+## Dependency Direction
+
+```text
+core/ -> sdk/ -> client.py -> cli/
+```
+
+- `core/` owns shared runtime plumbing such as errors, environment lookup, and URL normalization.
+- `sdk/` owns Research clients/contracts plus shared pagination helpers.
+- `client.py` composes Research behind `SynthClient` and `AsyncSynthClient`.
+- `cli/` wraps the SDK for terminal use.
+
+## Supported Imports
+
+Prefer the front-door client and the hero nouns:
+
+```python
+from synth_ai import SynthClient
+
+research = SynthClient().research
+project = research.projects.create(request)
+swarm = research.swarms.create(project.project_id, request=launch)
+swarm.wait()
+```
+
+`research.advanced.*` exists but is explicitly unstable operator surface; do
+not build against it as if it were the public story.
+
+## Layering
+
+One DAG, enforced by `check_sdk_layering.py` in the sibling `testing` repo.
+See `unify_sdk_layering.md` for the rationale.
+
+```text
+core/      plumbing only: auth, http, errors, utils, generic contracts
+  |
+  v
+sdk/       Research + pagination
+  |
+  v
+client.py  SynthClient / AsyncSynthClient composition
+  |
+  +--> cli/            thin terminal adapter
+  +--> mcp/research/   thin MCP adapter
+```
+
+| From \ To | `core` | `sdk` | `client` | `cli` | `mcp` |
+|-----------|--------|-------|----------|-------|-------|
+| `core` | yes | **no** | no | no | no |
+| `sdk` | yes | yes | no | no | no |
+| `client` | yes | yes | — | no | no |
+| `cli` | yes | yes | yes | — | no |
+| `mcp` | yes | yes | preferred yes | no | — |
+
+`core/` must not import `sdk/`: plumbing cannot depend on the clients built on
+top of it. Peer imports inside a layer are fine.
+
+## Guidelines for New Code
+
+1. Put shared errors, URL handling, and environment helpers in `core/`.
+2. Put Research contracts, clients, and operator session surfaces in `sdk/research/`.
+3. Put front-door composition in `client.py`.
+4. Put terminal commands in `cli/`.
+5. Keep unreleased or archived infra APIs out of public README examples.

{synth_ai-0.17.5.dev589 → synth_ai-0.18.0.dev590}/synth_ai/__init__.py

@@ -13,14 +13,11 @@ from importlib.metadata import PackageNotFoundError as _PackageNotFoundError
 from pathlib import Path as _Path
 from typing import Any as _Any
 
-try:
-    from synth_ai.core.utils.log_filter import (
-        install_log_filter as _install_log_filter,
-    )
+from synth_ai.core.utils.log_filter import (
+    install_log_filter as _install_log_filter,
+)
 
-    _install_log_filter()
-except Exception:
-    pass
+_install_log_filter()
 
 try:
     __version__ = _metadata.version("synth-ai")

synth_ai-0.18.0.dev590/synth_ai/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""Allow running synth_ai as a module: python -m synth_ai"""
+
+from synth_ai.cli import cli
+
+if __name__ == "__main__":
+    cli()

synth_ai-0.18.0.dev590/synth_ai/cli/AGENTS.md

@@ -0,0 +1,16 @@
+CLI structure notes (for coding agents)
+
+- Keep `synth_ai/cli/` flat: one file per command, filename == command name.
+- Each command file holds Click wiring (options/args/validation/routing).
+- Business logic lives in `synth_ai/sdk/` (reusable) or `synth_ai/core/` (internal).
+- CLI-only helpers may live in `synth_ai/cli/lib/` or `synth_ai/cli/utils/` only.
+- No shims/wrappers: do not duplicate modules across folders or re-export commands.
+- Avoid heavy module-level imports in CLI; import inside functions for lazy load.
+- Use Click conventions; no surprising CLI behavior.
+
+## Incident Log Requirement
+
+When you hit a Synth code bug or local dev setup issue, append a timestamped entry to `specifications/issues_log/YYYY-MM-DD.md` in the sibling `testing/` repo before finishing.
+
+Use this one-line format:
+`- [YYYY-MM-DD HH:MM:SS TZ] <repo/path> — <issue> — <impact> — <action/status>`

synth_ai-0.18.0.dev590/synth_ai/cli/README.md

@@ -0,0 +1,35 @@
+# CLI Modules
+
+Thin Click adapters over `SynthClient` / `sdk.research`.
+
+`synth-ai research` is the whole CLI. Infrastructure commands (`containers`,
+`tunnels`, `pools`) and the operator consoles (`dev-envs`, the
+`synth-ai-research-factory-standup` script) were removed in 0.18.0; see
+`CHANGELOG.md` for what replaced each one.
+
+## Command Structure
+
+```
+synth-ai research --help
+synth-ai research projects ...
+synth-ai research swarms ...
+```
+
+## Import Rules
+
+```python
+# CLI importing from SDK (correct)
+from synth_ai import SynthClient
+
+# CLI importing from core (correct)
+from synth_ai.core.utils.env import get_api_key
+
+# SDK importing from CLI (wrong - never do this)
+```
+
+## Relationship to Other Modules
+
+| Module | Relationship |
+|--------|--------------|
+| `core/` | `cli/` imports shared env/error helpers |
+| `sdk/` / `client.py` | Business calls go through Research clients |

{synth_ai-0.17.5.dev589 → synth_ai-0.18.0.dev590}/synth_ai/cli/main.py

@@ -2,7 +2,6 @@
 
 import click
 
-from synth_ai.cli.dev_envs import dev_envs
 from synth_ai.cli.research import research
 
 
@@ -24,5 +23,4 @@ def cli(ctx):
         click.echo(ctx.get_help())
 
 
-cli.add_command(dev_envs)
 cli.add_command(research)

{synth_ai-0.17.5.dev589 → synth_ai-0.18.0.dev590}/synth_ai/client.py

@@ -24,9 +24,8 @@ def _resolve_base_url(base_url: str | None) -> str:
 class SynthClient:
     """Sync client for Managed Research.
 
-    Use ``research`` for hosted projects, swarms, and Factory lifecycles.
-    Infrastructure clients (containers, tunnels, pools) are archived under
-    ``old/sdk/`` and are not composed here.
+    Use ``research`` for hosted projects, swarms, and Factory lifecycles. That
+    is the whole client: there is no container, tunnel, or pool namespace.
     """
 
     def __init__(
@@ -34,11 +33,11 @@ class SynthClient:
         *,
         api_key: str | None = None,
         base_url: str | None = None,
-        timeout: float = 30.0,
+        timeout_seconds: float = 30.0,
     ) -> None:
         self.api_key = _resolve_api_key(api_key)
         self.base_url = _resolve_base_url(base_url)
-        self.timeout = timeout
+        self.timeout_seconds = timeout_seconds
         self._research_client: ResearchClient | None = None
 
     @property
@@ -50,7 +49,7 @@ class SynthClient:
             self._research_client = ResearchClient(
                 api_key=self.api_key,
                 base_url=self.base_url,
-                timeout_seconds=self.timeout,
+                timeout_seconds=self.timeout_seconds,
             )
         return self._research_client
 
@@ -58,6 +57,7 @@ class SynthClient:
         """Close all lazily opened SDK transports."""
         if self._research_client is not None:
             self._research_client.close()
+            self._research_client = None
 
     def __enter__(self) -> SynthClient:
         return self
@@ -74,11 +74,11 @@ class AsyncSynthClient:
         *,
         api_key: str | None = None,
         base_url: str | None = None,
-        timeout: float = 30.0,
+        timeout_seconds: float = 30.0,
     ) -> None:
         self.api_key = _resolve_api_key(api_key)
         self.base_url = _resolve_base_url(base_url)
-        self.timeout = timeout
+        self.timeout_seconds = timeout_seconds
         self._async_research_client: AsyncResearchClient | None = None
 
     @property
@@ -90,7 +90,7 @@ class AsyncSynthClient:
             self._async_research_client = AsyncResearchClient(
                 api_key=self.api_key,
                 base_url=self.base_url,
-                timeout_seconds=self.timeout,
+                timeout_seconds=self.timeout_seconds,
             )
         return self._async_research_client
 
@@ -108,6 +108,7 @@ class AsyncSynthClient:
         """Close all asynchronous Research transports."""
         if self._async_research_client is not None:
             await self._async_research_client.close()
+            self._async_research_client = None
 
     async def __aenter__(self) -> AsyncSynthClient:
         return self

synth_ai-0.18.0.dev590/synth_ai/core/README.md

@@ -0,0 +1,68 @@
+# Core Modules
+
+Shared runtime plumbing for the Synth AI SDK — and nothing else.
+
+`core/` is the bottom of the layering DAG (see `../README.md` and
+`unify_sdk_layering.md`). It may import only from `core/`. In particular it must
+not import `sdk/`: plumbing cannot depend on the clients built on top of it.
+`check_sdk_layering.py` in the sibling `testing` repo enforces this.
+
+## Structure
+
+```
+core/
+├── __init__.py      # Internal exports
+├── auth/            # Credentials and auth context
+├── http/            # Transport, request, retry
+├── errors.py        # Error types and handling
+├── contracts/       # Generic JSON/error contracts only
+├── utils/           # General utilities
+└── research/        # DEPRECATED alias -> synth_ai.sdk.research
+```
+
+`core/research/` is no longer an implementation tree. Research moved to
+`sdk/research/` so that `core/` means one thing; what remains is an import alias
+that forwards and warns, scheduled for deletion once sibling repos are clean.
+Do not add modules there.
+
+## Guidelines for Additions
+
+### DO add to `core/` if:
+
+1. **It's shared infrastructure** - Used by multiple live modules
+2. **It's internal implementation** - Not meant for direct user consumption
+3. **It's runtime plumbing** - Errors, URL resolution, env helpers
+4. **It's a utility** - Helpers used by the narrowed live SDK
+
+### DO NOT add to `core/` if:
+
+1. **It's a user-facing API** - Put it in `sdk/`
+2. **It's CLI-specific** - Put it in `cli/`
+3. **It's a public client** - Put it in `sdk/` or `client.py`
+4. **It's outside the public SDK runtime** - keep it out of `core/` unless it is required by supported live flows
+
+## Module Descriptions
+
+### `errors.py`
+Custom exception types and error handling utilities.
+
+### `utils/`
+General-purpose utilities for environment lookup, URLs, JSON helpers, and secure file handling.
+
+## Import Rules
+
+- `core/` should NOT import from `sdk/` or `cli/`
+- Internal modules should not be imported directly by users unless explicitly documented
+
+```python
+# Supported internal usage
+from synth_ai.core.errors import SynthError
+from synth_ai.core.utils.env import get_api_key
+```
+
+## Relationship to Other Modules
+
+| Module | Relationship |
+|--------|--------------|
+| `sdk/` | `sdk/` imports from `core/` for runtime helpers |
+| `cli/` | `cli/` imports from `core/` for shared errors and env utilities |

synth_ai-0.18.0.dev590/synth_ai/core/__init__.py

@@ -0,0 +1,7 @@
+"""Shared plumbing: errors, HTTP, auth, and typed contracts.
+
+``core/`` is what every public client is built on and is not itself a public
+client -- Research lives in ``synth_ai/sdk/research``. Import from the owning
+submodule (``synth_ai.core.errors``, ``synth_ai.core.http.retry``, ...); this
+package re-exports nothing.
+"""

synth_ai-0.18.0.dev590/synth_ai/core/auth/__init__.py

@@ -0,0 +1,4 @@
+"""Credential contracts for Synth clients.
+
+Import from the owning submodule; this package re-exports nothing.
+"""

synth_ai-0.18.0.dev590/synth_ai/core/contracts/__init__.py

@@ -0,0 +1,4 @@
+"""General typed contracts shared by Synth product clients.
+
+Import from the owning submodule; this package re-exports nothing.
+"""

{synth_ai-0.17.5.dev589 → synth_ai-0.18.0.dev590}/synth_ai/core/contracts/pagination.py

@@ -2,26 +2,15 @@
 
 from __future__ import annotations
 
-from dataclasses import dataclass
-from typing import Generic, Mapping, TypeVar
+from typing import Mapping
 
 from synth_ai.core.contracts.json_value import JsonValue
 
-ItemT = TypeVar("ItemT")
-
 
 class PageCursor(str):
     """Opaque cursor returned by the backend."""
 
 
-@dataclass(frozen=True, slots=True)
-class Page(Generic[ItemT]):
-    """One immutable page of typed resources."""
-
-    items: tuple[ItemT, ...]
-    next_cursor: PageCursor | None = None
-
-
 def build_query_params(**values: JsonValue) -> dict[str, JsonValue]:
     """Drop only absent or blank-string query values."""
 
@@ -43,4 +32,4 @@ def extract_next_cursor(payload: Mapping[str, object]) -> PageCursor | None:
     return PageCursor(value.strip())
 
 
-__all__ = ["Page", "PageCursor", "build_query_params", "extract_next_cursor"]
+__all__ = ["PageCursor", "build_query_params", "extract_next_cursor"]