sentienceapi 0.90.1

package/dist/llm-provider.d.ts

@@ -0,0 +1,60 @@
+/**
+ * LLM Provider Abstraction - BYOB (Bring Your Own Brain)
+ * Enables pluggable LLM support for SentienceAgent
+ */
+/**
+ * Response from LLM provider
+ */
+export interface LLMResponse {
+    content: string;
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    modelName?: string;
+}
+/**
+ * Abstract base class for LLM providers
+ * Implement this to integrate any LLM (OpenAI, Anthropic, Local, etc.)
+ */
+export declare abstract class LLMProvider {
+    /**
+     * Generate LLM response from prompts
+     * @param systemPrompt - System/instruction prompt
+     * @param userPrompt - User query prompt
+     * @param options - Additional provider-specific options
+     */
+    abstract generate(systemPrompt: string, userPrompt: string, options?: Record<string, any>): Promise<LLMResponse>;
+    /**
+     * Whether this provider supports JSON mode (structured output)
+     */
+    abstract supportsJsonMode(): boolean;
+    /**
+     * Get the model name/identifier
+     */
+    abstract get modelName(): string;
+}
+/**
+ * OpenAI Provider (GPT-4, GPT-4o, etc.)
+ * Requires: npm install openai
+ */
+export declare class OpenAIProvider extends LLMProvider {
+    private client;
+    private _modelName;
+    constructor(apiKey: string, model?: string);
+    generate(systemPrompt: string, userPrompt: string, options?: Record<string, any>): Promise<LLMResponse>;
+    supportsJsonMode(): boolean;
+    get modelName(): string;
+}
+/**
+ * Anthropic Provider (Claude 3.5 Sonnet, etc.)
+ * Requires: npm install @anthropic-ai/sdk
+ */
+export declare class AnthropicProvider extends LLMProvider {
+    private client;
+    private _modelName;
+    constructor(apiKey: string, model?: string);
+    generate(systemPrompt: string, userPrompt: string, options?: Record<string, any>): Promise<LLMResponse>;
+    supportsJsonMode(): boolean;
+    get modelName(): string;
+}
+//# sourceMappingURL=llm-provider.d.ts.map

package/dist/llm-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,8BAAsB,WAAW;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,IAAI,OAAO;IAEpC;;OAEG;IACH,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAiB;IAiB9C,QAAQ,CACZ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAChC,OAAO,CAAC,WAAW,CAAC;IAqBvB,gBAAgB,IAAI,OAAO;IAI3B,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAqC;IAgBlE,QAAQ,CACZ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAChC,OAAO,CAAC,WAAW,CAAC;IAsBvB,gBAAgB,IAAI,OAAO;IAK3B,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/llm-provider.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * LLM Provider Abstraction - BYOB (Bring Your Own Brain)
+ * Enables pluggable LLM support for SentienceAgent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicProvider = exports.OpenAIProvider = exports.LLMProvider = void 0;
+/**
+ * Abstract base class for LLM providers
+ * Implement this to integrate any LLM (OpenAI, Anthropic, Local, etc.)
+ */
+class LLMProvider {
+}
+exports.LLMProvider = LLMProvider;
+/**
+ * OpenAI Provider (GPT-4, GPT-4o, etc.)
+ * Requires: npm install openai
+ */
+class OpenAIProvider extends LLMProvider {
+    constructor(apiKey, model = 'gpt-4o') {
+        super();
+        // Lazy import to avoid requiring openai package if not used
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { OpenAI } = require('openai');
+            this.client = new OpenAI({ apiKey });
+        }
+        catch (error) {
+            throw new Error('OpenAI package not installed. Run: npm install openai');
+        }
+        this._modelName = model;
+    }
+    async generate(systemPrompt, userPrompt, options = {}) {
+        const response = await this.client.chat.completions.create({
+            model: this._modelName,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content: userPrompt }
+            ],
+            temperature: options.temperature ?? 0.0,
+            ...options
+        });
+        const choice = response.choices[0];
+        return {
+            content: choice.message.content || '',
+            promptTokens: response.usage?.prompt_tokens,
+            completionTokens: response.usage?.completion_tokens,
+            totalTokens: response.usage?.total_tokens,
+            modelName: this._modelName
+        };
+    }
+    supportsJsonMode() {
+        return true;
+    }
+    get modelName() {
+        return this._modelName;
+    }
+}
+exports.OpenAIProvider = OpenAIProvider;
+/**
+ * Anthropic Provider (Claude 3.5 Sonnet, etc.)
+ * Requires: npm install @anthropic-ai/sdk
+ */
+class AnthropicProvider extends LLMProvider {
+    constructor(apiKey, model = 'claude-3-5-sonnet-20241022') {
+        super();
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { Anthropic } = require('@anthropic-ai/sdk');
+            this.client = new Anthropic({ apiKey });
+        }
+        catch (error) {
+            throw new Error('Anthropic SDK not installed. Run: npm install @anthropic-ai/sdk');
+        }
+        this._modelName = model;
+    }
+    async generate(systemPrompt, userPrompt, options = {}) {
+        const response = await this.client.messages.create({
+            model: this._modelName,
+            max_tokens: options.max_tokens ?? 1024,
+            system: systemPrompt,
+            messages: [
+                { role: 'user', content: userPrompt }
+            ],
+            temperature: options.temperature ?? 0.0,
+            ...options
+        });
+        const content = response.content[0].text;
+        return {
+            content,
+            promptTokens: response.usage?.input_tokens,
+            completionTokens: response.usage?.output_tokens,
+            totalTokens: (response.usage?.input_tokens || 0) + (response.usage?.output_tokens || 0),
+            modelName: this._modelName
+        };
+    }
+    supportsJsonMode() {
+        // Claude supports structured output but not via "json_mode" flag
+        return false;
+    }
+    get modelName() {
+        return this._modelName;
+    }
+}
+exports.AnthropicProvider = AnthropicProvider;
+//# sourceMappingURL=llm-provider.js.map

package/dist/llm-provider.js.map

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

package/dist/query.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Query engine v1 - semantic selector matching
+ */
+import { Snapshot, Element, QuerySelector, QuerySelectorObject } from './types';
+export declare function parseSelector(selector: string): QuerySelectorObject;
+export declare function query(snapshot: Snapshot, selector: QuerySelector): Element[];
+export declare function find(snapshot: Snapshot, selector: QuerySelector): Element | null;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEhF,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAsJnE;AAiMD,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,EAAE,CAW5E;AAED,wBAAgB,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI,CAGhF"}

package/dist/query.js

@@ -0,0 +1,337 @@
+"use strict";
+/**
+ * Query engine v1 - semantic selector matching
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSelector = parseSelector;
+exports.query = query;
+exports.find = find;
+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' || key === 'name') {
+                query.text_contains = value;
+            }
+        }
+        else if (op === '^=') {
+            // Prefix match
+            if (key === 'text' || key === 'name') {
+                query.text_prefix = value;
+            }
+        }
+        else if (op === '$=') {
+            // Suffix match
+            if (key === 'text' || key === 'name') {
+                query.text_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 === 'name' || key === 'text') {
+                query.text = value;
+            }
+            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;
+        }
+    }
+    // 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;
+}
+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;
+}
+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,40 @@
+/**
+ * Read page content - supports raw HTML, text, and markdown formats
+ */
+import { SentienceBrowser } from './browser';
+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>;
+//# 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,gBAAgB,EAAE,MAAM,WAAW,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;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA+DrB"}

package/dist/read.js

@@ -0,0 +1,86 @@
+"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;
+const turndown_1 = __importDefault(require("turndown"));
+/**
+ * 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();
+    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 page.evaluate((opts) => {
+            return 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 page.evaluate((opts) => {
+        return window.sentience.read(opts);
+    }, { format }));
+    return result;
+}
+//# sourceMappingURL=read.js.map