Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions codex-rs/feature-specs/mcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,10 +118,10 @@ interaction, and model-turn routing through MCP clients.
#### Test cases

- MCP client tool-call behavior is covered part 1: codex-rs/core/tests/suite/mcp__client_tool_calls.rs:local_stdio_server_uses_runtime_fallback_cwd_when_config_omits_cwd,remote_stdio_env_var_source_does_not_copy_local_env,stdio_image_responses_are_sanitized_for_text_only_model,stdio_image_responses_preserve_original_detail_metadata,stdio_image_responses_round_trip,stdio_mcp_parallel_tool_calls_default_false_runs_serially,stdio_mcp_parallel_tool_calls_opt_in_runs_concurrently,stdio_mcp_read_only_tool_calls_run_concurrently_without_server_opt_in
- MCP client tool-call behavior is covered part 2: codex-rs/core/tests/suite/mcp__client_tool_calls.rs:stdio_mcp_tool_call_includes_sandbox_state_meta,stdio_server_propagates_explicit_local_env_var_source,stdio_server_propagates_whitelisted_env_vars,stdio_server_round_trip,stdio_server_uses_configured_cwd_before_runtime_fallback,streamable_http_tool_call_round_trip,streamable_http_with_oauth_round_trip
- MCP client tool-call behavior is covered part 2: codex-rs/core/tests/suite/mcp__client_tool_calls.rs:openai_form_capability_is_advertised_to_mcp_servers,openai_form_capability_is_not_advertised_by_default,openai_form_capability_updates_for_loaded_thread,shutdown_cancels_startup_prewarm_waiting_for_mcp_startup,stdio_image_responses_resize_large_image,stdio_mcp_tool_call_includes_sandbox_state_meta,stdio_server_propagates_explicit_local_env_var_source,stdio_server_propagates_whitelisted_env_vars,stdio_server_round_trip,stdio_server_uses_configured_cwd_before_runtime_fallback,streamable_http_tool_call_round_trip,streamable_http_with_oauth_round_trip
- MCP hook interaction is covered: codex-rs/core/tests/suite/mcp__hooks.rs:post_tool_use_records_mcp_tool_payload_and_context_with_legacy_prefixed_names,post_tool_use_records_mcp_tool_payload_and_context_with_non_prefixed_names,pre_tool_use_blocks_mcp_tool_before_execution_with_legacy_prefixed_names,pre_tool_use_blocks_mcp_tool_before_execution_with_non_prefixed_names,pre_tool_use_rewrites_mcp_tool_before_execution
- OpenAI file MCP behavior is covered: codex-rs/core/tests/suite/mcp__openai_file.rs:codex_apps_file_params_upload_local_paths_before_mcp_tool_call
- MCP turn metadata is covered: codex-rs/core/tests/suite/mcp__turn_metadata.rs:approved_mcp_tool_call_metadata_records_prior_user_input_request,mcp_tool_call_metadata_records_prior_request_user_input_tool
- OpenAI file MCP behavior is covered: codex-rs/core/tests/suite/mcp__openai_file.rs:codex_apps_file_params_pass_uploaded_file_to_post_tool_use_hook,codex_apps_file_params_upload_environment_files_before_mcp_tool_call
- MCP turn metadata is covered: codex-rs/core/tests/suite/mcp__turn_metadata.rs:apps_default_prompt_with_auto_review_routes_actual_mcp_approval_to_guardian,approved_mcp_tool_call_metadata_records_prior_user_input_request,mcp_tool_call_metadata_records_prior_request_user_input_tool

### app-server-api (app-server API behavior)

Expand All @@ -132,8 +132,8 @@ request/response behavior.

#### Test cases

- MCP resource API behavior is covered: codex-rs/app-server/tests/suite/v2/mcp__resource.rs:mcp_resource_read_returns_error_for_unknown_thread,mcp_resource_read_returns_resource_contents,mcp_resource_read_returns_resource_contents_without_thread
- MCP elicitation API behavior is covered: codex-rs/app-server/tests/suite/v2/mcp__server_elicitation.rs:mcp_server_elicitation_round_trip
- MCP resource API behavior is covered: codex-rs/app-server/tests/suite/v2/mcp__resource.rs:disabled_orchestrator_skills_do_not_expose_skills_namespace,local_executor_does_not_expose_orchestrator_skills,mcp_resource_read_returns_error_for_unknown_thread,mcp_resource_read_returns_resource_contents,mcp_resource_read_returns_resource_contents_without_thread,orchestrator_skill_can_read_referenced_resource_without_an_executor
- MCP elicitation API behavior is covered: codex-rs/app-server/tests/suite/v2/mcp__server_elicitation.rs:mcp_server_form_elicitation_round_trip,mcp_server_openai_form_elicitation_round_trip,openai_form_capability_follows_the_turn_starting_connection
- MCP server status API behavior is covered: codex-rs/app-server/tests/suite/v2/mcp__server_status.rs:mcp_server_status_list_keeps_tools_for_sanitized_name_collisions,mcp_server_status_list_returns_raw_server_and_tool_names,mcp_server_status_list_tools_and_auth_only_skips_slow_inventory_calls,mcp_server_status_list_uses_thread_project_local_config
- MCP tool API behavior is covered: codex-rs/app-server/tests/suite/v2/mcp__tool.rs:mcp_server_tool_call_forwards_url_elicitation,mcp_server_tool_call_returns_error_for_unknown_thread,mcp_server_tool_call_returns_tool_result,mcp_server_tool_call_round_trips_elicitation,mcp_tool_call_completion_notification_contains_truncated_large_result

Expand Down Expand Up @@ -170,7 +170,7 @@ state, and elicitation form rendering and response state.
#### Test cases

- MCP startup warning rendering and interaction state are covered part 1: codex-rs/tui/src/chatwidget/tests/mcp__startup.rs:app_server_mcp_startup_after_lag_can_settle_without_starting_updates,app_server_mcp_startup_after_lag_includes_runtime_servers_with_expected_set,app_server_mcp_startup_after_lag_preserves_partial_terminal_only_round,app_server_mcp_startup_failure_renders_warning_history,app_server_mcp_startup_lag_settles_startup_and_ignores_late_updates,app_server_mcp_startup_next_round_after_lag_can_settle_without_starting_updates,app_server_mcp_startup_next_round_discards_stale_terminal_updates,app_server_mcp_startup_next_round_keeps_terminal_statuses_after_starting
- MCP startup warning rendering and interaction state are covered part 2: codex-rs/tui/src/chatwidget/tests/mcp__startup.rs:app_server_mcp_startup_next_round_with_empty_expected_servers_reactivates,mcp_startup_complete_does_not_clear_running_task,mcp_startup_complete_preserves_review_status,mcp_startup_dedupes_same_round_duplicate_failure_warning,mcp_startup_failure_restores_running_status_header,mcp_startup_header_booting_snapshot,turn_start_preserves_active_mcp_startup_header,turn_start_replaces_idle_completed_mcp_startup_header
- MCP startup warning rendering and interaction state are covered part 2: codex-rs/tui/src/chatwidget/tests/mcp__startup.rs:app_server_mcp_startup_next_round_with_empty_expected_servers_reactivates,mcp_startup_complete_does_not_clear_running_task,mcp_startup_complete_preserves_review_status,mcp_startup_dedupes_same_round_duplicate_failure_warning,mcp_startup_failure_restores_running_status_header,mcp_startup_header_booting_snapshot,mcp_startup_ignores_status_for_other_thread,turn_start_preserves_active_mcp_startup_header,turn_start_replaces_idle_completed_mcp_startup_header
- MCP elicitation form parsing and approval metadata are covered: codex-rs/tui/src/bottom_pane/mcp__server_elicitation_tests.rs:empty_object_schema_uses_approval_actions,empty_tool_approval_schema_uses_approval_actions,parses_boolean_form_request,plugin_tool_suggestion_meta_without_install_url_is_parsed_into_request_payload,tool_approval_display_params_prefer_explicit_display_order,tool_suggestion_meta_is_parsed_into_request_payload,unsupported_numeric_form_falls_back
- MCP elicitation response and queue state are covered: codex-rs/tui/src/bottom_pane/mcp__server_elicitation_tests.rs:ctrl_c_cancels_elicitation,empty_tool_approval_schema_always_allow_sets_persist_meta,empty_tool_approval_schema_session_choice_sets_persist_meta,horizontal_list_keys_move_between_select_fields,queues_requests_fifo,resolved_request_dismisses_overlay_without_emitting_events,submit_sends_accept_with_typed_content
- MCP elicitation form rendering is covered: codex-rs/tui/src/bottom_pane/mcp__server_elicitation_tests.rs:approval_form_tool_approval_snapshot,approval_form_tool_approval_with_param_summary_snapshot,approval_form_tool_approval_with_persist_options_snapshot,boolean_form_snapshot,message_only_form_snapshot,message_only_form_with_persist_options_snapshot
Expand Down Expand Up @@ -208,9 +208,9 @@ by the MCP feature.

- RMCP process cleanup behavior is covered: codex-rs/rmcp-client/tests/mcp__process_group_cleanup.rs:drop_kills_wrapper_process_group,shutdown_kills_initialized_stdio_server_with_in_flight_operation
- RMCP resource behavior is covered: codex-rs/rmcp-client/tests/mcp__resources.rs:rmcp_client_can_list_and_read_resources
- RMCP streamable HTTP OAuth startup behavior is covered: codex-rs/rmcp-client/tests/mcp__streamable_http_oauth_startup.rs:oauth_startup_child,refreshes_expired_persisted_token_before_initialize
- RMCP streamable HTTP OAuth startup behavior is covered: codex-rs/rmcp-client/tests/mcp__streamable_http_oauth_startup.rs:oauth_startup_child,persisted_credentials_auth_status_child,refreshes_expired_persisted_token_before_initialize,reports_auth_status_for_persisted_credentials
- RMCP streamable HTTP remote behavior is covered: codex-rs/rmcp-client/tests/mcp__streamable_http_remote.rs:streamable_http_remote_client_round_trips_through_exec_server
- RMCP streamable HTTP recovery behavior is covered: codex-rs/rmcp-client/tests/mcp__streamable_http_recovery.rs:streamable_http_401_does_not_trigger_recovery,streamable_http_403_finds_bearer_challenge_in_later_header_value,streamable_http_403_scope_challenge_returns_insufficient_scope,streamable_http_404_recovery_only_retries_once,streamable_http_404_session_expiry_recovers_and_retries_once,streamable_http_non_session_failure_does_not_trigger_recovery
- RMCP streamable HTTP recovery behavior is covered: codex-rs/rmcp-client/tests/mcp__streamable_http_recovery.rs:streamable_http_401_does_not_trigger_recovery,streamable_http_403_finds_bearer_challenge_in_later_header_value,streamable_http_403_scope_challenge_returns_insufficient_scope,streamable_http_404_recovery_only_retries_once,streamable_http_404_session_expiry_recovers_and_retries_once,streamable_http_initialize_retries_json_rpc_transient_status,streamable_http_initialize_retries_remote_no_response_error,streamable_http_initialize_retries_transient_http_status,streamable_http_non_session_failure_does_not_trigger_recovery,streamable_http_retries_initialized_notification_status,streamable_http_session_recovery_retries_initialize_failure,streamable_http_tools_list_retries_json_rpc_transient_status,streamable_http_tools_list_retries_transient_http_status

### codex-api (Codex API client and protocol behavior)

Expand Down
Loading
Loading