Add thinker-with-files-gemini, which is cheaper since has no context except prompt + passed in files

Author: jahooma

agents/base2/base2.ts

@@ -87,7 +87,7 @@ export function createBase2(
       isFree && 'code-reviewer-lite',
       isDefault && 'code-reviewer',
       isMax && 'code-reviewer-multi-prompt',
-      isFree && 'thinker-gemini',
+      isFree && 'thinker-with-files-gemini',
       'thinker-gpt',
       'context-pruner',
     ),
@@ -143,7 +143,7 @@ Use the spawn_agents tool to spawn specialized agents to help you complete the u
   ${buildArray(
         '- Spawn context-gathering agents (file pickers and web/docs researchers) before making edits. Use the code_search, list_directory, and glob tools directly for searching and exploring the codebase.',
         isFree && 'Do not spawn the thinker-gpt agent, unless the user asks. Not everyone has connected their ChatGPT subscription to Codebuff to allow for it.',
-        isFree && 'You must spawn the thinker-gemini agent to think through and plan the reponse to most requests, unless the request is trivial. This agent is extremely useful as it is very smart!',
+        isFree && 'You must spawn the thinker-with-files-gemini agent to think through and plan the reponse to most requests, unless the request is trivial. This agent is extremely useful as it is very smart! You must pass the relevant filePaths when spawning it, since it does not have access to the conversation history.',
         isDefault &&
         '- Spawn the editor agent to implement the changes after you have gathered all the context you need.',
         (isDefault || isMax) &&
@@ -206,7 +206,7 @@ ${buildArray(
 [ You read a few other relevant files using the read_files tool ]${!noAskUser
         ? `\n\n[ You ask the user for important clarifications on their request or alternate implementation strategies using the ask_user tool ]`
         : ''
-      }${isFree ? `\n\n[ You spawn the thinker-gemini agent to plan the best response ]` : ''}
+      }${isFree ? `\n\n[ You spawn the thinker-with-files-gemini agent with the relevant filePaths to plan the best response ]` : ''}
 ${isDefault
         ? `[ You implement the changes using the editor agent ]`
         : isFast || isFree
@@ -334,7 +334,7 @@ ${buildArray(
     (isDefault || isMax) &&
     `- For any task requiring 3+ steps, use the write_todos tool to write out your step-by-step implementation plan. Include ALL of the applicable tasks in the list.${isFast ? '' : ' You should include a step to review the changes after you have implemented the changes.'}:${hasNoValidation ? '' : ' You should include at least one step to validate/test your changes: be specific about whether to typecheck, run tests, run lints, etc.'} You may be able to do reviewing and validation in parallel in the same step. Skip write_todos for simple tasks like quick edits or answering questions.`,
     isFree &&
-    `- For most requests, spawn the thinker-gemini agent to think through and plan the best response. This agent is extremely useful as it is very smart. You must take advantage of it and spawn it about once per user request. Gather all the necessary context *before* spawning the thinker-gemini agent.`,
+    `- For most requests, spawn the thinker-with-files-gemini agent to think through and plan the best response. This agent is extremely useful as it is very smart. You must take advantage of it and spawn it about once per user request. Gather all the necessary context *before* spawning it, and pass the relevant filePaths since it does not have access to the conversation history.`,
     (isDefault || isMax) &&
     `- For quick problems, briefly explain your reasoning to the user. If you need to think longer, write your thoughts within the <think> tags. Finally, for complex problems, spawn the thinker agent to help find the best solution. (gpt-5-agent is a last resort for complex problems)`,
     isDefault &&
@@ -380,7 +380,7 @@ function buildImplementationStepPrompt({
     `Keep working until the user's request is completely satisfied${!hasNoValidation ? ' and validated' : ''}, or until you require more information from the user.`,
     'You must use the skill tool to load any potentially relevant skills.',
     isFree &&
-    `You must spawn the thinker-gemini agent once per user request to plan the best response.`,
+    `You must spawn the thinker-with-files-gemini agent once per user request to plan the best response. Pass the relevant filePaths since it does not have access to the conversation history.`,
     isMax &&
     `You must spawn the 'editor-multi-prompt' agent to implement code changes rather than using the str_replace or write_file tools, since it will generate the best code changes.`,
     (isDefault || isMax) &&

agents/thinker/thinker-with-files-gemini.ts

@@ -0,0 +1,61 @@
+import { publisher } from '../constants'
+
+import type { SecretAgentDefinition } from '../types/secret-agent-definition'
+
+const definition: SecretAgentDefinition = {
+  id: 'thinker-with-files-gemini',
+  publisher,
+  model: 'google/gemini-3.1-pro-preview',
+  displayName: 'Theo the Theorizer with Files (Gemini)',
+  reasoningOptions: {
+    effort: 'low',
+  },
+  spawnerPrompt:
+    'Does deep thinking given the prompt and provided files using Gemini. Use this to help you solve a specific problem. This agent has no context on the conversation history so it cannot see files you have read or previous discussion. Instead, you must provide all the relevant context via the prompt or filePaths for this agent to work well.',
+  inputSchema: {
+    prompt: {
+      type: 'string',
+      description: 'The problem you are trying to solve',
+    },
+    params: {
+      type: 'object',
+      properties: {
+        filePaths: {
+          type: 'array',
+          items: {
+            type: 'string',
+            description: 'The path to a file',
+          },
+          description:
+            'A list of relevant file paths to read before thinking. Try to provide ALL the files that could be relevant to your request.',
+        },
+      },
+      required: ['filePaths'],
+    },
+  },
+  outputMode: 'last_message',
+  outputSchema: undefined,
+  includeMessageHistory: false,
+  inheritParentSystemPrompt: false,
+  spawnableAgents: [],
+  toolNames: [],
+
+  instructionsPrompt: `You are the thinker-with-files-gemini agent. Think about the user request and when satisfied, write out a very concise response that captures the most important points. DO NOT be verbose -- say the absolute minimum needed to answer the user's question correctly.
+
+The parent agent will see your response. DO NOT call any tools. No need to spawn the thinker agent, because you are already the thinker agent. Just do the thinking work now.`,
+
+  handleSteps: function* ({ params }) {
+    const filePaths = params?.filePaths as string[] | undefined
+
+    if (filePaths && filePaths.length > 0) {
+      yield {
+        toolName: 'read_files',
+        input: { paths: filePaths },
+      }
+    }
+
+    yield 'STEP'
+  },
+}
+
+export default definition

common/src/constants/free-agents.ts

@@ -37,6 +37,9 @@ export const FREE_MODE_AGENT_MODELS: Record<string, Set<string>> = {
 
   // Code reviewer for free mode
   'code-reviewer-lite': new Set(['minimax/minimax-m2.5']),
+
+  // Thinker for free mode
+  'thinker-with-files-gemini': new Set(['google/gemini-3.1-pro-preview']),
 }
 
 /**