jif-oai 1c55bb2702 [codex] Improve built-in tool schema docs (#24794) ...

## Summary
- Clarify default, omission, and bounded behavior across built-in tool
schemas, including unified exec, classic shell, Code Mode exec/wait,
multi-agent, agent job, MCP resource, image, goal, plan, tool_search,
and test-sync fields.
- Convert update_plan status to an enum and add short field descriptions
where the schema previously relied on surrounding context.
- Remove the dedicated permission-approval schema test and keep only
updates to existing expected-spec tests.

## Validation
- Ran `just fmt`.
- Ran `git diff --check`.
- Did not run clippy or tests, per request.

Regression has been eval
[here](https://openai.slack.com/archives/C09GDSP1J9X/p1779905065496949)
and we proved there are no regressions

1c55bb2702 · 2026-05-29 13:32:19 +02:00

History

..

agent

[codex] Add user input client ids (#24653)

2026-05-28 14:54:39 -07:00

apps

Split DeveloperInstructions into individual fragments. (#18813)

2026-04-21 10:22:36 -07:00

bin

Refactor config types into a separate crate (#16962)

2026-04-07 00:32:41 +00:00

config

fix(config): use deny for Unix socket permissions (#24970)

2026-05-28 23:53:26 +00:00

context

Use internal model context fragments for goal steering (#24918)

2026-05-29 10:28:25 +02:00

context_manager

Surface filesystem permission profiles in prompt context (#23924)

2026-05-28 14:56:53 -07:00

guardian

Surface filesystem permission profiles in prompt context (#23924)

2026-05-28 14:56:53 -07:00

plugins

[codex] Remove string-keyed MCP tool maps (#21454)

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

sandboxing

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

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

session

Use internal model context fragments for goal steering (#24918)

2026-05-29 10:28:25 +02:00

state

Add experimental turn additional context (#24154)

2026-05-26 13:02:34 -07:00

tasks

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

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

tools

[codex] Improve built-in tool schema docs (#24794)

2026-05-29 13:32:19 +02:00

unified_exec

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

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

utils

Extract rollout into its own crate (#15548)

2026-03-24 18:10:53 -07:00

agents_md_tests.rs

Warn on invalid UTF-8 in AGENTS.md files (#23232)

2026-05-19 21:56:46 -07:00

agents_md.rs

Warn on invalid UTF-8 in AGENTS.md files (#23232)

2026-05-19 21:56:46 -07:00

apply_patch_tests.rs

[codex] Migrate apply_patch to executor filesystem (#17027)

2026-04-07 21:20:22 +00:00

apply_patch.rs

Support multi-environment apply_patch selection (#21617)

2026-05-11 16:33:44 -07:00

attestation.rs

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

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

client_common_tests.rs

[codex] Remove legacy shell output formatting paths (#22706)

2026-05-18 09:57:54 -07:00

client_common.rs

[codex] Remove legacy shell output formatting paths (#22706)

2026-05-18 09:57:54 -07:00

client_tests.rs

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

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

client.rs

Stabilize Guardian client cache key handling (#24891)

2026-05-28 12:36:01 +02:00

codex_delegate_tests.rs

[codex] Add user input client ids (#24653)

2026-05-28 14:54:39 -07:00

codex_delegate.rs

[codex] Add user input client ids (#24653)

2026-05-28 14:54:39 -07:00

codex_thread.rs

Use inject_if_running for active goal steering (#24924)

2026-05-29 11:24:39 +02: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_remote_v2.rs

[codex] add compaction metadata to turn headers (#24368)

2026-05-27 11:09:33 -07:00

compact_remote.rs

[codex] add compaction metadata to turn headers (#24368)

2026-05-27 11:09:33 -07:00

compact_tests.rs

[codex] Filter legacy warning messages during compaction (#22243)

2026-05-11 19:51:51 -07:00

compact.rs

[codex] Store pending response items directly (#24865)

2026-05-28 07:23:08 -07:00

config_lock.rs

feat: add layered --profile-v2 config files (#17141)

2026-05-14 15:16:15 +02:00

connectors_tests.rs

Update rmcp to 1.7.0 (#24763)

2026-05-27 14:52:06 -07:00

connectors.rs

Move MCP tool naming mode into manager (#21576)

2026-05-26 08:21:15 -07:00

consequential_tool_message_templates.json

[elicitation] User-friendly tool call messages. (#14403)

2026-03-12 00:35:21 -07:00

environment_selection.rs

Make local environment optional in EnvironmentManager (#23369)

2026-05-19 12:55:34 -07:00

event_mapping_tests.rs

Use internal model context fragments for goal steering (#24918)

2026-05-29 10:28:25 +02:00

event_mapping.rs

Preserve image detail in app-server inputs (#20693)

2026-05-15 15:04:04 -07:00

exec_env_tests.rs

[codex] Move config loading into codex-config (#19487)

2026-04-26 15:10:53 -07:00

exec_env.rs

[codex] Move config loading into codex-config (#19487)

2026-04-26 15:10:53 -07:00

exec_policy_tests.rs

test: construct permission profiles directly (#23030)

2026-05-16 12:12:37 -07:00

exec_policy_windows_tests.rs

test: construct permission profiles directly (#23030)

2026-05-16 12:12:37 -07:00

exec_policy.rs

fix(exec-policy) use is_known_safe_command less (#20305)

2026-05-11 11:37:53 -07:00

exec_tests.rs

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

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

exec.rs

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

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

function_tool.rs

feat: extract shared tool executor interface (#22359)

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

git_info_tests.rs

Fix remote turn diff display roots (#23261)

2026-05-18 10:53:49 -07:00

goals.rs

Use internal model context fragments for goal steering (#24918)

2026-05-29 10:28:25 +02:00

hook_runtime.rs

[codex] Add user input client ids (#24653)

2026-05-28 14:54:39 -07:00

installation_id.rs

feat: split memories part 2 (#19860)

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

landlock.rs

linux-sandbox: switch helper plumbing to PermissionProfile (#20106)

2026-04-28 19:43:44 -07:00

lib.rs

centralize Responses retry policy (#24131)

2026-05-26 11:01:18 +02:00

mcp_openai_file.rs

Deprecate TurnContext cwd and resolve_path (#22519)

2026-05-13 11:15:25 -07:00

mcp_skill_dependencies.rs

Route MCP servers through explicit environments (#23583)

2026-05-21 17:19:54 +02:00

mcp_tool_approval_templates.rs

Uprev Rust toolchain pins to 1.95.0 (#24684)

2026-05-26 20:59:47 -07:00

mcp_tool_call_tests.rs

Update rmcp to 1.7.0 (#24763)

2026-05-27 14:52:06 -07:00

mcp_tool_call.rs

Move MCP tool naming mode into manager (#21576)

2026-05-26 08:21:15 -07:00

mcp_tool_exposure_test.rs

[codex] Support ui visibility meta for tools (#24700)

2026-05-28 10:24:03 -07:00

mcp_tool_exposure.rs

[codex] Support ui visibility meta for tools (#24700)

2026-05-28 10:24:03 -07:00

mcp.rs

feat: make built-in MCPs first-class runtime servers (#21356)

2026-05-07 10:36:32 +02:00

memory_usage.rs

Remove ToolsConfig from tool planning (#22835)

2026-05-19 11:24:09 +02:00

mention_syntax.rs

Extract codex-utils-plugins crate (#15746)

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

network_policy_decision_tests.rs

extract models manager and related ownership from core (#16508)

2026-04-02 23:00:02 -07:00

network_policy_decision.rs

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

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

network_proxy_loader_tests.rs

Use named MITM permissions config (#18240)

2026-05-20 17:10:37 -07:00

network_proxy_loader.rs

Use named MITM permissions config (#18240)

2026-05-20 17:10:37 -07:00

original_image_detail.rs

Remove js_repl feature (#19410)

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

otel_init.rs

Add process-scoped SQLite telemetry (#22154)

2026-05-11 11:32:40 -07:00

personality_migration_tests.rs

[codex] Add user input client ids (#24653)

2026-05-28 14:54:39 -07:00

personality_migration.rs

chore: stop consuming legacy config profiles (#24076)

2026-05-26 10:34:43 +02:00

prompt_debug.rs

Make local environment optional in EnvironmentManager (#23369)

2026-05-19 12:55:34 -07:00

realtime_context_tests.rs

[codex-analytics] rework thread_source for thread analytics (#20949)

2026-05-06 02:12:31 +00:00

realtime_context.rs

[codex] Route live thread writes through ThreadStore (#18882)

2026-04-23 10:17:09 -07:00

realtime_conversation_tests.rs

[codex] Fix realtime v1 websocket compatibility (#23771)

2026-05-20 16:03:51 -07:00

realtime_conversation.rs

[codex] Fix realtime v1 websocket compatibility (#23771)

2026-05-20 16:03:51 -07:00

realtime_prompt.rs

[codex] Update realtime V2 VAD silence delay and 1.5 prompt (#18092)

2026-04-16 14:30:57 -07:00

responses_retry.rs

centralize Responses retry policy (#24131)

2026-05-26 11:01:18 +02:00

review_format.rs

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

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

review_prompts.rs

Spread AbsolutePathBuf (#17792)

2026-04-14 14:26:10 -07:00

rollout.rs

codex: use ThreadStore history for core review forks (#20577)

2026-05-05 15:25:19 -07:00

safety_tests.rs

Make deny canonical for filesystem permission entries (#23493)

2026-05-19 11:03:47 -07:00

safety.rs

Make turn diff tracking operation backed (#21180)

2026-05-07 11:33:47 +02:00

sandbox_tags_tests.rs

telemetry: tag sandboxes from permission profiles (#22791)

2026-05-15 10:58:50 -07:00

sandbox_tags.rs

telemetry: tag sandboxes from permission profiles (#22791)

2026-05-15 10:58:50 -07:00

session_prefix.rs

Organize context fragments (#18794)

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

session_rollout_init_error.rs

remove temporary ownership re-exports (#16626)

2026-04-03 00:33:34 -07:00

session_startup_prewarm.rs

[codex] add compaction metadata to turn headers (#24368)

2026-05-27 11:09:33 -07:00

shell_detect.rs

…

shell_snapshot_tests.rs

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

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

shell_snapshot.rs

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

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

shell_tests.rs

chore: clean up argument-comment lint and roll out all-target CI on macOS (#16054)

2026-03-27 19:00:44 -07:00

shell.rs

fix: add shell fallback paths for pwsh/powershell that work on GitHub Actions Windows runners (#16617)

2026-04-02 13:47:10 -07:00

skills.rs

cleanup: Remove skill env var dependency prompting (#22721)

2026-05-19 01:24:19 +00:00

spawn.rs

Spread AbsolutePathBuf (#17792)

2026-04-14 14:26:10 -07: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

feat: async turn item process (#23692)

2026-05-20 15:30:01 +02:00

stream_events_utils.rs

Move memory state to a dedicated SQLite DB (#24591)

2026-05-26 20:07:25 +02:00

test_support.rs

Uprev Rust toolchain pins to 1.95.0 (#24684)

2026-05-26 20:59:47 -07:00

thread_manager_tests.rs

[codex] Add user input client ids (#24653)

2026-05-28 14:54:39 -07:00

thread_manager.rs

[codex] Store pending response items directly (#24865)

2026-05-28 07:23:08 -07:00

thread_rollout_truncation_tests.rs

Drop startup context when truncating forked rollouts (#24751)

2026-05-27 15:49:08 +02:00

thread_rollout_truncation.rs

Drop startup context when truncating forked rollouts (#24751)

2026-05-27 15:49:08 +02:00

turn_diff_tracker_tests.rs

fix: preserve exact turn diffs after partial apply_patch failures (#21518)

2026-05-07 18:05:45 +02:00

turn_diff_tracker.rs

fix: preserve exact turn diffs after partial apply_patch failures (#21518)

2026-05-07 18:05:45 +02:00

turn_metadata_tests.rs

[codex] add compaction metadata to turn headers (#24368)

2026-05-27 11:09:33 -07:00

turn_metadata.rs

[codex] add compaction metadata to turn headers (#24368)

2026-05-27 11:09:33 -07:00

turn_timing_tests.rs

Add turn start timestamp to turn metadata (#19473)

2026-04-28 16:36:59 +00:00

turn_timing.rs

[codex] Use compaction_trigger item for remote compaction v2 (#22809)

2026-05-15 11:40:35 +02:00

user_shell_command_tests.rs

Organize context fragments (#18794)

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

user_shell_command.rs

Organize context fragments (#18794)

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

util_tests.rs

Trim TUI legacy core helper usage (#22695)

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

util.rs

Trim TUI legacy core helper usage (#22695)

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

web_search.rs

…

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

config: remove legacy profile v1 resolution (#24051)

2026-05-22 12:13:52 +02:00

windows_sandbox.rs

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

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