Shorten and clarify schema descriptions in tools

Author: Tomohiko Hiraki

src/tools/keyboard.ts

@@ -13,9 +13,7 @@ const pressKey = defineTabTool({
     title: 'Press a key',
     description: 'Press a key on the keyboard',
     inputSchema: z.object({
-      key: z
-        .string()
-        .describe('Key to press (e.g., Enter, Escape, ArrowLeft, a)'),
+      key: z.string().describe('Key to press'),
       expectation: expectationSchema.describe(
         'Page state config. Use batch_execute for multiple keys'
       ),
@@ -44,9 +42,9 @@ const typeSchema = elementSchema.extend({
   ref: z
     .string()
     .describe(
-      'System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'
+      'System-generated element ID from previous tool results. Never use custom values.'
     ),
-  text: z.string().describe('Text to type into the element'),
+  text: z.string(),
   submit: z.boolean().optional().describe('Press Enter after typing if true'),
   slowly: z
     .boolean()

src/tools/snapshot.ts

@@ -45,7 +45,7 @@ export const elementSchema = z.object({
   ref: z
     .string()
     .describe(
-      'System-generated element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'
+      'System-generated element ID from previous tool results. Never use custom values.'
     ),
 });
 
@@ -110,7 +110,7 @@ const drag = defineTabTool({
       startRef: z
         .string()
         .describe(
-          'System-generated source element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'
+          'System-generated source element ID from previous tool results. Never use custom values.'
         ),
       endElement: z
         .string()
@@ -120,7 +120,7 @@ const drag = defineTabTool({
       endRef: z
         .string()
         .describe(
-          'System-generated target element ID from previous tool results (e.g., "rNODE-45-1"). Never use custom values.'
+          'System-generated target element ID from previous tool results. Never use custom values.'
         ),
       expectation: expectationSchema.describe(
         'Page state after drag. Use batch_execute for workflows'

src/tools/wait.ts

@@ -11,8 +11,8 @@ const wait = defineTool({
       'Wait for text to appear or disappear or a specified time to pass',
     inputSchema: z.object({
       time: z.number().optional().describe('Wait time in seconds'),
-      text: z.string().optional().describe('Text to wait for'),
-      textGone: z.string().optional().describe('Text to wait to disappear'),
+      text: z.string().optional(),
+      textGone: z.string().optional(),
       expectation: expectationSchema.describe('Page state after wait'),
     }),
     type: 'readOnly',