Skip to main content

Source: docs/manual/run-orchestration.md

This page is generated by site/scripts/sync-manual-docs.mjs.

Run Orchestration

Run orchestration in the UI is centered on the New Run modal with single-agent and multi-agent launch paths.

Source: cmd/ui/frontend/src/components/NewRunModal.tsx, cmd/ui/frontend/src/components/SwarmPreviewModal.tsx, cmd/ui/supervisor_api.go, cmd/ui/run_templates_handler.go

Launch Modes​

  • Single-agent mode: calls POST /api/execute.
  • Multi-agent mode: calls POST /api/supervisor/start.

Both modes are accessible from /runs through the same modal.

Run Templates​

The modal can save and load reusable launch definitions:

  • List templates: GET /api/run-templates
  • Create template: POST /api/run-templates
  • Load template detail: GET /api/run-templates/{id}

Template payloads preserve full form state, including KB IDs and prompt override settings.

Multi-Agent Controls​

Multi-agent launch supports:

  • Pattern selection (delegate, broadcast, debate, pipeline, voting, feature-team).
  • Agent count (bounded in UI and API).
  • Rollback token for coordinated feature-team flows.
  • Per-agent prompt version overrides via tabbed agent slots.
  • Optional raw JSON override fallback for advanced usage.

Pre-Run Preview and Simulation​

Preflight preview​

POST /api/supervisor/preflight-preview returns:

  • Resolved prompt rows per agent
  • KB snippet previews
  • Compliance allow/deny summary and risk score
  • Warnings

Swarm preview mode​

POST /api/supervisor/preview-run returns:

  • Simulated timeline (phase offsets and durations)
  • Predicted total cost and estimated time savings
  • Overall risk score
  • Risk heatmap
  • Blockers list

The modal can optionally simulate force-deploy behavior for high deploy-risk cases.

Feature ripple​

POST /api/supervisor/feature-ripple calculates ripple risk edges for agent-to-agent impact analysis.

Launch Presets​

The modal includes built-in presets:

  • Full Feature Team
  • Feature Team + Primary KB
  • Quick Single Agent v1.2

Presets seed pattern, agent count, KB selection, and (when available) prompt defaults.