Skip to content

Render live Codex conversations - #4

Merged
VolkerChristian merged 2 commits into
masterfrom
codex/q3-live-conversation
Aug 13, 2026
Merged

VolkerChristian merged 2 commits into
masterfrom
codex/q3-live-conversation

Conversation

@VolkerChristian

@VolkerChristian VolkerChristian commented Aug 13, 2026 •

Copy link
Copy Markdown
Member

Summary

Render the selected Codex thread's live conversation in the Figma v2 center work area from AISuite's current immutable frontend State.

Base SHA: 1599c5913fa8860a30687248af15836f67f7be8e

Depends on AISuite draft PR #20, which scopes provider item identity by thread and turn so repeated full reads remain valid on one observer session.

Public AISuite APIs used

  • client::State::threads(), thread(...), turn(...), parent-scoped item(threadId, turnId, itemId), and pendingRequests()
  • canonical ThreadState::orderedTurns and TurnState::orderedItems
  • controller-free observer client::Threads::read(typed::ThreadReadParams{includeTurns=true}, ...) to populate canonical State; operation results are not rendered or retained
  • client::itemSemanticView(...) with AgentMessageSemanticView, CommandExecutionSemanticView, FileChangeSemanticView, ToolCallSemanticView, WebSearchSemanticView, CollabAgentToolCallSemanticView, PlanSemanticView, and SubAgentActivitySemanticView
  • client::tokenUsageView(...), failureView(...), realtimeSemanticView(...), and pendingRequestPresentation(...)

Rendering coverage

  • chat: UserMessage, AgentMessage
  • typed activity: CommandExecution, FileChange, McpToolCall, DynamicToolCall, WebSearch, CollabAgentToolCall, Plan, SubAgentActivity
  • public-shell activity: Reasoning, ContextCompaction, EnteredReviewMode, ExitedReviewMode, HookPrompt, ImageGeneration, ImageView, Sleep
  • unknown/future kinds render an explicit fallback row with authoritative outer identity and status

Sequential-read repair

  • in-flight IDs retire on every operation completion, success or failure
  • initial synchronization no longer clears a read submitted by the immediately preceding Ready/state callback
  • conversation traversal uses the public parent-scoped item lookup
  • no reconnect, replacement Client, controller acquisition, or protocol workaround

UI scope

Live: selected-thread header, canonical turns/items, user/Codex messages, lifecycle, current-turn summary, typed activity, token/failure/realtime/truncation presentation, and stateChanged() rerender with near-bottom follow.

Intentionally non-functional/demo: composer actions, thread mutations, approvals/controller ownership, right Inspector preview, and shell-level deterministic status decoration outside the center.

Validation

  • cmake --build build --parallel 28: passed
  • AISuite focused tests: 5/5 passed, including two sequential full reads with repeated provider item-1 identities on one persistent observer connection
  • git diff --check: passed in both repositories
  • real Unix backend, one CodexUI process, frontend session 1, backend connection conn=1:
    • A 019ffbed-6412-7a51-92ee-5b8660e730cc (“CodexUI III”): request 2 completed, 30 items
    • B 019ffba3-8dd9-7971-8a33-be6cdee746d5: request 3 completed, 2 items; no stale A widgets
    • C 019ffb56-7e8a-7bd3-8fec-d4b4cfe40760 (“CodexUI II”): request 4 completed, 8 items; no stale B widgets
    • return to A: correct retained conversation, no fourth read
    • no reconnect/disconnect and no controller operation

Q3 remains read-only and adds no controller acquisition, prompt sending, new thread, interrupt/stop backend operation, approvals, manual protocol handling, transport change, second canonical State store, generic Qt model hierarchy, or SNode.C change.

@VolkerChristian
VolkerChristian marked this pull request as ready for review August 13, 2026 18:41
@VolkerChristian
VolkerChristian merged commit f9fee21 into master Aug 13, 2026
@VolkerChristian
VolkerChristian deleted the codex/q3-live-conversation branch September 2, 2026 14:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant