@natchs/browser-mcp 2.0.0

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

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const ClickArgs: z.ZodObject<{
+    selector: z.ZodString;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    selector: string;
+}, {
+    selector: string;
+    timeout?: number | undefined;
+}>;
+export declare const clickHandler: ToolHandler<Page>;
+//# sourceMappingURL=click.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,SAAS;;;;;;;;;EAGpB,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,IAAI,CAoB1C,CAAC"}

package/dist/tools/interaction/click.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const ClickArgs = z.object({
+    selector: z.string().min(1),
+    timeout: z.number().int().min(100).max(120000).default(10000),
+});
+export const clickHandler = async (args, ctx) => {
+    const parsed = ClickArgs.safeParse(args);
+    if (!parsed.success) {
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    }
+    const { selector, timeout } = parsed.data;
+    const selResult = sanitizeInput(selector);
+    if (selResult.blocked) {
+        return errorResult(ErrorCode.URL_BLOCKED, 'Input contains potentially unsafe characters');
+    }
+    const sel = selResult.sanitized;
+    try {
+        const page = await ctx.getPage();
+        await page.waitForSelector(sel, { timeout, state: 'visible' });
+        await page.click(sel, { timeout });
+        return okResult({ clicked: sel });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.CLICK_FAILED, message);
+    }
+};
+//# sourceMappingURL=click.js.map

package/dist/tools/interaction/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../../src/tools/interaction/click.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1C,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,8CAA8C,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/interaction/drag.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const DragArgs: z.ZodObject<{
+    selector: z.ZodString;
+    targetSelector: z.ZodString;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    selector: string;
+    targetSelector: string;
+}, {
+    selector: string;
+    targetSelector: string;
+    timeout?: number | undefined;
+}>;
+export declare const dragHandler: ToolHandler<Page>;
+//# sourceMappingURL=drag.d.ts.map

package/dist/tools/interaction/drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/drag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,QAAQ;;;;;;;;;;;;EAInB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,IAAI,CAczC,CAAC"}

package/dist/tools/interaction/drag.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const DragArgs = z.object({
+    selector: z.string().min(1),
+    targetSelector: z.string().min(1),
+    timeout: z.number().int().min(100).max(120000).default(10000),
+});
+export const dragHandler = async (args, ctx) => {
+    const parsed = DragArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    const { selector, targetSelector, timeout } = parsed.data;
+    const { sanitized: src } = sanitizeInput(selector);
+    const { sanitized: tgt } = sanitizeInput(targetSelector);
+    try {
+        const page = await ctx.getPage();
+        await page.dragAndDrop(src, tgt, { timeout });
+        return okResult({ dragged: src, to: tgt });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.DRAG_FAILED, message);
+    }
+};
+//# sourceMappingURL=drag.js.map

package/dist/tools/interaction/drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drag.js","sourceRoot":"","sources":["../../../src/tools/interaction/drag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1D,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9C,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/interaction/file-upload.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const FileUploadArgs: z.ZodObject<{
+    selector: z.ZodString;
+    paths: z.ZodArray<z.ZodString, "many">;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    selector: string;
+    paths: string[];
+}, {
+    selector: string;
+    paths: string[];
+    timeout?: number | undefined;
+}>;
+export declare const fileUploadHandler: ToolHandler<Page>;
+//# sourceMappingURL=file-upload.d.ts.map

package/dist/tools/interaction/file-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/file-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AAEH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,IAAI,CAwB/C,CAAC"}

package/dist/tools/interaction/file-upload.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const FileUploadArgs = z.object({
+    selector: z.string().min(1),
+    paths: z.array(z.string()).min(1),
+    timeout: z.number().int().min(100).max(120000).default(10000),
+});
+export const fileUploadHandler = async (args, ctx) => {
+    const parsed = FileUploadArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    const { selector, paths, timeout } = parsed.data;
+    const sel = sanitizeInput(selector);
+    for (const p of paths) {
+        if (p.includes('\0')) {
+            return errorResult(ErrorCode.PATH_BLOCKED, 'Path contains null bytes');
+        }
+        const normalizedForCheck = p.replace(/\\/g, '/');
+        const lowerPath = normalizedForCheck.toLowerCase();
+        if (lowerPath.includes('/proc/') || lowerPath.includes('/sys/') || lowerPath.includes('/dev/')) {
+            return errorResult(ErrorCode.PATH_BLOCKED, 'Path to pseudo-filesystem is blocked');
+        }
+    }
+    try {
+        const page = await ctx.getPage();
+        const input = await page.waitForSelector(sel.sanitized, { timeout, state: 'visible' });
+        await input.setInputFiles(paths);
+        return okResult({ uploaded: sel.sanitized, files: paths.length });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.UPLOAD_FAILED, message);
+    }
+};
+//# sourceMappingURL=file-upload.js.map

package/dist/tools/interaction/file-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.js","sourceRoot":"","sources":["../../../src/tools/interaction/file-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACtE,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACjD,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,kBAAkB,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC;QACnD,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/F,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,sCAAsC,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACvF,MAAM,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const FillArgs: z.ZodObject<{
+    selector: z.ZodString;
+    value: z.ZodString;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    timeout: number;
+    selector: string;
+}, {
+    value: string;
+    selector: string;
+    timeout?: number | undefined;
+}>;
+export declare const fillHandler: ToolHandler<Page>;
+//# sourceMappingURL=fill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/fill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,QAAQ;;;;;;;;;;;;EAInB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,IAAI,CAsBzC,CAAC"}

package/dist/tools/interaction/fill.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const FillArgs = z.object({
+    selector: z.string().min(1),
+    value: z.string(),
+    timeout: z.number().int().min(100).max(120000).default(10000),
+});
+export const fillHandler = async (args, ctx) => {
+    const parsed = FillArgs.safeParse(args);
+    if (!parsed.success) {
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    }
+    const { selector, value, timeout } = parsed.data;
+    const selResult = sanitizeInput(selector);
+    const valResult = sanitizeInput(value);
+    if (selResult.blocked || valResult.blocked) {
+        return errorResult(ErrorCode.URL_BLOCKED, 'Input contains potentially unsafe characters');
+    }
+    const sel = selResult.sanitized;
+    const val = valResult.sanitized;
+    try {
+        const page = await ctx.getPage();
+        await page.waitForSelector(sel, { timeout, state: 'visible' });
+        await page.fill(sel, val, { timeout });
+        return okResult({ filled: sel });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.FILL_FAILED, message);
+    }
+};
+//# sourceMappingURL=fill.js.map

package/dist/tools/interaction/fill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fill.js","sourceRoot":"","sources":["../../../src/tools/interaction/fill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACjD,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QAC3C,OAAO,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,8CAA8C,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/interaction/hover.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const HoverArgs: z.ZodObject<{
+    selector: z.ZodString;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    selector: string;
+}, {
+    selector: string;
+    timeout?: number | undefined;
+}>;
+export declare const hoverHandler: ToolHandler<Page>;
+//# sourceMappingURL=hover.d.ts.map

package/dist/tools/interaction/hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/hover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,SAAS;;;;;;;;;EAGpB,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,IAAI,CAc1C,CAAC"}

package/dist/tools/interaction/hover.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const HoverArgs = z.object({
+    selector: z.string().min(1),
+    timeout: z.number().int().min(100).max(120000).default(10000),
+});
+export const hoverHandler = async (args, ctx) => {
+    const parsed = HoverArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    const { selector, timeout } = parsed.data;
+    const { sanitized: sel } = sanitizeInput(selector);
+    try {
+        const page = await ctx.getPage();
+        await page.waitForSelector(sel, { timeout, state: 'visible' });
+        await page.hover(sel, { timeout });
+        return okResult({ hovered: sel });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.HOVER_FAILED, message);
+    }
+};
+//# sourceMappingURL=hover.js.map

package/dist/tools/interaction/hover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.js","sourceRoot":"","sources":["../../../src/tools/interaction/hover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACjE,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1C,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/interaction/index.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistry } from '../../core/registry.js';
+export declare function registerInteractionTools(registry: ToolRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/interaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAU3D,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAiCrE"}

package/dist/tools/interaction/index.js

@@ -0,0 +1,19 @@
+import { clickHandler, ClickArgs } from './click.js';
+import { fillHandler, FillArgs } from './fill.js';
+import { selectHandler, SelectArgs } from './select.js';
+import { hoverHandler, HoverArgs } from './hover.js';
+import { dragHandler, DragArgs } from './drag.js';
+import { typeHandler, TypeArgs } from './type.js';
+import { pressKeyHandler, PressKeyArgs } from './press-key.js';
+import { fileUploadHandler, FileUploadArgs } from './file-upload.js';
+export function registerInteractionTools(registry) {
+    registry.register({ name: 'browser_click', description: 'Click an element identified by CSS selector', category: 'interaction', schema: ClickArgs }, clickHandler);
+    registry.register({ name: 'browser_fill', description: 'Fill text into an input field', category: 'interaction', schema: FillArgs }, fillHandler);
+    registry.register({ name: 'browser_select', description: 'Select option(s) in a dropdown', category: 'interaction', schema: SelectArgs }, selectHandler);
+    registry.register({ name: 'browser_hover', description: 'Hover over an element', category: 'interaction', schema: HoverArgs }, hoverHandler);
+    registry.register({ name: 'browser_drag', description: 'Drag and drop an element to a target', category: 'interaction', schema: DragArgs }, dragHandler);
+    registry.register({ name: 'browser_type', description: 'Type text into an input field character by character', category: 'interaction', schema: TypeArgs }, typeHandler);
+    registry.register({ name: 'browser_press_key', description: 'Press a keyboard key (e.g. Enter, ArrowDown, Escape)', category: 'interaction', schema: PressKeyArgs }, pressKeyHandler);
+    registry.register({ name: 'browser_file_upload', description: 'Upload files via a file input element', category: 'interaction', schema: FileUploadArgs }, fileUploadHandler);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/interaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/interaction/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAErE,MAAM,UAAU,wBAAwB,CAAC,QAAsB;IAC7D,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,6CAA6C,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,EACjI,YAAY,CACb,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,+BAA+B,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,EACjH,WAAW,CACZ,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,gCAAgC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,EACtH,aAAa,CACd,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,EAC3G,YAAY,CACb,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,sCAAsC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,EACxH,WAAW,CACZ,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,sDAAsD,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,EACxI,WAAW,CACZ,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,mBAAmB,EAAE,WAAW,EAAE,sDAAsD,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,EACjJ,eAAe,CAChB,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,qBAAqB,EAAE,WAAW,EAAE,uCAAuC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,EACtI,iBAAiB,CAClB,CAAC;AACJ,CAAC"}

package/dist/tools/interaction/press-key.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const PressKeyArgs: z.ZodObject<{
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+}, {
+    key: string;
+}>;
+export declare const pressKeyHandler: ToolHandler<Page>;
+//# sourceMappingURL=press-key.d.ts.map

package/dist/tools/interaction/press-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"press-key.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/press-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,IAAI,CAa7C,CAAC"}

package/dist/tools/interaction/press-key.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const PressKeyArgs = z.object({
+    key: z.string().min(1),
+});
+export const pressKeyHandler = async (args, ctx) => {
+    const parsed = PressKeyArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    const { key } = parsed.data;
+    const { sanitized: k } = sanitizeInput(key);
+    try {
+        const page = await ctx.getPage();
+        await page.keyboard.press(k);
+        return okResult({ pressed: k });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.PRESS_KEY_FAILED, message);
+    }
+};
+//# sourceMappingURL=press-key.js.map

package/dist/tools/interaction/press-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"press-key.js","sourceRoot":"","sources":["../../../src/tools/interaction/press-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACpE,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAC5B,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/interaction/select.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const SelectArgs: z.ZodObject<{
+    selector: z.ZodString;
+    values: z.ZodArray<z.ZodString, "many">;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    values: string[];
+    timeout: number;
+    selector: string;
+}, {
+    values: string[];
+    selector: string;
+    timeout?: number | undefined;
+}>;
+export declare const selectHandler: ToolHandler<Page>;
+//# sourceMappingURL=select.d.ts.map

package/dist/tools/interaction/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,UAAU;;;;;;;;;;;;EAIrB,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,IAAI,CAe3C,CAAC"}

package/dist/tools/interaction/select.js

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const SelectArgs = z.object({
+    selector: z.string().min(1),
+    values: z.array(z.string()).min(1),
+    timeout: z.number().int().min(100).max(120000).default(10000),
+});
+export const selectHandler = async (args, ctx) => {
+    const parsed = SelectArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    const { selector, values, timeout } = parsed.data;
+    const { sanitized: sel } = sanitizeInput(selector);
+    const sanitizedValues = values.map(v => sanitizeInput(v).sanitized);
+    try {
+        const page = await ctx.getPage();
+        await page.waitForSelector(sel, { timeout, state: 'visible' });
+        await page.selectOption(sel, sanitizedValues, { timeout });
+        return okResult({ selected: sel, values: sanitizedValues });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.SELECT_FAILED, message);
+    }
+};
+//# sourceMappingURL=select.js.map

package/dist/tools/interaction/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/tools/interaction/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAClE,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IAClD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,QAAQ,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/interaction/type.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const TypeArgs: z.ZodObject<{
+    selector: z.ZodString;
+    text: z.ZodString;
+    delay: z.ZodDefault<z.ZodNumber>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    timeout: number;
+    text: string;
+    selector: string;
+    delay: number;
+}, {
+    text: string;
+    selector: string;
+    timeout?: number | undefined;
+    delay?: number | undefined;
+}>;
+export declare const typeHandler: ToolHandler<Page>;
+//# sourceMappingURL=type.d.ts.map

package/dist/tools/interaction/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/tools/interaction/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;EAKnB,CAAC;AAEH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,IAAI,CAgBzC,CAAC"}

package/dist/tools/interaction/type.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+import { sanitizeInput } from '../../core/sandbox.js';
+export const TypeArgs = z.object({
+    selector: z.string().min(1),
+    text: z.string(),
+    delay: z.number().int().min(0).max(1000).default(0),
+    timeout: z.number().int().min(100).max(120000).default(10000),
+});
+export const typeHandler = async (args, ctx) => {
+    const parsed = TypeArgs.safeParse(args);
+    if (!parsed.success)
+        return errorResult(ErrorCode.INVALID_ARGS, parsed.error.message);
+    const { selector, text, delay, timeout } = parsed.data;
+    const { sanitized: sel } = sanitizeInput(selector);
+    const { sanitized: txt } = sanitizeInput(text);
+    try {
+        const page = await ctx.getPage();
+        await page.waitForSelector(sel, { timeout, state: 'visible' });
+        await page.click(sel, { timeout });
+        await page.type(sel, txt, { delay });
+        return okResult({ typed: sel, text: txt });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.TYPE_FAILED, message);
+    }
+};
+//# sourceMappingURL=type.js.map

package/dist/tools/interaction/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/tools/interaction/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAsB,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtF,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACvD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,OAAO,QAAQ,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/navigation/back.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const GoBackArgs: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const goBackHandler: ToolHandler<Page>;
+//# sourceMappingURL=back.d.ts.map

package/dist/tools/navigation/back.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"back.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/back.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,UAAU,gDAAe,CAAC;AAEvC,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,IAAI,CAS3C,CAAC"}

package/dist/tools/navigation/back.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+export const GoBackArgs = z.object({});
+export const goBackHandler = async (_args, ctx) => {
+    try {
+        const page = await ctx.getPage();
+        await page.goBack();
+        return okResult({ finalUrl: page.url() });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.GO_BACK_FAILED, message);
+    }
+};
+//# sourceMappingURL=back.js.map

package/dist/tools/navigation/back.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"back.js","sourceRoot":"","sources":["../../../src/tools/navigation/back.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIjD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEvC,MAAM,CAAC,MAAM,aAAa,GAAsB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACnE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/navigation/forward.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../../core/registry.js';
+import type { Page } from 'playwright';
+export declare const GoForwardArgs: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const goForwardHandler: ToolHandler<Page>;
+//# sourceMappingURL=forward.d.ts.map

package/dist/tools/navigation/forward.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/forward.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,aAAa,gDAAe,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,IAAI,CAS9C,CAAC"}

package/dist/tools/navigation/forward.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+import { errorResult, okResult } from '../../core/output.js';
+import { ErrorCode } from '../../core/errors.js';
+export const GoForwardArgs = z.object({});
+export const goForwardHandler = async (_args, ctx) => {
+    try {
+        const page = await ctx.getPage();
+        await page.goForward();
+        return okResult({ finalUrl: page.url() });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return errorResult(ErrorCode.GO_FORWARD_FAILED, message);
+    }
+};
+//# sourceMappingURL=forward.js.map

package/dist/tools/navigation/forward.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.js","sourceRoot":"","sources":["../../../src/tools/navigation/forward.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIjD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,gBAAgB,GAAsB,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACtE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,WAAW,CAAC,SAAS,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC,CAAC"}

package/dist/tools/navigation/index.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRegistry } from '../../core/registry.js';
+export declare function registerNavigationTools(registry: ToolRegistry): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/navigation/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAO3D,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAqBpE"}

package/dist/tools/navigation/index.js

@@ -0,0 +1,13 @@
+import { navigateHandler, NavigateArgs } from './navigate.js';
+import { goBackHandler, GoBackArgs } from './back.js';
+import { goForwardHandler, GoForwardArgs } from './forward.js';
+import { refreshHandler, RefreshArgs } from './refresh.js';
+import { waitForHandler, WaitForArgs } from './wait-for.js';
+export function registerNavigationTools(registry) {
+    registry.register({ name: 'browser_navigate', description: 'Navigate to a URL', category: 'navigation', schema: NavigateArgs }, navigateHandler);
+    registry.register({ name: 'browser_go_back', description: 'Go back to the previous page in history', category: 'navigation', schema: GoBackArgs }, goBackHandler);
+    registry.register({ name: 'browser_go_forward', description: 'Go forward to the next page in history', category: 'navigation', schema: GoForwardArgs }, goForwardHandler);
+    registry.register({ name: 'browser_refresh', description: 'Refresh/reload the current page', category: 'navigation', schema: RefreshArgs }, refreshHandler);
+    registry.register({ name: 'browser_wait_for', description: 'Wait for a specified timeout in milliseconds', category: 'navigation', schema: WaitForArgs }, waitForHandler);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/navigation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5D,MAAM,UAAU,uBAAuB,CAAC,QAAsB;IAC5D,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,EAC5G,eAAe,CAChB,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,yCAAyC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,EAC/H,aAAa,CACd,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,oBAAoB,EAAE,WAAW,EAAE,wCAAwC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,EACpI,gBAAgB,CACjB,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,iCAAiC,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,EACxH,cAAc,CACf,CAAC;IACF,QAAQ,CAAC,QAAQ,CACf,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,8CAA8C,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,EACtI,cAAc,CACf,CAAC;AACJ,CAAC"}