dermanyang-oai b781733f95 Separate thread preparation from execution persistence (#47199) ...

## Why

Injecting context before the first turn currently forces a full flush. Stores need a preparation checkpoint that can leave disposable context in memory, while local storage must keep prepared context durable before the first user input.

## What changed

- Add `PersistContext::ThreadPreparation` and `CodexThread::checkpoint_preparation()`, and use the checkpoint in `inject_response_items()`.
- Allow stores to defer rollout-derived metadata writes through `record_thread_metadata()`, including during preparation and execution checkpoints. Keep standard metadata updates synchronous.
- Flush local storage at preparation checkpoints so injected context survives restart.

## Testing

Add tests showing that preparation and first sampling can proceed without waiting for durable metadata. Cover prepared context in first and follow-up requests, plus durability before first input and restoration after restart, in both legacy and paginated history modes.

GitOrigin-RevId: 74f6bb1a5f8d47192364b8bba6afd703a3b7d688

2026-09-22 05:53:29 +00:00

..

agent

Track cumulative MCP attribution across requests and thread history (#47081)

2026-09-21 18:19:07 +00:00

apps

Make Apps guidance react to MCP availability (#30226)

2026-07-06 14:29:19 -07:00

config

Enable the fullscreen transcript by default (#47178)

2026-09-22 03:20:04 +00:00

context

Include attributed previews in agent message board notifications (#47075)

2026-09-21 17:29:13 +00:00

context_manager

Defer extension tool history materialization until first access (#47035)

2026-09-21 13:56:17 +00:00

exec_policy

Apply remote platform semantics to exec safety checks (#42113)

2026-09-01 18:24:56 +00:00

guardian

Add extra policy configuration for Guardian reviews (#47125)

2026-09-21 23:06:36 +00:00

mcp_tool_call

Use captured step settings for tool planning and execution (#44242)

2026-09-09 17:45:37 +00:00

plugins

Attribute command and plugin analytics to the invoking model (#45445)

2026-09-14 15:30:22 +00:00

realtime_conversation

Support attaching to existing realtime calls (#39876)

2026-08-21 06:41:28 +00:00

realtime_history

Record realtime conversation history in Core (#41924)

2026-08-31 22:38:23 +00:00

sandboxing

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

session

Apply workspace routing to Guardian v2 classifier requests (#47162)

2026-09-22 02:33:29 +00:00

state

Expose a backend-independent agent control contract (#46547)

2026-09-19 01:03:55 +00:00

tasks

Preserve originating turn metadata for yielded skill calls (#47106)

2026-09-21 20:34:46 +00:00

thread_manager

Allow thread instruction providers to share updates with subagents (#46577)

2026-09-19 02:15:20 +00:00

tools

Preserve empty cell metadata under pending tool-call pressure (#47174)

2026-09-22 03:03:52 +00:00

unified_exec

Keep step settings and approval environments consistent (#46556)

2026-09-19 01:27:26 +00:00

utils

Count serialized JSON bytes without allocating strings (#40604)

2026-08-25 13:10:24 +00:00

agent_communication.rs

Support plaintext collaboration tool messages (#35845)

2026-07-28 23:49:37 +00:00

agent_message_board.rs

Include attributed previews in agent message board notifications (#47075)

2026-09-21 17:29:13 +00:00

agents_md_manager.rs

Allow thread instruction providers to share updates with subagents (#46577)

2026-09-19 02:15:20 +00:00

agents_md_tests.rs

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

agents_md.rs

Reject paths in project documentation fallback filenames (#45865)

2026-09-16 04:59:23 +00:00

apply_patch_tests.rs

Preserve filesystem sandbox policy context when the cwd disappears (#46112)

2026-09-17 04:37:54 +00:00

apply_patch.rs

Authorize apply_patch in the executor path context (#42391)

2026-09-02 23:58:24 +00:00

attestation.rs

[codex] request desktop attestation from app (#20619)

2026-05-08 12:36:02 -07:00

client_common_tests.rs

Refactor image content to use a shared ImageReference type (#45543)

2026-09-14 23:25:09 +00:00

client_common.rs

Normalize image detail for the receiving model (#44249)

2026-09-09 17:56:06 +00:00

client_tests.rs

Track cumulative MCP attribution across requests and thread history (#47081)

2026-09-21 18:19:07 +00:00

client.rs

Track cumulative MCP attribution across requests and thread history (#47081)

2026-09-21 18:19:07 +00:00

codex_delegate_tests.rs

Keep step settings and approval environments consistent (#46556)

2026-09-19 01:27:26 +00:00

codex_delegate.rs

Keep step settings and approval environments consistent (#46556)

2026-09-19 01:27:26 +00:00

codex_thread.rs

Separate thread preparation from execution persistence (#47199)

2026-09-22 05:53:29 +00:00

command_canonicalization_tests.rs

fix: move inline codex-rs/core unit tests into sibling files (#14444)

2026-03-12 08:16:36 -07:00

command_canonicalization.rs

core: remove cross-crate re-exports from lib.rs (#16512)

2026-04-01 23:06:24 -07:00

compact_model_fallback.rs

Broaden compaction fallback to the current model (#46324)

2026-09-17 23:54:31 +00:00

compact_remote_history_tests.rs

Remove the unused legacy remote compaction implementation (#44273)

2026-09-09 18:40:53 +00:00

compact_remote_history.rs

Remove the unused legacy remote compaction implementation (#44273)

2026-09-09 18:40:53 +00:00

compact_remote_v2_attempt.rs

Include Code Mode tool metadata in compaction prompts (#46044)

2026-09-16 22:26:40 +00:00

compact_remote_v2_image_budget_tests.rs

Account for file images in context budgets and Guardian reviews (#46072)

2026-09-17 01:38:13 +00:00

compact_remote_v2_images.rs

Account for file images in context budgets and Guardian reviews (#46072)

2026-09-17 01:38:13 +00:00

compact_remote_v2.rs

Add opt-in compaction after final responses (#46541)

2026-09-19 00:52:56 +00:00

compact_tests.rs

Include Code Mode tool metadata in compaction prompts (#46044)

2026-09-16 22:26:40 +00:00

compact_token_budget.rs

Preserve root turn attribution in turn-start events (#44611)

2026-09-10 18:24:13 +00:00

compact.rs

Track cumulative MCP attribution across requests and thread history (#47081)

2026-09-21 18:19:07 +00:00

connectors_tests.rs

Honor app link settings for MCP tool approvals (#42056)

2026-09-01 13:43:27 +00:00

connectors.rs

Allow subagents to request MCP elicitation input (#46877)

2026-09-20 19:42:18 +00:00

current_time.rs

[codex] route sleep through time providers (#29973)

2026-06-24 22:17:43 -07:00

cyber_access_program.rs

Add per-turn cyber access program selection (#40687)

2026-08-25 19:54:52 +00:00

elicitation_tests.rs

elicitations: Move to shared ElicitationService (#30627)

2026-07-06 11:20:32 -07:00

elicitation.rs

elicitations: Move to shared ElicitationService (#30627)

2026-07-06 11:20:32 -07:00

environment_selection_snapshot_tests.rs

Serialize environment updates and cancel removed pending attachments (#47077)

2026-09-21 17:53:03 +00:00

environment_selection.rs

Serialize environment updates and cancel removed pending attachments (#47077)

2026-09-21 17:53:03 +00:00

event_mapping_tests.rs

Support image references by file ID in inputs and tool outputs (#45794)

2026-09-15 21:19:08 +00:00

event_mapping.rs

Support image references by file ID in inputs and tool outputs (#45794)

2026-09-15 21:19:08 +00:00

exec_env_tests.rs

Add a feature flag to preserve apply_patch line endings (#37758)

2026-08-10 01:44:30 +00:00

exec_env.rs

Expose the Codex version to commands and turn metadata (#42395)

2026-09-03 00:17:19 +00:00

exec_policy_tests.rs

Remove selected core test cases (#42066)

2026-09-01 14:43:27 +00:00

exec_policy_windows_tests.rs

Retire the untrusted approval policy (#39630)

2026-08-20 07:03:02 +00:00

exec_policy.rs

Apply remote platform semantics to exec safety checks (#42113)

2026-09-01 18:24:56 +00:00

exec_tests.rs

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

exec.rs

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

feedback_config_tests.rs

Add configuration and feature diagnostics to report metadata (#46501)

2026-09-18 23:07:36 +00:00

feedback_config.rs

Add configuration and feature diagnostics to report metadata (#46501)

2026-09-18 23:07:36 +00:00

function_tool.rs

feat: extract shared tool executor interface (#22359)

2026-05-13 11:31:27 +02:00

git_info_tests.rs

Sanitize credentials from Git remote metadata (#40713)

2026-08-25 21:34:05 +00:00

guardian_review.rs

Move Guardian reviewer lifecycle into the extension (#45537)

2026-09-14 22:58:51 +00:00

hook_mcp_executor.rs

Preserve executor context for MCP stop hooks (#40012)

2026-08-21 21:17:42 +00:00

hook_runtime.rs

Preserve originating turn metadata for yielded skill calls (#47106)

2026-09-21 20:34:46 +00:00

image_preparation_tests.rs

Pass thread IDs to attachment uploads (#47121)

2026-09-21 22:58:49 +00:00

image_preparation.rs

Pass thread IDs to attachment uploads (#47121)

2026-09-21 22:58:49 +00:00

installation_id.rs

feat: split memories part 2 (#19860)

2026-04-28 13:03:28 +02:00

lib.rs

Wire agent message boards into persistent multi-agent runtimes (#47017)

2026-09-21 12:35:36 +00:00

mcp_openai_file.rs

Keep step settings and approval environments consistent (#46556)

2026-09-19 01:27:26 +00:00

mcp_skill_dependencies.rs

Add trusted enterprise MCP auth configuration (#44832)

2026-09-11 14:25:56 +00:00

mcp_tool_approval_templates.rs

Organize bundled Rust resources under asset directories (#41477)

2026-08-29 06:05:28 +00:00

mcp_tool_call_tests.rs

Allow subagents to request MCP elicitation input (#46877)

2026-09-20 19:42:18 +00:00

mcp_tool_call.rs

Preserve originating turn metadata for yielded skill calls (#47106)

2026-09-21 20:34:46 +00:00

mcp_tool_exposure_test.rs

Reuse MCP handlers across sampling steps (#37273)

2026-08-06 13:37:07 +00:00

mcp_tool_exposure.rs

Honor app link settings for MCP tool approvals (#42056)

2026-09-01 13:43:27 +00:00

mcp.rs

Add turn-start cloud plugin discovery to the MCP extension (#46572)

2026-09-19 02:07:58 +00:00

memory_usage.rs

Tag memory usage telemetry with the memory version (#45960)

2026-09-16 15:17:41 +00:00

mention_syntax.rs

Extract codex-utils-plugins crate (#15746)

2026-03-25 11:05:35 -07:00

network_policy_decision_tests.rs

fix: attribut network requests to the exact exec on linux (#29697)

2026-07-06 14:51:34 -07:00

network_policy_decision.rs

refactor(proxy): clarify sandbox block messages (#17168)

2026-04-09 10:53:06 -07:00

original_image_detail.rs

Remove js_repl feature (#19410)

2026-04-24 17:49:29 -07:00

otel_init.rs

Prepare the telemetry shutdown worker during initialization (#39050)

2026-08-17 19:06:53 +00:00

prompt_debug.rs

Use the originating model when recording conversation history (#44243)

2026-09-09 17:46:00 +00:00

realtime_context_tests.rs

Persist Daybreak preferences in thread metadata (#42854)

2026-09-04 21:17:25 +00:00

realtime_context.rs

Add experimental app-server project APIs (#38940)

2026-08-17 04:01:37 +00:00

realtime_conversation_tests.rs

Reconnect WebRTC Realtime sideband transports (#39257)

2026-08-18 18:41:40 +00:00

realtime_conversation.rs

Honor configured proxies for realtime WebSocket connections (#47101)

2026-09-21 20:05:21 +00:00

realtime_history_tests.rs

Preserve MCP App UI metadata in tool-call events and history (#45805)

2026-09-15 22:52:56 +00:00

realtime_history.rs

Record realtime conversation history in Core (#41924)

2026-08-31 22:38:23 +00:00

realtime_prompt.rs

[codex] Consolidate shared prompts in codex-prompts (#25151)

2026-06-01 18:45:07 +00:00

responses_headers.rs

Route Guardian requests through /responses with identifying headers (#45736)

2026-09-15 17:09:11 +00:00

responses_metadata.rs

Track cumulative MCP attribution across requests and thread history (#47081)

2026-09-21 18:19:07 +00:00

responses_retry_tests.rs

Separate Codex error details from retry metadata (#34996)

2026-07-23 19:32:26 +00:00

responses_retry.rs

Centralize retry decisions and delays in CodexErr (#46540)

2026-09-19 00:46:30 +00:00

rollout_budget.rs

Expose a backend-independent agent control contract (#46547)

2026-09-19 01:03:55 +00:00

rollout.rs

Honor the configured SQLite home across state consumers (#34994)

2026-07-23 19:19:35 +00:00

safety_tests.rs

Authorize apply_patch in the executor path context (#42391)

2026-09-02 23:58:24 +00:00

safety.rs

Authorize apply_patch in the executor path context (#42391)

2026-09-02 23:58:24 +00:00

sandbox_tags_tests.rs

Report configured sandbox policy consistently (#41933)

2026-08-31 23:29:20 +00:00

sandbox_tags.rs

Enable MXC selection through Windows sandbox configuration (#46271)

2026-09-17 18:20:28 +00:00

session_prefix_tests.rs

core: surface terminal subagent errors to parent agents (#28375)

2026-06-16 14:34:54 +02:00

session_prefix.rs

Classify additional generated context fragments (#40275)

2026-08-23 20:08:40 +00:00

session_rollout_init_error.rs

Preserve sandbox errors during session initialization (#40381)

2026-08-24 10:56:54 +00:00

session_startup_prewarm.rs

Move Guardian reviewer lifecycle into the extension (#45537)

2026-09-14 22:58:51 +00:00

shell_snapshot_sandbox_tests.rs

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

shell_snapshot_sandbox.rs

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

shell_snapshot_tests.rs

Split shell snapshot credential tests into focused cases (#46715)

2026-09-19 20:41:55 +00:00

shell_snapshot.rs

Support configured credential providers across shell snapshots (#44072)

2026-09-09 06:04:59 +00:00

shell_tests.rs

Resolve model-provided shells by type (#39607)

2026-08-20 06:03:25 +00:00

shell.rs

Resolve model-provided shells by type (#39607)

2026-08-20 06:03:25 +00:00

skills.rs

Preserve originating turn metadata for yielded skill calls (#47106)

2026-09-21 20:34:46 +00:00

spawn.rs

Support sandboxed file streaming in exec-server (#38356)

2026-08-13 11:11:26 +00:00

state_db_bridge.rs

state: pass state db handles through consumers (#20561)

2026-05-04 11:46:03 -07:00

stream_events_utils_tests.rs

Bind direct tool-call metadata to invocation outputs (#45185)

2026-09-13 06:53:20 +00:00

stream_events_utils.rs

Bind direct tool-call metadata to invocation outputs (#45185)

2026-09-13 06:53:20 +00:00

test_support.rs

Track cumulative MCP attribution across requests and thread history (#47081)

2026-09-21 18:19:07 +00:00

thread_manager_tests.rs

Preserve originating turn metadata for yielded skill calls (#47106)

2026-09-21 20:34:46 +00:00

thread_manager.rs

Delete persisted message boards with their root threads (#47029)

2026-09-21 13:28:02 +00:00

thread_rollout_truncation_tests.rs

Preserve root turn attribution in turn-start events (#44611)

2026-09-10 18:24:13 +00:00

thread_rollout_truncation.rs

Capture Guardian review checkpoints from live context (#46512)

2026-09-18 23:37:35 +00:00

thread_startup_metadata.rs

Separate thread startup metadata from replay history (#46294)

2026-09-17 19:55:20 +00:00

turn_diff_tracker_tests.rs

Render turn diffs for foreign environment paths (#34654)

2026-07-22 02:19:45 +00:00

turn_diff_tracker.rs

Render turn diffs for foreign environment paths (#34654)

2026-07-22 02:19:45 +00:00

turn_metadata_tests.rs

Track cumulative MCP attribution across requests and thread history (#47081)

2026-09-21 18:19:07 +00:00

turn_metadata.rs

Enable MXC selection through Windows sandbox configuration (#46271)

2026-09-17 18:20:28 +00:00

turn_timing_tests.rs

Replace Guardian tickets with parent response IDs (#43002)

2026-09-05 13:02:49 +00:00

turn_timing.rs

Propagate response tickets to Guardian reviews (#42758)

2026-09-04 12:56:26 +00:00

user_shell_command_tests.rs

Organize context fragments (#18794)

2026-04-20 22:39:17 -07:00

user_shell_command.rs

Snapshot resolved settings for each model step (#40651)

2026-08-25 17:41:22 +00:00

util_tests.rs

Trim TUI legacy core helper usage (#22695)

2026-05-14 16:54:59 -07:00

util.rs

Move retry backoff into codex-async-utils (#46330)

2026-09-18 00:25:37 +00:00

web_search.rs

Remove unused Rust helpers (#34345)

2026-07-20 13:45:29 +00:00

windows_sandbox_read_grants_tests.rs

windows-sandbox: pass workspace roots to runner (#24108)

2026-05-28 15:26:55 -07:00

windows_sandbox_read_grants.rs

windows-sandbox: pass workspace roots to runner (#24108)

2026-05-28 15:26:55 -07:00

windows_sandbox_tests.rs

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

windows_sandbox.rs

Always use private desktops for legacy Windows sandboxes (#46554)

2026-09-19 01:21:32 +00:00

windows_system_config.rs

Add telemetry for the Windows system config namespace (#44284)

2026-09-09 19:31:12 +00:00

worktree_trust_tests.rs

Validate linked worktrees before inheriting project trust (#39616)

2026-08-20 06:29:32 +00:00