imperium-crawl 1.5.2 → 2.0.0

package/dist/snapshot/store.js

@@ -0,0 +1,65 @@
+/**
+ * SnapshotStore — In-memory ref storage with LRU eviction.
+ *
+ * Stores RefMaps keyed by session_id (or auto-generated snapshot IDs).
+ * Refs are ephemeral — they exist only in memory and are invalidated
+ * when a new snapshot is taken for the same session.
+ */
+import { MAX_STORED_SNAPSHOTS } from "../constants.js";
+class SnapshotStore {
+    store = new Map();
+    /** Save a snapshot's refs, evicting oldest if at capacity */
+    save(id, refs, url) {
+        // Evict oldest if at capacity (LRU)
+        if (this.store.size >= MAX_STORED_SNAPSHOTS && !this.store.has(id)) {
+            let oldestKey;
+            let oldestTime = Infinity;
+            for (const [key, val] of this.store) {
+                if (val.timestamp < oldestTime) {
+                    oldestTime = val.timestamp;
+                    oldestKey = key;
+                }
+            }
+            if (oldestKey)
+                this.store.delete(oldestKey);
+        }
+        this.store.set(id, { refs, timestamp: Date.now(), url });
+    }
+    /** Resolve a ref string (e.g. "e5" or "@e5") to its locator info */
+    resolveRef(id, refString) {
+        const snapshot = this.store.get(id);
+        if (!snapshot)
+            return null;
+        // Strip leading @ if present
+        const ref = refString.startsWith("@") ? refString.slice(1) : refString;
+        return snapshot.refs[ref] ?? null;
+    }
+    /** Get all refs for a snapshot */
+    getRefs(id) {
+        return this.store.get(id)?.refs ?? null;
+    }
+    /** Invalidate a specific snapshot */
+    invalidate(id) {
+        this.store.delete(id);
+    }
+    /** Clear all stored snapshots */
+    clear() {
+        this.store.clear();
+    }
+    /** Number of stored snapshots */
+    get size() {
+        return this.store.size;
+    }
+}
+// ── Singleton ──
+let instance = null;
+export function getSnapshotStore() {
+    if (!instance)
+        instance = new SnapshotStore();
+    return instance;
+}
+/** Reset singleton (for testing) */
+export function resetSnapshotStore() {
+    instance = null;
+}
+//# sourceMappingURL=store.js.map

package/dist/snapshot/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/snapshot/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAQvD,MAAM,aAAa;IACT,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,6DAA6D;IAC7D,IAAI,CAAC,EAAU,EAAE,IAAY,EAAE,GAAW;QACxC,oCAAoC;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,oBAAoB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,SAA6B,CAAC;YAClC,IAAI,UAAU,GAAG,QAAQ,CAAC;YAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACpC,IAAI,GAAG,CAAC,SAAS,GAAG,UAAU,EAAE,CAAC;oBAC/B,UAAU,GAAG,GAAG,CAAC,SAAS,CAAC;oBAC3B,SAAS,GAAG,GAAG,CAAC;gBAClB,CAAC;YACH,CAAC;YACD,IAAI,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,oEAAoE;IACpE,UAAU,CAAC,EAAU,EAAE,SAAiB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,6BAA6B;QAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvE,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,kCAAkC;IAClC,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,qCAAqC;IACrC,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,iCAAiC;IACjC,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,iCAAiC;IACjC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED,kBAAkB;AAElB,IAAI,QAAQ,GAAyB,IAAI,CAAC;AAE1C,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC,QAAQ;QAAE,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,kBAAkB;IAChC,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/snapshot/types.d.ts

@@ -0,0 +1,42 @@
+/** Semantic locator info resolved from a ref */
+export interface RefEntry {
+    /** Playwright semantic locator string, e.g. getByRole('button', { name: 'Submit', exact: true }) */
+    selector: string;
+    /** ARIA role */
+    role: string;
+    /** Accessible name */
+    name: string;
+    /** nth index when multiple elements share same role+name */
+    nth?: number;
+}
+/** Map of ref IDs (e.g. "e1", "e2") to their locator info */
+export interface RefMap {
+    [ref: string]: RefEntry;
+}
+/** Result from getEnhancedSnapshot */
+export interface EnhancedSnapshot {
+    /** ARIA tree with [ref=eN] annotations */
+    tree: string;
+    /** Ref-to-locator mapping */
+    refs: RefMap;
+    /** Stats about the snapshot */
+    stats: {
+        totalElements: number;
+        interactiveElements: number;
+        contentElements: number;
+    };
+}
+/** Options for snapshot extraction */
+export interface SnapshotOptions {
+    /** Only include interactive elements (default: true) */
+    interactive?: boolean;
+    /** Also detect cursor:pointer/onclick elements without ARIA roles (default: false) */
+    cursor?: boolean;
+    /** Maximum depth of ARIA tree to include */
+    maxDepth?: number;
+    /** Filter out structural elements without refs (default: true) */
+    compact?: boolean;
+    /** CSS selector to scope the snapshot to a subtree */
+    selector?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/snapshot/types.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,6DAA6D;AAC7D,MAAM,WAAW,MAAM;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/snapshot/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/snapshot/types.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAElB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACzH;AAED,eAAO,MAAM,QAAQ,EAAE,cAAc,EA8BpC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAElB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACzH;AAED,eAAO,MAAM,QAAQ,EAAE,cAAc,EA+BpC,CAAC"}

package/dist/tools/index.js

@@ -16,6 +16,7 @@ import * as queryApi from "./query-api.js";
 import * as monitorWebsocket from "./monitor-websocket.js";
 import * as aiExtract from "./ai-extract.js";
 import * as interact from "./interact.js";
+import * as snapshot from "./snapshot.js";
 import * as batchScrape from "./batch-scrape.js";
 import * as listJobs from "./list-jobs.js";
 import * as jobStatus from "./job-status.js";
@@ -45,6 +46,7 @@ export const allTools = [
     aiExtract,
     // Interaction & session tools (Playwright needed)
     interact,
+    snapshot,
     // Batch processing
     batchScrape,
     listJobs,

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,gBAAgB,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAU7C,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,qCAAqC;IACrC,MAAwB;IACxB,KAAuB;IACvB,GAAqB;IACrB,OAAyB;IACzB,WAA6B;IAC7B,UAA4B;IAC5B,sCAAsC;IACtC,MAAwB;IACxB,UAA4B;IAC5B,WAA6B;IAC7B,WAA6B;IAC7B,eAAe;IACf,WAA6B;IAC7B,QAA0B;IAC1B,UAA4B;IAC5B,sDAAsD;IACtD,YAA8B;IAC9B,QAA0B;IAC1B,gBAAkC;IAClC,oCAAoC;IACpC,SAA2B;IAC3B,kDAAkD;IAClD,QAA0B;IAC1B,mBAAmB;IACnB,WAA6B;IAC7B,QAA0B;IAC1B,SAA2B;IAC3B,SAA2B;CAC5B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,UAAU,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,gBAAgB,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAU7C,MAAM,CAAC,MAAM,QAAQ,GAAqB;IACxC,qCAAqC;IACrC,MAAwB;IACxB,KAAuB;IACvB,GAAqB;IACrB,OAAyB;IACzB,WAA6B;IAC7B,UAA4B;IAC5B,sCAAsC;IACtC,MAAwB;IACxB,UAA4B;IAC5B,WAA6B;IAC7B,WAA6B;IAC7B,eAAe;IACf,WAA6B;IAC7B,QAA0B;IAC1B,UAA4B;IAC5B,sDAAsD;IACtD,YAA8B;IAC9B,QAA0B;IAC1B,gBAAkC;IAClC,oCAAoC;IACpC,SAA2B;IAC3B,kDAAkD;IAClD,QAA0B;IAC1B,QAA0B;IAC1B,mBAAmB;IACnB,WAA6B;IAC7B,QAA0B;IAC1B,SAA2B;IAC3B,SAA2B;CAC5B,CAAC"}

package/dist/tools/interact.d.ts

@@ -4,8 +4,9 @@ export declare const description = "Open a browser, execute a sequence of action
 export declare const schema: z.ZodObject<{
     url: z.ZodString;
     actions: z.ZodArray<z.ZodObject<{
-        type: z.ZodEnum<["click", "type", "scroll", "wait", "screenshot", "evaluate", "select", "hover", "press", "navigate"]>;
+        type: z.ZodEnum<["click", "type", "scroll", "wait", "screenshot", "evaluate", "select", "hover", "press", "navigate", "drag", "upload", "storage_get", "storage_set", "cookie_get", "cookie_set", "pdf", "auth_login"]>;
         selector: z.ZodOptional<z.ZodString>;
+        ref: z.ZodOptional<z.ZodString>;
         text: z.ZodOptional<z.ZodString>;
         value: z.ZodOptional<z.ZodString>;
         script: z.ZodOptional<z.ZodString>;
@@ -14,28 +15,93 @@ export declare const schema: z.ZodObject<{
         duration: z.ZodOptional<z.ZodNumber>;
         x: z.ZodOptional<z.ZodNumber>;
         y: z.ZodOptional<z.ZodNumber>;
+        target_selector: z.ZodOptional<z.ZodString>;
+        target_ref: z.ZodOptional<z.ZodString>;
+        file_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        storage: z.ZodOptional<z.ZodEnum<["local", "session"]>>;
+        auth_profile: z.ZodOptional<z.ZodString>;
+        cookies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+            domain: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            expires: z.ZodOptional<z.ZodNumber>;
+            httpOnly: z.ZodOptional<z.ZodBoolean>;
+            secure: z.ZodOptional<z.ZodBoolean>;
+            sameSite: z.ZodOptional<z.ZodEnum<["Strict", "Lax", "None"]>>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+            path?: string | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+            sameSite?: "Strict" | "Lax" | "None" | undefined;
+        }, {
+            value: string;
+            name: string;
+            path?: string | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+            sameSite?: "Strict" | "Lax" | "None" | undefined;
+        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        type: "type" | "select" | "screenshot" | "click" | "scroll" | "wait" | "evaluate" | "hover" | "press" | "navigate";
+        type: "type" | "select" | "screenshot" | "navigate" | "click" | "hover" | "drag" | "upload" | "evaluate" | "pdf" | "cookie_get" | "storage_get" | "cookie_set" | "storage_set" | "scroll" | "wait" | "press" | "auth_login";
         key?: string | undefined;
         value?: string | undefined;
         text?: string | undefined;
         url?: string | undefined;
         script?: string | undefined;
+        ref?: string | undefined;
         x?: number | undefined;
         y?: number | undefined;
         selector?: string | undefined;
         duration?: number | undefined;
+        target_selector?: string | undefined;
+        target_ref?: string | undefined;
+        file_paths?: string[] | undefined;
+        storage?: "local" | "session" | undefined;
+        auth_profile?: string | undefined;
+        cookies?: {
+            value: string;
+            name: string;
+            path?: string | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+            sameSite?: "Strict" | "Lax" | "None" | undefined;
+        }[] | undefined;
     }, {
-        type: "type" | "select" | "screenshot" | "click" | "scroll" | "wait" | "evaluate" | "hover" | "press" | "navigate";
+        type: "type" | "select" | "screenshot" | "navigate" | "click" | "hover" | "drag" | "upload" | "evaluate" | "pdf" | "cookie_get" | "storage_get" | "cookie_set" | "storage_set" | "scroll" | "wait" | "press" | "auth_login";
         key?: string | undefined;
         value?: string | undefined;
         text?: string | undefined;
         url?: string | undefined;
         script?: string | undefined;
+        ref?: string | undefined;
         x?: number | undefined;
         y?: number | undefined;
         selector?: string | undefined;
         duration?: number | undefined;
+        target_selector?: string | undefined;
+        target_ref?: string | undefined;
+        file_paths?: string[] | undefined;
+        storage?: "local" | "session" | undefined;
+        auth_profile?: string | undefined;
+        cookies?: {
+            value: string;
+            name: string;
+            path?: string | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+            sameSite?: "Strict" | "Lax" | "None" | undefined;
+        }[] | undefined;
     }>, "many">;
     return_content: z.ZodDefault<z.ZodBoolean>;
     return_screenshot: z.ZodDefault<z.ZodBoolean>;
@@ -43,46 +109,169 @@ export declare const schema: z.ZodObject<{
     timeout: z.ZodDefault<z.ZodNumber>;
     proxy: z.ZodOptional<z.ZodString>;
     chrome_profile: z.ZodOptional<z.ZodString>;
+    return_snapshot: z.ZodDefault<z.ZodBoolean>;
+    action_policy_path: z.ZodOptional<z.ZodString>;
+    allowed_domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    intercept_rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url_pattern: z.ZodString;
+        action: z.ZodEnum<["block", "mock", "modify", "log"]>;
+        response: z.ZodOptional<z.ZodObject<{
+            status: z.ZodOptional<z.ZodNumber>;
+            body: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            contentType: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            headers?: Record<string, string> | undefined;
+            status?: number | undefined;
+            body?: string | undefined;
+            contentType?: string | undefined;
+        }, {
+            headers?: Record<string, string> | undefined;
+            status?: number | undefined;
+            body?: string | undefined;
+            contentType?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        action: "block" | "mock" | "modify" | "log";
+        url_pattern: string;
+        response?: {
+            headers?: Record<string, string> | undefined;
+            status?: number | undefined;
+            body?: string | undefined;
+            contentType?: string | undefined;
+        } | undefined;
+    }, {
+        action: "block" | "mock" | "modify" | "log";
+        url_pattern: string;
+        response?: {
+            headers?: Record<string, string> | undefined;
+            status?: number | undefined;
+            body?: string | undefined;
+            contentType?: string | undefined;
+        } | undefined;
+    }>, "many">>;
+    return_network_log: z.ZodDefault<z.ZodBoolean>;
+    device: z.ZodOptional<z.ZodString>;
+    geolocation: z.ZodOptional<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        latitude: number;
+        longitude: number;
+    }, {
+        latitude: number;
+        longitude: number;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     url: string;
     timeout: number;
     actions: {
-        type: "type" | "select" | "screenshot" | "click" | "scroll" | "wait" | "evaluate" | "hover" | "press" | "navigate";
+        type: "type" | "select" | "screenshot" | "navigate" | "click" | "hover" | "drag" | "upload" | "evaluate" | "pdf" | "cookie_get" | "storage_get" | "cookie_set" | "storage_set" | "scroll" | "wait" | "press" | "auth_login";
         key?: string | undefined;
         value?: string | undefined;
         text?: string | undefined;
         url?: string | undefined;
         script?: string | undefined;
+        ref?: string | undefined;
         x?: number | undefined;
         y?: number | undefined;
         selector?: string | undefined;
         duration?: number | undefined;
+        target_selector?: string | undefined;
+        target_ref?: string | undefined;
+        file_paths?: string[] | undefined;
+        storage?: "local" | "session" | undefined;
+        auth_profile?: string | undefined;
+        cookies?: {
+            value: string;
+            name: string;
+            path?: string | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+            sameSite?: "Strict" | "Lax" | "None" | undefined;
+        }[] | undefined;
     }[];
     return_content: boolean;
     return_screenshot: boolean;
+    return_snapshot: boolean;
+    return_network_log: boolean;
     proxy?: string | undefined;
+    geolocation?: {
+        latitude: number;
+        longitude: number;
+    } | undefined;
     chrome_profile?: string | undefined;
     session_id?: string | undefined;
+    action_policy_path?: string | undefined;
+    allowed_domains?: string[] | undefined;
+    intercept_rules?: {
+        action: "block" | "mock" | "modify" | "log";
+        url_pattern: string;
+        response?: {
+            headers?: Record<string, string> | undefined;
+            status?: number | undefined;
+            body?: string | undefined;
+            contentType?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    device?: string | undefined;
 }, {
     url: string;
     actions: {
-        type: "type" | "select" | "screenshot" | "click" | "scroll" | "wait" | "evaluate" | "hover" | "press" | "navigate";
+        type: "type" | "select" | "screenshot" | "navigate" | "click" | "hover" | "drag" | "upload" | "evaluate" | "pdf" | "cookie_get" | "storage_get" | "cookie_set" | "storage_set" | "scroll" | "wait" | "press" | "auth_login";
         key?: string | undefined;
         value?: string | undefined;
         text?: string | undefined;
         url?: string | undefined;
         script?: string | undefined;
+        ref?: string | undefined;
         x?: number | undefined;
         y?: number | undefined;
         selector?: string | undefined;
         duration?: number | undefined;
+        target_selector?: string | undefined;
+        target_ref?: string | undefined;
+        file_paths?: string[] | undefined;
+        storage?: "local" | "session" | undefined;
+        auth_profile?: string | undefined;
+        cookies?: {
+            value: string;
+            name: string;
+            path?: string | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+            sameSite?: "Strict" | "Lax" | "None" | undefined;
+        }[] | undefined;
     }[];
     proxy?: string | undefined;
+    geolocation?: {
+        latitude: number;
+        longitude: number;
+    } | undefined;
     timeout?: number | undefined;
     chrome_profile?: string | undefined;
     return_content?: boolean | undefined;
     return_screenshot?: boolean | undefined;
     session_id?: string | undefined;
+    return_snapshot?: boolean | undefined;
+    action_policy_path?: string | undefined;
+    allowed_domains?: string[] | undefined;
+    intercept_rules?: {
+        action: "block" | "mock" | "modify" | "log";
+        url_pattern: string;
+        response?: {
+            headers?: Record<string, string> | undefined;
+            status?: number | undefined;
+            body?: string | undefined;
+            contentType?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    return_network_log?: boolean | undefined;
+    device?: string | undefined;
 }>;
 export type InteractInput = z.infer<typeof schema>;
 export declare function execute(input: InteractInput): Promise<{

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

@@ -1 +1 @@
-{"version":3,"file":"interact.d.ts","sourceRoot":"","sources":["../../src/tools/interact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,IAAI,aAAa,CAAC;AAE/B,eAAO,MAAM,WAAW,wPAC+N,CAAC;AA0BxP,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCjB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AA+GnD,wBAAsB,OAAO,CAAC,KAAK,EAAE,aAAa;;cAiGjB,MAAM;eAAS,MAAM;eAAS,MAAM;mBAAa,MAAM;;GAiBvF"}
+{"version":3,"file":"interact.d.ts","sourceRoot":"","sources":["../../src/tools/interact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,eAAO,MAAM,IAAI,aAAa,CAAC;AAE/B,eAAO,MAAM,WAAW,wPAC+N,CAAC;AAkDxP,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+EjB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AA6TnD,wBAAsB,OAAO,CAAC,KAAK,EAAE,aAAa;;cA+JjB,MAAM;eAAS,MAAM;eAAS,MAAM;mBAAa,MAAM;;GAiBvF"}