safari-devtools-mcp 0.1.0

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Screenshot tool.
+ * Mirrors chrome-devtools-mcp tool name: take_screenshot
+ *
+ * Note: Safari WebDriver only supports PNG format and does not support
+ * fullPage screenshots natively. Element screenshots are supported via UIDs.
+ */
+import { z } from 'zod';
+import type { ToolHandler } from './types.js';
+export declare const takeScreenshotSchema: {
+    uid: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
+};
+export declare const takeScreenshot: ToolHandler;
+//# sourceMappingURL=screenshot.d.ts.map

package/build/src/tools/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/tools/screenshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,oBAAoB;;;CAahC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WAoD5B,CAAC"}

package/build/src/tools/screenshot.js

@@ -0,0 +1,70 @@
+/**
+ * Screenshot tool.
+ * Mirrors chrome-devtools-mcp tool name: take_screenshot
+ *
+ * Note: Safari WebDriver only supports PNG format and does not support
+ * fullPage screenshots natively. Element screenshots are supported via UIDs.
+ */
+import { z } from 'zod';
+import { writeFile } from 'fs/promises';
+export const takeScreenshotSchema = {
+    uid: z
+        .string()
+        .optional()
+        .describe('The uid of an element on the page from the page content snapshot. If omitted takes a page screenshot.'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('The absolute path, or a path relative to the current working directory, to save the screenshot to instead of attaching it to the response.'),
+};
+export const takeScreenshot = async (params, driver) => {
+    let base64Data;
+    let description;
+    if (params.uid) {
+        base64Data = await driver.takeElementScreenshot(params.uid);
+        description = `Took a screenshot of element with uid "${params.uid}".`;
+    }
+    else {
+        base64Data = await driver.takeScreenshot();
+        description = "Took a screenshot of the current page's viewport.";
+    }
+    if (params.filePath) {
+        const buffer = Buffer.from(base64Data, 'base64');
+        await writeFile(params.filePath, buffer);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `${description}\nSaved screenshot to ${params.filePath}.`,
+                },
+            ],
+        };
+    }
+    // Check size — if too large, suggest saving to file
+    if (base64Data.length >= 2_000_000) {
+        const { tmpdir } = await import('os');
+        const { join } = await import('path');
+        const tempPath = join(tmpdir(), `safari-screenshot-${Date.now()}.png`);
+        const buffer = Buffer.from(base64Data, 'base64');
+        await writeFile(tempPath, buffer);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `${description}\nScreenshot was too large to embed. Saved to ${tempPath}.`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: description },
+            {
+                type: 'image',
+                data: base64Data,
+                mimeType: 'image/png',
+            },
+        ],
+    };
+};
+//# sourceMappingURL=screenshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../../src/tools/screenshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAGtC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uGAAuG,CACxG;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4IAA4I,CAC7I;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAClE,IAAI,UAAkB,CAAC;IACvB,IAAI,WAAmB,CAAC;IAExB,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,UAAU,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,GAAa,CAAC,CAAC;QACtE,WAAW,GAAG,0CAA0C,MAAM,CAAC,GAAG,IAAI,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3C,WAAW,GAAG,mDAAmD,CAAC;IACpE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,SAAS,CAAC,MAAM,CAAC,QAAkB,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,GAAG,WAAW,yBAAyB,MAAM,CAAC,QAAQ,GAAG;iBAChE;aACF;SACF,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,IAAI,UAAU,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACnC,MAAM,EAAC,MAAM,EAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,qBAAqB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,GAAG,WAAW,iDAAiD,QAAQ,GAAG;iBACjF;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP,EAAC,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,EAAC;YAC1C;gBACE,IAAI,EAAE,OAAgB;gBACtB,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE,WAAW;aACtB;SACF;KACF,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * JavaScript evaluation tool.
+ * Mirrors chrome-devtools-mcp tool name: evaluate_script
+ */
+import { z } from 'zod';
+import type { ToolHandler } from './types.js';
+export declare const evaluateScriptSchema: {
+    function: z.ZodString;
+    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare const evaluateScript: ToolHandler;
+//# sourceMappingURL=script.d.ts.map

package/build/src/tools/script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../src/tools/script.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,oBAAoB;;;CAuBhC,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,WA0B5B,CAAC"}

package/build/src/tools/script.js

@@ -0,0 +1,48 @@
+/**
+ * JavaScript evaluation tool.
+ * Mirrors chrome-devtools-mcp tool name: evaluate_script
+ */
+import { z } from 'zod';
+export const evaluateScriptSchema = {
+    function: z.string().describe(`A JavaScript function declaration to be executed in the currently selected page.
+Example without arguments: \`() => {
+  return document.title
+}\` or \`async () => {
+  return await fetch("example.com")
+}\`.
+Example with arguments: \`(el) => {
+  return el.innerText;
+}\`
+`),
+    args: z
+        .array(z
+        .string()
+        .describe('The uid of an element on the page from the page content snapshot'))
+        .optional()
+        .describe('An optional list of element UIDs to pass as arguments.'),
+};
+export const evaluateScript = async (params, driver) => {
+    try {
+        const result = await driver.evaluateScript(params.function, params.args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Script ran on page and returned:\n\`\`\`json\n${result}\n\`\`\``,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Script evaluation failed: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+//# sourceMappingURL=script.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"script.js","sourceRoot":"","sources":["../../../src/tools/script.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAC3B;;;;;;;;;CASH,CACE;IACD,IAAI,EAAE,CAAC;SACJ,KAAK,CACJ,CAAC;SACE,MAAM,EAAE;SACR,QAAQ,CACP,kEAAkE,CACnE,CACJ;SACA,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAClE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CACxC,MAAM,CAAC,QAAkB,EACzB,MAAM,CAAC,IAA4B,CACpC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,iDAAiD,MAAM,UAAU;iBACxE;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC5F;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * DOM snapshot and wait tools.
+ * Mirrors chrome-devtools-mcp tool names: take_snapshot, wait_for
+ */
+import { z } from 'zod';
+import type { ToolHandler } from './types.js';
+export declare const takeSnapshotSchema: {
+    verbose: z.ZodOptional<z.ZodBoolean>;
+    filePath: z.ZodOptional<z.ZodString>;
+};
+export declare const takeSnapshot: ToolHandler;
+export declare const waitForSchema: {
+    text: z.ZodArray<z.ZodString, "many">;
+    timeout: z.ZodOptional<z.ZodNumber>;
+};
+export declare const waitFor: ToolHandler;
+//# sourceMappingURL=snapshot.d.ts.map

package/build/src/tools/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/tools/snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,kBAAkB;;;CAa9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,WAmB1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;CAWzB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA6BrB,CAAC"}

package/build/src/tools/snapshot.js

@@ -0,0 +1,75 @@
+/**
+ * DOM snapshot and wait tools.
+ * Mirrors chrome-devtools-mcp tool names: take_snapshot, wait_for
+ */
+import { z } from 'zod';
+import { writeFile } from 'fs/promises';
+import { formatSnapshot } from '../formatters/SnapshotFormatter.js';
+export const takeSnapshotSchema = {
+    verbose: z
+        .boolean()
+        .optional()
+        .describe('Whether to include all possible information (tag names, attributes). Default is false.'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('The absolute path, or a path relative to the current working directory, to save the snapshot to instead of attaching it to the response.'),
+};
+export const takeSnapshot = async (params, driver) => {
+    const tree = await driver.takeSnapshot(params.verbose);
+    const text = formatSnapshot(tree, params.verbose);
+    if (params.filePath) {
+        await writeFile(params.filePath, text, 'utf-8');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Snapshot saved to ${params.filePath}.`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [{ type: 'text', text }],
+    };
+};
+export const waitForSchema = {
+    text: z
+        .array(z.string())
+        .min(1)
+        .describe('Non-empty list of texts. Resolves when any value appears on the page.'),
+    timeout: z
+        .number()
+        .optional()
+        .describe('Timeout in milliseconds. Default is 30000.'),
+};
+export const waitFor = async (params, driver) => {
+    const texts = params.text;
+    const timeout = params.timeout;
+    try {
+        const found = await driver.waitForText(texts, timeout);
+        // Take a snapshot after waiting
+        const tree = await driver.takeSnapshot();
+        const snapshotText = formatSnapshot(tree);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Element matching "${found}" found.\n\n${snapshotText}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: error instanceof Error ? error.message : String(error),
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+//# sourceMappingURL=snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../../src/tools/snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,cAAc,EAAC,MAAM,oCAAoC,CAAC;AAGlE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,wFAAwF,CACzF;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0IAA0I,CAC3I;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAChE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,OAA8B,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,OAA8B,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,SAAS,CAAC,MAAM,CAAC,QAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,qBAAqB,MAAM,CAAC,QAAQ,GAAG;iBAC9C;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAC,IAAI,EAAE,MAAe,EAAE,IAAI,EAAC,CAAC;KACzC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,uEAAuE,CACxE;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;CAC1D,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAgB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAgB,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAA6B,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvD,gCAAgC;QAChC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,qBAAqB,KAAK,eAAe,YAAY,EAAE;iBAC9D;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC7D;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Shared tool types.
+ */
+import type { SafariDriver } from '../SafariDriver.js';
+export interface ToolResult {
+    content: ({
+        type: 'text';
+        text: string;
+    } | {
+        type: 'image';
+        data: string;
+        mimeType: string;
+    })[];
+    isError?: boolean;
+}
+export type ToolHandler = (params: Record<string, unknown>, driver: SafariDriver) => Promise<ToolResult>;
+//# sourceMappingURL=types.d.ts.map

package/build/src/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CACL;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAC5B;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAClD,EAAE,CAAC;IACJ,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,YAAY,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC"}

package/build/src/tools/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared tool types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/build/src/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Core type definitions for Safari DevTools MCP.
+ */
+export interface ConsoleLogEntry {
+    msgid: number;
+    level: ConsoleLevel;
+    message: string;
+    timestamp: number;
+    source?: string;
+    stackTrace?: string;
+    args?: string[];
+}
+export type ConsoleLevel = 'log' | 'debug' | 'info' | 'error' | 'warn' | 'trace' | 'assert' | 'dir' | 'table' | 'clear' | 'count' | 'timeEnd';
+export interface NetworkLogEntry {
+    reqid: number;
+    url: string;
+    method: string;
+    status: number;
+    statusText: string;
+    resourceType: ResourceType;
+    startTime: number;
+    duration: number;
+    transferSize: number;
+    encodedBodySize: number;
+    decodedBodySize: number;
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    /** Whether this entry was captured from Performance API (pre-injection) */
+    historical: boolean;
+    error?: string;
+    /** Request body (for intercepted requests) */
+    requestBody?: string;
+    /** Response body (for intercepted requests) */
+    responseBody?: string;
+    /** MIME type of the response */
+    mimeType?: string;
+}
+export type ResourceType = 'document' | 'stylesheet' | 'image' | 'media' | 'font' | 'script' | 'xhr' | 'fetch' | 'websocket' | 'other';
+export interface SnapshotNode {
+    uid: string;
+    role: string;
+    name: string;
+    value?: string;
+    description?: string;
+    children: SnapshotNode[];
+    tagName?: string;
+    attributes?: Record<string, string>;
+}
+export interface PageInfo {
+    pageId: number;
+    url: string;
+    title: string;
+    isSelected: boolean;
+}
+export interface SafariSessionOptions {
+    headless?: boolean;
+    enableInspection?: boolean;
+    enableProfiling?: boolean;
+}
+export interface ToolCategory {
+    DEBUGGING: 'debugging';
+    NAVIGATION: 'navigation';
+    INPUT: 'input';
+    NETWORK: 'network';
+    EMULATION: 'emulation';
+}
+export declare const ToolCategories: {
+    readonly DEBUGGING: "debugging";
+    readonly NAVIGATION: "navigation";
+    readonly INPUT: "input";
+    readonly NETWORK: "network";
+    readonly EMULATION: "emulation";
+};
+//# sourceMappingURL=types.d.ts.map

package/build/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,OAAO,GACP,MAAM,GACN,OAAO,GACP,MAAM,GACN,OAAO,GACP,QAAQ,GACR,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,YAAY,GACZ,OAAO,GACP,OAAO,GACP,MAAM,GACN,QAAQ,GACR,KAAK,GACL,OAAO,GACP,WAAW,GACX,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,WAAW,CAAC;IACvB,UAAU,EAAE,YAAY,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC"}

package/build/src/types.js

@@ -0,0 +1,11 @@
+/**
+ * Core type definitions for Safari DevTools MCP.
+ */
+export const ToolCategories = {
+    DEBUGGING: 'debugging',
+    NAVIGATION: 'navigation',
+    INPUT: 'input',
+    NETWORK: 'network',
+    EMULATION: 'emulation',
+};
+//# sourceMappingURL=types.js.map

package/build/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+FH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "safari-devtools-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Safari DevTools — browser debugging and automation for AI coding agents",
+  "type": "module",
+  "main": "build/src/index.js",
+  "bin": {
+    "safari-devtools-mcp": "build/src/bin/safari-devtools-mcp.js"
+  },
+  "files": [
+    "build/src",
+    "LICENSE",
+    "!*.tsbuildinfo"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf build",
+    "start": "node build/src/bin/safari-devtools-mcp.js",
+    "dev": "npm run build && npm start",
+    "typecheck": "tsc --noEmit",
+    "format": "eslint --cache --fix . && prettier --write --cache .",
+    "check-format": "eslint --cache . && prettier --check --cache .",
+    "test": "npm run build && node --test build/tests/**/*.test.js",
+    "test:no-build": "node --test build/tests/**/*.test.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HayoDev/safari-devtools-mcp.git"
+  },
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/HayoDev/safari-devtools-mcp/issues"
+  },
+  "homepage": "https://github.com/HayoDev/safari-devtools-mcp#readme",
+  "keywords": [
+    "mcp",
+    "safari",
+    "devtools",
+    "debugging",
+    "browser-automation",
+    "model-context-protocol",
+    "ai-coding"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "selenium-webdriver": "^4.26.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.35.0",
+    "@stylistic/eslint-plugin": "^5.4.0",
+    "@types/node": "^22.10.0",
+    "@types/selenium-webdriver": "^4.1.27",
+    "eslint": "^9.35.0",
+    "prettier": "^3.6.0",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.43.0"
+  }
+}