@ai2qa/local-agent 0.1.0

package/dist/server.js

@@ -0,0 +1,387 @@
+"use strict";
+/**
+ * MCP Server
+ *
+ * Model Context Protocol server that exposes browser automation tools.
+ * Supports stdio transport for local AI tools (Claude Code, Cursor, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Ai2qaMcpServer = void 0;
+exports.createMcpServer = createMcpServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const connection_js_1 = require("./browser/connection.js");
+const websocket_js_1 = require("./transports/websocket.js");
+const types_js_2 = require("./tools/types.js");
+const navigate_js_1 = require("./tools/navigate.js");
+const click_js_1 = require("./tools/click.js");
+const fill_js_1 = require("./tools/fill.js");
+const hover_js_1 = require("./tools/hover.js");
+const press_key_js_1 = require("./tools/press-key.js");
+const screenshot_js_1 = require("./tools/screenshot.js");
+const snapshot_js_1 = require("./tools/snapshot.js");
+const wait_js_1 = require("./tools/wait.js");
+const evaluate_js_1 = require("./tools/evaluate.js");
+const report_js_1 = require("./tools/report.js");
+const knowledge_js_1 = require("./tools/knowledge.js");
+/** MCP tool definitions */
+const TOOLS = [
+    {
+        name: types_js_2.TOOL_NAMES.NAVIGATE,
+        description: 'Navigate to a URL or perform navigation actions (reload, back, forward)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'URL to navigate to' },
+                type: {
+                    type: 'string',
+                    enum: ['goto', 'reload', 'back', 'forward'],
+                    description: 'Navigation type (default: goto)',
+                },
+                timeout: { type: 'number', description: 'Timeout in milliseconds (default: 30000)' },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.CLICK,
+        description: 'Click on an element by CSS selector or ref ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: { type: 'string', description: 'CSS selector of element to click' },
+                ref: { type: 'string', description: 'Reference ID from snapshot (e.g., ref_0)' },
+                button: { type: 'string', enum: ['left', 'right', 'middle'], description: 'Mouse button' },
+                clickCount: { type: 'number', description: 'Number of clicks (default: 1)' },
+                timeout: { type: 'number', description: 'Timeout in milliseconds' },
+            },
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.FILL,
+        description: 'Fill an input element with text',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: { type: 'string', description: 'CSS selector of input element' },
+                ref: { type: 'string', description: 'Reference ID from snapshot' },
+                value: { type: 'string', description: 'Text value to fill' },
+                clear: { type: 'boolean', description: 'Clear existing content first (default: true)' },
+                timeout: { type: 'number', description: 'Timeout in milliseconds' },
+            },
+            required: ['value'],
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.HOVER,
+        description: 'Hover over an element',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: { type: 'string', description: 'CSS selector of element' },
+                ref: { type: 'string', description: 'Reference ID from snapshot' },
+                timeout: { type: 'number', description: 'Timeout in milliseconds' },
+            },
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.PRESS_KEY,
+        description: 'Press a keyboard key or key combination',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                key: { type: 'string', description: 'Key to press (e.g., Enter, Tab, Escape)' },
+                modifiers: {
+                    type: 'array',
+                    items: { type: 'string', enum: ['Alt', 'Control', 'Meta', 'Shift'] },
+                    description: 'Modifier keys to hold',
+                },
+            },
+            required: ['key'],
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.SCREENSHOT,
+        description: 'Take a screenshot of the page or element',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                fullPage: { type: 'boolean', description: 'Capture full scrollable page' },
+                selector: { type: 'string', description: 'CSS selector of element to screenshot' },
+                format: { type: 'string', enum: ['png', 'jpeg'], description: 'Image format' },
+                quality: { type: 'number', description: 'JPEG quality (0-100)' },
+            },
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.SNAPSHOT,
+        description: 'Get a snapshot of the page DOM/accessibility tree for AI analysis',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                verbose: { type: 'boolean', description: 'Include interactive element refs' },
+                mode: {
+                    type: 'string',
+                    enum: ['accessibility', 'html', 'text'],
+                    description: 'Snapshot mode (default: accessibility)',
+                },
+            },
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.WAIT,
+        description: 'Wait for element, text, or duration',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                selector: { type: 'string', description: 'Wait for element selector' },
+                text: { type: 'string', description: 'Wait for text to appear' },
+                ms: { type: 'number', description: 'Wait for milliseconds' },
+                state: {
+                    type: 'string',
+                    enum: ['attached', 'detached', 'visible', 'hidden'],
+                    description: 'Element state to wait for',
+                },
+                timeout: { type: 'number', description: 'Maximum wait time' },
+            },
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.EVALUATE,
+        description: 'Execute JavaScript in page context',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                script: { type: 'string', description: 'JavaScript code to execute' },
+                args: { type: 'array', description: 'Arguments to pass to the script' },
+            },
+            required: ['script'],
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.REPORT_RESULTS,
+        description: 'Report test execution results back to AI2QA for learning',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Target domain (e.g., app.example.com)' },
+                results: {
+                    type: 'array',
+                    description: 'Results from using existing patterns',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            patternKey: { type: 'string', description: 'Pattern key that was used' },
+                            selectorUsed: { type: 'string', description: 'Actual selector used' },
+                            success: { type: 'boolean', description: 'Whether the pattern worked' },
+                            durationMs: { type: 'number', description: 'Execution time in ms' },
+                            errorMessage: { type: 'string', description: 'Error message if failed' },
+                        },
+                        required: ['patternKey', 'success'],
+                    },
+                },
+                newPatterns: {
+                    type: 'array',
+                    description: 'Newly discovered patterns to contribute',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            key: { type: 'string', description: 'Pattern key (e.g., login_button)' },
+                            selector: { type: 'string', description: 'CSS/XPath selector' },
+                            selectorType: {
+                                type: 'string',
+                                enum: ['CSS', 'XPATH', 'TEXT', 'ARIA', 'DATA_TESTID'],
+                                description: 'Type of selector',
+                            },
+                            patternType: {
+                                type: 'string',
+                                enum: ['SELECTOR', 'TIMING', 'AUTH', 'QUIRK'],
+                                description: 'Type of pattern',
+                            },
+                            value: { type: 'string', description: 'Value for non-selector patterns' },
+                            description: { type: 'string', description: 'Human-readable description' },
+                        },
+                        required: ['key'],
+                    },
+                },
+            },
+            required: ['domain'],
+        },
+    },
+    {
+        name: types_js_2.TOOL_NAMES.GET_KNOWLEDGE,
+        description: 'Fetch relevant QA patterns for a domain before testing',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: { type: 'string', description: 'Target domain (e.g., app.example.com)' },
+                flowName: { type: 'string', description: 'Optional: specific flow (login, checkout)' },
+                includeSelectors: { type: 'boolean', description: 'Include selector patterns (default: true)' },
+                includeQuirks: { type: 'boolean', description: 'Include site quirks (default: true)' },
+            },
+            required: ['domain'],
+        },
+    },
+];
+/**
+ * AI2QA MCP Server
+ */
+class Ai2qaMcpServer {
+    server;
+    browserConnection;
+    page = null;
+    constructor(config) {
+        this.browserConnection = new connection_js_1.BrowserConnection(config?.browser);
+        // Configure knowledge API if provided
+        if (config?.knowledgeApi) {
+            (0, report_js_1.configureKnowledgeApi)(config.knowledgeApi);
+        }
+        this.server = new index_js_1.Server({
+            name: 'ai2qa-local-agent',
+            version: '0.1.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    /**
+     * Configure the knowledge API for reporting results.
+     */
+    configureKnowledgeApi(config) {
+        (0, report_js_1.configureKnowledgeApi)(config);
+    }
+    setupHandlers() {
+        // List available tools
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+            tools: TOOLS,
+        }));
+        // Handle tool calls
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            // Ensure browser is connected
+            if (!this.page) {
+                const result = await this.browserConnection.connect();
+                if (!result.success) {
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: false,
+                                    error: `Failed to connect to browser: ${result.error.message}`,
+                                }),
+                            },
+                        ],
+                    };
+                }
+                this.page = result.value;
+            }
+            // Execute the tool
+            const toolResult = await this.executeTool(name, args ?? {});
+            // Format response based on tool type
+            if (name === types_js_2.TOOL_NAMES.SCREENSHOT && toolResult.success && 'data' in toolResult) {
+                return {
+                    content: [
+                        {
+                            type: 'image',
+                            data: toolResult.data,
+                            mimeType: toolResult.mimeType ?? 'image/png',
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(toolResult, null, 2),
+                    },
+                ],
+            };
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async executeTool(name, args) {
+        if (!this.page) {
+            return { success: false, error: 'No browser page available' };
+        }
+        switch (name) {
+            case types_js_2.TOOL_NAMES.NAVIGATE:
+                return (0, navigate_js_1.navigate)(this.page, args);
+            case types_js_2.TOOL_NAMES.CLICK:
+                return (0, click_js_1.click)(this.page, args);
+            case types_js_2.TOOL_NAMES.FILL:
+                return (0, fill_js_1.fill)(this.page, args);
+            case types_js_2.TOOL_NAMES.HOVER:
+                return (0, hover_js_1.hover)(this.page, args);
+            case types_js_2.TOOL_NAMES.PRESS_KEY:
+                return (0, press_key_js_1.pressKey)(this.page, args);
+            case types_js_2.TOOL_NAMES.SCREENSHOT:
+                return (0, screenshot_js_1.screenshot)(this.page, args);
+            case types_js_2.TOOL_NAMES.SNAPSHOT:
+                return (0, snapshot_js_1.snapshot)(this.page, args);
+            case types_js_2.TOOL_NAMES.WAIT:
+                return (0, wait_js_1.wait)(this.page, args);
+            case types_js_2.TOOL_NAMES.EVALUATE:
+                return (0, evaluate_js_1.evaluate)(this.page, args);
+            case types_js_2.TOOL_NAMES.REPORT_RESULTS:
+                // Report results doesn't need the browser page
+                return (0, report_js_1.reportResults)(args);
+            case types_js_2.TOOL_NAMES.GET_KNOWLEDGE:
+                // Get knowledge doesn't need the browser page
+                return (0, knowledge_js_1.getKnowledge)(args);
+            default:
+                return { success: false, error: `Unknown tool: ${name}` };
+        }
+    }
+    /**
+     * Start the MCP server with stdio transport (default for local AI tools).
+     */
+    async start() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('[Ai2qaMcpServer] Server started with stdio transport');
+    }
+    /**
+     * Start the MCP server with WebSocket transport (for AI2QA cloud).
+     */
+    async startWithWebSocket(config) {
+        const transport = new websocket_js_1.WebSocketTransport(config);
+        await transport.start();
+        await this.server.connect(transport);
+        console.error('[Ai2qaMcpServer] Server started with WebSocket transport');
+        console.error(`[Ai2qaMcpServer] Connected to: ${config.url}`);
+    }
+    /**
+     * Start with a custom transport.
+     */
+    async startWithTransport(transport) {
+        await this.server.connect(transport);
+        console.error('[Ai2qaMcpServer] Server started with custom transport');
+    }
+    /**
+     * Stop the server and clean up resources.
+     */
+    async stop() {
+        await this.browserConnection.disconnect();
+        await this.server.close();
+        console.error('[Ai2qaMcpServer] Server stopped');
+    }
+    /**
+     * Get the underlying MCP server instance.
+     */
+    getServer() {
+        return this.server;
+    }
+}
+exports.Ai2qaMcpServer = Ai2qaMcpServer;
+/**
+ * Factory function for creating the MCP server.
+ */
+function createMcpServer(config) {
+    return new Ai2qaMcpServer(config);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/click.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Click Tool
+ *
+ * Clicks on elements by selector or ref ID.
+ */
+import type { Page } from 'playwright';
+import { ClickResult } from './types.js';
+export declare function setRef(refId: string, selector: string): void;
+export declare function getRef(refId: string): string | undefined;
+export declare function clearRefs(): void;
+export declare function click(page: Page, params: unknown): Promise<ClickResult>;
+//# sourceMappingURL=click.d.ts.map

package/dist/tools/click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/tools/click.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAqB,WAAW,EAAE,MAAM,YAAY,CAAC;AAK5D,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExD;AAED,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAuC7E"}

package/dist/tools/click.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Click Tool
+ *
+ * Clicks on elements by selector or ref ID.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setRef = setRef;
+exports.getRef = getRef;
+exports.clearRefs = clearRefs;
+exports.click = click;
+const types_js_1 = require("./types.js");
+/** Map of ref IDs to selectors (populated by snapshot tool) */
+const refMap = new Map();
+function setRef(refId, selector) {
+    refMap.set(refId, selector);
+}
+function getRef(refId) {
+    return refMap.get(refId);
+}
+function clearRefs() {
+    refMap.clear();
+}
+async function click(page, params) {
+    const parseResult = types_js_1.ClickParamsSchema.safeParse(params);
+    if (!parseResult.success) {
+        return {
+            success: false,
+            error: `Invalid parameters: ${parseResult.error.message}`,
+        };
+    }
+    const { selector, ref, button, clickCount, timeout } = parseResult.data;
+    // Resolve selector from ref if provided
+    const resolvedSelector = ref ? getRef(ref) : selector;
+    if (!resolvedSelector) {
+        return {
+            success: false,
+            error: ref ? `Unknown ref: ${ref}` : 'No selector provided',
+        };
+    }
+    try {
+        await page.click(resolvedSelector, {
+            button,
+            clickCount,
+            timeout,
+        });
+        return {
+            success: true,
+            selector: resolvedSelector,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: `Click failed on "${resolvedSelector}": ${message}`,
+            selector: resolvedSelector,
+        };
+    }
+}
+//# sourceMappingURL=click.js.map

package/dist/tools/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../src/tools/click.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAQH,wBAEC;AAED,wBAEC;AAED,8BAEC;AAED,sBAuCC;AAxDD,yCAA4D;AAE5D,+DAA+D;AAC/D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEzC,SAAgB,MAAM,CAAC,KAAa,EAAE,QAAgB;IAClD,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,MAAM,CAAC,KAAa;IAChC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,SAAgB,SAAS;IACrB,MAAM,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAEM,KAAK,UAAU,KAAK,CAAC,IAAU,EAAE,MAAe;IACnD,MAAM,WAAW,GAAG,4BAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,uBAAuB,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE;SAC5D,CAAC;IACN,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC;IAExE,wCAAwC;IACxC,MAAM,gBAAgB,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACtD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACpB,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC,CAAC,sBAAsB;SAC9D,CAAC;IACN,CAAC;IAED,IAAI,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE;YAC/B,MAAM;YACN,UAAU;YACV,OAAO;SACV,CAAC,CAAC;QAEH,OAAO;YACH,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,gBAAgB;SAC7B,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,oBAAoB,gBAAgB,MAAM,OAAO,EAAE;YAC1D,QAAQ,EAAE,gBAAgB;SAC7B,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/tools/evaluate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Evaluate Tool
+ *
+ * Executes JavaScript in the page context.
+ */
+import type { Page } from 'playwright';
+import { EvaluateResult } from './types.js';
+export declare function evaluate(page: Page, params: unknown): Promise<EvaluateResult>;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/tools/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAwB,cAAc,EAAE,MAAM,YAAY,CAAC;AAElE,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAuCnF"}

package/dist/tools/evaluate.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Evaluate Tool
+ *
+ * Executes JavaScript in the page context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluate = evaluate;
+const types_js_1 = require("./types.js");
+async function evaluate(page, params) {
+    const parseResult = types_js_1.EvaluateParamsSchema.safeParse(params);
+    if (!parseResult.success) {
+        return {
+            success: false,
+            error: `Invalid parameters: ${parseResult.error.message}`,
+        };
+    }
+    const { script, args } = parseResult.data;
+    try {
+        // Wrap the script in a function if it's not already
+        const wrappedScript = script.trim().startsWith('(')
+            ? script
+            : `(${script})`;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const result = await page.evaluate(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (evalArgs) => {
+            // eslint-disable-next-line no-eval
+            const fn = eval(evalArgs.code);
+            return typeof fn === 'function' ? fn(...evalArgs.params) : fn;
+        }, { code: wrappedScript, params: args ?? [] });
+        return {
+            success: true,
+            result: serializeResult(result),
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: `Evaluate failed: ${message}`,
+        };
+    }
+}
+/**
+ * Serialize evaluation result to JSON-safe format.
+ */
+function serializeResult(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'function') {
+        return '[Function]';
+    }
+    if (typeof value === 'symbol') {
+        return value.toString();
+    }
+    if (value instanceof Error) {
+        return {
+            name: value.name,
+            message: value.message,
+            stack: value.stack,
+        };
+    }
+    if (Array.isArray(value)) {
+        return value.map(serializeResult);
+    }
+    if (typeof value === 'object') {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            result[key] = serializeResult(val);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/tools/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../src/tools/evaluate.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAKH,4BAuCC;AAzCD,yCAAkE;AAE3D,KAAK,UAAU,QAAQ,CAAC,IAAU,EAAE,MAAe;IACtD,MAAM,WAAW,GAAG,+BAAoB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,uBAAuB,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE;SAC5D,CAAC;IACN,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC;IAE1C,IAAI,CAAC;QACD,oDAAoD;QACpD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAC/C,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,IAAI,MAAM,GAAG,CAAC;QAEpB,8DAA8D;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ;QAC9B,8DAA8D;QAC9D,CAAC,QAAyC,EAAE,EAAE;YAC1C,mCAAmC;YACnC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,CAAC,EACD,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,CAC9C,CAAC;QAEF,OAAO;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;SAClC,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,oBAAoB,OAAO,EAAE;SACvC,CAAC;IACN,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC;IACxB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO;YACH,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACrB,CAAC;IACN,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/tools/fill.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fill Tool
+ *
+ * Fills input elements with text values.
+ */
+import type { Page } from 'playwright';
+import { FillResult } from './types.js';
+export declare function fill(page: Page, params: unknown): Promise<FillResult>;
+//# sourceMappingURL=fill.d.ts.map

package/dist/tools/fill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../src/tools/fill.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAoB,UAAU,EAAE,MAAM,YAAY,CAAC;AAG1D,wBAAsB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAyC3E"}

package/dist/tools/fill.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Fill Tool
+ *
+ * Fills input elements with text values.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fill = fill;
+const types_js_1 = require("./types.js");
+const click_js_1 = require("./click.js");
+async function fill(page, params) {
+    const parseResult = types_js_1.FillParamsSchema.safeParse(params);
+    if (!parseResult.success) {
+        return {
+            success: false,
+            error: `Invalid parameters: ${parseResult.error.message}`,
+        };
+    }
+    const { selector, ref, value, clear, timeout } = parseResult.data;
+    // Resolve selector from ref if provided
+    const resolvedSelector = ref ? (0, click_js_1.getRef)(ref) : selector;
+    if (!resolvedSelector) {
+        return {
+            success: false,
+            error: ref ? `Unknown ref: ${ref}` : 'No selector provided',
+        };
+    }
+    try {
+        const element = page.locator(resolvedSelector);
+        if (clear) {
+            await element.clear({ timeout });
+        }
+        await element.fill(value, { timeout });
+        return {
+            success: true,
+            selector: resolvedSelector,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: `Fill failed on "${resolvedSelector}": ${message}`,
+            selector: resolvedSelector,
+        };
+    }
+}
+//# sourceMappingURL=fill.js.map

package/dist/tools/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../src/tools/fill.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAMH,oBAyCC;AA5CD,yCAA0D;AAC1D,yCAAoC;AAE7B,KAAK,UAAU,IAAI,CAAC,IAAU,EAAE,MAAe;IAClD,MAAM,WAAW,GAAG,2BAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,uBAAuB,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE;SAC5D,CAAC;IACN,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC;IAElE,wCAAwC;IACxC,MAAM,gBAAgB,GAAG,GAAG,CAAC,CAAC,CAAC,IAAA,iBAAM,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACtD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACpB,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC,CAAC,sBAAsB;SAC9D,CAAC;IACN,CAAC;IAED,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAE/C,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAEvC,OAAO;YACH,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,gBAAgB;SAC7B,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,mBAAmB,gBAAgB,MAAM,OAAO,EAAE;YACzD,QAAQ,EAAE,gBAAgB;SAC7B,CAAC;IACN,CAAC;AACL,CAAC"}

package/dist/tools/hover.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hover Tool
+ *
+ * Hovers over elements to trigger hover states, tooltips, etc.
+ */
+import type { Page } from 'playwright';
+import { HoverResult } from './types.js';
+export declare function hover(page: Page, params: unknown): Promise<HoverResult>;
+//# sourceMappingURL=hover.d.ts.map