@jshookmcp/jshook 0.2.3 → 0.2.5

package/dist/src/server/domains/browser/definitions.tools.page-system.js

@@ -1,252 +1,110 @@
+import { tool } from '../../registry/tool-builder.js';
 export const browserPageSystemTools = [
-    {
-        name: 'console_enable',
-        description: 'Enable console monitoring to capture console.log, console.error, etc.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'console_get_logs',
-        description: 'Get captured console logs',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                type: {
-                    type: 'string',
-                    description: 'Filter by log type',
-                    enum: ['log', 'warn', 'error', 'info', 'debug'],
-                },
-                limit: {
-                    type: 'number',
-                    description: 'Maximum number of logs to return',
-                },
-                since: {
-                    type: 'number',
-                    description: 'Only return logs after this timestamp',
-                },
-            },
-        },
-    },
-    {
-        name: 'console_execute',
-        description: 'Execute JavaScript expression in console context',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                expression: {
-                    type: 'string',
-                    description: 'JavaScript expression to execute',
-                },
-            },
-            required: ['expression'],
-        },
-    },
-    {
-        name: 'dom_get_computed_style',
-        description: 'Get computed CSS styles of an element',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                selector: {
-                    type: 'string',
-                    description: 'CSS selector',
-                },
-            },
-            required: ['selector'],
-        },
-    },
-    {
-        name: 'dom_find_by_text',
-        description: 'Find elements by text content (useful for dynamic content)',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                text: {
-                    type: 'string',
-                    description: 'Text to search for',
-                },
-                tag: {
-                    type: 'string',
-                    description: 'Optional tag name to filter (e.g., "button", "a")',
-                },
-            },
-            required: ['text'],
-        },
-    },
-    {
-        name: 'dom_get_xpath',
-        description: 'Get XPath of an element',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                selector: {
-                    type: 'string',
-                    description: 'CSS selector',
-                },
-            },
-            required: ['selector'],
-        },
-    },
-    {
-        name: 'dom_is_in_viewport',
-        description: 'Check if element is visible in viewport',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                selector: {
-                    type: 'string',
-                    description: 'CSS selector',
-                },
-            },
-            required: ['selector'],
-        },
-    },
-    {
-        name: 'page_get_performance',
-        description: 'Get page performance metrics (load time, network time, etc.)',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'page_inject_script',
-        description: 'Inject JavaScript code into page',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                script: {
-                    type: 'string',
-                    description: 'JavaScript code to inject',
-                },
-            },
-            required: ['script'],
-        },
-    },
-    {
-        name: 'page_set_cookies',
-        description: 'Set cookies for the page',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                cookies: {
-                    type: 'array',
-                    description: 'Array of cookie objects',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            name: { type: 'string' },
-                            value: { type: 'string' },
-                            domain: { type: 'string' },
-                            path: { type: 'string' },
-                            expires: { type: 'number' },
-                            httpOnly: { type: 'boolean' },
-                            secure: { type: 'boolean' },
-                            sameSite: { type: 'string', enum: ['Strict', 'Lax', 'None'] },
-                        },
-                        required: ['name', 'value'],
-                    },
-                },
-            },
-            required: ['cookies'],
-        },
-    },
-    {
-        name: 'page_get_cookies',
-        description: 'Get all cookies for the page',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'page_clear_cookies',
-        description: 'Clear all cookies',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'page_set_viewport',
-        description: 'Set viewport size',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                width: {
-                    type: 'number',
-                    description: 'Viewport width',
-                },
-                height: {
-                    type: 'number',
-                    description: 'Viewport height',
-                },
-            },
-            required: ['width', 'height'],
-        },
-    },
-    {
-        name: 'page_emulate_device',
-        description: 'Emulate mobile device (iPhone, iPad, Android)',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                device: {
-                    type: 'string',
-                    description: 'Device to emulate. Supports canonical values (iPhone, iPad, Android) and aliases like "iPhone 13" / "iPhone 14".',
-                },
-            },
-            required: ['device'],
-        },
-    },
-    {
-        name: 'page_get_local_storage',
-        description: 'Get all localStorage items',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
-    {
-        name: 'page_set_local_storage',
-        description: 'Set localStorage item',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                key: {
-                    type: 'string',
-                    description: 'Storage key',
-                },
-                value: {
-                    type: 'string',
-                    description: 'Storage value',
-                },
-            },
-            required: ['key', 'value'],
-        },
-    },
-    {
-        name: 'page_press_key',
-        description: 'Press a keyboard key (e.g., "Enter", "Escape", "ArrowDown")',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                key: {
-                    type: 'string',
-                    description: 'Key to press',
-                },
-            },
-            required: ['key'],
-        },
-    },
-    {
-        name: 'page_get_all_links',
-        description: 'Get all links on the page',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-        },
-    },
+    tool('console_enable')
+        .desc('Enable console monitoring to capture console.log, console.error, etc.')
+        .idempotent()
+        .build(),
+    tool('console_get_logs')
+        .desc('Get captured console logs')
+        .enum('type', ['log', 'warn', 'error', 'info', 'debug'], 'Filter by log type')
+        .number('limit', 'Maximum number of logs to return')
+        .number('since', 'Only return logs after this timestamp')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('console_execute')
+        .desc('Execute JavaScript expression in console context')
+        .string('expression', 'JavaScript expression to execute')
+        .required('expression')
+        .openWorld()
+        .build(),
+    tool('dom_get_computed_style')
+        .desc('Get computed CSS styles of an element')
+        .string('selector', 'CSS selector')
+        .required('selector')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('dom_find_by_text')
+        .desc('Find elements by text content (useful for dynamic content)')
+        .string('text', 'Text to search for')
+        .string('tag', 'Optional tag name to filter (e.g., "button", "a")')
+        .required('text')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('dom_get_xpath')
+        .desc('Get XPath of an element')
+        .string('selector', 'CSS selector')
+        .required('selector')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('dom_is_in_viewport')
+        .desc('Check if element is visible in viewport')
+        .string('selector', 'CSS selector')
+        .required('selector')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('page_get_performance')
+        .desc('Get page performance metrics (load time, network time, etc.)')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('page_inject_script')
+        .desc('Inject JavaScript code into page')
+        .string('script', 'JavaScript code to inject')
+        .required('script')
+        .openWorld()
+        .build(),
+    tool('page_set_cookies')
+        .desc('Set cookies for the page')
+        .array('cookies', {
+        type: 'object',
+        properties: {
+            name: { type: 'string' },
+            value: { type: 'string' },
+            domain: { type: 'string' },
+            path: { type: 'string' },
+            expires: { type: 'number' },
+            httpOnly: { type: 'boolean' },
+            secure: { type: 'boolean' },
+            sameSite: { type: 'string', enum: ['Strict', 'Lax', 'None'] },
+        },
+        required: ['name', 'value'],
+    }, 'Array of cookie objects')
+        .required('cookies')
+        .idempotent()
+        .build(),
+    tool('page_get_cookies').desc('Get all cookies for the page').readOnly().idempotent().build(),
+    tool('page_clear_cookies').desc('Clear all cookies').destructive().idempotent().build(),
+    tool('page_set_viewport')
+        .desc('Set viewport size')
+        .number('width', 'Viewport width')
+        .number('height', 'Viewport height')
+        .required('width', 'height')
+        .idempotent()
+        .build(),
+    tool('page_emulate_device')
+        .desc('Emulate mobile device (iPhone, iPad, Android)')
+        .string('device', 'Device to emulate. Supports canonical values (iPhone, iPad, Android) and aliases like "iPhone 13" / "iPhone 14".')
+        .required('device')
+        .idempotent()
+        .build(),
+    tool('page_get_local_storage').desc('Get all localStorage items').readOnly().idempotent().build(),
+    tool('page_set_local_storage')
+        .desc('Set localStorage item')
+        .string('key', 'Storage key')
+        .string('value', 'Storage value')
+        .required('key', 'value')
+        .idempotent()
+        .build(),
+    tool('page_press_key')
+        .desc('Press a keyboard key (e.g., "Enter", "Escape", "ArrowDown")')
+        .string('key', 'Key to press')
+        .required('key')
+        .openWorld()
+        .build(),
+    tool('page_get_all_links').desc('Get all links on the page').readOnly().idempotent().build(),
 ];