sentienceapi 0.90.1

package/dist/expect.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Expect/Assert functionality
+ */
+import { SentienceBrowser } from './browser';
+import { Element, QuerySelector } from './types';
+export declare class Expectation {
+    private browser;
+    private selector;
+    constructor(browser: SentienceBrowser, selector: QuerySelector);
+    toBeVisible(timeout?: number): Promise<Element>;
+    toExist(timeout?: number): Promise<Element>;
+    toHaveText(expectedText: string, timeout?: number): Promise<Element>;
+    toHaveCount(expectedCount: number, timeout?: number): Promise<void>;
+}
+export declare function expect(browser: SentienceBrowser, selector: QuerySelector): Expectation;
+//# sourceMappingURL=expect.d.ts.map

package/dist/expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../src/expect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKjD,qBAAa,WAAW;IAEpB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ;gBADR,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,aAAa;IAG3B,WAAW,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBtD,OAAO,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlD,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB3E,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBjF;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,GAAG,WAAW,CAEtF"}

package/dist/expect.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * Expect/Assert functionality
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Expectation = void 0;
+exports.expect = expect;
+const wait_1 = require("./wait");
+const query_1 = require("./query");
+const snapshot_1 = require("./snapshot");
+class Expectation {
+    constructor(browser, selector) {
+        this.browser = browser;
+        this.selector = selector;
+    }
+    async toBeVisible(timeout = 10000) {
+        const result = await (0, wait_1.waitFor)(this.browser, this.selector, timeout);
+        if (!result.found) {
+            throw new Error(`Element not found: ${this.selector} (timeout: ${timeout}ms)`);
+        }
+        const element = result.element;
+        if (!element.in_viewport) {
+            throw new Error(`Element found but not visible in viewport: ${this.selector}`);
+        }
+        return element;
+    }
+    async toExist(timeout = 10000) {
+        const result = await (0, wait_1.waitFor)(this.browser, this.selector, timeout);
+        if (!result.found) {
+            throw new Error(`Element does not exist: ${this.selector} (timeout: ${timeout}ms)`);
+        }
+        return result.element;
+    }
+    async toHaveText(expectedText, timeout = 10000) {
+        const result = await (0, wait_1.waitFor)(this.browser, this.selector, timeout);
+        if (!result.found) {
+            throw new Error(`Element not found: ${this.selector} (timeout: ${timeout}ms)`);
+        }
+        const element = result.element;
+        if (!element.text || !element.text.includes(expectedText)) {
+            throw new Error(`Element text mismatch. Expected '${expectedText}', got '${element.text}'`);
+        }
+        return element;
+    }
+    async toHaveCount(expectedCount, timeout = 10000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeout) {
+            const snap = await (0, snapshot_1.snapshot)(this.browser);
+            const matches = (0, query_1.query)(snap, this.selector);
+            if (matches.length === expectedCount) {
+                return;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 250));
+        }
+        // Final check
+        const snap = await (0, snapshot_1.snapshot)(this.browser);
+        const matches = (0, query_1.query)(snap, this.selector);
+        const actualCount = matches.length;
+        throw new Error(`Element count mismatch. Expected ${expectedCount}, got ${actualCount}`);
+    }
+}
+exports.Expectation = Expectation;
+function expect(browser, selector) {
+    return new Expectation(browser, selector);
+}
+//# sourceMappingURL=expect.js.map

package/dist/expect.js.map

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

package/dist/generator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Script Generator - converts trace into executable code
+ */
+import { Trace } from './recorder';
+export declare class ScriptGenerator {
+    private trace;
+    constructor(trace: Trace);
+    generatePython(): string;
+    generateTypeScript(): string;
+    private generatePythonStep;
+    private generateTypeScriptStep;
+    savePython(filepath: string): Promise<void>;
+    saveTypeScript(filepath: string): Promise<void>;
+}
+export declare function generate(trace: Trace, language?: 'py' | 'ts'): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAa,MAAM,YAAY,CAAC;AAE9C,qBAAa,eAAe;IACd,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEhC,cAAc,IAAI,MAAM;IAyBxB,kBAAkB,IAAI,MAAM;IA4B5B,OAAO,CAAC,kBAAkB;IA4C1B,OAAO,CAAC,sBAAsB;IA8CxB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAO3E"}

package/dist/generator.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * Script Generator - converts trace into executable code
+ */
+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.ScriptGenerator = void 0;
+exports.generate = generate;
+class ScriptGenerator {
+    constructor(trace) {
+        this.trace = trace;
+    }
+    generatePython() {
+        const lines = [
+            '"""',
+            `Generated script from trace: ${this.trace.start_url}`,
+            `Created: ${this.trace.created_at}`,
+            '"""',
+            '',
+            'from sentience import SentienceBrowser, snapshot, find, click, type_text, press',
+            '',
+            'def main():',
+            '    with SentienceBrowser(headless=False) as browser:',
+            `        browser.page.goto("${this.trace.start_url}")`,
+            '        browser.page.wait_for_load_state("networkidle")',
+            '',
+        ];
+        for (const step of this.trace.steps) {
+            lines.push(...this.generatePythonStep(step, '        '));
+        }
+        lines.push('', 'if __name__ == "__main__":', '    main()');
+        return lines.join('\n');
+    }
+    generateTypeScript() {
+        const lines = [
+            '/**',
+            ` * Generated script from trace: ${this.trace.start_url}`,
+            ` * Created: ${this.trace.created_at}`,
+            ' */',
+            '',
+            "import { SentienceBrowser, snapshot, find, click, typeText, press } from './src';",
+            '',
+            'async function main() {',
+            '  const browser = new SentienceBrowser(undefined, undefined, false);',
+            '',
+            '  try {',
+            '    await browser.start();',
+            `    await browser.getPage().goto('${this.trace.start_url}');`,
+            '    await browser.getPage().waitForLoadState(\'networkidle\');',
+            '',
+        ];
+        for (const step of this.trace.steps) {
+            lines.push(...this.generateTypeScriptStep(step, '    '));
+        }
+        lines.push('  } finally {', '    await browser.close();', '  }', '}', '', 'main().catch(console.error);');
+        return lines.join('\n');
+    }
+    generatePythonStep(step, indent) {
+        const lines = [];
+        if (step.type === 'navigation') {
+            lines.push(`${indent}# Navigate to ${step.url}`);
+            lines.push(`${indent}browser.page.goto("${step.url}")`);
+            lines.push(`${indent}browser.page.wait_for_load_state("networkidle")`);
+        }
+        else if (step.type === 'click') {
+            if (step.selector) {
+                lines.push(`${indent}# Click: ${step.selector}`);
+                lines.push(`${indent}snap = snapshot(browser)`);
+                lines.push(`${indent}element = find(snap, "${step.selector}")`);
+                lines.push(`${indent}if element:`);
+                lines.push(`${indent}    click(browser, element.id)`);
+                lines.push(`${indent}else:`);
+                lines.push(`${indent}    raise Exception("Element not found: ${step.selector}")`);
+            }
+            else if (step.element_id !== undefined) {
+                lines.push(`${indent}# TODO: replace with semantic selector`);
+                lines.push(`${indent}click(browser, ${step.element_id})`);
+            }
+            lines.push('');
+        }
+        else if (step.type === 'type') {
+            if (step.selector) {
+                lines.push(`${indent}# Type into: ${step.selector}`);
+                lines.push(`${indent}snap = snapshot(browser)`);
+                lines.push(`${indent}element = find(snap, "${step.selector}")`);
+                lines.push(`${indent}if element:`);
+                lines.push(`${indent}    type_text(browser, element.id, "${step.text}")`);
+                lines.push(`${indent}else:`);
+                lines.push(`${indent}    raise Exception("Element not found: ${step.selector}")`);
+            }
+            else if (step.element_id !== undefined) {
+                lines.push(`${indent}# TODO: replace with semantic selector`);
+                lines.push(`${indent}type_text(browser, ${step.element_id}, "${step.text}")`);
+            }
+            lines.push('');
+        }
+        else if (step.type === 'press') {
+            lines.push(`${indent}# Press key: ${step.key}`);
+            lines.push(`${indent}press(browser, "${step.key}")`);
+            lines.push('');
+        }
+        return lines;
+    }
+    generateTypeScriptStep(step, indent) {
+        const lines = [];
+        if (step.type === 'navigation') {
+            lines.push(`${indent}// Navigate to ${step.url}`);
+            lines.push(`${indent}await browser.getPage().goto('${step.url}');`);
+            lines.push(`${indent}await browser.getPage().waitForLoadState('networkidle');`);
+        }
+        else if (step.type === 'click') {
+            if (step.selector) {
+                lines.push(`${indent}// Click: ${step.selector}`);
+                lines.push(`${indent}const snap = await snapshot(browser);`);
+                lines.push(`${indent}const element = find(snap, '${step.selector}');`);
+                lines.push(`${indent}if (element) {`);
+                lines.push(`${indent}  await click(browser, element.id);`);
+                lines.push(`${indent}} else {`);
+                lines.push(`${indent}  throw new Error('Element not found: ${step.selector}');`);
+                lines.push(`${indent}}`);
+            }
+            else if (step.element_id !== undefined) {
+                lines.push(`${indent}// TODO: replace with semantic selector`);
+                lines.push(`${indent}await click(browser, ${step.element_id});`);
+            }
+            lines.push('');
+        }
+        else if (step.type === 'type') {
+            if (step.selector) {
+                lines.push(`${indent}// Type into: ${step.selector}`);
+                lines.push(`${indent}const snap = await snapshot(browser);`);
+                lines.push(`${indent}const element = find(snap, '${step.selector}');`);
+                lines.push(`${indent}if (element) {`);
+                lines.push(`${indent}  await typeText(browser, element.id, '${step.text}');`);
+                lines.push(`${indent}} else {`);
+                lines.push(`${indent}  throw new Error('Element not found: ${step.selector}');`);
+                lines.push(`${indent}}`);
+            }
+            else if (step.element_id !== undefined) {
+                lines.push(`${indent}// TODO: replace with semantic selector`);
+                lines.push(`${indent}await typeText(browser, ${step.element_id}, '${step.text}');`);
+            }
+            lines.push('');
+        }
+        else if (step.type === 'press') {
+            lines.push(`${indent}// Press key: ${step.key}`);
+            lines.push(`${indent}await press(browser, '${step.key}');`);
+            lines.push('');
+        }
+        return lines;
+    }
+    async savePython(filepath) {
+        const code = this.generatePython();
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        fs.writeFileSync(filepath, code, 'utf-8');
+    }
+    async saveTypeScript(filepath) {
+        const code = this.generateTypeScript();
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        fs.writeFileSync(filepath, code, 'utf-8');
+    }
+}
+exports.ScriptGenerator = ScriptGenerator;
+function generate(trace, language = 'py') {
+    const generator = new ScriptGenerator(trace);
+    if (language === 'py') {
+        return generator.generatePython();
+    }
+    else {
+        return generator.generateTypeScript();
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmKH,4BAOC;AAtKD,MAAa,eAAe;IAC1B,YAAoB,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;IAAG,CAAC;IAEpC,cAAc;QACZ,MAAM,KAAK,GAAG;YACZ,KAAK;YACL,gCAAgC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE;YACtD,YAAY,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;YACnC,KAAK;YACL,EAAE;YACF,iFAAiF;YACjF,EAAE;YACF,aAAa;YACb,uDAAuD;YACvD,8BAA8B,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI;YACtD,yDAAyD;YACzD,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,4BAA4B,EAAE,YAAY,CAAC,CAAC;QAE3D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,kBAAkB;QAChB,MAAM,KAAK,GAAG;YACZ,KAAK;YACL,mCAAmC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE;YACzD,eAAe,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE;YACtC,KAAK;YACL,EAAE;YACF,mFAAmF;YACnF,EAAE;YACF,yBAAyB;YACzB,sEAAsE;YACtE,EAAE;YACF,SAAS;YACT,4BAA4B;YAC5B,qCAAqC,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK;YAC9D,gEAAgE;YAChE,EAAE;SACH,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,4BAA4B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,8BAA8B,CAAC,CAAC;QAE1G,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,kBAAkB,CAAC,IAAe,EAAE,MAAc;QACxD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,sBAAsB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,iDAAiD,CAAC,CAAC;QACzE,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,0BAA0B,CAAC,CAAC;gBAChD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yBAAyB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,gCAAgC,CAAC,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,2CAA2C,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;YACpF,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,wCAAwC,CAAC,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,kBAAkB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;YAC5D,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACrD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,0BAA0B,CAAC,CAAC;gBAChD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yBAAyB,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,aAAa,CAAC,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,uCAAuC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;gBAC1E,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,2CAA2C,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;YACpF,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,wCAAwC,CAAC,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,sBAAsB,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;YAChF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,gBAAgB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,mBAAmB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,sBAAsB,CAAC,IAAe,EAAE,MAAc;QAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,kBAAkB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,iCAAiC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,0DAA0D,CAAC,CAAC;QAClF,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAClD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,uCAAuC,CAAC,CAAC;gBAC7D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,+BAA+B,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;gBACvE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,qCAAqC,CAAC,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,CAAC,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yCAAyC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;gBACjF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yCAAyC,CAAC,CAAC;gBAC/D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,wBAAwB,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YACnE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,iBAAiB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACtD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,uCAAuC,CAAC,CAAC;gBAC7D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,+BAA+B,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;gBACvE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,gBAAgB,CAAC,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,0CAA0C,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;gBAC9E,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,CAAC,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yCAAyC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;gBACjF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yCAAyC,CAAC,CAAC;gBAC/D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,2BAA2B,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;YACtF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,iBAAiB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,yBAAyB,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,EAAE,GAAG,wDAAa,IAAI,GAAC,CAAC;QAC9B,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,wDAAa,IAAI,GAAC,CAAC;QAC9B,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;CACF;AA7JD,0CA6JC;AAED,SAAgB,QAAQ,CAAC,KAAY,EAAE,WAAwB,IAAI;IACjE,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC,cAAc,EAAE,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Sentience TypeScript SDK - AI Agent Browser Automation
+ */
+export { SentienceBrowser } from './browser';
+export { snapshot, SnapshotOptions } from './snapshot';
+export { query, find, parseSelector } from './query';
+export { click, typeText, press, clickRect, ClickRect } from './actions';
+export { waitFor } from './wait';
+export { expect, Expectation } from './expect';
+export { Inspector, inspect } from './inspector';
+export { Recorder, Trace, TraceStep, record } from './recorder';
+export { ScriptGenerator, generate } from './generator';
+export { read, ReadOptions, ReadResult } from './read';
+export { screenshot, ScreenshotOptions } from './screenshot';
+export * from './types';
+export { saveStorageState } from './utils';
+export { LLMProvider, LLMResponse, OpenAIProvider, AnthropicProvider } from './llm-provider';
+export { SentienceAgent, AgentActResult, HistoryEntry, TokenStats } from './agent';
+export { ConversationalAgent, ExecutionPlan, PlanStep, StepResult, ConversationEntry, ActionType, ActionParameters } from './conversational-agent';
+export { Tracer, TraceSink, JsonlTraceSink, TraceEvent, TraceEventData } from './tracing';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC7D,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EACL,WAAW,EACX,WAAW,EACX,cAAc,EACd,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,MAAM,EACN,SAAS,EACT,cAAc,EACd,UAAU,EACV,cAAc,EACf,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * Sentience TypeScript SDK - AI Agent Browser Automation
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonlTraceSink = exports.TraceSink = exports.Tracer = exports.ConversationalAgent = exports.SentienceAgent = exports.AnthropicProvider = exports.OpenAIProvider = exports.LLMProvider = exports.saveStorageState = exports.screenshot = exports.read = exports.generate = exports.ScriptGenerator = exports.record = exports.Recorder = exports.inspect = exports.Inspector = exports.Expectation = exports.expect = exports.waitFor = exports.clickRect = exports.press = exports.typeText = exports.click = exports.parseSelector = exports.find = exports.query = exports.snapshot = exports.SentienceBrowser = void 0;
+var browser_1 = require("./browser");
+Object.defineProperty(exports, "SentienceBrowser", { enumerable: true, get: function () { return browser_1.SentienceBrowser; } });
+var snapshot_1 = require("./snapshot");
+Object.defineProperty(exports, "snapshot", { enumerable: true, get: function () { return snapshot_1.snapshot; } });
+var query_1 = require("./query");
+Object.defineProperty(exports, "query", { enumerable: true, get: function () { return query_1.query; } });
+Object.defineProperty(exports, "find", { enumerable: true, get: function () { return query_1.find; } });
+Object.defineProperty(exports, "parseSelector", { enumerable: true, get: function () { return query_1.parseSelector; } });
+var actions_1 = require("./actions");
+Object.defineProperty(exports, "click", { enumerable: true, get: function () { return actions_1.click; } });
+Object.defineProperty(exports, "typeText", { enumerable: true, get: function () { return actions_1.typeText; } });
+Object.defineProperty(exports, "press", { enumerable: true, get: function () { return actions_1.press; } });
+Object.defineProperty(exports, "clickRect", { enumerable: true, get: function () { return actions_1.clickRect; } });
+var wait_1 = require("./wait");
+Object.defineProperty(exports, "waitFor", { enumerable: true, get: function () { return wait_1.waitFor; } });
+var expect_1 = require("./expect");
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return expect_1.expect; } });
+Object.defineProperty(exports, "Expectation", { enumerable: true, get: function () { return expect_1.Expectation; } });
+var inspector_1 = require("./inspector");
+Object.defineProperty(exports, "Inspector", { enumerable: true, get: function () { return inspector_1.Inspector; } });
+Object.defineProperty(exports, "inspect", { enumerable: true, get: function () { return inspector_1.inspect; } });
+var recorder_1 = require("./recorder");
+Object.defineProperty(exports, "Recorder", { enumerable: true, get: function () { return recorder_1.Recorder; } });
+Object.defineProperty(exports, "record", { enumerable: true, get: function () { return recorder_1.record; } });
+var generator_1 = require("./generator");
+Object.defineProperty(exports, "ScriptGenerator", { enumerable: true, get: function () { return generator_1.ScriptGenerator; } });
+Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generator_1.generate; } });
+var read_1 = require("./read");
+Object.defineProperty(exports, "read", { enumerable: true, get: function () { return read_1.read; } });
+var screenshot_1 = require("./screenshot");
+Object.defineProperty(exports, "screenshot", { enumerable: true, get: function () { return screenshot_1.screenshot; } });
+__exportStar(require("./types"), exports);
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "saveStorageState", { enumerable: true, get: function () { return utils_1.saveStorageState; } });
+// Agent Layer (v0.2.0+)
+var llm_provider_1 = require("./llm-provider");
+Object.defineProperty(exports, "LLMProvider", { enumerable: true, get: function () { return llm_provider_1.LLMProvider; } });
+Object.defineProperty(exports, "OpenAIProvider", { enumerable: true, get: function () { return llm_provider_1.OpenAIProvider; } });
+Object.defineProperty(exports, "AnthropicProvider", { enumerable: true, get: function () { return llm_provider_1.AnthropicProvider; } });
+var agent_1 = require("./agent");
+Object.defineProperty(exports, "SentienceAgent", { enumerable: true, get: function () { return agent_1.SentienceAgent; } });
+// Conversational Agent Layer (v0.3.0+)
+var conversational_agent_1 = require("./conversational-agent");
+Object.defineProperty(exports, "ConversationalAgent", { enumerable: true, get: function () { return conversational_agent_1.ConversationalAgent; } });
+// Tracing Layer (v0.3.1+)
+var tracing_1 = require("./tracing");
+Object.defineProperty(exports, "Tracer", { enumerable: true, get: function () { return tracing_1.Tracer; } });
+Object.defineProperty(exports, "TraceSink", { enumerable: true, get: function () { return tracing_1.TraceSink; } });
+Object.defineProperty(exports, "JsonlTraceSink", { enumerable: true, get: function () { return tracing_1.JsonlTraceSink; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA;AACzB,uCAAuD;AAA9C,oGAAA,QAAQ,OAAA;AACjB,iCAAqD;AAA5C,8FAAA,KAAK,OAAA;AAAE,6FAAA,IAAI,OAAA;AAAE,sGAAA,aAAa,OAAA;AACnC,qCAAyE;AAAhE,gGAAA,KAAK,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,gGAAA,KAAK,OAAA;AAAE,oGAAA,SAAS,OAAA;AAC1C,+BAAiC;AAAxB,+FAAA,OAAO,OAAA;AAChB,mCAA+C;AAAtC,gGAAA,MAAM,OAAA;AAAE,qGAAA,WAAW,OAAA;AAC5B,yCAAiD;AAAxC,sGAAA,SAAS,OAAA;AAAE,oGAAA,OAAO,OAAA;AAC3B,uCAAgE;AAAvD,oGAAA,QAAQ,OAAA;AAAoB,kGAAA,MAAM,OAAA;AAC3C,yCAAwD;AAA/C,4GAAA,eAAe,OAAA;AAAE,qGAAA,QAAQ,OAAA;AAClC,+BAAuD;AAA9C,4FAAA,IAAI,OAAA;AACb,2CAA6D;AAApD,wGAAA,UAAU,OAAA;AACnB,0CAAwB;AACxB,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA;AAEzB,wBAAwB;AACxB,+CAKwB;AAJtB,2GAAA,WAAW,OAAA;AAEX,8GAAA,cAAc,OAAA;AACd,iHAAA,iBAAiB,OAAA;AAEnB,iCAKiB;AAJf,uGAAA,cAAc,OAAA;AAMhB,uCAAuC;AACvC,+DAQgC;AAP9B,2HAAA,mBAAmB,OAAA;AASrB,0BAA0B;AAC1B,qCAMmB;AALjB,iGAAA,MAAM,OAAA;AACN,oGAAA,SAAS,OAAA;AACT,yGAAA,cAAc,OAAA"}

package/dist/inspector.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Inspector tool - helps developers see what the agent "sees"
+ */
+import { SentienceBrowser } from './browser';
+export declare class Inspector {
+    private browser;
+    private active;
+    constructor(browser: SentienceBrowser);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare function inspect(browser: SentienceBrowser): Inspector;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../src/inspector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,qBAAa,SAAS;IAGR,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,MAAM,CAAkB;gBAEZ,OAAO,EAAE,gBAAgB;IAEvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2ItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAW5B;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAE5D"}

package/dist/inspector.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Inspector tool - helps developers see what the agent "sees"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Inspector = void 0;
+exports.inspect = inspect;
+class Inspector {
+    constructor(browser) {
+        this.browser = browser;
+        this.active = false;
+    }
+    async start() {
+        const page = this.browser.getPage();
+        this.active = true;
+        // Inject inspector script into page
+        await page.evaluate(() => {
+            // Remove existing inspector if any
+            if (window.__sentience_inspector_active) {
+                return;
+            }
+            window.__sentience_inspector_active = true;
+            window.__sentience_last_element_id = null;
+            // Get element at point
+            function getElementAtPoint(x, y) {
+                const el = document.elementFromPoint(x, y);
+                if (!el)
+                    return null;
+                // Find element in registry
+                const registry = window.sentience_registry;
+                if (registry) {
+                    for (let i = 0; i < registry.length; i++) {
+                        if (registry[i] === el) {
+                            return i;
+                        }
+                    }
+                }
+                return null;
+            }
+            // Mouse move handler
+            function handleMouseMove(e) {
+                if (!window.__sentience_inspector_active)
+                    return;
+                const elementId = getElementAtPoint(e.clientX, e.clientY);
+                if (elementId === null || elementId === window.__sentience_last_element_id) {
+                    return;
+                }
+                window.__sentience_last_element_id = elementId;
+                // Get element info from snapshot if available
+                const sentience = window.sentience;
+                const registry = window.sentience_registry;
+                if (sentience && registry) {
+                    const el = registry[elementId];
+                    if (el) {
+                        const rect = el.getBoundingClientRect();
+                        const text = el.getAttribute('aria-label') ||
+                            el.value ||
+                            el.placeholder ||
+                            el.alt ||
+                            (el.innerText || '').substring(0, 50);
+                        const role = el.getAttribute('role') || el.tagName.toLowerCase();
+                        console.log(`[Sentience Inspector] Element #${elementId}: role=${role}, text="${text}", bbox=(${Math.round(rect.x)}, ${Math.round(rect.y)}, ${Math.round(rect.width)}, ${Math.round(rect.height)})`);
+                    }
+                }
+            }
+            // Click handler
+            function handleClick(e) {
+                if (!window.__sentience_inspector_active)
+                    return;
+                e.preventDefault();
+                e.stopPropagation();
+                const elementId = getElementAtPoint(e.clientX, e.clientY);
+                if (elementId === null)
+                    return;
+                // Get full element info
+                const sentience = window.sentience;
+                const registry = window.sentience_registry;
+                if (sentience && registry) {
+                    const el = registry[elementId];
+                    if (el) {
+                        const rect = el.getBoundingClientRect();
+                        const info = {
+                            id: elementId,
+                            tag: el.tagName.toLowerCase(),
+                            role: el.getAttribute('role') || 'generic',
+                            text: el.getAttribute('aria-label') ||
+                                el.value ||
+                                el.placeholder ||
+                                el.alt ||
+                                (el.innerText || '').substring(0, 100),
+                            bbox: {
+                                x: Math.round(rect.x),
+                                y: Math.round(rect.y),
+                                width: Math.round(rect.width),
+                                height: Math.round(rect.height),
+                            },
+                            attributes: {
+                                id: el.id || null,
+                                class: el.className || null,
+                                name: el.name || null,
+                                type: el.type || null,
+                            },
+                        };
+                        console.log('[Sentience Inspector] Clicked element:', JSON.stringify(info, null, 2));
+                        // Also try to get from snapshot if available
+                        if (sentience && sentience.snapshot) {
+                            sentience
+                                .snapshot({ limit: 100 })
+                                .then((snap) => {
+                                const element = snap.elements.find((el) => el.id === elementId);
+                                if (element) {
+                                    console.log('[Sentience Inspector] Snapshot element:', JSON.stringify(element, null, 2));
+                                }
+                            })
+                                .catch(() => { });
+                        }
+                    }
+                }
+            }
+            // Add event listeners
+            document.addEventListener('mousemove', handleMouseMove, true);
+            document.addEventListener('click', handleClick, true);
+            // Store cleanup function
+            window.__sentience_inspector_cleanup = () => {
+                document.removeEventListener('mousemove', handleMouseMove, true);
+                document.removeEventListener('click', handleClick, true);
+                window.__sentience_inspector_active = false;
+            };
+            console.log('[Sentience Inspector] ✅ Inspection mode active. Hover elements to see info, click to see full details.');
+        });
+    }
+    async stop() {
+        const page = this.browser.getPage();
+        this.active = false;
+        // Cleanup inspector
+        await page.evaluate(() => {
+            if (window.__sentience_inspector_cleanup) {
+                window.__sentience_inspector_cleanup();
+            }
+        });
+    }
+}
+exports.Inspector = Inspector;
+function inspect(browser) {
+    return new Inspector(browser);
+}
+//# sourceMappingURL=inspector.js.map

package/dist/inspector.js.map

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