rensan-browser 0.1.0

package/README.md

@@ -0,0 +1,133 @@
+# rensan-browser
+
+AI-powered browser for agents — navigate, click, type, read, see images, capture requests.
+
+Built on [Playwright](https://playwright.dev) + [Claude](https://anthropic.com). Designed for AI agents that need to interact with websites and intercept their API traffic.
+
+## Install
+
+```bash
+npm install rensan-browser playwright
+npx playwright install chromium
+```
+
+## Quick start
+
+```typescript
+import { RensanBrowser } from 'rensan-browser'
+
+const browser = new RensanBrowser({ apiKey: 'sk-ant-...' })
+
+const session = await browser.open('https://example.com')
+
+// Read text from the page
+const headline = await session.read('the main headline')
+
+// Click anything — AI finds it
+await session.click('the Accept cookies button')
+
+// Fill any input — AI finds it
+await session.fill('Buenos Aires', 'the city search input')
+
+// Take a screenshot (base64 JPEG)
+const img = await session.screenshot()
+
+// Capture JSON requests fired by the page
+const requests = await session.capture(async () => {
+  await session.fill('BUE', 'origin airport')
+  await session.click('search flights button')
+})
+// requests = [{ url, data, score }, ...]
+
+await session.close()
+await browser.close()
+```
+
+## API
+
+### `new RensanBrowser(config)`
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | required | Anthropic API key |
+| `model` | `string` | `claude-haiku-4-5` | Vision model for AI decisions |
+| `headless` | `boolean` | `true` | Run browser headless |
+| `timeout` | `number` | `25000` | Default navigation timeout (ms) |
+
+### Browser methods
+
+```typescript
+browser.open(url, options?)           // open session and navigate
+browser.newSession()                  // open blank session
+browser.openMany(urls[], options?)    // multiple sessions in parallel
+browser.run(async (session) => ...)   // auto-closing session
+browser.close()                       // close browser
+```
+
+### Session methods
+
+```typescript
+// Navigation
+session.goto(url, options?)
+
+// Interaction — AI finds the element via vision
+session.click(goal)                   // 'the login button'
+session.fill(value, goal, options?)   // ('BUE', 'origin airport input')
+session.type(text, options?)          // type at current focus
+session.moveTo(goal | { x, y })       // move cursor
+
+// Reading
+session.read(goal?)                   // 'the product price' or all text
+session.screenshot()                  // base64 JPEG
+
+// Scrolling
+session.scroll('down' | 'up', options?)
+
+// Request capture
+session.capture(async () => { ... })  // returns CapturedRequest[]
+session.startCapture()
+session.stopCapture()
+session.capturedRequests
+
+// Lifecycle
+session.wait(ms)
+session.close()
+```
+
+### Parallel sessions
+
+```typescript
+const [s1, s2, s3] = await browser.openMany([
+  'https://skyscanner.com',
+  'https://kayak.com',
+  'https://despegar.com',
+])
+
+const results = await Promise.all([
+  s1.capture(async () => s1.fill('BUE', 'origin')),
+  s2.capture(async () => s2.fill('BUE', 'origin')),
+  s3.capture(async () => s3.fill('BUE', 'origin')),
+])
+```
+
+### Request scoring
+
+Captured requests are automatically ranked by relevance — first-party API calls score higher than tracking, ads, and analytics. No hardcoded domain lists.
+
+```typescript
+const requests = await session.capture(async () => {
+  await session.goto('https://news-site.com')
+})
+// requests[0] is the most likely real data API
+```
+
+## How AI interaction works
+
+1. **Layer 1 — Playwright semantic (free)**: tries `getByRole('searchbox')`, `getByRole('textbox')` and common patterns. Works for most standard inputs.
+2. **Layer 2 — Claude Haiku vision (~$0.001)**: takes a screenshot, sends it to Haiku, gets back a CSS selector. Works for any page layout.
+
+Total cost per interaction: ~$0.001 with Haiku.
+
+## License
+
+MIT

package/dist/ai.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ai.ts
+ * All AI calls for rensan-browser.
+ * Haiku sees the page screenshot and decides what to do.
+ */
+import type { AIDecision } from './types';
+export declare class AIClient {
+    readonly model: string;
+    private client;
+    constructor(apiKey: string, model: string);
+    /**
+     * Look at a screenshot and decide what element to interact with.
+     * Returns a CSS/semantic selector and action type.
+     */
+    decide(screenshot: string, goal: string, value?: string): Promise<AIDecision>;
+    /**
+     * Read and extract specific text from a screenshot.
+     */
+    read(screenshot: string, goal?: string): Promise<string>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,qBAAa,QAAQ;IAGS,QAAQ,CAAC,KAAK,EAAE,MAAM;IAFlD,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,MAAM,EAAW,KAAK,EAAE,MAAM;IAIlD;;;OAGG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IA4CnF;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAsB/D"}

package/dist/ai.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * ai.ts
+ * All AI calls for rensan-browser.
+ * Haiku sees the page screenshot and decides what to do.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AIClient = void 0;
+const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+class AIClient {
+    constructor(apiKey, model) {
+        this.model = model;
+        this.client = new sdk_1.default({ apiKey });
+    }
+    /**
+     * Look at a screenshot and decide what element to interact with.
+     * Returns a CSS/semantic selector and action type.
+     */
+    async decide(screenshot, goal, value) {
+        const valueHint = value ? `Value to type: "${value}"` : '';
+        const msg = await this.client.messages.create({
+            model: this.model,
+            max_tokens: 200,
+            messages: [{
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'image',
+                            source: { type: 'base64', media_type: 'image/jpeg', data: screenshot },
+                        },
+                        {
+                            type: 'text',
+                            text: `Goal: ${goal}
+${valueHint}
+
+Look at this screenshot of a webpage.
+Find the best element to interact with to achieve the goal.
+
+Respond ONLY with JSON:
+{
+  "action": "click" | "fill" | "none",
+  "selector": "a valid CSS selector or Playwright locator string",
+  "confidence": 0.0-1.0
+}
+
+Rules:
+- For search/input goals use "fill"
+- For button/link goals use "click"
+- If nothing relevant exists use "none"
+- Prefer specific selectors: [placeholder="..."], [aria-label="..."], button:has-text("...")`,
+                        },
+                    ],
+                }],
+        });
+        const raw = msg.content[0].text.trim()
+            .replace(/^```json?\s*/i, '').replace(/\s*```$/i, '').trim();
+        return JSON.parse(raw);
+    }
+    /**
+     * Read and extract specific text from a screenshot.
+     */
+    async read(screenshot, goal) {
+        const prompt = goal
+            ? `From this webpage screenshot, extract: ${goal}. Return only the extracted text, nothing else.`
+            : 'Extract all visible main content text from this webpage. Skip navigation, ads, and footers.';
+        const msg = await this.client.messages.create({
+            model: this.model,
+            max_tokens: 1000,
+            messages: [{
+                    role: 'user',
+                    content: [
+                        {
+                            type: 'image',
+                            source: { type: 'base64', media_type: 'image/jpeg', data: screenshot },
+                        },
+                        { type: 'text', text: prompt },
+                    ],
+                }],
+        });
+        return msg.content[0].text.trim();
+    }
+}
+exports.AIClient = AIClient;
+//# sourceMappingURL=ai.js.map

package/dist/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,4DAA0C;AAG1C,MAAa,QAAQ;IAGnB,YAAY,MAAc,EAAW,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,aAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,UAAkB,EAAE,IAAY,EAAE,KAAc;QAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,mBAAmB,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC5C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,CAAC;oBACT,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,OAAO;4BACb,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE;yBACvE;wBACD;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,SAAS,IAAI;EAC7B,SAAS;;;;;;;;;;;;;;;;6FAgBkF;yBAClF;qBACF;iBACF,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,GAAG,GAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAoC,CAAC,IAAI,CAAC,IAAI,EAAE;aACvE,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAE/D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,IAAa;QAC1C,MAAM,MAAM,GAAG,IAAI;YACjB,CAAC,CAAC,0CAA0C,IAAI,iDAAiD;YACjG,CAAC,CAAC,6FAA6F,CAAC;QAElG,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC5C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,CAAC;oBACT,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,OAAO;4BACb,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE;yBACvE;wBACD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;qBAC/B;iBACF,CAAC;SACH,CAAC,CAAC;QAEH,OAAQ,GAAG,CAAC,OAAO,CAAC,CAAC,CAAoC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACxE,CAAC;CACF;AAhFD,4BAgFC"}

package/dist/browser.d.ts

@@ -0,0 +1,59 @@
+/**
+ * browser.ts
+ * Main entry point. Manages Playwright browser lifecycle and creates Sessions.
+ */
+import { Session } from './session';
+import type { RensanConfig, GotoOptions } from './types';
+export declare class RensanBrowser {
+    private browser;
+    private config;
+    constructor(config: RensanConfig);
+    launch(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Open a new browser session (tab).
+     * Auto-launches browser if not running.
+     *
+     * @example
+     * const session = await browser.newSession()
+     * await session.goto('https://example.com')
+     */
+    newSession(): Promise<Session>;
+    /**
+     * Open a session and navigate to a URL in one step.
+     *
+     * @example
+     * const session = await browser.open('https://example.com')
+     * await session.click('the search button')
+     */
+    open(url: string, options?: GotoOptions): Promise<Session>;
+    /**
+     * Open multiple sessions in parallel, each navigated to its own URL.
+     *
+     * @example
+     * const [s1, s2, s3] = await browser.openMany([
+     *   'https://skyscanner.com',
+     *   'https://kayak.com',
+     *   'https://despegar.com',
+     * ])
+     * const results = await Promise.all([
+     *   s1.capture(async () => s1.fill('BUE', 'origin')),
+     *   s2.capture(async () => s2.fill('BUE', 'origin')),
+     *   s3.capture(async () => s3.fill('BUE', 'origin')),
+     * ])
+     */
+    openMany(urls: string[], options?: GotoOptions): Promise<Session[]>;
+    /**
+     * Run a task in a temporary session that auto-closes when done.
+     *
+     * @example
+     * const requests = await browser.run(async (session) => {
+     *   await session.goto('https://example.com')
+     *   return session.capture(async () => {
+     *     await session.fill('argentina', 'search')
+     *   })
+     * })
+     */
+    run<T>(fn: (session: Session) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQzD,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,EAAE,YAAY;IAM1B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAOpC;;;;;;OAMG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhE;;;;;;;;;;;;;;OAcG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIzE;;;;;;;;;;OAUG;IACG,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAQ/D"}

package/dist/browser.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * browser.ts
+ * Main entry point. Manages Playwright browser lifecycle and creates Sessions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RensanBrowser = void 0;
+const playwright_1 = require("playwright");
+const session_1 = require("./session");
+const DEFAULTS = {
+    model: 'claude-haiku-4-5',
+    headless: true,
+    timeout: 25000,
+};
+class RensanBrowser {
+    constructor(config) {
+        this.browser = null;
+        this.config = { ...DEFAULTS, ...config };
+    }
+    // ─── Lifecycle ───────────────────────────────────────────────────────────────
+    async launch() {
+        if (this.browser)
+            return;
+        this.browser = await playwright_1.chromium.launch({ headless: this.config.headless });
+    }
+    async close() {
+        await this.browser?.close().catch(() => { });
+        this.browser = null;
+    }
+    // ─── Session factory ─────────────────────────────────────────────────────────
+    /**
+     * Open a new browser session (tab).
+     * Auto-launches browser if not running.
+     *
+     * @example
+     * const session = await browser.newSession()
+     * await session.goto('https://example.com')
+     */
+    async newSession() {
+        await this.launch();
+        const ctx = await this.browser.newContext({ viewport: { width: 1280, height: 800 } });
+        const page = await ctx.newPage();
+        return new session_1.Session(page, this.config.apiKey, this.config.model, this.config.timeout);
+    }
+    /**
+     * Open a session and navigate to a URL in one step.
+     *
+     * @example
+     * const session = await browser.open('https://example.com')
+     * await session.click('the search button')
+     */
+    async open(url, options) {
+        const session = await this.newSession();
+        await session.goto(url, options);
+        return session;
+    }
+    /**
+     * Open multiple sessions in parallel, each navigated to its own URL.
+     *
+     * @example
+     * const [s1, s2, s3] = await browser.openMany([
+     *   'https://skyscanner.com',
+     *   'https://kayak.com',
+     *   'https://despegar.com',
+     * ])
+     * const results = await Promise.all([
+     *   s1.capture(async () => s1.fill('BUE', 'origin')),
+     *   s2.capture(async () => s2.fill('BUE', 'origin')),
+     *   s3.capture(async () => s3.fill('BUE', 'origin')),
+     * ])
+     */
+    async openMany(urls, options) {
+        return Promise.all(urls.map(url => this.open(url, options)));
+    }
+    /**
+     * Run a task in a temporary session that auto-closes when done.
+     *
+     * @example
+     * const requests = await browser.run(async (session) => {
+     *   await session.goto('https://example.com')
+     *   return session.capture(async () => {
+     *     await session.fill('argentina', 'search')
+     *   })
+     * })
+     */
+    async run(fn) {
+        const session = await this.newSession();
+        try {
+            return await fn(session);
+        }
+        finally {
+            await session.close();
+        }
+    }
+}
+exports.RensanBrowser = RensanBrowser;
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,2CAAoD;AACpD,uCAAoC;AAGpC,MAAM,QAAQ,GAAG;IACf,KAAK,EAAK,kBAAkB;IAC5B,QAAQ,EAAE,IAAI;IACd,OAAO,EAAG,KAAK;CAChB,CAAC;AAEF,MAAa,aAAa;IAIxB,YAAY,MAAoB;QAHxB,YAAO,GAAmB,IAAI,CAAC;QAIrC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED,gFAAgF;IAEhF,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,MAAM,qBAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,gFAAgF;IAEhF;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAI,MAAM,IAAI,CAAC,OAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACxF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,iBAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,OAAqB;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAc,EAAE,OAAqB;QAClD,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,GAAG,CAAI,EAAoC;QAC/C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAxFD,sCAwFC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { RensanBrowser } from './browser';
+export { Session } from './session';
+export type { RensanConfig, CapturedRequest, GotoOptions, FillOptions, ScrollOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = exports.RensanBrowser = void 0;
+var browser_1 = require("./browser");
+Object.defineProperty(exports, "RensanBrowser", { enumerable: true, get: function () { return browser_1.RensanBrowser; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "Session", { enumerable: true, get: function () { return session_1.Session; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}

package/dist/interceptor.d.ts

@@ -0,0 +1,23 @@
+/**
+ * interceptor.ts
+ * Captures JSON network responses from a Playwright page.
+ * Uses structural scoring to rank useful vs junk URLs.
+ */
+import type { Page } from 'playwright';
+import type { CapturedRequest } from './types';
+export declare class Interceptor {
+    private page;
+    private captured;
+    private handler;
+    private siteUrl;
+    constructor(page: Page, siteUrl?: string);
+    setSiteUrl(url: string): void;
+    start(): void;
+    stop(): CapturedRequest[];
+    get raw(): Array<{
+        url: string;
+        data: unknown;
+    }>;
+    ranked(topN?: number): CapturedRequest[];
+}
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAsC/C,qBAAa,WAAW;IAKV,OAAO,CAAC,IAAI;IAJxB,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,OAAO,CAAmD;IAClE,OAAO,CAAC,OAAO,CAAS;gBAEJ,IAAI,EAAE,IAAI,EAAE,OAAO,SAAK;IAI5C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,KAAK,IAAI,IAAI;IAyBb,IAAI,IAAI,eAAe,EAAE;IAQzB,IAAI,GAAG,IAAI,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAE/C;IAED,MAAM,CAAC,IAAI,SAAK,GAAG,eAAe,EAAE;CAMrC"}

package/dist/interceptor.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * interceptor.ts
+ * Captures JSON network responses from a Playwright page.
+ * Uses structural scoring to rank useful vs junk URLs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Interceptor = void 0;
+function scoreUrl(url, siteUrl) {
+    let score = 0;
+    try {
+        const u = new URL(url);
+        const site = new URL(siteUrl);
+        const siteDomain = site.hostname.replace(/^www\./, '');
+        const urlDomain = u.hostname.replace(/^www\./, '');
+        // First-party = strong signal
+        if (urlDomain === siteDomain || urlDomain.endsWith('.' + siteDomain) || siteDomain.endsWith('.' + urlDomain)) {
+            score += 10;
+        }
+        const path = u.pathname.toLowerCase();
+        const params = [...u.searchParams];
+        if (/\/api\/|\/v\d+\/|\/rest\/|\/graphql/.test(path))
+            score += 5;
+        if (/\/content\/|\/articles\/|\/news\/|\/feed\//.test(path))
+            score += 3;
+        if (/\/search\/|\/query\/|\/data\/|\/results\//.test(path))
+            score += 3;
+        if (/\/products?\/|\/items?\/|\/catalog\//.test(path))
+            score += 2;
+        // Tracking param keys
+        const trackingKeys = ['uid', 'partner_id', 'gdpr', 'xcid', 'anId', 'tid', 'sjk', 'pid', 'coppa', 'enrich', 'sdkp'];
+        const trackingHits = params.filter(([k]) => trackingKeys.includes(k)).length;
+        score -= trackingHits * 2;
+        if (params.length > 8)
+            score -= 3;
+        if (params.length > 15)
+            score -= 5;
+        if (url.length > 300)
+            score -= 3;
+        if (url.length > 500)
+            score -= 5;
+    }
+    catch {
+        return -99;
+    }
+    return score;
+}
+class Interceptor {
+    constructor(page, siteUrl = '') {
+        this.page = page;
+        this.captured = [];
+        this.handler = null;
+        this.siteUrl = siteUrl;
+    }
+    setSiteUrl(url) {
+        this.siteUrl = url;
+    }
+    start() {
+        this.captured = [];
+        this.handler = async (res) => {
+            const status = res.status();
+            const ct = res.headers()['content-type'] ?? '';
+            const url = res.url();
+            if (status !== 200)
+                return;
+            if (!ct.includes('json'))
+                return;
+            if (url.length > 600)
+                return;
+            try {
+                const data = await res.json();
+                if (!data || typeof data !== 'object')
+                    return;
+                const keys = Array.isArray(data)
+                    ? Object.keys(data[0] ?? {})
+                    : Object.keys(data);
+                if (keys.length < 2)
+                    return;
+                this.captured.push({ url, data });
+            }
+            catch { /* skip */ }
+        };
+        this.page.on('response', this.handler);
+    }
+    stop() {
+        if (this.handler) {
+            this.page.off('response', this.handler);
+            this.handler = null;
+        }
+        return this.ranked();
+    }
+    get raw() {
+        return [...this.captured];
+    }
+    ranked(topN = 15) {
+        return this.captured
+            .map(r => ({ url: r.url, data: r.data, score: scoreUrl(r.url, this.siteUrl) }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topN);
+    }
+}
+exports.Interceptor = Interceptor;
+//# sourceMappingURL=interceptor.js.map

package/dist/interceptor.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,94 @@
+/**
+ * session.ts
+ * One browser tab — the main object you interact with.
+ *
+ * session.goto()        — navigate
+ * session.click()       — AI finds and clicks element
+ * session.fill()        — AI finds input and types
+ * session.type()        — type at current focus
+ * session.read()        — AI reads text from page
+ * session.screenshot()  — returns base64 JPEG
+ * session.scroll()      — scroll up/down
+ * session.moveTo()      — move cursor to element or coords
+ * session.capture()     — run block while capturing requests
+ */
+import type { Page } from 'playwright';
+import type { CapturedRequest, GotoOptions, FillOptions, ScrollOptions } from './types';
+export declare class Session {
+    readonly page: Page;
+    private defaultTimeout;
+    private ai;
+    private interceptor;
+    private currentUrl;
+    constructor(page: Page, apiKey: string, model: string, defaultTimeout: number);
+    goto(url: string, options?: GotoOptions): Promise<void>;
+    wait(ms: number): Promise<void>;
+    screenshot(): Promise<string>;
+    /**
+     * Click an element described in natural language.
+     * AI sees the page and finds the right element.
+     *
+     * @example
+     * await session.click('the Accept cookies button')
+     * await session.click('the search icon in the top right')
+     */
+    click(goal: string): Promise<boolean>;
+    private semanticClick;
+    /**
+     * Find an input and type a value.
+     * AI sees the page and locates the right field.
+     *
+     * @example
+     * await session.fill('BUE', 'the origin airport input')
+     * await session.fill('argentina', 'the main search field')
+     */
+    fill(value: string, goal: string, options?: FillOptions): Promise<boolean>;
+    /**
+     * Type text at the current focused element.
+     */
+    type(text: string, options?: FillOptions): Promise<void>;
+    /**
+     * Read text from the page using AI vision.
+     *
+     * @example
+     * const title = await session.read('the main article headline')
+     * const price = await session.read('the product price')
+     * const all   = await session.read() // all visible content
+     */
+    read(goal?: string): Promise<string>;
+    /**
+     * Scroll the page.
+     *
+     * @example
+     * await session.scroll('down')
+     * await session.scroll('up', { pixels: 200 })
+     * await session.scroll('down', { pixels: 800 })
+     */
+    scroll(direction: 'up' | 'down', options?: ScrollOptions): Promise<void>;
+    /**
+     * Move cursor to coordinates or to an element described in natural language.
+     *
+     * @example
+     * await session.moveTo({ x: 100, y: 200 })
+     * await session.moveTo('the hamburger menu icon')
+     */
+    moveTo(target: {
+        x: number;
+        y: number;
+    } | string): Promise<void>;
+    startCapture(): void;
+    stopCapture(): CapturedRequest[];
+    get capturedRequests(): CapturedRequest[];
+    /**
+     * Run a block and return captured + scored requests after.
+     *
+     * @example
+     * const requests = await session.capture(async () => {
+     *   await session.fill('BUE', 'origin airport')
+     *   await session.click('search button')
+     * })
+     */
+    capture(fn: () => Promise<void>): Promise<CapturedRequest[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExF,qBAAa,OAAO;IAMhB,QAAQ,CAAC,IAAI,EAAE,IAAI;IAGnB,OAAO,CAAC,cAAc;IARxB,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAM;gBAGb,IAAI,EAAE,IAAI,EACnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACL,cAAc,EAAE,MAAM;IAQ1B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3D,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/B,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAOnC;;;;;;;OAOG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAkB7B,aAAa;IAyB3B;;;;;;;OAOG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAsCpF;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlE;;;;;;;OAOG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc1C;;;;;;;OAOG;IACG,MAAM,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IASlF;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtE,YAAY,IAAI,IAAI;IAKpB,WAAW,IAAI,eAAe,EAAE;IAIhC,IAAI,gBAAgB,IAAI,eAAe,EAAE,CAExC;IAED;;;;;;;;OAQG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAY5D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/session.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * session.ts
+ * One browser tab — the main object you interact with.
+ *
+ * session.goto()        — navigate
+ * session.click()       — AI finds and clicks element
+ * session.fill()        — AI finds input and types
+ * session.type()        — type at current focus
+ * session.read()        — AI reads text from page
+ * session.screenshot()  — returns base64 JPEG
+ * session.scroll()      — scroll up/down
+ * session.moveTo()      — move cursor to element or coords
+ * session.capture()     — run block while capturing requests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = void 0;
+const ai_1 = require("./ai");
+const interceptor_1 = require("./interceptor");
+class Session {
+    constructor(page, apiKey, model, defaultTimeout) {
+        this.page = page;
+        this.defaultTimeout = defaultTimeout;
+        this.currentUrl = '';
+        this.ai = new ai_1.AIClient(apiKey, model);
+        this.interceptor = new interceptor_1.Interceptor(page);
+    }
+    // ─── Navigation ─────────────────────────────────────────────────────────────
+    async goto(url, options = {}) {
+        const { waitUntil = 'domcontentloaded', timeout = this.defaultTimeout } = options;
+        this.currentUrl = url;
+        this.interceptor.setSiteUrl(url);
+        await this.page.goto(url, { waitUntil, timeout }).catch(async () => {
+            await this.page.waitForTimeout(2500);
+        });
+    }
+    async wait(ms) {
+        await this.page.waitForTimeout(ms);
+    }
+    // ─── Screenshot ─────────────────────────────────────────────────────────────
+    async screenshot() {
+        const buf = await this.page.screenshot({ type: 'jpeg', quality: 60 });
+        return buf.toString('base64');
+    }
+    // ─── Click ──────────────────────────────────────────────────────────────────
+    /**
+     * Click an element described in natural language.
+     * AI sees the page and finds the right element.
+     *
+     * @example
+     * await session.click('the Accept cookies button')
+     * await session.click('the search icon in the top right')
+     */
+    async click(goal) {
+        // Layer 1 — try Playwright semantic first (free)
+        const semanticResult = await this.semanticClick(goal);
+        if (semanticResult)
+            return true;
+        // Layer 2 — vision
+        try {
+            const img = await this.screenshot();
+            const decision = await this.ai.decide(img, goal);
+            if (decision.action === 'none' || !decision.selector)
+                return false;
+            await this.page.locator(decision.selector).first().click({ timeout: 4000 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async semanticClick(goal) {
+        const lower = goal.toLowerCase();
+        // Cookie-like goals: try common patterns
+        if (/cookie|accept|consent|agree|dismiss/i.test(lower)) {
+            for (const sel of [
+                'button:has-text("Accept")', 'button:has-text("Aceptar")',
+                'button:has-text("I agree")', 'button:has-text("Got it")',
+                '#onetrust-accept-btn-handler', '[class*="cookie"] button',
+            ]) {
+                try {
+                    const el = this.page.locator(sel).first();
+                    if (await el.isVisible({ timeout: 400 }).catch(() => false)) {
+                        await el.click({ timeout: 2000 });
+                        return true;
+                    }
+                }
+                catch { /* try next */ }
+            }
+        }
+        return false;
+    }
+    // ─── Fill ───────────────────────────────────────────────────────────────────
+    /**
+     * Find an input and type a value.
+     * AI sees the page and locates the right field.
+     *
+     * @example
+     * await session.fill('BUE', 'the origin airport input')
+     * await session.fill('argentina', 'the main search field')
+     */
+    async fill(value, goal, options = {}) {
+        const { pressEnter = true, delay = 60 } = options;
+        // Layer 1 — Playwright semantic roles (free)
+        for (const role of ['searchbox', 'textbox']) {
+            try {
+                const loc = this.page.getByRole(role).first();
+                if (await loc.isVisible({ timeout: 500 }).catch(() => false)) {
+                    await loc.fill('');
+                    await loc.type(value, { delay });
+                    if (pressEnter)
+                        await this.page.keyboard.press('Enter');
+                    return true;
+                }
+            }
+            catch { /* try next */ }
+        }
+        // Layer 2 — vision
+        try {
+            const img = await this.screenshot();
+            const decision = await this.ai.decide(img, goal, value);
+            if (decision.action === 'none' || !decision.selector)
+                return false;
+            const el = this.page.locator(decision.selector).first();
+            if (decision.action === 'fill') {
+                await el.fill('');
+                await el.type(value, { delay });
+                if (pressEnter)
+                    await this.page.keyboard.press('Enter');
+            }
+            else {
+                await el.click({ timeout: 4000 });
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ─── Type ───────────────────────────────────────────────────────────────────
+    /**
+     * Type text at the current focused element.
+     */
+    async type(text, options = {}) {
+        const { pressEnter = false, delay = 60 } = options;
+        await this.page.keyboard.type(text, { delay });
+        if (pressEnter)
+            await this.page.keyboard.press('Enter');
+    }
+    // ─── Read ───────────────────────────────────────────────────────────────────
+    /**
+     * Read text from the page using AI vision.
+     *
+     * @example
+     * const title = await session.read('the main article headline')
+     * const price = await session.read('the product price')
+     * const all   = await session.read() // all visible content
+     */
+    async read(goal) {
+        // Try to get text from DOM first (free)
+        if (!goal) {
+            const text = await this.page.evaluate(() => document.body.innerText).catch(() => '');
+            if (text.length > 50)
+                return text.slice(0, 5000);
+        }
+        // Vision for specific extractions
+        const img = await this.screenshot();
+        return this.ai.read(img, goal);
+    }
+    // ─── Scroll ─────────────────────────────────────────────────────────────────
+    /**
+     * Scroll the page.
+     *
+     * @example
+     * await session.scroll('down')
+     * await session.scroll('up', { pixels: 200 })
+     * await session.scroll('down', { pixels: 800 })
+     */
+    async scroll(direction, options = {}) {
+        const { pixels = 400 } = options;
+        const delta = direction === 'down' ? pixels : -pixels;
+        await this.page.evaluate((d) => window.scrollBy(0, d), delta);
+        await this.page.waitForTimeout(300);
+    }
+    // ─── Move cursor ─────────────────────────────────────────────────────────────
+    /**
+     * Move cursor to coordinates or to an element described in natural language.
+     *
+     * @example
+     * await session.moveTo({ x: 100, y: 200 })
+     * await session.moveTo('the hamburger menu icon')
+     */
+    async moveTo(target) {
+        if (typeof target === 'object') {
+            await this.page.mouse.move(target.x, target.y);
+            return;
+        }
+        // AI finds the element
+        try {
+            const img = await this.screenshot();
+            const decision = await this.ai.decide(img, `hover over: ${target}`);
+            if (decision.action === 'none' || !decision.selector)
+                return;
+            await this.page.locator(decision.selector).first().hover({ timeout: 3000 });
+        }
+        catch { /* ignore */ }
+    }
+    // ─── Request capture ─────────────────────────────────────────────────────────
+    startCapture() {
+        this.interceptor.setSiteUrl(this.currentUrl);
+        this.interceptor.start();
+    }
+    stopCapture() {
+        return this.interceptor.stop();
+    }
+    get capturedRequests() {
+        return this.interceptor.ranked();
+    }
+    /**
+     * Run a block and return captured + scored requests after.
+     *
+     * @example
+     * const requests = await session.capture(async () => {
+     *   await session.fill('BUE', 'origin airport')
+     *   await session.click('search button')
+     * })
+     */
+    async capture(fn) {
+        this.startCapture();
+        try {
+            await fn();
+            await this.page.waitForTimeout(2000);
+        }
+        finally {
+            return this.stopCapture();
+        }
+    }
+    // ─── Lifecycle ───────────────────────────────────────────────────────────────
+    async close() {
+        await this.page.close().catch(() => { });
+    }
+}
+exports.Session = Session;
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+export interface RensanConfig {
+    /** Anthropic API key */
+    apiKey: string;
+    /** Vision model for page understanding. Default: claude-haiku-4-5 */
+    model?: string;
+    /** Run browser headless. Default: true */
+    headless?: boolean;
+    /** Default navigation timeout ms. Default: 25000 */
+    timeout?: number;
+}
+export interface GotoOptions {
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+    timeout?: number;
+}
+export interface FillOptions {
+    /** Press Enter after typing. Default: true */
+    pressEnter?: boolean;
+    /** Delay between keystrokes ms. Default: 60 */
+    delay?: number;
+}
+export interface ScrollOptions {
+    /** Pixels to scroll. Default: 400 */
+    pixels?: number;
+}
+export interface CapturedRequest {
+    url: string;
+    data: Record<string, unknown>;
+    score: number;
+}
+export interface AIDecision {
+    action: 'click' | 'fill' | 'none';
+    selector: string;
+    confidence: number;
+}
+export interface ReadResult {
+    text: string;
+    raw: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb"}

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ─── Config ───────────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,iFAAiF"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "rensan-browser",
+  "version": "0.1.0",
+  "description": "AI-powered browser for agents — navigate, click, type, read, see images, capture requests",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["browser", "ai", "agent", "playwright", "automation", "vision", "scraping", "claude"],
+  "license": "MIT",
+  "peerDependencies": {
+    "playwright": ">=1.46.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "playwright": "^1.58.0",
+    "typescript": "^5.0.0"
+  }
+}