pakrym-oaiandGitHub dac5f07403 [codex] Add context remaining tool (#27518) ...

## Why

The token budget feature can inject remaining-context notices into
model-visible context, but the model does not have a direct way to ask
for that same remaining-token fragment on demand.

This PR adds a small model tool for the token budget feature so the
model can request the current remaining context window message without
duplicating the fragment format.

## What changed

- Adds a `get_context_remaining` direct-model tool behind
`Feature::TokenBudget`.
- Renders the tool output through `TokenBudgetRemainingContext`,
matching the existing budget message shape.
- Registers the tool alongside `new_context` in the token budget tool
set.
- Adds integration coverage that verifies the tool is exposed and
returns the same `<token_budget>` remaining fragment already present in
context.

## Validation

- `just test -p codex-core token_budget`

2026-06-11 04:17:10 +00:00

..

snapshots

[codex] Add new context window tool (#27488)

2026-06-11 03:39:07 +00:00

abort_tasks.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

additional_context.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

agent_execution.rs

feat: count V2 concurrency by active execution (#26969)

2026-06-08 14:21:28 +02:00

agent_jobs.rs

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

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

agent_websocket.rs

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

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

agents_md.rs

[codex] Characterize global instruction lifecycle (#26830)

2026-06-09 20:51:57 +00:00

apply_patch_cli.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

approvals.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

auto_review.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

cli_stream.rs

Guard core test subprocess cleanup (#27343)

2026-06-10 12:19:26 -07:00

client_websockets.rs

[codex] Store compact window id in rollout (#27264)

2026-06-10 08:47:16 -07:00

client.rs

[codex] Store compact window id in rollout (#27264)

2026-06-10 08:47:16 -07:00

code_mode.rs

core: resize all history images behind a feature flag (#27247)

2026-06-10 19:21:24 -07:00

codex_delegate.rs

chore(features) rm Feature::ApplyPatchFreeform (#22711)

2026-05-14 16:15:56 -07:00

collaboration_instructions.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

compact_remote_parity.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

compact_remote.rs

Add per-session realtime model and version overrides (#24999)

2026-06-09 17:54:32 -07:00

compact_resume_fork.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

compact.rs

[codex] Compact when comp_hash changes (#27520)

2026-06-11 04:11:26 +00:00

deprecation_notice.rs

[codex] Remove experimental instructions file config (#22724)

2026-05-14 18:04:26 -07:00

exec_policy.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

exec.rs

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

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

fork_thread.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

guardian_review.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

hierarchical_agents.rs

Fix remote environment test fixtures (#22572)

2026-05-14 12:40:01 -07:00

hooks_mcp.rs

[codex] Wait for MCP readiness in core integration tests (#24964)

2026-05-29 10:22:27 -07:00

hooks.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

image_rollout.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

items.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

json_result.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

live_cli.rs

Prefer just test over cargo test in docs (#23910)

2026-05-22 16:58:14 +00:00

mcp_turn_metadata.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

mod.rs

[codex] Add token budget context feature (#27438)

2026-06-10 20:07:06 -07:00

model_overrides.rs

[5 of 7] Replace OverrideTurnContext with ThreadSettings (#22508)

2026-05-18 21:03:51 -07:00

model_runtime_selectors.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

model_switching.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

model_visible_layout.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

models_cache_ttl.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

models_etag_responses.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

openai_file_mcp.rs

Add user_input_requested_during_turn to MCP turn metadata (#22237)

2026-05-15 01:26:50 +00:00

otel.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

override_updates.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

pending_input.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

permissions_messages.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

personality_migration.rs

Add multi-agent runtime metadata types (#25720)

2026-06-02 12:10:14 +02:00

personality.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

plugins.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

prompt_caching.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

prompt_debug_tests.rs

Route AGENTS.md loading through environment filesystems (#26205)

2026-06-04 12:43:07 -07:00

quota_exceeded.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

realtime_conversation.rs

Add per-session realtime model and version overrides (#24999)

2026-06-09 17:54:32 -07:00

remote_env.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

remote_models.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

request_compression.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

request_permissions_tool.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

request_permissions.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

request_plugin_install.rs

Split plugin install discovery into list and request tools (#23372)

2026-05-19 14:45:37 -07:00

request_user_input.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

responses_api_proxy_headers.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

responses_lite.rs

core: strip image detail from Responses Lite requests (#27246)

2026-06-10 20:43:03 -07:00

resume_warning.rs

[codex] Compact when comp_hash changes (#27520)

2026-06-11 04:11:26 +00:00

resume.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

review.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

rmcp_client.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

rollout_list_find.rs

store and expose parent_thread_id on Threads (#25113)

2026-06-01 04:33:20 +00:00

safety_check_downgrade.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

search_tool.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

shell_command.rs

chore(features) rm Feature::ApplyPatchFreeform (#22711)

2026-05-14 16:15:56 -07:00

shell_serialization.rs

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

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

shell_snapshot.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

skill_approval.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

skills.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

spawn_agent_description.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

sqlite_state.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

stream_error_allows_next_turn.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

stream_no_completed.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

subagent_notifications.rs

Load selected executor skills through extensions (#27184)

2026-06-09 19:51:54 +02:00

token_budget.rs

[codex] Add context remaining tool (#27518)

2026-06-11 04:17:10 +00:00

tool_harness.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

tool_parallelism.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

tools.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

truncation.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

turn_state.rs

Stabilize websocket response.failed error delivery (#14017)

2026-03-11 12:33:09 -07:00

unified_exec_zsh_fork_approvals.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

unified_exec.rs

[codex] Handle Ctrl-C for non-TTY unified exec (#26734)

2026-06-09 15:10:17 -07:00

unstable_features_warning.rs

app-server: remove experimental persist_extended_history bool flag (#25712)

2026-06-01 23:33:42 +00:00

user_notification.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

user_shell_cmd.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

view_image.rs

[codex] Add comp_hash to model metadata (#27532)

2026-06-10 20:42:55 -07:00

web_search.rs

core tests: submit turns with permission profiles (#20010)

2026-04-28 23:01:40 +00:00

websocket_fallback.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

window_headers.rs

Pair thread environment settings (#26687)

2026-06-08 13:55:15 -07:00

windows_sandbox.rs

Use Windows setup marker as completion signal (#26074)

2026-06-03 15:33:34 -07:00