[EPIC] Agent Orchestration - Persistent task management #95

Closed
opened 2026-01-29 23:29:55 +00:00 by jason.woltje · 0 comments
Owner

Overview

Infrastructure for persistent task management with Orchestrator service (`apps/orchestrator/`) as the execution backend.

Architectural Decision (2026-02-02 Update)

Architecture updated: Orchestrator is now a monorepo service at `apps/orchestrator/`, not external ClawdBot.

Delegation Model: Mosaic Stack integrates with Orchestrator service rather than building orchestration internally.

Layer Responsibility
Mosaic Stack Control Plane — task CRUD, UI, RBAC, dispatch, kill authority
Orchestrator service (`apps/orchestrator/`) Execution Plane — agent spawning, health monitoring, recovery, scheduling

Scope

Mosaic Stack handles:

• Task definitions and CRUD API
• Database persistence (survives restarts)
• Progress UI and audit trail
• Dispatch to Orchestrator service backend
Kill authority over all Orchestrator operations
• Failure handling (when Orchestrator reports failures)

Orchestrator service (`apps/orchestrator/`) handles:

• Agent spawning and lifecycle
• Health monitoring and heartbeats
• Automatic recovery
• Task coordination and scheduling

Phases

• Phase 1: Foundation (database schema, CRUD API)
• Phase 2: Orchestrator Integration (dispatcher, callbacks, kill endpoints)
• Phase 3: Failure Handling (retry logic, escalation)
• Phase 4: Observability (dashboard, kill controls)

#83 Federation EPIC (cross-instance coordination)
#102 Gateway Integration (Orchestrator connection)
• ORCH-101 to ORCH-134 (Orchestrator implementation issues)

## Overview Infrastructure for persistent task management with Orchestrator service (\`apps/orchestrator/\`) as the execution backend. ## Architectural Decision (2026-02-02 Update) **Architecture updated:** Orchestrator is now a monorepo service at \`apps/orchestrator/\`, not external ClawdBot. **Delegation Model:** Mosaic Stack integrates with Orchestrator service rather than building orchestration internally. | Layer | Responsibility | |-------|----------------| | **Mosaic Stack** | Control Plane — task CRUD, UI, RBAC, dispatch, **kill authority** | | **Orchestrator service (\`apps/orchestrator/\`)** | Execution Plane — agent spawning, health monitoring, recovery, scheduling | ## Scope **Mosaic Stack handles:** • Task definitions and CRUD API • Database persistence (survives restarts) • Progress UI and audit trail • Dispatch to Orchestrator service backend • **Kill authority** over all Orchestrator operations • Failure handling (when Orchestrator reports failures) **Orchestrator service (\`apps/orchestrator/\`) handles:** • Agent spawning and lifecycle • Health monitoring and heartbeats • Automatic recovery • Task coordination and scheduling ## Phases • Phase 1: Foundation (database schema, CRUD API) • Phase 2: Orchestrator Integration (dispatcher, callbacks, kill endpoints) • Phase 3: Failure Handling (retry logic, escalation) • Phase 4: Observability (dashboard, kill controls) ## Related • #83 Federation EPIC (cross-instance coordination) • #102 Gateway Integration (Orchestrator connection) • ORCH-101 to ORCH-134 (Orchestrator implementation issues)
jason.woltje added this to the M6-AgentOrchestration (0.0.6) milestone 2026-01-29 23:29:55 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaic/stack#95