{ "schema_version": "settings-catalog.v1", "generated_by": "cmd/settings-catalog", "domains": [ { "domain": "profiles", "resource_type": "agent_profile", "label": "Agent profiles", "description": "Saved agent profile settings used for future sessions.", "owner": "agent-settings", "scope": "resource", "target": { "scope": "resource", "requires_resource_id": true, "allows_workspace_id": true }, "fields": [ { "key": "agent_profile.name", "field_path": "name", "label": "name", "description": "Profile display name.", "json_type": "string", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.model", "field_path": "model", "label": "model", "description": "Preferred model; empty uses the agent default.", "json_type": "string", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.fallback_model", "field_path": "fallback_model", "label": "fallback_model", "description": "Optional fallback model.", "json_type": "string", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.auto_fallback", "field_path": "auto_fallback", "label": "auto_fallback", "description": "Enable automatic fallback behavior.", "json_type": "boolean", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.require_exact_model", "field_path": "require_exact_model", "label": "require_exact_model", "description": "Require the configured model to be advertised and applied.", "json_type": "boolean", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.mode", "field_path": "mode", "label": "mode", "description": "Agent operating mode.", "json_type": "string", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.config_options", "field_path": "config_options", "label": "config_options", "description": "Typed provider configuration options.", "json_type": "object", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "replacement": true, "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.allow_indexing", "field_path": "allow_indexing", "label": "allow_indexing", "description": "Legacy indexing permission field.", "json_type": "boolean", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.auto_approve", "field_path": "auto_approve", "label": "auto_approve", "description": "Automatically approve agent permissions.", "json_type": "boolean", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.cli_passthrough", "field_path": "cli_passthrough", "label": "cli_passthrough", "description": "Allow CLI passthrough mode.", "json_type": "boolean", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.enabled", "field_path": "enabled", "label": "enabled", "description": "Allow this profile for new work.", "json_type": "boolean", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.cli_flags", "field_path": "cli_flags", "label": "cli_flags", "description": "Complete replacement list of CLI flags.", "json_type": "array", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "replacement": true, "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.env_vars", "field_path": "env_vars", "label": "env_vars", "description": "Complete replacement list of environment variables.", "json_type": "array", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "sensitive": true, "replacement": true, "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.command_prefix", "field_path": "command_prefix", "label": "command_prefix", "description": "Optional launcher command prefix.", "json_type": "string", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "change_timing": "future_sessions", "settings_href": "/settings/agents" }, { "key": "agent_profile.dynamic", "field_path": "dynamic", "label": "dynamic", "description": "Versioned dynamic routing document.", "json_type": "object", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile", "authority": "org.config.manage", "replacement": true, "change_timing": "future_sessions", "settings_href": "/settings/agents" } ], "operations": [ { "name": "update", "binding": "agent-settings.profile.update", "authority": "org.config.manage" } ], "settings_href": "/settings/agents" }, { "domain": "profiles", "resource_type": "agent_profile_mcp", "label": "Profile MCP documents", "description": "Separate MCP server settings for a saved agent profile.", "owner": "agent-settings", "scope": "resource", "target": { "scope": "resource", "requires_resource_id": true }, "fields": [ { "key": "agent_profile_mcp.enabled", "field_path": "enabled", "label": "MCP enabled", "description": "Enable the profile MCP document.", "json_type": "boolean", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile-mcp", "authority": "org.config.manage" }, { "key": "agent_profile_mcp.servers", "field_path": "servers", "label": "MCP servers", "description": "Complete replacement map of validated MCP servers.", "json_type": "object", "support": "supported", "classification": "writable", "owner": "agent-settings", "writable": true, "validator": "agent-settings.profile-mcp", "authority": "org.config.manage", "sensitive": true, "replacement": true }, { "key": "agent_profile_mcp.meta", "field_path": "meta", "label": "MCP metadata", "description": "Preserved metadata from the MCP document.", "json_type": "object", "support": "read_only", "classification": "computed", "owner": "agent-settings", "sensitive": true } ], "operations": [ { "name": "update", "binding": "agent-settings.profile-mcp.update", "authority": "org.config.manage" } ], "settings_href": "/settings/agents" } ], "mutable_fields": { "agent_profile": [ "allow_indexing", "auto_approve", "auto_fallback", "cli_flags", "cli_passthrough", "command_prefix", "config_options", "dynamic", "enabled", "env_vars", "fallback_model", "mode", "model", "name", "require_exact_model" ], "user_settings": [ "agent_generated_task_titles", "app_status_bar_enabled", "app_status_bar_order", "auto_focus_new_tasks", "azure_devops_browse_preferences", "changes_panel_layout", "chat_submit_key", "confirm_task_archive", "default_editor_id", "default_utility_agent_id", "default_utility_agent_profile_id", "default_utility_model", "enable_preview_on_click", "github_default_query_presets", "github_saved_presets", "gitlab_saved_presets", "initial_setup_complete", "jira_saved_views", "jira_task_presets", "kanban_hidden_step_ids", "kanban_priority_filter_tokens", "kanban_sort", "kanban_view_mode", "keyboard_shortcuts", "last_seen_display", "lsp_auto_install_languages", "lsp_auto_start_languages", "lsp_server_configs", "lsp_status_location", "mcp_task_agent_profile_default", "preferred_shell", "prevent_auto_start_agent_on_open", "quick_chat_tab_order_by_workspace", "release_notes_last_seen_version", "repository_ids", "resolve_session_hostnames", "review_auto_mark_on_scroll", "saved_layouts", "show_anchored_prompt_bar", "show_release_notification", "show_scroll_to_last_prompt", "show_scroll_to_start", "show_todo_list_panel", "show_todo_list_panel_only_when_not_empty", "show_transcript_auto_scroll_control", "sidebar_active_view_id", "sidebar_draft", "sidebar_hover_delay_ms", "sidebar_hover_enabled", "sidebar_task_color_automation", "sidebar_task_color_patch", "sidebar_task_colors", "sidebar_task_prefs", "sidebar_views", "startup_page", "system_metrics_display", "task_create_last_used", "tasks_list_group", "tasks_list_show_details", "tasks_list_sort", "terminal_font_family", "terminal_font_size", "terminal_link_behavior", "thread_active_view_id", "thread_view_draft", "thread_views", "unread_divider", "workflow_filter_id", "workflow_ids_with_auto_hide_empty_steps", "workspace_id" ] } }