@predicatelabs/sdk 0.99.9

package/dist/cli.js

@@ -0,0 +1,422 @@
+"use strict";
+/**
+ * CLI commands for Sentience SDK
+ */
+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 });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const browser_1 = require("./browser");
+const inspector_1 = require("./inspector");
+const recorder_1 = require("./recorder");
+const generator_1 = require("./generator");
+const actions_1 = require("./actions");
+const snapshot_1 = require("./snapshot");
+const screenshot_1 = require("./screenshot");
+async function cmdInspect(args) {
+    // Parse proxy from args
+    let proxy;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--proxy' && i + 1 < args.length) {
+            proxy = args[++i];
+        }
+    }
+    const browser = new browser_1.SentienceBrowser(undefined, undefined, false, proxy);
+    try {
+        await browser.start();
+        console.log('✅ Inspector started. Hover elements to see info, click to see full details.');
+        console.log('Press Ctrl+C to stop.');
+        const inspector = (0, inspector_1.inspect)(browser);
+        await inspector.start();
+        // Keep running until interrupted
+        process.on('SIGINT', () => {
+            void (async () => {
+                console.log('\n👋 Inspector stopped.');
+                await inspector.stop();
+                await browser.close();
+                process.exit(0);
+            })();
+        });
+        // Wait indefinitely
+        await new Promise(() => { });
+    }
+    catch (e) {
+        console.error(`❌ Error: ${e.message}`);
+        await browser.close();
+        process.exit(1);
+    }
+}
+async function cmdRecord(args) {
+    // Parse arguments
+    let url;
+    let output = 'trace.json';
+    let captureSnapshots = false;
+    let proxy;
+    const maskPatterns = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--url' && i + 1 < args.length) {
+            url = args[++i];
+        }
+        else if (args[i] === '--output' || args[i] === '-o') {
+            output = args[++i];
+        }
+        else if (args[i] === '--snapshots') {
+            captureSnapshots = true;
+        }
+        else if (args[i] === '--mask' && i + 1 < args.length) {
+            maskPatterns.push(args[++i]);
+        }
+        else if (args[i] === '--proxy' && i + 1 < args.length) {
+            proxy = args[++i];
+        }
+    }
+    const browser = new browser_1.SentienceBrowser(undefined, undefined, false, proxy);
+    try {
+        await browser.start();
+        // Navigate to start URL if provided
+        if (url) {
+            const page = browser.getPage();
+            if (!page) {
+                throw new Error('Browser not started. Call start() first.');
+            }
+            await page.goto(url);
+            await page.waitForLoadState('networkidle');
+        }
+        console.log('✅ Recording started. Perform actions in the browser.');
+        console.log('Press Ctrl+C to stop and save trace.');
+        const rec = (0, recorder_1.record)(browser, captureSnapshots);
+        rec.start();
+        // Add mask patterns
+        for (const pattern of maskPatterns) {
+            rec.addMaskPattern(pattern);
+        }
+        // Keep running until interrupted
+        process.on('SIGINT', () => {
+            void (async () => {
+                console.log('\n💾 Saving trace...');
+                await rec.save(output);
+                console.log(`✅ Trace saved to ${output}`);
+                await browser.close();
+                process.exit(0);
+            })();
+        });
+        // Wait indefinitely
+        await new Promise(() => { });
+    }
+    catch (e) {
+        console.error(`❌ Error: ${e.message}`);
+        await browser.close();
+        process.exit(1);
+    }
+}
+async function cmdGen(args) {
+    try {
+        // Parse arguments
+        let traceFile;
+        let lang = 'py';
+        let output;
+        for (let i = 0; i < args.length; i++) {
+            if (args[i] && !args[i].startsWith('--')) {
+                traceFile = args[i];
+            }
+            else if (args[i] === '--lang') {
+                lang = args[++i];
+            }
+            else if (args[i] === '--output' || args[i] === '-o') {
+                output = args[++i];
+            }
+        }
+        if (!traceFile) {
+            console.error('❌ Trace file required');
+            process.exit(1);
+        }
+        // Load trace
+        const trace = await recorder_1.Recorder.load(traceFile);
+        // Generate script
+        const generator = new generator_1.ScriptGenerator(trace);
+        if (lang === 'py') {
+            const outputFile = output || 'generated.py';
+            await generator.savePython(outputFile);
+            console.log(`✅ Generated Python script: ${outputFile}`);
+        }
+        else {
+            const outputFile = output || 'generated.ts';
+            await generator.saveTypeScript(outputFile);
+            console.log(`✅ Generated TypeScript script: ${outputFile}`);
+        }
+    }
+    catch (e) {
+        console.error(`❌ Error: ${e.message}`);
+        process.exit(1);
+    }
+}
+function printDriverHelp() {
+    console.log('\nCommands:');
+    console.log('  open <url>                 Navigate to URL');
+    console.log('  state [limit]              List clickable elements (optional limit)');
+    console.log('  click <element_id>         Click element by id');
+    console.log('  type <element_id> <text>   Type text into element');
+    console.log('  press <key>                Press a key (e.g., Enter)');
+    console.log('  screenshot [path]          Save screenshot (png/jpg)');
+    console.log('  close                      Close browser and exit');
+    console.log('  help                       Show this help');
+}
+function parseDriverLine(raw) {
+    const tokens = [];
+    const re = /"([^"]*)"|'([^']*)'|[^\s]+/g;
+    let match = null;
+    while ((match = re.exec(raw)) !== null) {
+        if (match[1] !== undefined) {
+            tokens.push(match[1]);
+        }
+        else if (match[2] !== undefined) {
+            tokens.push(match[2]);
+        }
+        else if (match[0]) {
+            tokens.push(match[0]);
+        }
+    }
+    return tokens;
+}
+async function cmdDriver(args) {
+    let url;
+    let limit = 50;
+    let headless = false;
+    let proxy;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--url' && i + 1 < args.length) {
+            url = args[++i];
+        }
+        else if (args[i] === '--limit' && i + 1 < args.length) {
+            const parsed = Number(args[++i]);
+            if (!Number.isFinite(parsed) || parsed <= 0) {
+                console.error('❌ --limit must be a positive number');
+                process.exit(1);
+            }
+            limit = Math.floor(parsed);
+        }
+        else if (args[i] === '--headless') {
+            headless = true;
+        }
+        else if (args[i] === '--proxy' && i + 1 < args.length) {
+            proxy = args[++i];
+        }
+    }
+    const browser = new browser_1.SentienceBrowser(undefined, undefined, headless, proxy);
+    try {
+        await browser.start();
+        if (url) {
+            const page = browser.getPage();
+            if (!page)
+                throw new Error('Browser not started. Call start() first.');
+            await page.goto(url);
+            await page.waitForLoadState('networkidle');
+        }
+        console.log("✅ Manual driver started. Type 'help' for commands.");
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: true,
+        });
+        let closed = false;
+        rl.on('close', () => {
+            closed = true;
+        });
+        rl.on('SIGINT', () => {
+            console.log('\n👋 Exiting manual driver.');
+            rl.close();
+        });
+        const ask = async () => {
+            const raw = await new Promise(resolve => rl.question('sentience> ', resolve));
+            const trimmed = raw.trim();
+            if (!trimmed) {
+                return;
+            }
+            const parts = parseDriverLine(trimmed);
+            if (parts.length === 0)
+                return;
+            const cmd = parts[0].toLowerCase();
+            const cmdArgs = parts.slice(1);
+            if (cmd === 'help' || cmd === '?') {
+                printDriverHelp();
+                return;
+            }
+            if (cmd === 'open') {
+                if (cmdArgs.length < 1) {
+                    console.log('❌ Usage: open <url>');
+                    return;
+                }
+                const target = cmdArgs[0];
+                const page = browser.getPage();
+                if (!page)
+                    throw new Error('Browser not started. Call start() first.');
+                await page.goto(target);
+                await page.waitForLoadState('networkidle');
+                console.log(`✅ Opened ${target}`);
+                return;
+            }
+            if (cmd === 'state') {
+                let currentLimit = limit;
+                if (cmdArgs.length > 0) {
+                    const parsed = Number(cmdArgs[0]);
+                    if (!Number.isFinite(parsed) || parsed <= 0) {
+                        console.log('❌ Usage: state [limit]');
+                        return;
+                    }
+                    currentLimit = Math.floor(parsed);
+                }
+                const snapOpts = { limit: currentLimit };
+                const snap = await (0, snapshot_1.snapshot)(browser, snapOpts);
+                const clickables = snap.elements.filter(el => el.visual_cues?.is_clickable);
+                console.log(`URL: ${snap.url}`);
+                console.log(`Clickable elements: ${clickables.length}`);
+                for (const el of clickables) {
+                    let text = (el.text || '').replace(/\n/g, ' ').trim();
+                    if (text.length > 60) {
+                        text = `${text.slice(0, 57)}...`;
+                    }
+                    console.log(`- id=${el.id} role=${el.role} text='${text}'`);
+                }
+                return;
+            }
+            if (cmd === 'click') {
+                if (cmdArgs.length !== 1) {
+                    console.log('❌ Usage: click <element_id>');
+                    return;
+                }
+                const elementId = Number(cmdArgs[0]);
+                if (!Number.isFinite(elementId)) {
+                    console.log('❌ element_id must be a number');
+                    return;
+                }
+                await (0, actions_1.click)(browser, elementId);
+                console.log(`✅ Clicked element ${elementId}`);
+                return;
+            }
+            if (cmd === 'type') {
+                if (cmdArgs.length < 2) {
+                    console.log('❌ Usage: type <element_id> <text>');
+                    return;
+                }
+                const elementId = Number(cmdArgs[0]);
+                if (!Number.isFinite(elementId)) {
+                    console.log('❌ element_id must be a number');
+                    return;
+                }
+                const text = cmdArgs.slice(1).join(' ');
+                await (0, actions_1.typeText)(browser, elementId, text);
+                console.log(`✅ Typed into element ${elementId}`);
+                return;
+            }
+            if (cmd === 'press') {
+                if (cmdArgs.length !== 1) {
+                    console.log('❌ Usage: press <key> (e.g., "Enter")');
+                    return;
+                }
+                await (0, actions_1.press)(browser, cmdArgs[0]);
+                console.log(`✅ Pressed ${cmdArgs[0]}`);
+                return;
+            }
+            if (cmd === 'screenshot') {
+                let outPath = cmdArgs[0];
+                if (!outPath) {
+                    outPath = `screenshot-${Date.now()}.png`;
+                }
+                const ext = path.extname(outPath).toLowerCase();
+                const format = ext === '.jpg' || ext === '.jpeg' ? 'jpeg' : 'png';
+                const dataUrl = await (0, screenshot_1.screenshot)(browser, { format });
+                const comma = dataUrl.indexOf(',');
+                const base64 = comma >= 0 ? dataUrl.slice(comma + 1) : dataUrl;
+                fs.writeFileSync(outPath, Buffer.from(base64, 'base64'));
+                console.log(`✅ Saved screenshot to ${outPath}`);
+                return;
+            }
+            if (cmd === 'close' || cmd === 'exit' || cmd === 'quit') {
+                console.log('👋 Closing browser.');
+                rl.close();
+                return;
+            }
+            console.log(`❌ Unknown command: ${cmd}. Type 'help' for options.`);
+        };
+        while (!closed) {
+            await ask();
+        }
+    }
+    finally {
+        await browser.close();
+    }
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (command === 'inspect') {
+        await cmdInspect(args.slice(1));
+    }
+    else if (command === 'record') {
+        await cmdRecord(args.slice(1));
+    }
+    else if (command === 'gen') {
+        await cmdGen(args.slice(1));
+    }
+    else if (command === 'driver') {
+        await cmdDriver(args.slice(1));
+    }
+    else {
+        console.log('Usage: sentience <command> [options]');
+        console.log('');
+        console.log('Commands:');
+        console.log('  inspect                    Start inspector mode');
+        console.log('  record [--url URL]         Start recording mode');
+        console.log('  gen <trace.json>           Generate script from trace');
+        console.log('  driver [--url URL]         Manual driver CLI');
+        console.log('');
+        console.log('Options:');
+        console.log('  --proxy <url>              Proxy connection string (e.g., http://user:pass@host:port)');
+        console.log('');
+        console.log('Examples:');
+        console.log('  sentience inspect');
+        console.log('  sentience inspect --proxy http://user:pass@proxy.com:8000');
+        console.log('  sentience record --url https://example.com --output trace.json');
+        console.log('  sentience record --proxy http://user:pass@proxy.com:8000 --url https://example.com');
+        console.log('  sentience gen trace.json --lang py --output script.py');
+        console.log('  predicate driver --url https://example.com');
+        process.exit(1);
+    }
+}
+if (require.main === module) {
+    main().catch(console.error);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/conversational-agent.d.ts

@@ -0,0 +1,123 @@
+/**
+ * ConversationalAgent - Level 4 Abstraction
+ * Natural language interface for browser automation
+ */
+import { LLMProvider } from './llm-provider';
+import { SentienceBrowser } from './browser';
+import { Snapshot } from './types';
+export type ActionType = 'NAVIGATE' | 'FIND_AND_CLICK' | 'FIND_AND_TYPE' | 'PRESS_KEY' | 'WAIT' | 'EXTRACT_INFO' | 'VERIFY';
+export interface ActionParameters {
+    url?: string;
+    description?: string;
+    text?: string;
+    key?: string;
+    seconds?: number;
+    info_type?: string;
+    condition?: string;
+}
+export interface PlanStep {
+    action: ActionType;
+    parameters: ActionParameters;
+    reasoning: string;
+}
+export interface ExecutionPlan {
+    steps: PlanStep[];
+    goal: string;
+}
+export interface StepResult {
+    success: boolean;
+    action: ActionType;
+    result?: any;
+    error?: string;
+    snapshot?: Snapshot;
+    duration_ms?: number;
+}
+export interface ConversationEntry {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    plan?: ExecutionPlan;
+    results?: StepResult[];
+}
+export interface ConversationalAgentOptions {
+    llmProvider: LLMProvider;
+    browser: SentienceBrowser;
+    verbose?: boolean;
+    maxTokens?: number;
+    planningModel?: string;
+    executionModel?: string;
+}
+/**
+ * ConversationalAgent provides the highest level of abstraction (Level 4).
+ * It accepts natural language instructions, automatically plans the execution,
+ * performs the actions, and synthesizes natural language responses.
+ *
+ * Example:
+ *   const agent = new ConversationalAgent({ llmProvider, browser });
+ *   const response = await agent.execute("Search Google for TypeScript tutorials");
+ *   console.log(response);
+ */
+export declare class ConversationalAgent {
+    private llmProvider;
+    private browser;
+    private verbose;
+    private maxTokens;
+    private planningModel?;
+    private executionModel?;
+    private conversationHistory;
+    private sentienceAgent;
+    constructor(options: ConversationalAgentOptions);
+    /**
+     * Execute a natural language instruction.
+     * Plans the steps, executes them, and returns a natural language response.
+     */
+    execute(userInput: string): Promise<string>;
+    /**
+     * Create an execution plan from natural language input.
+     * Uses LLM to break down the request into atomic steps.
+     */
+    private createPlan;
+    /**
+     * Execute a single step from the plan.
+     */
+    private executeStep;
+    /**
+     * Extract specific information from a page snapshot.
+     */
+    private extractInformation;
+    /**
+     * Verify a condition is met on the current page.
+     */
+    private verifyCondition;
+    /**
+     * Convert a Snapshot object to text representation for LLM.
+     */
+    private snapshotToText;
+    /**
+     * Synthesize a natural language response from execution results.
+     */
+    private synthesizeResponse;
+    /**
+     * Chat interface that maintains conversation context.
+     * Unlike execute(), this method keeps track of the full conversation
+     * and uses it for context in subsequent interactions.
+     */
+    chat(message: string): Promise<string>;
+    /**
+     * Get a summary of the entire conversation session.
+     */
+    getSummary(): Promise<string>;
+    /**
+     * Clear conversation history.
+     */
+    clearHistory(): void;
+    /**
+     * Get the conversation history.
+     */
+    getHistory(): ConversationEntry[];
+    /**
+     * Get token usage statistics from the underlying agent.
+     */
+    getTokenStats(): import("./agent").TokenStats;
+}
+//# sourceMappingURL=conversational-agent.d.ts.map

package/dist/conversational-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversational-agent.d.ts","sourceRoot":"","sources":["../src/conversational-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,MAAM,GACN,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,cAAc,CAAiB;gBAE3B,OAAO,EAAE,0BAA0B;IAW/C;;;OAGG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsEjD;;;OAGG;YACW,UAAU;IA+CxB;;OAEG;YACW,WAAW;IA2GzB;;OAEG;YACW,kBAAkB;IAYhC;;OAEG;YACW,eAAe;IAY7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;YACW,kBAAkB;IAuChC;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA0BnC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,UAAU,IAAI,iBAAiB,EAAE;IAIjC;;OAEG;IACH,aAAa;CAGd"}