ios-webkit-mcp 0.18.3

package/build/src/tools/drag.js

@@ -0,0 +1,202 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+/**
+ * WIP gotcha: `Runtime.evaluate` with `awaitPromise:true` does NOT correctly
+ * serialize the resolved value of a returned Promise (even `Promise.resolve(42)`
+ * comes back as `{}`). So this tool keeps the inner expression synchronous.
+ * Per-step delay is implemented by issuing one Runtime.evaluate per pointermove
+ * step from TS land when `stepDelayMs > 0`. When `stepDelayMs === 0`, the entire
+ * sequence runs in a single sync IIFE.
+ */
+export const dragTool = {
+    name: 'drag',
+    description: [
+        'Drag from a source element to a target element (or by pixel offset) on the inspected iOS WebView page.',
+        'NOTE: WIP has no `Input.dispatchTouch/MouseEvent`. Synthetic pointer sequence (`pointerdown` → N × `pointermove` → `pointerup`, mirrored for mouse) via `Runtime.evaluate`. iOS gesture recognizers (UIPanGestureRecognizer / native scroll) will NOT fire because no real touch reaches the WebView host. Useful for JS-implemented drag handlers; useless for native scroll triggers.',
+        'Provide exactly one destination: `toSelector` (element-to-element) OR `dx`/`dy` (offset from source center).',
+    ].join(' '),
+    inputSchema: {
+        fromSelector: z.string().min(1).describe('CSS selector for the source element.'),
+        fromNth: z.number().int().min(0).optional().describe('Source nth match. Default 0.'),
+        toSelector: z.string().min(1).optional().describe('CSS selector for the destination element. Mutually exclusive with dx/dy.'),
+        toNth: z.number().int().min(0).optional().describe('Destination nth match. Default 0.'),
+        dx: z.number().optional().describe('X offset (CSS px) from source center. Mutually exclusive with toSelector.'),
+        dy: z.number().optional().describe('Y offset (CSS px) from source center. Mutually exclusive with toSelector.'),
+        steps: z.number().int().min(2).max(120).optional().describe('Number of pointermove steps between start and end. Default 12.'),
+        stepDelayMs: z.number().int().min(0).max(200).optional().describe('Delay between move steps. Default 12.'),
+        waitAfterMs: z.number().int().min(0).max(10_000).optional().describe('Block after release for this long (default 200).'),
+    },
+    handler: async ({ fromSelector, fromNth = 0, toSelector, toNth = 0, dx, dy, steps = 12, stepDelayMs = 12, waitAfterMs = 200, }) => {
+        const offsetMode = dx !== undefined || dy !== undefined;
+        if (offsetMode && toSelector !== undefined) {
+            return errorResult('Provide either `toSelector` OR `dx`/`dy`, not both.');
+        }
+        if (!offsetMode && toSelector === undefined) {
+            return errorResult('Provide one of: `toSelector` or `dx`/`dy`.');
+        }
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const fromJson = JSON.stringify(fromSelector);
+        const toJson = toSelector !== undefined ? JSON.stringify(toSelector) : 'null';
+        const prelude = `
+      (() => {
+        const fromMatches = document.querySelectorAll(${fromJson});
+        if (fromMatches.length === 0) return { ok: false, reason: 'from_no_match', selector: ${fromJson} };
+        if (${fromNth} >= fromMatches.length) return { ok: false, reason: 'from_nth_out_of_range', found: fromMatches.length };
+        const src = fromMatches[${fromNth}];
+        const srcRect = src.getBoundingClientRect();
+        const sx = srcRect.x + srcRect.width / 2;
+        const sy = srcRect.y + srcRect.height / 2;
+        let ex, ey, dstTag = null;
+        if (${toJson} !== null) {
+          const toMatches = document.querySelectorAll(${toJson});
+          if (toMatches.length === 0) return { ok: false, reason: 'to_no_match', selector: ${toJson} };
+          if (${toNth} >= toMatches.length) return { ok: false, reason: 'to_nth_out_of_range', found: toMatches.length };
+          const dst = toMatches[${toNth}];
+          const r = dst.getBoundingClientRect();
+          ex = r.x + r.width / 2;
+          ey = r.y + r.height / 2;
+          dstTag = dst.tagName.toLowerCase();
+        } else {
+          ex = sx + ${dx ?? 0};
+          ey = sy + ${dy ?? 0};
+        }
+        window.__wdm_drag = { src, sx, sy, ex, ey };
+        return { ok: true, fromTag: src.tagName.toLowerCase(), dstTag, sx, sy, ex, ey };
+      })()
+    `;
+        let pre;
+        try {
+            pre = await ps.session.send('Runtime.evaluate', { expression: prelude, returnByValue: true, awaitPromise: false }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (drag prelude) failed: ${describe(e)}`);
+        }
+        const preVal = pre?.result?.value;
+        if (!preVal || preVal.ok !== true) {
+            return errorResult(`# drag: failed at prelude\n\n${JSON.stringify(preVal)}`);
+        }
+        const fireSnippet = `(() => {
+      const d = window.__wdm_drag;
+      const src = d.src;
+      const fire = (type, x, y, evCtor, buttons) => {
+        src.dispatchEvent(new evCtor(type, {
+          bubbles: true, cancelable: true,
+          clientX: x, clientY: y,
+          pointerType: 'mouse', pointerId: 1, isPrimary: true,
+          button: 0, buttons: buttons != null ? buttons : 1,
+        }));
+      };
+      return fire;
+    })()`;
+        const downSync = `
+      (() => {
+        const d = window.__wdm_drag;
+        const src = d.src;
+        const init = { bubbles: true, cancelable: true, clientX: d.sx, clientY: d.sy, pointerType: 'mouse', pointerId: 1, isPrimary: true, button: 0, buttons: 1 };
+        src.dispatchEvent(new PointerEvent('pointerdown', init));
+        src.dispatchEvent(new MouseEvent('mousedown', init));
+        return { ok: true };
+      })()
+    `;
+        const moveSync = (t) => `
+      (() => {
+        const d = window.__wdm_drag;
+        const src = d.src;
+        const t = ${t};
+        const mx = d.sx + (d.ex - d.sx) * t;
+        const my = d.sy + (d.ey - d.sy) * t;
+        const init = { bubbles: true, cancelable: true, clientX: mx, clientY: my, pointerType: 'mouse', pointerId: 1, isPrimary: true, button: 0, buttons: 1 };
+        src.dispatchEvent(new PointerEvent('pointermove', init));
+        src.dispatchEvent(new MouseEvent('mousemove', init));
+        return { ok: true };
+      })()
+    `;
+        const upSync = `
+      (() => {
+        const d = window.__wdm_drag;
+        const src = d.src;
+        const init = { bubbles: true, cancelable: true, clientX: d.ex, clientY: d.ey, pointerType: 'mouse', pointerId: 1, isPrimary: true, button: 0, buttons: 0 };
+        src.dispatchEvent(new PointerEvent('pointerup', init));
+        src.dispatchEvent(new MouseEvent('mouseup', init));
+        return { ok: true };
+      })()
+    `;
+        const allInOne = `
+      (() => {
+        const d = window.__wdm_drag;
+        const src = d.src;
+        const steps = ${steps};
+        const fire = (type, x, y, evCtor, buttons) => {
+          src.dispatchEvent(new evCtor(type, {
+            bubbles: true, cancelable: true,
+            clientX: x, clientY: y,
+            pointerType: 'mouse', pointerId: 1, isPrimary: true,
+            button: 0, buttons: buttons != null ? buttons : 1,
+          }));
+        };
+        fire('pointerdown', d.sx, d.sy, PointerEvent);
+        fire('mousedown', d.sx, d.sy, MouseEvent);
+        for (let i = 1; i <= steps; i++) {
+          const t = i / steps;
+          const mx = d.sx + (d.ex - d.sx) * t;
+          const my = d.sy + (d.ey - d.sy) * t;
+          fire('pointermove', mx, my, PointerEvent);
+          fire('mousemove', mx, my, MouseEvent);
+        }
+        fire('pointerup', d.ex, d.ey, PointerEvent, 0);
+        fire('mouseup', d.ex, d.ey, MouseEvent, 0);
+        return { ok: true, steps };
+      })()
+    `;
+        try {
+            if (stepDelayMs === 0) {
+                const r = await ps.session.send('Runtime.evaluate', { expression: allInOne, returnByValue: true, awaitPromise: false }, 15_000);
+                const v = r?.result?.value;
+                if (!v || v.ok !== true) {
+                    return errorResult(`# drag: failed at all-in-one\n\n${JSON.stringify(v)}`);
+                }
+            }
+            else {
+                await ps.session.send('Runtime.evaluate', { expression: downSync, returnByValue: true, awaitPromise: false }, 10_000);
+                for (let i = 1; i <= steps; i++) {
+                    await ps.session.send('Runtime.evaluate', { expression: moveSync(i / steps), returnByValue: true, awaitPromise: false }, 10_000);
+                    if (i < steps)
+                        await new Promise(r => setTimeout(r, stepDelayMs));
+                }
+                await ps.session.send('Runtime.evaluate', { expression: upSync, returnByValue: true, awaitPromise: false }, 10_000);
+            }
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (drag loop) failed: ${describe(e)}`);
+        }
+        if (waitAfterMs > 0) {
+            await new Promise(r => setTimeout(r, waitAfterMs));
+        }
+        void fireSnippet; // referenced for documentation; not executed
+        return textResult([
+            `# drag ✓`,
+            '',
+            `from: \`<${preVal.fromTag}>\` @ (${preVal.sx.toFixed(1)}, ${preVal.sy.toFixed(1)})`,
+            `to: ${preVal.dstTag ? `\`<${preVal.dstTag}>\` @ ` : ''}(${preVal.ex.toFixed(1)}, ${preVal.ey.toFixed(1)})`,
+            `steps: ${steps}${stepDelayMs > 0 ? ` (per-step, ${stepDelayMs}ms between)` : ' (single sync round-trip)'}`,
+            '',
+            '⚠ Synthetic Pointer/Mouse drag. No native iOS gesture recognizers fire — useful only for handlers attached in JS (e.g. `pointerdown` listeners, `react-dnd`, sortable libs). Native scroll / pinch / pan will NOT respond.',
+        ].join('\n'));
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describe(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=drag.js.map

package/build/src/tools/drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.js","sourceRoot":"","sources":["../../../src/tools/drag.ts"],"names":[],"mappings":"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"}

package/build/src/tools/evaluate_script.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export declare const evaluateScriptTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        expression: z.ZodString;
+        pageId: z.ZodOptional<z.ZodString>;
+        awaitPromise: z.ZodOptional<z.ZodBoolean>;
+        returnByValue: z.ZodOptional<z.ZodBoolean>;
+        proxyDeviceListUrl: z.ZodOptional<z.ZodString>;
+    };
+    handler: ({ expression, pageId, awaitPromise, returnByValue, proxyDeviceListUrl, }: {
+        expression: string;
+        pageId?: string;
+        awaitPromise?: boolean;
+        returnByValue?: boolean;
+        proxyDeviceListUrl?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/evaluate_script.js

@@ -0,0 +1,172 @@
+import { z } from 'zod';
+import { fetchProxyDevices, fetchDevicePages } from '../wip-client/iwdp-http.js';
+import { WipSession } from '../wip-client/ws-session.js';
+import { PageSession } from '../page-session.js';
+const DEFAULT_PROXY_BASE = 'http://127.0.0.1:9221';
+export const evaluateScriptTool = {
+    name: 'evaluate_script',
+    description: [
+        'Evaluate a JavaScript expression in the inspected iOS WebView page.',
+        'Wraps WIP `Runtime.evaluate`. Returns the value (when returnByValue=true) or a description string.',
+        'If pageId is omitted the first inspectable page on the first device is used.',
+        'Requires `ios_webkit_debug_proxy` running + iPhone connected + isInspectable=true.',
+    ].join(' '),
+    inputSchema: {
+        expression: z
+            .string()
+            .min(1)
+            .describe('JavaScript expression to evaluate (e.g. `1+1`, `document.title`, `JSON.stringify(window.location)`)'),
+        pageId: z
+            .string()
+            .optional()
+            .describe('Page id from list_pages output. If omitted, uses the first available page.'),
+        awaitPromise: z
+            .boolean()
+            .optional()
+            .describe('If the expression returns a Promise, wait for it to settle (default true).'),
+        returnByValue: z
+            .boolean()
+            .optional()
+            .describe('Serialize the result by value (default true). Set false to keep an objectId reference.'),
+        proxyDeviceListUrl: z
+            .string()
+            .url()
+            .optional()
+            .describe(`Base URL of ios_webkit_debug_proxy's device-list endpoint (default ${DEFAULT_PROXY_BASE})`),
+    },
+    handler: async ({ expression, pageId, awaitPromise = true, returnByValue = true, proxyDeviceListUrl, }) => {
+        // Default mode (pageId omitted): use the shared PageSession so that
+        // Network / Console events fired by this expression flow into the same
+        // ws that list_console_messages / list_network_requests subscribe to.
+        // WIP per-ws Network.enable state is isolated, so a transient session
+        // would receive events that the persistent session never sees.
+        //
+        // Explicit pageId mode: open a transient session — useful for poking
+        // a non-default target (worker, secondary page) without disturbing
+        // the persistent attach.
+        let chosenPageMeta;
+        let evalResult;
+        let usingShared = false;
+        if (pageId == null && proxyDeviceListUrl == null) {
+            try {
+                const ps = await PageSession.get();
+                const info = ps.attachInfo;
+                chosenPageMeta = { device: info.deviceId, id: info.pageId, title: info.pageTitle, url: info.pageUrl };
+                evalResult = await ps.session.send('Runtime.evaluate', {
+                    expression,
+                    returnByValue,
+                    awaitPromise,
+                    generatePreview: true,
+                });
+                usingShared = true;
+            }
+            catch (e) {
+                return errorResult(`Runtime.evaluate (shared session) failed: ${describeError(e)}`);
+            }
+        }
+        else {
+            // Transient session path.
+            const base = proxyDeviceListUrl ?? DEFAULT_PROXY_BASE;
+            let devices;
+            try {
+                devices = await fetchProxyDevices(base);
+            }
+            catch (e) {
+                return errorResult(`Failed to reach ios_webkit_debug_proxy at ${base}: ${describeError(e)}`);
+            }
+            if (devices.length === 0) {
+                return errorResult('No iOS devices found. Connect an iPhone via USB, trust this Mac, and ensure Settings > Safari > Advanced > Web Inspector = ON.');
+            }
+            let chosenPageUrl;
+            let chosenMeta;
+            for (const dev of devices) {
+                let pages;
+                try {
+                    pages = await fetchDevicePages(dev.url);
+                }
+                catch {
+                    continue;
+                }
+                let match;
+                if (pageId != null) {
+                    match = pages.find(p => p.id === pageId);
+                }
+                else {
+                    match = pages.find(p => p.url && !p.title.startsWith('jsi_')) ?? pages[0];
+                }
+                if (match) {
+                    chosenPageUrl = match.webSocketDebuggerUrl;
+                    chosenMeta = { device: dev.deviceId, id: match.id, title: match.title, url: match.url };
+                    break;
+                }
+            }
+            if (!chosenPageUrl || !chosenMeta) {
+                return errorResult(pageId == null
+                    ? 'No inspectable pages available. Open a WebView page in the target app first (run `list_pages` to verify).'
+                    : `Page id "${pageId}" not found. Run \`list_pages\` to see available ids.`);
+            }
+            chosenPageMeta = chosenMeta;
+            const session = new WipSession();
+            try {
+                await session.connect(chosenPageUrl);
+                await session.waitForPageTarget();
+                evalResult = await session.send('Runtime.evaluate', {
+                    expression,
+                    returnByValue,
+                    awaitPromise,
+                    generatePreview: true,
+                });
+            }
+            catch (e) {
+                session.close();
+                return errorResult(`Runtime.evaluate (transient) failed: ${describeError(e)}`);
+            }
+            finally {
+                session.close();
+            }
+        }
+        const lines = [];
+        lines.push(`# Runtime.evaluate result`);
+        lines.push('');
+        lines.push(`Target: device \`${chosenPageMeta.device.slice(0, 12)}…\` · page id \`${chosenPageMeta.id}\` · ${chosenPageMeta.title || chosenPageMeta.url}${usingShared ? ' (shared session)' : ' (transient session)'}`);
+        lines.push('');
+        lines.push('```js');
+        lines.push(expression.length > 200 ? expression.slice(0, 200) + '…' : expression);
+        lines.push('```');
+        lines.push('');
+        const ro = evalResult.result;
+        if (evalResult.wasThrown) {
+            lines.push(`**Threw**: ${ro.description ?? ro.value ?? '(no description)'}`);
+        }
+        else if (returnByValue && 'value' in ro) {
+            lines.push(`**Value** (${ro.type}${ro.subtype ? '/' + ro.subtype : ''}):`);
+            lines.push('```json');
+            try {
+                lines.push(JSON.stringify(ro.value, null, 2));
+            }
+            catch {
+                lines.push(String(ro.value));
+            }
+            lines.push('```');
+        }
+        else {
+            lines.push(`**Result** (${ro.type}${ro.subtype ? '/' + ro.subtype : ''}): ${ro.description ?? ro.className ?? '(no description)'}`);
+            if (ro.objectId) {
+                lines.push(`objectId: \`${ro.objectId}\``);
+            }
+        }
+        return textResult(lines.join('\n'));
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describeError(e) {
+    if (e instanceof Error)
+        return e.message;
+    return String(e);
+}
+//# sourceMappingURL=evaluate_script.js.map

package/build/src/tools/evaluate_script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate_script.js","sourceRoot":"","sources":["../../../src/tools/evaluate_script.ts"],"names":[],"mappings":"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"}

package/build/src/tools/fill.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const fillTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        selector: z.ZodString;
+        value: z.ZodString;
+        nth: z.ZodOptional<z.ZodNumber>;
+        waitAfterMs: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ selector, value, nth, waitAfterMs, }: {
+        selector: string;
+        value: string;
+        nth?: number;
+        waitAfterMs?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};

package/build/src/tools/fill.js

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { PageSession } from '../page-session.js';
+export const fillTool = {
+    name: 'fill',
+    description: [
+        'Set the value of an input / textarea / contenteditable on the inspected iOS WebView page in one shot.',
+        'NOTE: WIP has no `Input.*` domain. This tool runs `Runtime.evaluate` to assign `el.value` (via the native setter so React `onChange` fires) and dispatches synthetic `input` + `change` events. Real key sequences are NOT simulated — for per-keystroke behavior use `type_text`.',
+        'Selector matches via `document.querySelectorAll(selector)[nth]`.',
+    ].join(' '),
+    inputSchema: {
+        selector: z.string().min(1).describe('CSS selector for the input / textarea / contenteditable element.'),
+        value: z.string().describe('Text to fill. Empty string is allowed (clears the field).'),
+        nth: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('When the selector matches multiple, pick the Nth (0-indexed). Default 0.'),
+        waitAfterMs: z
+            .number()
+            .int()
+            .min(0)
+            .max(10_000)
+            .optional()
+            .describe('Block after fill for this long (default 100) so subsequent reads see post-fill state.'),
+    },
+    handler: async ({ selector, value, nth = 0, waitAfterMs = 100, }) => {
+        let ps;
+        try {
+            ps = await PageSession.get();
+        }
+        catch (e) {
+            return errorResult(`Unable to attach to a WKWebView page: ${describe(e)}`);
+        }
+        const selJson = JSON.stringify(selector);
+        const valJson = JSON.stringify(value);
+        const expression = `
+      (() => {
+        const matches = document.querySelectorAll(${selJson});
+        if (matches.length === 0) return { ok: false, reason: 'no_match', selector: ${selJson} };
+        if (${nth} >= matches.length) return { ok: false, reason: 'nth_out_of_range', found: matches.length };
+        const el = matches[${nth}];
+        const tag = el.tagName.toLowerCase();
+        const isInput = tag === 'input' || tag === 'textarea';
+        const isCE = el.isContentEditable === true;
+        if (!isInput && !isCE) return { ok: false, reason: 'not_fillable', tag };
+        try {
+          el.focus();
+          if (isInput) {
+            const proto = tag === 'input' ? HTMLInputElement.prototype : HTMLTextAreaElement.prototype;
+            const setter = Object.getOwnPropertyDescriptor(proto, 'value') && Object.getOwnPropertyDescriptor(proto, 'value').set;
+            if (setter) setter.call(el, ${valJson}); else el.value = ${valJson};
+          } else {
+            el.textContent = ${valJson};
+          }
+          el.dispatchEvent(new Event('input', { bubbles: true }));
+          el.dispatchEvent(new Event('change', { bubbles: true }));
+        } catch (e) {
+          return { ok: false, reason: 'fill_threw', error: String(e), tag };
+        }
+        return {
+          ok: true,
+          tag,
+          mode: isInput ? 'value-setter' : 'contenteditable',
+          valueLen: ${valJson}.length,
+          foundCount: matches.length,
+        };
+      })()
+    `;
+        let result;
+        try {
+            result = await ps.session.send('Runtime.evaluate', { expression, returnByValue: true, awaitPromise: false }, 10_000);
+        }
+        catch (e) {
+            return errorResult(`Runtime.evaluate (fill) failed: ${describe(e)}`);
+        }
+        if (waitAfterMs > 0) {
+            await new Promise(r => setTimeout(r, waitAfterMs));
+        }
+        const v = result?.result?.value;
+        if (!v || v.ok !== true) {
+            return errorResult(`# fill: failed\n\nselector: \`${selector}\`\n\n${JSON.stringify(v)}`);
+        }
+        return textResult([
+            `# fill ✓ ${selector}`,
+            '',
+            `tag: \`<${v.tag}>\` (mode: ${v.mode})`,
+            `value length: ${v.valueLen}`,
+            `match count: ${v.foundCount} (picked nth=${nth})`,
+            '',
+            '⚠ Synthetic `value = …` + `input` / `change` events. Listeners depending on per-key events (composition, IME, key counters) will NOT fire. Use `type_text` for keystroke-level simulation.',
+        ].join('\n'));
+    },
+};
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+function describe(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=fill.js.map

package/build/src/tools/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/tools/fill.ts"],"names":[],"mappings":"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"}

package/build/src/tools/fill_form.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const fillFormTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        fields: z.ZodArray<z.ZodObject<{
+            selector: z.ZodString;
+            value: z.ZodString;
+            nth: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            selector: string;
+            nth?: number | undefined;
+        }, {
+            value: string;
+            selector: string;
+            nth?: number | undefined;
+        }>, "many">;
+        waitAfterMs: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: ({ fields, waitAfterMs, }: {
+        fields: Array<{
+            selector: string;
+            value: string;
+            nth?: number;
+        }>;
+        waitAfterMs?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};