@ai2qa/local-agent 0.1.0

package/dist/tools/snapshot.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Snapshot Tool
+ *
+ * Captures DOM/Accessibility snapshots for AI analysis.
+ * Supports three modes:
+ * - accessibility: Uses Playwright's accessibility tree (recommended for AI)
+ * - html: Raw HTML content
+ * - text: Visible text content only
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshot = snapshot;
+const types_js_1 = require("./types.js");
+const click_js_1 = require("./click.js");
+/** Reference counter for generating unique IDs */
+let refCounter = 0;
+async function snapshot(page, params) {
+    const parseResult = types_js_1.SnapshotParamsSchema.safeParse(params);
+    if (!parseResult.success) {
+        return {
+            success: false,
+            error: `Invalid parameters: ${parseResult.error.message}`,
+        };
+    }
+    const { verbose, mode } = parseResult.data;
+    try {
+        const url = page.url();
+        const title = await page.title();
+        let content;
+        const refs = {};
+        switch (mode) {
+            case 'accessibility':
+                content = await captureAccessibilitySnapshot(page, verbose, refs);
+                break;
+            case 'html':
+                content = await page.content();
+                break;
+            case 'text':
+                content = await page.innerText('body');
+                break;
+        }
+        return {
+            success: true,
+            content,
+            url,
+            title,
+            refs: Object.keys(refs).length > 0 ? refs : undefined,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: `Snapshot failed: ${message}`,
+        };
+    }
+}
+/**
+ * Capture accessibility tree snapshot using Playwright's aria snapshot.
+ */
+async function captureAccessibilitySnapshot(page, verbose, refs) {
+    // Clear previous refs
+    (0, click_js_1.clearRefs)();
+    refCounter = 0;
+    // Use Playwright's built-in aria snapshot
+    const ariaSnapshot = await page.locator('body').ariaSnapshot();
+    // Also capture interactive elements and assign refs
+    // Note: This code runs in browser context via Playwright's evaluate
+    const interactiveElements = await page.evaluate(`(() => {
+        const elements = [];
+        const interactiveSelectors = [
+            'a[href]',
+            'button',
+            'input',
+            'select',
+            'textarea',
+            '[role="button"]',
+            '[role="link"]',
+            '[role="menuitem"]',
+            '[role="tab"]',
+            '[onclick]',
+        ];
+
+        interactiveSelectors.forEach(sel => {
+            document.querySelectorAll(sel).forEach((el, idx) => {
+                const rect = el.getBoundingClientRect();
+                if (rect.width === 0 || rect.height === 0) return;
+
+                let selector = '';
+                if (el.id) {
+                    selector = '#' + el.id;
+                } else if (el.getAttribute('data-testid')) {
+                    selector = '[data-testid="' + el.getAttribute('data-testid') + '"]';
+                } else if (el.getAttribute('aria-label')) {
+                    selector = '[aria-label="' + el.getAttribute('aria-label') + '"]';
+                } else {
+                    selector = el.tagName.toLowerCase() + ':nth-of-type(' + (idx + 1) + ')';
+                }
+
+                elements.push({
+                    tag: el.tagName.toLowerCase(),
+                    role: el.getAttribute('role') || el.tagName.toLowerCase(),
+                    name: (el.innerText || '').slice(0, 50) || el.getAttribute('aria-label') || '',
+                    selector,
+                });
+            });
+        });
+
+        return elements;
+    })()`);
+    // Assign refs to interactive elements
+    interactiveElements.forEach(el => {
+        const refId = `ref_${refCounter++}`;
+        refs[refId] = el.selector;
+        (0, click_js_1.setRef)(refId, el.selector);
+    });
+    // Build output
+    const lines = [];
+    lines.push('=== Accessibility Snapshot ===');
+    lines.push(ariaSnapshot);
+    if (verbose && interactiveElements.length > 0) {
+        lines.push('');
+        lines.push('=== Interactive Elements (with refs) ===');
+        interactiveElements.slice(0, 50).forEach((el, idx) => {
+            const refId = `ref_${idx}`;
+            lines.push(`[${refId}] ${el.role}: "${el.name}" -> ${el.selector}`);
+        });
+        if (interactiveElements.length > 50) {
+            lines.push(`... and ${interactiveElements.length - 50} more elements`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/tools/snapshot.js.map

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

package/dist/tools/types.d.ts

@@ -0,0 +1,329 @@
+/**
+ * Tool Types and Contracts
+ *
+ * Defines the interface between MCP protocol and browser automation tools.
+ * These contracts MUST match the existing AI2QA cloud MCP server.
+ */
+import { z } from 'zod';
+/** Base result for all tool operations */
+export interface ToolResult {
+    readonly success: boolean;
+    readonly error?: string;
+}
+/** Navigate tool */
+export declare const NavigateParamsSchema: z.ZodObject<{
+    url: z.ZodString;
+    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["goto", "reload", "back", "forward"]>>>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    type: "goto" | "reload" | "back" | "forward";
+    timeout: number;
+}, {
+    url: string;
+    type?: "goto" | "reload" | "back" | "forward" | undefined;
+    timeout?: number | undefined;
+}>;
+export type NavigateParams = z.infer<typeof NavigateParamsSchema>;
+export interface NavigateResult extends ToolResult {
+    readonly url?: string;
+    readonly title?: string;
+}
+/** Click tool */
+export declare const ClickParamsSchema: z.ZodEffects<z.ZodObject<{
+    selector: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+    button: z.ZodDefault<z.ZodOptional<z.ZodEnum<["left", "right", "middle"]>>>;
+    clickCount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    button: "left" | "right" | "middle";
+    clickCount: number;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}, {
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    ref?: string | undefined;
+    button?: "left" | "right" | "middle" | undefined;
+    clickCount?: number | undefined;
+}>, {
+    timeout: number;
+    button: "left" | "right" | "middle";
+    clickCount: number;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}, {
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    ref?: string | undefined;
+    button?: "left" | "right" | "middle" | undefined;
+    clickCount?: number | undefined;
+}>;
+export type ClickParams = z.infer<typeof ClickParamsSchema>;
+export interface ClickResult extends ToolResult {
+    readonly selector?: string;
+}
+/** Fill tool */
+export declare const FillParamsSchema: z.ZodEffects<z.ZodObject<{
+    selector: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+    value: z.ZodString;
+    clear: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    timeout: number;
+    clear: boolean;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}, {
+    value: string;
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    ref?: string | undefined;
+    clear?: boolean | undefined;
+}>, {
+    value: string;
+    timeout: number;
+    clear: boolean;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}, {
+    value: string;
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    ref?: string | undefined;
+    clear?: boolean | undefined;
+}>;
+export type FillParams = z.infer<typeof FillParamsSchema>;
+export interface FillResult extends ToolResult {
+    readonly selector?: string;
+}
+/** Hover tool */
+export declare const HoverParamsSchema: z.ZodEffects<z.ZodObject<{
+    selector: z.ZodOptional<z.ZodString>;
+    ref: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}, {
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}>, {
+    timeout: number;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}, {
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    ref?: string | undefined;
+}>;
+export type HoverParams = z.infer<typeof HoverParamsSchema>;
+export interface HoverResult extends ToolResult {
+    readonly selector?: string;
+}
+/** Press key tool */
+export declare const PressKeyParamsSchema: z.ZodObject<{
+    key: z.ZodString;
+    modifiers: z.ZodOptional<z.ZodArray<z.ZodEnum<["Alt", "Control", "Meta", "Shift"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    modifiers?: ("Alt" | "Control" | "Meta" | "Shift")[] | undefined;
+}, {
+    key: string;
+    modifiers?: ("Alt" | "Control" | "Meta" | "Shift")[] | undefined;
+}>;
+export type PressKeyParams = z.infer<typeof PressKeyParamsSchema>;
+export interface PressKeyResult extends ToolResult {
+    readonly key?: string;
+}
+/** Screenshot tool */
+export declare const ScreenshotParamsSchema: z.ZodObject<{
+    fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    selector: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["png", "jpeg"]>>>;
+    quality: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    fullPage: boolean;
+    format: "png" | "jpeg";
+    selector?: string | undefined;
+    quality?: number | undefined;
+}, {
+    selector?: string | undefined;
+    fullPage?: boolean | undefined;
+    format?: "png" | "jpeg" | undefined;
+    quality?: number | undefined;
+}>;
+export type ScreenshotParams = z.infer<typeof ScreenshotParamsSchema>;
+export interface ScreenshotResult extends ToolResult {
+    readonly type?: 'image';
+    readonly data?: string;
+    readonly mimeType?: string;
+}
+/** Snapshot tool (DOM/Accessibility snapshot) */
+export declare const SnapshotParamsSchema: z.ZodObject<{
+    verbose: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["accessibility", "html", "text"]>>>;
+}, "strip", z.ZodTypeAny, {
+    mode: "accessibility" | "html" | "text";
+    verbose: boolean;
+}, {
+    mode?: "accessibility" | "html" | "text" | undefined;
+    verbose?: boolean | undefined;
+}>;
+export type SnapshotParams = z.infer<typeof SnapshotParamsSchema>;
+export interface SnapshotResult extends ToolResult {
+    readonly content?: string;
+    readonly url?: string;
+    readonly title?: string;
+    readonly refs?: Record<string, string>;
+}
+/** Wait tool */
+export declare const WaitParamsSchema: z.ZodObject<{
+    selector: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    ms: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodDefault<z.ZodOptional<z.ZodEnum<["attached", "detached", "visible", "hidden"]>>>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    state: "attached" | "detached" | "visible" | "hidden";
+    selector?: string | undefined;
+    text?: string | undefined;
+    ms?: number | undefined;
+}, {
+    timeout?: number | undefined;
+    selector?: string | undefined;
+    text?: string | undefined;
+    ms?: number | undefined;
+    state?: "attached" | "detached" | "visible" | "hidden" | undefined;
+}>;
+export type WaitParams = z.infer<typeof WaitParamsSchema>;
+export interface WaitResult extends ToolResult {
+    readonly waited?: number;
+}
+/** Evaluate tool (run JS in page context) */
+export declare const EvaluateParamsSchema: z.ZodObject<{
+    script: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+}, "strip", z.ZodTypeAny, {
+    script: string;
+    args?: unknown[] | undefined;
+}, {
+    script: string;
+    args?: unknown[] | undefined;
+}>;
+export type EvaluateParams = z.infer<typeof EvaluateParamsSchema>;
+export interface EvaluateResult extends ToolResult {
+    readonly result?: unknown;
+}
+/** Union of all tool parameters */
+export type AnyToolParams = NavigateParams | ClickParams | FillParams | HoverParams | PressKeyParams | ScreenshotParams | SnapshotParams | WaitParams | EvaluateParams | ReportResultsParams;
+/** Union of all tool results */
+export type AnyToolResult = NavigateResult | ClickResult | FillResult | HoverResult | PressKeyResult | ScreenshotResult | SnapshotResult | WaitResult | EvaluateResult | ReportResultsResult;
+/** Report results tool (for knowledge learning) */
+export declare const ReportResultsParamsSchema: z.ZodObject<{
+    domain: z.ZodString;
+    results: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        patternKey: z.ZodString;
+        selectorUsed: z.ZodOptional<z.ZodString>;
+        success: z.ZodBoolean;
+        durationMs: z.ZodOptional<z.ZodNumber>;
+        errorMessage: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        patternKey: string;
+        selectorUsed?: string | undefined;
+        durationMs?: number | undefined;
+        errorMessage?: string | undefined;
+    }, {
+        success: boolean;
+        patternKey: string;
+        selectorUsed?: string | undefined;
+        durationMs?: number | undefined;
+        errorMessage?: string | undefined;
+    }>, "many">>;
+    newPatterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        selector: z.ZodOptional<z.ZodString>;
+        selectorType: z.ZodOptional<z.ZodEnum<["CSS", "XPATH", "TEXT", "ARIA", "DATA_TESTID"]>>;
+        patternType: z.ZodOptional<z.ZodEnum<["SELECTOR", "TIMING", "AUTH", "QUIRK"]>>;
+        value: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        value?: string | undefined;
+        selector?: string | undefined;
+        selectorType?: "CSS" | "XPATH" | "TEXT" | "ARIA" | "DATA_TESTID" | undefined;
+        patternType?: "SELECTOR" | "TIMING" | "AUTH" | "QUIRK" | undefined;
+        description?: string | undefined;
+    }, {
+        key: string;
+        value?: string | undefined;
+        selector?: string | undefined;
+        selectorType?: "CSS" | "XPATH" | "TEXT" | "ARIA" | "DATA_TESTID" | undefined;
+        patternType?: "SELECTOR" | "TIMING" | "AUTH" | "QUIRK" | undefined;
+        description?: string | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+    results?: {
+        success: boolean;
+        patternKey: string;
+        selectorUsed?: string | undefined;
+        durationMs?: number | undefined;
+        errorMessage?: string | undefined;
+    }[] | undefined;
+    newPatterns?: {
+        key: string;
+        value?: string | undefined;
+        selector?: string | undefined;
+        selectorType?: "CSS" | "XPATH" | "TEXT" | "ARIA" | "DATA_TESTID" | undefined;
+        patternType?: "SELECTOR" | "TIMING" | "AUTH" | "QUIRK" | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+}, {
+    domain: string;
+    results?: {
+        success: boolean;
+        patternKey: string;
+        selectorUsed?: string | undefined;
+        durationMs?: number | undefined;
+        errorMessage?: string | undefined;
+    }[] | undefined;
+    newPatterns?: {
+        key: string;
+        value?: string | undefined;
+        selector?: string | undefined;
+        selectorType?: "CSS" | "XPATH" | "TEXT" | "ARIA" | "DATA_TESTID" | undefined;
+        patternType?: "SELECTOR" | "TIMING" | "AUTH" | "QUIRK" | undefined;
+        description?: string | undefined;
+    }[] | undefined;
+}>;
+export type ReportResultsParams = z.infer<typeof ReportResultsParamsSchema>;
+export interface ReportResultsResult extends ToolResult {
+    readonly patternsStored?: number;
+    readonly patternsUpdated?: number;
+    readonly message?: string;
+}
+/** Tool name constants */
+export declare const TOOL_NAMES: {
+    readonly NAVIGATE: "navigate_page";
+    readonly CLICK: "click";
+    readonly FILL: "fill";
+    readonly HOVER: "hover";
+    readonly PRESS_KEY: "press_key";
+    readonly SCREENSHOT: "take_screenshot";
+    readonly SNAPSHOT: "take_snapshot";
+    readonly WAIT: "wait_for";
+    readonly EVALUATE: "evaluate";
+    readonly REPORT_RESULTS: "report_test_results";
+    readonly GET_KNOWLEDGE: "get_qa_knowledge";
+};
+export type ToolName = typeof TOOL_NAMES[keyof typeof TOOL_NAMES];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/tools/types.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Tool Types and Contracts
+ *
+ * Defines the interface between MCP protocol and browser automation tools.
+ * These contracts MUST match the existing AI2QA cloud MCP server.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_NAMES = exports.ReportResultsParamsSchema = exports.EvaluateParamsSchema = exports.WaitParamsSchema = exports.SnapshotParamsSchema = exports.ScreenshotParamsSchema = exports.PressKeyParamsSchema = exports.HoverParamsSchema = exports.FillParamsSchema = exports.ClickParamsSchema = exports.NavigateParamsSchema = void 0;
+const zod_1 = require("zod");
+/** Navigate tool */
+exports.NavigateParamsSchema = zod_1.z.object({
+    url: zod_1.z.string().url(),
+    type: zod_1.z.enum(['goto', 'reload', 'back', 'forward']).optional().default('goto'),
+    timeout: zod_1.z.number().optional().default(30000),
+});
+/** Click tool */
+exports.ClickParamsSchema = zod_1.z.object({
+    selector: zod_1.z.string().optional(),
+    ref: zod_1.z.string().optional(),
+    button: zod_1.z.enum(['left', 'right', 'middle']).optional().default('left'),
+    clickCount: zod_1.z.number().optional().default(1),
+    timeout: zod_1.z.number().optional().default(10000),
+}).refine(data => data.selector !== undefined || data.ref !== undefined, { message: 'Either selector or ref must be provided' });
+/** Fill tool */
+exports.FillParamsSchema = zod_1.z.object({
+    selector: zod_1.z.string().optional(),
+    ref: zod_1.z.string().optional(),
+    value: zod_1.z.string(),
+    clear: zod_1.z.boolean().optional().default(true),
+    timeout: zod_1.z.number().optional().default(10000),
+}).refine(data => data.selector !== undefined || data.ref !== undefined, { message: 'Either selector or ref must be provided' });
+/** Hover tool */
+exports.HoverParamsSchema = zod_1.z.object({
+    selector: zod_1.z.string().optional(),
+    ref: zod_1.z.string().optional(),
+    timeout: zod_1.z.number().optional().default(10000),
+}).refine(data => data.selector !== undefined || data.ref !== undefined, { message: 'Either selector or ref must be provided' });
+/** Press key tool */
+exports.PressKeyParamsSchema = zod_1.z.object({
+    key: zod_1.z.string(),
+    modifiers: zod_1.z.array(zod_1.z.enum(['Alt', 'Control', 'Meta', 'Shift'])).optional(),
+});
+/** Screenshot tool */
+exports.ScreenshotParamsSchema = zod_1.z.object({
+    fullPage: zod_1.z.boolean().optional().default(false),
+    selector: zod_1.z.string().optional(),
+    format: zod_1.z.enum(['png', 'jpeg']).optional().default('png'),
+    quality: zod_1.z.number().min(0).max(100).optional(),
+});
+/** Snapshot tool (DOM/Accessibility snapshot) */
+exports.SnapshotParamsSchema = zod_1.z.object({
+    verbose: zod_1.z.boolean().optional().default(false),
+    mode: zod_1.z.enum(['accessibility', 'html', 'text']).optional().default('accessibility'),
+});
+/** Wait tool */
+exports.WaitParamsSchema = zod_1.z.object({
+    selector: zod_1.z.string().optional(),
+    text: zod_1.z.string().optional(),
+    ms: zod_1.z.number().optional(),
+    state: zod_1.z.enum(['attached', 'detached', 'visible', 'hidden']).optional().default('visible'),
+    timeout: zod_1.z.number().optional().default(30000),
+});
+/** Evaluate tool (run JS in page context) */
+exports.EvaluateParamsSchema = zod_1.z.object({
+    script: zod_1.z.string(),
+    args: zod_1.z.array(zod_1.z.unknown()).optional(),
+});
+/** Report results tool (for knowledge learning) */
+exports.ReportResultsParamsSchema = zod_1.z.object({
+    domain: zod_1.z.string(),
+    results: zod_1.z.array(zod_1.z.object({
+        patternKey: zod_1.z.string(),
+        selectorUsed: zod_1.z.string().optional(),
+        success: zod_1.z.boolean(),
+        durationMs: zod_1.z.number().optional(),
+        errorMessage: zod_1.z.string().optional(),
+    })).optional(),
+    newPatterns: zod_1.z.array(zod_1.z.object({
+        key: zod_1.z.string(),
+        selector: zod_1.z.string().optional(),
+        selectorType: zod_1.z.enum(['CSS', 'XPATH', 'TEXT', 'ARIA', 'DATA_TESTID']).optional(),
+        patternType: zod_1.z.enum(['SELECTOR', 'TIMING', 'AUTH', 'QUIRK']).optional(),
+        value: zod_1.z.string().optional(),
+        description: zod_1.z.string().optional(),
+    })).optional(),
+});
+/** Tool name constants */
+exports.TOOL_NAMES = {
+    NAVIGATE: 'navigate_page',
+    CLICK: 'click',
+    FILL: 'fill',
+    HOVER: 'hover',
+    PRESS_KEY: 'press_key',
+    SCREENSHOT: 'take_screenshot',
+    SNAPSHOT: 'take_snapshot',
+    WAIT: 'wait_for',
+    EVALUATE: 'evaluate',
+    REPORT_RESULTS: 'report_test_results',
+    GET_KNOWLEDGE: 'get_qa_knowledge',
+};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

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

package/dist/tools/wait.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wait Tool
+ *
+ * Waits for elements, text, or specified duration.
+ */
+import type { Page } from 'playwright';
+import { WaitResult } from './types.js';
+export declare function wait(page: Page, params: unknown): Promise<WaitResult>;
+//# sourceMappingURL=wait.d.ts.map

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

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

package/dist/tools/wait.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * Wait Tool
+ *
+ * Waits for elements, text, or specified duration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wait = wait;
+const types_js_1 = require("./types.js");
+async function wait(page, params) {
+    const parseResult = types_js_1.WaitParamsSchema.safeParse(params);
+    if (!parseResult.success) {
+        return {
+            success: false,
+            error: `Invalid parameters: ${parseResult.error.message}`,
+        };
+    }
+    const { selector, text, ms, state, timeout } = parseResult.data;
+    const startTime = Date.now();
+    try {
+        // If ms is specified, wait for that duration
+        if (ms !== undefined) {
+            await page.waitForTimeout(ms);
+            return {
+                success: true,
+                waited: ms,
+            };
+        }
+        // If selector is specified, wait for element
+        if (selector) {
+            await page.waitForSelector(selector, {
+                state,
+                timeout,
+            });
+            return {
+                success: true,
+                waited: Date.now() - startTime,
+            };
+        }
+        // If text is specified, wait for text to appear
+        if (text) {
+            await page.waitForFunction(`document.body.innerText.includes(${JSON.stringify(text)})`, { timeout });
+            return {
+                success: true,
+                waited: Date.now() - startTime,
+            };
+        }
+        // Default: wait for page to be stable (networkidle)
+        await page.waitForLoadState('domcontentloaded', { timeout });
+        return {
+            success: true,
+            waited: Date.now() - startTime,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: `Wait failed: ${message}`,
+            waited: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=wait.js.map

package/dist/tools/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/tools/wait.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAKH,oBA4DC;AA9DD,yCAA0D;AAEnD,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,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC;IAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACD,6CAA6C;QAC7C,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YAC9B,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE;aACb,CAAC;QACN,CAAC;QAED,6CAA6C;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE;gBACjC,KAAK;gBACL,OAAO;aACV,CAAC,CAAC;YACH,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACjC,CAAC;QACN,CAAC;QAED,gDAAgD;QAChD,IAAI,IAAI,EAAE,CAAC;YACP,MAAM,IAAI,CAAC,eAAe,CACtB,oCAAoC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAC3D,EAAE,OAAO,EAAE,CACd,CAAC;YACF,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACjC,CAAC;QACN,CAAC;QAED,oDAAoD;QACpD,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,OAAO;YACH,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,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,gBAAgB,OAAO,EAAE;YAChC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACjC,CAAC;IACN,CAAC;AACL,CAAC"}