Metadata-Version: 2.4
Name: managed-research
Version: 1.2026.42015
Summary: Public SDK, MCP, and schemas for Managed Research.
Project-URL: Homepage, https://github.com/synth-laboratories/managed-research
Project-URL: Repository, https://github.com/synth-laboratories/managed-research
Project-URL: Issues, https://github.com/synth-laboratories/managed-research/issues
Author: Synth Laboratories
License: MIT
Requires-Python: >=3.11
Requires-Dist: httpx>=0.28.1
Requires-Dist: pynacl>=1.5.0
Provides-Extra: dev
Requires-Dist: build>=1.2.2.post1; extra == 'dev'
Requires-Dist: pytest>=8.3.3; extra == 'dev'
Requires-Dist: ruff>=0.15.0; extra == 'dev'
Requires-Dist: ty>=0.0.28; extra == 'dev'
Description-Content-Type: text/markdown

# managed-research

Managed Research is Synth's Python SDK and MCP package for repeatable,
inspectable repo work.

## Install

```bash
uv add managed-research
```

## 60-Second Quickstart

```python
from managed_research import ManagedResearchClient

client = ManagedResearchClient(api_key="sk_...")

project = client.projects.default()
run = project.runs.start(
    "Inspect the repo, improve the benchmark path, and explain the changes.",
    host_kind="daytona",
    work_mode="directed_effort",
    providers=[{"provider": "openrouter"}],
)

print(run.id)
```

`ManagedResearchClient` is the canonical entrypoint. `SmrControlClient`
remains available as a compatibility alias for one release.

## Main Ideas

- Use `client.projects` to create or list projects.
- Use `client.project(project_id)` for project-scoped nouns like
  `repositories`, `files`, `outputs`, and `runs`.
- Use `client.runs.start(...)` when you want the default miscellaneous
  project flow.
- Use launch preflight before a manual run when you need to inspect blockers.
- Use `agent_harness="codex"` or `agent_harness="opencode_sdk"` when you want
  to pin the harness explicitly.

## OpenCode Harness

OpenCode is a first-class harness option with this initial model palette:

- `anthropic/claude-sonnet-4-6`
- `anthropic/claude-haiku-4-5-20251001`
- `x-ai/grok-4.1-fast`

For deeper examples, see:

- [`docs/quickstart.md`](./docs/quickstart.md)
- [`docs/python-sdk.md`](./docs/python-sdk.md)
- [`docs/mcp.md`](./docs/mcp.md)
