jordan 39df51defd feat: Add multi-provider code agent interface with Claude Code and OpenCode adapters

Implements weeks 1-4 of the multi-provider architecture:

Week 1 - Foundation:
- Add domain models (AgentProvider, AgentRequest, AgentEvent, AgentResult)
- Define CodeAgent port interface with Execute, Cancel, Capabilities
- Create thread-safe provider registry with first-registered default

Week 2 - Claude Code Adapter:
- Extract kubectl exec logic into CodeAgent implementation
- Parse stream-json output format (init, message, tool_use, result)
- Support session continuation via --resume flag

Week 3 - OpenCode Adapter:
- HTTP/SSE client for opencode serve API
- Session management (create, send message, abort)
- Event streaming with documented buffer rationale

Week 4 - Quality & Polish:
- Fix race condition in OpenCode Cancel method
- Add AgentRequest.Validate() with ErrPromptRequired, ErrInvalidTimeout
- Document DefaultAvailabilityTimeout constants
- Add HTTP error context for debugging

Also includes:
- Work queue system with PostgreSQL adapter
- Credential store for infrastructure secrets
- Project templates with Woodpecker CI integration
- Comprehensive test coverage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-27 09:25:51 -07:00

1.3 KiB

Raw Blame History

SSE Streaming

Last Updated: 2025-01 Confidence: High

Summary

Server-Sent Events (SSE) stream command output in real-time. Clients connect to a stream URL and receive output as it's produced.

Key Facts:

Endpoint: GET /projects/{id}/events/{stream_id}
Content-Type: text/event-stream
Events: output (stdout/stderr), done (completion)
In-memory stream publisher for current implementation
Stream URLs returned from command execution endpoints

File Pointers:

Handler: internal/handlers/projects.go (events endpoint)
Publisher: internal/adapter/memory/stream.go
Port: internal/port/stream.go

Client Usage

curl -N -H "X-API-Key: $KEY" \
  "http://localhost:8080/projects/my-project/events/stream-123"

Event Format

event: output
data: {"type": "stdout", "content": "Hello world\n"}

event: output
data: {"type": "stderr", "content": "Warning: ...\n"}

event: done
data: {"exit_code": 0, "duration_ms": 1234}

Flow

Client calls POST /projects/{id}/claude
Response includes stream_url
Client connects to stream_url via SSE
Server streams output events as produced
done event signals completion

1.3 KiB Raw Blame History