@jshookmcp/jshook 0.2.3 → 0.2.6

package/dist/src/server/domains/workflow/definitions.js

@@ -1,419 +1,149 @@
+import { tool } from '../../registry/tool-builder.js';
 export const workflowToolDefinitions = [
-    {
-        name: 'web_api_capture_session',
-        description: 'Full-chain web API capture workflow: navigate → inject interceptors → perform actions → collect requests → extract auth → optionally export HAR + Markdown report.\n\nThis is a composite tool that replaces the following manual sequence:\n1. network_enable\n2. console_inject_fetch_interceptor + console_inject_xhr_interceptor\n3. page_navigate\n4. (perform actions)\n5. network_get_requests\n6. network_extract_auth\n7. network_export_har (optional)\n\n**Captured fetch requests are auto-persisted to localStorage.__capturedAPIs** — survives context compression.\n**Set exportHar/exportReport: true to persist artifacts to disk** before context is compressed.\n\nUSE THIS when you need to capture the complete API surface of a page in one step.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                url: {
-                    type: 'string',
-                    description: 'URL to navigate to',
-                },
-                waitUntil: {
-                    type: 'string',
-                    enum: ['load', 'domcontentloaded', 'networkidle', 'networkidle2'],
-                    description: 'Navigation wait condition (default: domcontentloaded)',
-                    default: 'domcontentloaded',
-                },
-                actions: {
-                    type: 'array',
-                    description: 'Optional sequence of actions to perform after navigation (click, type, wait)',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            type: { type: 'string', enum: ['click', 'type', 'wait', 'evaluate'] },
-                            selector: { type: 'string' },
-                            text: { type: 'string' },
-                            expression: { type: 'string' },
-                            delayMs: { type: 'number' },
-                        },
-                        required: ['type'],
-                    },
-                },
-                exportHar: {
-                    type: 'boolean',
-                    description: 'Export captured traffic as HAR after collection (default: true — always persists to disk to survive context compression)',
-                    default: true,
-                },
-                harOutputPath: {
-                    type: 'string',
-                    description: 'File path for HAR export (default: auto-generated timestamped path artifacts/har/jshook-capture-<ts>.har)',
-                },
-                exportReport: {
-                    type: 'boolean',
-                    description: 'Export workflow summary as Markdown report (default: true)',
-                    default: true,
-                },
-                reportOutputPath: {
-                    type: 'string',
-                    description: 'File path for Markdown report export (default: auto-generated timestamped path artifacts/reports/web-api-capture-<ts>.md)',
-                },
-                waitAfterActionsMs: {
-                    type: 'number',
-                    description: 'Milliseconds to wait after all actions before collecting (default: 1500)',
-                    default: 1500,
-                },
+    tool('web_api_capture_session')
+        .desc('Full-chain web API capture workflow: navigate → inject interceptors → perform actions → collect requests → extract auth → optionally export HAR + Markdown report.\n\nThis is a composite tool that replaces the following manual sequence:\n1. network_enable\n2. console_inject_fetch_interceptor + console_inject_xhr_interceptor\n3. page_navigate\n4. (perform actions)\n5. network_get_requests\n6. network_extract_auth\n7. network_export_har (optional)\n\n**Captured fetch requests are auto-persisted to localStorage.__capturedAPIs** — survives context compression.\n**Set exportHar/exportReport: true to persist artifacts to disk** before context is compressed.\n\nUSE THIS when you need to capture the complete API surface of a page in one step.')
+        .string('url', 'URL to navigate to')
+        .enum('waitUntil', ['load', 'domcontentloaded', 'networkidle', 'networkidle2'], 'Navigation wait condition', { default: 'domcontentloaded' })
+        .array('actions', {
+        type: 'object',
+        properties: {
+            type: { type: 'string', enum: ['click', 'type', 'wait', 'evaluate'] },
+            selector: { type: 'string' },
+            text: { type: 'string' },
+            expression: { type: 'string' },
+            delayMs: { type: 'number' },
+        },
+        required: ['type'],
+    }, 'Optional sequence of actions to perform after navigation (click, type, wait)')
+        .boolean('exportHar', 'Export captured traffic as HAR after collection (always persists to disk to survive context compression)', { default: true })
+        .string('harOutputPath', 'File path for HAR export (default: auto-generated timestamped random path)')
+        .boolean('exportReport', 'Export workflow summary as Markdown report', { default: true })
+        .string('reportOutputPath', 'File path for Markdown report export (default: auto-generated timestamped random path)')
+        .number('waitAfterActionsMs', 'Milliseconds to wait after all actions before collecting', {
+        default: 1500,
+    })
+        .required('url')
+        .openWorld()
+        .build(),
+    tool('js_bundle_search')
+        .desc('Fetch a remote JavaScript bundle and search it with multiple named regex patterns in a single call.\n\nFeatures over bundle_search script:\n- Server-side fetch (no browser CORS constraints)\n- Bundle caching (5-min TTL, keyed by URL) — avoids re-downloading 1MB+ files\n- SVG/base64 false-positive filtering (`stripNoise: true` by default)\n- Per-pattern independent context window (`contextBefore`/`contextAfter`)\n- Up to `maxMatches` hits per pattern\n\nExample:\n  js_bundle_search({\n    url: "https://assets.example.com/main.js",\n    patterns: [\n      { name: "tier_values",   regex: "subscription.plus|user_tier" },\n      { name: "payment_apis",  regex: "/api/v1/payment/[a-z_]+" },\n      { name: "setSubscription", regex: "setSubscriptionPlus\\\\([^)]{0,80}\\\\)" }\n    ]\n  })')
+        .string('url', 'Remote URL of the JavaScript bundle to analyze')
+        .array('patterns', {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Human-readable label for this pattern' },
+            regex: { type: 'string', description: 'JavaScript regex string' },
+            contextBefore: {
+                type: 'number',
+                description: 'Characters of context before match (default: 80)',
             },
-            required: ['url'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: 'js_bundle_search',
-        description: 'Fetch a remote JavaScript bundle and search it with multiple named regex patterns in a single call.\n\nFeatures over bundle_search script:\n- Server-side fetch (no browser CORS constraints)\n- Bundle caching (5-min TTL, keyed by URL) — avoids re-downloading 1MB+ files\n- SVG/base64 false-positive filtering (`stripNoise: true` by default)\n- Per-pattern independent context window (`contextBefore`/`contextAfter`)\n- Up to `maxMatches` hits per pattern\n\nExample:\n  js_bundle_search({\n    url: "https://assets.example.com/main.js",\n    patterns: [\n      { name: "tier_values",   regex: "subscription.plus|user_tier" },\n      { name: "payment_apis",  regex: "/api/v1/payment/[a-z_]+" },\n      { name: "setSubscription", regex: "setSubscriptionPlus\\\\([^)]{0,80}\\\\)" }\n    ]\n  })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                url: {
-                    type: 'string',
-                    description: 'Remote URL of the JavaScript bundle to analyze',
-                },
-                patterns: {
-                    type: 'array',
-                    description: 'Named regex patterns to search for',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            name: { type: 'string', description: 'Human-readable label for this pattern' },
-                            regex: { type: 'string', description: 'JavaScript regex string' },
-                            contextBefore: {
-                                type: 'number',
-                                description: 'Characters of context before match (default: 80)',
-                            },
-                            contextAfter: {
-                                type: 'number',
-                                description: 'Characters of context after match (default: 80)',
-                            },
-                        },
-                        required: ['name', 'regex'],
-                    },
-                },
-                cacheBundle: {
-                    type: 'boolean',
-                    description: 'Cache the bundle for 5 minutes to avoid re-downloads (default: true)',
-                    default: true,
-                },
-                stripNoise: {
-                    type: 'boolean',
-                    description: 'Skip matches inside SVG path data or base64 blobs (default: true)',
-                    default: true,
-                },
-                maxMatches: {
-                    type: 'number',
-                    description: 'Maximum matches to return per pattern (default: 10)',
-                    default: 10,
-                },
-            },
-            required: ['url', 'patterns'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: 'page_script_register',
-        description: 'Register a named reusable JavaScript snippet in the Script Library.\n\nBuilt-in snippets available without registration:\n- `auth_extract`  — pull JWT/tokens from localStorage and cookies\n- `bundle_search` — fetch a CDN JS bundle and search it with regexes (params: { url, patterns })\n- `react_fill_form` — fill React controlled inputs (params: { fields: { selector: value } })\n- `dom_find_upgrade_buttons` — scan for upgrade/subscription UI elements\n\nRegistered scripts are executed with `page_script_run`. Scripts may reference `__params__` (set at call time via page_script_run params).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                name: {
-                    type: 'string',
-                    description: 'Unique script name (e.g. "my_extractor")',
-                },
-                code: {
-                    type: 'string',
-                    description: 'JavaScript expression/IIFE to register. Use `typeof __params__ !== "undefined" ? __params__ : {}` to safely access runtime parameters.',
-                },
-                description: {
-                    type: 'string',
-                    description: 'Optional human-readable description of the script',
-                },
-            },
-            required: ['name', 'code'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'page_script_run',
-        description: 'Execute a named script from the Script Library in the current page context.\n\nOptionally inject runtime parameters accessible as `__params__` inside the script.\n\nExample:\n  page_script_run({ name: "bundle_search", params: { url: "https://cdn.main.js", patterns: ["tier", "subscription"] } })\n  page_script_run({ name: "auth_extract" })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                name: {
-                    type: 'string',
-                    description: 'Script name to run (built-in or registered)',
-                },
-                params: {
-                    type: 'object',
-                    description: 'Optional parameters injected as __params__ (must be JSON-serializable)',
-                    additionalProperties: true,
-                },
-            },
-            required: ['name'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: 'api_probe_batch',
-        description: 'Probe multiple API endpoints in a single browser-context fetch burst.\n\nAuto-injects Bearer token from localStorage[token] / localStorage[active_token]. Returns status codes, content types, and response snippets for matching statuses. Skips HTML responses (login-redirect false-positives).\n\nReplaces 5–30 individual page_evaluate fetch calls with one tool call.\n\n**ALWAYS start with OpenAPI/Swagger discovery paths first** — a single 200 response gives you the full API schema:\n  "/docs", "/openapi.json", "/api/docs", "/swagger.json", "/api/v1/openapi.json", "/api/openapi.json"\n\nExample:\n  api_probe_batch({ baseUrl: "https://chat.qwen.ai", paths: ["/docs", "/openapi.json", "/api/v1/users/me", "/api/v1/chats/", "/api/admin/users"] })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                baseUrl: {
-                    type: 'string',
-                    description: 'Base URL prefix (e.g. "https://chat.qwen.ai") — trailing slash will be stripped',
-                },
-                paths: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Paths to probe (e.g. ["/api/v1/users", "/api/v1/chats"])',
-                },
-                method: {
-                    type: 'string',
-                    enum: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'],
-                    description: 'HTTP method for all probes (default: GET)',
-                    default: 'GET',
-                },
-                headers: {
-                    type: 'object',
-                    description: 'Additional HTTP headers to include in all requests',
-                    additionalProperties: { type: 'string' },
-                },
-                bodyTemplate: {
-                    type: 'string',
-                    description: 'JSON body string to send for POST/PUT/PATCH requests (optional)',
-                },
-                includeBodyStatuses: {
-                    type: 'array',
-                    items: { type: 'number' },
-                    description: 'Status codes for which to include response body snippet (default: [200, 201, 204])',
-                },
-                maxBodySnippetLength: {
-                    type: 'number',
-                    description: 'Max characters per response body snippet (default: 500)',
-                    default: 500,
-                },
-                autoInjectAuth: {
-                    type: 'boolean',
-                    description: 'Auto-inject Bearer token from localStorage (token / active_token / access_token). Default: true.',
-                    default: true,
-                },
+            contextAfter: {
+                type: 'number',
+                description: 'Characters of context after match (default: 80)',
             },
-            required: ['baseUrl', 'paths'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: 'register_account_flow',
-        description: 'Automated account registration flow with email verification.\n\nHandles the full flow:\n1. Navigate to registration page\n2. Fill in account fields (username, email, password, etc.)\n3. Submit registration form\n4. Open temporary email provider in a new tab\n5. Wait for and extract verification link/code\n6. Navigate to verification URL or fill in the code\n7. Return complete flow result\n\nUSE THIS instead of manually coordinating page_type + page_click + tab_workflow + dom_find_by_text for registration flows.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                registerUrl: {
-                    type: 'string',
-                    description: 'URL of the registration page',
-                },
-                fields: {
-                    type: 'object',
-                    description: 'Form field values keyed by input name attribute (e.g. {"email": "...", "password": "..."})',
-                    additionalProperties: { type: 'string' },
-                },
-                submitSelector: {
-                    type: 'string',
-                    description: 'CSS selector for the submit button (default: "button[type=\'submit\']")',
-                    default: "button[type='submit']",
-                },
-                emailProviderUrl: {
-                    type: 'string',
-                    description: 'URL of the temporary email provider page (e.g. https://www.linshiyouxiang.net)',
-                },
-                emailSelector: {
-                    type: 'string',
-                    description: 'CSS selector for the current email address element in the provider page',
-                },
-                verificationLinkPattern: {
-                    type: 'string',
-                    description: 'URL pattern to identify the verification link in emails (e.g. "/auth/activate", "/verify")',
-                },
-                checkboxSelectors: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'CSS selectors for checkboxes to click before submitting (terms of service, etc.)',
-                },
-                timeoutMs: {
-                    type: 'number',
-                    description: 'Total timeout for the entire flow in milliseconds (default: 60000)',
-                    default: 60000,
-                },
-            },
-            required: ['registerUrl', 'fields'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: 'batch_register',
-        description: 'Batch account registration with concurrency control, retry policies, and idempotency.\n\n' +
-            'Executes register_account_flow for multiple accounts in parallel, with:\n' +
-            '- Configurable max concurrency\n' +
-            '- Per-account retry with exponential backoff\n' +
-            '- Idempotent key (email/username) to skip already-succeeded accounts\n' +
-            '- Aggregated success/failure summary\n\n' +
-            'Example:\n' +
-            '  batch_register({\n' +
-            '    registerUrl: "https://example.com/register",\n' +
-            '    accounts: [\n' +
-            '      { fields: { email: "a@temp.mail", password: "Pass1!" } },\n' +
-            '      { fields: { email: "b@temp.mail", password: "Pass2!" } }\n' +
-            '    ],\n' +
-            '    maxConcurrency: 2\n' +
-            '  })',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                registerUrl: {
-                    type: 'string',
-                    description: 'URL of the registration page (shared across all accounts)',
-                },
-                accounts: {
-                    type: 'array',
-                    description: 'Array of account configurations',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            fields: {
-                                type: 'object',
-                                description: 'Form field values for this account',
-                                additionalProperties: { type: 'string' },
-                            },
-                            submitSelector: { type: 'string' },
-                            emailProviderUrl: { type: 'string' },
-                            emailSelector: { type: 'string' },
-                            verificationLinkPattern: { type: 'string' },
-                            checkboxSelectors: {
-                                type: 'array',
-                                items: { type: 'string' },
-                            },
-                        },
-                        required: ['fields'],
-                    },
-                },
-                maxConcurrency: {
-                    type: 'integer',
-                    description: 'Maximum parallel registrations (default: 2)',
-                    default: 2,
-                },
-                maxRetries: {
-                    type: 'integer',
-                    description: 'Max retries per account on failure (default: 1)',
-                    default: 1,
-                },
-                retryBackoffMs: {
-                    type: 'number',
-                    description: 'Initial retry backoff in ms (default: 2000)',
-                    default: 2000,
-                },
-                timeoutPerAccountMs: {
-                    type: 'number',
-                    description: 'Timeout per individual registration in ms (default: 90000)',
-                    default: 90000,
-                },
-                submitSelector: {
-                    type: 'string',
-                    description: 'Default submit button selector for all accounts',
-                    default: "button[type='submit']",
-                },
-            },
-            required: ['registerUrl', 'accounts'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
-        },
-    },
-    {
-        name: 'list_extension_workflows',
-        description: 'List runtime-loaded extension workflows discovered from plugins/ or workflows/ directories, including metadata needed before execution.',
-        inputSchema: {
-            type: 'object',
-            properties: {},
-            additionalProperties: false,
-        },
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            idempotentHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
-        name: 'run_extension_workflow',
-        description: 'Execute a runtime-loaded extension workflow contract by workflowId. Supports config overrides, per-node input overrides, and an optional timeout override.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                workflowId: {
-                    type: 'string',
-                    description: 'Registered extension workflow id to execute',
-                },
-                profile: {
-                    type: 'string',
-                    description: 'Optional profile label exposed to the workflow execution context',
-                },
-                config: {
-                    type: 'object',
-                    description: 'Optional config overrides read through ctx.getConfig(path, fallback)',
-                    additionalProperties: true,
-                },
-                nodeInputOverrides: {
-                    type: 'object',
-                    description: 'Optional shallow input overrides keyed by workflow node id',
-                    additionalProperties: {
-                        type: 'object',
-                        additionalProperties: true,
-                    },
-                },
-                timeoutMs: {
-                    type: 'number',
-                    description: 'Optional override for total workflow timeout in milliseconds',
-                },
-            },
-            required: ['workflowId'],
-        },
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: false,
-            idempotentHint: false,
-            openWorldHint: true,
         },
-    },
+        required: ['name', 'regex'],
+    }, 'Named regex patterns to search for')
+        .boolean('cacheBundle', 'Cache the bundle for 5 minutes to avoid re-downloads', {
+        default: true,
+    })
+        .boolean('stripNoise', 'Skip matches inside SVG path data or base64 blobs', { default: true })
+        .number('maxMatches', 'Maximum matches to return per pattern', { default: 10 })
+        .required('url', 'patterns')
+        .openWorld()
+        .build(),
+    tool('page_script_register')
+        .desc('Register a named reusable JavaScript snippet in the Script Library.\n\nCore ships built-in snippets such as `auth_extract`, `bundle_search`, `react_fill_form`, and `dom_find_upgrade_buttons`.\n\nRegistered scripts are executed with `page_script_run`. Scripts may reference `__params__` (set at call time via page_script_run params).')
+        .string('name', 'Unique script name (e.g. "my_extractor")')
+        .string('code', 'JavaScript expression/IIFE to register. Use `typeof __params__ !== "undefined" ? __params__ : {}` to safely access runtime parameters.')
+        .string('description', 'Optional human-readable description of the script')
+        .required('name', 'code')
+        .build(),
+    tool('page_script_run')
+        .desc('Execute a named script from the Script Library in the current page context.\n\nOptionally inject runtime parameters accessible as `__params__` inside the script.\n\nExample:\n  page_script_run({ name: "bundle_search", params: { url: "https://cdn.main.js", patterns: ["tier", "subscription"] } })\n  page_script_run({ name: "auth_extract" })')
+        .string('name', 'Script name to run (built-in or registered)')
+        .prop('params', {
+        type: 'object',
+        additionalProperties: true,
+        description: 'Optional parameters injected as __params__ (must be JSON-serializable)',
+    })
+        .required('name')
+        .openWorld()
+        .build(),
+    tool('api_probe_batch')
+        .desc('Probe multiple API endpoints in a single browser-context fetch burst.\n\nAuto-injects Bearer token from localStorage[token] / localStorage[active_token]. Returns status codes, content types, and response snippets for matching statuses. Skips HTML responses (login-redirect false-positives).\n\nReplaces 5–30 individual page_evaluate fetch calls with one tool call.\n\n**ALWAYS start with OpenAPI/Swagger discovery paths first** — a single 200 response gives you the full API schema:\n  "/docs", "/openapi.json", "/api/docs", "/swagger.json", "/api/v1/openapi.json", "/api/openapi.json"\n\nExample:\n  api_probe_batch({ baseUrl: "https://chat.qwen.ai", paths: ["/docs", "/openapi.json", "/api/v1/users/me", "/api/v1/chats/", "/api/admin/users"] })')
+        .string('baseUrl', 'Base URL prefix (e.g. "https://chat.qwen.ai") — trailing slash will be stripped')
+        .array('paths', { type: 'string' }, 'Paths to probe (e.g. ["/api/v1/users", "/api/v1/chats"])')
+        .enum('method', ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'], 'HTTP method for all probes', { default: 'GET' })
+        .object('headers', { additionalProperties: { type: 'string' } }, 'Additional HTTP headers to include in all requests')
+        .string('bodyTemplate', 'JSON body string to send for POST/PUT/PATCH requests (optional)')
+        .array('includeBodyStatuses', { type: 'number' }, 'Status codes for which to include response body snippet (default: [200, 201, 204])')
+        .number('maxBodySnippetLength', 'Max characters per response body snippet', { default: 500 })
+        .boolean('autoInjectAuth', 'Auto-inject Bearer token from localStorage (token / active_token / access_token).', { default: true })
+        .required('baseUrl', 'paths')
+        .openWorld()
+        .build(),
+    tool('register_account_flow')
+        .desc('Automated account registration flow with email verification.\n\nHandles the full flow:\n1. Navigate to registration page\n2. Fill in account fields (username, email, password, etc.)\n3. Submit registration form\n4. Open temporary email provider in a new tab\n5. Wait for and extract verification link/code\n6. Navigate to verification URL or fill in the code\n7. Return complete flow result\n\nUSE THIS instead of manually coordinating page_type + page_click + tab_workflow + dom_find_by_text for registration flows.')
+        .string('registerUrl', 'URL of the registration page')
+        .object('fields', { additionalProperties: { type: 'string' } }, 'Form field values keyed by input name attribute (e.g. {"email": "...", "password": "..."})')
+        .string('submitSelector', 'CSS selector for the submit button', {
+        default: "button[type='submit']",
+    })
+        .string('emailProviderUrl', 'URL of the temporary email provider page (e.g. https://www.linshiyouxiang.net)')
+        .string('emailSelector', 'CSS selector for the current email address element in the provider page')
+        .string('verificationLinkPattern', 'URL pattern to identify the verification link in emails (e.g. "/auth/activate", "/verify")')
+        .array('checkboxSelectors', { type: 'string' }, 'CSS selectors for checkboxes to click before submitting (terms of service, etc.)')
+        .number('timeoutMs', 'Total timeout for the entire flow in milliseconds', { default: 60000 })
+        .required('registerUrl', 'fields')
+        .openWorld()
+        .build(),
+    tool('batch_register')
+        .desc('Batch account registration with concurrency control, retry policies, and idempotency.\n\nExecutes register_account_flow for multiple accounts in parallel, with:\n- Configurable max concurrency\n- Per-account retry with exponential backoff\n- Idempotent key (email/username) to skip already-succeeded accounts\n- Aggregated success/failure summary\n\nExample:\n  batch_register({\n    registerUrl: "https://example.com/register",\n    accounts: [\n      { fields: { email: "a@temp.mail", password: "Pass1!" } },\n      { fields: { email: "b@temp.mail", password: "Pass2!" } }\n    ],\n    maxConcurrency: 2\n  })')
+        .string('registerUrl', 'URL of the registration page (shared across all accounts)')
+        .array('accounts', {
+        type: 'object',
+        properties: {
+            fields: { type: 'object', additionalProperties: { type: 'string' } },
+            submitSelector: { type: 'string' },
+            emailProviderUrl: { type: 'string' },
+            emailSelector: { type: 'string' },
+            verificationLinkPattern: { type: 'string' },
+            checkboxSelectors: { type: 'array', items: { type: 'string' } },
+        },
+        required: ['fields'],
+    }, 'Array of account configurations')
+        .number('maxConcurrency', 'Maximum parallel registrations', { default: 2 })
+        .number('maxRetries', 'Max retries per account on failure', { default: 1 })
+        .number('retryBackoffMs', 'Initial retry backoff in ms', { default: 2000 })
+        .number('timeoutPerAccountMs', 'Timeout per individual registration in ms', { default: 90000 })
+        .string('submitSelector', 'Default submit button selector for all accounts', {
+        default: "button[type='submit']",
+    })
+        .required('registerUrl', 'accounts')
+        .openWorld()
+        .build(),
+    tool('list_extension_workflows')
+        .desc('List runtime-loaded extension workflows discovered from plugins/ or workflows/ directories, including metadata needed before execution.')
+        .readOnly()
+        .idempotent()
+        .build(),
+    tool('run_extension_workflow')
+        .desc('Execute a runtime-loaded extension workflow contract by workflowId. Supports config overrides, per-node input overrides, and an optional timeout override.')
+        .string('workflowId', 'Registered extension workflow id to execute')
+        .string('profile', 'Optional profile label exposed to the workflow execution context')
+        .prop('config', {
+        type: 'object',
+        additionalProperties: true,
+        description: 'Optional config overrides read through ctx.getConfig(path, fallback)',
+    })
+        .prop('nodeInputOverrides', {
+        type: 'object',
+        additionalProperties: { type: 'object', additionalProperties: true },
+        description: 'Optional shallow input overrides keyed by workflow node id',
+    })
+        .number('timeoutMs', 'Optional override for total workflow timeout in milliseconds')
+        .required('workflowId')
+        .openWorld()
+        .build(),
 ];

package/dist/src/server/domains/workflow/handlers.impl.workflow-account-bundle.js

@@ -244,7 +244,7 @@ export class WorkflowHandlersAccountBundle extends WorkflowHandlersApi {
                     catch (e) {
                         if (e instanceof Error && e.message.startsWith('Blocked:'))
                             throw e;
-                        throw new Error(`DNS resolution failed for "${currentUrl}"`);
+                        throw new Error(`DNS resolution failed for "${currentUrl}"`, { cause: e });
                     }
                 }
                 if (!fetchUrl.startsWith('https://') && !LOOPBACK_HTTP_URL_RE.test(fetchUrl)) {