aether-mcp-server 2.0.2 → 2.1.1

package/dist/bridge/debugging.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Logging / debugging and diagnostic functions extracted from CdpBridge.
+ *
+ * These standalone functions accept a CdpClient (and optionally a Logger)
+ * and return results — no `this` state required.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogs = getLogs;
+exports.getNetworkErrors = getNetworkErrors;
+exports.getNetworkTraffic = getNetworkTraffic;
+exports.getNetworkResponse = getNetworkResponse;
+exports.getPerformanceMetrics = getPerformanceMetrics;
+exports.startTracing = startTracing;
+exports.stopTracing = stopTracing;
+exports.cdpCommand = cdpCommand;
+exports.evaluate = evaluate;
+exports.assertCondition = assertCondition;
+exports.getDOMStorage = getDOMStorage;
+const Eval = __importStar(require("../eval-scripts"));
+// ─── getLogs ──────────────────────────────────────────────────────────
+async function getLogs(client, params) {
+    const limit = Math.max(1, Math.min(Number(params.limit ?? 50), 100));
+    const logs = await client.getConsoleLogs(limit);
+    return { count: logs.length, logs };
+}
+// ─── getNetworkErrors ─────────────────────────────────────────────────
+async function getNetworkErrors(client, params) {
+    const limit = Math.max(1, Math.min(Number(params.limit ?? 20), 100));
+    const errors = (await client.getNetworkTraffic())
+        .filter((entry) => entry.type === 'error' || entry.status >= 400)
+        .slice(-limit);
+    return { count: errors.length, errors };
+}
+// ─── getNetworkTraffic ────────────────────────────────────────────────
+async function getNetworkTraffic(client, _params) {
+    return await client.getNetworkTraffic();
+}
+// ─── getNetworkResponse ───────────────────────────────────────────────
+async function getNetworkResponse(client, params) {
+    const requestId = params.requestId;
+    if (!requestId)
+        throw new Error('requestId required');
+    const result = await client.sendCommand('Network.getResponseBody', {
+        requestId,
+    });
+    return result;
+}
+// ─── getPerformanceMetrics ────────────────────────────────────────────
+async function getPerformanceMetrics(client, _params) {
+    await client.sendCommand('Performance.enable', {});
+    const result = await client.sendCommand('Performance.getMetrics', {});
+    return result.metrics;
+}
+// ─── startTracing ─────────────────────────────────────────────────────
+async function startTracing(client, params) {
+    await client.sendCommand('Tracing.start', {
+        categories: params.categories || 'devtools.timeline',
+    });
+    return 'Started tracing';
+}
+// ─── stopTracing ──────────────────────────────────────────────────────
+async function stopTracing(client) {
+    await client.sendCommand('Tracing.end', {});
+    return 'Stopped tracing';
+}
+// ─── cdpCommand ───────────────────────────────────────────────────────
+async function cdpCommand(client, params) {
+    return await client.sendCommand(params.command, params.args || {});
+}
+// ─── evaluate ─────────────────────────────────────────────────────────
+async function evaluate(client, params) {
+    return await client.evaluate(params.script);
+}
+// ─── assertCondition ──────────────────────────────────────────────────
+// Uses Eval.makeAssertionScript to build the evaluation script, then
+// executes it in the page context and returns the result.
+async function assertCondition(client, params) {
+    const assertionType = params.assertionType || 'element_exists';
+    const selector = params.selector;
+    const expectedText = params.expectedText || params.value || '';
+    const script = Eval.makeAssertionScript(selector, assertionType, expectedText);
+    const result = await client.evaluate(script);
+    return result || { success: false, message: 'Assertion failed' };
+}
+// ─── getDOMStorage ────────────────────────────────────────────────────
+async function getDOMStorage(client, params) {
+    await client.sendCommand('DOMStorage.enable', {});
+    const origin = params.origin ||
+        (await client
+            .evaluate('window.location.origin')
+            .catch(() => ''));
+    const result = await client.sendCommand('DOMStorage.getDOMStorageItems', {
+        storageId: {
+            securityOrigin: origin,
+            isLocalStorage: params.type !== 'session',
+        },
+    });
+    return result.entries || [];
+}

package/dist/bridge/inspection.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * State/Inspection functions extracted from CdpBridge.
+ *
+ * These operate as standalone functions that accept their dependencies
+ * (CdpClient, PageSnapshotCache, LocatorEngine) as explicit parameters
+ * rather than relying on `this` state.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.browserStatus = browserStatus;
+exports.snapshotCompact = snapshotCompact;
+exports.listInteractiveElements = listInteractiveElements;
+exports.getState = getState;
+exports.pageSnapshot = pageSnapshot;
+exports.getPageText = getPageText;
+exports.getAccessibilityTree = getAccessibilityTree;
+exports.getDOMTree = getDOMTree;
+exports.getDomSnapshot = getDomSnapshot;
+exports.highlightElements = highlightElements;
+exports.verifyUIState = verifyUIState;
+exports.getComputedStyle = getComputedStyle;
+exports.getEventListeners = getEventListeners;
+const Eval = __importStar(require("../eval-scripts"));
+// ─── browserStatus ────────────────────────────────────────────────────
+async function browserStatus(client, params) {
+    const connected = client.isConnected();
+    const activeTarget = client.getActiveTarget();
+    let targets;
+    if (connected && params.includeTargets) {
+        targets = await client.getTabs().catch(() => []);
+    }
+    return {
+        connected,
+        activeTarget: activeTarget
+            ? {
+                id: activeTarget.id,
+                type: activeTarget.type,
+                title: activeTarget.title,
+                url: activeTarget.url,
+            }
+            : null,
+        targets,
+    };
+}
+// ─── snapshotCompact ──────────────────────────────────────────────────
+async function snapshotCompact(client, snapshotCache, params) {
+    return snapshotCache.compact({
+        maxElements: params.maxElements ?? 30,
+        includeText: params.includeText !== false,
+    });
+}
+// ─── listInteractiveElements ──────────────────────────────────────────
+async function listInteractiveElements(client, snapshotCache, locator, params) {
+    const maxElements = Math.max(0, Math.min(Number(params.maxElements ?? 50), 200));
+    const snapshot = await snapshotCache.compact({
+        maxElements,
+        includeText: true,
+        withOverlay: !!params.withOverlay,
+    });
+    return {
+        count: snapshot.elements.length,
+        cache: snapshot.cache,
+        elements: snapshot.elements,
+    };
+}
+// ─── getState ─────────────────────────────────────────────────────────
+// Comprehensive state: screenshot, domSnapshot, elements, SoM, tabs
+async function getState(client, snapshotCache, locator, params) {
+    const includeScreenshot = params.screenshot === true;
+    const includeDomSnapshot = params.domSnapshot === true || params.includeDOMSnapshot === true;
+    const includeElements = params.elements !== false;
+    const includeSoM = params.som === true || params.withOverlay === true;
+    const includeTabs = params.tabs === true;
+    const includeAccessibilityTree = params.accessibilityTree !== false;
+    const compact = includeElements
+        ? await snapshotCache.compact({
+            maxElements: 200,
+            includeText: true,
+            withOverlay: includeSoM,
+        })
+        : await snapshotCache.compact({ maxElements: 0, includeText: false });
+    const [screenshot, domSnapshot, tabs, accessibilityTree] = await Promise.all([
+        includeScreenshot
+            ? client
+                .screenshot(params.format, params.quality)
+                .catch(() => null)
+            : Promise.resolve(null),
+        includeDomSnapshot
+            ? client.getDOMSnapshot().catch(() => null)
+            : Promise.resolve(null),
+        includeTabs
+            ? client.getTabs().catch(() => [])
+            : Promise.resolve([]),
+        includeAccessibilityTree
+            ? client.getRichAXTree().catch(() => null)
+            : Promise.resolve(null),
+    ]);
+    if (includeSoM) {
+        await client.removeSoMOverlay().catch(() => { });
+    }
+    return {
+        title: compact.title,
+        url: compact.url,
+        screenshot,
+        domSnapshot,
+        elements: includeElements ? compact.elements : [],
+        accessibilityTree,
+        somInjected: includeSoM,
+        cache: compact.cache,
+        tabs,
+    };
+}
+// ─── pageSnapshot ─────────────────────────────────────────────────────
+// Full page capture: title, url, screenshot, elements, forms,
+// cookies, accessibility tree
+async function pageSnapshot(client, params) {
+    try {
+        const includeScreenshot = params.screenshot === true;
+        const includeCookies = params.cookies === true;
+        const includeAccessibilityTree = params.accessibilityTree === true;
+        const [title, url, screenshot, domSnapshot, elements, forms, cookies, axTree,] = await Promise.all([
+            client.evaluate("document.title").catch(() => "Unknown"),
+            client
+                .evaluate("window.location.href")
+                .catch(() => "Unknown"),
+            includeScreenshot
+                ? client
+                    .screenshot(params.fullPage ? "jpeg" : "jpeg", 70)
+                    .catch(() => null)
+                : Promise.resolve(null),
+            params.includeDOMSnapshot
+                ? client.getDOMSnapshot().catch(() => null)
+                : Promise.resolve(undefined),
+            client
+                .getInteractiveElements(false)
+                .catch(() => ({ elements: [] })),
+            client
+                .evaluate(Eval.COLLECT_FORMS_SCRIPT)
+                .catch(() => []),
+            includeCookies
+                ? client
+                    .sendCommand("Network.getCookies", {})
+                    .catch(() => ({ cookies: [] }))
+                : Promise.resolve({ cookies: [] }),
+            includeAccessibilityTree
+                ? client
+                    .getRichAXTree()
+                    .catch(() => null)
+                : Promise.resolve(null),
+        ]);
+        return {
+            title,
+            url,
+            screenshot,
+            elements: elements.elements,
+            accessibilityTree: axTree,
+            forms: forms || [],
+            cookies: cookies.cookies || [],
+            domSnapshot: params.includeDOMSnapshot ? domSnapshot : undefined,
+            metadata: {
+                timestamp: Date.now(),
+                elementCount: elements.elements.length,
+            },
+        };
+    }
+    catch (e) {
+        return { success: false, error: e.message };
+    }
+}
+// ─── getPageText ──────────────────────────────────────────────────────
+// Eval.makeGetPageTextScript(format, selector, includeLinks)
+// with maxLength truncation
+async function getPageText(client, params) {
+    const format = params.format === "text" ? "text" : "markdown";
+    const selector = params.selector ? String(params.selector) : "";
+    const maxLength = Math.max(500, Math.min(Number(params.maxLength ?? 20000), 200000));
+    const includeLinks = params.includeLinks !== false;
+    const extracted = await client
+        .evaluate(Eval.makeGetPageTextScript(format, selector, includeLinks))
+        .catch((e) => ({
+        title: "",
+        url: "",
+        text: "",
+        error: e?.message,
+    }));
+    const text = String(extracted?.text ?? "");
+    const truncated = text.length > maxLength;
+    return {
+        title: extracted?.title ?? "",
+        url: extracted?.url ?? "",
+        format,
+        length: text.length,
+        truncated,
+        text: truncated
+            ? text.slice(0, maxLength) + "\n\n…[truncated]"
+            : text,
+    };
+}
+// ─── getAccessibilityTree ─────────────────────────────────────────────
+// client.getRichAXTree()
+async function getAccessibilityTree(client) {
+    return await client.getRichAXTree();
+}
+// ─── getDOMTree ───────────────────────────────────────────────────────
+// client.getDOMSnapshot()
+async function getDOMTree(client) {
+    const result = await client.getDOMSnapshot();
+    return result;
+}
+// ─── getDomSnapshot ───────────────────────────────────────────────────
+// Same as getDOMTree — kept for backward compatibility
+async function getDomSnapshot(client, params) {
+    return await client.getDOMSnapshot();
+}
+// ─── highlightElements ────────────────────────────────────────────────
+// client.getInteractiveElements(true)
+async function highlightElements(client) {
+    const result = await client.getInteractiveElements(true);
+    return {
+        success: true,
+        elements: result.elements,
+        message: `Highlighted ${result.elements.length} elements`,
+    };
+}
+// ─── verifyUIState ────────────────────────────────────────────────────
+// Eval.makeVerifyUIScript(selector)
+async function verifyUIState(client, params) {
+    const selector = params.selector;
+    const result = await client.evaluate(Eval.makeVerifyUIScript(selector));
+    return result || { exists: false, visible: false };
+}
+// ─── getComputedStyle ─────────────────────────────────────────────────
+// Eval.makeComputedStyleScript(selector, property)
+async function getComputedStyle(client, params) {
+    const selector = params.selector;
+    const property = params.property;
+    if (!selector)
+        throw new Error("Selector required");
+    const result = await client.evaluate(Eval.makeComputedStyleScript(selector, property));
+    return result;
+}
+// ─── getEventListeners ────────────────────────────────────────────────
+// Evaluate for DevTools protocol (note: getEventListeners is CDP-specific
+// and not available in page context without the DevTools API)
+async function getEventListeners(client, params) {
+    const selector = params.selector;
+    if (!selector)
+        throw new Error("Selector required");
+    // Attempt to use DOM.getEventListeners via CDP if available,
+    // otherwise fall back to a page-context message.
+    try {
+        const objectResult = await client.sendCommand("DOM.resolveNode", { selector }).catch(() => null);
+        if (objectResult?.object?.objectId) {
+            const listeners = await client.sendCommand("DOMDebugger.getEventListeners", { objectId: objectResult.object.objectId }).catch(() => null);
+            return listeners;
+        }
+    }
+    catch {
+        // Fallback to page-context message
+    }
+    const result = await client.evaluate(`
+        (function() {
+            const el = document.querySelector(${JSON.stringify(selector)});
+            if (!el) return null;
+            return { message: "getEventListeners requires DevTools protocol, not available in page context" };
+        })()
+    `);
+    return result;
+}