489 Commits

• feat: add Reject approval policy with granular prompt rejection controls (#12087)

  ## Why
  
  We need a way to auto-reject specific approval prompt categories without
  switching all approvals off.
  
  The goal is to let users independently control:
  - sandbox escalation approvals,
  - execpolicy `prompt` rule approvals,
  - MCP elicitation prompts.
  
  ## What changed
  
  - Added a new primary approval mode in `protocol/src/protocol.rs`:
  
  ```rust
  pub enum AskForApproval {
      // ...
      Reject(RejectConfig),
      // ...
  }
  
  pub struct RejectConfig {
      pub sandbox_approval: bool,
      pub rules: bool,
      pub mcp_elicitations: bool,
  }
  ```
  
  - Wired `RejectConfig` semantics through approval paths in `core`:
    - `core/src/exec_policy.rs`
      - rejects rule-driven prompts when `rules = true`
      - rejects sandbox/escalation prompts when `sandbox_approval = true`
  - preserves rule priority when both rule and sandbox prompt conditions
  are present
    - `core/src/tools/sandboxing.rs`
  - applies `sandbox_approval` to default exec approval decisions and
  sandbox-failure retry gating
    - `core/src/safety.rs`
  - keeps `Reject { all false }` behavior aligned with `OnRequest` for
  patch safety
      - rejects out-of-root patch approvals when `sandbox_approval = true`
    - `core/src/mcp_connection_manager.rs`
      - auto-declines MCP elicitations when `mcp_elicitations = true`
  
  - Ensured approval policy used by MCP elicitation flow stays in sync
  with constrained session policy updates.
  
  - Updated app-server v2 conversions and generated schema/TypeScript
  artifacts for the new `Reject` shape.
  
  ## Verification
  
  Added focused unit coverage for the new behavior in:
  - `core/src/exec_policy.rs`
  - `core/src/tools/sandboxing.rs`
  - `core/src/mcp_connection_manager.rs`
  - `core/src/safety.rs`
  - `core/src/tools/runtimes/apply_patch.rs`
  
  Key cases covered include rule-vs-sandbox prompt precedence, MCP
  auto-decline behavior, and patch/sandbox retry behavior under
  `RejectConfig`.

  Michael Bolin · 2026-02-19 11:41:49 -08:00
  425fff7ad6
• Revert "feat: no timeout mode on ue" (#12256)

  Reverts openai/codex#12250

  jif-oai · 2026-02-19 19:02:29 +00:00
  928be5f515
• feat: no timeout mode on ue (#12250)
  jif-oai · 2026-02-19 18:58:13 +00:00
  9719dc502c
• Add configurable agent spawn depth (#12251)

  Summary
  - expose `agents.max_depth` in config schema and toml parsing, with
  defaults and validation
  - thread-spawn depth guards and multi-agent handler now respect the
  configured limit instead of a hardcoded value
  - ensure documentation and helpers account for agent depth limits

  jif-oai · 2026-02-19 18:40:41 +00:00
  d87cf7794c
• feat: sub-agent injection (#12152)

  This PR adds parent-thread sub-agent completion notifications and change
  the prompt of the model to prevent if from being confused

  jif-oai · 2026-02-19 11:32:10 +00:00
  2daa3fd44f
• js_repl: canonicalize paths for node_modules boundary checks (#12177)

  ## Summary
  
  Fix `js_repl` package-resolution boundary checks for macOS temp
  directory path aliasing (`/var` vs `/private/var`).
  
  ## Problem
  
  `js_repl` verifies that resolved bare-package imports stay inside a
  configured `node_modules` root.
  On macOS, temp directories are commonly exposed as `/var/...` but
  canonicalize to `/private/var/...`.
  Because the boundary check compared raw paths with `path.relative(...)`,
  valid resolutions under temp dirs could be misclassified as escaping the
  allowed base, causing false `Module not found` errors.
  
  ## Changes
  
  - Add `fs` import in the JS kernel.
  - Add `canonicalizePath()` using `fs.realpathSync.native(...)` (with
  safe fallback).
  - Canonicalize both `base` and `resolvedPath` before running the
  `node_modules` containment check.
  
  ## Impact
  
  - Fixes false-negative boundary checks for valid package resolutions in
  macOS temp-dir scenarios.
  - Keeps the existing security boundary behavior intact.
  - Scope is limited to `js_repl` kernel module path validation logic.
  
  
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - 👉 `1` https://github.com/openai/codex/pull/12177
  - ⏳ `2` https://github.com/openai/codex/pull/10673

  Curtis 'Fjord' Hawthorne · 2026-02-18 11:56:45 -08:00
  cc248e4681
• Stop filtering model tools in js_repl_tools_only mode (#12069)

  ## Summary
  This change removes tool-list filtering in `js_repl_tools_only` mode and
  relies on the normal model tool descriptions, while still enforcing that
  tool execution must go through `js_repl` + `codex.tool(...)`.
  
  ## Motivation
  The previous `js_repl_tools_only` filtering hid most tools from the
  model request, which diverged from standard tool-list behavior and made
  signatures less discoverable. I tested that this filtering is not
  needed, and the model can follow the prompt to only call tools via
  `js_repl`.
  
  ## What Changed
  - `filter_tools_for_model(...)` in `core/src/tools/spec.rs` is now a
  pass-through (no filtering when `js_repl_tools_only` is enabled).
  - Updated tests to assert that model tools are not filtered in
  `js_repl_tools_only` mode.
  - Updated dynamic-tool test to assert dynamic tools remain visible in
  model tool specs.
  - Removed obsolete test helper used only by the old filtering
  assertions.
  
  ## Safety / Behavior
  - This commit does **not** relax execution policy.
  - Direct model tool calls remain blocked in `js_repl_tools_only` mode
  (except internal `js_repl` tools), and callers are instructed to use
  `js_repl` + `codex.tool(...)`.
  
  ## Testing
  - `cargo test -p codex-core js_repl_tools_only`
  - Manual rollout validation showed the model can follow the `js_repl`
  routing instructions without needing filtered tool lists.
  
  
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - 👉 `1` https://github.com/openai/codex/pull/12069
  - ⏳ `2` https://github.com/openai/codex/pull/10673
  - ⏳ `3` https://github.com/openai/codex/pull/10670

  Curtis 'Fjord' Hawthorne · 2026-02-18 07:31:15 -08:00
  491b4946ae
• feat: memory usage metrics (#12120)
  jif-oai · 2026-02-18 12:45:19 +00:00
  a9f5f633b2
• [js_repl] paths for node module resolution can be specified for js_repl (#11944)

  # External (non-OpenAI) Pull Request Requirements
  
  In `js_repl` mode, module resolution currently starts from
  `js_repl_kernel.js`, which is written to a per-kernel temp dir. This
  effectively means that bare imports will not resolve.
  
  This PR adds a new config option, `js_repl_node_module_dirs`, which is a
  list of dirs that are used (in order) to resolve a bare import. If none
  of those work, the current working directory of the thread is used.
  
  For example:
  ```toml
  js_repl_node_module_dirs = [
      "/path/to/node_modules/",
      "/other/path/to/node_modules/",
  ]
  ```

  aaronl-openai · 2026-02-17 23:29:49 -08:00
  f600453699
• feat(core): zsh exec bridge (#12052)

  zsh fork PR stack:
  - https://github.com/openai/codex/pull/12051 
  - https://github.com/openai/codex/pull/12052 👈 
  
  ### Summary
  This PR introduces a feature-gated native shell runtime path that routes
  shell execution through a patched zsh exec bridge, removing MCP-specific
  behavior from the shell hot path while preserving existing
  CommandExecution lifecycle semantics.
  
  When shell_zsh_fork is enabled, shell commands run via patched zsh with
  per-`execve` interception through EXEC_WRAPPER. Core receives wrapper
  IPC requests over a Unix socket, applies existing approval policy, and
  returns allow/deny before the subcommand executes.
  
  ### What’s included
  **1) New zsh exec bridge runtime in core**
  - Wrapper-mode entrypoint (maybe_run_zsh_exec_wrapper_mode) for
  EXEC_WRAPPER invocations.
  - Per-execution Unix-socket IPC handling for wrapper requests/responses.
  - Approval callback integration using existing core approval
  orchestration.
  - Streaming stdout/stderr deltas to existing command output event
  pipeline.
  - Error handling for malformed IPC, denial/abort, and execution
  failures.
  
  **2) Session lifecycle integration**
  SessionServices now owns a `ZshExecBridge`.
  Session startup initializes bridge state; shutdown tears it down
  cleanly.
  
  **3) Shell runtime routing (feature-gated)**
  When `shell_zsh_fork` is enabled:
  - Build execution env/spec as usual.
  - Add wrapper socket env wiring.
  - Execute via `zsh_exec_bridge.execute_shell_request(...)` instead of
  the regular shell path.
  - Non-zsh-fork behavior remains unchanged.
  
  **4) Config + feature wiring**
  - Added `Feature::ShellZshFork` (under development).
  - Added config support for `zsh_path` (optional absolute path to patched
  zsh):
  - `Config`, `ConfigToml`, `ConfigProfile`, overrides, and schema.
  - Session startup validates that `zsh_path` exists/usable when zsh-fork
  is enabled.
  - Added startup test for missing `zsh_path` failure mode.
  
  **5) Seatbelt/sandbox updates for wrapper IPC**
  - Extended seatbelt policy generation to optionally allow outbound
  connection to explicitly permitted Unix sockets.
  - Wired sandboxing path to pass wrapper socket path through to seatbelt
  policy generation.
  - Added/updated seatbelt tests for explicit socket allow rule and
  argument emission.
  
  **6) Runtime entrypoint hooks**
  - This allows the same binary to act as the zsh wrapper subprocess when
  invoked via `EXEC_WRAPPER`.
  
  **7) Tool selection behavior**
  - ToolsConfig now prefers ShellCommand type when shell_zsh_fork is
  enabled.
  - Added test coverage for precedence with unified-exec enabled.

  Owen Lin · 2026-02-17 20:19:53 -08:00
  edacbf7b6e
• feat(core): plumb distinct approval ids for command approvals (#12051)

  zsh fork PR stack:
  - https://github.com/openai/codex/pull/12051 👈 
  - https://github.com/openai/codex/pull/12052
  
  With upcoming support for a fork of zsh that allows us to intercept
  `execve` and run execpolicy checks for each subcommand as part of a
  `CommandExecution`, it will be possible for there to be multiple
  approval requests for a shell command like `/path/to/zsh -lc 'git status
  && rg \"TODO\" src && make test'`.
  
  To support that, this PR introduces a new `approval_id` field across
  core, protocol, and app-server so that we can associate approvals
  properly for subcommands.

  Owen Lin · 2026-02-18 01:55:57 +00:00
  db4d2599b5
• [apps] Expose more fields from apps listing endpoints. (#11706)

  - [x] Expose app_metadata, branding, and labels in AppInfo.

  Matthew Zeng · 2026-02-17 11:45:04 -08:00
  16fa195fce
• feat: move agents config to main config (#11982)
  jif-oai · 2026-02-17 18:17:19 +00:00
  76283e6b4e
• fix: race in js repl (#11922)

  js_repl_reset previously raced with in-flight/new js_repl executions
  because reset() could clear exec_tool_calls without synchronizing with
  execute(). In that window, a running exec could lose its per-exec
  tool-call context, and subsequent kernel RunTool messages would fail
  with js_repl exec context not found. The fix serializes reset and
  execute on the same exec_lock, so reset cannot run concurrently with
  exec setup/teardown. We also keep the timeout path safe by performing
  reset steps inline while execute() already holds the lock, avoiding
  re-entrant lock acquisition. A regression test now verifies that reset
  waits for the exec lock and does not clear tool-call state early.

  jif-oai · 2026-02-17 11:06:14 +00:00
  77f74a5c17
• fix: js_repl reset hang by clearing exec tool calls without waiting (#11932)

  Remove the waiting loop in `reset` so it no longer blocks on potentially
  hanging exec tool calls + add `clear_all_exec_tool_calls_map` to drain
  the map and notify waiters so `reset` completes immediately

  jif-oai · 2026-02-17 08:40:54 +00:00
  846464e869
• chore(core) rm Feature::RequestRule (#11866)

  ## Summary
  This feature is now reasonably stable, let's remove it so we can
  simplify our upcoming iterations here.
  
  ## Testing 
  - [x] Existing tests pass

  Dylan Hurd · 2026-02-16 22:30:23 +00:00
  19afbc35c1
• Rename collab modules to multi agents (#11939)

  Summary
  - rename the `collab` handlers and UI files to `multi_agents` to match
  the new naming
  - update module references and specs so the handlers and TUI widgets
  consistently use the renamed files
  - keep the existing functionality while aligning file and module names
  with the multi-agent terminology

  jif-oai · 2026-02-16 19:05:13 +00:00
  beb5cb4f48
• feat: drop MCP managing tools if no MCP servers (#11900)

  Drop MCP tools if no MCP servers to save context
  
  For this https://github.com/openai/codex/issues/11049

  jif-oai · 2026-02-16 18:40:45 +00:00
  af434b4f71
• feat: add customizable roles for multi-agents (#11917)

  The idea is to have 2 family of agents.
  
  1. Built-in that we packaged directly with Codex
  2. User defined that are defined using the `agents_config.toml` file. It
  can reference config files that will override the agent config. This
  looks like this:
  ```
  version = 1
  
  [agents.explorer]
  description = """Use `explorer` for all codebase questions.
  Explorers are fast and authoritative.
  Always prefer them over manual search or file reading.
  Rules:
  - Ask explorers first and precisely.
  - Do not re-read or re-search code they cover.
  - Trust explorer results without verification.
  - Run explorers in parallel when useful.
  - Reuse existing explorers for related questions."""
  config_file = "explorer.toml"
  ```

  jif-oai · 2026-02-16 16:29:32 +00:00
  e47045c806
• Allow hooks to error (#11615)

  Allow hooks to return errors. 
  
  We should do this before introducing more hook types, or we'll have to
  migrate them all.

  gt-oai · 2026-02-16 14:11:05 +00:00
  b3095679ed
• feat: use shell policy in shell snapshot (#11759)

  Honor `shell_environment_policy.set` even after a shell snapshot

  jif-oai · 2026-02-16 09:11:00 +00:00
  825a4af42f
• feat: persist and restore codex app's tools after search (#11780)

  ### What changed
  1. Removed per-turn MCP selection reset in `core/src/tasks/mod.rs`.
  2. Added `SessionState::set_mcp_tool_selection(Vec<String>)` in
  `core/src/state/session.rs` for authoritative restore behavior (deduped,
  order-preserving, empty clears).
  3. Added rollout parsing in `core/src/codex.rs` to recover
  `active_selected_tools` from prior `search_tool_bm25` outputs:
     - tracks matching `call_id`s
     - parses function output text JSON
     - extracts `active_selected_tools`
     - latest valid payload wins
     - malformed/non-matching payloads are ignored
  4. Applied restore logic to resumed and forked startup paths in
  `core/src/codex.rs`.
  5. Updated instruction text to session/thread scope in
  `core/templates/search_tool/tool_description.md`.
  6. Expanded tests in `core/tests/suite/search_tool.rs`, plus unit
  coverage in:
     - `core/src/codex.rs`
     - `core/src/state/session.rs`
  
  ### Behavior after change
  1. Search activates matched tools.
  2. Additional searches union into active selection.
  3. Selection survives new turns in the same thread.
  4. Resume/fork restores selection from rollout history.
  5. Separate threads do not inherit selection unless forked.

  Anton Panasenko · 2026-02-15 19:18:41 -08:00
  02abd9a8ea
• fix(core): add linux bubblewrap sandbox tag (#11767)

  ## Summary
  - add a distinct `linux_bubblewrap` sandbox tag when the Linux
  bubblewrap pipeline feature is enabled
  - thread the bubblewrap feature flag into sandbox tag generation for:
    - turn metadata header emission
    - tool telemetry metric tags and after-tool-use hooks
  - add focused unit tests for `sandbox_tag` precedence and Linux
  bubblewrap behavior
  
  ## Validation
  - `just fmt`
  - `cargo clippy -p codex-core --all-targets`
  - `cargo test -p codex-core sandbox_tags::tests`
  - started `cargo test -p codex-core` and stopped it per request
  
  Co-authored-by: Codex <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

  viyatb-oai · 2026-02-14 19:00:01 +00:00
  db6aa80195
• feat(core): add structured network approval plumbing and policy decision model (#11672)

  ### Description
  #### Summary
  Introduces the core plumbing required for structured network approvals
  
  #### What changed
  - Added structured network policy decision modeling in core.
  - Added approval payload/context types needed for network approval
  semantics.
  - Wired shell/unified-exec runtime plumbing to consume structured
  decisions.
  - Updated related core error/event surfaces for structured handling.
  - Updated protocol plumbing used by core approval flow.
  - Included small CLI debug sandbox compatibility updates needed by this
  layer.
  
  #### Why
  establishes the minimal backend foundation for network approvals without
  yet changing high-level orchestration or TUI behavior.
  
  #### Notes
  - Behavior remains constrained by existing requirements/config gating.
  - Follow-up PRs in the stack handle orchestration, UX, and app-server
  integration.
  
  ---------
  
  Co-authored-by: Codex <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>

  viyatb-oai · 2026-02-14 04:18:12 +00:00
  b527ee2890
• Fix js_repl in-flight tool-call waiter race (#11800)

  ## Summary
  
  This PR fixes a race in `js_repl` tool-call draining that could leave an
  exec waiting indefinitely for in-flight tool calls to finish.
  
  The fix is in:
  
  -
  `/Users/fjord/code/codex-jsrepl-seq/codex-rs/core/src/tools/js_repl/mod.rs`
  
  ## Problem
  
  `js_repl` tracks in-flight tool calls per exec and waits for them to
  drain on completion/timeout/cancel paths.
  The previous wait logic used a check-then-wait pattern with `Notify`
  that could miss a wakeup:
  
  1. Observe `in_flight > 0`
  2. Drop lock
  3. Register wait (`notified().await`)
  
  If `notify_waiters()` happened between (2) and (3), the waiter could
  sleep until another notification that never comes.
  
  ## What changed
  
  - Updated all exec-tool-call wait loops to create an owned notification
  future while holding the lock:
  - use `Arc<Notify>::notified_owned()` instead of cloning notify and
  awaiting later.
  - Applied this consistently to:
    - `wait_for_exec_tool_calls`
    - `wait_for_all_exec_tool_calls`
    - `wait_for_exec_tool_calls_map`
  
  This preserves existing behavior while eliminating the lost-wakeup
  window.
  
  ## Test coverage
  
  Added a regression test:
  
  - `wait_for_exec_tool_calls_map_drains_inflight_calls_without_hanging`
  
  The test repeatedly races waiter/finisher tasks and asserts bounded
  completion to catch hangs.
  
  ## Impact
  
  - No API changes.
  - No user-facing behavior changes intended.
  - Improves reliability of exec lifecycle boundaries when tool calls are
  still in flight.
  
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - ✅ `1` https://github.com/openai/codex/pull/11796
  - 👉 `2` https://github.com/openai/codex/pull/11800
  - ⏳ `3` https://github.com/openai/codex/pull/10673
  - ⏳ `4` https://github.com/openai/codex/pull/10670

  Curtis 'Fjord' Hawthorne · 2026-02-14 01:24:52 +00:00
  0d76d029b7
• Fix js_repl view_image test runtime panic (#11796)

  ## Summary
  Fixes a flaky/panicking `js_repl` image-path test by running it on a
  multi-thread Tokio runtime and tightening assertions to focus on real
  behavior.
  
  ## Problem
  `js_repl_can_attach_image_via_view_image_tool` in  
  
  `/Users/fjord/code/codex-jsrepl-seq/codex-rs/core/src/tools/js_repl/mod.rs`
  can panic under single-thread test runtime with:
  
  `can call blocking only when running on the multi-threaded runtime`
  
  It also asserted a brittle user-facing text string.
  
  ## Changes
  1. Updated the test runtime to:
     `#[tokio::test(flavor = "multi_thread", worker_threads = 2)]`
  2. Removed the brittle `"attached local image path"` string assertion.
  3. Kept the concrete side-effect assertions:
     - tool call succeeds
  - image is actually injected into pending input (`InputImage` with
  `data:image/png;base64,...`)
  
  ## Why this is safe
  This is test-only behavior. No production runtime code paths are
  changed.
  
  ## Validation
  - Ran:
  `cargo test -p codex-core
  tools::js_repl::tests::js_repl_can_attach_image_via_view_image_tool --
  --nocapture`
  - Result: pass
  
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - 👉 `1` https://github.com/openai/codex/pull/11796
  - ⏳ `2` https://github.com/openai/codex/pull/11800
  - ⏳ `3` https://github.com/openai/codex/pull/10673
  - ⏳ `4` https://github.com/openai/codex/pull/10670

  Curtis 'Fjord' Hawthorne · 2026-02-14 01:11:13 +00:00
  6cbb489e6e
• Add js_repl kernel crash diagnostics (#11666)

  ## Summary
  
  This PR improves `js_repl` crash diagnostics so kernel failures are
  debuggable without weakening timeout/reset guarantees.
  
  ## What Changed
  
  - Added bounded kernel stderr capture and truncation logic (line + byte
  caps).
  - Added structured kernel snapshots (`pid`, exit status, stderr tail)
  for failure paths.
  - Enriched model-visible kernel-failure errors with a structured
  diagnostics payload:
    - `js_repl diagnostics: {...}`
    - Included only for likely kernel-failure write/EOF cases.
  - Improved logging around kernel write failures, unexpected exits, and
  kill/wait paths.
  - Added/updated unit tests for:
    - UTF-8-safe truncation
    - stderr tail bounds
    - structured diagnostics shape/truncation
    - conditional diagnostics emission
    - timeout kill behavior
    - forced kernel-failure diagnostics
  
  ## Why
  
  Before this, failures like broken pipe / unexpected kernel exit often
  surfaced as generic errors with little context. This change preserves
  existing behavior but adds actionable diagnostics while keeping output
  bounded.
  
  ## Scope
  
  - Code changes are limited to:
  -
  `/Users/fjord/code/codex-jsrepl-seq/codex-rs/core/src/tools/js_repl/mod.rs`
  
  ## Validation
  
  - `cargo clippy -p codex-core --all-targets -- -D warnings`
  - Targeted `codex-core` js_repl unit tests (including new
  diagnostics/timeout coverage)
  - Tried starting a long running js_repl command (sleep for 10 minutes),
  verified error output was as expected after killing the node process.
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - 👉 `1` https://github.com/openai/codex/pull/11666
  - ⏳ `2` https://github.com/openai/codex/pull/10673
  - ⏳ `3` https://github.com/openai/codex/pull/10670

  Curtis 'Fjord' Hawthorne · 2026-02-13 11:57:11 -08:00
  a02342c9e1
• core: limit search_tool_bm25 to Apps and clarify discovery guidance (#11669)

  ## Summary
  - Limit `search_tool_bm25` indexing to `codex_apps` tools only, so
  non-Apps MCP servers are no longer discoverable through this search
  path.
  - Move search-tool discovery guidance into the `search_tool_bm25` tool
  description (via template include) instead of injecting it as a separate
  developer message.
  - Update Apps discovery guidance wording to clarify when to use
  `search_tool_bm25` for Apps-backed systems (for example Slack, Google
  Drive, Jira, Notion) and when to call tools directly.
  - Remove dead `core` helper code (`filter_codex_apps_mcp_tools` and
  `codex_apps_connector_id`) that is no longer used after the
  tool-selection refactor.
  - Update `core` search-tool tests to assert codex-apps-only behavior and
  to validate guidance from the tool description.
  
  ## Validation
  - ✅ `just fmt`
  - ✅ `cargo test -p codex-core search_tool`
  - ⚠️ `cargo test -p codex-core` was attempted, but the run repeatedly
  stalled on
  `tools::js_repl::tests::js_repl_can_attach_image_via_view_image_tool`.
  
  ## Tickets
  - None

  Anton Panasenko · 2026-02-13 09:32:46 -08:00
  38c442ca7f
• [apps] Add is_enabled to app info. (#11417)

  - [x] Add is_enabled to app info and the response of `app/list`.
  - [x] Update TUI to have Enable/Disable button on the app detail page.

  Matthew Zeng · 2026-02-13 00:30:52 +00:00
  c37560069a
• Add js_repl_tools_only model and routing restrictions (#10671)

  # External (non-OpenAI) Pull Request Requirements
  
  Before opening this Pull Request, please read the dedicated
  "Contributing" markdown file or your PR may be closed:
  https://github.com/openai/codex/blob/main/docs/contributing.md
  
  If your PR conforms to our contribution guidelines, replace this text
  with a detailed and high quality description of your changes.
  
  Include a link to a bug report or enhancement request.
  
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - ✅ `1` https://github.com/openai/codex/pull/10674
  - ✅ `2` https://github.com/openai/codex/pull/10672
  - 👉 `3` https://github.com/openai/codex/pull/10671
  - ⏳ `4` https://github.com/openai/codex/pull/10673
  - ⏳ `5` https://github.com/openai/codex/pull/10670

  Curtis 'Fjord' Hawthorne · 2026-02-12 15:41:05 -08:00
  0dcfc59171
• feat: introduce Permissions (#11633)

  ## Why
  We currently carry multiple permission-related concepts directly on
  `Config` for shell/unified-exec behavior (`approval_policy`,
  `sandbox_policy`, `network`, `shell_environment_policy`,
  `windows_sandbox_mode`).
  
  Consolidating these into one in-memory struct makes permission handling
  easier to reason about and sets up the next step: supporting named
  permission profiles (`[permissions.PROFILE_NAME]`) without changing
  behavior now.
  
  This change is mostly mechanical: it updates existing callsites to go
  through `config.permissions`, but it does not yet refactor those
  callsites to take a single `Permissions` value in places where multiple
  permission fields are still threaded separately.
  
  This PR intentionally **does not** change the on-disk `config.toml`
  format yet and keeps compatibility with legacy config keys.
  
  ## What Changed
  - Introduced `Permissions` in `core/src/config/mod.rs`.
  - Added `Config::permissions` and moved effective runtime permission
  fields under it:
    - `approval_policy`
    - `sandbox_policy`
    - `network`
    - `shell_environment_policy`
    - `windows_sandbox_mode`
  - Updated config loading/building so these effective values are still
  derived from the same existing config inputs and constraints.
  - Updated Windows sandbox helpers/resolution to read/write via
  `permissions`.
  - Threaded the new field through all permission consumers across core
  runtime, app-server, CLI/exec, TUI, and sandbox summary code.
  - Updated affected tests to reference `config.permissions.*`.
  - Renamed the struct/field from
  `EffectivePermissions`/`effective_permissions` to
  `Permissions`/`permissions` and aligned variable naming accordingly.
  
  ## Verification
  - `just fix -p codex-core -p codex-tui -p codex-cli -p codex-app-server
  -p codex-exec -p codex-utils-sandbox-summary`
  - `cargo build -p codex-core -p codex-tui -p codex-cli -p
  codex-app-server -p codex-exec -p codex-utils-sandbox-summary`

  Michael Bolin · 2026-02-12 14:42:54 -08:00
  a4cc1a4a85
• Add js_repl host helpers and exec end events (#10672)

  ## Summary
  
  This PR adds host-integrated helper APIs for `js_repl` and updates model
  guidance so the agent can use them reliably.
  
  ### What’s included
  
  - Add `codex.tool(name, args?)` in the JS kernel so `js_repl` can call
  normal Codex tools.
  - Keep persistent JS state and scratch-path helpers available:
    - `codex.state`
    - `codex.tmpDir`
  - Wire `js_repl` tool calls through the standard tool router path.
  - Add/align `js_repl` execution completion/end event behavior with
  existing tool logging patterns.
  - Update dynamic prompt injection (`project_doc`) to document:
    - how to call `codex.tool(...)`
    - raw output behavior
  - image flow via `view_image` (`codex.tmpDir` +
  `codex.tool("view_image", ...)`)
  - stdio safety guidance (`console.log` / `codex.tool`, avoid direct
  `process.std*`)
  
  ## Why
  
  - Standardize JS-side tool usage on `codex.tool(...)`
  - Make `js_repl` behavior more consistent with existing tool execution
  and event/logging patterns.
  - Give the model enough runtime guidance to use `js_repl` safely and
  effectively.
  
  ## Testing
  
  - Added/updated unit and runtime tests for:
    - `codex.tool` calls from `js_repl` (including shell/MCP paths)
    - image handoff flow via `view_image`
    - prompt-injection text for `js_repl` guidance
    - execution/end event behavior and related regression coverage
  
  
  
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - ✅ `1` https://github.com/openai/codex/pull/10674
  - 👉 `2` https://github.com/openai/codex/pull/10672
  - ⏳ `3` https://github.com/openai/codex/pull/10671
  - ⏳ `4` https://github.com/openai/codex/pull/10673
  - ⏳ `5` https://github.com/openai/codex/pull/10670

  Curtis 'Fjord' Hawthorne · 2026-02-12 12:10:25 -08:00
  466be55abc
• feat(app-server): experimental flag to persist extended history (#11227)

  This PR adds an experimental `persist_extended_history` bool flag to
  app-server thread APIs so rollout logs can retain a richer set of
  EventMsgs for non-lossy Thread > Turn > ThreadItems reconstruction (i.e.
  on `thread/resume`).
  
  ### Motivation
  Today, our rollout recorder only persists a small subset (e.g. user
  message, reasoning, assistant message) of `EventMsg` types, dropping a
  good number (like command exec, file change, etc.) that are important
  for reconstructing full item history for `thread/resume`, `thread/read`,
  and `thread/fork`.
  
  Some clients want to be able to resume a thread without lossiness. This
  lossiness is primarily a UI thing, since what the model sees are
  `ResponseItem` and not `EventMsg`.
  
  ### Approach
  This change introduces an opt-in `persist_full_history` flag to preserve
  those events when you start/resume/fork a thread (defaults to `false`).
  
  This is done by adding an `EventPersistenceMode` to the rollout
  recorder:
  - `Limited` (existing behavior, default)
  - `Extended` (new opt-in behavior)
  
  In `Extended` mode, persist additional `EventMsg` variants needed for
  non-lossy app-server `ThreadItem` reconstruction. We now store the
  following ThreadItems that we didn't before:
  - web search
  - command execution
  - patch/file changes
  - MCP tool calls
  - image view calls
  - collab tool outcomes
  - context compaction
  - review mode enter/exit
  
  For **command executions** in particular, we truncate the output using
  the existing `truncate_text` from core to store an upper bound of 10,000
  bytes, which is also the default value for truncating tool outputs shown
  to the model. This keeps the size of the rollout file and command
  execution items returned over the wire reasonable.
  
  And we also persist `EventMsg::Error` which we can now map back to the
  Turn's status and populates the Turn's error metadata.
  
  #### Updates to EventMsgs
  To truly make `thread/resume` non-lossy, we also needed to persist the
  `status` on `EventMsg::CommandExecutionEndEvent` and
  `EventMsg::PatchApplyEndEvent`. Previously it was not obvious whether a
  command failed or was declined (similar for apply_patch). These
  EventMsgs were never persisted before so I made it a required field.

  Owen Lin · 2026-02-12 19:34:22 +00:00
  efc8d45750
• Bump rmcp to 0.15 (#11539)

  https://github.com/modelcontextprotocol/rust-sdk/pull/598 in 0.14 broke
  some MCP oauth (like Linear) and
  https://github.com/modelcontextprotocol/rust-sdk/pull/641 fixed it in
  0.15

  Gabriel Peal · 2026-02-11 22:04:17 -08:00
  bd3ce98190
• feat: make sandbox read access configurable with ReadOnlyAccess (#11387)

  `SandboxPolicy::ReadOnly` previously implied broad read access and could
  not express a narrower read surface.
  This change introduces an explicit read-access model so we can support
  user-configurable read restrictions in follow-up work, while preserving
  current behavior today.
  
  It also ensures unsupported backends fail closed for restricted-read
  policies instead of silently granting broader access than intended.
  
  ## What
  
  - Added `ReadOnlyAccess` in protocol with:
    - `Restricted { include_platform_defaults, readable_roots }`
    - `FullAccess`
  - Updated `SandboxPolicy` to carry read-access configuration:
    - `ReadOnly { access: ReadOnlyAccess }`
    - `WorkspaceWrite { ..., read_only_access: ReadOnlyAccess }`
  - Preserved existing behavior by defaulting current construction paths
  to `ReadOnlyAccess::FullAccess`.
  - Threaded the new fields through sandbox policy consumers and call
  sites across `core`, `tui`, `linux-sandbox`, `windows-sandbox`, and
  related tests.
  - Updated Seatbelt policy generation to honor restricted read roots by
  emitting scoped read rules when full read access is not granted.
  - Added fail-closed behavior on Linux and Windows backends when
  restricted read access is requested but not yet implemented there
  (`UnsupportedOperation`).
  - Regenerated app-server protocol schema and TypeScript artifacts,
  including `ReadOnlyAccess`.
  
  ## Compatibility / rollout
  
  - Runtime behavior remains unchanged by default (`FullAccess`).
  - API/schema changes are in place so future config wiring can enable
  restricted read access without another policy-shape migration.

  Michael Bolin · 2026-02-11 18:31:14 -08:00
  abbd74e2be
• Consolidate search_tool feature into apps (#11509)

  ## Summary
  - Remove `Feature::SearchTool` and the `search_tool` config key from the
  feature registry/schema.
  - Gate `search_tool_bm25` exposure via `Feature::Apps` in
  `core/src/tools/spec.rs`.
  - Update MCP selection logic in `core/src/codex.rs` to use
  `Feature::Apps` for search-tool behavior.
  - Update `core/tests/suite/search_tool.rs` to enable `Feature::Apps`.
  - Regenerate `core/config.schema.json` via `just write-config-schema`.
  
  ## Testing
  - `just fmt`
  - `cargo test -p codex-core --test all suite::search_tool::`
  
  ## Tickets
  - None

  Anton Panasenko · 2026-02-11 16:52:42 -08:00
  d3b078c282
• Add AfterToolUse hook (#11335)

  Not wired up to config yet. (So we can change the name if we want)
  
  An example payload:
  
  ```
  {
    "session_id": "019c48b7-7098-7b61-bc48-32e82585d451",
    "cwd": "/Users/gt/code/codex/codex-rs",
    "triggered_at": "2026-02-10T18:02:31Z",
    "hook_event": {
      "event_type": "after_tool_use",
      "turn_id": "4",
      "call_id": "call_iuo4DqWgjE7OxQywnL2UzJUE",
      "tool_name": "apply_patch",
      "tool_kind": "custom",
      "tool_input": {
        "input_type": "custom",
        "input": "*** Begin Patch\n*** Update File: README.md\n@@\n-# Codex CLI hello (Rust Implementation)\n+# Codex CLI (Rust Implementation)\n*** End Patch\n"
      },
      "executed": true,
      "success": true,
      "duration_ms": 37,
      "mutating": true,
      "sandbox": "none",
      "sandbox_policy": "danger-full-access",
      "output_preview": "{\"output\":\"Success. Updated the following files:\\nM README.md\\n\",\"metadata\":{\"exit_code\":0,\"duration_seconds\":0.0}}"
    }
  }
  ```

  gt-oai · 2026-02-11 22:25:04 +00:00
  7112e16809
• Add feature-gated freeform js_repl core runtime (#10674)

  ## Summary
  
  This PR adds an **experimental, feature-gated `js_repl` core runtime**
  so models can execute JavaScript in a persistent REPL context across
  tool calls.
  
  The implementation integrates with existing feature gating, tool
  registration, prompt composition, config/schema docs, and tests.
  
  ## What changed
  
  - Added new experimental feature flag: `features.js_repl`.
  - Added freeform `js_repl` tool and companion `js_repl_reset` tool.
  - Gated tool availability behind `Feature::JsRepl`.
  - Added conditional prompt-section injection for JS REPL instructions
  via marker-based prompt processing.
  - Implemented JS REPL handlers, including freeform parsing and pragma
  support (timeout/reset controls).
  - Added runtime resolution order for Node:
    1. `CODEX_JS_REPL_NODE_PATH`
    2. `js_repl_node_path` in config
    3. `PATH`
  - Added JS runtime assets/version files and updated docs/schema.
  
  ## Why
  
  This enables richer agent workflows that require incremental JavaScript
  execution with preserved state, while keeping rollout safe behind an
  explicit feature flag.
  
  ## Testing
  
  Coverage includes:
  
  - Feature-flag gating behavior for tool exposure.
  - Freeform parser/pragma handling edge cases.
  - Runtime behavior (state persistence across calls and top-level `await`
  support).
  
  ## Usage
  
  ```toml
  [features]
  js_repl = true
  ```
  
  Optional runtime override:
  
  - `CODEX_JS_REPL_NODE_PATH`, or
  - `js_repl_node_path` in config.
  
  #### [git stack](https://github.com/magus/git-stack-cli)
  - 👉 `1` https://github.com/openai/codex/pull/10674
  - ⏳ `2` https://github.com/openai/codex/pull/10672
  - ⏳ `3` https://github.com/openai/codex/pull/10671
  - ⏳ `4` https://github.com/openai/codex/pull/10673
  - ⏳ `5` https://github.com/openai/codex/pull/10670

  Curtis 'Fjord' Hawthorne · 2026-02-11 12:05:02 -08:00
  42e22f3bde
• chore: sub-agent never ask for approval (#11464)
  jif-oai · 2026-02-11 19:19:37 +00:00
  2fac9cc8cd
• Remove test-support feature from codex-core and replace it with explicit test toggles (#11405)

  ## Why
  
  `codex-core` was being built in multiple feature-resolved permutations
  because test-only behavior was modeled as crate features. For a large
  crate, those permutations increase compile cost and reduce cache reuse.
  
  ## Net Change
  
  - Removed the `test-support` crate feature and related feature wiring so
  `codex-core` no longer needs separate feature shapes for test consumers.
  - Standardized cross-crate test-only access behind
  `codex_core::test_support`.
  - External test code now imports helpers from
  `codex_core::test_support`.
  - Underlying implementation hooks are kept internal (`pub(crate)`)
  instead of broadly public.
  
  ## Outcome
  
  - Fewer `codex-core` build permutations.
  - Better incremental cache reuse across test targets.
  - No intended production behavior change.

  Michael Bolin · 2026-02-10 22:44:02 -08:00
  476c1a7160
• include sandbox (seatbelt, elevated, etc.) as in turn metadata header (#10946)

  This will help us understand retention/usage for folks who use the
  Windows (or any other) sandboxes

  iceweasel-oai · 2026-02-10 19:50:07 +00:00
  82f93a13b2
• fix(core): canonicalize wrapper approvals and support heredoc prefix … (#10941)

  ## Summary
  - Reduced repeated approvals for equivalent wrapper commands and fixed
  execpolicy matching for heredoc-style shell invocations, with minimal
  behavior change and fail-closed defaults.
  
  ## Fixes
  1. Canonicalized approval matching for wrappers so equivalent commands
  map to the same approval intent.
  2. Added heredoc-aware prefix extraction for execpolicy so commands like
  `python3 <<'PY' ... PY` match rules such as `prefix_rule(["python3"],
  ...)`.
  3. Kept fallback behavior conservative: if parsing is ambiguous,
  existing prompt behavior is preserved.
  
  ## Edge Cases Covered
  - Wrapper path/name differences: `/bin/bash` vs `bash`, `/bin/zsh` vs
  `zsh`.
  - Shell modes: `-c` and `-lc`.
  - Heredoc forms: quoted delimiter (`<<'PY'`) and unquoted delimiter (`<<
  PY`).
  - Multi-command heredoc scripts are rejected by the fallback
  - Non-heredoc redirections (`>`, etc.) are not treated as heredoc prefix
  matches.
  - Complex scripts still fall back to prior behavior rather than
  expanding permissions.
  
  ---------
  
  Co-authored-by: Dylan Hurd <dylan.hurd@openai.com>

  viyatb-oai · 2026-02-10 11:46:40 -08:00
  62d0f302fd
• Always expose view_image and return unsupported image-input error (#11336)

  - Keep `view_image` in the advertised tool list for all models.
  - Return a clear error when the current model does not support image
  inputs, and cover it with a unit test.

  Ahmed Ibrahim · 2026-02-10 11:25:12 -08:00
  6e96e4837e
• feat: add connector capabilities to sub-agents (#11191)
  jif-oai · 2026-02-10 11:53:01 +00:00
  87ccc5bbae
• feat: retain NetworkProxy, when appropriate (#11207)

  As of this PR, `SessionServices` retains a
  `Option<StartedNetworkProxy>`, if appropriate.
  
  Now the `network` field on `Config` is `Option<NetworkProxySpec>`
  instead of `Option<NetworkProxy>`.
  
  Over in `Session::new()`, we invoke `NetworkProxySpec::start_proxy()` to
  create the `StartedNetworkProxy`, which is a new struct that retains the
  `NetworkProxy` as well as the `NetworkProxyHandle`. (Note that `Drop` is
  implemented for `NetworkProxyHandle` to ensure the proxies are shutdown
  when it is dropped.)
  
  The `NetworkProxy` from the `StartedNetworkProxy` is threaded through to
  the appropriate places.
  
  
  ---
  [//]: # (BEGIN SAPLING FOOTER)
  Stack created with [Sapling](https://sapling-scm.com). Best reviewed
  with [ReviewStack](https://reviewstack.dev/openai/codex/pull/11207).
  * #11285
  * __->__ #11207

  Michael Bolin · 2026-02-10 02:09:23 -08:00
  44ebf4588f
• feat(sandbox): enforce proxy-aware network routing in sandbox (#11113)

  ## Summary
  - expand proxy env injection to cover common tool env vars
  (`HTTP_PROXY`/`HTTPS_PROXY`/`ALL_PROXY`/`NO_PROXY` families +
  tool-specific variants)
  - harden macOS Seatbelt network policy generation to route through
  inferred loopback proxy endpoints and fail closed when proxy env is
  malformed
  - thread proxy-aware Linux sandbox flags and add minimal bwrap netns
  isolation hook for restricted non-proxy runs
  - add/refresh tests for proxy env wiring, Seatbelt policy generation,
  and Linux sandbox argument wiring

  viyatb-oai · 2026-02-10 07:44:21 +00:00
  3391e5ea86
• Remove offline fallback for models (#11238)

  # External (non-OpenAI) Pull Request Requirements
  
  Before opening this Pull Request, please read the dedicated
  "Contributing" markdown file or your PR may be closed:
  https://github.com/openai/codex/blob/main/docs/contributing.md
  
  If your PR conforms to our contribution guidelines, replace this text
  with a detailed and high quality description of your changes.
  
  Include a link to a bug report or enhancement request.

  Ahmed Ibrahim · 2026-02-09 16:58:54 -08:00
  a1abd53b6a
• feat: tie shell snapshot to cwd (#11231)

  Fix for this: https://github.com/openai/codex/issues/11223
  
  Basically we tie the shell snapshot to a `cwd` to handle `cwd`-based env
  setups

  jif-oai · 2026-02-09 22:14:39 +00:00
  ffd4bd345c
• feat: search_tool (#10657)

  **Why We Did This**
  - The goal is to reduce MCP tool context pollution by not exposing the
  full MCP tool list up front
  - It forces an explicit discovery step (`search_tool_bm25`) so the model
  narrows tool scope before making MCP calls, which helps relevance and
  lowers prompt/tool clutter.
  
  **What It Changed**
  - Added a new experimental feature flag `search_tool` in
  `core/src/features.rs:90` and `core/src/features.rs:430`.
  - Added config/schema support for that flag in
  `core/config.schema.json:214` and `core/config.schema.json:1235`.
  - Added BM25 dependency (`bm25`) in `Cargo.toml:129` and
  `core/Cargo.toml:23`.
  - Added new tool handler `search_tool_bm25` in
  `core/src/tools/handlers/search_tool_bm25.rs:18`.
  - Registered the handler and tool spec in
  `core/src/tools/handlers/mod.rs:11` and `core/src/tools/spec.rs:780` and
  `core/src/tools/spec.rs:1344`.
  - Extended `ToolsConfig` to carry `search_tool` enablement in
  `core/src/tools/spec.rs:32` and `core/src/tools/spec.rs:56`.
  - Injected dedicated developer instructions for tool-discovery workflow
  in `core/src/codex.rs:483` and `core/src/codex.rs:1976`, using
  `core/templates/search_tool/developer_instructions.md:1`.
  - Added session state to store one-shot selected MCP tools in
  `core/src/state/session.rs:27` and `core/src/state/session.rs:131`.
  - Added filtering so when feature is enabled, only selected MCP tools
  are exposed on the next request (then consumed) in
  `core/src/codex.rs:3800` and `core/src/codex.rs:3843`.
  - Added E2E suite coverage for
  enablement/instructions/hide-until-search/one-turn-selection in
  `core/tests/suite/search_tool.rs:72`,
  `core/tests/suite/search_tool.rs:109`,
  `core/tests/suite/search_tool.rs:147`, and
  `core/tests/suite/search_tool.rs:218`.
  - Refactored test helper utilities to support config-driven tool
  collection in `core/tests/suite/tools.rs:281`.
  
  **Net Behavioral Effect**
  - With `search_tool` **off**: existing MCP behavior (tools exposed
  normally).
  - With `search_tool` **on**: MCP tools start hidden, model must call
  `search_tool_bm25`, and only returned `selected_tools` are available for
  the next model call.

  Anton Panasenko · 2026-02-09 12:53:50 -08:00
  becc3a0424
• Revert "chore: enable sub agents" (#11230)

  Reverts openai/codex#11173

  jif-oai · 2026-02-09 20:22:38 +00:00
  c2bfd1e473