openchrome-mcp 1.9.6 → 1.10.0

package/README.md

@@ -409,6 +409,48 @@ Tier 3 launches a real headed Chrome window with a genuine user-agent (`Chrome/.
 
 ---
 
+## FAQ: Comparison with Other Browser MCPs
+
+Common questions from users evaluating OpenChrome against Chrome DevTools MCP, Firefox DevTools MCP, and similar tools (see [#612](https://github.com/shaun0927/openchrome/issues/612)).
+
+### Can multiple MCP clients share tabs safely?
+
+**Yes — tabs cannot clobber each other across clients.**
+
+OpenChrome identifies every tab by its CDP `targetId` — a stable, browser-assigned string — not by a visible 1/2/3 index. On top of stable IDs, two layers of isolation are specifically designed for multi-client scenarios:
+
+- **`workerId`** — logical tab groups per client or parallel lane. A new tab under one `workerId` is invisible to another and never replaces one.
+- **`profileDirectory`** — launches a fully separate Chrome instance bound to that profile, giving OS-level cookie / storage / extension isolation.
+
+If client A opens five tabs and client B opens five tabs, all ten `tabId`s are distinct and stable; a new tab from A can never displace B's tab #3.
+
+### How do I handle sites that require interactive login (password, 2FA, CAPTCHA)?
+
+Two mechanisms, used together in practice:
+
+**1. Persistent-profile headless — log in once, automate forever.**
+Point OpenChrome at a persistent `userDataDir` (+ optional `profileDirectory`) and cookies / `localStorage` / IndexedDB survive across runs. After the first login, subsequent **headless** runs stay logged in until the site invalidates the session.
+
+**2. Headed fallback for the initial login or WAF-blocked sites.**
+When a human action is genuinely required (first-time login, 2FA, CAPTCHA, WebAuthn) or when a Tier-1/Tier-2 headless attempt is blocked by a CDN/WAF, OpenChrome lazy-launches a separate headed Chrome on a different debug port. Cookies are sync'd from the real Chrome profile before launch, and the headed page is registered back into the same logical session so the surrounding workflow continues seamlessly.
+
+**Typical pattern:** bootstrap the login once via the headed path → the persistent profile carries the cookies → all subsequent automation runs headless without a window.
+
+### Does OpenChrome steal focus with popup windows?
+
+**No — the "recurring popup interruptions" problem does not occur in OpenChrome.**
+
+The headed-browser focus-stealing pattern that users encounter with some MCP servers (cross-Space jumps on macOS, un-minimizable popups, per-tool-call window raises) comes from designs where the MCP drives a user-visible browser and creates OS windows as it works. OpenChrome is architected differently:
+
+- **Default mode is headless** — no window exists, so there is nothing to take focus.
+- **`tabs_create` opens a tab, not an OS window.** New tabs are created via CDP inside the already-running Chrome, and OpenChrome never calls `page.bringToFront()` anywhere in the codebase.
+- **The headed fallback is lazy and reused.** When it is needed, it launches **once** per server lifetime; every later navigation/tab runs inside that same instance. At worst you see one focus grab the very first time the fallback activates — not one per action, never one per tab.
+- **The headed fallback is optional.** If persistent-profile headless is sufficient for your sites, you will never see a browser window.
+
+The only scenario in which a window appears at all is the first time the Tier-3 headed fallback activates in a given session.
+
+---
+
 ## Benchmarks
 
 Measure token efficiency and parallel performance:
@@ -514,6 +556,12 @@ openchrome serve \
 
 ---
 
+## Authentication
+
+OpenChrome supports per-tenant API keys, JWT/OAuth, a legacy shared token, and an unauthenticated mode. See **[docs/auth.md](docs/auth.md)** for the full guide including quickstart, scope table, key rotation, revocation, and troubleshooting.
+
+---
+
 ## Under the Hood: 8-Layer Reliability
 
 OpenChrome has **49 distinct reliability mechanisms** across 8 defense layers — ensuring no single failure can hang the MCP server.

package/config/audit-redaction.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "./audit-redaction.schema.json",
+  "description": "Per-tool redaction rules applied to audit log entries. Each rule identifies a sensitive field by a JSON-path-like key and describes how the value should be recorded: 'redact' replaces with [REDACTED], 'hash' stores sha256:<hex>, 'truncate' keeps the first N bytes and appends a hash of the full value.",
+  "defaultSensitiveFieldNames": [
+    "password",
+    "passwd",
+    "pwd",
+    "secret",
+    "token",
+    "authorization",
+    "auth",
+    "api_key",
+    "apikey",
+    "access_key",
+    "refresh_token",
+    "id_token",
+    "session_token",
+    "cookie",
+    "set-cookie",
+    "credit_card",
+    "ssn",
+    "private_key"
+  ],
+  "tools": {
+    "cookies": [
+      { "path": "value", "mode": "hash" }
+    ],
+    "cookies.set": [
+      { "path": "value", "mode": "hash" },
+      { "path": "cookies[*].value", "mode": "hash" }
+    ],
+    "fill_form": [
+      { "path": "fields[*].value", "mode": "redactIfSensitiveName" }
+    ],
+    "form_input": [
+      { "path": "value", "mode": "redact" }
+    ],
+    "type": [
+      { "path": "text", "mode": "truncate", "maxBytes": 200 }
+    ],
+    "javascript_tool": [
+      { "path": "code", "mode": "truncate", "maxBytes": 200 }
+    ],
+    "storage": [
+      { "path": "value", "mode": "truncate", "maxBytes": 200 }
+    ]
+  }
+}

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"}