@predicatelabs/sdk 0.99.9

package/dist/snapshot.js

@@ -0,0 +1,358 @@
+"use strict";
+/**
+ * Snapshot functionality - calls window.sentience.snapshot() or server-side API
+ */
+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.SnapshotGatewayError = void 0;
+exports.snapshot = snapshot;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const browser_evaluator_1 = require("./utils/browser-evaluator");
+// Maximum payload size for API requests (10MB server limit)
+const MAX_PAYLOAD_BYTES = 10 * 1024 * 1024;
+/**
+ * Structured error for server-side (gateway) snapshot failures.
+ *
+ * Keeps HTTP status/URL/response details available to callers for better logging/debugging.
+ */
+class SnapshotGatewayError extends Error {
+    constructor(message, opts) {
+        super(message);
+        this.name = 'SnapshotGatewayError';
+        this.statusCode = opts?.statusCode;
+        this.url = opts?.url;
+        this.requestId = opts?.requestId;
+        this.responseText = opts?.responseText;
+        this.cause = opts?.cause;
+    }
+    static snip(s, n = 400) {
+        if (!s)
+            return undefined;
+        const t = String(s).replace(/\r/g, ' ').replace(/\n/g, ' ').trim();
+        return t.slice(0, n);
+    }
+}
+exports.SnapshotGatewayError = SnapshotGatewayError;
+/**
+ * Save raw_elements to a JSON file for benchmarking/training
+ *
+ * @param rawElements Raw elements data from snapshot
+ * @param tracePath Path to save trace file. If undefined, uses "trace_{timestamp}.json"
+ */
+function _saveTraceToFile(rawElements, tracePath) {
+    // Default filename if none provided
+    const filename = tracePath || `trace_${Date.now()}.json`;
+    // Ensure directory exists
+    const dir = path.dirname(filename);
+    if (dir !== '.') {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Save the raw elements to JSON
+    fs.writeFileSync(filename, JSON.stringify(rawElements, null, 2));
+}
+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();
+    if (!page) {
+        throw new Error('Browser not started. Call start() first.');
+    }
+    // CRITICAL: Wait for extension injection to complete (CSP-resistant architecture)
+    // The new architecture loads injected_api.js asynchronously, so window.sentience
+    // may not be immediately available after page load
+    try {
+        await browser_evaluator_1.BrowserEvaluator.waitForCondition(page, () => typeof window.sentience !== 'undefined', 5000);
+    }
+    catch (e) {
+        throw new Error(`Sentience extension failed to inject window.sentience API. ` +
+            `Is the extension loaded? ${e instanceof Error ? e.message : String(e)}`);
+    }
+    // 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 browser_evaluator_1.BrowserEvaluator.evaluate(page, opts => window.sentience.snapshot(opts), opts);
+    // Extract screenshot format from data URL if not provided by extension
+    if (result.screenshot && !result.screenshot_format) {
+        const screenshotDataUrl = result.screenshot;
+        if (screenshotDataUrl.startsWith('data:image/')) {
+            // Extract format from "data:image/jpeg;base64,..." or "data:image/png;base64,..."
+            const formatMatch = screenshotDataUrl.split(';')[0].split('/')[1];
+            if (formatMatch === 'jpeg' || formatMatch === 'jpg') {
+                result.screenshot_format = 'jpeg';
+            }
+            else if (formatMatch === 'png') {
+                result.screenshot_format = 'png';
+            }
+        }
+    }
+    // Save trace if requested
+    if (options.save_trace && result.raw_elements) {
+        _saveTraceToFile(result.raw_elements, options.trace_path);
+    }
+    // Basic validation
+    if (result.status !== 'success' && result.status !== 'error') {
+        throw new Error(`Invalid snapshot status: ${result.status}`);
+    }
+    const snapshot = result;
+    // Show visual overlay if requested
+    if (options.show_overlay && result.raw_elements) {
+        await browser_evaluator_1.BrowserEvaluator.evaluate(page, (elements) => {
+            if (window.sentience && window.sentience.showOverlay) {
+                window.sentience.showOverlay(elements, null);
+            }
+        }, result.raw_elements);
+    }
+    // Show grid overlay if requested
+    if (options.show_grid) {
+        const { getGridBounds } = await Promise.resolve().then(() => __importStar(require('./utils/grid-utils')));
+        // Get all grids (don't filter by grid_id here - we want to show all but highlight the target)
+        const grids = getGridBounds(snapshot, undefined);
+        // Debug: Check if elements have layout data
+        const elementsWithLayout = snapshot.elements.filter(e => e.layout?.grid_id != null).length;
+        if (grids.length === 0 && elementsWithLayout === 0) {
+            console.warn('[SDK] No grids detected. Elements may not have layout data. ' +
+                'Ensure you are using use_api: false or that the API returns layout data.');
+        }
+        if (grids.length > 0) {
+            // Pass grid_id as targetGridId to highlight it in red
+            const targetGridId = options.grid_id ?? null;
+            await browser_evaluator_1.BrowserEvaluator.evaluate(page, (args) => {
+                if (window.sentience && window.sentience.showGrid) {
+                    window.sentience.showGrid(args.grids, args.targetGridId);
+                }
+                else {
+                    console.warn('[SDK] showGrid not available in extension. Make sure the extension is loaded.');
+                }
+            }, { grids, targetGridId });
+        }
+        else {
+            console.warn(`[SDK] No grids to display. Found ${elementsWithLayout} elements with layout data out of ${snapshot.elements.length} total elements.`);
+        }
+    }
+    return snapshot;
+}
+async function snapshotViaApi(browser, options, apiKey, apiUrl) {
+    const page = browser.getPage();
+    if (!page) {
+        throw new Error('Browser not started. Call start() first.');
+    }
+    const gatewayUrl = `${apiUrl}/v1/snapshot`;
+    // CRITICAL: Wait for extension injection to complete (CSP-resistant architecture)
+    // Even for API mode, we need the extension to collect raw data locally
+    try {
+        await browser_evaluator_1.BrowserEvaluator.waitForCondition(page, () => typeof window.sentience !== 'undefined', 5000);
+    }
+    catch (_e) {
+        throw new Error('Sentience extension failed to inject. Cannot collect raw data for API processing.');
+    }
+    // Step 1: Get raw data from local extension (always happens locally)
+    const rawOpts = {};
+    if (options.screenshot !== undefined) {
+        rawOpts.screenshot = options.screenshot;
+    }
+    const rawResult = await browser_evaluator_1.BrowserEvaluator.evaluate(page, opts => window.sentience.snapshot(opts), rawOpts);
+    // Save trace if requested (save raw data before API processing)
+    if (options.save_trace && rawResult.raw_elements) {
+        _saveTraceToFile(rawResult.raw_elements, options.trace_path);
+    }
+    // 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 clientMetrics = rawResult?.diagnostics?.metrics;
+    const diag = rawResult?.diagnostics;
+    const clientDiagnostics = diag?.captcha || diag?.requires_vision || diag?.requires_vision_reason
+        ? {
+            captcha: diag?.captcha,
+            requires_vision: diag?.requires_vision,
+            requires_vision_reason: diag?.requires_vision_reason,
+        }
+        : undefined;
+    const payload = {
+        raw_elements: rawResult.raw_elements || [], // Raw data needed for server processing
+        url: rawResult.url || '',
+        viewport: rawResult.viewport,
+        goal: options.goal, // Optional goal/task description
+        options: {
+            limit: options.limit,
+            filter: options.filter,
+        },
+        client_metrics: clientMetrics || undefined,
+        client_diagnostics: clientDiagnostics,
+    };
+    // Check payload size before sending (server has 10MB limit)
+    const payloadJson = JSON.stringify(payload);
+    const payloadSize = new TextEncoder().encode(payloadJson).length;
+    if (payloadSize > MAX_PAYLOAD_BYTES) {
+        const sizeMB = (payloadSize / 1024 / 1024).toFixed(2);
+        const limitMB = (MAX_PAYLOAD_BYTES / 1024 / 1024).toFixed(0);
+        throw new Error(`Payload size (${sizeMB}MB) exceeds server limit (${limitMB}MB). ` +
+            `Try reducing the number of elements on the page or filtering elements.`);
+    }
+    const headers = {
+        Authorization: `Bearer ${apiKey}`,
+        'Content-Type': 'application/json',
+    };
+    try {
+        const timeoutMs = options.gatewayTimeoutMs ?? 30000;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        let response;
+        try {
+            response = await fetch(gatewayUrl, {
+                method: 'POST',
+                headers,
+                body: payloadJson,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        if (!response.ok) {
+            let errorText = undefined;
+            try {
+                errorText = await response.text();
+            }
+            catch (_e) {
+                errorText = undefined;
+            }
+            const requestId = response.headers.get('x-request-id') || response.headers.get('x-trace-id') || undefined;
+            const bodySnip = SnapshotGatewayError.snip(errorText);
+            const parts = [];
+            parts.push(`status=${response.status}`);
+            parts.push(`url=${gatewayUrl}`);
+            if (requestId)
+                parts.push(`request_id=${requestId}`);
+            if (bodySnip)
+                parts.push(`body=${bodySnip}`);
+            throw new SnapshotGatewayError(`Server-side snapshot API failed: ${parts.join(' ')}. Try using use_api: false to use local extension instead.`, {
+                statusCode: response.status,
+                url: gatewayUrl,
+                requestId,
+                responseText: bodySnip,
+            });
+        }
+        const apiResult = await response.json();
+        // Extract screenshot format from data URL if not provided by extension
+        let screenshotFormat = rawResult.screenshot_format;
+        if (rawResult.screenshot && !screenshotFormat) {
+            const screenshotDataUrl = rawResult.screenshot;
+            if (screenshotDataUrl.startsWith('data:image/')) {
+                // Extract format from "data:image/jpeg;base64,..." or "data:image/png;base64,..."
+                const formatMatch = screenshotDataUrl.split(';')[0].split('/')[1];
+                if (formatMatch === 'jpeg' || formatMatch === 'jpg') {
+                    screenshotFormat = 'jpeg';
+                }
+                else if (formatMatch === 'png') {
+                    screenshotFormat = 'png';
+                }
+            }
+        }
+        // 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: screenshotFormat,
+            error: apiResult.error,
+            // Phase 2: Ordinal support - dominant group key from Gateway
+            dominant_group_key: apiResult.dominant_group_key,
+            // Phase 2: Runtime stability/debug info
+            diagnostics: apiResult.diagnostics || rawResult.diagnostics,
+        };
+        // Show visual overlay if requested (use API-ranked elements)
+        if (options.show_overlay && apiResult.elements && page) {
+            await browser_evaluator_1.BrowserEvaluator.evaluate(page, (elements) => {
+                if (window.sentience && window.sentience.showOverlay) {
+                    window.sentience.showOverlay(elements, null);
+                }
+            }, apiResult.elements);
+        }
+        // Show grid overlay if requested
+        if (options.show_grid) {
+            const { getGridBounds } = await Promise.resolve().then(() => __importStar(require('./utils/grid-utils')));
+            // Get all grids (don't filter by grid_id here - we want to show all but highlight the target)
+            const grids = getGridBounds(snapshotData, undefined);
+            if (grids.length > 0 && page) {
+                // Pass grid_id as targetGridId to highlight it in red
+                const targetGridId = options.grid_id ?? null;
+                await browser_evaluator_1.BrowserEvaluator.evaluate(page, (args) => {
+                    if (window.sentience && window.sentience.showGrid) {
+                        window.sentience.showGrid(args.grids, args.targetGridId);
+                    }
+                    else {
+                        console.warn('[SDK] showGrid not available in extension');
+                    }
+                }, { grids, targetGridId });
+            }
+        }
+        return snapshotData;
+    }
+    catch (e) {
+        if (e instanceof SnapshotGatewayError) {
+            throw e;
+        }
+        const errType = e instanceof Error ? e.name : typeof e;
+        const errMsg = e instanceof Error ? `${e.name}: ${e.message}` : String(e);
+        throw new SnapshotGatewayError(`Server-side snapshot API failed: url=${gatewayUrl} err_type=${SnapshotGatewayError.snip(errType, 80)} err=${SnapshotGatewayError.snip(errMsg, 220)}. Try using use_api: false to use local extension instead.`, { url: gatewayUrl, cause: e });
+    }
+}
+//# 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/textSearch.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Text search utilities - find text and get pixel coordinates
+ */
+import { Page } from 'playwright';
+import { FindTextRectOptions, TextRectSearchResult } from './types';
+/**
+ * Find all occurrences of text on the page and get their exact pixel coordinates.
+ *
+ * This function searches for text in all visible text nodes on the page and returns
+ * the bounding rectangles for each match. Useful for:
+ * - Finding specific UI elements by their text content
+ * - Locating buttons, links, or labels without element IDs
+ * - Getting exact coordinates for click automation
+ * - Highlighting search results visually
+ *
+ * @param page - Playwright Page instance
+ * @param options - Search options
+ * @returns TextRectSearchResult with all matches and their coordinates
+ *
+ * @example
+ * // Find "Sign In" button
+ * const result = await findTextRect(page, { text: "Sign In" });
+ * if (result.status === "success" && result.results) {
+ *   const firstMatch = result.results[0];
+ *   console.log(`Found at: (${firstMatch.rect.x}, ${firstMatch.rect.y})`);
+ *   console.log(`Size: ${firstMatch.rect.width}x${firstMatch.rect.height}`);
+ *   console.log(`In viewport: ${firstMatch.in_viewport}`);
+ * }
+ *
+ * @example
+ * // Case-sensitive search
+ * const result = await findTextRect(page, {
+ *   text: "LOGIN",
+ *   caseSensitive: true
+ * });
+ *
+ * @example
+ * // Whole word only
+ * const result = await findTextRect(page, {
+ *   text: "log",
+ *   wholeWord: true  // Won't match "login"
+ * });
+ *
+ * @example
+ * // Find all matches and click the first visible one
+ * const result = await findTextRect(page, {
+ *   text: "Buy Now",
+ *   maxResults: 5
+ * });
+ * if (result.status === "success" && result.results) {
+ *   for (const match of result.results) {
+ *     if (match.in_viewport) {
+ *       // Use clickRect from actions module
+ *       await page.mouse.click(
+ *         match.rect.x + match.rect.width / 2,
+ *         match.rect.y + match.rect.height / 2
+ *       );
+ *       break;
+ *     }
+ *   }
+ * }
+ */
+export declare function findTextRect(page: Page, options: FindTextRectOptions | string): Promise<TextRectSearchResult>;
+//# sourceMappingURL=textSearch.d.ts.map

package/dist/textSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textSearch.d.ts","sourceRoot":"","sources":["../src/textSearch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,mBAAmB,GAAG,MAAM,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAgE/B"}

package/dist/textSearch.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * Text search utilities - find text and get pixel coordinates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTextRect = findTextRect;
+/**
+ * Find all occurrences of text on the page and get their exact pixel coordinates.
+ *
+ * This function searches for text in all visible text nodes on the page and returns
+ * the bounding rectangles for each match. Useful for:
+ * - Finding specific UI elements by their text content
+ * - Locating buttons, links, or labels without element IDs
+ * - Getting exact coordinates for click automation
+ * - Highlighting search results visually
+ *
+ * @param page - Playwright Page instance
+ * @param options - Search options
+ * @returns TextRectSearchResult with all matches and their coordinates
+ *
+ * @example
+ * // Find "Sign In" button
+ * const result = await findTextRect(page, { text: "Sign In" });
+ * if (result.status === "success" && result.results) {
+ *   const firstMatch = result.results[0];
+ *   console.log(`Found at: (${firstMatch.rect.x}, ${firstMatch.rect.y})`);
+ *   console.log(`Size: ${firstMatch.rect.width}x${firstMatch.rect.height}`);
+ *   console.log(`In viewport: ${firstMatch.in_viewport}`);
+ * }
+ *
+ * @example
+ * // Case-sensitive search
+ * const result = await findTextRect(page, {
+ *   text: "LOGIN",
+ *   caseSensitive: true
+ * });
+ *
+ * @example
+ * // Whole word only
+ * const result = await findTextRect(page, {
+ *   text: "log",
+ *   wholeWord: true  // Won't match "login"
+ * });
+ *
+ * @example
+ * // Find all matches and click the first visible one
+ * const result = await findTextRect(page, {
+ *   text: "Buy Now",
+ *   maxResults: 5
+ * });
+ * if (result.status === "success" && result.results) {
+ *   for (const match of result.results) {
+ *     if (match.in_viewport) {
+ *       // Use clickRect from actions module
+ *       await page.mouse.click(
+ *         match.rect.x + match.rect.width / 2,
+ *         match.rect.y + match.rect.height / 2
+ *       );
+ *       break;
+ *     }
+ *   }
+ * }
+ */
+async function findTextRect(page, options) {
+    // Support simple string input for convenience
+    const opts = typeof options === 'string' ? { text: options } : options;
+    const { text, caseSensitive = false, wholeWord = false, maxResults = 10 } = opts;
+    if (!text || text.trim().length === 0) {
+        return {
+            status: 'error',
+            error: 'Text parameter is required and cannot be empty',
+        };
+    }
+    // Limit max_results to prevent performance issues
+    const limitedMaxResults = Math.min(maxResults, 100);
+    // CRITICAL: Wait for extension injection to complete (CSP-resistant architecture)
+    // The new architecture loads injected_api.js asynchronously, so window.sentience
+    // may not be immediately available after page load
+    try {
+        await page.waitForFunction(() => typeof window.sentience !== 'undefined', {
+            timeout: 5000,
+        });
+    }
+    catch (e) {
+        // Gather diagnostics if wait fails
+        const diag = await page
+            .evaluate(() => ({
+            sentience_defined: typeof window.sentience !== 'undefined',
+            extension_id: document.documentElement.dataset.sentienceExtensionId || 'not set',
+            url: window.location.href,
+        }))
+            .catch(() => ({ error: 'Could not gather diagnostics' }));
+        throw new Error(`Sentience extension failed to inject window.sentience API. ` +
+            `Is the extension loaded? Diagnostics: ${JSON.stringify(diag)}`);
+    }
+    // Verify findTextRect method exists (for older extension versions that don't have it)
+    const hasFindTextRect = await page.evaluate(() => typeof window.sentience.findTextRect !== 'undefined');
+    if (!hasFindTextRect) {
+        throw new Error('window.sentience.findTextRect is not available. ' +
+            'Please update the Sentience extension to the latest version.');
+    }
+    // Call the extension's findTextRect method
+    const result = await page.evaluate(evalOptions => {
+        return window.sentience.findTextRect(evalOptions);
+    }, {
+        text,
+        caseSensitive,
+        wholeWord,
+        maxResults: limitedMaxResults,
+    });
+    return result;
+}
+//# sourceMappingURL=textSearch.js.map

package/dist/textSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textSearch.js","sourceRoot":"","sources":["../src/textSearch.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA8DH,oCAmEC;AA5HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACI,KAAK,UAAU,YAAY,CAChC,IAAU,EACV,OAAqC;IAErC,8CAA8C;IAC9C,MAAM,IAAI,GAAwB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAE5F,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IAEjF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,gDAAgD;SACxD,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAEpD,kFAAkF;IAClF,iFAAiF;IACjF,mDAAmD;IACnD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,OAAQ,MAAc,CAAC,SAAS,KAAK,WAAW,EAAE;YACjF,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,mCAAmC;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI;aACpB,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;YACf,iBAAiB,EAAE,OAAQ,MAAc,CAAC,SAAS,KAAK,WAAW;YACnE,YAAY,EAAE,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,oBAAoB,IAAI,SAAS;YAChF,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;SAC1B,CAAC,CAAC;aACF,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC,CAAC,CAAC;QAE5D,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,yCAAyC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,QAAQ,CACzC,GAAG,EAAE,CAAC,OAAQ,MAAc,CAAC,SAAS,CAAC,YAAY,KAAK,WAAW,CACpE,CAAC;IACF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,kDAAkD;YAChD,8DAA8D,CACjE,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC,WAAW,CAAC,EAAE;QACZ,OAAQ,MAAc,CAAC,SAAS,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAC7D,CAAC,EACD;QACE,IAAI;QACJ,aAAa;QACb,SAAS;QACT,UAAU,EAAE,iBAAiB;KAC9B,CACF,CAAC;IAEF,OAAO,MAA8B,CAAC;AACxC,CAAC"}

package/dist/tools/context.d.ts

@@ -0,0 +1,18 @@
+import type { BackendCapabilities } from '../types';
+import type { AgentRuntime } from '../agent-runtime';
+import { FileSandbox } from './filesystem';
+export declare class UnsupportedCapabilityError extends Error {
+    readonly error = "unsupported_capability";
+    readonly detail: string;
+    readonly capability: string;
+    constructor(capability: string, detail?: string);
+}
+export declare class ToolContext {
+    readonly runtime: AgentRuntime;
+    readonly files: FileSandbox;
+    constructor(runtime: AgentRuntime, files?: FileSandbox, baseDir?: string);
+    capabilities(): BackendCapabilities;
+    can(name: keyof BackendCapabilities): boolean;
+    require(name: keyof BackendCapabilities): void;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/tools/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,KAAK,4BAA4B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAMhD;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;gBAEhB,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM;IAQxE,YAAY,IAAI,mBAAmB;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,mBAAmB,GAAG,OAAO;IAI7C,OAAO,CAAC,IAAI,EAAE,MAAM,mBAAmB,GAAG,IAAI;CAK/C"}

package/dist/tools/context.js

@@ -0,0 +1,40 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolContext = exports.UnsupportedCapabilityError = void 0;
+const path_1 = __importDefault(require("path"));
+const filesystem_1 = require("./filesystem");
+class UnsupportedCapabilityError extends Error {
+    constructor(capability, detail) {
+        const message = detail ?? `${capability} not supported by backend`;
+        super(message);
+        this.error = 'unsupported_capability';
+        this.detail = message;
+        this.capability = capability;
+    }
+}
+exports.UnsupportedCapabilityError = UnsupportedCapabilityError;
+class ToolContext {
+    constructor(runtime, files, baseDir) {
+        this.runtime = runtime;
+        const root = baseDir
+            ? path_1.default.resolve(baseDir)
+            : path_1.default.resolve(process.cwd(), '.sentience', 'files');
+        this.files = files ?? new filesystem_1.FileSandbox(root);
+    }
+    capabilities() {
+        return this.runtime.capabilities();
+    }
+    can(name) {
+        return Boolean(this.capabilities()[name]);
+    }
+    require(name) {
+        if (!this.can(name)) {
+            throw new UnsupportedCapabilityError(name);
+        }
+    }
+}
+exports.ToolContext = ToolContext;
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAGxB,6CAA2C;AAE3C,MAAa,0BAA2B,SAAQ,KAAK;IAKnD,YAAY,UAAkB,EAAE,MAAe;QAC7C,MAAM,OAAO,GAAG,MAAM,IAAI,GAAG,UAAU,2BAA2B,CAAC;QACnE,KAAK,CAAC,OAAO,CAAC,CAAC;QANR,UAAK,GAAG,wBAAwB,CAAC;QAOxC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAXD,gEAWC;AAED,MAAa,WAAW;IAItB,YAAY,OAAqB,EAAE,KAAmB,EAAE,OAAgB;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACvB,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,wBAAW,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,IAA+B;QACjC,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,CAAC,IAA+B;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;CACF;AAzBD,kCAyBC"}

package/dist/tools/defaults.d.ts

@@ -0,0 +1,5 @@
+import type { AgentRuntime } from '../agent-runtime';
+import { ToolContext } from './context';
+import { ToolRegistry } from './registry';
+export declare function registerDefaultTools(registry: ToolRegistry, runtime?: ToolContext | AgentRuntime): ToolRegistry;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/tools/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/tools/defaults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,WAAW,EAA8B,MAAM,WAAW,CAAC;AACpE,OAAO,EAAc,YAAY,EAAE,MAAM,YAAY,CAAC;AAwHtD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,GACnC,YAAY,CAyTd"}