Agent Mesh — UI surfaces¶
Target
This page describes intended behaviour or structure. No implementation is claimed unless a section is explicitly marked Current implementation or Evidence.
The Agent Mesh has no interface of its own. It serves read models and a small set of commands to the Studio BFF (GW-03); the Studio renders them inside the run views whose authority is the Control plane. The CLI and the VS Code extension show the same timeline.
Screens fed by the Agent Mesh¶
| Studio work area | Screen | Read model | Commands |
|---|---|---|---|
| Operations & usage | Run detail → attempt timeline (phases, checkpoints, calls by hash and receipt, decisions, outcome) | GET /runtime/attempts/{attemptId}, Runtime.WatchAttempt stream |
none; cancel is a Control plane command |
| Operations & usage | Run detail → workflow graph (step states, timers, compensation) | GET /runtime/workflow-runs/{runId} |
none |
| Operations & usage | Decisions inbox: inputs and escalations (approvals are the Control plane's inbox) | AttemptDecisionRequested events through the BFF |
Runtime.AnswerDecision |
| Operations & usage | Operator recovery view: checkpoints and their adapter versions before a resume decision | GET /runtime/attempts/{attemptId}/checkpoints |
none; a new attempt is a Control plane decision |
| Assets | Release detail → "verified by runtime" panel | GET /runtime/releases/{releaseId} |
none |
| Assets | Workflow definition versions and validation results | GET /runtime/workflow-definitions/{definitionId}/versions, POST /runtime/workflow-definitions/validate |
validate (sandbox) |
State families shown¶
| Family | Values |
|---|---|
| Attempt (runtime view) | Claimed, Running, WaitingForTool, WaitingForDecision, Paused, Succeeded, Failed, TimedOut, Cancelled, Uncertain |
| Attempt phase | Resolving, LoadingRelease, BuildingContext, Planning, Calling, Observing, Verifying, Correcting, Checkpointing, Reporting |
| Workflow run | Pending, Running, WaitingForTimer, WaitingForHuman, Compensating, Completed, Failed, Cancelled |
| Step run | Pending, Ready, Requested, Running, Succeeded, Failed, Skipped, Compensated, Cancelled |
| Decision | pending, answered, expired |
Rules the clients must honour¶
- Content never crosses the BFF from the runtime. Timelines show hashes, receipt references and artifact links; the artifact itself is fetched from Knowledge under its own permission and retention.
- Uncertain is a first-class state, shown with the receipt that caused the doubt and an explicit operator action (confirm effect, start new attempt, fail), never as a retry button.
- Decisions show the exact proposal version they answer; a stale decision is refused server-side and the screen re-reads.
- Live updates come from the stream, the next read is the truth; a toast is not.
CLI and VS Code¶
factory runs timeline <runId>, factory runs graph <runId>, factory decisions list|answer, factory workflows validate <file>; the VS Code run panel shows the attempt timeline and the workflow graph for the run bound to the current repository and lets a maintainer validate a workflow DSL file in the editor.