core-agent-ide/codex-rs/app-server-protocol/src
Charley Cunningham e6662d6387
app-server: treat null mode developer instructions as built-in defaults (#10983)
## Summary
- make `turn/start` normalize
`collaborationMode.settings.developer_instructions: null` to the
built-in instructions for the selected mode
- prevent app-server clients from accidentally clearing mode-switch
developer instructions by sending `null`
- document this behavior in the v2 protocol and app-server docs

## What changed
- `codex-rs/app-server/src/codex_message_processor.rs`
  - added a small `normalize_turn_start_collaboration_mode` helper
  - in `turn_start`, apply normalization before `OverrideTurnContext`
- `codex-rs/app-server/tests/suite/v2/turn_start.rs`
- extended `turn_start_accepts_collaboration_mode_override_v2` to assert
the outgoing request includes default-mode instruction text when the
client sends `developer_instructions: null`
- `codex-rs/app-server-protocol/src/protocol/v2.rs`
- clarified `TurnStartParams.collaboration_mode` docs:
`settings.developer_instructions: null` means use built-in mode
instructions
- regenerated schema fixture:
- `codex-rs/app-server-protocol/schema/typescript/v2/TurnStartParams.ts`
- docs:
  - `codex-rs/app-server/README.md`
  - `codex-rs/docs/codex_mcp_interface.md`
2026-02-07 12:59:41 -08:00
..
bin feat: add --experimental to generate-ts (#10402) 2026-02-02 20:30:01 +00:00
protocol app-server: treat null mode developer instructions as built-in defaults (#10983) 2026-02-07 12:59:41 -08:00
experimental_api.rs feat: experimental flags (#10231) 2026-02-02 11:06:50 +00:00
export.rs Mark Config.apps as experimental, correct schema generation issue (#10938) 2026-02-06 16:30:41 -08:00
jsonrpc_lite.rs [app-server] remove serde(skip_serializing_if = "Option::is_none") annotations (#5939) 2025-10-30 18:18:53 +00:00
lib.rs feat: add --experimental to generate-ts (#10402) 2026-02-02 20:30:01 +00:00
schema_fixtures.rs feat: replace custom mcp-types crate with equivalents from rmcp (#10349) 2026-02-02 17:41:55 -08:00