Create web-researcher and docs-researcher (both Flash) for scout to spawn.

Author: jahooma

.agents/base2/base2-factory.ts

@@ -26,7 +26,7 @@ export const base2 = (model: ModelName): Omit<SecretAgentDefinition, 'id'> => ({
   },
   outputMode: 'last_message',
   includeMessageHistory: true,
-  toolNames: ['spawn_agents', 'end_turn'],
+  toolNames: ['spawn_agent_inline', 'spawn_agents', 'end_turn'],
   spawnableAgents: ['scout', 'planner', 'editor', 'reviewer', 'context-pruner'],
 
   systemPrompt: `You are Buffy, a strategic coding assistant that orchestrates complex coding tasks through specialized sub-agents.

.agents/base2/scout.ts

@@ -8,8 +8,12 @@ const definition: SecretAgentDefinition = {
   id: 'scout',
   publisher,
   model: 'google/gemini-2.5-flash',
+  reasoningOptions: {
+    effort: 'low',
+    exclude: true,
+  },
   displayName: 'Lewis & Clark',
-  spawnableAgents: ['file-explorer', 'researcher'],
+  spawnableAgents: ['file-explorer', 'web-researcher', 'docs-researcher'],
   toolNames: ['spawn_agents', 'end_turn'],
 
   inputSchema: {
@@ -30,14 +34,17 @@ Then answer the question to the best of your ability.
 
 You cannot use any other tools beyond the ones provided to you. (No abiltity to read files, write files, or run terminal commands, etc.)
 
+Note: when you spawn the file-explorer, it takes a params field, which is an object with a prompts field, which is an array of strings.
+Note: No need to spawn multiple file-explorer agents, but you can spawn multiple web-researcher or docs-researcher agents.
+
 ${PLACEHOLDER.FILE_TREE_PROMPT}
 ${PLACEHOLDER.KNOWLEDGE_FILES_CONTENTS}`,
 
   instructionsPrompt: `Instructions:
-1. Use <thinking> tags to think about which agent(s) to spawn.
-2. Spawn the file explorer, researcher, or both at the same time with the spawn_agents tool.
-3. Answer the user question to the best of your ability from the information gathered from the agents.
-4. Use the end_turn tool.`,
+In your thinking, consider which agent(s) to spawn.
+1. Spawn the file-explorer, web-researcher, docs-researcher, or any combination of the above at the same time with the spawn_agents tool. Do not spawn any more agents after this step. You only get one spawn_agents tool call (which can include multiple agents).
+2. Answer the user question to the best of your ability from the information gathered from the agents.
+3. Use the end_turn tool.`,
 }
 
 export default definition

.agents/docs-researcher.ts

@@ -0,0 +1,12 @@
+import { publisher } from './constants'
+import { docsResearcher } from './factory/docs-researcher'
+
+import type { SecretAgentDefinition } from './types/secret-agent-definition'
+
+const definition: SecretAgentDefinition = {
+  id: 'docs-researcher',
+  publisher,
+  ...docsResearcher('google/gemini-2.5-flash'),
+}
+
+export default definition

.agents/factory/docs-researcher.ts

@@ -0,0 +1,28 @@
+import type { SecretAgentDefinition } from '../types/secret-agent-definition'
+import type { Model } from '@codebuff/common/constants'
+
+export const docsResearcher = (
+  model: Model,
+): Omit<SecretAgentDefinition, 'id'> => ({
+  model,
+  displayName: 'Doc',
+  spawnerPrompt: `Expert at reading technical documentation to find relevant information.`,
+  inputSchema: {
+    prompt: {
+      type: 'string',
+      description:
+        'A question you would like answered using technical documentation.',
+    },
+  },
+  outputMode: 'last_message',
+  includeMessageHistory: false,
+  toolNames: ['read_docs', 'end_turn'],
+  spawnableAgents: [],
+
+  systemPrompt: `You are an expert researcher who can read documentation to find relevant information. Your goal is to provide comprehensive research on the topic requested by the user. Use read_docs to get detailed documentation.`,
+  instructionsPrompt: `Instructions:
+1. Use the read_docs tool to get detailed documentation relevant to the user's question.
+2. Provide a comprehensive report of the documentation. Include key findings, relevant insights, and actionable recommendations.
+3. End your response with the end_turn tool.
+  `.trim(),
+})

.agents/factory/web-researcher.ts

@@ -0,0 +1,34 @@
+import type { SecretAgentDefinition } from '../types/secret-agent-definition'
+import type { Model } from '@codebuff/common/constants'
+
+export const webResearcher = (
+  model: Model,
+): Omit<SecretAgentDefinition, 'id'> => ({
+  model,
+  displayName: 'Weeb',
+  spawnerPrompt: `Expert at browsing the web to find relevant information.`,
+  inputSchema: {
+    prompt: {
+      type: 'string',
+      description: 'A question you would like answered using web search',
+    },
+  },
+  outputMode: 'last_message',
+  includeMessageHistory: false,
+  toolNames: ['web_search', 'end_turn'],
+  spawnableAgents: [],
+
+  systemPrompt: `You are an expert researcher who can search the web to find relevant information. Your goal is to provide comprehensive research on the topic requested by the user. Use web_search to find current information.`,
+  instructionsPrompt:
+    `Provide comprehensive research on the topic. Use web_search to find current information.
+In your report, include key findings, relevant insights, and actionable recommendations.
+Always end your response with the end_turn tool.`.trim(),
+
+  handleSteps: function* ({ agentState, prompt, params }) {
+    yield {
+      toolName: 'web_search' as const,
+      input: { query: prompt || '', depth: 'standard' as const },
+    }
+    yield 'STEP_ALL'
+  },
+})

.agents/web-researcher.ts

@@ -0,0 +1,12 @@
+import { publisher } from './constants'
+import { webResearcher } from './factory/web-researcher'
+
+import type { SecretAgentDefinition } from './types/secret-agent-definition'
+
+const definition: SecretAgentDefinition = {
+  id: 'web-researcher',
+  publisher,
+  ...webResearcher('google/gemini-2.5-flash'),
+}
+
+export default definition

common/src/tools/params/tool/read-docs.ts

@@ -13,13 +13,12 @@ export const readDocsParams = {
         .string()
         .min(1, 'Library title cannot be empty')
         .describe(
-          `The exact library or framework name (e.g., "Next.js", "MongoDB", "React"). Use the official name as it appears in documentation, not a search query.`,
+          `The library or framework name (e.g., "Next.js", "MongoDB", "React"). Use the official name as it appears in documentation if possible. Only public libraries available in Context7's database are supported, so small or private libraries may not be available.`,
         ),
       topic: z
         .string()
-        .optional()
         .describe(
-          `Optional specific topic to focus on (e.g., "routing", "hooks", "authentication")`,
+          `Specific topic to focus on (e.g., "routing", "hooks", "authentication")`,
         ),
       max_tokens: z
         .number()