Support disabling tool suggest for specific tools. (#20072)

## Summary
- Add `disable_tool_suggest` to app and plugin config, schema, and
TypeScript output
- Exclude disabled connectors and plugins from tool suggestion discovery
- Persist "never show again" tool-suggestion choices back into
`config.toml`
- Update config docs and add coverage for connector and plugin
suppression

## Testing
- Added and updated unit tests for config persistence and tool-suggest
filtering
- Not run (not requested)

codex-rs/tools/src/lib.rs

@@ -140,6 +140,8 @@ pub use tool_spec::create_local_shell_tool;
 pub use tool_spec::create_tools_json_for_responses_api;
 pub use tool_spec::create_web_search_tool;
 pub use tool_suggest::TOOL_SUGGEST_APPROVAL_KIND_VALUE;
+pub use tool_suggest::TOOL_SUGGEST_PERSIST_ALWAYS_VALUE;
+pub use tool_suggest::TOOL_SUGGEST_PERSIST_KEY;
 pub use tool_suggest::ToolSuggestArgs;
 pub use tool_suggest::ToolSuggestMeta;
 pub use tool_suggest::ToolSuggestResult;

codex-rs/tools/src/tool_suggest.rs

@@ -14,6 +14,8 @@ use crate::DiscoverableToolAction;
 use crate::DiscoverableToolType;
 
 pub const TOOL_SUGGEST_APPROVAL_KIND_VALUE: &str = "tool_suggestion";
+pub const TOOL_SUGGEST_PERSIST_KEY: &str = "persist";
+pub const TOOL_SUGGEST_PERSIST_ALWAYS_VALUE: &str = "always";
 
 #[derive(Debug, Deserialize)]
 pub struct ToolSuggestArgs {
@@ -37,6 +39,7 @@ pub struct ToolSuggestResult {
 #[derive(Debug, Serialize, PartialEq, Eq)]
 pub struct ToolSuggestMeta<'a> {
     pub codex_approval_kind: &'static str,
+    pub persist: &'static str,
     pub tool_type: DiscoverableToolType,
     pub suggest_type: DiscoverableToolAction,
     pub suggest_reason: &'a str,
@@ -111,6 +114,7 @@ fn build_tool_suggestion_meta<'a>(
 ) -> ToolSuggestMeta<'a> {
     ToolSuggestMeta {
         codex_approval_kind: TOOL_SUGGEST_APPROVAL_KIND_VALUE,
+        persist: TOOL_SUGGEST_PERSIST_ALWAYS_VALUE,
         tool_type,
         suggest_type: action_type,
         suggest_reason,

codex-rs/tools/src/tool_suggest_tests.rs

@@ -48,6 +48,7 @@ fn build_tool_suggestion_elicitation_request_uses_expected_shape() {
             request: McpServerElicitationRequest::Form {
                 meta: Some(json!(ToolSuggestMeta {
                     codex_approval_kind: TOOL_SUGGEST_APPROVAL_KIND_VALUE,
+                    persist: TOOL_SUGGEST_PERSIST_ALWAYS_VALUE,
                     tool_type: DiscoverableToolType::Connector,
                     suggest_type: DiscoverableToolAction::Install,
                     suggest_reason: "Plan and reference events from your calendar",
@@ -104,6 +105,7 @@ fn build_tool_suggestion_elicitation_request_for_plugin_omits_install_url() {
             request: McpServerElicitationRequest::Form {
                 meta: Some(json!(ToolSuggestMeta {
                     codex_approval_kind: TOOL_SUGGEST_APPROVAL_KIND_VALUE,
+                    persist: TOOL_SUGGEST_PERSIST_ALWAYS_VALUE,
                     tool_type: DiscoverableToolType::Plugin,
                     suggest_type: DiscoverableToolAction::Install,
                     suggest_reason: "Use the sample plugin's skills and MCP server",
@@ -138,6 +140,7 @@ fn build_tool_suggestion_meta_uses_expected_shape() {
         meta,
         ToolSuggestMeta {
             codex_approval_kind: TOOL_SUGGEST_APPROVAL_KIND_VALUE,
+            persist: TOOL_SUGGEST_PERSIST_ALWAYS_VALUE,
             tool_type: DiscoverableToolType::Connector,
             suggest_type: DiscoverableToolAction::Install,
             suggest_reason: "Find and reference emails from your inbox",