@isoldex/sentinel 0.1.0 → 2.0.0

package/dist/index.js

@@ -1,3 +1,5 @@
+import { EventEmitter } from 'events';
+import * as fs from 'fs';
 import { SentinelDriver } from './core/driver.js';
 import { StateParser } from './core/state-parser.js';
 import { ActionEngine } from './api/act.js';
@@ -5,30 +7,56 @@ import { ExtractionEngine } from './api/extract.js';
 import { ObservationEngine } from './api/observe.js';
 import { GeminiService } from './utils/gemini.js';
 import { Verifier } from './reliability/verifier.js';
+import { AgentLoop } from './agent/agent-loop.js';
+import { VisionGrounding } from './core/vision-grounding.js';
+import { WorkflowRecorder } from './recorder/workflow-recorder.js';
+import { TokenTracker } from './utils/token-tracker.js';
+import { SentinelError, ActionError, ExtractionError, NavigationError, AgentError, NotInitializedError } from './types/errors.js';
+export { SentinelError, ActionError, ExtractionError, NavigationError, AgentError, NotInitializedError };
+export { GeminiProvider } from './utils/providers/gemini-provider.js';
+export { OpenAIProvider } from './utils/providers/openai-provider.js';
+export { ClaudeProvider } from './utils/providers/claude-provider.js';
+export { OllamaProvider } from './utils/providers/ollama-provider.js';
 import { z } from 'zod';
 // Re-export z and types so users can do: import { Sentinel, z } from './index.js'
 export { z };
-export class Sentinel {
+export class Sentinel extends EventEmitter {
     driver;
     stateParser = null;
     actionEngine = null;
     extractionEngine = null;
     observationEngine = null;
     verifier = null;
+    agentLoop = null;
+    visionGrounding = null;
+    recorder;
+    tokenTracker;
     gemini;
+    visionFallback;
+    apiKey;
     verbose;
     enableCaching;
     domSettleTimeoutMs;
     constructor(options) {
+        super();
         const driverOptions = {
             headless: options.headless ?? false,
             ...(options.viewport ? { viewport: options.viewport } : {}),
+            ...(options.browser ? { browser: options.browser } : {}),
+            ...(options.proxy ? { proxy: options.proxy } : {}),
+            ...(options.humanLike ? { humanLike: options.humanLike } : {}),
+            ...(options.sessionPath ? { sessionPath: options.sessionPath } : {}),
         };
         this.driver = new SentinelDriver(driverOptions);
-        this.gemini = new GeminiService(options.apiKey);
+        // Use custom provider if supplied, otherwise fall back to GeminiService
+        this.gemini = options.provider ?? new GeminiService(options.apiKey);
         this.verbose = options.verbose ?? 1;
         this.enableCaching = options.enableCaching ?? true;
         this.domSettleTimeoutMs = options.domSettleTimeoutMs ?? 3000;
+        this.visionFallback = options.visionFallback ?? false;
+        this.apiKey = options.apiKey;
+        this.recorder = new WorkflowRecorder();
+        this.tokenTracker = new TokenTracker(process.env.GEMINI_VERSION ?? 'gemini-1.5-flash');
     }
     // ─── Playwright passthrough ───────────────────────────────────────────────
     /** Direct access to the Playwright Page object */
@@ -45,21 +73,74 @@ export class Sentinel {
         const page = this.driver.getPage();
         const cdp = this.driver.getCDPSession();
         this.stateParser = new StateParser(page, cdp);
-        this.actionEngine = new ActionEngine(page, this.stateParser, this.gemini);
+        if (this.visionFallback) {
+            this.visionGrounding = new VisionGrounding(this.apiKey);
+        }
+        this.actionEngine = new ActionEngine(page, this.stateParser, this.gemini, this.visionGrounding ?? undefined);
         this.extractionEngine = new ExtractionEngine(page, this.stateParser, this.gemini);
         this.observationEngine = new ObservationEngine(page, this.stateParser, this.gemini);
         this.verifier = new Verifier(page, this.stateParser, this.gemini);
+        this.agentLoop = new AgentLoop(this.actionEngine, this.stateParser, this.gemini);
         this.log(1, '🚀 Sentinel initialized');
     }
     async goto(url) {
         await this.driver.goto(url);
         this.stateParser?.invalidateCache();
+        this.recorder.record({ type: 'goto', url, pageUrl: url, pageTitle: '' });
+        this.emit('navigate', { url });
         this.log(1, `🌐 Navigated to ${url}`);
     }
     async close() {
         await this.driver.close();
+        this.emit('close');
         this.log(1, '🔒 Sentinel closed');
     }
+    // ─── Recording ─────────────────────────────────────────────────────────────
+    /** Start recording all actions into a replayable workflow. */
+    startRecording(name) {
+        this.recorder.startRecording(name);
+        this.log(1, '🔴 Recording started');
+    }
+    /** Stop recording and return the captured workflow. */
+    stopRecording() {
+        const workflow = this.recorder.stopRecording();
+        this.log(1, `⏹️  Recording stopped (${workflow.steps.length} steps)`);
+        return workflow;
+    }
+    /** Export a recorded workflow as TypeScript code. */
+    exportWorkflowAsCode(workflow) {
+        return this.recorder.exportAsCode(workflow);
+    }
+    /** Export a recorded workflow as JSON string. */
+    exportWorkflowAsJSON(workflow) {
+        return this.recorder.exportAsJSON(workflow);
+    }
+    /** Replay a recorded workflow step by step. */
+    async replay(workflow) {
+        this.log(1, `▶️  Replaying workflow: "${workflow.name}" (${workflow.steps.length} steps)`);
+        for (const step of workflow.steps) {
+            if (step.type === 'goto' && step.url) {
+                await this.goto(step.url);
+            }
+            else if ((step.type === 'act' || step.type === 'scroll' || step.type === 'press') && step.instruction) {
+                await this.act(step.instruction);
+            }
+            else if (step.type === 'observe') {
+                await this.observe(step.instruction);
+            }
+        }
+        this.log(1, '✅ Replay complete');
+    }
+    // ─── Token Tracking ────────────────────────────────────────────────────────
+    /** Get accumulated token usage and estimated cost. */
+    getTokenUsage() {
+        return this.tokenTracker.getUsage();
+    }
+    /** Export token usage log as JSON to a file path. */
+    exportLogs(filePath) {
+        fs.writeFileSync(filePath, this.tokenTracker.exportAsJSON(), 'utf-8');
+        this.log(1, `📊 Logs exported to ${filePath}`);
+    }
     // ─── Core API ─────────────────────────────────────────────────────────────
     /**
      * Perform an action on the page described in natural language.
@@ -90,7 +171,10 @@ export class Sentinel {
             const verification = await this.verifier.verifyAction(instruction, stateBefore, stateAfter);
             if (verification.success && verification.confidence > 0.7) {
                 this.log(1, `✅ "${instruction}" verified (confidence: ${(verification.confidence * 100).toFixed(0)}%)`);
-                return { success: true, message: verification.message, ...(result.action ? { action: result.action } : {}) };
+                const actionResult = { success: true, message: verification.message, ...(result.action ? { action: result.action } : {}) };
+                this.recorder.record({ type: 'act', instruction, pageUrl: this.driver.getPage().url(), pageTitle: '' });
+                this.emit('action', { instruction, result: actionResult });
+                return actionResult;
             }
             else {
                 this.log(1, `⚠️  Verification weak (${(verification.confidence * 100).toFixed(0)}%): ${verification.message}. ` +
@@ -133,6 +217,86 @@ export class Sentinel {
         this.log(2, `👁️  Observing${instruction ? `: "${instruction}"` : ''}`);
         return await this.observationEngine.observe(instruction);
     }
+    /**
+     * Save the current browser session (cookies, localStorage) to a JSON file.
+     */
+    async saveSession(filePath) {
+        await this.driver.saveSession(filePath);
+        this.log(1, `💾 Session saved to ${filePath}`);
+    }
+    /**
+     * Open a new browser tab, optionally navigating to a URL.
+     * @returns The index of the new tab.
+     */
+    async newTab(url) {
+        const index = await this.driver.newTab(url);
+        this.stateParser?.invalidateCache();
+        this.log(1, `🗂️  New tab opened (index ${index})`);
+        return index;
+    }
+    /**
+     * Switch to a tab by index.
+     */
+    async switchTab(index) {
+        await this.driver.switchTab(index);
+        this.stateParser?.invalidateCache();
+        this.log(1, `🗂️  Switched to tab ${index}`);
+    }
+    /**
+     * Close a tab by index.
+     */
+    async closeTab(index) {
+        await this.driver.closeTab(index);
+        this.stateParser?.invalidateCache();
+        this.log(1, `🗂️  Tab ${index} closed`);
+    }
+    /** Number of open tabs */
+    get tabCount() {
+        return this.driver.tabCount;
+    }
+    /**
+     * Check if the current page has a login form.
+     */
+    async hasLoginForm() {
+        return this.driver.hasLoginForm();
+    }
+    /**
+     * Take a screenshot of the current page.
+     * @returns PNG image as a Buffer
+     */
+    async screenshot() {
+        const buf = await this.driver.getPage().screenshot({ type: 'png', fullPage: false });
+        this.log(2, '📸 Screenshot taken');
+        return buf;
+    }
+    /**
+     * Describe the current page visually using Gemini Vision.
+     * Requires visionFallback: true in SentinelOptions.
+     */
+    async describeScreen() {
+        if (!this.visionGrounding) {
+            throw new Error('Vision Grounding is disabled. Set visionFallback: true in SentinelOptions.');
+        }
+        const screenshot = await this.screenshot();
+        return await this.visionGrounding.describeScreen(screenshot);
+    }
+    /**
+     * Run an autonomous multi-step agent to achieve a high-level goal.
+     *
+     * @param goal     Natural language goal, e.g. "Go to Amazon, search for laptop, extract top 5 results"
+     * @param options  Optional: maxSteps (default 15), onStep callback
+     *
+     * @example
+     * const result = await sentinel.run('Search for "TypeScript" on Google and extract the first 3 results');
+     */
+    async run(goal, options) {
+        if (!this.agentLoop)
+            throw new Error('Sentinel not initialized. Call init() first.');
+        this.log(1, `🤖 Agent starting: "${goal}"`);
+        const result = await this.agentLoop.run(goal, options);
+        this.log(1, `🤖 Agent finished: ${result.message}`);
+        return result;
+    }
     // ─── Internal helpers ─────────────────────────────────────────────────────
     log(level, message) {
         if (this.verbose >= level) {

package/dist/index.js.map

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

package/dist/recorder/workflow-recorder.d.ts

@@ -0,0 +1,30 @@
+export interface RecordedAction {
+    type: 'act' | 'extract' | 'observe' | 'goto' | 'scroll' | 'press';
+    instruction?: string;
+    url?: string;
+    value?: string;
+    timestamp: number;
+    pageUrl: string;
+    pageTitle: string;
+}
+export interface RecordedWorkflow {
+    name: string;
+    createdAt: string;
+    steps: RecordedAction[];
+}
+/**
+ * Records Sentinel actions and exports them as replayable workflows.
+ */
+export declare class WorkflowRecorder {
+    private recording;
+    private steps;
+    private workflowName;
+    constructor(name?: string);
+    startRecording(name?: string): void;
+    stopRecording(): RecordedWorkflow;
+    record(action: Omit<RecordedAction, 'timestamp'>): void;
+    isRecording(): boolean;
+    exportAsJSON(workflow: RecordedWorkflow): string;
+    exportAsCode(workflow: RecordedWorkflow): string;
+}
+//# sourceMappingURL=workflow-recorder.d.ts.map

package/dist/recorder/workflow-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-recorder.d.ts","sourceRoot":"","sources":["../../src/recorder/workflow-recorder.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,SAAsB;IAItC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAOnC,aAAa,IAAI,gBAAgB;IAWjC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,IAAI;IAKvD,WAAW,IAAI,OAAO;IAItB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM;IAIhD,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM;CA6CjD"}

package/dist/recorder/workflow-recorder.js

@@ -0,0 +1,83 @@
+/**
+ * Records Sentinel actions and exports them as replayable workflows.
+ */
+export class WorkflowRecorder {
+    recording = false;
+    steps = [];
+    workflowName;
+    constructor(name = 'recorded-workflow') {
+        this.workflowName = name;
+    }
+    startRecording(name) {
+        if (name)
+            this.workflowName = name;
+        this.steps = [];
+        this.recording = true;
+        console.log(`[Recorder] 🔴 Recording started: "${this.workflowName}"`);
+    }
+    stopRecording() {
+        this.recording = false;
+        const workflow = {
+            name: this.workflowName,
+            createdAt: new Date().toISOString(),
+            steps: [...this.steps],
+        };
+        console.log(`[Recorder] ⏹️  Recording stopped. ${this.steps.length} step(s) captured.`);
+        return workflow;
+    }
+    record(action) {
+        if (!this.recording)
+            return;
+        this.steps.push({ ...action, timestamp: Date.now() });
+    }
+    isRecording() {
+        return this.recording;
+    }
+    exportAsJSON(workflow) {
+        return JSON.stringify(workflow, null, 2);
+    }
+    exportAsCode(workflow) {
+        const lines = [
+            `import { Sentinel } from '@isoldex/sentinel';`,
+            `import * as dotenv from 'dotenv';`,
+            `dotenv.config();`,
+            ``,
+            `// Recorded workflow: "${workflow.name}"`,
+            `// Created: ${workflow.createdAt}`,
+            ``,
+            `async function run() {`,
+            `  const sentinel = new Sentinel({`,
+            `    apiKey: process.env.GEMINI_API_KEY!,`,
+            `    headless: false,`,
+            `    verbose: 1,`,
+            `  });`,
+            `  await sentinel.init();`,
+            ``,
+        ];
+        for (const step of workflow.steps) {
+            switch (step.type) {
+                case 'goto':
+                    lines.push(`  await sentinel.goto('${step.url}');`);
+                    break;
+                case 'act':
+                    lines.push(`  await sentinel.act('${step.instruction?.replace(/'/g, "\\'")}');`);
+                    break;
+                case 'extract':
+                    lines.push(`  // await sentinel.extract('${step.instruction?.replace(/'/g, "\\'")}', schema);`);
+                    break;
+                case 'observe':
+                    lines.push(`  await sentinel.observe(${step.instruction ? `'${step.instruction.replace(/'/g, "\\'")}'` : ''});`);
+                    break;
+                case 'scroll':
+                    lines.push(`  await sentinel.act('${step.instruction?.replace(/'/g, "\\'")}');`);
+                    break;
+                case 'press':
+                    lines.push(`  await sentinel.act('Press ${step.value}');`);
+                    break;
+            }
+        }
+        lines.push(``, `  await sentinel.close();`, `}`, ``, `run();`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=workflow-recorder.js.map

package/dist/recorder/workflow-recorder.js.map

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

package/dist/reliability/verifier.d.ts

@@ -1,7 +1,7 @@
 import type { Page } from 'playwright';
 import { StateParser } from '../core/state-parser.js';
 import type { SimplifiedState } from '../core/state-parser.js';
-import { GeminiService } from '../utils/gemini.js';
+import type { LLMProvider } from '../utils/llm-provider.js';
 export interface VerificationResult {
     done: boolean;
     success: boolean;
@@ -12,7 +12,7 @@ export declare class Verifier {
     private page;
     private stateParser;
     private gemini;
-    constructor(page: Page, stateParser: StateParser, gemini: GeminiService);
+    constructor(page: Page, stateParser: StateParser, gemini: LLMProvider);
     verifyAction(action: string, stateBefore: SimplifiedState, stateAfter: SimplifiedState): Promise<VerificationResult>;
 }
 //# sourceMappingURL=verifier.d.ts.map

package/dist/reliability/verifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/reliability/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,qBAAa,QAAQ;IAEjB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;gBAFN,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,aAAa;IAGzB,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,EAC5B,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,kBAAkB,CAAC;CAkD/B"}
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/reliability/verifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,qBAAa,QAAQ;IAEjB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM;gBAFN,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,WAAW;IAGvB,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,EAC5B,UAAU,EAAE,eAAe,GAC1B,OAAO,CAAC,kBAAkB,CAAC;CAkD/B"}

package/dist/reliability/verifier.js

@@ -1,5 +1,4 @@
 import { StateParser } from '../core/state-parser.js';
-import { GeminiService } from '../utils/gemini.js';
 /** Returns a short, meaningful summary of a state for comparison */
 function summarizeState(state) {
     return {

package/dist/reliability/verifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../src/reliability/verifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,oEAAoE;AACpE,SAAS,cAAc,CAAC,KAAsB;IAC5C,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;QACnC,kEAAkE;QAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,QAAQ;IAET;IACA;IACA;IAHV,YACU,IAAU,EACV,WAAwB,EACxB,MAAqB;QAFrB,SAAI,GAAJ,IAAI,CAAM;QACV,gBAAW,GAAX,WAAW,CAAa;QACxB,WAAM,GAAN,MAAM,CAAe;IAC5B,CAAC;IAEJ,KAAK,CAAC,YAAY,CAChB,MAAc,EACd,WAA4B,EAC5B,UAA2B;QAG3B,qEAAqE;QACrE,IAAI,WAAW,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,CAAC,GAAG,MAAM,UAAU,CAAC,GAAG,iBAAiB,CAAC,CAAC;YAC7F,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,qBAAqB,UAAU,CAAC,GAAG,EAAE;gBAC9C,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG;8CAC2B,MAAM;;;QAG5C,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;;QAGpD,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;KAKtD,CAAC;QAEF,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAChC;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC;SACnD,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAIpD,MAAM,EAAE,MAAM,CAAC,CAAC;QAEnB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,WAAW;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../src/reliability/verifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAWtD,oEAAoE;AACpE,SAAS,cAAc,CAAC,KAAsB;IAC5C,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;QACnC,kEAAkE;QAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,QAAQ;IAET;IACA;IACA;IAHV,YACU,IAAU,EACV,WAAwB,EACxB,MAAmB;QAFnB,SAAI,GAAJ,IAAI,CAAM;QACV,gBAAW,GAAX,WAAW,CAAa;QACxB,WAAM,GAAN,MAAM,CAAa;IAC1B,CAAC;IAEJ,KAAK,CAAC,YAAY,CAChB,MAAc,EACd,WAA4B,EAC5B,UAA2B;QAG3B,qEAAqE;QACrE,IAAI,WAAW,CAAC,GAAG,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,CAAC,GAAG,MAAM,UAAU,CAAC,GAAG,iBAAiB,CAAC,CAAC;YAC7F,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,qBAAqB,UAAU,CAAC,GAAG,EAAE;gBAC9C,UAAU,EAAE,IAAI;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG;8CAC2B,MAAM;;;QAG5C,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;;QAGpD,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;;;;;KAKtD,CAAC;QAEF,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;gBAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAChC;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC;SACnD,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAIpD,MAAM,EAAE,MAAM,CAAC,CAAC;QAEnB,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,WAAW;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;CACF"}

package/dist/types/errors.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Base class for all Sentinel errors.
+ */
+export declare class SentinelError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, any> | undefined;
+    constructor(message: string, code: string, context?: Record<string, any> | undefined);
+}
+/**
+ * Thrown when an action (click, fill, etc.) fails after all retries.
+ */
+export declare class ActionError extends SentinelError {
+    constructor(message: string, context?: Record<string, any>);
+}
+/**
+ * Thrown when structured data extraction fails.
+ */
+export declare class ExtractionError extends SentinelError {
+    constructor(message: string, context?: Record<string, any>);
+}
+/**
+ * Thrown when the LLM provider returns an unexpected or unparseable response.
+ */
+export declare class LLMError extends SentinelError {
+    constructor(message: string, context?: Record<string, any>);
+}
+/**
+ * Thrown when navigation to a URL fails.
+ */
+export declare class NavigationError extends SentinelError {
+    constructor(message: string, context?: Record<string, any>);
+}
+/**
+ * Thrown when the agent loop exceeds max steps or gets stuck.
+ */
+export declare class AgentError extends SentinelError {
+    constructor(message: string, context?: Record<string, any>);
+}
+/**
+ * Thrown when Sentinel is used before init() is called.
+ */
+export declare class NotInitializedError extends SentinelError {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gBAF7C,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YAAA;CAMhD;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,aAAa;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,aAAa;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,aAAa;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;;CAKrD"}

package/dist/types/errors.js

@@ -0,0 +1,69 @@
+/**
+ * Base class for all Sentinel errors.
+ */
+export class SentinelError extends Error {
+    code;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'SentinelError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when an action (click, fill, etc.) fails after all retries.
+ */
+export class ActionError extends SentinelError {
+    constructor(message, context) {
+        super(message, 'ACTION_FAILED', context);
+        this.name = 'ActionError';
+    }
+}
+/**
+ * Thrown when structured data extraction fails.
+ */
+export class ExtractionError extends SentinelError {
+    constructor(message, context) {
+        super(message, 'EXTRACTION_FAILED', context);
+        this.name = 'ExtractionError';
+    }
+}
+/**
+ * Thrown when the LLM provider returns an unexpected or unparseable response.
+ */
+export class LLMError extends SentinelError {
+    constructor(message, context) {
+        super(message, 'LLM_ERROR', context);
+        this.name = 'LLMError';
+    }
+}
+/**
+ * Thrown when navigation to a URL fails.
+ */
+export class NavigationError extends SentinelError {
+    constructor(message, context) {
+        super(message, 'NAVIGATION_FAILED', context);
+        this.name = 'NavigationError';
+    }
+}
+/**
+ * Thrown when the agent loop exceeds max steps or gets stuck.
+ */
+export class AgentError extends SentinelError {
+    constructor(message, context) {
+        super(message, 'AGENT_ERROR', context);
+        this.name = 'AgentError';
+    }
+}
+/**
+ * Thrown when Sentinel is used before init() is called.
+ */
+export class NotInitializedError extends SentinelError {
+    constructor() {
+        super('Sentinel not initialized. Call init() first.', 'NOT_INITIALIZED');
+        this.name = 'NotInitializedError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAGpB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAA6B;QAE7C,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAsB;QAG7C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,aAAa;IAC5C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,aAAa;IACzC,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,aAAa;IAC3C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD;QACE,KAAK,CAAC,8CAA8C,EAAE,iBAAiB,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/utils/gemini.d.ts

@@ -1,10 +1,7 @@
-import { z } from "zod";
-/** Accepts either a Zod schema or a raw JSON Schema object */
-export type SchemaInput<T> = z.ZodType | Record<string, any>;
+import type { SchemaInput } from './llm-provider.js';
+export type { SchemaInput };
 export declare class GeminiService {
-    private genAI;
-    private structuredModel;
-    private textModel;
+    private provider;
     constructor(apiKey: string);
     generateStructuredData<T>(prompt: string, schema: SchemaInput<T>): Promise<T>;
     generateText(prompt: string, systemInstruction?: string): Promise<string>;

package/dist/utils/gemini.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/utils/gemini.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA6BxB,8DAA8D;AAC9D,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAoC7D,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,SAAS,CAAM;gBAEX,MAAM,EAAE,MAAM;IASpB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuB7E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAehF"}
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/utils/gemini.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAiB;gBAErB,MAAM,EAAE,MAAM;IAIpB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI7E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAGhF"}