Brain Tools
Updated at 2026-09-21 · 623d849
Every wired runtime shares the same brain tools, served by brain-host on
one /tools/invoke wire: three retrieval tools from its own retriever,
the rest from this repo's brain-orchestrator core. Descriptions of the
operations tools are extracted from the plugin source on every release.
Retrieval (brain-host retriever)
| Tool | Description |
|---|---|
memory_search | Hybrid full-text + embedding search over the wiki and tastes; one hit per entry with the best section's line range and snippet. |
memory_get | Read a wiki or taste entry by path, optionally a line range. |
wiki | Retriever status: index size, provenance, generation. |
Operations (brain-orchestrator)
| Tool | Description |
|---|---|
tasks | Task orchestrator: manage goals, tasks, workflows, checkpoints, and handoffs. |
agent_identify | Register or refresh an agent identity. Returns a short-lived session token + server time. |
learning_capture | Capture a reusable learning (feedback / project / reference / rejection) into the brain. |
traces_record | Record a trace event (tool call, task lifecycle, session boundary, learning capture). |
traces_query | Query trace events with optional filters by agent, goal, task, kind, and time range. |
m1_event_record | Record one M1 universal-protocol event (session_start | knowledge_surfaced | assistant_ack | session_snapshot | session_end). Idempotent on event_id — retries are safe. See wiki: infrastructure/m1-universal-event-protocol.md |
m1_score | Compute M1 application_rate rollups (ack_rate + use_rate per day/runtime/agent) from m1_events in the given window. Defaults to last 24h. |
The m1_* tools register only when the M1 events store is configured —
older deployments without it simply don't see them.