Skip to content
Orchestration5 min read

Multi-Specialist Group Rooms & Orchestration

Visible supervisor routing, step-by-step run_events execution telemetry, and instant run cancellation inside multi-department Group Rooms.

Real operational exceptions cross departmental boundaries: customs documentation meets warehouse quarantine rules meets carrier scheduling. SCA handles this through Group Rooms orchestrated cleanly by Mastra.

How supervisor routing works

When a coordinator posts an issue in a Group Room (such as Coca-Cola Cross-Border Lane Ops):

  • Explicit @mention or automatic triage: Address one specialist directly with @Customs Specialist or post an open operational question. A supervisor analyzes the thread context and delegates sequentially or in sequence to the right specialists in the room.
  • Scoped specialist identity per turn: Each invoked specialist keeps its own system instructions, its own attached Knowledge Collections, and its own tool permissions—preventing customs tariffs from leaking into unrelated general prompts.
  • Structured visible handoff: Each specialist response renders as a clearly attributed card inside the group timeline, showing View activity (Checks performed, cited handbooks, and handoff step context).

Streaming events & deterministic Stop

Long-running multi-step checks stream live progress via persisted run_events, keeping UI state resilient across browser refreshes:

  • Dispatchers see clear plain-language status feedback while specialists search handbooks or check transport conditions.
  • Clicking Stop cancels execution immediately via server-side abort propagation, emits an explicit interrupted status, and preserves whatever verified information was gathered before cancellation.

Summary checkpoints for ongoing operational rooms

Like Direct Threads, long-lived Group Rooms generate manual or automatic Room Summary Checkpoints, giving shift replacements an immediate digest of active shipment holds, verified customs steps, and pending approvals.