Add Codex chat integration to desktop app

[arul28]

Summary

• add the new CodexChatPage, its supporting state slice, renderer UI elements, and startup path wiring so the desktop app can host the Codex chat surface
• introduce shared IPC/types and preload hooks plus a main-process codex service stack (JSON-RPC parser, lane thread store, codex app server service) that materializes threads and exposes the required endpoints
• cover the new services/state with targeted unit tests so the integration logic stays verifiable as it evolves

Testing

• Not run (not requested)

Summary by CodeRabbit

• New Features

  • Integrated Codex chat with thread management, turn-based conversations, and model/reasoning effort selection.
  • Added ChatGPT and API key authentication for Codex accounts.
  • Added approval workflow UI for command execution and file change requests.
  • Lane-thread binding persistence for chat continuity.

• UI/UX Enhancements

  • New Codex tab in main navigation.
  • Codex Chat button in terminal view for inline and full-page chat modes.
  • Lane picker dialog to select lanes for inline chat.
  • Connection state management and retry controls.

• Performance

  • Optimized Vite caching and development configuration.
  • Improved startup page initialization with staged data loading.

[coderabbitai]

📝 Walkthrough

Walkthrough

This PR introduces a comprehensive Codex app-server integration into the desktop application. It adds a new backend service that spawns and manages the Codex process via JSON-RPC over stdio, implements lane/thread lifecycle management with persistent storage, exposes IPC handlers for all Codex operations, creates a new CodexChatPage UI component for chat interactions, and integrates Codex chat capabilities into existing views.

Changes

Cohort / File(s)	Summary
Core Codex Service apps/desktop/src/main/services/codex/codexAppServerService.ts, codexAppServerService.test.ts	Implements complete Codex app-server orchestration with process spawning, JSON-RPC over stdio protocol, request/response tracking, approval workflows, lane/thread management, and lifecycle controls; comprehensive test suite covers request/response correlation, approval flows, turn operations, retry logic, and error handling.
JSON-RPC Protocol apps/desktop/src/main/services/codex/jsonRpcLineParser.ts, jsonRpcLineParser.test.ts	Defines JSON-RPC message types and line-based parser for newline-delimited JSON communication; handles buffering, partial messages, and error resilience with unit tests for multi-chunk parsing and invalid JSON handling.
Lane/Thread Persistence apps/desktop/src/main/services/codex/laneThreadStore.ts, laneThreadStore.test.ts	Implements per-lane thread binding storage with recent thread history, default thread tracking, and reverse lookup; includes sanitization and persistent backing via AdeDb.
Main Process Integration apps/desktop/src/main/main.ts	Wires codexAppServerService into AppContext, initializes with db/logger/laneService/clientVersion, exposes via IPC, and ensures proper disposal on context close.
IPC & Bridge apps/desktop/src/main/services/ipc/registerIpc.ts, apps/desktop/src/preload/preload.ts, apps/desktop/src/preload/global.d.ts	Adds 18 new IPC handlers for Codex operations (connection, threads, turns, accounts, models, approvals); exposes codex API surface on window.ade via preload; includes type imports for all Codex types.
Shared IPC Channels apps/desktop/src/shared/ipc.ts	Adds 19 IPC channel constants under ade.codex.* namespace for all Codex operations.
Type Definitions apps/desktop/src/shared/types.ts	Defines comprehensive TypeScript types for Codex concepts: connection state, accounts, rate limits, models, threads, turns, approvals, authentication, and event payloads; all exported for type safety across main/renderer.
Chat UI Component apps/desktop/src/renderer/components/codex/CodexChatPage.tsx	Introduces full-featured Codex chat UI with state management, thread lifecycle handling, model/effort selection, prompt submission, turn rendering, and approval workflows; supports both embedded and full-page modes.
Chat State Management apps/desktop/src/renderer/state/codexChatState.ts, codexChatState.test.ts	Implements reducer-based state container for chat with hydration from threads, turn/item management, streaming delta handling, and approval tracking; includes type definitions and selector utilities.
UI Integration apps/desktop/src/renderer/components/app/App.tsx, TabNav.tsx, LaneWorkPane.tsx, TerminalsPage.tsx, StartupAuthPage.tsx	Registers /codex route, adds Codex tab navigation, integrates CodexChatPage into lane work pane with embedded mode, adds inline Codex chat to terminals view with lane picker dialog, refactors startup flow for cached snapshot handling.
Build Configuration apps/desktop/package.json, apps/desktop/vite.config.ts	Updates dev script with --force flag for Vite; adds stable cache directory and optimizeDeps configuration to exclude UI/motion libraries from pre-bundling.

Sequence Diagram(s)

sequenceDiagram
    participant Renderer as Renderer Process
    participant IPC as IPC Bridge
    participant Service as CodexAppServerService
    participant ChildProcess as Codex App Server
    
    Renderer->>IPC: codexThreadStart({ laneId, model })
    IPC->>Service: threadStart(args)
    Service->>ChildProcess: thread/start (JSON-RPC)
    ChildProcess-->>Service: thread/start response
    Service->>Service: Store lane-thread binding
    Service-->>IPC: Return CodexThread
    IPC-->>Renderer: Promise<CodexThread>
    
    Renderer->>IPC: codexTurnStart({ threadId, prompt, effort })
    IPC->>Service: turnStart(args)
    Service->>ChildProcess: turn/start (JSON-RPC)
    ChildProcess-->>Service: turn/start response
    ChildProcess-->>Service: item/commandExecution (notification)
    Service-->>Renderer: codexEvent (via IPC)
    Renderer->>Renderer: Update chat UI with turn
    
    ChildProcess-->>Service: item/fileChange (approval request)
    Service->>Service: Store pending approval
    Service-->>Renderer: codexEvent (approval request)
    Renderer->>Renderer: Render approval card
    
    Renderer->>IPC: codexRespondApproval({ requestId, decision })
    IPC->>Service: respondToApprovalRequest(requestId, decision)
    Service->>ChildProcess: approval/response (JSON-RPC)
    ChildProcess-->>Service: acknowledgement
    Service->>Service: Clear pending approval

Loading

sequenceDiagram
    participant User as User
    participant CodexChatUI as CodexChatPage Component
    participant ChatState as Chat State (Reducer)
    participant API as Codex API (IPC)
    
    User->>CodexChatUI: Select lane, write prompt
    CodexChatUI->>API: getLaneBinding(laneId)
    API-->>CodexChatUI: CodexLaneThreadBinding
    alt Thread exists
        CodexChatUI->>API: threadResume({ laneId, threadId })
    else No thread
        CodexChatUI->>API: threadStart({ laneId, model })
    end
    API-->>CodexChatUI: CodexThread
    
    CodexChatUI->>ChatState: hydrate-thread action
    ChatState-->>CodexChatUI: Updated state with turns
    CodexChatUI->>CodexChatUI: Render thread turns
    
    User->>CodexChatUI: Submit prompt with model/effort
    CodexChatUI->>API: turnStart({ threadId, prompt, model, effort })
    CodexChatUI->>API: onEvent(callback)
    API-->>CodexChatUI: Turn initiated
    
    API-->>CodexChatUI: codexEvent (turn-started, item notifications, completion)
    CodexChatUI->>ChatState: notification action (streaming deltas)
    ChatState-->>CodexChatUI: Updated with turn items
    CodexChatUI->>CodexChatUI: Re-render active turn
    
    alt Item requires approval
        API-->>CodexChatUI: codexEvent (approval request)
        CodexChatUI->>CodexChatUI: Render ApprovalCard
        User->>CodexChatUI: Accept/decline
        CodexChatUI->>API: codexRespondApproval({ requestId, decision })
    end

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~75 minutes

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}