Architecture
Control Plane (State Runtime)
Use MuBit control APIs as the stable integration boundary for memory, context assembly, diagnostics, the learning loop, and coordination.
The control plane is the primary public integration boundary for current MuBit. It combines the memory lifecycle, compaction-safe context assembly, diagnostics, learning loop, coordination primitives, and structured run-scoped variables.
If your team needs one stable runtime boundary for long-running AI systems, standardize on the control plane first.
Core workflow model
| Workflow | Recommended surfaces |
|---|---|
| Memory write/read | remember, recall, raw control.ingest, raw control.query |
| Context assembly | getContext / get_context, /v2/control/context |
| Learning loop | reflect, recordOutcome / record_outcome, surfaceStrategies / surface_strategies |
| Diagnostics | memoryHealth / memory_health, diagnose |
| Coordination | registerAgent / register_agent, handoff, feedback |
Operating guidance
- Use one deterministic
run_id/session_idstrategy. - Prefer helper-first SDK methods for application code.
- Use
checkpointbefore compaction or risky transitions. - Use
getContextrather than rebuilding long prompts manually.
Failure modes and troubleshooting
| Symptom | Root cause | Fix |
|---|---|---|
| Stale or weak responses | Context was built manually and inconsistently | Standardize on getContext() / get_context() |
| The system does not improve across attempts | Reflection or outcome recording is missing | Pair reflect() with recordOutcome() |
| Multi-agent behavior drifts | Roles are implicit | Register agents and persist handoffs / feedback |
Next steps
- Review the full route contract at Control HTTP reference.
- Apply the workflow in Support agent memory loop.