[ORCH-007] Gateway Integration #102

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

Phase 2: Orchestrator Integration

Core integration with Orchestrator service (`apps/orchestrator/`) Gateway API for agent spawning and control.

Deliverables

[ ] Orchestrator Gateway API client (spawn, status, kill)
[ ] Task context serialization (convert Mosaic task to Orchestrator format)
[ ] Session token management (track Orchestrator session IDs)
[ ] Callback endpoint registration (tell Orchestrator where to report)
[ ] Health check endpoint (verify Orchestrator reachability)
[ ] Kill session API (terminate running Orchestrator session)

API Operations

// Spawn agent session
POST /orchestrator/sessions/spawn
{ task, context, callback_url }

// Check session status
GET /orchestrator/sessions/:id/status

// Kill session (hard termination)
POST /orchestrator/sessions/:id/kill

// List active sessions
GET /orchestrator/sessions

Auth Flow

• Mosaic Stack issues scoped token for callbacks
• Orchestrator includes token in all callbacks
• Mosaic Stack validates token before accepting updates

Dependencies

#99 Task Dispatcher Service

#95 Agent Orchestration EPIC
• Orchestrator service at `apps/orchestrator/`
• ORCH-102 (Orchestrator server implementation)
• ORCH-113 (Coordinator API client)

## Phase 2: Orchestrator Integration Core integration with Orchestrator service (\`apps/orchestrator/\`) Gateway API for agent spawning and control. ## Deliverables [ ] Orchestrator Gateway API client (spawn, status, kill) [ ] Task context serialization (convert Mosaic task to Orchestrator format) [ ] Session token management (track Orchestrator session IDs) [ ] Callback endpoint registration (tell Orchestrator where to report) [ ] Health check endpoint (verify Orchestrator reachability) [ ] **Kill session API** (terminate running Orchestrator session) ## API Operations ``` // Spawn agent session POST /orchestrator/sessions/spawn { task, context, callback_url } // Check session status GET /orchestrator/sessions/:id/status // Kill session (hard termination) POST /orchestrator/sessions/:id/kill // List active sessions GET /orchestrator/sessions ``` ## Auth Flow • Mosaic Stack issues scoped token for callbacks • Orchestrator includes token in all callbacks • Mosaic Stack validates token before accepting updates ## Dependencies • #99 Task Dispatcher Service ## Related • #95 Agent Orchestration EPIC • Orchestrator service at \`apps/orchestrator/\` • ORCH-102 (Orchestrator server implementation) • ORCH-113 (Coordinator API client)
jason.woltje added this to the M6-AgentOrchestration (0.0.6) milestone 2026-01-29 23:30:27 +00:00
jason.woltje added the phase-2apiapip0 labels 2026-01-29 23:30:27 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaic/stack#102