PRD-024: sea-api Protocol Gateway

• PRD-ID: PRD-024
• Satisfies: ADR-034, ADR-033
• Relates to: PRD-023 (SEA™ Platform Integration)

Overview

Expose SEA™ capabilities through standardized protocol gateways (OpenAI-compatible API, editor actions) for integration with Zed IDE and LibreChat.

Requirements (EARS)

Editor Integration (Zed)

• REQ-063: When a user invokes an editor action in Zed, the system shall execute the corresponding SEA™ capability and return results to the editor.
• REQ-065: When an editor action request includes a requestId, the system shall ensure idempotent execution using that key.
• REQ-066: When querying capabilities, the system shall return a list of available actions and their input schemas.

Chat Integration (LibreChat)

• REQ-064: When LibreChat sends a chat completion request to /v1/chat/completions, the system shall process it as a stateless request and return an OpenAI-compatible response.
• REQ-067: When a chat request specifies stream: true, the system shall support streaming responses via SSE.

Security & Boundaries

• REQ-068: When any request arrives at the gateway, the system shall verify authentication before processing (POL-048-001).
• REQ-069: When processing requests, the gateway shall remain stateless (POL-048-003).
• REQ-070: When translating protocols, the gateway shall enforce format compatibility (POL-048-002 for OpenAI).