sentience-ts 0.10.3

package/dist/recorder.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Recorder - captures user actions into a trace
+ */
+import { SentienceBrowser } from './browser';
+import { Snapshot } from './types';
+export interface TraceStep {
+    ts: number;
+    type: 'navigation' | 'click' | 'type' | 'press' | 'wait' | 'assert';
+    selector?: string;
+    element_id?: number;
+    text?: string;
+    key?: string;
+    url?: string;
+    snapshot?: Snapshot;
+}
+export interface Trace {
+    version: string;
+    created_at: string;
+    start_url: string;
+    steps: TraceStep[];
+}
+export declare class Recorder {
+    private browser;
+    private captureSnapshots;
+    private trace;
+    private active;
+    private startTime;
+    private maskPatterns;
+    constructor(browser: SentienceBrowser, captureSnapshots?: boolean);
+    start(): void;
+    stop(): void;
+    addMaskPattern(pattern: string): void;
+    private shouldMask;
+    recordNavigation(url: string): void;
+    recordClick(elementId: number, selector?: string): Promise<void>;
+    recordType(elementId: number, text: string, selector?: string): Promise<void>;
+    recordPress(key: string): void;
+    getTrace(): Trace;
+    save(filepath: string): Promise<void>;
+    static load(filepath: string): Promise<Trace>;
+    private inferSelector;
+}
+export declare function record(browser: SentienceBrowser, captureSnapshots?: boolean): Recorder;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAW,MAAM,SAAS,CAAC;AAI5C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,qBAAa,QAAQ;IAOjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IAP1B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAAgB;gBAG1B,OAAO,EAAE,gBAAgB,EACzB,gBAAgB,GAAE,OAAe;IAG3C,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IAIZ,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrC,OAAO,CAAC,UAAU;IAKlB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAW7B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwChE,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnF,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAW9B,QAAQ,IAAI,KAAK;IAOX,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAS9B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;YAMrC,aAAa;CAwF5B;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,GAAE,OAAe,GAAG,QAAQ,CAE7F"}

package/dist/recorder.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * Recorder - captures user actions into a trace
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Recorder = void 0;
+exports.record = record;
+const snapshot_1 = require("./snapshot");
+const query_1 = require("./query");
+class Recorder {
+    constructor(browser, captureSnapshots = false) {
+        this.browser = browser;
+        this.captureSnapshots = captureSnapshots;
+        this.trace = null;
+        this.active = false;
+        this.startTime = new Date();
+        this.maskPatterns = [];
+    }
+    start() {
+        const page = this.browser.getPage();
+        this.active = true;
+        const startUrl = page.url();
+        this.startTime = new Date();
+        this.trace = {
+            version: '1.0.0',
+            created_at: new Date().toISOString(),
+            start_url: startUrl,
+            steps: [],
+        };
+    }
+    stop() {
+        this.active = false;
+    }
+    addMaskPattern(pattern) {
+        this.maskPatterns.push(pattern.toLowerCase());
+    }
+    shouldMask(text) {
+        const textLower = text.toLowerCase();
+        return this.maskPatterns.some((pattern) => textLower.includes(pattern));
+    }
+    recordNavigation(url) {
+        if (!this.active || !this.trace)
+            return;
+        const ts = Date.now() - this.startTime.getTime();
+        this.trace.steps.push({
+            ts,
+            type: 'navigation',
+            url,
+        });
+    }
+    async recordClick(elementId, selector) {
+        if (!this.active || !this.trace)
+            return;
+        // If no selector provided, try to infer one
+        if (!selector) {
+            selector = await this.inferSelector(elementId);
+        }
+        const ts = Date.now() - this.startTime.getTime();
+        // Optionally capture snapshot
+        if (this.captureSnapshots) {
+            try {
+                const snap = await (0, snapshot_1.snapshot)(this.browser);
+                this.trace.steps.push({
+                    ts,
+                    type: 'click',
+                    element_id: elementId,
+                    selector,
+                    snapshot: snap,
+                });
+            }
+            catch (e) {
+                // If snapshot fails, just record without it
+                this.trace.steps.push({
+                    ts,
+                    type: 'click',
+                    element_id: elementId,
+                    selector,
+                });
+            }
+        }
+        else {
+            this.trace.steps.push({
+                ts,
+                type: 'click',
+                element_id: elementId,
+                selector,
+            });
+        }
+    }
+    async recordType(elementId, text, selector) {
+        if (!this.active || !this.trace)
+            return;
+        // If no selector provided, try to infer one
+        if (!selector) {
+            selector = await this.inferSelector(elementId);
+        }
+        const ts = Date.now() - this.startTime.getTime();
+        const mask = this.shouldMask(text);
+        const maskedText = mask ? '***' : text;
+        this.trace.steps.push({
+            ts,
+            type: 'type',
+            element_id: elementId,
+            text: maskedText,
+            selector,
+        });
+    }
+    recordPress(key) {
+        if (!this.active || !this.trace)
+            return;
+        const ts = Date.now() - this.startTime.getTime();
+        this.trace.steps.push({
+            ts,
+            type: 'press',
+            key,
+        });
+    }
+    getTrace() {
+        if (!this.trace) {
+            throw new Error('No trace available. Start recording first.');
+        }
+        return this.trace;
+    }
+    async save(filepath) {
+        if (!this.trace) {
+            throw new Error('No trace to save. Start recording first.');
+        }
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        fs.writeFileSync(filepath, JSON.stringify(this.trace, null, 2), 'utf-8');
+    }
+    static async load(filepath) {
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        const data = fs.readFileSync(filepath, 'utf-8');
+        return JSON.parse(data);
+    }
+    async inferSelector(elementId) {
+        try {
+            // Take a snapshot to get element info
+            const snap = await (0, snapshot_1.snapshot)(this.browser);
+            // Find the element in the snapshot
+            let element;
+            for (const el of snap.elements) {
+                if (el.id === elementId) {
+                    element = el;
+                    break;
+                }
+            }
+            if (!element) {
+                return undefined;
+            }
+            // Build candidate selector
+            const parts = [];
+            // Add role
+            if (element.role && element.role !== 'generic') {
+                parts.push(`role=${element.role}`);
+            }
+            // Add text if available
+            if (element.text) {
+                const textPart = element.text.replace(/"/g, '\\"').substring(0, 50);
+                parts.push(`text~"${textPart}"`);
+            }
+            else {
+                // Try to get name/aria-label/placeholder from DOM
+                try {
+                    const el = await this.browser.getPage().evaluate((id) => {
+                        const registry = window.sentience_registry;
+                        if (!registry || !registry[id])
+                            return null;
+                        const elem = registry[id];
+                        return {
+                            name: elem.name || null,
+                            ariaLabel: elem.getAttribute('aria-label') || null,
+                            placeholder: elem.placeholder || null,
+                        };
+                    }, elementId);
+                    if (el) {
+                        if (el.name) {
+                            parts.push(`name="${el.name}"`);
+                        }
+                        else if (el.ariaLabel) {
+                            parts.push(`text~"${el.ariaLabel}"`);
+                        }
+                        else if (el.placeholder) {
+                            parts.push(`text~"${el.placeholder}"`);
+                        }
+                    }
+                }
+                catch (e) {
+                    // Ignore errors
+                }
+            }
+            // Add clickable if relevant
+            if (element.visual_cues.is_clickable) {
+                parts.push('clickable=true');
+            }
+            if (parts.length === 0) {
+                return undefined;
+            }
+            const selector = parts.join(' ');
+            // Validate selector - should match exactly 1 element
+            const matches = (0, query_1.query)(snap, selector);
+            if (matches.length === 1) {
+                return selector;
+            }
+            else if (matches.length > 1) {
+                // Multiple matches - return selector anyway (could add more constraints later)
+                return selector;
+            }
+            else {
+                // Selector doesn't match - return undefined (will use element_id)
+                return undefined;
+            }
+        }
+        catch (e) {
+            return undefined;
+        }
+    }
+}
+exports.Recorder = Recorder;
+function record(browser, captureSnapshots = false) {
+    return new Recorder(browser, captureSnapshots);
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkQH,wBAEC;AAhQD,yCAAsC;AACtC,mCAAqD;AAoBrD,MAAa,QAAQ;IAMnB,YACU,OAAyB,EACzB,mBAA4B,KAAK;QADjC,YAAO,GAAP,OAAO,CAAkB;QACzB,qBAAgB,GAAhB,gBAAgB,CAAiB;QAPnC,UAAK,GAAiB,IAAI,CAAC;QAC3B,WAAM,GAAY,KAAK,CAAC;QACxB,cAAS,GAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,iBAAY,GAAa,EAAE,CAAC;IAKjC,CAAC;IAEJ,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,GAAG;YACX,OAAO,EAAE,OAAO;YAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,SAAS,EAAE,QAAQ;YACnB,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,CAAC;IAEO,UAAU,CAAC,IAAY;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,gBAAgB,CAAC,GAAW;QAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YACpB,EAAE;YACF,IAAI,EAAE,YAAY;YAClB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,QAAiB;QACpD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExC,4CAA4C;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAEjD,8BAA8B;QAC9B,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;oBACpB,EAAE;oBACF,IAAI,EAAE,OAAO;oBACb,UAAU,EAAE,SAAS;oBACrB,QAAQ;oBACR,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,4CAA4C;gBAC5C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;oBACpB,EAAE;oBACF,IAAI,EAAE,OAAO;oBACb,UAAU,EAAE,SAAS;oBACrB,QAAQ;iBACT,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;gBACpB,EAAE;gBACF,IAAI,EAAE,OAAO;gBACb,UAAU,EAAE,SAAS;gBACrB,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,IAAY,EAAE,QAAiB;QACjE,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExC,4CAA4C;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAEvC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YACpB,EAAE;YACF,IAAI,EAAE,MAAM;YACZ,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,UAAU;YAChB,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO;QAExC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;YACpB,EAAE;YACF,IAAI,EAAE,OAAO;YACb,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,EAAE,GAAG,wDAAa,IAAI,GAAC,CAAC;QAC9B,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAgB;QAChC,MAAM,EAAE,GAAG,wDAAa,IAAI,GAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAU,CAAC;IACnC,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,SAAiB;QAC3C,IAAI,CAAC;YACH,sCAAsC;YACtC,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE1C,mCAAmC;YACnC,IAAI,OAA4B,CAAC;YACjC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,IAAI,EAAE,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,2BAA2B;YAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;YAE3B,WAAW;YACX,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACrC,CAAC;YAED,wBAAwB;YACxB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpE,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,GAAG,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,kDAAkD;gBAClD,IAAI,CAAC;oBACH,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,CAC9C,CAAC,EAAE,EAAE,EAAE;wBACL,MAAM,QAAQ,GAAI,MAAc,CAAC,kBAAkB,CAAC;wBACpD,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;4BAAE,OAAO,IAAI,CAAC;wBAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;wBAC1B,OAAO;4BACL,IAAI,EAAG,IAAyB,CAAC,IAAI,IAAI,IAAI;4BAC7C,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,IAAI;4BAClD,WAAW,EAAG,IAAyB,CAAC,WAAW,IAAI,IAAI;yBAC5D,CAAC;oBACJ,CAAC,EACD,SAAS,CACV,CAAC;oBAEF,IAAI,EAAE,EAAE,CAAC;wBACP,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;4BACZ,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;wBAClC,CAAC;6BAAM,IAAI,EAAE,CAAC,SAAS,EAAE,CAAC;4BACxB,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,SAAS,GAAG,CAAC,CAAC;wBACvC,CAAC;6BAAM,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;4BAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,WAAW,GAAG,CAAC,CAAC;wBACzC,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,gBAAgB;gBAClB,CAAC;YACH,CAAC;YAED,4BAA4B;YAC5B,IAAI,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC/B,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEjC,qDAAqD;YACrD,MAAM,OAAO,GAAG,IAAA,aAAK,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAEtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,QAAQ,CAAC;YAClB,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,+EAA+E;gBAC/E,OAAO,QAAQ,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACN,kEAAkE;gBAClE,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AAvOD,4BAuOC;AAED,SAAgB,MAAM,CAAC,OAAyB,EAAE,mBAA4B,KAAK;IACjF,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AACjD,CAAC"}

package/dist/screenshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Screenshot functionality - standalone screenshot capture
+ */
+import { SentienceBrowser } from './browser';
+export interface ScreenshotOptions {
+    format?: 'png' | 'jpeg';
+    quality?: number;
+}
+/**
+ * Capture screenshot of current page
+ *
+ * @param browser - SentienceBrowser instance
+ * @param options - Screenshot options
+ * @returns Base64-encoded screenshot data URL (e.g., "data:image/png;base64,...")
+ */
+export declare function screenshot(browser: SentienceBrowser, options?: ScreenshotOptions): Promise<string>;
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CA2BjB"}

package/dist/screenshot.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Screenshot functionality - standalone screenshot capture
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.screenshot = screenshot;
+/**
+ * Capture screenshot of current page
+ *
+ * @param browser - SentienceBrowser instance
+ * @param options - Screenshot options
+ * @returns Base64-encoded screenshot data URL (e.g., "data:image/png;base64,...")
+ */
+async function screenshot(browser, options = {}) {
+    const page = browser.getPage();
+    const format = options.format || 'png';
+    const quality = options.quality;
+    if (format === 'jpeg' && quality !== undefined) {
+        if (quality < 1 || quality > 100) {
+            throw new Error('Quality must be between 1 and 100 for JPEG format');
+        }
+    }
+    // Use Playwright's screenshot with base64 encoding
+    const screenshotOptions = {
+        type: format,
+        encoding: 'base64',
+    };
+    if (format === 'jpeg' && quality !== undefined) {
+        screenshotOptions.quality = quality;
+    }
+    // Capture screenshot
+    const base64Data = await page.screenshot(screenshotOptions);
+    // Return as data URL
+    const mimeType = format === 'png' ? 'image/png' : 'image/jpeg';
+    return `data:${mimeType};base64,${base64Data}`;
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../src/screenshot.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAgBH,gCA8BC;AArCD;;;;;;GAMG;AACI,KAAK,UAAU,UAAU,CAC9B,OAAyB,EACzB,UAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/C,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,iBAAiB,GAAQ;QAC7B,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,QAAQ;KACnB,CAAC;IAEF,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/C,iBAAiB,CAAC,OAAO,GAAG,OAAO,CAAC;IACtC,CAAC;IAED,qBAAqB;IACrB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IAE5D,qBAAqB;IACrB,MAAM,QAAQ,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;IAC/D,OAAO,QAAQ,QAAQ,WAAW,UAAU,EAAE,CAAC;AACjD,CAAC"}

package/dist/snapshot.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Snapshot functionality - calls window.sentience.snapshot() or server-side API
+ */
+import { SentienceBrowser } from './browser';
+import { Snapshot } from './types';
+export interface SnapshotOptions {
+    screenshot?: boolean | {
+        format: 'png' | 'jpeg';
+        quality?: number;
+    };
+    limit?: number;
+    filter?: {
+        min_area?: number;
+        allowed_roles?: string[];
+        min_z_index?: number;
+    };
+    use_api?: boolean;
+}
+export declare function snapshot(browser: SentienceBrowser, options?: SnapshotOptions): Promise<Snapshot>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,QAAQ,CAAC,CAiBnB"}

package/dist/snapshot.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Snapshot functionality - calls window.sentience.snapshot() or server-side API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshot = snapshot;
+async function snapshot(browser, options = {}) {
+    // Get API configuration
+    const apiKey = browser.getApiKey();
+    const apiUrl = browser.getApiUrl();
+    // Determine if we should use server-side API
+    const shouldUseApi = options.use_api !== undefined
+        ? options.use_api
+        : (apiKey !== undefined);
+    if (shouldUseApi && apiKey) {
+        // Use server-side API (Pro/Enterprise tier)
+        return snapshotViaApi(browser, options, apiKey, apiUrl);
+    }
+    else {
+        // Use local extension (Free tier)
+        return snapshotViaExtension(browser, options);
+    }
+}
+async function snapshotViaExtension(browser, options) {
+    const page = browser.getPage();
+    // Build options object
+    const opts = {};
+    if (options.screenshot !== undefined) {
+        opts.screenshot = options.screenshot;
+    }
+    if (options.limit !== undefined) {
+        opts.limit = options.limit;
+    }
+    if (options.filter !== undefined) {
+        opts.filter = options.filter;
+    }
+    // Call extension API
+    const result = await page.evaluate((opts) => {
+        return window.sentience.snapshot(opts);
+    }, opts);
+    // Basic validation
+    if (result.status !== 'success' && result.status !== 'error') {
+        throw new Error(`Invalid snapshot status: ${result.status}`);
+    }
+    return result;
+}
+async function snapshotViaApi(browser, options, apiKey, apiUrl) {
+    const page = browser.getPage();
+    // Step 1: Get raw data from local extension (always happens locally)
+    const rawOpts = {};
+    if (options.screenshot !== undefined) {
+        rawOpts.screenshot = options.screenshot;
+    }
+    const rawResult = await page.evaluate((opts) => {
+        return window.sentience.snapshot(opts);
+    }, rawOpts);
+    // Step 2: Send to server for smart ranking/filtering
+    // Use raw_elements (raw data) instead of elements (processed data)
+    // Server validates API key and applies proprietary ranking logic
+    const payload = {
+        raw_elements: rawResult.raw_elements || [], // Raw data needed for server processing
+        url: rawResult.url || '',
+        viewport: rawResult.viewport,
+        options: {
+            limit: options.limit,
+            filter: options.filter,
+        },
+    };
+    const headers = {
+        'Authorization': `Bearer ${apiKey}`,
+        'Content-Type': 'application/json',
+    };
+    try {
+        const response = await fetch(`${apiUrl}/v1/snapshot`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API request failed: ${response.status} ${errorText}`);
+        }
+        const apiResult = await response.json();
+        // Merge API result with local data (screenshot, etc.)
+        const snapshotData = {
+            status: apiResult.status || 'success',
+            timestamp: apiResult.timestamp,
+            url: apiResult.url || rawResult.url || '',
+            viewport: apiResult.viewport || rawResult.viewport,
+            elements: apiResult.elements || [],
+            screenshot: rawResult.screenshot, // Keep local screenshot
+            screenshot_format: rawResult.screenshot_format,
+            error: apiResult.error,
+        };
+        return snapshotData;
+    }
+    catch (e) {
+        throw new Error(`API request failed: ${e.message}`);
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * TypeScript type definitions - matches spec/sdk-types.md
+ */
+export interface BBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Viewport {
+    width: number;
+    height: number;
+}
+export interface VisualCues {
+    is_primary: boolean;
+    background_color_name: string | null;
+    is_clickable: boolean;
+}
+export interface Element {
+    id: number;
+    role: string;
+    text: string | null;
+    importance: number;
+    bbox: BBox;
+    visual_cues: VisualCues;
+    in_viewport: boolean;
+    is_occluded: boolean;
+    z_index: number;
+}
+export interface Snapshot {
+    status: "success" | "error";
+    timestamp?: string;
+    url: string;
+    viewport?: Viewport;
+    elements: Element[];
+    screenshot?: string;
+    screenshot_format?: "png" | "jpeg";
+    error?: string;
+    requires_license?: boolean;
+}
+export interface ActionResult {
+    success: boolean;
+    duration_ms: number;
+    outcome?: "navigated" | "dom_updated" | "no_change" | "error";
+    url_changed?: boolean;
+    snapshot_after?: Snapshot;
+    error?: {
+        code: string;
+        reason: string;
+        recovery_hint?: string;
+    };
+}
+export interface WaitResult {
+    found: boolean;
+    element?: Element;
+    duration_ms: number;
+    timeout: boolean;
+}
+export interface QuerySelectorObject {
+    role?: string;
+    text?: string;
+    name?: string;
+    clickable?: boolean;
+    isPrimary?: boolean;
+    importance?: number | {
+        min?: number;
+        max?: number;
+    };
+}
+export type QuerySelector = string | QuerySelectorObject;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,QAAQ,CAAC;IAC1B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,mBAAmB,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * TypeScript type definitions - matches spec/sdk-types.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/wait.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Wait functionality
+ */
+import { SentienceBrowser } from './browser';
+import { WaitResult, QuerySelector } from './types';
+export declare function waitFor(browser: SentienceBrowser, selector: QuerySelector, timeout?: number, interval?: number): Promise<WaitResult>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAW,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7D,wBAAsB,OAAO,CAC3B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,MAAc,EACvB,QAAQ,GAAE,MAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAgCrB"}

package/dist/wait.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Wait functionality
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitFor = waitFor;
+const snapshot_1 = require("./snapshot");
+const query_1 = require("./query");
+async function waitFor(browser, selector, timeout = 10000, interval = 250) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        // Take snapshot
+        const snap = await (0, snapshot_1.snapshot)(browser);
+        // Try to find element
+        const element = (0, query_1.find)(snap, selector);
+        if (element) {
+            const durationMs = Date.now() - startTime;
+            return {
+                found: true,
+                element,
+                duration_ms: durationMs,
+                timeout: false,
+            };
+        }
+        // Wait before next poll
+        await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    // Timeout
+    const durationMs = Date.now() - startTime;
+    return {
+        found: false,
+        element: undefined,
+        duration_ms: durationMs,
+        timeout: true,
+    };
+}
+//# sourceMappingURL=wait.js.map

package/dist/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../src/wait.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAOH,0BAqCC;AAxCD,yCAAsC;AACtC,mCAA+B;AAExB,KAAK,UAAU,OAAO,CAC3B,OAAyB,EACzB,QAAuB,EACvB,UAAkB,KAAK,EACvB,WAAmB,GAAG;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;QACxC,gBAAgB;QAChB,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAQ,EAAC,OAAO,CAAC,CAAC;QAErC,sBAAsB;QACtB,MAAM,OAAO,GAAG,IAAA,YAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAErC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAC1C,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,OAAO;gBACP,WAAW,EAAE,UAAU;gBACvB,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,UAAU;IACV,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAC1C,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,UAAU;QACvB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}