configure-eve-driver

name	configure-eve-driver
description	Use when choosing, editing, or overriding EvE driver settings for codex_smoke, codex_max, or interactive/debug runs.

Configure the EvE Driver

Use the public presets first:

• driver: codex_smoke is for fast runtime validation.
• driver: codex_max is for full non-interactive runs.

Do not add a new preset for a one-off variation. Prefer Hydra overrides until the role is stable enough to document as a supported entrypoint.

Public Surface

Driver presets live in configs/eve/driver/. Keep that directory small:

• codex_smoke.yaml: non-interactive Codex backend, small turn budget, web search disabled.
• codex_max.yaml: non-interactive Codex backend, full-run budget, web search enabled.

Task smoke configs live beside task configs, but keep the root config surface compact:

• circle_packing.smoke is the single tracked circle packing smoke preset.
• By default it validates the ordinary loop.
• Use explicit Hydra overrides from that same entrypoint for judge evaluation or role-specific system prompt smoke paths.

Task smoke configs should use driver: codex_smoke. Do not shrink loop.n_workers_phase2 in the default smoke path; the two-worker default covers Phase 2 multi-worker behavior and optimizer sync.

Normal Commands

Fast smoke:

uv run python -m scaling_evolve.algorithms.eve.runner --config-name=circle_packing.smoke

Judge evaluation smoke:

uv run python -m scaling_evolve.algorithms.eve.runner \
  --config-name=circle_packing.smoke \
  evaluation=circle_packing.judge \
  label=circle-packing-judge-smoke

Role-specific system prompt smoke:

uv run python -m scaling_evolve.algorithms.eve.runner \
  --config-name=circle_packing.smoke \
  evaluation=circle_packing.judge \
  loop.max_iterations=1 \
  label=circle-packing-codex-prompt-smoke \
  +driver.overrides.solver.system_prompt_file=configs/eve/optimizer/circle_packing/prompt/CODEX_SYSTEM_PROMPT.md

Full run:

uv run python -m scaling_evolve.algorithms.eve.runner --config-name=circle_packing

One-off interactive/debug run:

uv run python -m scaling_evolve.algorithms.eve.runner \
  --config-name=circle_packing.smoke \
  driver.driver=codex_tmux \
  driver.open_iterm2=true

If overriding from a full config, keep the backend switch explicit:

uv run python -m scaling_evolve.algorithms.eve.runner \
  --config-name=circle_packing \
  driver.driver=codex_tmux \
  driver.open_iterm2=true

Do not preserve interactive/debug overrides as new YAML presets unless the team decides they are a supported public entry.

Selection Semantics

The driver config lives under the top-level driver: key.

• driver.driver selects the backend and wins over driver.provider.
• driver.provider is accepted for older configs. Avoid it for new public presets.
• If a config inherits from codex_max, changing only driver.provider will not switch the backend because driver.driver=codex_exec is still set.
• Role overrides are shallow merges: EvE starts from the base driver mapping, then overlays driver.overrides.solver or driver.overrides.eval.
• Do not configure driver.overrides.optimizer; the independent optimizer driver role was removed.

Supported backend names are codex_exec and codex_tmux. The public presets should still remain codex_smoke and codex_max.

Driver Options

Common Codex-style fields (codex_exec, codex_tmux):

• driver.executable: command name to launch.
• driver.model: model identifier passed to the backend.
• driver.reasoning_effort: reasoning budget where supported.
• driver.effort_level: accepted as a fallback spelling for Codex-style reasoning effort.
• driver.rollout_max_turns: per-rollout agent turn cap.
• driver.timeout_seconds: per-rollout wall-clock timeout.
• driver.web_search: disabled, cached, or live.
• driver.budget_prompt: whether EvE injects the budget prompt wrapper.
• driver.enable_multi_agent: optional backend feature override.
• driver.personality: optional backend personality override.
• driver.system_prompt_file: repo-relative path to a backend system prompt file.
• driver.model_provider: optional alternate provider id for Codex-style backends.
• driver.model_providers: provider config map; if an entry declares env_key, EvE fails fast when that environment variable is missing.
• driver.token_pricing: per-driver pricing metadata override. Prefer shared pricing in configs/pricing.yaml unless a run needs a local override.

Tmux-only fields (codex_tmux):

• driver.approval_policy: approval policy passed to the interactive backend.
• driver.sandbox_mode: sandbox mode passed to the interactive backend.
• driver.allow_network: when sandbox_mode is omitted, true maps to danger-full-access; otherwise the default is workspace-write.
• driver.pool_size: shared tmux pane pool size when any role uses a tmux backend. Default is the worker count.
• driver.open_iterm2: whether EvE opens the tmux session in a visible terminal window.
• driver.completion_filename: internal tmux completion marker filename.
• driver.instruction_filename: internal tmux instruction filename.

Implementation References

This skill is grounded in the current runtime surfaces:

• src/scaling_evolve/algorithms/eve/runtime/driver.py for backend selection, role overrides, tmux pool creation, sandbox/web-search normalization, provider environment resolution, and pricing config loading.
• src/scaling_evolve/providers/agent/drivers/codex_exec.py for non-interactive Codex fields.
• src/scaling_evolve/providers/agent/drivers/codex_tmux.py for interactive Codex/tmux fields.
• src/scaling_evolve/providers/agent/config.py for persistent session provider config validation.