Add default agent configuration for agentic search

- in CLI settings, add section 'Defaults', allow setting a default agent for 'Agentic Search', and respect user selection to skip the quick pick
- on Agent, make 'name' and 'agent' required properties and skip redundant checks and Non-Null Assertion Operator
- on agent, make 'name' and 'agent' required properties

├── apps
│   └── editor
│       ├── package.json
│       └── src
│           ├── commands
│           │   └── agentic-search-command
│           │       └── agentic-search-command.ts
│           ├── constants
│           │   ├── instructions.ts
│           │   └── state-keys.ts
│           ├── features
│           │   └── agentic-search
│           │       └── agentic-search.ts
│           ├── services
│           │   └── providers-manager.ts
│           ├── types
│           │   └── cli-configuration.ts
│           ├── utils
│           │   ├── agentic-cli-invocation
│           │   │   └── invoke-agentic-cli.ts
│           │   └── cli-configuration-format-converters.ts
│           └── views
│               ├── prompt
│               │   ├── backend
│               │   │   ├── message-handlers
│               │   │   │   ├── handle-agentic-search
│               │   │   │   │   └── handle-agentic-search.ts
│               │   │   │   └── handle-voice-input.ts
│               │   │   └── prompt-view-provider.ts
│               │   ├── frontend
│               │   │   └── Main
│               │   │       ├── Main.tsx
│               │   │       └── MainView
│               │   │           ├── MainView.tsx
│               │   │           └── hooks
│               │   │               └── use-last-choice-tooltip.ts
│               │   └── types
│               │       └── messages.ts
│               ├── settings
│               │   ├── backend
│               │   │   ├── message-handlers
│               │   │   │   ├── handle-get-api-configurations.ts
│               │   │   │   ├── handle-select-default-api-configuration.ts
│               │   │   │   ├── handle-set-default-api-configuration.ts
│               │   │   │   └── index.ts
│               │   │   └── settings-view-provider.ts
│               │   ├── frontend
│               │   │   ├── Home
│               │   │   │   ├── Home.tsx
│               │   │   │   └── sections
│               │   │   │       ├── ApiSection.tsx
│               │   │   │       └── CliSection.tsx
│               │   │   ├── Settings.tsx
│               │   │   └── i18n
│               │   │       ├── translations
│               │   │       │   ├── actions.ts
│               │   │       │   ├── agent.ts
│               │   │       │   ├── api.ts
│               │   │       │   ├── common.ts
│               │   │       │   ├── edit-provider-form.ts
│               │   │       │   ├── edit-template-form.ts
│               │   │       │   ├── general.ts
│               │   │       │   ├── index.ts
│               │   │       │   ├── sections.ts
│               │   │       │   └── web.ts
│               │   │       └── use-translation.tsx
│               │   └── types
│               │       └── messages.ts
│               └── shared
│                   ├── actions
│                   │   ├── agent
│                   │   │   ├── create.ts
│                   │   │   ├── delete.ts
│                   │   │   ├── reorder.ts
│                   │   │   └── update.ts
│                   │   └── api
│                   │       ├── create
│                   │       │   └── interactions
│                   │       │       └── verify-model.ts
│                   │       └── update
│                   │           └── update.ts
│                   ├── forms
│                   │   └── EditCliConfigurationForm
│                   │       └── EditCliConfigurationForm.tsx
│                   └── types
│                       └── api-features.ts
└── packages
    └── ui
        └── src
            └── components
                └── editor
                    └── settings
                        └── DefaultConfigurationSelector
                            └── DefaultConfigurationSelector.tsx

Author: robertpiosik

apps/editor/package.json

@@ -1039,8 +1039,15 @@
               },
               "isPinned": {
                 "type": "boolean"
+              },
+              "isDefaultForAgenticSearch": {
+                "type": "boolean"
               }
-            }
+            },
+            "required": [
+              "name",
+              "agent"
+            ]
           }
         },
         "codeWebChat.chatbots": {

apps/editor/src/features/agentic-search/agentic-search.ts

@@ -62,6 +62,13 @@ export const agentic_search = async (params: {
       }
     )
 
+    const config = vscode.workspace.getConfiguration('codeWebChat')
+    const agent_configs = config.get<any[]>('agents', []) || []
+    const default_agent = agent_configs.find(c => c.isDefaultForAgenticSearch)
+    
+    const use_quick_pick = !default_agent
+    const agent_configuration_name = default_agent ? default_agent.name : undefined
+
     const last_used_agent_config_name =
       params.extension_context.workspaceState.get<string>(
         LAST_USED_AGENTIC_SEARCH_AGENT_STATE_KEY
@@ -78,6 +85,7 @@ export const agentic_search = async (params: {
         'utils.agentic-cli-invocation.agent.waiting-for-agent'
       ),
       last_used_agent_config_name,
+      agent_configuration_name,
       on_agent_selected: (name: string) => {
         params.extension_context.workspaceState.update(
           LAST_USED_AGENTIC_SEARCH_AGENT_STATE_KEY,
@@ -91,7 +99,7 @@ export const agentic_search = async (params: {
       last_selected_workspace_state_key:
         LAST_SELECTED_WORKSPACE_IN_AGENTIC_SEARCH_STATE_KEY,
       show_back_button: true,
-      use_quick_pick: true,
+      use_quick_pick,
       build_prompt: async () => {
         const { instructions: processed_query, skill_definitions } =
           await replace_symbols({

apps/editor/src/types/cli-configuration.ts

@@ -1,6 +1,6 @@
 export type CliConfiguration = {
-  name?: string
-  agent?: string
+  name: string
+  agent: string
   flags?: string
   is_pinned?: boolean
 }

apps/editor/src/utils/cli-configuration-format-converters.ts

@@ -2,8 +2,8 @@ import { AGENTS } from '@/constants/agents'
 import { CliConfiguration } from '@/types/cli-configuration'
 
 export type ConfigAgentConfigurationFormat = {
-  name?: string
-  agent?: keyof typeof AGENTS
+  name: string
+  agent: keyof typeof AGENTS
   flags?: string
   isPinned?: boolean
 }
@@ -23,7 +23,7 @@ export const ui_agent_configuration_to_config_format = (
   agent_configuration: CliConfiguration
 ): ConfigAgentConfigurationFormat => {
   return {
-    name: agent_configuration.name || undefined,
+    name: agent_configuration.name,
     agent: agent_configuration.agent as keyof typeof AGENTS,
     flags: agent_configuration.flags,
     isPinned: agent_configuration.is_pinned

apps/editor/src/views/prompt/backend/prompt-view-provider.ts

@@ -941,7 +941,7 @@ export class PromptViewProvider implements vscode.WebviewViewProvider {
             this.extension_context.globalState.get<string>(key)
           if (last_selected) {
             if (
-              agent_configurations_ui.some((p) => (p.name ?? '') == last_selected)
+              agent_configurations_ui.some((p) => p.name == last_selected)
             ) {
               selected_name = last_selected
             }

apps/editor/src/views/prompt/frontend/Main/MainView/MainView.tsx

@@ -278,22 +278,22 @@ export const MainView: React.FC<Props> = (props) => {
     })
 
   const agent_configurations_ui: UiConfigurations.Configuration[] =
-    props.agent_configurations.map((c, index) => {
-      const is_unnamed = !c.name || /^\(\d+\)$/.test(c.name.trim())
+    props.agent_configurations.map((c) => {
+      const is_unnamed = /^\(\d+\)$/.test(c.name.trim())
       const display_name = is_unnamed
-        ? c.agent!
-        : c.name!.replace(/ \(\d+\)$/, '')
+        ? c.agent
+        : c.name.replace(/ \(\d+\)$/, '')
 
       const details: string[] = []
       if (is_unnamed) {
         if (c.flags) details.push(c.flags)
-      } else if (c.agent) {
+      } else {
         details.push(c.agent)
         if (c.flags) details.push(c.flags)
       }
 
       return {
-        id: c.name ?? `unnamed-${index}`,
+        id: c.name,
         title: display_name,
         details,
         is_pinned: c.is_pinned
@@ -753,7 +753,7 @@ export const MainView: React.FC<Props> = (props) => {
           on_reorder={(reordered) => {
             const new_agent_configurations = reordered.map((c) => {
               return props.agent_configurations.find(
-                (p, i) => (p.name ?? `unnamed-${i}`) == c.id
+                (p) => p.name == c.id
               )!
             })
             props.on_agent_configurations_reorder(new_agent_configurations)

apps/editor/src/views/prompt/frontend/Main/MainView/hooks/use-last-choice-tooltip.ts

@@ -93,14 +93,12 @@ export const use_last_choice_tooltip = (params: {
           (c) => c.name == params.selected_agent_configuration_name
         )
         if (configuration) {
-          const is_unnamed =
-            !configuration.name ||
-            /^\(\d+\)$/.test(configuration.name.trim())
+          const is_unnamed = /^\(\d+\)$/.test(configuration.name.trim())
           const display_name = is_unnamed
-            ? configuration.agent!
-            : configuration.name!.replace(/ \(\d+\)$/, '')
+            ? configuration.agent
+            : configuration.name.replace(/ \(\d+\)$/, '')
           const details: string[] = []
-          if (!is_unnamed && configuration.agent) {
+          if (!is_unnamed) {
             details.push(configuration.agent)
           }
           if (configuration.flags) {

apps/editor/src/views/settings/backend/settings-view-provider.ts

@@ -116,7 +116,10 @@ export class SettingsViewProvider {
         )
         .map((config: any) => {
           return config_agent_configuration_to_ui_format(config)
-        })
+        }),
+      defaults: {
+        'agentic-search': agent_configurations_config.find((c: any) => c.isDefaultForAgenticSearch)?.name || null
+      }
     })
   }
 
@@ -303,6 +306,78 @@ export class SettingsViewProvider {
           await handle_pick_api_model(this, message)
         } else if (message.command == 'PICK_API_REASONING_EFFORT') {
           await handle_pick_api_reasoning_effort(this, message)
+        } else if (message.command == 'SET_DEFAULT_AGENT_CONFIGURATION') {
+          const config = vscode.workspace.getConfiguration('codeWebChat')
+          const agent_configs = config.get<any[]>('agents', []) || []
+          const updated = agent_configs.map((c) => {
+            const new_c = { ...c }
+            if (message.cli_feature === 'agentic-search') {
+              if (c.name === message.agent_configuration_name) {
+                new_c.isDefaultForAgenticSearch = true
+              } else {
+                delete new_c.isDefaultForAgenticSearch
+              }
+            }
+            return new_c
+          })
+          await config.update('agents', updated, vscode.ConfigurationTarget.Global)
+        } else if (message.command == 'SELECT_DEFAULT_AGENT_CONFIGURATION') {
+          const config = vscode.workspace.getConfiguration('codeWebChat')
+          const agent_configs = config.get<any[]>('agents', []) || []
+          if (agent_configs.length === 0) return
+
+          const items = agent_configs.map((c) => {
+            const is_unnamed = /^\(\d+\)$/.test(c.name.trim())
+            const display_name = is_unnamed ? c.agent : c.name.replace(/ \(\d+\)$/, '')
+
+            return {
+              label: display_name,
+              description: c.agent === display_name ? undefined : c.agent,
+              agent_configuration_name: c.name
+            }
+          })
+
+          const quick_pick = vscode.window.createQuickPick<
+            vscode.QuickPickItem & { agent_configuration_name: string }
+          >()
+          quick_pick.items = items
+          quick_pick.title = 'Select default agent'
+          quick_pick.placeholder = 'Select agent'
+
+          const close_button: vscode.QuickInputButton = {
+            iconPath: new vscode.ThemeIcon('close'),
+            tooltip: 'Close'
+          }
+          quick_pick.buttons = [close_button]
+
+          quick_pick.onDidTriggerButton((button) => {
+            if (button === close_button) {
+              quick_pick.hide()
+            }
+          })
+
+          quick_pick.onDidAccept(async () => {
+            const selected = quick_pick.selectedItems[0]
+            quick_pick.hide()
+
+            if (selected) {
+              const updated = agent_configs.map((c) => {
+                const new_c = { ...c }
+                if (message.cli_feature === 'agentic-search') {
+                  if (c.name === selected.agent_configuration_name) {
+                    new_c.isDefaultForAgenticSearch = true
+                  } else {
+                    delete new_c.isDefaultForAgenticSearch
+                  }
+                }
+                return new_c
+              })
+              await config.update('agents', updated, vscode.ConfigurationTarget.Global)
+            }
+          })
+
+          quick_pick.onDidHide(() => quick_pick.dispose())
+          quick_pick.show()
         } else if (message.command == 'GET_IS_MODERN_UI') {
           this._send_is_modern_ui()
         }

apps/editor/src/views/settings/frontend/Home/Home.tsx

@@ -31,6 +31,7 @@ export type NavItem =
   | 'section:api:group:system-instructions'
   | 'section:cli'
   | 'section:cli:group:agents'
+  | 'section:cli:group:agent-defaults'
 
 export type NavConfigItem = { id: NavItem; label: TranslationKey }
 
@@ -86,6 +87,10 @@ export const NAV_ITEMS_CONFIG: NavConfigItem[] = [
   {
     id: 'section:cli:group:agents',
     label: 'agents.configurations.title'
+  },
+  {
+    id: 'section:cli:group:agent-defaults',
+    label: 'cli.default-configurations.title'
   }
 ]
 
@@ -125,6 +130,9 @@ type Props = {
   on_edit_agent_configuration: (id: string) => void
   on_delete_agent_configuration: (name: string) => void
   on_toggle_pinned_agent_configuration: (config: CliConfiguration) => void
+  agent_defaults: Record<string, string | null>
+  on_set_default_agent_configuration: (cli_feature: string, name: string | null) => void
+  on_select_default_agent_configuration: (cli_feature: string) => void
   on_commit_instructions_change: (instructions: string) => void
   on_attach_ascii_tree_of_context_change: (
     value: 'ask' | 'always' | 'never'
@@ -417,6 +425,9 @@ export const Home: React.FC<Props> = (props) => {
           on_toggle_pinned_agent_configuration={
             props.on_toggle_pinned_agent_configuration
           }
+          agent_defaults={props.agent_defaults}
+          on_set_default_agent_configuration={props.on_set_default_agent_configuration}
+          on_select_default_agent_configuration={props.on_select_default_agent_configuration}
         />
       </UiLayout>
     </div>

apps/editor/src/views/settings/frontend/Home/sections/CliSection.tsx

@@ -3,13 +3,17 @@ import { Section as UiSection } from '@ui/components/editor/settings/Section'
 import { Group as UiGroup } from '@ui/components/editor/settings/Group/Group'
 import { SortableList } from '@ui/components/editor/settings/SortableList'
 import { IconButton } from '@ui/components/editor/common/IconButton'
+import { DefaultConfigurationSelector } from '@ui/components/editor/settings/DefaultConfigurationSelector'
 import { CliConfiguration } from '@/types/cli-configuration'
 import { use_translation } from '../../i18n/use-translation'
 import { NavItem } from '../Home'
 
 type Props = {
   agent_configurations: CliConfiguration[]
   set_agent_configurations: (configurations: CliConfiguration[]) => void
+  agent_defaults: Record<string, string | null>
+  on_set_default_agent_configuration: (cli_feature: string, name: string | null) => void
+  on_select_default_agent_configuration: (cli_feature: string) => void
   on_reorder_agent_configurations: (reordered: CliConfiguration[]) => void
   on_add_agent_configuration: (params?: {
     insertion_index?: number
@@ -31,9 +35,9 @@ export const CliSection = forwardRef<HTMLDivElement, Props>((props, ref) => {
       >
         <UiGroup title={t('agents.configurations.title')}>
           <SortableList
-            items={props.agent_configurations.map((c, index) => ({
+            items={props.agent_configurations.map((c) => ({
               ...c,
-              id: c.name ?? `unnamed-${index}`
+              id: c.name
             }))}
             on_reorder={(reordered) => {
               const restored = reordered.map(
@@ -50,18 +54,15 @@ export const CliSection = forwardRef<HTMLDivElement, Props>((props, ref) => {
               items_text_many: t('agents.configurations.items-many')
             }}
             render_content={(config) => {
-              const is_unnamed =
-                !config.name ||
-                config.name.startsWith('unnamed-') ||
-                /^\(\d+\)$/.test(config.name.trim())
+              const is_unnamed = /^\(\d+\)$/.test(config.name.trim())
               const display_name = is_unnamed
-                ? config.agent!
-                : config.name!.replace(/ \(\d+\)$/, '')
+                ? config.agent
+                : config.name.replace(/ \(\d+\)$/, '')
 
               const details: string[] = []
               if (is_unnamed) {
                 // ...
-              } else if (config.agent) {
+              } else {
                 details.push(config.agent)
               }
 
@@ -132,6 +133,41 @@ export const CliSection = forwardRef<HTMLDivElement, Props>((props, ref) => {
           />
         </UiGroup>
       </div>
+      <div
+        ref={(el) => props.set_section_ref('section:cli:group:agent-defaults', el)}
+      >
+        <UiGroup
+          title={t('cli.default-configurations.title')}
+          is_disabled={props.agent_configurations.length === 0}
+        >
+          <DefaultConfigurationSelector
+            title={t('cli.default-configurations.tool.agentic-search')}
+            value={props.agent_defaults['agentic-search'] || null}
+            configurations={props.agent_configurations.map((config) => {
+              const is_unnamed = /^\(\d+\)$/.test(config.name.trim())
+              const display_name = is_unnamed
+                ? config.agent
+                : config.name.replace(/ \(\d+\)$/, '')
+
+              return {
+                id: config.name,
+                model: display_name,
+                description: config.agent
+              }
+            })}
+            on_unset={() =>
+              props.on_set_default_agent_configuration('agentic-search', null)
+            }
+            on_select={() =>
+              props.on_select_default_agent_configuration('agentic-search')
+            }
+            translations={{
+              select: t('agents.configurations.action.select-default'),
+              unset: t('agents.configurations.action.unset-default')
+            }}
+          />
+        </UiGroup>
+      </div>
     </UiSection>
   )
 })