@hasna/browser 0.3.4 → 0.3.6

package/dist/lib/url-watcher.d.ts

@@ -0,0 +1,33 @@
+/**
+ * browser_watch_url — poll a URL for content changes, store diffs.
+ */
+export interface WatchJob {
+    id: string;
+    name?: string;
+    url: string;
+    schedule: string;
+    selector?: string;
+    last_check?: string;
+    enabled: boolean;
+    created_at: string;
+}
+export interface WatchEvent {
+    id: string;
+    watch_id: string;
+    checked_at: string;
+    changed: boolean;
+    old_content?: string;
+    new_content?: string;
+    diff_summary?: string;
+}
+export declare function createWatchJob(url: string, schedule: string, opts?: {
+    name?: string;
+    selector?: string;
+    extractSchema?: Record<string, string>;
+}): WatchJob;
+export declare function getWatchJob(id: string): WatchJob | null;
+export declare function listWatchJobs(): WatchJob[];
+export declare function deleteWatchJob(id: string): boolean;
+export declare function getWatchEvents(watchId: string, limit?: number): WatchEvent[];
+export declare function loadWatchJobsOnStartup(): void;
+//# sourceMappingURL=url-watcher.d.ts.map

package/dist/lib/url-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-watcher.d.ts","sourceRoot":"","sources":["../../src/lib/url-watcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkCH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClF,QAAQ,CAcV;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAMvD;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAK1C;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKlD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE,CAMxE;AAwED,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}

package/dist/lib/vision-fallback.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Vision-based element finding — uses a screenshot + vision model to locate elements
+ * when a11y tree and CSS selectors fail (canvas, complex SVGs, custom widgets).
+ */
+import type { Page } from "playwright";
+export interface VisionFindResult {
+    found: boolean;
+    x: number;
+    y: number;
+    confidence: string;
+    description: string;
+    model: string;
+    error?: string;
+}
+/**
+ * Take a screenshot and ask a vision model to find an element matching the description.
+ * Returns coordinates to click.
+ */
+export declare function findElementByVision(page: Page, description: string, opts?: {
+    model?: string;
+    maxWidth?: number;
+}): Promise<VisionFindResult>;
+/**
+ * Click at coordinates found by vision model.
+ */
+export declare function clickByVision(page: Page, description: string, opts?: {
+    model?: string;
+}): Promise<VisionFindResult>;
+//# sourceMappingURL=vision-fallback.d.ts.map

package/dist/lib/vision-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-fallback.d.ts","sourceRoot":"","sources":["../../src/lib/vision-fallback.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,OAAO,CAAC,gBAAgB,CAAC,CA+D3B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}

package/dist/lib/workflows.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Saved workflows — reusable browser automation sequences with self-healing.
+ * Record a flow once, replay it forever. If selectors change, auto-heal and update.
+ */
+import type { Page } from "playwright";
+import type { RecordingStep } from "../types/index.js";
+export interface Workflow {
+    id: string;
+    name: string;
+    description: string | null;
+    steps: RecordingStep[];
+    start_url: string | null;
+    last_run: string | null;
+    last_heal: string | null;
+    heal_count: number;
+    run_count: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface WorkflowRunResult {
+    success: boolean;
+    steps_executed: number;
+    steps_failed: number;
+    steps_healed: number;
+    healed_details: Array<{
+        step: number;
+        original: string;
+        healed_to: string;
+        method: string;
+    }>;
+    errors: string[];
+    duration_ms: number;
+}
+export declare function saveWorkflow(data: {
+    name: string;
+    description?: string;
+    steps: RecordingStep[];
+    startUrl?: string;
+}): Workflow;
+export declare function saveWorkflowFromRecording(recordingId: string, name: string, description?: string): Workflow;
+export declare function getWorkflow(id: string): Workflow | null;
+export declare function getWorkflowByName(name: string): Workflow | null;
+export declare function listWorkflows(): Workflow[];
+export declare function deleteWorkflow(name: string): boolean;
+export declare function runWorkflow(workflow: Workflow, page: Page): Promise<WorkflowRunResult>;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/lib/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/lib/workflows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAO9H;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CAQ3G;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAKvD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAK/D;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAI1C;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAkBD,wBAAsB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+F5F"}

package/dist/mcp/actions.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=actions.d.ts.map

package/dist/mcp/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/mcp/actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2CzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAkhBzC"}

package/dist/mcp/capture.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=capture.d.ts.map

package/dist/mcp/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/mcp/capture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6BzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAodzC"}

package/dist/mcp/data.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=data.d.ts.map

package/dist/mcp/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/mcp/data.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,QAIzC"}

package/dist/mcp/gallery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gallery.test.d.ts.map

package/dist/mcp/gallery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.test.d.ts","sourceRoot":"","sources":["../../src/mcp/gallery.test.ts"],"names":[],"mappings":""}

package/dist/mcp/helpers.d.ts

@@ -0,0 +1,55 @@
+export { z } from "zod";
+export { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export { createSession, closeSession, getSession, listSessions, getSessionPage, getSessionByName, renameSession, setSessionPage, getTokenBudget, getSessionBunView, isBunSession, getActiveSessionForAgent, getDefaultSession, countActiveSessions, isAutoGallery, } from "../lib/session.js";
+export { navigate, click, type as typeText, fill, scroll, hover, selectOption, checkBox, uploadFile, goBack, goForward, reload, waitForSelector, pressKey, clickText, fillForm, waitForText, watchPage, getWatchChanges, stopWatch, clickRef, typeRef, fillRef, selectRef, checkRef, hoverRef, } from "../lib/actions.js";
+export { getText, getHTML, getLinks, getTitle, getUrl, extract, extractStructured, extractTable, getAriaSnapshot, findElements, elementExists, getPageInfo, } from "../lib/extractor.js";
+export { takeScreenshot, generatePDF } from "../lib/screenshot.js";
+export { enableNetworkLogging, addInterceptRule, clearInterceptRules, startHAR } from "../lib/network.js";
+export { getPerformanceMetrics, startCoverage } from "../lib/performance.js";
+export { enableConsoleCapture } from "../lib/console.js";
+export { getCookies, setCookie, clearCookies, getLocalStorage, setLocalStorage, getSessionStorage, setSessionStorage, } from "../lib/storage.js";
+export { startRecording, stopRecording, replayRecording, recordStep } from "../lib/recorder.js";
+export { crawl } from "../lib/crawler.js";
+export { registerAgent, heartbeat, listAgents, getAgent } from "../lib/agents.js";
+export { ensureProject, listProjects, getProjectByName } from "../db/projects.js";
+export { getNetworkLog } from "../db/network-log.js";
+export { getConsoleLog } from "../db/console-log.js";
+export { listEntries, getEntry, tagEntry, untagEntry, favoriteEntry, deleteEntry, searchEntries, getGalleryStats, } from "../db/gallery.js";
+export { saveToDownloads, listDownloads, getDownload, deleteDownload, cleanStaleDownloads, exportToPath } from "../lib/downloads.js";
+export { diffImages } from "../lib/gallery-diff.js";
+export { takeSnapshot as takeSnapshotFn, diffSnapshots, getLastSnapshot, setLastSnapshot } from "../lib/snapshot.js";
+export { persistFile } from "../lib/files-integration.js";
+export { listRecordings, getRecording } from "../db/recordings.js";
+export { logEvent, getTimeline } from "../db/timeline.js";
+export { newTab, listTabs, switchTab, closeTab } from "../lib/tabs.js";
+export { getDialogs, handleDialog } from "../lib/dialogs.js";
+export { saveProfile, loadProfile, applyProfile, listProfiles as listProfilesFn, deleteProfile, } from "../lib/profiles.js";
+export { UseCase, BrowserError } from "../types/index.js";
+export type { BrowserEngine } from "../types/index.js";
+export declare const networkLogCleanup: Map<string, () => void>;
+export declare const consoleCaptureCleanup: Map<string, () => void>;
+export declare const harCaptures: Map<string, import("../index.js").HARCapture>;
+export declare function json(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function err(e: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+/** Like err() but attempts to capture a screenshot for context. */
+export declare function errWithScreenshot(e: unknown, sessionId?: string): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+}>;
+/** Resolve session_id: use explicit value, or auto-select the single active session. */
+export declare function resolveSessionId(sessionId?: string): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/mcp/helpers.d.ts.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":""}