Skip to content

police sweep 2026-05-25: docs sync #1

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

Merged
onebit0fme merged 1 commit into from
May 25, 2026
Merged

police sweep 2026-05-25: docs sync #1

Show file tree
Hide file tree
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
2 changes: 1 addition & 1 deletion CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ The **public programmatic surface is HTTP**: the REST API and the product MCP se
| **Authoring schemas** | `model.yaml` + JSONL samples — the published training-input contract (DR 009), at `u22a8.ai/schemas`. | The published JSON Schemas |
| **TypeScript SDK** | Hand-written HTTP client for `/v1` — **in progress (U22-57)**, not shipped. Document when it lands. | — |

**MCP tools** (group them this way in docs): *reading* — `list_models`, `get_model`, `list_traits`, `list_samples`, `list_versions`, `get_version`; *scoring* — `score`, `compare`, `extract`; *authoring* (draft-only) — `create_model`, `update_model`, `delete_model`, `add_traits`, `update_trait`, `delete_trait`, `add_samples`, `delete_sample`; *lifecycle* — `train`, `discover_traits`, `tag_version`, `untag_version`, `activate_version`.
**MCP tools** (group them this way in docs): *reading* — `list_models`, `get_model`, `list_traits`, `list_samples`\*, `list_versions`\*, `get_version`\* (\*owner-only); *scoring* — `score`, `compare`, `extract`; *authoring* (draft-only) — `create_model`, `update_model`, `delete_model`, `add_traits`, `update_trait`, `delete_trait`, `add_samples`, `delete_sample`; *lifecycle* — `train`, `discover_traits`, `synthesize_samples`, `tag_version`, `untag_version`, `activate_version`.

**Authentication.** Developers issue an API key in the console and send `Authorization: Bearer <key>`. Keys carry a scope — **`scoring`** (read + score/compare) or **`authoring`** (full). A key authors only in namespaces it owns, and reads its own plus the public namespaces (`u22a8`, `live`, `bench`). MCP uses OAuth via WorkOS rather than a static key.

Expand Down
11 changes: 6 additions & 5 deletions api-reference/mcp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ Score this commit message against the `u22a8.commit-message` model and report ea

## Tools

Tools are grouped by what they do. Reading and scoring tools work against any model a session can read; authoring and lifecycle tools require ownership of the model's namespace.
Tools are grouped by what they do. Reading and scoring tools work against any model a session can read; `list_samples`, `list_versions`, and `get_version` additionally require ownership of the model's namespace; authoring and lifecycle tools always require ownership.

### Reading

Expand All @@ -57,9 +57,9 @@ Tools are grouped by what they do. Reading and scoring tools work against any mo
| `list_models` | List models in a namespace (defaults to the public catalog). |
| `get_model` | Fetch one model's metadata. |
| `list_traits` | List a model's traits with sample counts and polarity labels. |
| `list_samples` | List a model's training samples, filtered by trait. |
| `list_versions` | List a model's versions, newest first. |
| `get_version` | Fetch one version's snapshot by `vN` number or tag. |
| `list_samples` | List a model's training samples, filtered by trait. Owner-only. |
| `list_versions` | List a model's versions, newest first. Owner-only. |
| `get_version` | Fetch one version's snapshot by `vN` number or tag. Owner-only. |

### Scoring

Expand Down Expand Up @@ -90,11 +90,12 @@ Authoring tools mutate a draft model. Trait and sample edits apply only while th
|------|---------|
| `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 labeled samples from a draft model's trait definitions. Runs asynchronously. |
| `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` and `discover_traits` 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`, `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.

## Models as resources

Expand Down
Loading
Loading