Debugging playbook

AgentUI Workflow Stall

Use when an AgentUI workflow node, save/export/share/delegate, or dry-run/run span stalls.

Linked toolsok
4
Source: playbook registry
Updated: 5/25/2026, 5:11:10 PM
Evidence/query
Commandsok
2
Source: playbook registry
Updated: 5/25/2026, 5:11:10 PM
Evidence/query
AgentUITraceClawsSandbox
Symptoms
  • agentui span is waiting.
  • Workflow node has no terminal event.
  • Delegation edge is missing from service map.
Likely Causes
  • Workflow run did not emit heartbeat.
  • Storage adapter is local-only.
  • Delegated service did not propagate headers.
Checks
  • Inspect async job state.
  • Open trace service map.
  • Check node execution span parentage.
Evidence To Collect
  • workflow ID
  • node ID
  • job ID
  • delegate target
  • trace headers
platphormctl Commands
platphormctl trace propagate --service agentui
platphormctl trace incomplete