Skip to content

core: allow restricting subagent environments#31662

Draft
frantic-openai wants to merge 4 commits into
mainfrom
codex/subagent-environment-ids
Draft

core: allow restricting subagent environments#31662
frantic-openai wants to merge 4 commits into
mainfrom
codex/subagent-environment-ids

Conversation

@frantic-openai

Copy link
Copy Markdown

Summary

  • Add optional environment_ids to v1 and v2 spawn_agent.
  • Validate explicit child selections against ready parent-turn environments, preserve parent order, and support an empty selection.
  • Filter fork-inherited selected capability roots to the same environment subset.
  • Add schema, selection, capability-root, and remote/local integration coverage.

Why

A root thread with both local and remote environments currently passes every selected environment to each child. That means a child intended to work only on Windows can still explicitly target local.

This MVP lets the parent spawn a child with, for example, environment_ids: ["windows"]. While that child is loaded, tool calls naming an omitted environment are rejected.

Known limitation

This is a spawn-time, loaded-session restriction. Environment selections are not yet persisted for cold resume; a V2 residency reload or later cold resume reconstructs the thread from default environment selections, so include_local may reattach local. Persisting the subset across resume is a follow-up.

Validation

  • just test -p codex-core spawn_agent_environment_ids (5 passed)
  • just test -p codex-core spawn_agent_tool_v (2 passed)
  • just test -p codex-core --lib spawn_agent_restricted_fork_filters_selected_capability_roots (1 passed)
  • just test -p codex-core --test all spawned_agent_can_restrict_inherited_environments (1 passed locally; body is guarded when no remote fixture is available)
  • just fix -p codex-core
  • just fmt
  • git diff --check

I also ran the full just test -p codex-core suite earlier: 2813 passed, 137 failed, and 18 skipped. The failures were unrelated local-host fixture failures such as missing codex-code-mode-host / test_stdio_server and sandbox/PTY environment failures.

@frantic-openai frantic-openai force-pushed the codex/subagent-environment-ids branch from 3a39a35 to 3967f0d Compare July 9, 2026 18:14
frantic-openai added a commit that referenced this pull request Jul 9, 2026
frantic-openai added a commit that referenced this pull request Jul 9, 2026
@frantic-openai frantic-openai force-pushed the codex/subagent-environment-ids branch from 5bacd5e to 57cdf8b Compare July 9, 2026 19:20
parent_thread_id: Some(session.thread_id),
environments: Some(turn.environments.to_selections()),
environments: Some(environments),
restricted_environment_ids: args.environment_ids.clone(),

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we persist this selection before exposing it? V2 normally unloads completed agents, and a later follow-up reloads them from default environment selections. A ["windows"] child for example therefore regains local during ordinary use, which defeats the restriction

.await?;
apply_spawn_agent_runtime_overrides(&mut config, turn.as_ref())?;
let environments =
spawn_agent_environment_selections(turn.as_ref(), args.environment_ids.as_deref())?;

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we validate environment_ids before emitting the v1 InProgress item

.get_thread(child_thread_id)
.await
.expect("child thread should be registered");
assert_eq!(

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we cover this through an actual child model step? This assertion checks the stored vector, but not that fork-retained skills/MCP context from the omitted environment disappears from the outbound child request

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants