claude-chrome-parallel 1.0.0

package/dist/hints/hint-engine.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * HintEngine — evaluates rules against tool results to produce proactive hints.
+ *
+ * Rules are sorted by priority (lower = higher priority) and evaluated first-match-wins.
+ * Uses ActivityTracker's recent calls for sequence/pattern detection.
+ * Integrates PatternLearner for adaptive error→recovery learning.
+ */
+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.HintEngine = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const pattern_learner_1 = require("./pattern-learner");
+const error_recovery_1 = require("./rules/error-recovery");
+const composite_suggestions_1 = require("./rules/composite-suggestions");
+const sequence_detection_1 = require("./rules/sequence-detection");
+const repetition_detection_1 = require("./rules/repetition-detection");
+const learned_rules_1 = require("./rules/learned-rules");
+const success_hints_1 = require("./rules/success-hints");
+class HintEngine {
+    rules;
+    activityTracker;
+    learner;
+    logFilePath = null;
+    // Buffered async write stream
+    logStream = null;
+    logBuffer = [];
+    flushTimer = null;
+    static FLUSH_INTERVAL = 200; // ms
+    constructor(activityTracker) {
+        this.activityTracker = activityTracker;
+        this.learner = new pattern_learner_1.PatternLearner();
+        // Collect all rules and sort by priority (ascending = highest priority first)
+        // Learned rules (350) sit between repetition (250) and success hints (400)
+        this.rules = [
+            ...error_recovery_1.errorRecoveryRules,
+            ...composite_suggestions_1.compositeSuggestionRules,
+            ...sequence_detection_1.sequenceDetectionRules,
+            ...repetition_detection_1.repetitionDetectionRules,
+            ...(0, learned_rules_1.createLearnedRules)(this.learner),
+            ...success_hints_1.successHintRules,
+        ].sort((a, b) => a.priority - b.priority);
+        // Flush remaining buffer on process exit
+        process.on('exit', () => {
+            this.flushBuffer();
+        });
+    }
+    /**
+     * Enable hit/miss logging to a JSONL file for data collection.
+     */
+    enableLogging(dirPath) {
+        try {
+            fs.mkdirSync(dirPath, { recursive: true });
+            this.logFilePath = path.join(dirPath, `hints-${new Date().toISOString().slice(0, 10)}.jsonl`);
+            this.logStream = fs.createWriteStream(this.logFilePath, { flags: 'a' });
+        }
+        catch {
+            // Best-effort logging
+        }
+    }
+    /**
+     * Enable adaptive learning — load existing patterns and persist new ones.
+     */
+    enableLearning(dirPath) {
+        this.learner.enablePersistence(dirPath);
+    }
+    /**
+     * Evaluate rules and return the first matching hint, or null.
+     * Also feeds the learner for adaptive pattern detection.
+     */
+    getHint(toolName, result, isError) {
+        const resultText = this.extractText(result);
+        const recentCalls = this.activityTracker.getRecentCalls(5);
+        const ctx = { toolName, resultText, isError, recentCalls };
+        let matchedRule = null;
+        let hint = null;
+        for (const rule of this.rules) {
+            const h = rule.match(ctx);
+            if (h) {
+                matchedRule = rule.name;
+                hint = h;
+                break;
+            }
+        }
+        // Feed the learner: observe every completion for recovery detection
+        this.learner.onToolComplete(toolName, isError);
+        // If no rule matched an error, start learning observation
+        if (hint === null && isError) {
+            this.learner.onMiss(toolName, resultText);
+        }
+        this.log({ timestamp: Date.now(), toolName, isError, matchedRule, hint });
+        return hint;
+    }
+    /**
+     * Extract text content from an MCPResult for pattern matching.
+     */
+    extractText(result) {
+        const content = result.content;
+        if (!Array.isArray(content))
+            return JSON.stringify(result);
+        return content
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('\n');
+    }
+    /**
+     * Write a log entry via buffered async stream (best-effort, non-blocking).
+     */
+    log(entry) {
+        if (!this.logStream)
+            return;
+        this.logBuffer.push(JSON.stringify(entry) + '\n');
+        if (!this.flushTimer) {
+            this.flushTimer = setTimeout(() => {
+                this.flushBuffer();
+            }, HintEngine.FLUSH_INTERVAL);
+        }
+    }
+    /**
+     * Flush buffered log entries to the write stream.
+     */
+    flushBuffer() {
+        if (this.logBuffer.length > 0 && this.logStream) {
+            const data = this.logBuffer.join('');
+            this.logStream.write(data);
+            this.logBuffer = [];
+        }
+        this.flushTimer = null;
+    }
+    /**
+     * Flush pending writes and close the log stream. Call on shutdown.
+     */
+    destroy() {
+        this.flushBuffer();
+        if (this.logStream) {
+            this.logStream.end();
+            this.logStream = null;
+        }
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    /**
+     * Get all registered rules (for testing).
+     */
+    getRules() {
+        return this.rules;
+    }
+    /**
+     * Get the pattern learner (for testing).
+     */
+    getLearner() {
+        return this.learner;
+    }
+}
+exports.HintEngine = HintEngine;
+//# sourceMappingURL=hint-engine.js.map

package/dist/hints/hint-engine.js.map

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

package/dist/hints/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hints module — Proactive 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 — Proactive 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;AAyC/C,eAAO,MAAM,kBAAkB,EAAE,QAAQ,EAOtC,CAAC"}