Add gRPC-backed code-mode sessions (#38041)

## What changed

- Add `GrpcCodeModeSessionProvider` for opening code-mode sessions over HTTP/2 or an existing `tonic` channel.
- Support execution, waiting, termination, per-session limits, cell-closure callbacks, and graceful shutdown over the gRPC protocol.
- Bound transport waits and error messages, validate host identifiers and responses, and clean up abandoned executions and observers.

## Testing

- Add end-to-end TCP tests covering session persistence, cancellation, concurrent waits, shutdown, cell cleanup, and independent yield limits.
- Add unit coverage for protocol conversion, deadlines, and session lifecycle state.

GitOrigin-RevId: d4729ce608ad4b42a99744b07e1f230e46cb24ec
This commit is contained in:
Channing Conger
2026-08-11 17:31:11 +00:00
committed by copyberry
parent b2543af02b
commit 1e557a554e
20 changed files with 2275 additions and 17 deletions
@@ -0,0 +1,89 @@
use codex_code_mode_protocol::CellId;
use codex_code_mode_protocol::grpc;
use pretty_assertions::assert_eq;
use super::SessionState;
#[test]
fn cell_closure_waits_until_the_started_cell_is_claimed() {
let mut state = SessionState::default();
state
.begin_execution("execution".to_string())
.expect("register execution");
assert_eq!(
state
.close_cell(grpc::CellClosed {
execution_id: "execution".to_string(),
cell_id: "cell".to_string(),
final_tool_call_sequence: 0,
})
.expect("record early cell closure"),
None
);
state
.admit_execution("execution", "cell")
.expect("admit started cell");
assert_eq!(
state
.mark_execution_ready("execution")
.expect("claim started cell"),
Some(CellId::new("cell".to_string()))
);
}
#[test]
fn oversized_cell_ids_are_rejected_before_admission() {
let mut state = SessionState::default();
state
.begin_execution("execution".to_string())
.expect("register execution");
assert_eq!(
state.admit_execution("execution", &"x".repeat(grpc::MAX_IDENTIFIER_BYTES + 1)),
Err(format!(
"gRPC code-mode host returned cell ID exceeding {} bytes",
grpc::MAX_IDENTIFIER_BYTES
))
);
assert_eq!(state.remove_execution("execution"), None);
}
#[test]
fn abandonment_before_start_ignores_later_cell_closure() {
let mut state = SessionState::default();
state
.begin_execution("execution".to_string())
.expect("register execution");
assert_eq!(state.remove_execution("execution"), None);
assert_eq!(
state
.close_cell(grpc::CellClosed {
execution_id: "execution".to_string(),
cell_id: "cell".to_string(),
final_tool_call_sequence: 0,
})
.expect("ignore closure for abandoned execution"),
None
);
assert!(state.close(/*failure*/ None).is_empty());
}
#[test]
fn disconnect_returns_each_live_cell_once() {
let mut state = SessionState::default();
state
.begin_execution("execution".to_string())
.expect("register execution");
state
.admit_execution("execution", "cell")
.expect("admit execution");
assert_eq!(
state.close(Some("lease closed".to_string())),
vec![CellId::new("cell".to_string())]
);
assert!(state.close(/*failure*/ None).is_empty());
assert_eq!(state.require_open(), Err("lease closed".to_string()));
}