claude-chrome-parallel 1.0.0

package/dist/tools/lightweight-scroll.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * Lightweight Scroll Tool - JavaScript-based scrolling without screenshots
+ *
+ * Eliminates the CDP screenshot serialization bottleneck that caused
+ * 185-second timeouts under high concurrency (20+ tabs).
+ *
+ * Performance impact: Scroll from 185s (timeout) to <5ms per call
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLightweightScrollTool = registerLightweightScrollTool;
+const session_manager_1 = require("../session-manager");
+const definition = {
+    name: 'lightweight_scroll',
+    description: 'Scroll a page using JavaScript without taking a screenshot. ' +
+        'Much faster than computer(scroll) in high-concurrency scenarios because it ' +
+        'avoids CDP screenshot capture. Use this when you need to scroll to load content ' +
+        '(infinite scroll, lazy loading) but do not need a visual screenshot of the result. ' +
+        'Returns the new scroll position.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tabId: {
+                type: 'string',
+                description: 'Tab ID to scroll',
+            },
+            direction: {
+                type: 'string',
+                enum: ['up', 'down', 'left', 'right'],
+                description: 'Scroll direction',
+            },
+            amount: {
+                type: 'number',
+                description: 'Scroll amount in pixels (default: 300)',
+            },
+            smooth: {
+                type: 'boolean',
+                description: 'Use smooth scrolling animation (default: false)',
+            },
+            selector: {
+                type: 'string',
+                description: 'CSS selector of a specific element to scroll (default: window). ' +
+                    'Use for scrollable containers like chat panels or sidebars.',
+            },
+            scrollToEnd: {
+                type: 'boolean',
+                description: 'Scroll to the very end in the given direction (default: false). ' +
+                    'Useful for reaching the bottom of a page or container.',
+            },
+            waitAfterMs: {
+                type: 'number',
+                description: 'Milliseconds to wait after scrolling for content to load (default: 0). ' +
+                    'Useful for infinite scroll pages that need time to fetch new content.',
+            },
+        },
+        required: ['tabId', 'direction'],
+    },
+};
+const handler = async (sessionId, args) => {
+    const tabId = args.tabId;
+    const direction = args.direction;
+    const amount = args.amount || 300;
+    const smooth = args.smooth || false;
+    const selector = args.selector;
+    const scrollToEnd = args.scrollToEnd || false;
+    const waitAfterMs = args.waitAfterMs || 0;
+    if (!tabId) {
+        return {
+            content: [{ type: 'text', text: 'Error: tabId is required' }],
+            isError: true,
+        };
+    }
+    if (!direction || !['up', 'down', 'left', 'right'].includes(direction)) {
+        return {
+            content: [{ type: 'text', text: 'Error: direction must be one of: up, down, left, right' }],
+            isError: true,
+        };
+    }
+    const sessionManager = (0, session_manager_1.getSessionManager)();
+    try {
+        const page = await sessionManager.getPage(sessionId, tabId, undefined, 'lightweight_scroll');
+        if (!page) {
+            return {
+                content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
+                isError: true,
+            };
+        }
+        const scrollResult = await page.evaluate((params) => {
+            return new Promise((resolve) => {
+                try {
+                    const target = params.selector
+                        ? document.querySelector(params.selector)
+                        : null;
+                    if (params.selector && !target) {
+                        resolve({
+                            success: false,
+                            scrollX: 0,
+                            scrollY: 0,
+                            scrollHeight: 0,
+                            scrollWidth: 0,
+                            clientHeight: 0,
+                            clientWidth: 0,
+                            atEnd: false,
+                            error: `Selector "${params.selector}" not found`,
+                        });
+                        return;
+                    }
+                    const scrollTarget = target || document.documentElement;
+                    const behavior = params.smooth ? 'smooth' : 'instant';
+                    if (params.scrollToEnd) {
+                        // Scroll to the very end
+                        switch (params.direction) {
+                            case 'down':
+                                (target || window).scrollTo({
+                                    top: scrollTarget.scrollHeight,
+                                    behavior,
+                                });
+                                break;
+                            case 'up':
+                                (target || window).scrollTo({ top: 0, behavior });
+                                break;
+                            case 'right':
+                                (target || window).scrollTo({
+                                    left: scrollTarget.scrollWidth,
+                                    behavior,
+                                });
+                                break;
+                            case 'left':
+                                (target || window).scrollTo({ left: 0, behavior });
+                                break;
+                        }
+                    }
+                    else {
+                        // Scroll by amount
+                        let deltaX = 0;
+                        let deltaY = 0;
+                        switch (params.direction) {
+                            case 'down':
+                                deltaY = params.amount;
+                                break;
+                            case 'up':
+                                deltaY = -params.amount;
+                                break;
+                            case 'right':
+                                deltaX = params.amount;
+                                break;
+                            case 'left':
+                                deltaX = -params.amount;
+                                break;
+                        }
+                        (target || window).scrollBy({ left: deltaX, top: deltaY, behavior });
+                    }
+                    // Dispatch scroll event to trigger lazy loaders / infinite scroll handlers
+                    const eventTarget = target || document;
+                    eventTarget.dispatchEvent(new Event('scroll', { bubbles: true }));
+                    const finalize = () => {
+                        const el = target || document.documentElement;
+                        const sx = target ? el.scrollLeft : window.scrollX;
+                        const sy = target ? el.scrollTop : window.scrollY;
+                        const sh = el.scrollHeight;
+                        const sw = el.scrollWidth;
+                        const ch = el.clientHeight;
+                        const cw = el.clientWidth;
+                        // Check if at the end in the scroll direction
+                        let atEnd = false;
+                        switch (params.direction) {
+                            case 'down':
+                                atEnd = sy + ch >= sh - 1;
+                                break;
+                            case 'up':
+                                atEnd = sy <= 0;
+                                break;
+                            case 'right':
+                                atEnd = sx + cw >= sw - 1;
+                                break;
+                            case 'left':
+                                atEnd = sx <= 0;
+                                break;
+                        }
+                        resolve({
+                            success: true,
+                            scrollX: Math.round(sx),
+                            scrollY: Math.round(sy),
+                            scrollHeight: sh,
+                            scrollWidth: sw,
+                            clientHeight: ch,
+                            clientWidth: cw,
+                            atEnd,
+                        });
+                    };
+                    if (params.waitAfterMs > 0) {
+                        setTimeout(finalize, params.waitAfterMs);
+                    }
+                    else {
+                        // Small delay for scroll to settle
+                        requestAnimationFrame(() => finalize());
+                    }
+                }
+                catch (e) {
+                    resolve({
+                        success: false,
+                        scrollX: 0,
+                        scrollY: 0,
+                        scrollHeight: 0,
+                        scrollWidth: 0,
+                        clientHeight: 0,
+                        clientWidth: 0,
+                        atEnd: false,
+                        error: e instanceof Error ? e.message : String(e),
+                    });
+                }
+            });
+        }, {
+            direction,
+            amount,
+            smooth,
+            selector: selector || null,
+            scrollToEnd,
+            waitAfterMs,
+        });
+        if (!scrollResult.success) {
+            return {
+                content: [{ type: 'text', text: `Scroll error: ${scrollResult.error}` }],
+                isError: true,
+            };
+        }
+        const targetDesc = selector ? ` (${selector})` : '';
+        const endIndicator = scrollResult.atEnd ? ' [END REACHED]' : '';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        scrolled: `${direction} ${scrollToEnd ? 'to end' : amount + 'px'}${targetDesc}${endIndicator}`,
+                        position: {
+                            x: scrollResult.scrollX,
+                            y: scrollResult.scrollY,
+                        },
+                        dimensions: {
+                            scrollHeight: scrollResult.scrollHeight,
+                            scrollWidth: scrollResult.scrollWidth,
+                            clientHeight: scrollResult.clientHeight,
+                            clientWidth: scrollResult.clientWidth,
+                        },
+                        atEnd: scrollResult.atEnd,
+                    }),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Lightweight scroll error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+};
+function registerLightweightScrollTool(server) {
+    server.registerTool('lightweight_scroll', handler, definition);
+}
+//# sourceMappingURL=lightweight-scroll.js.map

package/dist/tools/lightweight-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightweight-scroll.js","sourceRoot":"","sources":["../../src/tools/lightweight-scroll.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAySH,sEAEC;AAvSD,wDAAuD;AAEvD,MAAM,UAAU,GAAsB;IACpC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,8DAA8D;QAC9D,6EAA6E;QAC7E,kFAAkF;QAClF,qFAAqF;QACrF,kCAAkC;IACpC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kBAAkB;aAChC;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;gBACrC,WAAW,EAAE,kBAAkB;aAChC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iDAAiD;aAC/D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kEAAkE;oBAClE,6DAA6D;aAChE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,kEAAkE;oBAClE,wDAAwD;aAC3D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,yEAAyE;oBACzE,uEAAuE;aAC1E;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC;KACjC;CACF,CAAC;AAEF,MAAM,OAAO,GAAgB,KAAK,EAChC,SAAiB,EACjB,IAA6B,EACT,EAAE;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAe,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAmB,CAAC;IAC3C,MAAM,MAAM,GAAI,IAAI,CAAC,MAAiB,IAAI,GAAG,CAAC;IAC9C,MAAM,MAAM,GAAI,IAAI,CAAC,MAAkB,IAAI,KAAK,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAA8B,CAAC;IACrD,MAAM,WAAW,GAAI,IAAI,CAAC,WAAuB,IAAI,KAAK,CAAC;IAC3D,MAAM,WAAW,GAAI,IAAI,CAAC,WAAsB,IAAI,CAAC,CAAC;IAEtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;YAC7D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wDAAwD,EAAE,CAAC;YAC3F,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAA,mCAAiB,GAAE,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAC7F,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,KAAK,YAAY,EAAE,CAAC;gBAClE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CACtC,CAAC,MAOA,EAUE,EAAE;YACH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ;wBAC5B,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;wBACzC,CAAC,CAAC,IAAI,CAAC;oBAET,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;wBAC/B,OAAO,CAAC;4BACN,OAAO,EAAE,KAAK;4BACd,OAAO,EAAE,CAAC;4BACV,OAAO,EAAE,CAAC;4BACV,YAAY,EAAE,CAAC;4BACf,WAAW,EAAE,CAAC;4BACd,YAAY,EAAE,CAAC;4BACf,WAAW,EAAE,CAAC;4BACd,KAAK,EAAE,KAAK;4BACZ,KAAK,EAAE,aAAa,MAAM,CAAC,QAAQ,aAAa;yBACjD,CAAC,CAAC;wBACH,OAAO;oBACT,CAAC;oBAED,MAAM,YAAY,GAAG,MAAM,IAAI,QAAQ,CAAC,eAAe,CAAC;oBACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;oBAEtD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;wBACvB,yBAAyB;wBACzB,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;4BACzB,KAAK,MAAM;gCACT,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC;oCAC1B,GAAG,EAAE,YAAY,CAAC,YAAY;oCAC9B,QAAQ;iCACT,CAAC,CAAC;gCACH,MAAM;4BACR,KAAK,IAAI;gCACP,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;gCAClD,MAAM;4BACR,KAAK,OAAO;gCACV,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC;oCAC1B,IAAI,EAAE,YAAY,CAAC,WAAW;oCAC9B,QAAQ;iCACT,CAAC,CAAC;gCACH,MAAM;4BACR,KAAK,MAAM;gCACT,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;gCACnD,MAAM;wBACV,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,mBAAmB;wBACnB,IAAI,MAAM,GAAG,CAAC,CAAC;wBACf,IAAI,MAAM,GAAG,CAAC,CAAC;wBACf,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;4BACzB,KAAK,MAAM;gCACT,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gCACvB,MAAM;4BACR,KAAK,IAAI;gCACP,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;gCACxB,MAAM;4BACR,KAAK,OAAO;gCACV,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gCACvB,MAAM;4BACR,KAAK,MAAM;gCACT,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;gCACxB,MAAM;wBACV,CAAC;wBACD,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;oBACvE,CAAC;oBAED,2EAA2E;oBAC3E,MAAM,WAAW,GAAG,MAAM,IAAI,QAAQ,CAAC;oBACvC,WAAW,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBAElE,MAAM,QAAQ,GAAG,GAAG,EAAE;wBACpB,MAAM,EAAE,GAAG,MAAM,IAAI,QAAQ,CAAC,eAAe,CAAC;wBAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;wBACnD,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;wBAClD,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC;wBAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC;wBAC1B,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC;wBAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC;wBAE1B,8CAA8C;wBAC9C,IAAI,KAAK,GAAG,KAAK,CAAC;wBAClB,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;4BACzB,KAAK,MAAM;gCACT,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gCAC1B,MAAM;4BACR,KAAK,IAAI;gCACP,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC;gCAChB,MAAM;4BACR,KAAK,OAAO;gCACV,KAAK,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gCAC1B,MAAM;4BACR,KAAK,MAAM;gCACT,KAAK,GAAG,EAAE,IAAI,CAAC,CAAC;gCAChB,MAAM;wBACV,CAAC;wBAED,OAAO,CAAC;4BACN,OAAO,EAAE,IAAI;4BACb,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;4BACvB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;4BACvB,YAAY,EAAE,EAAE;4BAChB,WAAW,EAAE,EAAE;4BACf,YAAY,EAAE,EAAE;4BAChB,WAAW,EAAE,EAAE;4BACf,KAAK;yBACN,CAAC,CAAC;oBACL,CAAC,CAAC;oBAEF,IAAI,MAAM,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;wBAC3B,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;oBAC3C,CAAC;yBAAM,CAAC;wBACN,mCAAmC;wBACnC,qBAAqB,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAC1C,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC;wBACN,OAAO,EAAE,KAAK;wBACd,OAAO,EAAE,CAAC;wBACV,OAAO,EAAE,CAAC;wBACV,YAAY,EAAE,CAAC;wBACf,WAAW,EAAE,CAAC;wBACd,YAAY,EAAE,CAAC;wBACf,WAAW,EAAE,CAAC;wBACd,KAAK,EAAE,KAAK;wBACZ,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;qBAClD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,EACD;YACE,SAAS;YACT,MAAM;YACN,MAAM;YACN,QAAQ,EAAE,QAAQ,IAAI,IAAI;YAC1B,WAAW;YACX,WAAW;SACZ,CACF,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,YAAY,CAAC,KAAK,EAAE,EAAE,CAAC;gBACxE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;QAEhE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,QAAQ,EAAE,GAAG,SAAS,IAAI,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,YAAY,EAAE;wBAC9F,QAAQ,EAAE;4BACR,CAAC,EAAE,YAAY,CAAC,OAAO;4BACvB,CAAC,EAAE,YAAY,CAAC,OAAO;yBACxB;wBACD,UAAU,EAAE;4BACV,YAAY,EAAE,YAAY,CAAC,YAAY;4BACvC,WAAW,EAAE,YAAY,CAAC,WAAW;4BACrC,YAAY,EAAE,YAAY,CAAC,YAAY;4BACvC,WAAW,EAAE,YAAY,CAAC,WAAW;yBACtC;wBACD,KAAK,EAAE,YAAY,CAAC,KAAK;qBAC1B,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,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;AAEF,SAAgB,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC"}

package/dist/tools/memory.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Memory Tools — 3 MCP tools for domain knowledge persistence.
+ *
+ * memory_record   — Agent stores knowledge after successful operations
+ * memory_query    — Retrieve domain knowledge sorted by confidence
+ * memory_validate — Agent reports success/failure after using knowledge
+ */
+import { MCPServer } from '../mcp-server';
+export declare function registerMemoryTools(server: MCPServer): void;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/tools/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA0J1C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAI3D"}

package/dist/tools/memory.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Memory Tools — 3 MCP tools for domain knowledge persistence.
+ *
+ * memory_record   — Agent stores knowledge after successful operations
+ * memory_query    — Retrieve domain knowledge sorted by confidence
+ * memory_validate — Agent reports success/failure after using knowledge
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMemoryTools = registerMemoryTools;
+const domain_memory_1 = require("../memory/domain-memory");
+// ============================================
+// memory_record
+// ============================================
+const recordDefinition = {
+    name: 'memory_record',
+    description: `Record domain knowledge for future reuse. Call this after discovering useful selectors, extraction strategies, or site-specific tips. The key should follow a naming convention like "selector:tweet", "tip:scroll_first", "avoid:read_page_for_extraction".`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            domain: {
+                type: 'string',
+                description: 'Website domain (e.g., "x.com", "amazon.com")',
+            },
+            key: {
+                type: 'string',
+                description: 'Knowledge key (e.g., "selector:tweet_container", "tip:infinite_scroll")',
+            },
+            value: {
+                type: 'string',
+                description: 'The knowledge value (e.g., "article[data-testid=\'tweet\']")',
+            },
+        },
+        required: ['domain', 'key', 'value'],
+    },
+};
+const recordHandler = async (_sessionId, args) => {
+    const domain = args.domain;
+    const key = args.key;
+    const value = args.value;
+    const entry = (0, domain_memory_1.getDomainMemory)().record(domain, key, value);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ id: entry.id, confidence: entry.confidence }, null, 2),
+            },
+        ],
+    };
+};
+// ============================================
+// memory_query
+// ============================================
+const queryDefinition = {
+    name: 'memory_query',
+    description: `Query stored domain knowledge. Returns entries sorted by confidence (highest first). Use before interacting with a site to leverage previously learned selectors and strategies.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            domain: {
+                type: 'string',
+                description: 'Website domain to query (e.g., "x.com")',
+            },
+            key: {
+                type: 'string',
+                description: 'Optional key or key prefix to filter (e.g., "selector" returns all selector:* entries)',
+            },
+        },
+        required: ['domain'],
+    },
+};
+const queryHandler = async (_sessionId, args) => {
+    const domain = args.domain;
+    const key = args.key;
+    const entries = (0, domain_memory_1.getDomainMemory)().query(domain, key);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ entries, count: entries.length }, null, 2),
+            },
+        ],
+    };
+};
+// ============================================
+// memory_validate
+// ============================================
+const validateDefinition = {
+    name: 'memory_validate',
+    description: `Validate domain knowledge after using it. Call with success=true when stored knowledge worked correctly, or success=false when it was outdated/broken. This adjusts confidence scores (+0.1 on success, -0.2 on failure).`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                description: 'The knowledge entry ID to validate',
+            },
+            success: {
+                type: 'boolean',
+                description: 'Whether the knowledge was accurate (true) or outdated/broken (false)',
+            },
+        },
+        required: ['id', 'success'],
+    },
+};
+const validateHandler = async (_sessionId, args) => {
+    const id = args.id;
+    const success = args.success;
+    const entry = (0, domain_memory_1.getDomainMemory)().validate(id, success);
+    if (!entry) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        id,
+                        pruned: true,
+                        message: 'Entry was pruned due to low confidence or not found',
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ id: entry.id, newConfidence: entry.confidence }, null, 2),
+            },
+        ],
+    };
+};
+// ============================================
+// Registration
+// ============================================
+function registerMemoryTools(server) {
+    server.registerTool('memory_record', recordHandler, recordDefinition);
+    server.registerTool('memory_query', queryHandler, queryDefinition);
+    server.registerTool('memory_validate', validateHandler, validateDefinition);
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

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

package/dist/tools/navigate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Navigate Tool - Navigate to URLs
+ */
+import { MCPServer } from '../mcp-server';
+export declare function registerNavigateTool(server: MCPServer): void;
+//# sourceMappingURL=navigate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/tools/navigate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA4P1C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE5D"}