claude-chrome-parallel 3.0.3 → 3.4.0

package/dist/hints/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hints module — Anti-삽질 hint system
+ */
+export { HintEngine } from './hint-engine';
+export type { HintContext, HintRule, HintLogEntry } from './hint-engine';
+export { PatternLearner } from './pattern-learner';
+export type { LearnedPattern } from './pattern-learner';
+//# sourceMappingURL=index.d.ts.map

package/dist/hints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hints/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/hints/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Hints module — Anti-삽질 hint system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatternLearner = exports.HintEngine = void 0;
+var hint_engine_1 = require("./hint-engine");
+Object.defineProperty(exports, "HintEngine", { enumerable: true, get: function () { return hint_engine_1.HintEngine; } });
+var pattern_learner_1 = require("./pattern-learner");
+Object.defineProperty(exports, "PatternLearner", { enumerable: true, get: function () { return pattern_learner_1.PatternLearner; } });
+//# sourceMappingURL=index.js.map

package/dist/hints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hints/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAEnB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/dist/hints/pattern-learner.d.ts

@@ -0,0 +1,76 @@
+/**
+ * PatternLearner — Adaptive memory system that learns error→recovery patterns.
+ *
+ * Flow:
+ * 1. Hint miss on error → start observing next 3 tool calls
+ * 2. If a different tool succeeds → record as recovery pattern
+ * 3. Same error→recovery seen N times → promote to learned rule
+ * 4. Persisted to JSON, survives across sessions
+ */
+export interface LearnedPattern {
+    id: string;
+    errorFingerprint: string;
+    errorTools: string[];
+    recoveryTool: string;
+    occurrences: number;
+    confidence: number;
+    firstSeen: number;
+    lastSeen: number;
+    hint: string;
+}
+export declare class PatternLearner {
+    private pending;
+    private rawObservations;
+    private patterns;
+    private filePath;
+    private dirty;
+    static readonly WATCH_WINDOW = 3;
+    static readonly PROMOTE_THRESHOLD = 3;
+    static readonly CONFIDENCE_THRESHOLD = 0.6;
+    static readonly MAX_PENDING = 10;
+    /**
+     * Enable persistence — load existing patterns and save new ones.
+     */
+    enablePersistence(dirPath: string): void;
+    /**
+     * Called when a hint miss occurs on an error (no static rule matched).
+     * Starts observing subsequent calls to detect recovery pattern.
+     */
+    onMiss(toolName: string, errorText: string): void;
+    /**
+     * Called on every tool completion to observe potential recovery patterns.
+     */
+    onToolComplete(toolName: string, isError: boolean): void;
+    /**
+     * Record an observed error→recovery correlation.
+     */
+    private recordRecovery;
+    /**
+     * Check if a raw observation should be promoted to a learned pattern.
+     */
+    private tryPromote;
+    /**
+     * Match an error against learned patterns.
+     */
+    matchPattern(errorText: string, toolName: string): LearnedPattern | null;
+    /**
+     * Normalize error text for fingerprinting.
+     * Strips dynamic values (IDs, large numbers) to group similar errors.
+     */
+    normalizeError(text: string): string;
+    /**
+     * Get all learned patterns (for testing/inspection).
+     */
+    getPatterns(): LearnedPattern[];
+    /**
+     * Get pending observation count (for testing).
+     */
+    getPendingCount(): number;
+    static generateHint(recoveryTool: string, occurrences: number): string;
+    private load;
+    /**
+     * Persist learned patterns to disk.
+     */
+    save(): void;
+}
+//# sourceMappingURL=pattern-learner.d.ts.map

package/dist/hints/pattern-learner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-learner.d.ts","sourceRoot":"","sources":["../../src/hints/pattern-learner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAsBD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,KAAK,CAAS;IAEtB,MAAM,CAAC,QAAQ,CAAC,YAAY,KAAK;IACjC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,KAAK;IACtC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,OAAO;IAC3C,MAAM,CAAC,QAAQ,CAAC,WAAW,MAAM;IAEjC;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUxC;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAiBjD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IA0BxD;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,UAAU;IA0ClB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAaxE;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAUpC;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;IAI/B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAItE,OAAO,CAAC,IAAI;IAWZ;;OAEG;IACH,IAAI,IAAI,IAAI;CAgBb"}

package/dist/hints/pattern-learner.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * PatternLearner — Adaptive memory system that learns error→recovery patterns.
+ *
+ * Flow:
+ * 1. Hint miss on error → start observing next 3 tool calls
+ * 2. If a different tool succeeds → record as recovery pattern
+ * 3. Same error→recovery seen N times → promote to learned rule
+ * 4. Persisted to JSON, survives across sessions
+ */
+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.PatternLearner = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class PatternLearner {
+    pending = [];
+    rawObservations = new Map();
+    patterns = [];
+    filePath = null;
+    dirty = false;
+    static WATCH_WINDOW = 3;
+    static PROMOTE_THRESHOLD = 3;
+    static CONFIDENCE_THRESHOLD = 0.6;
+    static MAX_PENDING = 10;
+    /**
+     * Enable persistence — load existing patterns and save new ones.
+     */
+    enablePersistence(dirPath) {
+        try {
+            fs.mkdirSync(dirPath, { recursive: true });
+            this.filePath = path.join(dirPath, 'learned-patterns.json');
+            this.load();
+        }
+        catch {
+            // Best-effort
+        }
+    }
+    /**
+     * Called when a hint miss occurs on an error (no static rule matched).
+     * Starts observing subsequent calls to detect recovery pattern.
+     */
+    onMiss(toolName, errorText) {
+        const fingerprint = this.normalizeError(errorText);
+        if (!fingerprint)
+            return;
+        // Limit pending observations to prevent memory buildup
+        if (this.pending.length >= PatternLearner.MAX_PENDING) {
+            this.pending.shift();
+        }
+        this.pending.push({
+            errorTool: toolName,
+            errorFingerprint: fingerprint,
+            timestamp: Date.now(),
+            remainingSlots: PatternLearner.WATCH_WINDOW,
+        });
+    }
+    /**
+     * Called on every tool completion to observe potential recovery patterns.
+     */
+    onToolComplete(toolName, isError) {
+        const resolved = [];
+        for (let i = 0; i < this.pending.length; i++) {
+            const obs = this.pending[i];
+            if (!isError && toolName !== obs.errorTool) {
+                // Success with different tool = potential recovery
+                this.recordRecovery(obs.errorFingerprint, obs.errorTool, toolName);
+                resolved.push(i);
+            }
+            else if (!isError && toolName === obs.errorTool) {
+                // Same tool succeeded = self-resolved, discard
+                resolved.push(i);
+            }
+            else {
+                // Another error, keep watching
+                obs.remainingSlots--;
+                if (obs.remainingSlots <= 0)
+                    resolved.push(i);
+            }
+        }
+        // Remove resolved observations (reverse order to preserve indices)
+        for (let i = resolved.length - 1; i >= 0; i--) {
+            this.pending.splice(resolved[i], 1);
+        }
+    }
+    /**
+     * Record an observed error→recovery correlation.
+     */
+    recordRecovery(errorFingerprint, errorTool, recoveryTool) {
+        let raw = this.rawObservations.get(errorFingerprint);
+        if (!raw) {
+            raw = {
+                errorFingerprint,
+                errorTools: new Set(),
+                recoveryTools: new Map(),
+                totalObservations: 0,
+            };
+            this.rawObservations.set(errorFingerprint, raw);
+        }
+        raw.errorTools.add(errorTool);
+        raw.recoveryTools.set(recoveryTool, (raw.recoveryTools.get(recoveryTool) || 0) + 1);
+        raw.totalObservations++;
+        this.tryPromote(raw);
+    }
+    /**
+     * Check if a raw observation should be promoted to a learned pattern.
+     */
+    tryPromote(raw) {
+        let bestTool = '';
+        let bestCount = 0;
+        for (const [tool, count] of raw.recoveryTools) {
+            if (count > bestCount) {
+                bestTool = tool;
+                bestCount = count;
+            }
+        }
+        const confidence = bestCount / raw.totalObservations;
+        if (bestCount < PatternLearner.PROMOTE_THRESHOLD || confidence < PatternLearner.CONFIDENCE_THRESHOLD) {
+            return;
+        }
+        const existing = this.patterns.find(p => p.errorFingerprint === raw.errorFingerprint);
+        if (existing) {
+            existing.occurrences = bestCount;
+            existing.confidence = confidence;
+            existing.recoveryTool = bestTool;
+            existing.lastSeen = Date.now();
+            existing.errorTools = Array.from(raw.errorTools);
+            existing.hint = PatternLearner.generateHint(bestTool, bestCount);
+        }
+        else {
+            this.patterns.push({
+                id: `learned-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                errorFingerprint: raw.errorFingerprint,
+                errorTools: Array.from(raw.errorTools),
+                recoveryTool: bestTool,
+                occurrences: bestCount,
+                confidence,
+                firstSeen: Date.now(),
+                lastSeen: Date.now(),
+                hint: PatternLearner.generateHint(bestTool, bestCount),
+            });
+        }
+        this.dirty = true;
+        this.save();
+    }
+    /**
+     * Match an error against learned patterns.
+     */
+    matchPattern(errorText, toolName) {
+        const fingerprint = this.normalizeError(errorText);
+        for (const pattern of this.patterns) {
+            if (pattern.errorTools.includes(toolName) &&
+                (fingerprint.includes(pattern.errorFingerprint) || pattern.errorFingerprint.includes(fingerprint))) {
+                return pattern;
+            }
+        }
+        return null;
+    }
+    /**
+     * Normalize error text for fingerprinting.
+     * Strips dynamic values (IDs, large numbers) to group similar errors.
+     */
+    normalizeError(text) {
+        return text
+            .toLowerCase()
+            .replace(/\b[0-9a-f]{8,}\b/g, '{id}')
+            .replace(/\d{4,}/g, '{n}')
+            .replace(/\s+/g, ' ')
+            .trim()
+            .slice(0, 100);
+    }
+    /**
+     * Get all learned patterns (for testing/inspection).
+     */
+    getPatterns() {
+        return this.patterns;
+    }
+    /**
+     * Get pending observation count (for testing).
+     */
+    getPendingCount() {
+        return this.pending.length;
+    }
+    static generateHint(recoveryTool, occurrences) {
+        return `Hint: Try ${recoveryTool} — learned from ${occurrences} previous recoveries.`;
+    }
+    load() {
+        if (!this.filePath)
+            return;
+        try {
+            const data = fs.readFileSync(this.filePath, 'utf-8');
+            const store = JSON.parse(data);
+            this.patterns = store.patterns || [];
+        }
+        catch {
+            this.patterns = [];
+        }
+    }
+    /**
+     * Persist learned patterns to disk.
+     */
+    save() {
+        if (!this.filePath || !this.dirty)
+            return;
+        try {
+            const dir = path.dirname(this.filePath);
+            fs.mkdirSync(dir, { recursive: true });
+            const store = {
+                version: 1,
+                patterns: this.patterns,
+                updatedAt: Date.now(),
+            };
+            fs.writeFileSync(this.filePath, JSON.stringify(store, null, 2));
+            this.dirty = false;
+        }
+        catch {
+            // Best-effort
+        }
+    }
+}
+exports.PatternLearner = PatternLearner;
+//# sourceMappingURL=pattern-learner.js.map

package/dist/hints/pattern-learner.js.map

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

package/dist/hints/rules/composite-suggestions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Composite Suggestions — suggests combining multi-step patterns into single calls.
+ */
+import type { HintRule } from '../hint-engine';
+export declare const compositeSuggestionRules: HintRule[];
+//# sourceMappingURL=composite-suggestions.d.ts.map

package/dist/hints/rules/composite-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-suggestions.d.ts","sourceRoot":"","sources":["../../../src/hints/rules/composite-suggestions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AAU5D,eAAO,MAAM,wBAAwB,EAAE,QAAQ,EA4C9C,CAAC"}

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

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Composite Suggestions — suggests combining multi-step patterns into single calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compositeSuggestionRules = void 0;
+function lastToolWas(ctx, name) {
+    return ctx.recentCalls.length > 0 && ctx.recentCalls[0].toolName === name;
+}
+function recentToolCount(ctx, name) {
+    return ctx.recentCalls.filter(c => c.toolName === name).length;
+}
+exports.compositeSuggestionRules = [
+    {
+        name: 'find-then-click',
+        priority: 200,
+        match(ctx) {
+            if (ctx.toolName !== 'computer' && ctx.toolName !== 'click')
+                return null;
+            if (!lastToolWas(ctx, 'find'))
+                return null;
+            return 'Hint: Use click_element to find+click in one call.';
+        },
+    },
+    {
+        name: 'multiple-form-input',
+        priority: 201,
+        match(ctx) {
+            if (ctx.toolName !== 'form_input')
+                return null;
+            if (recentToolCount(ctx, 'form_input') >= 1) {
+                return 'Hint: Use fill_form({fields:{...}}) for multiple fields.';
+            }
+            return null;
+        },
+    },
+    {
+        name: 'navigate-then-click',
+        priority: 202,
+        match(ctx) {
+            if (ctx.toolName !== 'computer' && ctx.toolName !== 'click' && ctx.toolName !== 'click_element')
+                return null;
+            if (!lastToolWas(ctx, 'navigate'))
+                return null;
+            // Don't match screenshot operations — handled by sequence-detection
+            if (/screenshot/i.test(ctx.resultText))
+                return null;
+            return 'Hint: Use wait_and_click to handle loading delays.';
+        },
+    },
+    {
+        name: 'read-page-truncated',
+        priority: 203,
+        match(ctx) {
+            if (ctx.toolName !== 'read_page')
+                return null;
+            if (ctx.isError)
+                return null;
+            if (/truncat|too (long|large)|content cut|\.\.\.$/i.test(ctx.resultText)) {
+                return 'Hint: Use find(query) for targeted element search.';
+            }
+            return null;
+        },
+    },
+];
+//# sourceMappingURL=composite-suggestions.js.map

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":";AAAA;;GAEG;;;AAIH,SAAS,WAAW,CAAC,GAAgB,EAAE,IAAY;IACjD,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC;AAC5E,CAAC;AAED,SAAS,eAAe,CAAC,GAAgB,EAAE,IAAY;IACrD,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;AACjE,CAAC;AAEY,QAAA,wBAAwB,GAAe;IAClD;QACE,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,GAAG;QACb,KAAK,CAAC,GAAG;YACP,IAAI,GAAG,CAAC,QAAQ,KAAK,UAAU,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAC;YACzE,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC3C,OAAO,oDAAoD,CAAC;QAC9D,CAAC;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,GAAG;QACb,KAAK,CAAC,GAAG;YACP,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY;gBAAE,OAAO,IAAI,CAAC;YAC/C,IAAI,eAAe,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,OAAO,0DAA0D,CAAC;YACpE,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,GAAG;QACb,KAAK,CAAC,GAAG;YACP,IAAI,GAAG,CAAC,QAAQ,KAAK,UAAU,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,eAAe;gBAAE,OAAO,IAAI,CAAC;YAC7G,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/C,oEAAoE;YACpE,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpD,OAAO,oDAAoD,CAAC;QAC9D,CAAC;KACF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,GAAG;QACb,KAAK,CAAC,GAAG;YACP,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW;gBAAE,OAAO,IAAI,CAAC;YAC9C,IAAI,GAAG,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC7B,IAAI,+CAA+C,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzE,OAAO,oDAAoD,CAAC;YAC9D,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF;CACF,CAAC"}

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;AAiC/C,eAAO,MAAM,kBAAkB,EAAE,QAAQ,EAOtC,CAAC"}

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

@@ -0,0 +1,47 @@
+"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_mcp to list valid tabIds.',
+    },
+    {
+        test: /selector[^a-z]*(failed|not found|no match)|querySelectorAll.*returned 0|no elements? match/i,
+        hint: 'Hint: Try find(query) with natural language instead.',
+    },
+    {
+        test: /click_element[^a-z]*(no match|not found|could not find)/i,
+        hint: 'Hint: Element may not be loaded. Try wait_and_click.',
+    },
+    {
+        test: /timeout|timed?\s*out|navigation timeout/i,
+        hint: 'Hint: Page may require login or different navigation.',
+    },
+    {
+        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.',
+    },
+];
+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,kDAAkD;KACzD;IACD;QACE,IAAI,EAAE,6FAA6F;QACnG,IAAI,EAAE,sDAAsD;KAC7D;IACD;QACE,IAAI,EAAE,0DAA0D;QAChE,IAAI,EAAE,sDAAsD;KAC7D;IACD;QACE,IAAI,EAAE,0CAA0C;QAChD,IAAI,EAAE,uDAAuD;KAC9D;IACD;QACE,IAAI,EAAE,wEAAwE;QAC9E,IAAI,EAAE,yDAAyD;KAChE;IACD;QACE,IAAI,EAAE,uCAAuC;QAC7C,IAAI,EAAE,wEAAwE;KAC/E;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/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;AA4C5D,eAAO,MAAM,wBAAwB,EAAE,QAAQ,EA8B9C,CAAC"}