naps62/maestro
Archived
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases Wiki Activity

Support Codex ACP configuration and lifecycle events #201

New Issue
Closed
opened 2026-09-06 17:56:59 +01:00 by naps62-yolo · 0 comments
naps62-yolo commented 2026-09-06 17:56:59 +01:00
Collaborator
Copy Link
Copy Source

Depends on: #200

Goal

Make Codex sessions satisfy Maestro's existing structured-session contract across configuration, transcript projection, permissions, usage reporting, cancellation, and resume.

Requirements

  • Exercise the maintained @agentclientprotocol/codex-acp adapter against Maestro's ACP handshake and document any provider-specific capability differences.
  • Verify model, reasoning-effort, mode, and command configuration from the adapter's advertised session options.
  • Correctly project Codex text, reasoning, plans, shell commands, file changes, MCP calls, web/search and media-related tool events using the existing eight transcript row kinds.
  • Verify permission decisions, turn cancellation, token/context usage, adapter failure, and session/load behavior.
  • Preserve understood-but-unrendered updates as notices; upgrade or extend the ACP schema only where a real Codex update requires it.
  • Add deterministic compatibility fixtures plus the narrowest practical real-adapter smoke coverage that does not require CI credentials.
  • Amend docs/STRUCTURED-VIEW.md so its core contract is provider-independent and Claude/Codex differences are explicit.

Non-goals

  • Reproducing every Codex app-server feature beyond what ACP exposes.
  • Web or TUI visual redesign.
  • TUI parity with browser-only Markdown, clipboard, hover, or autocomplete behavior.
Depends on: #200 ## Goal Make Codex sessions satisfy Maestro's existing structured-session contract across configuration, transcript projection, permissions, usage reporting, cancellation, and resume. ## Requirements - Exercise the maintained `@agentclientprotocol/codex-acp` adapter against Maestro's ACP handshake and document any provider-specific capability differences. - Verify model, reasoning-effort, mode, and command configuration from the adapter's advertised session options. - Correctly project Codex text, reasoning, plans, shell commands, file changes, MCP calls, web/search and media-related tool events using the existing eight transcript row kinds. - Verify permission decisions, turn cancellation, token/context usage, adapter failure, and `session/load` behavior. - Preserve understood-but-unrendered updates as notices; upgrade or extend the ACP schema only where a real Codex update requires it. - Add deterministic compatibility fixtures plus the narrowest practical real-adapter smoke coverage that does not require CI credentials. - Amend `docs/STRUCTURED-VIEW.md` so its core contract is provider-independent and Claude/Codex differences are explicit. ## Non-goals - Reproducing every Codex app-server feature beyond what ACP exposes. - Web or TUI visual redesign. - TUI parity with browser-only Markdown, clipboard, hover, or autocomplete behavior.
naps62-yolo added this to the Codex structured sessions milestone 2026-09-06 17:56:59 +01:00
naps62-yolo added the area/protocoldifficulty/hardtype/feat labels 2026-09-06 17:57:21 +01:00
This repo is archived. You cannot comment on issues.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/android
area/cli
area/config
area/daemon
area/protocol
area/tui
area/web
code-review
difficulty/easy
difficulty/hard
difficulty/medium
epic
Tracks a multi-issue epic / parent work item
 tui
type/docs
type/feat
type/fix
type/refactor
type/test
No labels area/protocol difficulty/hard type/feat
Milestone
No items
No Milestone Codex structured sessions
Projects
Clear projects
No projects
Assignees
Clear assignees
hermes (Hermes (agent)) naps62-yolo (naps62-yolo (agent)) resende (Resende) naps62 (Miguel Palhas)
No Assignees
1 Participants
Due Date
No due date set.
Depends on
#200 Select structured ACP adapters from the resolved agent command
naps62/maestro
Reference: naps62/maestro#201