gateway-orchestrator-contract

What problem does it solve?

This Skill standardizes the contract between AgentHub Gateway and the internal Orchestrator, preventing process-boundary leaks and ensuring reliable streamed orchestration with traceability and safe error handling.

Core Features & Use Cases

• Service boundary enforcement: Guarantees Gateway only handles external HTTP/SSE, while Orchestrator owns planning, execution, fallback/retry, and internal streaming.
• Stable inter-process streaming protocol: Defines the internal OrchestratorStreamEvent (snake_case) and the required mapping responsibility to AG-UI events (UPPER_SNAKE_CASE).
• Operational correctness for runs: Specifies OrchestratorRequest, OrchestrationPlan, OrchestratorResult, run lifecycle/status, ordered_parallel and sequential behaviors.
• Cross-process safety & reliability: Mandates internal auth, timeout, cancellation propagation, trace header propagation, and SafeError error contracts.
• Contract test and mock-first guidance: Provides minimum checks to validate endpoints, serialization, streaming, cancel behavior, and error redaction.

Quick Start

Implement Gateway and Orchestrator as two independent processes and use this contract to validate request/stream/result shapes, internal auth, trace headers, and cancellation semantics end to end.