ag-ui-protocol / ag-ui-protocol/ag-ui

[Feature]: Add AWS Labs - CLI Agent Orchestrator (CAO) integration to the Dojo

Abierto
#2,215 2 comentarios 0 reacciones 0 asignados Ver en GitHub
enhancement Integration
Lenguaje dominante
Python
Estrellas
15.9k
Forks
1.4k
Merge medio
1 d 17 h
PR fusionados (30 d)
163

Descripción

### Pre-flight Checklist

- [x] I have searched existing issues and this hasn't been requested yet.

### Problem or Motivation

AG-UI's Dojo showcases agent frameworks, but none demonstrate **live multi-agent orchestration over real OS processes** with human-in-the-loop **interrupts** on genuine CLI permission prompts.

[CLI Agent Orchestrator (CAO)](https://github.com/awslabs/cli-agent-orchestrator) runs each coding agent (Kiro CLI, Claude Code, Codex, …) as a real process in an isolated tmux session and coordinates them supervisor→worker over MCP. It already exposes an AG-UI-compliant surface (see awslabs/cli-agent-orchestrator#458 — the AG-UI Phase 2 L2 construct library + run plane). What's missing is a first-class Dojo integration so users can *see* a real multi-agent fleet — including a genuine interrupt/approval round-trip — rendered through AG-UI.

### Proposed Solution

Add `cli-agent-orchestrator` as a first-class AG-UI integration:

- A TypeScript thin client (`@ag-ui/cli-agent-orchestrator`) — a `HttpAgent` subclass pointing at CAO's AG-UI endpoint (zero extra wire code).
- A **keyless** example server (via CAO's `mock_cli` fleet — no API keys) exposing the four standard features: `agentic_chat`, `shared_state`, `human_in_the_loop`, and the flagship `interrupt` (a real permission prompt → `RUN_FINISHED outcome={type:"interrupt"}` → `resume[]`).
- Dojo wiring (menu/agents/env), content-json, four Playwright e2e specs, and a CI matrix entry — all keyless so the e2e suite runs without secrets.

Because the fleet is real OS processes, the interrupt feature demonstrates something no API-wrapper integration can: approving/denying a live agent's actual permission prompt.

### Alternatives Considered

- An API-wrapper integration — rejected: it loses the real-CLI fidelity (native tool behavior, auth, provider features) that is CAO's entire value proposition.
- Hosting a live multi-agent demo server — deferred to a maintainer-side follow-up (tmux/Docker on the hosted Dojo).

### Additional Context

- Upstream tracking issue: awslabs/cli-agent-orchestrator#458.
- The example server is standalone (no hard dependency on CAO core beyond the pinned `cli-agent-orchestrator[agui]` extra), so there is no cross-repo drift risk.
- I'm ready to submit the implementation PR and to be listed in CODEOWNERS for the integration directory.

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.