code-mode: introduce durable session interface (#24180)

mirror of https://github.com/pchuan98/codex.git synced 2026-07-01 00:31:56 +08:00

## Summary

Introduce a `CodeModeSession` interface for executing and managing
code-mode cells.

This moves cell lifecycle, callback delegation, termination, and
shutdown behind a session abstraction, while continuing to use the
existing in-process implementation, and the ability to implement an
external process one behind this interface.

A Codex session owns one `CodeModeSession`, which in turn owns its
running cells and stored code-mode state. Each cell is represented to
the caller as a `StartedCell`, exposing its cell ID and initial
response.

It also introduces a `CodeModeSessionDelegate` callback interface. A
session uses the delegate to invoke nested host tools and emit
notifications while a cell is running, allowing the runtime to
communicate with its owning Codex session without depending directly on
core turn handling.

<img width="2121" height="1001" alt="image"
src="https://github.com/user-attachments/assets/c349a819-2a59-485c-bda4-2caf68ac4c31"
/>

This commit is contained in:

Channing Conger

2026-05-29 11:42:52 -07:00

committed by

GitHub

parent 451b386442

commit c9dc0f6338

11 changed files with 1056 additions and 458 deletions

codex-rs/Cargo.lock

Generated

-2

View File

@@ -2430,8 +2430,6 @@ dependencies = [
 name = "codex-code-mode"
 version = "0.0.0"
 dependencies = [
  "async-channel",
  "async-trait",
  "codex-protocol",
  "deno_core_icudata",
  "pretty_assertions",