@iflow-mcp/shaun0927-openchrome 1.7.13

package/dist/hints/rules/composite-suggestions.js.map

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

package/dist/hints/rules/error-recovery.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Error Recovery Rules — highest priority
+ * Maps error patterns to actionable recovery hints.
+ */
+import type { HintRule } from '../hint-engine';
+export declare const errorRecoveryRules: HintRule[];
+//# sourceMappingURL=error-recovery.d.ts.map

package/dist/hints/rules/error-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-recovery.d.ts","sourceRoot":"","sources":["../../../src/hints/rules/error-recovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA6C/C,eAAO,MAAM,kBAAkB,EAAE,QAAQ,EAOtC,CAAC"}

package/dist/hints/rules/error-recovery.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Error Recovery Rules — highest priority
+ * Maps error patterns to actionable recovery hints.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorRecoveryRules = void 0;
+const patterns = [
+    {
+        test: /ref[^a-z]*not found|invalid ref|stale ref/i,
+        hint: 'Hint: Refs expire after page changes. Use read_page or find for fresh refs.',
+    },
+    {
+        test: /tab[^a-z]*not found|invalid tab|no such tab/i,
+        hint: 'Hint: Use tabs_context to list valid tabIds.',
+    },
+    {
+        test: /selector[^a-z]*(failed|not found|no match)|querySelectorAll.*returned 0|no elements? (found )?match/i,
+        hint: 'Hint: Try find(query) with natural language instead.',
+    },
+    {
+        test: /no clickable elements found|no good match found|click element error/i,
+        hint: 'Hint: Element may not be loaded. Try wait_and_click or read_page mode="dom" to verify.',
+    },
+    {
+        test: /captureScreenshot.*timed?\s*out|screenshot.*timed?\s*out|screenshot failed/i,
+        hint: 'Hint: Screenshot timed out on a slow page. Use read_page mode="dom" for instant page state without rendering. For heavy pages (Next.js dev, SPAs), always prefer read_page over screenshot.',
+    },
+    {
+        test: /timeout|timed?\s*out|navigation timeout/i,
+        hint: 'Hint: Page timed out. Try wait_for with type "selector" to wait for specific content, or navigate to a simpler URL first.',
+    },
+    {
+        test: /cannot read propert|null is not|undefined is not|is null|is undefined/i,
+        hint: 'Hint: Element is null. Use find or read_page to verify.',
+    },
+    {
+        test: /coordinate|click at position|x,?\s*y/i,
+        hint: 'Hint: Use click_element(query) instead — finds and clicks in one step.',
+    },
+    {
+        test: /^\s*\{\s*\}\s*$|"result":\s*\{\s*\}/,
+        hint: 'Hint: Empty object may indicate an async result. Wrap code in async IIFE: (async () => { return await ... })()',
+    },
+    {
+        test: /await is only valid in async/i,
+        hint: 'Hint: Top-level await is not supported in javascript_tool. Use Promise chaining instead: new Promise(r => setTimeout(r, ms)).then(() => yourCode). Or wrap in async IIFE: (async () => { await ...; return result; })()',
+    },
+];
+exports.errorRecoveryRules = patterns.map((p, i) => ({
+    name: `error-recovery-${i}`,
+    priority: 100 + i,
+    match(ctx) {
+        if (!ctx.isError)
+            return null;
+        return p.test.test(ctx.resultText) ? p.hint : null;
+    },
+}));
+//# sourceMappingURL=error-recovery.js.map

package/dist/hints/rules/error-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-recovery.js","sourceRoot":"","sources":["../../../src/hints/rules/error-recovery.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,MAAM,QAAQ,GAA0C;IACtD;QACE,IAAI,EAAE,4CAA4C;QAClD,IAAI,EAAE,6EAA6E;KACpF;IACD;QACE,IAAI,EAAE,8CAA8C;QACpD,IAAI,EAAE,8CAA8C;KACrD;IACD;QACE,IAAI,EAAE,sGAAsG;QAC5G,IAAI,EAAE,sDAAsD;KAC7D;IACD;QACE,IAAI,EAAE,sEAAsE;QAC5E,IAAI,EAAE,wFAAwF;KAC/F;IACD;QACE,IAAI,EAAE,6EAA6E;QACnF,IAAI,EAAE,6LAA6L;KACpM;IACD;QACE,IAAI,EAAE,0CAA0C;QAChD,IAAI,EAAE,2HAA2H;KAClI;IACD;QACE,IAAI,EAAE,wEAAwE;QAC9E,IAAI,EAAE,yDAAyD;KAChE;IACD;QACE,IAAI,EAAE,uCAAuC;QAC7C,IAAI,EAAE,wEAAwE;KAC/E;IACD;QACE,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE,gHAAgH;KACvH;IACD;QACE,IAAI,EAAE,+BAA+B;QACrC,IAAI,EAAE,yNAAyN;KAChO;CACF,CAAC;AAEW,QAAA,kBAAkB,GAAe,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,IAAI,EAAE,kBAAkB,CAAC,EAAE;IAC3B,QAAQ,EAAE,GAAG,GAAG,CAAC;IACjB,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC9B,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;CACF,CAAC,CAAC,CAAC"}

package/dist/hints/rules/learned-rules.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Learned Rules — dynamically matches against patterns discovered by PatternLearner.
+ * Priority 350: between repetition detection (250) and success hints (400).
+ */
+import type { HintRule } from '../hint-engine';
+import type { PatternLearner } from '../pattern-learner';
+/**
+ * Create a HintRule that delegates to the PatternLearner.
+ * The rule's match function reads current patterns at evaluation time,
+ * so newly learned patterns are immediately available.
+ */
+export declare function createLearnedRules(learner: PatternLearner): HintRule[];
+//# sourceMappingURL=learned-rules.d.ts.map

package/dist/hints/rules/learned-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learned-rules.d.ts","sourceRoot":"","sources":["../../../src/hints/rules/learned-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,EAAE,CAYtE"}

package/dist/hints/rules/learned-rules.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Learned Rules — dynamically matches against patterns discovered by PatternLearner.
+ * Priority 350: between repetition detection (250) and success hints (400).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLearnedRules = createLearnedRules;
+/**
+ * Create a HintRule that delegates to the PatternLearner.
+ * The rule's match function reads current patterns at evaluation time,
+ * so newly learned patterns are immediately available.
+ */
+function createLearnedRules(learner) {
+    return [
+        {
+            name: 'learned-pattern',
+            priority: 350,
+            match(ctx) {
+                if (!ctx.isError)
+                    return null;
+                const pattern = learner.matchPattern(ctx.resultText, ctx.toolName);
+                return pattern ? pattern.hint : null;
+            },
+        },
+    ];
+}
+//# sourceMappingURL=learned-rules.js.map

package/dist/hints/rules/learned-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learned-rules.js","sourceRoot":"","sources":["../../../src/hints/rules/learned-rules.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAUH,gDAYC;AAjBD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,OAAuB;IACxD,OAAO;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,GAAG;YACb,KAAK,CAAC,GAAG;gBACP,IAAI,CAAC,GAAG,CAAC,OAAO;oBAAE,OAAO,IAAI,CAAC;gBAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACnE,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACvC,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/hints/rules/pagination-detection.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pagination Detection — detects sequential pagination loops and suggests batch_paginate.
+ * Priority range: 190-199 (between error recovery at 100 and composite suggestions at 200).
+ */
+import type { HintRule } from '../hint-engine';
+export declare const paginationDetectionRules: HintRule[];
+//# sourceMappingURL=pagination-detection.d.ts.map

package/dist/hints/rules/pagination-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-detection.d.ts","sourceRoot":"","sources":["../../../src/hints/rules/pagination-detection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AAyM5D,eAAO,MAAM,wBAAwB,EAAE,QAAQ,EAkD9C,CAAC"}

package/dist/hints/rules/pagination-detection.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Pagination Detection — detects sequential pagination loops and suggests batch_paginate.
+ * Priority range: 190-199 (between error recovery at 100 and composite suggestions at 200).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paginationDetectionRules = void 0;
+// ---------------------------------------------------------------------------
+// Rule 1 helpers — keyboard navigation loop
+// ---------------------------------------------------------------------------
+const PAGINATION_KEYS = ['ArrowRight', 'ArrowDown', 'ArrowLeft', 'ArrowUp', 'PageDown', 'PageUp'];
+function detectKeyboardPaginationLoop(ctx) {
+    if (ctx.toolName !== 'computer') {
+        return { detected: false, tabId: null, key: null, count: 0 };
+    }
+    const recent = ctx.recentCalls;
+    if (recent.length < 3) {
+        return { detected: false, tabId: null, key: null, count: 0 };
+    }
+    let keyCount = 0;
+    let screenshotCount = 0;
+    let tabId = null;
+    let detectedKey = null;
+    for (const call of recent) {
+        if (call.toolName !== 'computer')
+            continue;
+        const args = call.args || {};
+        const action = args.action;
+        const callTabId = args.tabId;
+        if (tabId === null && callTabId)
+            tabId = callTabId;
+        if (callTabId && callTabId !== tabId)
+            continue; // different tab, skip
+        if (action === 'key') {
+            const keyText = args.text;
+            if (keyText && PAGINATION_KEYS.includes(keyText)) {
+                keyCount++;
+                if (!detectedKey)
+                    detectedKey = keyText;
+            }
+        }
+        if (action === 'screenshot')
+            screenshotCount++;
+    }
+    const detected = keyCount >= 2 && screenshotCount >= 2;
+    return { detected, tabId, key: detectedKey, count: keyCount + screenshotCount };
+}
+// ---------------------------------------------------------------------------
+// Rule 2 helpers — click "next" loop
+// ---------------------------------------------------------------------------
+const NEXT_PATTERNS = /next|다음|arrow|forward|›|»|page[-_]?next/i;
+function detectClickPaginationLoop(ctx) {
+    const isClickTool = ctx.toolName === 'click_element' ||
+        ctx.toolName === 'click' ||
+        (ctx.toolName === 'computer');
+    if (!isClickTool)
+        return { detected: false, selector: null, tabId: null };
+    const recent = ctx.recentCalls;
+    if (recent.length < 4)
+        return { detected: false, selector: null, tabId: null };
+    let clickNextCount = 0;
+    let screenshotCount = 0;
+    let detectedSelector = null;
+    let detectedTabId = null;
+    for (const call of recent) {
+        const args = call.args || {};
+        const callTabId = args.tabId;
+        if (call.toolName === 'click_element' || call.toolName === 'click') {
+            const selector = (args.selector || args.element || args.query || '');
+            const text = (args.text || args.label || '');
+            if (NEXT_PATTERNS.test(selector) || NEXT_PATTERNS.test(text)) {
+                clickNextCount++;
+                if (!detectedSelector)
+                    detectedSelector = selector || text;
+                if (!detectedTabId && callTabId)
+                    detectedTabId = callTabId;
+            }
+        }
+        else if (call.toolName === 'computer') {
+            const action = args.action;
+            if (action === 'click') {
+                const text = (args.text || '');
+                if (NEXT_PATTERNS.test(text)) {
+                    clickNextCount++;
+                    if (!detectedTabId && callTabId)
+                        detectedTabId = callTabId;
+                }
+            }
+            if (action === 'screenshot')
+                screenshotCount++;
+        }
+    }
+    const detected = clickNextCount >= 2 && screenshotCount >= 1;
+    return { detected, selector: detectedSelector, tabId: detectedTabId };
+}
+// ---------------------------------------------------------------------------
+// Rule 3 helpers — URL pagination loop
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to extract an incrementing page number from a URL.
+ * Returns { template, pages } where template has {N} placeholder, pages is sorted list.
+ */
+function extractUrlPagePattern(urls) {
+    if (urls.length < 2)
+        return null;
+    // Patterns to try (in order of preference):
+    // 1. query param: ?page=N or &page=N
+    // 2. path segment: /page/N or /p/N
+    // 3. any trailing number segment
+    const queryPattern = /([?&]page=)(\d+)/i;
+    const pathPattern = /(\/(page|p)\/?)(\d+)/i;
+    const trailingPattern = /\/(\d+)(\/?)(\?.*)?$/;
+    for (const regex of [queryPattern, pathPattern, trailingPattern]) {
+        const pageNums = [];
+        let template = null;
+        for (const url of urls) {
+            const m = url.match(regex);
+            if (!m)
+                break;
+            const num = parseInt(m[regex === queryPattern ? 2 : regex === pathPattern ? 3 : 1], 10);
+            pageNums.push(num);
+            if (!template) {
+                template = url.replace(regex, (match) => {
+                    if (regex === queryPattern)
+                        return match.replace(/\d+$/, '{N}');
+                    if (regex === pathPattern)
+                        return match.replace(/\d+$/, '{N}');
+                    return match.replace(/^\d+/, '{N}');
+                });
+            }
+        }
+        if (pageNums.length === urls.length && template) {
+            // Verify incrementing
+            const sorted = [...pageNums].sort((a, b) => a - b);
+            let isIncrementing = true;
+            for (let i = 1; i < sorted.length; i++) {
+                if (sorted[i] - sorted[i - 1] !== 1) {
+                    isIncrementing = false;
+                    break;
+                }
+            }
+            if (isIncrementing) {
+                return { template, pages: sorted };
+            }
+        }
+    }
+    return null;
+}
+function detectNavigateUrlLoop(ctx) {
+    if (ctx.toolName !== 'navigate') {
+        return { detected: false, template: null, startPage: 0, count: 0 };
+    }
+    const navigateCalls = ctx.recentCalls.filter((c) => c.toolName === 'navigate');
+    if (navigateCalls.length < 2) {
+        return { detected: false, template: null, startPage: 0, count: 0 };
+    }
+    const urls = navigateCalls
+        .map((c) => c.args?.url || '')
+        .filter(Boolean);
+    if (urls.length < 2) {
+        return { detected: false, template: null, startPage: 0, count: 0 };
+    }
+    const result = extractUrlPagePattern(urls);
+    if (!result) {
+        return { detected: false, template: null, startPage: 0, count: 0 };
+    }
+    return {
+        detected: true,
+        template: result.template,
+        startPage: result.pages[0],
+        count: result.pages.length,
+    };
+}
+// ---------------------------------------------------------------------------
+// Exported rules
+// ---------------------------------------------------------------------------
+exports.paginationDetectionRules = [
+    {
+        name: 'pagination-keyboard-loop',
+        priority: 190,
+        match(ctx) {
+            const { detected, tabId, key, count } = detectKeyboardPaginationLoop(ctx);
+            if (!detected)
+                return null;
+            const tabPart = tabId ? `tabId='${tabId}', ` : '';
+            const keyPart = key ? `keyAction='${key}', ` : '';
+            const n = Math.floor(count / 2);
+            return (`Hint: Sequential pagination loop detected (key+screenshot ×${n}). ` +
+                `Use batch_paginate(${tabPart}strategy='keyboard', ${keyPart}totalPages=N, captureMode='screenshot') ` +
+                `to capture all remaining pages in a single call — no manual navigation needed.`);
+        },
+    },
+    {
+        name: 'pagination-click-loop',
+        priority: 191,
+        match(ctx) {
+            const { detected, selector, tabId } = detectClickPaginationLoop(ctx);
+            if (!detected)
+                return null;
+            const tabPart = tabId ? `tabId='${tabId}', ` : '';
+            const selectorPart = selector ? `nextSelector='${selector}', ` : `nextSelector='[aria-label*=next], .next-page', `;
+            return (`Hint: Repeated next-click+screenshot loop detected. ` +
+                `Use batch_paginate(${tabPart}strategy='click', ${selectorPart}captureMode='screenshot') ` +
+                `to collect all pages automatically.`);
+        },
+    },
+    {
+        name: 'pagination-navigate-loop',
+        priority: 192,
+        match(ctx) {
+            const { detected, template, startPage, count } = detectNavigateUrlLoop(ctx);
+            if (!detected || !template)
+                return null;
+            return (`Hint: Sequential URL pagination detected (${count} pages so far, pattern: ${template}). ` +
+                `Use batch_paginate(strategy='url', urlTemplate='${template}', startPage=${startPage}, totalPages=N) ` +
+                `to fetch all pages in parallel instead of sequential navigate calls.`);
+        },
+    },
+];
+//# sourceMappingURL=pagination-detection.js.map

package/dist/hints/rules/pagination-detection.js.map

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

package/dist/hints/rules/repetition-detection.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Repetition Detection — generic patterns that catch inefficiency without hardcoded rules.
+ * Priority 250: between composite suggestions (200) and sequence detection (300).
+ */
+import type { HintRule } from '../hint-engine';
+export declare const repetitionDetectionRules: HintRule[];
+//# sourceMappingURL=repetition-detection.d.ts.map

package/dist/hints/rules/repetition-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repetition-detection.d.ts","sourceRoot":"","sources":["../../../src/hints/rules/repetition-detection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AAuD5D,eAAO,MAAM,wBAAwB,EAAE,QAAQ,EAiO9C,CAAC"}