openchrome-mcp 1.9.6 → 1.9.7

package/dist/actions/action-cache.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Action Cache - Domain memory integration for caching successful action sequences.
+ *
+ * After a successful `act` execution, saves the instruction→sequence mapping.
+ * On repeat visits to the same domain, tries the cached sequence first.
+ */
+import { ParsedAction } from './action-parser';
+export interface CachedSequence {
+    instruction: string;
+    actions: ParsedAction[];
+    cachedAt: number;
+}
+/**
+ * Look up a cached action sequence for the given instruction and domain.
+ * Returns null if no cache hit or confidence is too low.
+ */
+export declare function getCachedSequence(url: string, instruction: string): CachedSequence | null;
+/**
+ * Cache a successful action sequence for the given domain.
+ */
+export declare function cacheSequence(url: string, instruction: string, actions: ParsedAction[]): void;
+/**
+ * Report success/failure for a cached sequence to adjust confidence.
+ */
+export declare function validateCachedSequence(url: string, instruction: string, success: boolean): void;
+//# sourceMappingURL=action-cache.d.ts.map

package/dist/actions/action-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-cache.d.ts","sourceRoot":"","sources":["../../src/actions/action-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/C,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAmBzF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAa7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAW/F"}

package/dist/actions/action-cache.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Action Cache - Domain memory integration for caching successful action sequences.
+ *
+ * After a successful `act` execution, saves the instruction→sequence mapping.
+ * On repeat visits to the same domain, tries the cached sequence first.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedSequence = getCachedSequence;
+exports.cacheSequence = cacheSequence;
+exports.validateCachedSequence = validateCachedSequence;
+const domain_memory_1 = require("../memory/domain-memory");
+const CACHE_KEY_PREFIX = 'act-sequence:';
+const MIN_CONFIDENCE = 0.6;
+/**
+ * Look up a cached action sequence for the given instruction and domain.
+ * Returns null if no cache hit or confidence is too low.
+ */
+function getCachedSequence(url, instruction) {
+    const domain = (0, domain_memory_1.extractDomainFromUrl)(url);
+    if (!domain)
+        return null;
+    const key = CACHE_KEY_PREFIX + normalizeForCache(instruction);
+    const memory = (0, domain_memory_1.getDomainMemory)();
+    const entries = memory.query(domain, key);
+    if (entries.length === 0)
+        return null;
+    const best = entries[0]; // Already sorted by confidence desc
+    if (best.confidence < MIN_CONFIDENCE)
+        return null;
+    try {
+        const cached = JSON.parse(best.value);
+        return cached;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Cache a successful action sequence for the given domain.
+ */
+function cacheSequence(url, instruction, actions) {
+    const domain = (0, domain_memory_1.extractDomainFromUrl)(url);
+    if (!domain)
+        return;
+    const key = CACHE_KEY_PREFIX + normalizeForCache(instruction);
+    const value = {
+        instruction,
+        actions,
+        cachedAt: Date.now(),
+    };
+    const memory = (0, domain_memory_1.getDomainMemory)();
+    memory.record(domain, key, JSON.stringify(value));
+}
+/**
+ * Report success/failure for a cached sequence to adjust confidence.
+ */
+function validateCachedSequence(url, instruction, success) {
+    const domain = (0, domain_memory_1.extractDomainFromUrl)(url);
+    if (!domain)
+        return;
+    const key = CACHE_KEY_PREFIX + normalizeForCache(instruction);
+    const memory = (0, domain_memory_1.getDomainMemory)();
+    const entries = memory.query(domain, key);
+    if (entries.length > 0) {
+        memory.validate(entries[0].id, success);
+    }
+}
+/**
+ * Normalize instruction for cache key: lowercase, collapse whitespace, trim.
+ */
+function normalizeForCache(instruction) {
+    return instruction.toLowerCase().replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=action-cache.js.map

package/dist/actions/action-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-cache.js","sourceRoot":"","sources":["../../src/actions/action-cache.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAkBH,8CAmBC;AAKD,sCAaC;AAKD,wDAWC;AArED,2DAAgF;AAGhF,MAAM,gBAAgB,GAAG,eAAe,CAAC;AACzC,MAAM,cAAc,GAAG,GAAG,CAAC;AAQ3B;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,GAAW,EAAE,WAAmB;IAChE,MAAM,MAAM,GAAG,IAAA,oCAAoB,EAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,MAAM,GAAG,GAAG,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAA,+BAAe,GAAE,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,oCAAoC;IAC7D,IAAI,IAAI,CAAC,UAAU,GAAG,cAAc;QAAE,OAAO,IAAI,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,MAAM,GAAmB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,GAAW,EAAE,WAAmB,EAAE,OAAuB;IACrF,MAAM,MAAM,GAAG,IAAA,oCAAoB,EAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,GAAG,GAAG,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAmB;QAC5B,WAAW;QACX,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;KACrB,CAAC;IAEF,MAAM,MAAM,GAAG,IAAA,+BAAe,GAAE,CAAC;IACjC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,GAAW,EAAE,WAAmB,EAAE,OAAgB;IACvF,MAAM,MAAM,GAAG,IAAA,oCAAoB,EAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,GAAG,GAAG,gBAAgB,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAA,+BAAe,GAAE,CAAC;IACjC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE1C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,OAAO,WAAW,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC"}

package/dist/actions/action-parser.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Action Parser - Converts natural language instructions into structured action sequences.
+ * Uses pattern matching and keyword extraction only — no LLM calls.
+ */
+export type ActionVerb = 'click' | 'type' | 'select' | 'check' | 'uncheck' | 'hover' | 'scroll' | 'wait' | 'navigate';
+export interface ParsedAction {
+    action: ActionVerb;
+    target?: string;
+    value?: string;
+    condition?: string;
+}
+export interface ParseResult {
+    success: boolean;
+    actions: ParsedAction[];
+    error?: string;
+    suggestion?: string;
+}
+/**
+ * Parse a natural language browser instruction into a structured action sequence.
+ * Pure pattern-matching — no LLM calls, no network I/O.
+ */
+export declare function parseInstruction(instruction: string): ParseResult;
+//# sourceMappingURL=action-parser.d.ts.map

package/dist/actions/action-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-parser.d.ts","sourceRoot":"","sources":["../../src/actions/action-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAkTD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CA0CjE"}

package/dist/actions/action-parser.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * Action Parser - Converts natural language instructions into structured action sequences.
+ * Uses pattern matching and keyword extraction only — no LLM calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseInstruction = parseInstruction;
+// ---------------------------------------------------------------------------
+// Verb detection patterns
+// ---------------------------------------------------------------------------
+/** Returns the ActionVerb for a given phrase prefix, or null if unrecognised. */
+function detectVerb(phrase) {
+    const s = phrase.trim().toLowerCase();
+    // Korean — check first so multi-byte sequences don't interfere with ASCII patterns
+    if (/체크\s*해제|언체크/.test(s))
+        return 'uncheck';
+    if (/체크/.test(s))
+        return 'check';
+    if (/클릭|누르|탭/.test(s))
+        return 'click';
+    if (/입력|작성|쓰|타이핑/.test(s))
+        return 'type';
+    if (/선택|고르/.test(s))
+        return 'select';
+    if (/호버|마우스\s*오버/.test(s))
+        return 'hover';
+    if (/스크롤/.test(s))
+        return 'scroll';
+    if (/기다리|대기/.test(s))
+        return 'wait';
+    if (/이동|열|방문|접속/.test(s))
+        return 'navigate';
+    // English — longer phrases before shorter ones to avoid partial matches
+    if (/^(?:hover\s+over|mouse\s+over|hover)\b/.test(s))
+        return 'hover';
+    if (/^(?:scroll\s+(?:down|up|to)|scroll)\b/.test(s))
+        return 'scroll';
+    if (/^(?:wait\s+for|wait)\b/.test(s))
+        return 'wait';
+    if (/^(?:navigate\s+to|go\s+to|open|visit)\b/.test(s))
+        return 'navigate';
+    if (/^(?:fill\s+in|type|enter|input|write)\b/.test(s))
+        return 'type';
+    if (/^(?:select|choose|pick)\b/.test(s))
+        return 'select';
+    if (/^(?:uncheck|untick)\b/.test(s))
+        return 'uncheck';
+    if (/^(?:check|tick)\b/.test(s))
+        return 'check';
+    if (/^(?:click|press|tap)\b/.test(s))
+        return 'click';
+    return null;
+}
+/** True if the trimmed phrase starts with a recognised verb (English or Korean). */
+function startsWithVerb(phrase) {
+    return detectVerb(phrase) !== null;
+}
+// ---------------------------------------------------------------------------
+// Compound instruction splitter
+// ---------------------------------------------------------------------------
+/**
+ * Split a compound instruction into individual clauses.
+ * Splitting happens on:
+ *   ", then "  /  ", and then "
+ *   " then "   — only when followed by a verb
+ *   " and "    — only when followed by a verb (avoids "name and email")
+ *   ","        — followed by a space and a verb
+ */
+function splitIntoSegments(instruction) {
+    // Normalise whitespace
+    const text = instruction.trim().replace(/\s+/g, ' ');
+    // First pass: split on ", then " and ", and then " unconditionally
+    const parts = [];
+    const unconditional = text.split(/,\s*and\s+then\s+|,\s*then\s+/i);
+    for (const part of unconditional) {
+        // Second pass within each part: Korean conjunctions, then English conjunctions
+        const koreanParts = splitOnKoreanConjunctions(part.trim());
+        for (const kp of koreanParts) {
+            const subParts = splitOnConjunctions(kp.trim());
+            parts.push(...subParts);
+        }
+    }
+    return parts.filter(p => p.length > 0);
+}
+/**
+ * Split Korean compound sentences on conjunctive endings:
+ * "하고" (and do), "이고" (and), "고" after verb stem.
+ * e.g. "이메일을 입력하고 제출 버튼을 클릭해" → ["이메일을 입력하고", "제출 버튼을 클릭해"]
+ * We split AFTER the "하고/고" suffix so the first segment retains it for verb detection.
+ */
+function splitOnKoreanConjunctions(text) {
+    // Split on "하고 " (connective "and") between two Korean segments
+    // Pattern: split at boundary after "하고" followed by a Korean character
+    const parts = [];
+    // Match "하고" or "이고" or "ㄱ고" connectives between clauses
+    const re = /하고\s+(?=\S)/gu;
+    let lastIndex = 0;
+    let match;
+    while ((match = re.exec(text)) !== null) {
+        // Include "하고" in the first segment so its verb can still be detected
+        parts.push(text.slice(lastIndex, match.index + 2).trim()); // up to and including "하고"
+        lastIndex = match.index + match[0].length;
+    }
+    parts.push(text.slice(lastIndex).trim());
+    return parts.filter(p => p.length > 0);
+}
+function splitOnConjunctions(text) {
+    // Split on "WORD, VERB" — comma followed by a verb-starting word
+    // or " then VERB" / " and VERB"
+    const result = [];
+    let remaining = text;
+    // Pattern: (", " | " then " | " and ") followed by a verb-starting token
+    const re = /(?:,\s+|\s+then\s+|\s+and\s+)(?=[a-z\u3131-\uD7A3\u4E00-\u9FFF])/gi;
+    let lastIndex = 0;
+    let match;
+    while ((match = re.exec(remaining)) !== null) {
+        const afterSplit = remaining.slice(match.index + match[0].length);
+        if (startsWithVerb(afterSplit)) {
+            result.push(remaining.slice(lastIndex, match.index).trim());
+            lastIndex = match.index + match[0].length;
+        }
+    }
+    result.push(remaining.slice(lastIndex).trim());
+    return result.filter(p => p.length > 0);
+}
+// ---------------------------------------------------------------------------
+// Value / target extractors per verb
+// ---------------------------------------------------------------------------
+/** Detect a URL anywhere in a string. */
+function extractUrl(text) {
+    const m = text.match(/https?:\/\/[^\s,"']+/);
+    return m ? m[0] : undefined;
+}
+function parseClickPhrase(phrase) {
+    const s = phrase.trim();
+    // Korean: "{target}을/를 클릭" or "{target} 클릭"
+    const krMatch = s.match(/^(.+?)(?:을|를)?\s+(?:클릭|누르|탭)/u);
+    if (krMatch) {
+        return { action: 'click', target: krMatch[1].trim() };
+    }
+    // English: strip leading verb words
+    const stripped = s.replace(/^(?:click|press|tap)\s+(?:on\s+)?(?:the\s+)?/i, '');
+    return { action: 'click', target: stripped || undefined };
+}
+function parseTypePhrase(phrase) {
+    const s = phrase.trim();
+    // Korean: "{target}에 {value}을/를 입력" or "{value}을/를 입력"
+    const krInTarget = s.match(/^(.+?)에\s+(.+?)(?:을|를)?\s+입력/u);
+    if (krInTarget) {
+        return { action: 'type', target: krInTarget[1].trim(), value: krInTarget[2].trim() };
+    }
+    const krNoTarget = s.match(/^(.+?)(?:을|를)?\s+입력/u);
+    if (krNoTarget) {
+        return { action: 'type', value: krNoTarget[1].trim() };
+    }
+    // English patterns:
+    // "type {value} in(to) the {target}"
+    const inMatch = s.match(/^(?:type|enter|input|fill\s+in|write)\s+(.+?)\s+in(?:to)?\s+(?:the\s+)?(.+)$/i);
+    if (inMatch) {
+        return { action: 'type', value: inMatch[1].trim(), target: inMatch[2].trim() };
+    }
+    // "type {value}"
+    const simpleMatch = s.match(/^(?:type|enter|input|fill\s+in|write)\s+(.+)$/i);
+    if (simpleMatch) {
+        return { action: 'type', value: simpleMatch[1].trim() };
+    }
+    return { action: 'type' };
+}
+function parseSelectPhrase(phrase) {
+    const s = phrase.trim();
+    // "select {value} from (the) {target}" / "choose {value} in (the) {target}"
+    const fromMatch = s.match(/^(?:select|choose|pick)\s+(.+?)\s+(?:from|in)\s+(?:the\s+)?(.+)$/i);
+    if (fromMatch) {
+        return { action: 'select', value: fromMatch[1].trim(), target: fromMatch[2].trim() };
+    }
+    // Korean: "{value}을/를 선택" or "{target}에서 {value} 선택"
+    const krSelect = s.match(/^(.+?)(?:을|를)?\s+선택/u);
+    if (krSelect) {
+        return { action: 'select', value: krSelect[1].trim() };
+    }
+    const stripped = s.replace(/^(?:select|choose|pick)\s+/i, '');
+    return { action: 'select', target: stripped || undefined };
+}
+function parseNavigatePhrase(phrase) {
+    const s = phrase.trim();
+    // Extract URL first
+    const url = extractUrl(s);
+    if (url) {
+        return { action: 'navigate', value: url };
+    }
+    // Korean: "{url}로 이동" / "{url}에 접속"
+    const krNav = s.match(/^(.+?)(?:로|에)\s+(?:이동|접속)/u);
+    if (krNav) {
+        return { action: 'navigate', value: krNav[1].trim() };
+    }
+    // English: strip verb prefix
+    const stripped = s.replace(/^(?:navigate\s+to|go\s+to|open|visit)\s+/i, '');
+    return { action: 'navigate', value: stripped || undefined };
+}
+function parseScrollPhrase(phrase) {
+    const s = phrase.trim();
+    // "scroll down to {target}" / "scroll up to {target}" / "scroll to {target}"
+    const toMatch = s.match(/^(?:스크롤\s+)?scroll\s+(?:down\s+to|up\s+to|to)\s+(?:the\s+)?(.+)$/i);
+    if (toMatch) {
+        return { action: 'scroll', target: toMatch[1].trim() };
+    }
+    // "scroll down" / "scroll up"
+    const dirMatch = s.match(/^(?:스크롤\s+)?scroll\s+(down|up)$/i);
+    if (dirMatch) {
+        return { action: 'scroll', value: dirMatch[1].toLowerCase() };
+    }
+    // Korean bare: "스크롤"
+    if (/^스크롤$/.test(s)) {
+        return { action: 'scroll' };
+    }
+    const stripped = s.replace(/^(?:스크롤|scroll)\s+/i, '');
+    return { action: 'scroll', target: stripped || undefined };
+}
+function parseWaitPhrase(phrase) {
+    const s = phrase.trim();
+    // "wait for {target} to {condition}"
+    const toCondMatch = s.match(/^(?:wait\s+for|wait)\s+(?:the\s+)?(.+?)\s+to\s+(appear|disappear|load)$/i);
+    if (toCondMatch) {
+        return { action: 'wait', target: toCondMatch[1].trim(), condition: toCondMatch[2].toLowerCase() };
+    }
+    // "wait for {target}"
+    const forMatch = s.match(/^(?:wait\s+for|wait)\s+(?:the\s+)?(.+)$/i);
+    if (forMatch) {
+        return { action: 'wait', target: forMatch[1].trim(), condition: 'appear' };
+    }
+    // Korean: "{target}을/를 기다리" or "기다리"
+    const krWait = s.match(/^(.+?)(?:을|를)?\s*(?:기다리|대기)/u);
+    if (krWait) {
+        return { action: 'wait', target: krWait[1].trim(), condition: 'appear' };
+    }
+    return { action: 'wait', condition: 'appear' };
+}
+function parseCheckPhrase(phrase, verb) {
+    const s = phrase.trim();
+    const stripped = s.replace(/^(?:uncheck|untick|check|tick|체크\s*해제|언체크|체크)\s+(?:the\s+)?/i, '');
+    return { action: verb, target: stripped || undefined };
+}
+function parseHoverPhrase(phrase) {
+    const s = phrase.trim();
+    const stripped = s.replace(/^(?:hover\s+over|mouse\s+over|hover|호버|마우스\s*오버)\s+(?:the\s+)?/i, '');
+    return { action: 'hover', target: stripped || undefined };
+}
+// ---------------------------------------------------------------------------
+// Single-phrase parser
+// ---------------------------------------------------------------------------
+function parsePhrase(phrase) {
+    const trimmed = phrase.trim();
+    if (!trimmed)
+        return null;
+    const verb = detectVerb(trimmed);
+    if (!verb) {
+        // Check if it contains a URL — treat as navigate
+        const url = extractUrl(trimmed);
+        if (url)
+            return { action: 'navigate', value: url };
+        return null;
+    }
+    switch (verb) {
+        case 'click': return parseClickPhrase(trimmed);
+        case 'type': return parseTypePhrase(trimmed);
+        case 'select': return parseSelectPhrase(trimmed);
+        case 'navigate': return parseNavigatePhrase(trimmed);
+        case 'scroll': return parseScrollPhrase(trimmed);
+        case 'wait': return parseWaitPhrase(trimmed);
+        case 'check': return parseCheckPhrase(trimmed, 'check');
+        case 'uncheck': return parseCheckPhrase(trimmed, 'uncheck');
+        case 'hover': return parseHoverPhrase(trimmed);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a natural language browser instruction into a structured action sequence.
+ * Pure pattern-matching — no LLM calls, no network I/O.
+ */
+function parseInstruction(instruction) {
+    if (!instruction || instruction.trim().length === 0) {
+        return {
+            success: false,
+            actions: [],
+            error: 'Instruction is empty',
+            suggestion: 'Provide a natural language instruction such as "click the login button" or "type hello in the search box".',
+        };
+    }
+    const segments = splitIntoSegments(instruction);
+    const actions = [];
+    const failed = [];
+    for (const segment of segments) {
+        const parsed = parsePhrase(segment);
+        if (parsed) {
+            actions.push(parsed);
+        }
+        else {
+            failed.push(segment);
+        }
+    }
+    if (actions.length === 0) {
+        return {
+            success: false,
+            actions: [],
+            error: `Could not parse instruction: "${instruction}"`,
+            suggestion: 'Try breaking the instruction into individual steps such as "click X", "type Y in Z", or "navigate to URL".',
+        };
+    }
+    if (failed.length > 0) {
+        // Partial parse — return what we have but still signal success for the parseable parts
+        return {
+            success: true,
+            actions,
+            suggestion: `Could not parse the following segment(s): ${failed.map(f => `"${f}"`).join(', ')}. Try breaking these into individual tool calls.`,
+        };
+    }
+    return { success: true, actions };
+}
+//# sourceMappingURL=action-parser.js.map

package/dist/actions/action-parser.js.map

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

package/dist/actions/action-templates.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Action Templates - Pre-compiled action sequences for common browser workflows.
+ *
+ * When the user's instruction matches a template, the cached sequence is used
+ * instead of NL parsing. This is faster and more reliable for known patterns.
+ */
+import { ParsedAction } from './action-parser';
+export interface ActionTemplate {
+    id: string;
+    name: string;
+    description: string;
+    /** Regex pattern to match the instruction. Named groups become template variables. */
+    pattern: RegExp;
+    /** Function that returns the action sequence, using captured groups as variables. */
+    build: (vars: Record<string, string>) => ParsedAction[];
+}
+/**
+ * Built-in action templates for common workflows.
+ */
+export declare const ACTION_TEMPLATES: ActionTemplate[];
+/**
+ * Try to match instruction against known templates.
+ * Returns the action sequence if matched, null otherwise.
+ */
+export declare function matchTemplate(instruction: string): {
+    template: ActionTemplate;
+    actions: ParsedAction[];
+} | null;
+//# sourceMappingURL=action-templates.d.ts.map

package/dist/actions/action-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-templates.d.ts","sourceRoot":"","sources":["../../src/actions/action-templates.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,YAAY,EAAE,CAAC;CACzD;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAwF5C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CAAE,GAAG,IAAI,CAmB/G"}

package/dist/actions/action-templates.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Action Templates - Pre-compiled action sequences for common browser workflows.
+ *
+ * When the user's instruction matches a template, the cached sequence is used
+ * instead of NL parsing. This is faster and more reliable for known patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACTION_TEMPLATES = void 0;
+exports.matchTemplate = matchTemplate;
+const action_parser_1 = require("./action-parser");
+/**
+ * Built-in action templates for common workflows.
+ */
+exports.ACTION_TEMPLATES = [
+    // Login template
+    {
+        id: 'login',
+        name: 'Login',
+        description: 'Log in with email/username and password',
+        pattern: /^(?:log\s*in|sign\s*in)\s+(?:with\s+)?(?<email>[^\s]+)\s+(?:and\s+)?(?<password>.+)$/i,
+        build: (vars) => [
+            { action: 'type', target: 'email', value: vars.email },
+            { action: 'type', target: 'password', value: vars.password },
+            { action: 'click', target: 'login button' },
+        ],
+    },
+    // Korean login
+    {
+        id: 'login-kr',
+        name: 'Login (Korean)',
+        description: '로그인',
+        pattern: /^(?<email>[^\s]+)(?:와|과|하고)\s*(?<password>.+?)(?:로|으로)\s*(?:로그인|로그 인|사인 인)$/,
+        build: (vars) => [
+            { action: 'type', target: 'email', value: vars.email },
+            { action: 'type', target: 'password', value: vars.password },
+            { action: 'click', target: '로그인 버튼' },
+        ],
+    },
+    // Search template
+    {
+        id: 'search',
+        name: 'Search',
+        description: 'Search for a query',
+        pattern: /^search\s+(?:for\s+)?(?<query>.+?)(?:\s+in\s+(?:the\s+)?(?<target>.+?))?$/i,
+        build: (vars) => {
+            const steps = [];
+            if (vars.target) {
+                steps.push({ action: 'type', target: vars.target, value: vars.query });
+            }
+            else {
+                steps.push({ action: 'type', target: 'search', value: vars.query });
+            }
+            steps.push({ action: 'click', target: 'search button' });
+            return steps;
+        },
+    },
+    // Korean search
+    {
+        id: 'search-kr',
+        name: 'Search (Korean)',
+        description: '검색',
+        pattern: /^(?<query>.+?)(?:을|를)?\s*검색$/,
+        build: (vars) => [
+            { action: 'type', target: 'search', value: vars.query },
+            { action: 'click', target: '검색 버튼' },
+        ],
+    },
+    // Form fill template
+    {
+        id: 'fill-form',
+        name: 'Fill Form',
+        description: 'Fill form fields with key-value pairs',
+        pattern: /^fill\s+(?:out\s+)?(?:the\s+)?(?:(?<formName>.+?)\s+)?(?:form\s+)?with\s+(?<pairs>.+)$/i,
+        build: (vars) => {
+            const actions = [];
+            // Parse comma-separated key=value or "key value" pairs
+            const pairs = vars.pairs.split(/,\s*/);
+            for (const pair of pairs) {
+                const kv = pair.match(/^(.+?)\s+(.+)$/) || pair.match(/^(.+?)=(.+)$/);
+                if (kv) {
+                    actions.push({ action: 'type', target: kv[1].trim(), value: kv[2].trim() });
+                }
+            }
+            return actions;
+        },
+    },
+    // Navigate and do template
+    {
+        id: 'goto-and-do',
+        name: 'Navigate and Act',
+        description: 'Go to a URL and perform an action',
+        pattern: /^(?:go\s+to|navigate\s+to|open|visit)\s+(?<url>https?:\/\/\S+)\s+(?:and|then)\s+(?<action>.+)$/i,
+        build: (vars) => {
+            // The remaining action part will be parsed by the action parser
+            // For templates, we just handle the navigate part
+            const parsed = (0, action_parser_1.parseInstruction)(vars.action);
+            return [
+                { action: 'navigate', value: vars.url },
+                ...(parsed.success ? parsed.actions : []),
+            ];
+        },
+    },
+];
+/**
+ * Try to match instruction against known templates.
+ * Returns the action sequence if matched, null otherwise.
+ */
+function matchTemplate(instruction) {
+    const trimmed = instruction.trim();
+    for (const tpl of exports.ACTION_TEMPLATES) {
+        const match = trimmed.match(tpl.pattern);
+        if (match && match.groups) {
+            try {
+                const actions = tpl.build(match.groups);
+                if (actions.length > 0) {
+                    return { template: tpl, actions };
+                }
+            }
+            catch {
+                // Template build failed — try next template
+                continue;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=action-templates.js.map

package/dist/actions/action-templates.js.map

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