@tangle-network/browser-agent-driver 0.33.3 → 0.34.0

package/dist/brain/snapshot-budget.js

@@ -0,0 +1,202 @@
+/**
+ * Snapshot budgeting: dedup repeated element runs, cap total size while
+ * preserving interactive + content lines, and compact the first-turn snapshot.
+ *
+ * Pure functions over snapshot text — no Brain state.
+ */
+import { AriaSnapshotHelper } from '../drivers/snapshot.js';
+/**
+ * Collapse consecutive runs of similar elements (same indent + role, names
+ * differing only by a trailing number/short suffix) into a single representative
+ * line with a count.  Reduces token cost on pages with long pagination, nav
+ * lists, or repeated product cards.
+ *
+ * Skips dialog/alertdialog (agent must see each one) and groups < 3 items.
+ */
+function deduplicateSnapshot(snapshot) {
+    const lines = snapshot.split('\n');
+    const out = [];
+    // Extract (indent, role) from a snapshot line. Returns null for non-element lines.
+    const parseLine = (line) => {
+        const m = line.match(/^(\s*-\s+)(\w+)\s+"([^"]*)"\s*\[ref=(\w+)\]/);
+        if (!m)
+            return null;
+        return { indent: m[1], role: m[2], name: m[3], ref: m[4], full: line };
+    };
+    // Strip trailing numbers/ordinals to get a "name stem" for grouping.
+    // "Page 1" and "Page 20" → "Page ", "Item #3" and "Item #42" → "Item #"
+    const nameStem = (name) => name.replace(/\d+/g, '#');
+    // Structural fingerprint for a block of lines (element + its children).
+    // Used for card-level dedup: two hotel cards have different names but the
+    // same structure (listitem > link + img + text + text + button).
+    const structuralFingerprint = (startIdx, baseIndent) => {
+        const roles = [];
+        let j = startIdx;
+        while (j < lines.length) {
+            const p = parseLine(lines[j]);
+            if (!p) {
+                j++;
+                continue;
+            }
+            // Stop when we hit an element at the same or shallower indent (sibling or parent)
+            if (j > startIdx && p.indent.length <= baseIndent.length)
+                break;
+            roles.push(p.role);
+            j++;
+        }
+        return { fp: roles.join(','), endIdx: j };
+    };
+    let i = 0;
+    while (i < lines.length) {
+        const parsed = parseLine(lines[i]);
+        // Non-element line or dialog/alertdialog — emit as-is
+        if (!parsed || /\b(?:dialog|alertdialog)\b/i.test(parsed.role)) {
+            out.push(lines[i]);
+            i++;
+            continue;
+        }
+        // Try block-level dedup first: look for consecutive sibling blocks
+        // with the same structural fingerprint (same child-role sequence).
+        // This catches card patterns like Booking hotel results, Allrecipes cards.
+        if (/\b(?:listitem|article|group|region)\b/i.test(parsed.role)) {
+            const { fp: firstFp, endIdx: firstEnd } = structuralFingerprint(i, parsed.indent);
+            if (firstEnd > i + 2 && firstFp.includes(',')) { // non-trivial block
+                const blocks = [
+                    { start: i, end: firstEnd, firstLine: lines[i] },
+                ];
+                let scanIdx = firstEnd;
+                while (scanIdx < lines.length) {
+                    const nextParsed = parseLine(lines[scanIdx]);
+                    if (!nextParsed || nextParsed.indent !== parsed.indent || nextParsed.role !== parsed.role)
+                        break;
+                    const { fp: nextFp, endIdx: nextEnd } = structuralFingerprint(scanIdx, nextParsed.indent);
+                    if (nextFp !== firstFp)
+                        break;
+                    blocks.push({ start: scanIdx, end: nextEnd, firstLine: lines[scanIdx] });
+                    scanIdx = nextEnd;
+                }
+                if (blocks.length >= 3) {
+                    // Emit first 2 blocks fully, summarize the rest
+                    for (let b = 0; b < Math.min(2, blocks.length); b++) {
+                        for (let k = blocks[b].start; k < blocks[b].end; k++) {
+                            out.push(lines[k]);
+                        }
+                    }
+                    const remaining = blocks.length - 2;
+                    out.push(`${parsed.indent}... [${remaining} more similar ${parsed.role} blocks with same structure]`);
+                    i = blocks[blocks.length - 1].end;
+                    continue;
+                }
+            }
+        }
+        // Line-level dedup: consecutive runs of same (indent, role, name stem)
+        const group = [parsed];
+        const stem = nameStem(parsed.name);
+        let j = i + 1;
+        while (j < lines.length) {
+            const next = parseLine(lines[j]);
+            if (!next ||
+                next.indent !== parsed.indent ||
+                next.role !== parsed.role ||
+                nameStem(next.name) !== stem)
+                break;
+            group.push(next);
+            j++;
+        }
+        if (group.length < 3) {
+            // Not enough to dedup — emit originals
+            for (const g of group)
+                out.push(g.full);
+        }
+        else {
+            // Emit first element with a summary of the rest
+            const last = group[group.length - 1];
+            out.push(`${parsed.full} (+${group.length - 1} similar: "${group[1].name}"\u2026"${last.name}")`);
+        }
+        i = j;
+    }
+    return out.join('\n');
+}
+/**
+ * Cap snapshot size to control token cost on large pages.
+ * Keeps the full snapshot when it fits within budget; otherwise preserves:
+ *   1. Interactive elements with refs (buttons, inputs, links — for action targets)
+ *   2. Content lines: term/definition/code/pre/paragraph (for extraction tasks
+ *      like MDN, Python docs, W3C spec where the value the agent needs lives in
+ *      a `<dl>/<code>/<pre>` block, not in an interactive element)
+ *
+ * New-page callers use a larger default budget; same-page callers can pass a
+ * tighter budget after the model has already seen the full snapshot once.
+ */
+export function budgetSnapshot(snapshot, maxChars = 24_000) {
+    // Skip dedup on small snapshots — not enough repetition to justify the O(n) scan
+    if (snapshot.length > 6_000) {
+        snapshot = deduplicateSnapshot(snapshot);
+    }
+    if (snapshot.length <= maxChars)
+        return snapshot;
+    // First pass: separate keep-set (interactive + content lines) from decorative.
+    // Content roles (term, definition, code, pre, paragraph) carry text the LLM
+    // needs for extraction tasks. They have no [ref=] but the text is the data.
+    const lines = snapshot.split('\n');
+    const interactive = [];
+    const content = [];
+    const decorative = [];
+    for (const line of lines) {
+        if (/\b(?:button|link|textbox|combobox|menuitem|checkbox|radio|select|heading|dialog|alertdialog)\b/i.test(line) && /\[ref=/.test(line)) {
+            interactive.push(line);
+        }
+        else if (/^\s*-\s+(?:term|definition|code|pre|paragraph)\b/i.test(line)) {
+            content.push(line);
+        }
+        else {
+            decorative.push(line);
+        }
+    }
+    // If interactive + content fits, use both with a truncation note
+    const keepSet = interactive.concat(content);
+    const keepText = keepSet.join('\n');
+    if (keepText.length <= maxChars) {
+        return keepText + `\n... [${decorative.length} decorative elements omitted for brevity]`;
+    }
+    // Second pass: when interactive + content still exceed budget, prioritize:
+    // 1. inputs (searchbox/textbox/combobox) — essential for form tasks
+    // 2. headings + dialogs — structural navigation
+    // 3. content lines (term/definition/code/pre) — extraction data
+    // 4. bulk links/buttons — main content
+    const priority = [];
+    const bulk = [];
+    for (const line of interactive) {
+        if (/\b(?:searchbox|textbox|combobox|heading|dialog|alertdialog)\b/i.test(line)) {
+            priority.push(line);
+        }
+        else {
+            bulk.push(line);
+        }
+    }
+    // Content lines come right after priority interactive (they're the extraction
+    // data) and before bulk links/buttons.
+    const priorityWithContent = priority.concat(content);
+    const priorityText = priorityWithContent.join('\n');
+    const remaining = maxChars - priorityText.length - 80; // reserve space for note
+    if (remaining > 0) {
+        const bulkText = bulk.join('\n');
+        const trimmedBulk = bulkText.slice(0, remaining);
+        const bulkKept = trimmedBulk.lastIndexOf('\n') > 0
+            ? trimmedBulk.slice(0, trimmedBulk.lastIndexOf('\n'))
+            : trimmedBulk;
+        return priorityText + '\n' + bulkKept +
+            `\n... [${interactive.length - priority.length - bulkKept.split('\n').length} interactive + ${decorative.length} decorative elements omitted]`;
+    }
+    // Hard cap: take the first maxChars of the full snapshot
+    return snapshot.slice(0, maxChars) + '\n... [snapshot truncated — large page]';
+}
+export function compactFirstTurnSnapshot(snapshot) {
+    const compact = AriaSnapshotHelper.formatCompact(snapshot);
+    const basis = compact.length > 0 ? compact : snapshot;
+    const maxChars = 4000;
+    if (basis.length <= maxChars)
+        return basis;
+    return `${basis.slice(0, maxChars)}\n... [snapshot truncated for first-turn fast path]`;
+}
+//# sourceMappingURL=snapshot-budget.js.map

package/dist/brain/snapshot-budget.js.map

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

package/dist/brain/system-prompt.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Dynamic system-prompt assembly for the Brain decision engine: conditional
+ * rule-group injection (search / data-extraction / heavy-page), user + domain
+ * + macro rule appends, and the Anthropic cache_control split used by
+ * `decide()`.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * `buildSystemForDecide` keeps a thin delegator on Brain; the other three
+ * helpers moved wholesale. Bodies are verbatim — same ordering, thresholds,
+ * and byte-stable cached-prefix placement. State is read through
+ * {@link BrainSystemPromptHost}, which Brain `implements`.
+ */
+import type { SystemModelMessage } from 'ai';
+import type { PageState } from '../types.js';
+/**
+ * The slice of Brain state the system-prompt assembly reads. Brain declares
+ * `implements BrainSystemPromptHost`, so tsc proves this surface is complete.
+ * All members are public on Brain by construction.
+ */
+export interface BrainSystemPromptHost {
+    systemPrompt: string;
+    extensionRules?: {
+        global?: string;
+        search?: string;
+        dataExtraction?: string;
+        heavy?: string;
+    };
+    extensionDomainRules?: Record<string, {
+        extraRules?: string;
+    }>;
+    macroPromptBlock: string;
+}
+/**
+ * Build the system prompt dynamically, injecting conditional rule groups
+ * based on goal text, page snapshot content, and turn number.
+ * Saves ~800 tokens per turn on simple navigation tasks.
+ */
+export declare function buildSystemPromptImpl(self: BrainSystemPromptHost, goal: string, state: PageState, turn: number): string;
+/**
+ * Same as buildSystemPrompt but returns the parts so the caller can decide
+ * how to send them. For Anthropic, decide() ships them as a SystemModelMessage[]
+ * with cache_control on the stable CORE_RULES prefix; other providers join.
+ *
+ * The first slot is ALWAYS CORE_RULES (or the user's custom override) so the
+ * cache breakpoint placement is deterministic. Extension-supplied rules are
+ * appended AFTER REASONING_SUFFIX so the cached prefix stays byte-stable
+ * across turns.
+ */
+export declare function composeSystemPromptPartsImpl(self: BrainSystemPromptHost, goal: string, state: PageState, turn: number): string[];
+/**
+ * Find the per-domain extra rules whose domain key matches the URL host.
+ * Multiple matches are concatenated in registration order.
+ */
+export declare function matchDomainRulesImpl(self: BrainSystemPromptHost, url: string): string | undefined;
+/**
+ * Build the system prompt for `decide()` in the form best suited to the
+ * active provider:
+ *   - Anthropic: a SystemModelMessage[] with `cache_control: ephemeral`
+ *     on the CORE_RULES slot. Subsequent turns get a cache hit on the
+ *     ~1500-token prefix (90% cheaper input + faster TTFT).
+ *   - Everything else: a single concatenated string (current behavior).
+ *
+ * Custom system prompts (set via config) are passed verbatim — caching
+ * is opt-in via the default prompt path only.
+ */
+export declare function buildSystemForDecideImpl(self: BrainSystemPromptHost, goal: string, state: PageState, turn: number, providerName: 'openai' | 'anthropic' | 'google' | 'cli-bridge' | 'codex-cli' | 'claude-code' | 'sandbox-backend' | 'zai-coding-plan'): string | SystemModelMessage[];
+//# sourceMappingURL=system-prompt.d.ts.map

package/dist/brain/system-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../src/brain/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAY7C;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/F,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvH;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA0ChI;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAejG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,qBAAqB,EAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,GACnI,MAAM,GAAG,kBAAkB,EAAE,CAmB/B"}

package/dist/brain/system-prompt.js

@@ -0,0 +1,128 @@
+/**
+ * Dynamic system-prompt assembly for the Brain decision engine: conditional
+ * rule-group injection (search / data-extraction / heavy-page), user + domain
+ * + macro rule appends, and the Anthropic cache_control split used by
+ * `decide()`.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * `buildSystemForDecide` keeps a thin delegator on Brain; the other three
+ * helpers moved wholesale. Bodies are verbatim — same ordering, thresholds,
+ * and byte-stable cached-prefix placement. State is read through
+ * {@link BrainSystemPromptHost}, which Brain `implements`.
+ */
+import { CORE_RULES, SEARCH_RULES, DATA_EXTRACTION_RULES, HEAVY_PAGE_RULES, REASONING_SUFFIX, SYSTEM_PROMPT, DATA_EXTRACTION_PATTERN, SEARCH_SNAPSHOT_PATTERN, } from './prompts.js';
+/**
+ * Build the system prompt dynamically, injecting conditional rule groups
+ * based on goal text, page snapshot content, and turn number.
+ * Saves ~800 tokens per turn on simple navigation tasks.
+ */
+export function buildSystemPromptImpl(self, goal, state, turn) {
+    return composeSystemPromptPartsImpl(self, goal, state, turn).join('');
+}
+/**
+ * Same as buildSystemPrompt but returns the parts so the caller can decide
+ * how to send them. For Anthropic, decide() ships them as a SystemModelMessage[]
+ * with cache_control on the stable CORE_RULES prefix; other providers join.
+ *
+ * The first slot is ALWAYS CORE_RULES (or the user's custom override) so the
+ * cache breakpoint placement is deterministic. Extension-supplied rules are
+ * appended AFTER REASONING_SUFFIX so the cached prefix stays byte-stable
+ * across turns.
+ */
+export function composeSystemPromptPartsImpl(self, goal, state, turn) {
+    if (self.systemPrompt !== SYSTEM_PROMPT)
+        return [self.systemPrompt];
+    const parts = [CORE_RULES];
+    const snapshotSample = state.snapshot.length > 4000 ? state.snapshot.slice(0, 4000) : state.snapshot;
+    if (SEARCH_SNAPSHOT_PATTERN.test(snapshotSample) || /\/search\b/i.test(state.url)) {
+        parts.push(SEARCH_RULES);
+        if (self.extensionRules?.search) {
+            parts.push(`\n\nUSER RULES (search):\n${self.extensionRules.search}`);
+        }
+    }
+    if (DATA_EXTRACTION_PATTERN.test(goal)) {
+        parts.push(DATA_EXTRACTION_RULES);
+        if (self.extensionRules?.dataExtraction) {
+            parts.push(`\n\nUSER RULES (data extraction):\n${self.extensionRules.dataExtraction}`);
+        }
+    }
+    if (state.snapshot.length > 10_000 || turn > 10) {
+        parts.push(HEAVY_PAGE_RULES);
+        if (self.extensionRules?.heavy) {
+            parts.push(`\n\nUSER RULES (heavy page):\n${self.extensionRules.heavy}`);
+        }
+    }
+    parts.push(REASONING_SUFFIX);
+    // Global user rules + matching per-domain rules. Both are appended AFTER
+    // REASONING_SUFFIX so they don't pollute the byte-stable cached prefix.
+    if (self.extensionRules?.global) {
+        parts.push(`\n\nUSER RULES (global):\n${self.extensionRules.global}`);
+    }
+    if (self.extensionDomainRules) {
+        const domainRules = matchDomainRulesImpl(self, state.url);
+        if (domainRules) {
+            parts.push(`\n\nUSER RULES (domain match):\n${domainRules}`);
+        }
+    }
+    // Macros live AFTER the cached prefix so registering new macros
+    // doesn't bust the Anthropic cache.
+    if (self.macroPromptBlock) {
+        parts.push(`\n\n${self.macroPromptBlock}`);
+    }
+    return parts;
+}
+/**
+ * Find the per-domain extra rules whose domain key matches the URL host.
+ * Multiple matches are concatenated in registration order.
+ */
+export function matchDomainRulesImpl(self, url) {
+    if (!self.extensionDomainRules)
+        return undefined;
+    let host;
+    try {
+        host = new URL(url).hostname;
+    }
+    catch {
+        return undefined;
+    }
+    const matches = [];
+    for (const [domain, rules] of Object.entries(self.extensionDomainRules)) {
+        if (host.includes(domain) && rules.extraRules) {
+            matches.push(rules.extraRules);
+        }
+    }
+    return matches.length > 0 ? matches.join('\n\n') : undefined;
+}
+/**
+ * Build the system prompt for `decide()` in the form best suited to the
+ * active provider:
+ *   - Anthropic: a SystemModelMessage[] with `cache_control: ephemeral`
+ *     on the CORE_RULES slot. Subsequent turns get a cache hit on the
+ *     ~1500-token prefix (90% cheaper input + faster TTFT).
+ *   - Everything else: a single concatenated string (current behavior).
+ *
+ * Custom system prompts (set via config) are passed verbatim — caching
+ * is opt-in via the default prompt path only.
+ */
+export function buildSystemForDecideImpl(self, goal, state, turn, providerName) {
+    const parts = composeSystemPromptPartsImpl(self, goal, state, turn);
+    if (providerName !== 'anthropic' || self.systemPrompt !== SYSTEM_PROMPT || parts.length === 0) {
+        return parts.join('');
+    }
+    // Anthropic path: first slot is CORE_RULES (cached), remaining parts ship
+    // as a separate uncached system message so the prefix stays byte-stable
+    // across turns and the cache hits.
+    const corePart = {
+        role: 'system',
+        content: parts[0],
+        providerOptions: {
+            anthropic: {
+                cacheControl: { type: 'ephemeral' },
+            },
+        },
+    };
+    if (parts.length === 1)
+        return [corePart];
+    return [corePart, { role: 'system', content: parts.slice(1).join('') }];
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/brain/system-prompt.js.map

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

package/dist/brain/tasks/design-audit.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Design-audit task for the Brain decision engine: uses vision to analyze
+ * layout, typography, spacing, contrast, and UX, returning structured findings
+ * with categories, severities, and optional ROI / patch passthrough.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.auditDesign keeps a thin delegator; the body lives here verbatim and
+ * reads Brain state through {@link BrainDesignAuditHost}, which Brain
+ * `implements` so tsc proves the host surface is complete.
+ */
+import type { ModelMessage, SystemModelMessage } from 'ai';
+import type { PageState, DesignFinding } from '../../types.js';
+import type { UserContent } from '../types.js';
+import type { ModelSelection, GenerateResult } from '../model-client.js';
+/**
+ * The slice of Brain state `auditDesign` reads. All members are public on Brain
+ * by construction; `implements BrainDesignAuditHost` makes a missing/mistyped
+ * member a compile error.
+ */
+export interface BrainDesignAuditHost {
+    debug: boolean;
+    buildUserContent(text: string, screenshot?: string, forceVision?: boolean): UserContent;
+    generate(system: string | SystemModelMessage[], messages: ModelMessage[], selection?: ModelSelection, maxOutputTokens?: number): Promise<GenerateResult>;
+}
+export declare function auditDesignImpl(self: BrainDesignAuditHost, state: PageState, goal: string, checkpoints: string[], systemPrompt?: string): Promise<{
+    score: number;
+    findings: DesignFinding[];
+    raw: string;
+    tokensUsed?: number;
+    designSystemScore?: Record<string, unknown>;
+    parseError?: string;
+}>;
+//# sourceMappingURL=design-audit.d.ts.map

package/dist/brain/tasks/design-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-audit.d.ts","sourceRoot":"","sources":["../../../src/brain/tasks/design-audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IACxF,QAAQ,CACN,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,EACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,CAAC,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,oBAAoB,EAC1B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoG3J"}

package/dist/brain/tasks/design-audit.js

@@ -0,0 +1,100 @@
+/**
+ * Design-audit task for the Brain decision engine: uses vision to analyze
+ * layout, typography, spacing, contrast, and UX, returning structured findings
+ * with categories, severities, and optional ROI / patch passthrough.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.auditDesign keeps a thin delegator; the body lives here verbatim and
+ * reads Brain state through {@link BrainDesignAuditHost}, which Brain
+ * `implements` so tsc proves the host surface is complete.
+ */
+import { DESIGN_AUDIT_PROMPT } from '../prompts.js';
+export async function auditDesignImpl(self, state, goal, checkpoints, systemPrompt) {
+    const textContent = `GOAL: ${goal}
+
+CHECKPOINTS to verify:
+${checkpoints.map((c, i) => `${i + 1}. ${c}`).join('\n')}
+
+CURRENT PAGE:
+URL: ${state.url}
+Title: ${state.title}
+
+ELEMENTS:
+${state.snapshot}
+
+Audit this page for design quality, UX issues, and visual bugs.`;
+    const userContent = self.buildUserContent(textContent, state.screenshot, true);
+    const result = await self.generate(systemPrompt ?? DESIGN_AUDIT_PROMPT, [{ role: 'user', content: userContent }], undefined, 8000);
+    const raw = result.text;
+    const tokensUsed = result.tokensUsed;
+    if (self.debug) {
+        console.log('[Brain] Design audit:', raw.slice(0, 300));
+    }
+    try {
+        let text = raw.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        // Extract JSON object if surrounded by non-JSON text or truncated
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            const start = text.indexOf('{');
+            const end = text.lastIndexOf('}');
+            if (start >= 0 && end > start) {
+                parsed = JSON.parse(text.slice(start, end + 1));
+            }
+            else {
+                throw new Error('No JSON object found');
+            }
+        }
+        const VALID_CATEGORIES = new Set(['visual-bug', 'layout', 'contrast', 'alignment', 'spacing', 'typography', 'accessibility', 'ux']);
+        const VALID_SEVERITIES = new Set(['critical', 'major', 'minor']);
+        const VALID_BLAST = new Set(['page', 'section', 'component', 'system']);
+        const clampScore = (n) => typeof n === 'number' ? Math.max(1, Math.min(10, n)) : undefined;
+        const findings = Array.isArray(parsed.findings)
+            ? parsed.findings.map((f) => ({
+                category: (VALID_CATEGORIES.has(f.category) ? f.category : 'ux'),
+                severity: (VALID_SEVERITIES.has(f.severity) ? f.severity : 'minor'),
+                description: String(f.description ?? ''),
+                location: String(f.location ?? ''),
+                suggestion: String(f.suggestion ?? ''),
+                ...(f.cssSelector ? { cssSelector: String(f.cssSelector) } : {}),
+                ...(f.cssFix ? { cssFix: String(f.cssFix) } : {}),
+                // Optional ROI fields.
+                ...(clampScore(f.impact) !== undefined ? { impact: clampScore(f.impact) } : {}),
+                ...(clampScore(f.effort) !== undefined ? { effort: clampScore(f.effort) } : {}),
+                ...(VALID_BLAST.has(f.blast)
+                    ? { blast: f.blast }
+                    : {}),
+                // Layer 2 — preserve raw patches array (untyped passthrough). The
+                // parsePatches/validatePatch pipeline in build-result.ts converts
+                // these into typed, validated Patch objects.
+                ...(Array.isArray(f.patches) ? { rawPatches: f.patches } : {}),
+            }))
+            : [];
+        const designSystemScore = parsed.designSystemScore && typeof parsed.designSystemScore === 'object'
+            ? parsed.designSystemScore
+            : undefined;
+        const rawScore = typeof parsed.score === 'number' ? parsed.score : 5;
+        return {
+            score: Math.max(1, Math.min(10, rawScore)),
+            findings,
+            raw,
+            tokensUsed,
+            designSystemScore,
+        };
+    }
+    catch (err) {
+        return {
+            score: 5,
+            findings: [],
+            raw,
+            tokensUsed,
+            parseError: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=design-audit.js.map

package/dist/brain/tasks/design-audit.js.map

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

package/dist/brain/tasks/evaluate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Quality-evaluation task for the Brain decision engine: asks the LLM to rate
+ * the visual quality, design, and professional polish of the current page.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.evaluate keeps a thin delegator; the body lives here verbatim and reads
+ * Brain state through {@link BrainEvaluateHost}, which Brain `implements` so tsc
+ * proves the host surface is complete.
+ */
+import type { ModelMessage, SystemModelMessage } from 'ai';
+import type { PageState } from '../../types.js';
+import type { QualityEvaluation, UserContent } from '../types.js';
+import type { ModelSelection, GenerateResult } from '../model-client.js';
+/**
+ * The slice of Brain state `evaluate` reads. All members are public on Brain by
+ * construction; `implements BrainEvaluateHost` makes a missing/mistyped member a
+ * compile error.
+ */
+export interface BrainEvaluateHost {
+    debug: boolean;
+    buildUserContent(text: string, screenshot?: string, forceVision?: boolean): UserContent;
+    generate(system: string | SystemModelMessage[], messages: ModelMessage[], selection?: ModelSelection, maxOutputTokens?: number): Promise<GenerateResult>;
+}
+export declare function evaluateImpl(self: BrainEvaluateHost, state: PageState, goal: string): Promise<QualityEvaluation>;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/brain/tasks/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../src/brain/tasks/evaluate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IACxF,QAAQ,CACN,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,EACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,CAAC,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoDtH"}