create codebase explorer, directory-lister, glob-matcher. consolidate file-pickers

Author: jahooma

.agents/base2/base-layer.ts

@@ -32,7 +32,7 @@ const definition: SecretAgentDefinition = {
   spawnableAgents: [
     'read-only-commander',
     'file-picker',
-    'code-searcher',
+    'codebase-explorer',
     'researcher-web',
     'researcher-docs',
     'thinker',

.agents/file-explorer/code-searcher.ts

@@ -34,7 +34,7 @@ const codeSearcher: SecretAgentDefinition = {
   id: 'code-searcher',
   displayName: 'Code Searcher',
   spawnerPrompt:
-    'Mechanically runs multiple code search queries and returns all results',
+    'Mechanically runs multiple code search queries (using ripgrep line-oriented search) and returns all results',
   model: 'anthropic/claude-sonnet-4.5',
   publisher,
   outputMode: 'all_messages',
@@ -44,16 +44,6 @@ const codeSearcher: SecretAgentDefinition = {
   inputSchema: {
     params: paramsSchema,
   },
-  systemPrompt:
-    'You are a code searcher agent that executes multiple code search queries and compiles the results. Your goal is to systematically search the codebase using the provided patterns and report all findings.',
-  instructionsPrompt: `
-Execute each code search query provided in the parameters and compile all results.
-
-For each search query, run the code_search tool with the specified pattern, flags, cwd, and maxResults.
-
-After all searches complete, provide a comprehensive summary of the findings, organizing results by search query.
-`.trim(),
-
   handleSteps: function* ({ params }) {
     const searchQueries: SearchQuery[] = params?.searchQueries ?? []
 

.agents/file-explorer/codebase-explorer.ts

@@ -0,0 +1,63 @@
+import { publisher } from '../constants'
+
+import type { SecretAgentDefinition } from '../types/secret-agent-definition'
+
+const codebaseExplorer: SecretAgentDefinition = {
+  id: 'codebase-explorer',
+  displayName: 'Codebase Explorer',
+  spawnerPrompt:
+    'Orchestrates multiple exploration agents to comprehensively analyze the codebase and answer questions.',
+  model: 'anthropic/claude-sonnet-4.5',
+  publisher,
+  outputMode: 'last_message',
+  includeMessageHistory: false,
+  toolNames: ['spawn_agents'],
+  spawnableAgents: [
+    'file-picker',
+    'code-searcher',
+    'directory-lister',
+    'glob-matcher',
+  ],
+  inputSchema: {
+    prompt: {
+      type: 'string',
+      description: 'A question or exploration goal for the codebase.',
+    },
+  },
+  systemPrompt: `You are a codebase exploration orchestrator. Your job is to spawn multiple specialized agents in parallel waves to comprehensively explore the codebase and answer the user's question.
+
+You have access to these agents:
+
+1. **file-explorer** - Spawns multiple file-picker agents to find relevant files
+   - Takes a prompt and a "prompts" param with 1-4 specific focus areas
+   - Example: { prompts: ["authentication logic", "API endpoints", "database models"] }
+
+2. **code-searcher** - Runs multiple ripgrep searches to find code patterns
+   - Takes a "searchQueries" param with array of search queries
+   - Each query has: pattern (required), flags, cwd, maxResults
+   - Example: { searchQueries: [{ pattern: "class.*Auth", flags: "-t ts" }] }
+
+3. **directory-lister** - Lists contents of multiple directories
+   - Takes a "directories" param with array of directory paths
+   - Each has: path (required)
+   - Example: { directories: [{ path: "src/auth" }, { path: "src/api" }] }
+
+4. **glob-matcher** - Matches multiple glob patterns to find files
+   - Takes a "patterns" param with array of glob patterns
+   - Each has: pattern (required), cwd (optional)
+   - Example: { patterns: [{ pattern: "**/*test*.ts" }, { pattern: "*.config.js" }] }
+
+Strategy:
+1. Analyze the user's question to determine what exploration approach would be most effective
+2. Spawn multiple agents in parallel in the first wave to gather information from different angles
+3. Based on the results, you can spawn additional agents in subsequent waves if needed to fill gaps
+4. Synthesize all findings into a comprehensive answer`,
+
+  instructionsPrompt: `Analyze the user's prompt and spawn appropriate exploration agents in parallel.
+
+After reviewing the results, spawn additional agents if needed to fill gaps.
+
+Finally, synthesize all findings into a comprehensive answer.`,
+}
+
+export default codebaseExplorer

.agents/file-explorer/directory-lister.ts

@@ -0,0 +1,55 @@
+import { publisher } from '../constants'
+
+import type { SecretAgentDefinition } from '../types/secret-agent-definition'
+
+interface ListDirectoryQuery {
+  path: string
+}
+
+const paramsSchema = {
+  type: 'object' as const,
+  properties: {
+    directories: {
+      type: 'array' as const,
+      items: {
+        type: 'object' as const,
+        properties: {
+          path: { type: 'string' as const },
+        },
+        required: ['path'],
+      },
+      description: 'Array of directory paths to list',
+    },
+  },
+  required: ['directories'],
+}
+
+const directoryLister: SecretAgentDefinition = {
+  id: 'directory-lister',
+  displayName: 'Directory Lister',
+  spawnerPrompt:
+    'Mechanically lists multiple directories and returns their contents',
+  model: 'anthropic/claude-sonnet-4.5',
+  publisher,
+  outputMode: 'all_messages',
+  includeMessageHistory: false,
+  toolNames: ['list_directory'],
+  spawnableAgents: [],
+  inputSchema: {
+    params: paramsSchema,
+  },
+  handleSteps: function* ({ params }) {
+    const directories: ListDirectoryQuery[] = params?.directories ?? []
+
+    for (const directory of directories) {
+      yield {
+        toolName: 'list_directory',
+        input: {
+          path: directory.path,
+        },
+      }
+    }
+  },
+}
+
+export default directoryLister

.agents/file-explorer/file-explorer.ts

@@ -22,7 +22,7 @@ const fileExplorer: SecretAgentDefinition = {
   displayName: 'Dora the File Explorer',
   spawnerPrompt:
     'Comprehensively explores the codebase and reports back on the results',
-  model: 'anthropic/claude-4-sonnet-20250522',
+  model: 'x-ai/grok-4-fast',
   publisher,
   outputMode: 'structured_output',
   includeMessageHistory: false,

.agents/file-explorer/file-picker.ts

@@ -6,7 +6,7 @@ import type { SecretAgentDefinition } from '../types/secret-agent-definition'
 const definition: SecretAgentDefinition = {
   id: 'file-picker',
   publisher,
-  ...filePicker('google/gemini-2.5-flash'),
+  ...filePicker('x-ai/grok-4-fast'),
 }
 
 export default definition

.agents/file-explorer/glob-matcher.ts

@@ -0,0 +1,58 @@
+import { publisher } from '../constants'
+
+import type { SecretAgentDefinition } from '../types/secret-agent-definition'
+
+interface GlobQuery {
+  pattern: string
+  cwd?: string
+}
+
+const paramsSchema = {
+  type: 'object' as const,
+  properties: {
+    patterns: {
+      type: 'array' as const,
+      items: {
+        type: 'object' as const,
+        properties: {
+          pattern: { type: 'string' as const },
+          cwd: { type: 'string' as const },
+        },
+        required: ['pattern'],
+      },
+      description: 'Array of glob patterns to match',
+    },
+  },
+  required: ['patterns'],
+}
+
+const globMatcher: SecretAgentDefinition = {
+  id: 'glob-matcher',
+  displayName: 'Glob Matcher',
+  spawnerPrompt:
+    'Mechanically runs multiple glob pattern matches and returns all matching files',
+  model: 'anthropic/claude-sonnet-4.5',
+  publisher,
+  outputMode: 'all_messages',
+  includeMessageHistory: false,
+  toolNames: ['glob'],
+  spawnableAgents: [],
+  inputSchema: {
+    params: paramsSchema,
+  },
+  handleSteps: function* ({ params }) {
+    const patterns: GlobQuery[] = params?.patterns ?? []
+
+    for (const query of patterns) {
+      yield {
+        toolName: 'glob',
+        input: {
+          pattern: query.pattern,
+          cwd: query.cwd,
+        },
+      }
+    }
+  },
+}
+
+export default globMatcher

.agents/file-explorer/inline-file-explorer.ts

@@ -23,7 +23,7 @@ const inlineFileExplorer: SecretAgentDefinition = {
   publisher,
   outputMode: 'last_message',
   toolNames: ['spawn_agents', 'read_files'],
-  spawnableAgents: ['researcher-file-picker'],
+  spawnableAgents: ['file-picker'],
   inputSchema: {
     prompt: {
       type: 'string',
@@ -47,7 +47,7 @@ const inlineFileExplorer: SecretAgentDefinition = {
       toolName: 'spawn_agents',
       input: {
         agents: filePickerPrompts.map((promptText) => ({
-          agent_type: 'researcher-file-picker',
+          agent_type: 'file-picker',
           prompt: promptText,
         })),
       },

.agents/file-picker.ts

@@ -24,7 +24,7 @@ const fileExplorer: SecretAgentDefinition = {
   outputMode: 'structured_output',
   includeMessageHistory: false,
   toolNames: ['spawn_agents', 'set_output'],
-  spawnableAgents: ['researcher-file-picker'],
+  spawnableAgents: ['file-picker'],
   inputSchema: {
     prompt: {
       type: 'string',
@@ -47,7 +47,7 @@ const fileExplorer: SecretAgentDefinition = {
         toolName: 'spawn_agents',
         input: {
           agents: filePickerPrompts.map((promptText) => ({
-            agent_type: 'researcher-file-picker',
+            agent_type: 'file-picker',
             prompt: promptText,
           })),
         },