Skip to content

police sweep 2026-06-02: docs sync — MCP lifecycle async behavior #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
onebit0fme wants to merge 1 commit into from
Closed

police sweep 2026-06-02: docs sync — MCP lifecycle async behavior #5

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions api-reference/mcp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,14 +88,16 @@ Authoring tools mutate a draft model. Trait and sample edits apply only while th

| Tool | Purpose |
|------|---------|
| `train` | Train a draft model, or re-tune a ready one. Runs asynchronously. |
| `discover_traits` | Derive intrinsic traits from a draft model's samples. Runs asynchronously. |
| `synthesize_samples` | Generate labelled samples from a draft model's trait definitions. Runs asynchronously. |
| `train` | Train a draft model, or re-tune a ready one. Enqueues the run and returns immediately. |
| `discover_traits` | Derive intrinsic traits from a draft model's samples. Blocks until the run completes, streaming progress. |
| `synthesize_samples` | Generate labelled samples from a draft model's trait definitions. Blocks until the run completes, streaming progress. |
| `tag_version` | Pin a tag to the active version. |
| `untag_version` | Remove a tag. |
| `activate_version` | Point the model at a version — roll back or pin. |

`train`, `discover_traits`, and `synthesize_samples` return once the run is enqueued; the model reports a `busy` state until the run completes. Poll `get_model` for the state rather than waiting on the call.
`train` returns once the run is enqueued — the model reports a `busy` state until the run completes; poll `get_model` for the outcome.

`discover_traits` and `synthesize_samples` **block until the run finishes**, streaming progress on the same request. Calls may take several minutes. Poll `get_model` only if the call times out or the client disconnects.

## Models as resources

Expand Down
Loading