mosaic/stack
1
0
Fork 0
Code Issues 10 Pull Requests Actions Packages Projects Releases 2 Wiki Activity

[INFRA-012] SSE endpoint for CLI consumers #174

New Issue
Closed
opened 2026-02-01 07:25:31 +00:00 by jason.woltje · 0 comments
jason.woltje commented 2026-02-01 07:25:31 +00:00
Owner
Copy Link

Summary

Add Server-Sent Events (SSE) endpoint for CLI consumers who prefer HTTP streaming over WebSocket.

Endpoint

GET /runner-jobs/:jobId/events/stream

Response Format

event: step.started
data: {"stepId": "uuid", "name": "Running tests", "phase": "validation"}

event: step.output
data: {"stepId": "uuid", "chunk": "Test suite passed: 42/42"}

event: step.completed
data: {"stepId": "uuid", "status": "completed", "duration_ms": 1234}

Tasks

  • Create SSE endpoint in runner-jobs controller
  • Implement event stream from Valkey Pub/Sub
  • Add keep-alive pings
  • Handle connection cleanup
  • Add authentication

Files to Modify

  • apps/api/src/runner-jobs/runner-jobs.controller.ts

Acceptance Criteria

  • curl can stream events
  • Events match WebSocket format
  • Keep-alive prevents timeout
  • Auth token required

Related

## Summary Add Server-Sent Events (SSE) endpoint for CLI consumers who prefer HTTP streaming over WebSocket. ## Endpoint GET /runner-jobs/:jobId/events/stream ## Response Format ``` event: step.started data: {"stepId": "uuid", "name": "Running tests", "phase": "validation"} event: step.output data: {"stepId": "uuid", "chunk": "Test suite passed: 42/42"} event: step.completed data: {"stepId": "uuid", "status": "completed", "duration_ms": 1234} ``` ## Tasks - [ ] Create SSE endpoint in runner-jobs controller - [ ] Implement event stream from Valkey Pub/Sub - [ ] Add keep-alive pings - [ ] Handle connection cleanup - [ ] Add authentication ## Files to Modify - apps/api/src/runner-jobs/runner-jobs.controller.ts ## Acceptance Criteria - curl can stream events - Events match WebSocket format - Keep-alive prevents timeout - Auth token required ## Related - Epic: #162 - Depends on: #169 (job events)
jason.woltje added this to the M4.2-Infrastructure (0.0.4) milestone 2026-02-01 07:25:31 +00:00
jason.woltje added the apiapiphase-4p1 labels 2026-02-01 07:25:31 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
ai
AI/LLM integration
 api
Backend/API work
 api
auth
Authentication
 database
database
Database/schema work
 devops
Docker/deployment
 docs
Documentation
 frontend
graph
knowledge-module
migration
Data migration
 orchestrator
Orchestrator service (apps/orchestrator/)
 p0
Critical priority
 p1
High priority
 p2
Medium priority
 p3
Low priority
 performance
Performance work
 phase-1
phase-2
phase-3
phase-4
phase-5
plugin
MoltBot plugin work
 search
security
Security-related
 setup
Initial setup
 testing
Testing/QA
 web
Frontend work
No Label api api p1 phase-4
Milestone
No items
No Milestone M4.2-Infrastructure (0.0.4)
Projects
Clear projects
No project
Assignees
Clear assignees
jason.woltje
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mosaic/stack#174
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?