u

src/tools/ask-expert.js

@@ -8,14 +8,10 @@ import { emitToolCall, clip } from './notify.js';
 export const askExpertTool = defineTool({
     name: 'ask_an_expert',
     description:
-        'Ask expert a question. You ' +
-        'MUST use it every time something is confusing, unclear, or progress ' +
-        'seems difficult—do not keep guessing or spinning. The question is ' +
-        'presented to the user as a copy-pasteable block that they can hand to an ' +
-        'expert, and their reply (the expert\'s answer) is returned to you. ' +
-        'Provide a self-contained `question`; put any supporting detail the ' +
-        'expert will need (error messages, code, what you already tried) in the ' +
-        'optional `context`.',
+        'Escalate to a human expert when you are genuinely stuck (a confusing or unclear problem, or ' +
+        'you have tried and are still spinning). Do not use it for things you can resolve yourself. ' +
+        'Question shown to user as copy-pasteable block for their expert; reply returned to you. ' +
+        'Self-contained `question`; put supporting detail (errors, code, what you tried) in optional `context`.',
     parameters: {
         type: 'object',
         additionalProperties: false,
@@ -23,13 +19,12 @@ export const askExpertTool = defineTool({
         properties: {
             question: {
                 type: 'string',
-                description: 'The question to put to the expert. Keep it concise and specific.',
+                description: 'Question for the expert. Concise & specific.',
             },
             context: {
                 type: 'string',
                 description:
-                    'Optional supporting detail the expert needs to answer well ' +
-                    '(error messages, relevant code, what you already tried, etc.).',
+                    'Opt supporting detail the expert needs (errors, code, what you tried).',
             },
         },
     },