codex

mirror of https://github.com/openai/codex.git synced 2026-10-21 17:48:44 +00:00

Files

T

Rohan Mehta ab6095dde0 Allow callers to control prompt cache keys independently of session IDs (#55587 )

## What changed

Expose `PromptCacheKey` through `StartThreadOptions` with three policies: retain the default session-derived key, send a custom key, or omit `prompt_cache_key` from model requests. Keep session identity headers independent of this policy.

Propagate the policy to child agents, delegated sessions, and guardian review sessions. Hosts must reapply the policy when resuming a thread from storage.

## Testing

Add coverage for all three policies across turns, including unchanged session and thread headers. Extend subagent coverage to verify inheritance of the default and omitted-key policies.

GitOrigin-RevId: f9e8ab31fcf568636f9712726760e4e9a4672428

2026-10-20 14:14:59 +00:00

agent

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

apps

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +00:00

config

Preserve parent history by default in full agent forks (#55548 )

2026-10-20 11:56:17 +00:00

context

Support catalog templates for approved command prefixes (#55366 )

2026-10-19 19:55:39 +00:00

context_manager

Share additional tool declarations across response item clones (#54945 )

2026-10-17 23:17:51 +00:00

exec_policy

Avoid false URL-launch detections in literal PowerShell commands (#54076 )

2026-10-14 19:47:50 +00:00

guardian

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

mcp_tool_call

Preserve specific MCP failure codes in metrics and spans (#54094 )

2026-10-14 20:53:59 +00:00

plugins

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +00:00

realtime_conversation

Expose and persist turn lineage across the app server (#51415 )

2026-10-06 16:56:39 +00:00

realtime_history

Record realtime conversation history in Core (#41924 )

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

sandboxing

Run sandbox integrity checks before commands and filesystem operations (#51843 )

2026-10-07 21:52:43 +00:00

session

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

state

Add infrastructure for speculative remote V2 compaction (#53614 )

2026-10-13 08:44:23 +00:00

tasks

Allow agent messages to wake idle root sessions behind a feature flag (#54961 )

2026-10-18 01:58:02 +00:00

thread_manager

Distinguish retryable thread-store errors from unknown write outcomes (#54664 )

2026-10-16 17:31:47 +00:00

tools

Add configured thread environment inheritance for subagents (#55375 )

2026-10-19 20:30:44 +00:00

unified_exec

Allow stdin review under active grants with sandbox prompts disabled (#54119 )

2026-10-14 23:02:21 +00:00

utils

…

agent_communication.rs

Preserve queued agent mail across session eviction (#50087 )

2026-10-01 20:17:34 +00:00

agent_message_board.rs

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +00:00

agents_md_manager.rs

Roll back stale Guardian reviews before reusing reviewer history (#51683 )

2026-10-07 13:05:06 +00:00

agents_md_tests.rs

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +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

Fix macOS system-alias matching in patch permission checks (#47879 )

2026-09-24 16:36:57 +00:00

apply_patch.rs

Fix macOS system-alias matching in patch permission checks (#47879 )

2026-09-24 16:36:57 +00:00

attestation.rs

…

client_common_tests.rs

Add opt-in output token replay for OpenAI requests (#52742 )

2026-10-10 01:25:00 +00:00

client_common.rs

Interrupt and drain canceled classifier responses before socket reuse (#53698 )

2026-10-13 15:24:00 +00:00

client_tests.rs

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

client_tool_metadata_tests.rs

Send base instructions as Responses input messages (#51156 )

2026-10-05 18:52:51 +00:00

client_tool_metadata.rs

Bound tool-call observations to the outgoing Responses message budget (#47957 )

2026-09-24 22:54:29 +00:00

client.rs

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

code_mode_host_tests.rs

Verify reset notification during code-mode host recovery (#52952 )

2026-10-10 18:26:18 +00:00

code_mode_host.rs

Add opt-in gRPC over stdio for the code-mode host (#52723 )

2026-10-09 23:26:34 +00:00

codex_delegate_tests.rs

Add opt-in output token replay for OpenAI requests (#52742 )

2026-10-10 01:25:00 +00:00

codex_delegate.rs

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

codex_thread.rs

Use thread connections for enterprise MCP status listings (#55394 )

2026-10-19 22:02:44 +00:00

command_canonicalization_tests.rs

…

command_canonicalization.rs

…

compact_model_fallback.rs

Treat incomplete responses as terminal errors (#53451 )

2026-10-12 18:53:49 +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

Prepare compaction helpers for background requests (#53606 )

2026-10-13 08:13:34 +00:00

compact_remote_v2_attempt.rs

Reuse background results for remote V2 compaction (#53620 )

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

compact_remote_v2_image_budget_tests.rs

Add opt-in output token replay for OpenAI requests (#52742 )

2026-10-10 01:25:00 +00:00

compact_remote_v2_images.rs

Add opt-in output token replay for OpenAI requests (#52742 )

2026-10-10 01:25:00 +00:00

compact_remote_v2_installation_tests.rs

Wire background compaction into the turn lifecycle (#53800 )

2026-10-13 23:51:47 +00:00

compact_remote_v2_installation.rs

Wire background compaction into the turn lifecycle (#53800 )

2026-10-13 23:51:47 +00:00

compact_remote_v2.rs

Wire background compaction into the turn lifecycle (#53800 )

2026-10-13 23:51:47 +00:00

compact_retained_tool_outputs.rs

Retain client-marked tool outputs across compaction (#52937 )

2026-10-10 17:30:25 +00:00

compact_tests.rs

Refresh model instructions in incremental-tool context windows (#53872 )

2026-10-14 05:36:44 +00:00

compact_token_budget.rs

Install full context in compaction replacement history (#51117 )

2026-10-05 16:10:27 +00:00

compact.rs

Remove the long-thread accuracy warning after compaction (#55355 )

2026-10-19 19:24:26 +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 exec-server to proxy permitted private IPs upstream (#48568 )

2026-09-26 23:17:41 +00:00

current_time.rs

…

cyber_access_program.rs

Forward per-turn Cyber access programs to Guardian (#52689 )

2026-10-09 20:14:04 +00:00

elicitation_tests.rs

…

elicitation.rs

…

environment_connection_tests.rs

Defer environment disconnect notifications until recovery fails (#55401 )

2026-10-19 22:55:42 +00:00

environment_selection_snapshot_tests.rs

Add configured thread environment inheritance for subagents (#55375 )

2026-10-19 20:30:44 +00:00

environment_selection.rs

Defer environment disconnect notifications until recovery fails (#55401 )

2026-10-19 22:55:42 +00:00

event_mapping_tests.rs

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +00:00

event_mapping.rs

Track content provenance through prompt assembly and compaction (#53831 )

2026-10-14 02:01:49 +00:00

exec_env_tests.rs

Make apply_patch preserve line endings unconditionally (#51203 )

2026-10-05 23:52:06 +00:00

exec_env.rs

Expose originating tool call metadata in command environments (#52119 )

2026-10-08 13:45:19 +00:00

exec_policy_tests.rs

Avoid false URL-launch detections in literal PowerShell commands (#54076 )

2026-10-14 19:47:50 +00:00

exec_policy_windows_tests.rs

Avoid false URL-launch detections in literal PowerShell commands (#54076 )

2026-10-14 19:47:50 +00:00

exec_policy.rs

Avoid false URL-launch detections in literal PowerShell commands (#54076 )

2026-10-14 19:47:50 +00:00

exec_tests.rs

Wait for readiness in the SIGTERM cancellation test (#54099 )

2026-10-14 21:11:58 +00:00

exec.rs

Run sandbox integrity checks before commands and filesystem operations (#51843 )

2026-10-07 21:52:43 +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

Complete dynamic tool lifecycles on cancellation (#51556 )

2026-10-07 03:07:51 +00:00

git_info_tests.rs

Use descriptor-safe helpers for executable test fixtures (#50018 )

2026-10-01 15:57:03 +00:00

guardian_review.rs

Add opt-in conversation history retrieval to Guardian reviews (#49036 )

2026-09-28 17:29:52 +00:00

hook_mcp_executor.rs

Start dormant MCP servers for hook calls (#55263 )

2026-10-19 11:40:15 +00:00

hook_runtime.rs

Add observation-only model request lifecycle hooks (#55144 )

2026-10-18 22:43:56 +00:00

image_preparation_tests.rs

Track content provenance through prompt assembly and compaction (#53831 )

2026-10-14 02:01:49 +00:00

image_preparation.rs

Store generated image items as attachment references (#54398 )

2026-10-15 19:51:22 +00:00

installation_id.rs

…

lib.rs

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

mcp_openai_file.rs

Bind permission grants to the originating turn (#49880 )

2026-10-01 05:33:36 +00:00

mcp_skill_dependencies.rs

Add configurable default plugin activation policy (#52220 )

2026-10-08 18:42:58 +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

Distinguish MCP approval cancellation reasons (#54679 )

2026-10-16 19:08:19 +00:00

mcp_tool_call.rs

Distinguish MCP approval cancellation reasons (#54679 )

2026-10-16 19:08:19 +00:00

mcp_tool_exposure_test.rs

…

mcp_tool_exposure.rs

Reuse MCP handler metadata for cache comparisons (#51755 )

2026-10-07 16:35:05 +00:00

mcp.rs

Add optional MCP disablement for prediction forks and samples (#55463 )

2026-10-20 05:25:43 +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

…

model_request_tests.rs

Preserve WebSocket continuations when steering a turn (#48508 )

2026-09-26 18:36:55 +00:00

model_request.rs

Add extension hooks for model requests and response streams (#47679 )

2026-09-23 22:10:04 +00:00

network_policy_decision_tests.rs

…

network_policy_decision.rs

…

original_image_detail.rs

…

otel_init.rs

Honor custom OTLP metrics exporters when analytics is disabled (#52278 )

2026-10-08 21:18:24 +00:00

prompt_debug.rs

Preserve tool declaration mode across resumed context windows (#51480 )

2026-10-06 21:28:13 +00:00

realtime_context_tests.rs

Add opt-in output token replay for OpenAI requests (#52742 )

2026-10-10 01:25:00 +00:00

realtime_context.rs

…

realtime_conversation_tests.rs

Forward client voice session IDs in realtime requests (#53784 )

2026-10-13 22:21:31 +00:00

realtime_conversation.rs

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +00:00

realtime_history_tests.rs

Record resolved model and reasoning effort in sub-agent activity (#51463 )

2026-10-06 19:29:40 +00:00

realtime_history.rs

Record realtime conversation history in Core (#41924 )

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

realtime_prompt.rs

…

responses_headers.rs

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

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

responses_metadata.rs

Track history initialization in Responses turn metadata (#52325 )

2026-10-08 23:34:16 +00:00

responses_retry_tests.rs

Move content-filter guidance into the shared Responses retry handler (#49130 )

2026-09-29 02:05:56 +00:00

responses_retry.rs

Honor server retry advice across Responses retries and fallback (#49441 )

2026-09-30 02:12:42 +00:00

rollout_budget.rs

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

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

rollout.rs

…

safety_tests.rs

Fix macOS system-alias matching in patch permission checks (#47879 )

2026-09-24 16:36:57 +00:00

safety.rs

Fix macOS system-alias matching in patch permission checks (#47879 )

2026-09-24 16:36:57 +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

Notify parent agents when Guardian stops a subagent (#49312 )

2026-09-29 16:53:11 +00:00

session_prefix.rs

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +00:00

session_rollout_init_error_tests.rs

Distinguish retryable thread-store errors from unknown write outcomes (#54664 )

2026-10-16 17:31:47 +00:00

session_rollout_init_error.rs

Distinguish retryable thread-store errors from unknown write outcomes (#54664 )

2026-10-16 17:31:47 +00:00

shell_snapshot_sandbox_tests.rs

Preserve sandbox overrides across execution requests (#51786 )

2026-10-07 17:59:22 +00:00

shell_snapshot_sandbox.rs

Run sandbox integrity checks before commands and filesystem operations (#51843 )

2026-10-07 21:52:43 +00:00

shell_snapshot_tests.rs

Add opt-in credential masking for proxied sandboxed sessions (#52302 )

2026-10-08 22:27:00 +00:00

shell_snapshot.rs

Expose originating tool call metadata in command environments (#52119 )

2026-10-08 13:45:19 +00:00

shell_tests.rs

Restore executor tool paths after login shell startup (#49467 )

2026-09-30 03:22:55 +00:00

shell.rs

Restore executor tool paths after login shell startup (#49467 )

2026-09-30 03:22:55 +00:00

skills.rs

Integrate discovery V2 with step-scoped skill catalogs (#55322 )

2026-10-19 17:02:20 +00:00

spawn.rs

Remove the patched zsh shell execution backend (#52160 )

2026-10-08 16:19:09 +00:00

state_db_bridge.rs

…

stream_events_utils_tests.rs

Add observation-only model request lifecycle hooks (#55144 )

2026-10-18 22:43:56 +00:00

stream_events_utils.rs

Add observation-only model request lifecycle hooks (#55144 )

2026-10-18 22:43:56 +00:00

test_support.rs

Default local threads to paginated history (#47900 )

2026-09-24 18:07:37 +00:00

thread_manager_tests.rs

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

thread_manager.rs

Allow callers to control prompt cache keys independently of session IDs (#55587 )

2026-10-20 14:14:59 +00:00

thread_rollout_truncation_tests.rs

Add opt-in output token replay for OpenAI requests (#52742 )

2026-10-10 01:25:00 +00:00

thread_rollout_truncation.rs

Remove partial-history subagent forks (#51329 )

2026-10-06 10:39:16 +00:00

thread_spawn.rs

Add configured thread environment inheritance for subagents (#55375 )

2026-10-19 20:30:44 +00:00

thread_startup_metadata.rs

Remove initial messages from session configuration events (#50360 )

2026-10-02 16:55:41 +00:00

turn_diff_tracker_tests.rs

…

turn_diff_tracker.rs

…

turn_extension_data.rs

Capture host-supplied extension data for each turn (#49846 )

2026-10-01 03:31:48 +00:00

turn_metadata_tests.rs

Forward turn metadata to image generation and edit requests (#54058 )

2026-10-14 18:01:54 +00:00

turn_metadata.rs

Forward turn metadata to image generation and edit requests (#54058 )

2026-10-14 18:01:54 +00:00

turn_timing_tests.rs

Add opt-in output token replay for OpenAI requests (#52742 )

2026-10-10 01:25:00 +00:00

turn_timing.rs

Track inference tool changes in turn analytics (#50964 )

2026-10-04 21:19:05 +00:00

user_shell_command_tests.rs

…

user_shell_command.rs

Support typed content in contextual prompt fragments (#54776 )

2026-10-17 04:02:21 +00:00

util_tests.rs

…

util.rs

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

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

web_search.rs

…

windows_sandbox_read_grants_tests.rs

…

windows_sandbox_read_grants.rs

…

windows_sandbox_tests.rs

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

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

windows_sandbox.rs

Log Windows sandbox availability and backend selection (#51974 )

2026-10-08 06:31:56 +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

Add portable project trust lookup APIs (#47620 )

2026-09-23 18:40:12 +00:00