@predicatelabs/sdk 0.99.9

package/dist/query.js

@@ -0,0 +1,482 @@
+"use strict";
+/**
+ * Query engine v1 - semantic selector matching
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSelector = parseSelector;
+exports.query = query;
+exports.find = find;
+/**
+ * Parse a selector string into a QuerySelectorObject
+ *
+ * Supports operators: =, !=, ~, ^=, $=, >, >=, <, <=
+ * Supports dot notation: attr.id, css.color, bbox.x
+ *
+ * @param selector - Selector string (e.g., "role=button", "text~search", "importance>0.5")
+ * @returns Parsed query object
+ *
+ * @example
+ * ```typescript
+ * const query = parseSelector('role=button clickable=true importance>0.5');
+ * // Returns: { role: 'button', clickable: true, importance_min: 0.5 }
+ * ```
+ */
+function parseSelector(selector) {
+    const query = {};
+    // Match patterns like: key=value, key~'value', key!="value", key>123, key^='prefix', key$='suffix'
+    // Updated regex to support: =, !=, ~, ^=, $=, >, >=, <, <=
+    // Supports dot notation: attr.id, css.color
+    // Note: Handle ^= and $= first (before single char operators) to avoid regex conflicts
+    const pattern = /([\w.]+)(\^=|\$=|>=|<=|!=|[=~<>])((?:'[^']+'|"[^"]+"|[^\s]+))/g;
+    let match;
+    while ((match = pattern.exec(selector)) !== null) {
+        const key = match[1];
+        const op = match[2];
+        let value = match[3];
+        // Remove quotes from value
+        value = value.replace(/^["']|["']$/g, '');
+        // Handle numeric comparisons
+        let isNumeric = false;
+        let numericValue = 0;
+        const parsedNum = parseFloat(value);
+        if (!isNaN(parsedNum) && isFinite(parsedNum)) {
+            isNumeric = true;
+            numericValue = parsedNum;
+        }
+        if (op === '!=') {
+            if (key === 'role') {
+                query.role_exclude = value;
+            }
+            else if (key === 'clickable') {
+                query.clickable = false;
+            }
+            else if (key === 'visible') {
+                query.visible = false;
+            }
+        }
+        else if (op === '~') {
+            // Substring match (case-insensitive)
+            if (key === 'text') {
+                query.text_contains = value;
+            }
+            else if (key === 'name') {
+                query.name_contains = value;
+            }
+            else if (key === 'value') {
+                query.value_contains = value;
+            }
+        }
+        else if (op === '^=') {
+            // Prefix match
+            if (key === 'text') {
+                query.text_prefix = value;
+            }
+            else if (key === 'name') {
+                query.name_prefix = value;
+            }
+            else if (key === 'value') {
+                query.value_prefix = value;
+            }
+        }
+        else if (op === '$=') {
+            // Suffix match
+            if (key === 'text') {
+                query.text_suffix = value;
+            }
+            else if (key === 'name') {
+                query.name_suffix = value;
+            }
+            else if (key === 'value') {
+                query.value_suffix = value;
+            }
+        }
+        else if (op === '>') {
+            // Greater than
+            if (isNumeric) {
+                if (key === 'importance') {
+                    query.importance_min = numericValue + 0.0001; // Exclusive
+                }
+                else if (key.startsWith('bbox.')) {
+                    query[`${key}_min`] = numericValue + 0.0001;
+                }
+                else if (key === 'z_index') {
+                    query.z_index_min = numericValue + 0.0001;
+                }
+            }
+            else if (key.startsWith('attr.') || key.startsWith('css.')) {
+                query[`${key}_gt`] = value;
+            }
+        }
+        else if (op === '>=') {
+            // Greater than or equal
+            if (isNumeric) {
+                if (key === 'importance') {
+                    query.importance_min = numericValue;
+                }
+                else if (key.startsWith('bbox.')) {
+                    query[`${key}_min`] = numericValue;
+                }
+                else if (key === 'z_index') {
+                    query.z_index_min = numericValue;
+                }
+            }
+            else if (key.startsWith('attr.') || key.startsWith('css.')) {
+                query[`${key}_gte`] = value;
+            }
+        }
+        else if (op === '<') {
+            // Less than
+            if (isNumeric) {
+                if (key === 'importance') {
+                    query.importance_max = numericValue - 0.0001; // Exclusive
+                }
+                else if (key.startsWith('bbox.')) {
+                    query[`${key}_max`] = numericValue - 0.0001;
+                }
+                else if (key === 'z_index') {
+                    query.z_index_max = numericValue - 0.0001;
+                }
+            }
+            else if (key.startsWith('attr.') || key.startsWith('css.')) {
+                query[`${key}_lt`] = value;
+            }
+        }
+        else if (op === '<=') {
+            // Less than or equal
+            if (isNumeric) {
+                if (key === 'importance') {
+                    query.importance_max = numericValue;
+                }
+                else if (key.startsWith('bbox.')) {
+                    query[`${key}_max`] = numericValue;
+                }
+                else if (key === 'z_index') {
+                    query.z_index_max = numericValue;
+                }
+            }
+            else if (key.startsWith('attr.') || key.startsWith('css.')) {
+                query[`${key}_lte`] = value;
+            }
+        }
+        else if (op === '=') {
+            // Exact match
+            if (key === 'role') {
+                query.role = value;
+            }
+            else if (key === 'clickable') {
+                query.clickable = value.toLowerCase() === 'true';
+            }
+            else if (key === 'visible') {
+                query.visible = value.toLowerCase() === 'true';
+            }
+            else if (key === 'tag') {
+                query.tag = value;
+            }
+            else if (key === 'text') {
+                query.text = value;
+            }
+            else if (key === 'name') {
+                query.name = value;
+            }
+            else if (key === 'value') {
+                query.value = value;
+            }
+            else if (key === 'checked' || key === 'disabled' || key === 'expanded') {
+                query[key] = value.toLowerCase() === 'true';
+            }
+            else if (key === 'importance' && isNumeric) {
+                query.importance = numericValue;
+            }
+            else if (key.startsWith('attr.')) {
+                // Dot notation for attributes: attr.id="submit-btn"
+                const attrKey = key.substring(5); // Remove "attr." prefix
+                if (!query.attr) {
+                    query.attr = {};
+                }
+                query.attr[attrKey] = value;
+            }
+            else if (key.startsWith('css.')) {
+                // Dot notation for CSS: css.color="red"
+                const cssKey = key.substring(4); // Remove "css." prefix
+                if (!query.css) {
+                    query.css = {};
+                }
+                query.css[cssKey] = value;
+            }
+        }
+    }
+    return query;
+}
+function matchElement(element, query) {
+    // Role exact match
+    if (query.role !== undefined) {
+        if (element.role !== query.role) {
+            return false;
+        }
+    }
+    // Role exclusion
+    if (query.role_exclude !== undefined) {
+        if (element.role === query.role_exclude) {
+            return false;
+        }
+    }
+    // Clickable
+    if (query.clickable !== undefined) {
+        if (element.visual_cues.is_clickable !== query.clickable) {
+            return false;
+        }
+    }
+    // Visible (using in_viewport and !is_occluded)
+    if (query.visible !== undefined) {
+        const isVisible = element.in_viewport && !element.is_occluded;
+        if (isVisible !== query.visible) {
+            return false;
+        }
+    }
+    // Tag (not yet in Element model, but prepare for future)
+    if (query.tag !== undefined) {
+        // For now, this will always fail since tag is not in Element model
+        // This is a placeholder for future implementation
+    }
+    // Text exact match
+    if (query.text !== undefined) {
+        if (!element.text || element.text !== query.text) {
+            return false;
+        }
+    }
+    // Text contains (case-insensitive)
+    if (query.text_contains !== undefined) {
+        if (!element.text) {
+            return false;
+        }
+        if (!element.text.toLowerCase().includes(query.text_contains.toLowerCase())) {
+            return false;
+        }
+    }
+    // Text prefix match
+    if (query.text_prefix !== undefined) {
+        if (!element.text) {
+            return false;
+        }
+        if (!element.text.toLowerCase().startsWith(query.text_prefix.toLowerCase())) {
+            return false;
+        }
+    }
+    // Text suffix match
+    if (query.text_suffix !== undefined) {
+        if (!element.text) {
+            return false;
+        }
+        if (!element.text.toLowerCase().endsWith(query.text_suffix.toLowerCase())) {
+            return false;
+        }
+    }
+    // Name matching (best-effort; fallback to text for backward compatibility)
+    const nameVal = element.name ?? element.text ?? '';
+    if (query.name !== undefined) {
+        if (!nameVal || nameVal !== query.name) {
+            return false;
+        }
+    }
+    if (query.name_contains !== undefined) {
+        if (!nameVal || !nameVal.toLowerCase().includes(query.name_contains.toLowerCase())) {
+            return false;
+        }
+    }
+    if (query.name_prefix !== undefined) {
+        if (!nameVal || !nameVal.toLowerCase().startsWith(query.name_prefix.toLowerCase())) {
+            return false;
+        }
+    }
+    if (query.name_suffix !== undefined) {
+        if (!nameVal || !nameVal.toLowerCase().endsWith(query.name_suffix.toLowerCase())) {
+            return false;
+        }
+    }
+    // Value matching (inputs/textarea/select)
+    const valueVal = element.value ?? null;
+    if (query.value !== undefined) {
+        if (valueVal === null || valueVal !== query.value) {
+            return false;
+        }
+    }
+    if (query.value_contains !== undefined) {
+        if (valueVal === null || !valueVal.toLowerCase().includes(query.value_contains.toLowerCase())) {
+            return false;
+        }
+    }
+    if (query.value_prefix !== undefined) {
+        if (valueVal === null || !valueVal.toLowerCase().startsWith(query.value_prefix.toLowerCase())) {
+            return false;
+        }
+    }
+    if (query.value_suffix !== undefined) {
+        if (valueVal === null || !valueVal.toLowerCase().endsWith(query.value_suffix.toLowerCase())) {
+            return false;
+        }
+    }
+    // State matching (best-effort)
+    if (query.checked !== undefined) {
+        if ((element.checked === true) !== query.checked) {
+            return false;
+        }
+    }
+    if (query.disabled !== undefined) {
+        if ((element.disabled === true) !== query.disabled) {
+            return false;
+        }
+    }
+    if (query.expanded !== undefined) {
+        if ((element.expanded === true) !== query.expanded) {
+            return false;
+        }
+    }
+    // Importance filtering
+    if (query.importance !== undefined) {
+        if (element.importance !== query.importance) {
+            return false;
+        }
+    }
+    if (query.importance_min !== undefined) {
+        if (element.importance < query.importance_min) {
+            return false;
+        }
+    }
+    if (query.importance_max !== undefined) {
+        if (element.importance > query.importance_max) {
+            return false;
+        }
+    }
+    // BBox filtering (spatial)
+    if (query['bbox.x_min'] !== undefined) {
+        if (element.bbox.x < query['bbox.x_min']) {
+            return false;
+        }
+    }
+    if (query['bbox.x_max'] !== undefined) {
+        if (element.bbox.x > query['bbox.x_max']) {
+            return false;
+        }
+    }
+    if (query['bbox.y_min'] !== undefined) {
+        if (element.bbox.y < query['bbox.y_min']) {
+            return false;
+        }
+    }
+    if (query['bbox.y_max'] !== undefined) {
+        if (element.bbox.y > query['bbox.y_max']) {
+            return false;
+        }
+    }
+    if (query['bbox.width_min'] !== undefined) {
+        if (element.bbox.width < query['bbox.width_min']) {
+            return false;
+        }
+    }
+    if (query['bbox.width_max'] !== undefined) {
+        if (element.bbox.width > query['bbox.width_max']) {
+            return false;
+        }
+    }
+    if (query['bbox.height_min'] !== undefined) {
+        if (element.bbox.height < query['bbox.height_min']) {
+            return false;
+        }
+    }
+    if (query['bbox.height_max'] !== undefined) {
+        if (element.bbox.height > query['bbox.height_max']) {
+            return false;
+        }
+    }
+    // Z-index filtering
+    if (query.z_index_min !== undefined) {
+        if (element.z_index < query.z_index_min) {
+            return false;
+        }
+    }
+    if (query.z_index_max !== undefined) {
+        if (element.z_index > query.z_index_max) {
+            return false;
+        }
+    }
+    // In viewport filtering
+    if (query.in_viewport !== undefined) {
+        if (element.in_viewport !== query.in_viewport) {
+            return false;
+        }
+    }
+    // Occlusion filtering
+    if (query.is_occluded !== undefined) {
+        if (element.is_occluded !== query.is_occluded) {
+            return false;
+        }
+    }
+    // Attribute filtering (dot notation: attr.id="submit-btn")
+    if (query.attr !== undefined) {
+        // This requires DOM access, which is not available in the Element model
+        // This is a placeholder for future implementation when we add DOM access
+    }
+    // CSS property filtering (dot notation: css.color="red")
+    if (query.css !== undefined) {
+        // This requires DOM access, which is not available in the Element model
+        // This is a placeholder for future implementation when we add DOM access
+    }
+    return true;
+}
+/**
+ * Query elements from a snapshot using a selector
+ *
+ * @param snapshot - Snapshot containing elements to query
+ * @param selector - Query selector (string DSL or object)
+ * @returns Array of matching elements, sorted by importance (descending)
+ *
+ * @example
+ * ```typescript
+ * const snap = await snapshot(browser);
+ *
+ * // String selector
+ * const buttons = query(snap, 'role=button');
+ * const clickable = query(snap, 'clickable=true');
+ *
+ * // Object selector
+ * const results = query(snap, {
+ *   role: 'button',
+ *   importance_min: 0.5
+ * });
+ * ```
+ */
+function query(snapshot, selector) {
+    // Parse selector if string
+    const queryObj = typeof selector === 'string' ? parseSelector(selector) : selector;
+    // Filter elements
+    const matches = snapshot.elements.filter(el => matchElement(el, queryObj));
+    // Sort by importance (descending)
+    matches.sort((a, b) => b.importance - a.importance);
+    return matches;
+}
+/**
+ * Find the first element matching a selector
+ *
+ * @param snapshot - Snapshot containing elements to search
+ * @param selector - Query selector (string DSL or object)
+ * @returns First matching element, or null if none found
+ *
+ * @example
+ * ```typescript
+ * const snap = await snapshot(browser);
+ *
+ * // Find first button
+ * const button = find(snap, 'role=button');
+ * if (button) {
+ *   await click(browser, button.id);
+ * }
+ *
+ * // Find element by text
+ * const searchBox = find(snap, 'text~search');
+ * ```
+ */
+function find(snapshot, selector) {
+    const results = query(snapshot, selector);
+    return results[0] || null;
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

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

package/dist/read.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Read page content - supports raw HTML, text, and markdown formats
+ */
+import { ZodTypeAny } from 'zod';
+import { SentienceBrowser } from './browser';
+import { LLMProvider } from './llm-provider';
+import type { ExtractResult } from './types';
+export interface ReadOptions {
+    format?: 'raw' | 'text' | 'markdown';
+    enhanceMarkdown?: boolean;
+}
+export interface ReadResult {
+    status: 'success' | 'error';
+    url: string;
+    format: 'raw' | 'text' | 'markdown';
+    content: string;
+    length: number;
+    error?: string;
+}
+/**
+ * Read page content as raw HTML, text, or markdown
+ *
+ * @param browser - SentienceBrowser instance
+ * @param options - Read options
+ * @returns ReadResult with page content
+ *
+ * @example
+ * // Get raw HTML (default)
+ * const result = await read(browser);
+ * const htmlContent = result.content;
+ *
+ * @example
+ * // Get high-quality markdown (uses Turndown internally)
+ * const result = await read(browser, { format: 'markdown' });
+ * const markdown = result.content;
+ *
+ * @example
+ * // Get plain text
+ * const result = await read(browser, { format: 'text' });
+ * const text = result.content;
+ */
+export declare function read(browser: SentienceBrowser, options?: ReadOptions): Promise<ReadResult>;
+/**
+ * Extract structured data from the current page using read() markdown + LLM.
+ */
+export declare function extract(browser: SentienceBrowser, llm: LLMProvider, query: string, schema?: ZodTypeAny, maxChars?: number): Promise<ExtractResult>;
+//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAoErB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,UAAU,EACnB,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CA2BxB"}

package/dist/read.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Read page content - supports raw HTML, text, and markdown formats
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.read = read;
+exports.extract = extract;
+const turndown_1 = __importDefault(require("turndown"));
+const browser_evaluator_1 = require("./utils/browser-evaluator");
+const zod_1 = require("./utils/zod");
+function extractJsonPayload(text) {
+    const fenced = text.match(/```json\s*(\{[\s\S]*?\})\s*```/i);
+    if (fenced && fenced[1]) {
+        return JSON.parse(fenced[1]);
+    }
+    const inline = text.match(/(\{[\s\S]*\})/);
+    if (inline && inline[1]) {
+        return JSON.parse(inline[1]);
+    }
+    return JSON.parse(text);
+}
+/**
+ * Read page content as raw HTML, text, or markdown
+ *
+ * @param browser - SentienceBrowser instance
+ * @param options - Read options
+ * @returns ReadResult with page content
+ *
+ * @example
+ * // Get raw HTML (default)
+ * const result = await read(browser);
+ * const htmlContent = result.content;
+ *
+ * @example
+ * // Get high-quality markdown (uses Turndown internally)
+ * const result = await read(browser, { format: 'markdown' });
+ * const markdown = result.content;
+ *
+ * @example
+ * // Get plain text
+ * const result = await read(browser, { format: 'text' });
+ * const text = result.content;
+ */
+async function read(browser, options = {}) {
+    const page = browser.getPage();
+    if (!page) {
+        throw new Error('Browser not started. Call start() first.');
+    }
+    const format = options.format || 'raw'; // Default to 'raw' for Turndown compatibility
+    const enhanceMarkdown = options.enhanceMarkdown !== false; // Default to true
+    if (format === 'markdown' && enhanceMarkdown) {
+        // Get raw HTML from the extension first
+        const rawHtmlResult = (await browser_evaluator_1.BrowserEvaluator.evaluate(page, opts => window.sentience.read(opts), { format: 'raw' }));
+        if (rawHtmlResult.status === 'success') {
+            const htmlContent = rawHtmlResult.content;
+            try {
+                const turndownService = new turndown_1.default({
+                    headingStyle: 'atx',
+                    hr: '---',
+                    bulletListMarker: '-',
+                    codeBlockStyle: 'fenced',
+                    emDelimiter: '*',
+                });
+                // Add custom rules for better markdown
+                turndownService.addRule('strikethrough', {
+                    filter: node => ['s', 'del', 'strike'].includes(node.nodeName.toLowerCase()),
+                    replacement: function (content) {
+                        return '~~' + content + '~~';
+                    },
+                });
+                // Optionally strip certain tags entirely
+                turndownService.remove(['script', 'style', 'noscript', 'iframe']);
+                const markdownContent = turndownService.turndown(htmlContent);
+                return {
+                    status: 'success',
+                    url: rawHtmlResult.url,
+                    format: 'markdown',
+                    content: markdownContent,
+                    length: markdownContent.length,
+                };
+            }
+            catch (e) {
+                console.warn(`Turndown conversion failed: ${e.message}, falling back to extension's markdown.`);
+                // Fallback to extension's markdown if Turndown fails
+            }
+        }
+        else {
+            console.warn(`Failed to get raw HTML from extension: ${rawHtmlResult.error}, falling back to extension's markdown.`);
+            // Fallback to extension's markdown if getting raw HTML fails
+        }
+    }
+    // If not enhanced markdown, or fallback, call extension with requested format
+    const result = (await browser_evaluator_1.BrowserEvaluator.evaluate(page, opts => window.sentience.read(opts), { format }));
+    return result;
+}
+/**
+ * Extract structured data from the current page using read() markdown + LLM.
+ */
+async function extract(browser, llm, query, schema, maxChars = 12000) {
+    const result = await read(browser, { format: 'markdown', enhanceMarkdown: true });
+    if (result.status !== 'success') {
+        return { ok: false, error: result.error ?? 'read failed' };
+    }
+    const content = result.content.slice(0, maxChars);
+    const schemaDesc = schema ? JSON.stringify((0, zod_1.zodToJsonSchema)(schema)) : '';
+    const system = 'You extract structured data from markdown content. Return only JSON. No prose.';
+    const user = `QUERY:\n${query}\n\nSCHEMA:\n${schemaDesc}\n\nCONTENT:\n${content}`;
+    const response = await llm.generate(system, user);
+    const raw = response.content.trim();
+    if (!schema) {
+        return { ok: true, data: { text: raw }, raw };
+    }
+    try {
+        const payload = extractJsonPayload(raw);
+        const parsed = schema.safeParse(payload);
+        if (!parsed.success) {
+            return { ok: false, error: parsed.error.message, raw };
+        }
+        return { ok: true, data: parsed.data, raw };
+    }
+    catch (err) {
+        return { ok: false, error: String(err?.message ?? err), raw };
+    }
+}
+//# sourceMappingURL=read.js.map