@tangle-network/browser-agent-driver 0.12.1 → 0.13.0

package/dist/design/audit/evaluate.js

@@ -0,0 +1,353 @@
+/**
+ * Evaluator — composes classification + rubric + measurements + LLM vision
+ * into structured findings.
+ *
+ * Architecture:
+ *   1. Classifier output drives which rubric fragments apply.
+ *   2. Deterministic measurements (contrast, axe) become "ground-truth" findings
+ *      injected directly into the result. The LLM is not asked to invent these.
+ *   3. The LLM's job is purely subjective: visual quality, hierarchy, polish,
+ *      design system coherence. It sees the screenshot, the composed rubric,
+ *      and a summary of the deterministic findings as context.
+ *
+ * This split is the whole point of Gen 2: stop asking the LLM to estimate
+ * things that are computable.
+ */
+import { impactToSeverity } from './measure/index.js';
+import { annotateRoi } from './roi.js';
+/**
+ * Build the LLM prompt for visual evaluation. Includes:
+ *   - The composed rubric (only fragments matching the classification)
+ *   - A summary of the deterministic measurements (so the LLM knows what's
+ *     already been counted and doesn't double-count)
+ *   - Strict instructions: no estimating contrast, no inventing a11y findings
+ */
+const UNIVERSAL_DIMENSIONS = [
+    'layout',
+    'typography',
+    'color',
+    'spacing',
+    'components',
+    'interactions',
+    'accessibility',
+    'polish',
+];
+function buildEvalPrompt(input) {
+    const { classification, rubric, measurements } = input;
+    const measurementSummary = [
+        `CONTRAST (already measured by deterministic math, do not re-evaluate):`,
+        `  - ${measurements.contrast.totalChecked} text elements checked`,
+        `  - ${measurements.contrast.aaFailures.length} fail WCAG AA`,
+        `  - ${measurements.contrast.aaaFailures.length} fail WCAG AAA`,
+        measurements.contrast.aaFailures.length > 0
+            ? `  - Top failures: ${measurements.contrast.aaFailures
+                .slice(0, 3)
+                .map(f => `${f.color} on ${f.background} (${f.ratio}:1)`)
+                .join(', ')}`
+            : '',
+        '',
+        `ACCESSIBILITY (already measured by axe-core, do not re-evaluate):`,
+        `  - axe ran: ${measurements.a11y.ran}`,
+        `  - ${measurements.a11y.violations.length} WCAG violations found`,
+        measurements.a11y.violations.length > 0
+            ? `  - Top issues: ${measurements.a11y.violations
+                .slice(0, 5)
+                .map(v => `${v.id} (${v.impact})`)
+                .join(', ')}`
+            : '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+    // Compose the full dimension list (universal + custom from rubric fragments)
+    const allDimensions = [...UNIVERSAL_DIMENSIONS, ...rubric.dimensions];
+    const dimensionExample = allDimensions
+        .map(d => `    "${d}": ${Math.floor(Math.random() * 4) + 5}`)
+        .join(',\n');
+    return `You are a principal design engineer who has shipped design systems at Linear, Stripe, and Vercel. You review with the precision of a typographer and the ruthlessness of a design director.
+
+You are evaluating a page that has been pre-classified and pre-measured. Your job is the SUBJECTIVE layer only: visual quality, hierarchy, polish, design system coherence. You must NOT invent contrast or accessibility findings — those have already been measured deterministically and will be merged with your output.
+
+PAGE CLASSIFICATION:
+- Type: ${classification.type}
+- Domain: ${classification.domain}
+- Framework: ${classification.framework ?? 'unknown'}
+- Design system: ${classification.designSystem}
+- Maturity: ${classification.maturity}
+- Intent: ${classification.intent}
+- Classifier confidence: ${classification.confidence}
+
+DETERMINISTIC MEASUREMENTS:
+${measurementSummary}
+
+EVALUATION RUBRIC (composed from fragments matching this page):
+
+${rubric.body}
+
+YOUR JOB:
+1. Score this page 1-10 against the rubric above. Use the calibration anchors strictly.
+2. Produce findings ONLY for things you can SEE in the screenshot — visual hierarchy, typography choices, spacing rhythm, component coherence, polish details.
+3. Do NOT produce contrast findings — they've been measured.
+4. Do NOT produce accessibility findings — axe has been run.
+5. Be specific. Reference exact elements, measured spacing, typography choices.
+6. For each finding include a concrete CSS fix in the cssFix field.
+7. For each finding ALSO include impact, effort, and blast — these drive the ROI ranking.
+
+ROI FIELDS — score each finding on:
+- impact (1-10): how much this hurts the user. 1 = nitpick, 10 = breaks the experience.
+- effort (1-10): how hard the fix is. 1 = single CSS line, 5 = a few component edits, 10 = redesign.
+- blast: scope of the fix's effect.
+    "page" = only this page benefits
+    "section" = a region of this page (hero, footer)
+    "component" = a shared component (Card, Button) — multiple pages benefit
+    "system" = a design token or global style — every page benefits
+
+A high-blast / low-effort fix has massive ROI. Use this scale honestly — the user will fix the top-ROI items first.
+
+RESPOND WITH ONLY a JSON object:
+{
+  "score": 7,
+  "summary": "One-sentence assessment of the design system's coherence and the page's effectiveness for its classified intent",
+  "strengths": [
+    "Specific evidence-based strength",
+    "Another measured strength"
+  ],
+  "findings": [
+    {
+      "category": "spacing",
+      "severity": "major",
+      "description": "Hero section has 64px top padding but only 16px bottom — inconsistent vertical rhythm breaks the 8px grid",
+      "location": "Hero section → features grid transition",
+      "suggestion": "Use 48px or 64px consistently for all major section transitions",
+      "cssSelector": "main > section:first-child",
+      "cssFix": "padding-bottom: 48px",
+      "impact": 6,
+      "effort": 1,
+      "blast": "page"
+    }
+  ],
+  "designSystemScore": {
+${dimensionExample}
+  }
+}
+
+Categories: visual-bug, layout, alignment, spacing, typography, ux
+(Do NOT use 'contrast' or 'accessibility' — those come from measurements.)
+Severities: critical, major, minor
+Score: 1-10. Most production apps score 5-7.
+
+DIMENSIONS — score each of these on a 1-10 scale in designSystemScore:
+${allDimensions.map(d => `- ${d}`).join('\n')}`;
+}
+/**
+ * Convert deterministic measurements into findings.
+ *
+ * Both contrast and a11y measurements are GROUPED before becoming findings:
+ *   - Contrast: grouped by (color, background) pair → one finding per token
+ *     mismatch, with affected element count. A site with 47 elements using
+ *     the same failing gray gets ONE finding ("change --color-text-muted"),
+ *     not 47 spammy entries.
+ *   - axe: grouped by rule id → one finding per rule, with N affected nodes.
+ *
+ * Grouping has two big effects:
+ *   1. Top Fixes by ROI surfaces real systemic issues, not 5 copies of the same one.
+ *   2. blast scales with how many elements are affected — a contrast pair on
+ *      47 elements is `system`; a one-off is `page`.
+ */
+export function measurementsToFindings(measurements) {
+    const findings = [];
+    // ── Contrast: group by (normalizedColor|normalizedBackground) ──
+    const contrastGroups = new Map();
+    for (const f of measurements.contrast.aaFailures) {
+        const key = `${f.color}|${f.background}`;
+        const existing = contrastGroups.get(key);
+        if (existing) {
+            existing.selectors.push(f.selector);
+            // Track the worst (lowest) ratio in the group
+            if (f.ratio < existing.ratio)
+                existing.ratio = f.ratio;
+            if (f.ratio < f.required - 1.5)
+                existing.isCritical = true;
+        }
+        else {
+            contrastGroups.set(key, {
+                color: f.color,
+                background: f.background,
+                ratio: f.ratio,
+                required: f.required,
+                selectors: [f.selector],
+                sampleText: f.text,
+                isCritical: f.ratio < f.required - 1.5,
+            });
+        }
+    }
+    // Convert each group to a single finding. Cap to top 10 groups by element count.
+    const sortedGroups = [...contrastGroups.values()].sort((a, b) => b.selectors.length - a.selectors.length);
+    for (const g of sortedGroups.slice(0, 10)) {
+        const count = g.selectors.length;
+        const target = g.required.toFixed(1);
+        // Blast scales with how many elements use this color pair
+        const blast = count >= 5 ? 'system' : count >= 2 ? 'component' : 'page';
+        findings.push({
+            category: 'contrast',
+            severity: g.isCritical ? 'critical' : 'major',
+            description: count > 1
+                ? `Text color ${g.color} on background ${g.background} fails WCAG AA on ${count} elements (worst ratio ${g.ratio}:1, need ${target}:1)`
+                : `Text color ${g.color} on background ${g.background} has contrast ratio ${g.ratio}:1, fails WCAG AA (need ${target}:1)`,
+            location: count > 1
+                ? `${count} elements (e.g. ${g.selectors[0]})`
+                : `${g.selectors[0]} — "${g.sampleText}"`,
+            suggestion: count > 1
+                ? `Change the shared color token. ${count} elements use this pairing — fix once, all benefit. Increase contrast to at least ${target}:1.`
+                : `Increase contrast to at least ${target}:1. Darken the text color or lighten the background.`,
+            cssSelector: g.selectors[0],
+            cssFix: `/* ${count} element${count !== 1 ? 's' : ''} affected: ${g.ratio}:1 → need ${target}:1 */`,
+            impact: g.isCritical ? 9 : 7,
+            effort: 1,
+            blast,
+        });
+    }
+    // ── Accessibility: group by axe rule id ──
+    // axe already returns one violation per rule (with multiple nodes), so the
+    // grouping is mostly about reframing the description to surface the count.
+    for (const v of measurements.a11y.violations.slice(0, 15)) {
+        const nodeCount = v.nodes.length;
+        const firstNode = v.nodes[0];
+        const blast = nodeCount >= 5 ? 'system' : nodeCount >= 2 ? 'component' : 'page';
+        findings.push({
+            category: 'accessibility',
+            severity: impactToSeverity(v.impact),
+            description: nodeCount > 1
+                ? `[axe: ${v.id}] ${v.description} (${nodeCount} affected elements)`
+                : `[axe: ${v.id}] ${v.description}`,
+            location: firstNode
+                ? nodeCount > 1
+                    ? `${nodeCount} elements (e.g. ${firstNode.selector})`
+                    : firstNode.selector
+                : 'page',
+            suggestion: nodeCount > 1
+                ? `${firstNode?.failureSummary ?? 'Fix all affected elements.'} ${nodeCount} elements affected — likely a shared component bug.`
+                : firstNode?.failureSummary || `See ${v.helpUrl}`,
+            ...(firstNode ? { cssSelector: firstNode.selector } : {}),
+            impact: v.impact === 'critical' ? 9 : v.impact === 'serious' ? 7 : v.impact === 'moderate' ? 5 : 3,
+            effort: 3,
+            blast,
+        });
+    }
+    return findings;
+}
+/**
+ * Run the full evaluation pipeline for one page.
+ *
+ * Returns a PageAuditResult with merged findings (deterministic + LLM visual).
+ */
+export async function evaluatePage(brain, input) {
+    // Run the LLM visual evaluation
+    const result = await brain.auditDesign(input.state, `Audit the visual design quality of this ${input.classification.type} page`, [], buildEvalPrompt(input));
+    // Parse summary/strengths/designSystemScore from raw LLM response
+    let summary = '';
+    let strengths = [];
+    let designSystemScore;
+    try {
+        let text = result.raw.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const start = text.indexOf('{');
+        const end = text.lastIndexOf('}');
+        if (start >= 0 && end > start) {
+            const parsed = JSON.parse(text.slice(start, end + 1));
+            summary = typeof parsed.summary === 'string' ? parsed.summary : '';
+            strengths = Array.isArray(parsed.strengths) ? parsed.strengths : [];
+            if (parsed.designSystemScore && typeof parsed.designSystemScore === 'object') {
+                designSystemScore = {};
+                for (const [k, v] of Object.entries(parsed.designSystemScore)) {
+                    if (typeof v === 'number')
+                        designSystemScore[k] = v;
+                }
+            }
+        }
+    }
+    catch {
+        // fall through with defaults
+    }
+    // Filter LLM findings to only the categories we expect from the visual layer
+    // (the LLM should not be producing contrast/accessibility findings, but be defensive)
+    const visualCategories = new Set([
+        'visual-bug',
+        'layout',
+        'alignment',
+        'spacing',
+        'typography',
+        'ux',
+    ]);
+    const visualFindings = result.findings.filter(f => visualCategories.has(f.category));
+    // Merge: deterministic measurements first (they're ground truth), then visual
+    const measurementFindings = measurementsToFindings(input.measurements);
+    const mergedFindings = [...measurementFindings, ...visualFindings];
+    // Annotate every finding with its computed ROI score so downstream sorting works.
+    // Visual findings have impact/effort/blast from the LLM; measurement findings
+    // get derived defaults below.
+    annotateRoi(mergedFindings);
+    // Override the accessibility dimension in the design system score with
+    // measurement-driven truth. The overall score still reflects visual quality
+    // (the LLM's job) — but the a11y dimension is no longer LLM-estimated.
+    if (designSystemScore) {
+        designSystemScore.accessibility = computeAccessibilityScore(input.measurements);
+    }
+    // Only hard-cap the overall score in catastrophic cases (broken contrast on
+    // most text). Otherwise trust the LLM's visual judgment and let the
+    // accessibility dimension carry the measurement story.
+    let finalScore = result.score;
+    const contrastFailRate = 1 - input.measurements.contrast.summary.aaPassRate;
+    const trueCriticalA11y = input.measurements.a11y.violations.filter(v => v.impact === 'critical').length;
+    if (contrastFailRate > 0.5 && trueCriticalA11y >= 3) {
+        finalScore = Math.min(finalScore, 6);
+    }
+    return {
+        url: input.url,
+        score: finalScore,
+        summary,
+        strengths,
+        findings: mergedFindings,
+        classification: input.classification,
+        rubricFragments: input.rubric.fragments.map(f => f.id),
+        measurements: input.measurements,
+        designSystemScore: designSystemScore,
+        screenshotPath: input.screenshotPath,
+        tokensUsed: result.tokensUsed,
+    };
+}
+/**
+ * Translate raw measurement data into a 1-10 accessibility score.
+ *
+ * Anchors:
+ *  - 10: 100% AA contrast pass + 0 axe violations
+ *  -  8: 95%+ AA contrast pass + ≤2 minor/moderate violations
+ *  -  6: 90%+ AA contrast pass + 0 critical violations
+ *  -  4: 75%+ AA contrast pass OR 1 critical violation
+ *  -  2: <75% AA contrast pass OR 3+ critical violations
+ */
+function computeAccessibilityScore(measurements) {
+    const aaPass = measurements.contrast.summary.aaPassRate;
+    const critical = measurements.a11y.violations.filter(v => v.impact === 'critical').length;
+    const serious = measurements.a11y.violations.filter(v => v.impact === 'serious').length;
+    const moderate = measurements.a11y.violations.filter(v => v.impact === 'moderate').length;
+    // Catastrophic
+    if (aaPass < 0.5 || critical >= 3)
+        return 2;
+    // Severe
+    if (aaPass < 0.75 || critical >= 1)
+        return 4;
+    // Significant issues
+    if (aaPass < 0.9 || serious >= 3)
+        return 6;
+    // Minor issues
+    if (aaPass < 0.95 || serious >= 1 || moderate >= 3)
+        return 7;
+    // Mostly clean
+    if (aaPass < 1 || moderate >= 1)
+        return 8;
+    // Pristine
+    return 10;
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/design/audit/evaluate.js.map

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

package/dist/design/audit/measure/a11y.d.ts

@@ -0,0 +1,25 @@
+/**
+ * axe-core a11y measurement.
+ *
+ * Injects axe-core into the page and runs `axe.run()` to get ground-truth
+ * WCAG violations. Replaces the LLM's accessibility guesses with the
+ * industry-standard rule engine maintained by Deque.
+ *
+ * axe-core is bundled as a dependency; we read its source from node_modules
+ * and inject it via Playwright's `page.addScriptTag` so it works regardless
+ * of CSP.
+ */
+import type { Page } from 'playwright';
+import type { A11yReport, A11yViolation } from '../types.js';
+/**
+ * Run axe-core against the current page state.
+ *
+ * Failures of this function are non-fatal — the audit continues without
+ * a11y findings if axe can't be injected (e.g., strict CSP).
+ */
+export declare function measureA11y(page: Page): Promise<A11yReport>;
+/**
+ * Map axe impact level to our DesignFinding severity scale.
+ */
+export declare function impactToSeverity(impact: A11yViolation['impact']): 'critical' | 'major' | 'minor';
+//# sourceMappingURL=a11y.d.ts.map

package/dist/design/audit/measure/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/measure/a11y.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AA6C5D;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CA6FjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAWhG"}

package/dist/design/audit/measure/a11y.js

@@ -0,0 +1,144 @@
+/**
+ * axe-core a11y measurement.
+ *
+ * Injects axe-core into the page and runs `axe.run()` to get ground-truth
+ * WCAG violations. Replaces the LLM's accessibility guesses with the
+ * industry-standard rule engine maintained by Deque.
+ *
+ * axe-core is bundled as a dependency; we read its source from node_modules
+ * and inject it via Playwright's `page.addScriptTag` so it works regardless
+ * of CSP.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// Resolve axe-core's bundled JS once per process. Walk up from this file's
+// dist location to find node_modules — works in both `dist/` and source layout.
+let cachedAxeSource = null;
+function getAxeSource() {
+    if (cachedAxeSource !== null)
+        return cachedAxeSource;
+    // Try multiple candidate paths because compilation may relocate this file.
+    const candidates = [];
+    let cursor = __dirname;
+    for (let i = 0; i < 6; i++) {
+        candidates.push(path.join(cursor, 'node_modules/axe-core/axe.min.js'));
+        cursor = path.dirname(cursor);
+    }
+    for (const c of candidates) {
+        if (fs.existsSync(c)) {
+            cachedAxeSource = fs.readFileSync(c, 'utf-8');
+            return cachedAxeSource;
+        }
+    }
+    throw new Error('axe-core/axe.min.js not found in any parent node_modules');
+}
+/**
+ * Run axe-core against the current page state.
+ *
+ * Failures of this function are non-fatal — the audit continues without
+ * a11y findings if axe can't be injected (e.g., strict CSP).
+ */
+export async function measureA11y(page) {
+    let axeSource;
+    try {
+        axeSource = getAxeSource();
+    }
+    catch (err) {
+        return {
+            ran: false,
+            error: err instanceof Error ? err.message : String(err),
+            violations: [],
+            passes: 0,
+        };
+    }
+    try {
+        // Inject axe-core. CSP-strict pages (Stripe, GitHub, etc) block addScriptTag,
+        // so we fall back to direct evaluate() which CSP allows because it runs in
+        // the puppeteer/playwright extension world, not the page context.
+        let injected = false;
+        try {
+            await page.addScriptTag({ content: axeSource });
+            injected = true;
+        }
+        catch {
+            // CSP blocked the script tag — try CDP-based bypass
+            try {
+                const session = await page.context().newCDPSession(page);
+                await session.send('Page.addScriptToEvaluateOnNewDocument', { source: axeSource });
+                // Reload to apply
+                await page.reload({ waitUntil: 'domcontentloaded', timeout: 15_000 });
+                injected = true;
+            }
+            catch {
+                // CDP failed too — last resort: inject via evaluate (works on most CSP configs)
+                await page.evaluate((src) => {
+                    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+                    new Function(src)();
+                }, axeSource);
+                injected = true;
+            }
+        }
+        if (!injected) {
+            return {
+                ran: false,
+                error: 'all injection methods failed (CSP)',
+                violations: [],
+                passes: 0,
+            };
+        }
+        // Run with WCAG 2.1 AA tags. Limit nodes per violation to keep payload manageable.
+        const raw = (await page.evaluate(async () => {
+            const w = window;
+            if (!w.axe) {
+                throw new Error('axe not loaded after injection');
+            }
+            return w.axe.run(document, {
+                runOnly: { type: 'tag', values: ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'] },
+                resultTypes: ['violations', 'passes'],
+            });
+        }));
+        const violations = raw.violations.map(v => ({
+            id: v.id,
+            impact: v.impact ?? 'moderate',
+            description: v.description || v.help,
+            tags: v.tags,
+            helpUrl: v.helpUrl,
+            nodes: v.nodes.slice(0, 5).map(n => ({
+                selector: Array.isArray(n.target) ? n.target.join(' ') : String(n.target),
+                html: (n.html ?? '').slice(0, 200),
+                failureSummary: (n.failureSummary ?? '').slice(0, 300),
+            })),
+        }));
+        return {
+            ran: true,
+            violations,
+            passes: raw.passes.length,
+        };
+    }
+    catch (err) {
+        return {
+            ran: false,
+            error: err instanceof Error ? err.message : String(err),
+            violations: [],
+            passes: 0,
+        };
+    }
+}
+/**
+ * Map axe impact level to our DesignFinding severity scale.
+ */
+export function impactToSeverity(impact) {
+    switch (impact) {
+        case 'critical':
+        case 'serious':
+            return 'critical';
+        case 'moderate':
+            return 'major';
+        case 'minor':
+        default:
+            return 'minor';
+    }
+}
+//# sourceMappingURL=a11y.js.map

package/dist/design/audit/measure/a11y.js.map

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

package/dist/design/audit/measure/contrast.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Real WCAG 2.1 contrast measurement.
+ *
+ * Walks every visible text element in the page, computes its actual rendered
+ * text color and resolved background color (climbing the parent chain through
+ * transparent backgrounds), then calculates the WCAG relative luminance ratio.
+ *
+ * This is deterministic — pure math, no LLM. Replaces the LLM's "estimated
+ * contrast ratio" guesses with ground truth.
+ */
+import type { Page } from 'playwright';
+import type { ContrastReport } from '../types.js';
+/**
+ * Run contrast measurement on a Playwright page.
+ * Returns ground-truth WCAG contrast failures.
+ */
+export declare function measureContrast(page: Page): Promise<ContrastReport>;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/design/audit/measure/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../../../src/design/audit/measure/contrast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAA;AAuLlE;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CAsBzE"}