@wenathlan/saddle 1.8.8 → 1.8.10

package/dist/binary/build.d.ts

@@ -0,0 +1,29 @@
+/**
+ * binary builder plans portable artifacts without choosing a compiler vendor.
+ */
+export declare const binarytargets: readonly string[];
+/** Creates a deterministic binary build plan from explicit options. */
+export declare function binaryplan(options?: {}): {
+    name: any;
+    target: any;
+    entry: any;
+    output: any;
+    command: any;
+    minify: any;
+    embedruntime: any;
+    externaldependencies: any;
+    metadata: any;
+};
+/** Returns an artifact manifest without writing files or running a compiler. */
+export declare function binarymanifest(plan: any): {
+    name: any;
+    target: any;
+    entry: any;
+    output: any;
+    files: any[];
+    reproducible: boolean;
+    metadata: any;
+};
+/** Resolves an injected builder and preserves the plan as the execution boundary. */
+export declare function buildbinary(plan: any, builder: any): Promise<any>;
+//# sourceMappingURL=build.d.ts.map

package/dist/binary/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../binary/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,aAAa,mBAA4K,CAAC;AAEvM,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,OAAO,KAAK;;;;;;;;;;EAItC;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,KAAA;IAAa,IAAI;IAAa,MAAM;IAAe,KAAK;IAAc,MAAM;IAAe,KAAK;IAAgB,YAAY;IAAQ,QAAQ;EAAoB;AAEnM,qFAAqF;AACrF,wBAAsB,WAAW,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA,gBAAiI"}

package/dist/binary/build.js

@@ -0,0 +1,17 @@
+/**
+ * binary builder plans portable artifacts without choosing a compiler vendor.
+ */
+export const binarytargets = Object.freeze(["node", "deno", "bun", "wasm", "singlefile", "sea", "appimage", "deb", "rpm", "snap", "flatpak", "dmg", "pkg", "exe", "msi", "msix", "apk", "aab", "ipa"]);
+/** Creates a deterministic binary build plan from explicit options. */
+export function binaryplan(options = {}) {
+    const target = options.target ?? "node";
+    if (!binarytargets.includes(target))
+        throw new TypeError(`unsupported binary target: ${target}`);
+    return { name: options.name ?? "saddle", target, entry: options.entry ?? "dist/cli/main.js", output: options.output ?? "dist/artifacts", command: options.command ?? `build ${target}`, minify: options.minify ?? false, embedruntime: options.embedruntime ?? false, externaldependencies: options.externaldependencies ?? [], metadata: options.metadata ?? {} };
+}
+/** Returns an artifact manifest without writing files or running a compiler. */
+export function binarymanifest(plan) { return { name: plan.name, target: plan.target, entry: plan.entry, output: plan.output, files: [plan.entry], reproducible: true, metadata: plan.metadata }; }
+/** Resolves an injected builder and preserves the plan as the execution boundary. */
+export async function buildbinary(plan, builder) { if (typeof builder !== "function")
+    throw new TypeError("binary builder is required"); return builder(binarymanifest(plan)); }
+//# sourceMappingURL=build.js.map

package/dist/binary/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../binary/build.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEvM,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,OAAO,GAAG,EAAE;IACrC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAC;IACjG,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK,EAAE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;AACrW,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;AAEnM,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,OAAO,OAAO,KAAK,UAAU;IAAE,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/bot/adapter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * platform adapters expose only the operations a bot needs.
+ */
+export declare function platformadapter(methods: any): any;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/bot/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../bot/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,KAAA,OAItC"}

package/dist/bot/adapter.js

@@ -0,0 +1,11 @@
+/**
+ * platform adapters expose only the operations a bot needs.
+ */
+export function platformadapter(methods) {
+    const required = ["authenticate", "listrepos", "createwebhook", "executebot"];
+    for (const name of required)
+        if (typeof methods?.[name] !== "function")
+            throw new TypeError(`platform adapter requires ${name}`);
+    return methods;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/bot/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../bot/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO;IACrC,MAAM,QAAQ,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;IAC9E,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,IAAI,OAAO,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAC;IACjI,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/bot/bot.d.ts

@@ -0,0 +1,28 @@
+export declare function saddlebot(options?: {}): {
+    register(name: any, adapter: any): any;
+    start(): Promise<{
+        status: string;
+        startedat: any;
+        commands: number;
+        adapters: string[];
+        tasks: any[];
+    }>;
+    stop(): Promise<{
+        status: string;
+        startedat: any;
+        commands: number;
+        adapters: string[];
+        tasks: any[];
+    }>;
+    executecommand: (input: any, context?: {}) => Promise<any>;
+    handlewebhook(platform: any, event: any): Promise<any>;
+    scheduletask(name: any, task: any, delay: any): any;
+    getstatus: () => {
+        status: string;
+        startedat: any;
+        commands: number;
+        adapters: string[];
+        tasks: any[];
+    };
+};
+//# sourceMappingURL=bot.d.ts.map

package/dist/bot/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../bot/bot.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCrC"}

package/dist/bot/bot.js

@@ -0,0 +1,52 @@
+/**
+ * saddlebot unifies commands without owning a platform credential or scheduler.
+ */
+import { parsecommand } from "./commands.js";
+export function saddlebot(options = {}) {
+    const adapters = new Map(Object.entries(options.adapters ?? {}));
+    const tasks = new Map();
+    const guard = options.guard;
+    const keys = new Map();
+    const state = { status: "stopped", startedat: undefined, commands: 0 };
+    const timers = new Set();
+    async function executecommand(input, context = {}) {
+        const parsed = typeof input === "string" ? parsecommand(input) : input;
+        state.commands += 1;
+        if (parsed.command === "status")
+            return getstatus();
+        if (parsed.command === "help")
+            return { commands: ["capture", "scrape", "review", "deploy", "memory", "test", "release", "webhook", "schedule", "publish", "artifact", "status"] };
+        const platform = parsed.flags.platform ?? context.platform;
+        const adapter = adapters.get(platform);
+        if (!adapter)
+            throw new Error(`no adapter registered for ${platform ?? "command"}`);
+        const permission = guard?.check({ command: parsed.command, platform, scopes: context.scopes ?? [] });
+        if (permission && !permission.allowed) {
+            const error = new Error(`bot command is not authorized: ${parsed.command}`);
+            error.code = "BOT_COMMAND_UNAUTHORIZED";
+            error.missing = permission.missing;
+            throw error;
+        }
+        const key = context.idempotencykey;
+        if (key && keys.has(key))
+            return keys.get(key);
+        const result = await adapter.executebot({ command: parsed.command, flags: parsed.flags, context });
+        if (key)
+            keys.set(key, result);
+        return result;
+    }
+    function getstatus() { return { ...state, adapters: [...adapters.keys()], tasks: [...tasks.keys()] }; }
+    return {
+        register(name, adapter) { adapters.set(name, adapter); return this; },
+        async start() { state.status = "running"; state.startedat = Date.now(); return getstatus(); },
+        async stop() { for (const timer of timers)
+            clearTimeout(timer); timers.clear(); state.status = "stopped"; return getstatus(); },
+        executecommand,
+        async handlewebhook(platform, event) { const adapter = adapters.get(platform); if (!adapter)
+            throw new Error(`no adapter registered for ${platform}`); return adapter.executebot({ command: "webhook", event }); },
+        scheduletask(name, task, delay) { if (typeof task !== "function" || !Number.isFinite(delay))
+            throw new TypeError("schedule requires task and delay"); const timer = setTimeout(async () => { tasks.delete(name); await task(); }, delay); timers.add(timer); tasks.set(name, { name, delay, scheduledat: Date.now() }); return tasks.get(name); },
+        getstatus
+    };
+}
+//# sourceMappingURL=bot.js.map

package/dist/bot/bot.js.map

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

package/dist/bot/commands.d.ts

@@ -0,0 +1,8 @@
+/**
+ * command parsing keeps the bot surface serializable and platform neutral.
+ */
+export declare function parsecommand(input: any): {
+    command: any;
+    flags: {};
+};
+//# sourceMappingURL=commands.d.ts.map

package/dist/bot/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../bot/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,KAAA;;;EAYjC"}

package/dist/bot/commands.js

@@ -0,0 +1,19 @@
+/**
+ * command parsing keeps the bot surface serializable and platform neutral.
+ */
+export function parsecommand(input) {
+    const tokens = tokenize(String(input ?? ""));
+    const command = tokens.shift() ?? "help";
+    const flags = {};
+    for (let index = 0; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        if (!token.startsWith("--"))
+            continue;
+        const key = token.slice(2).toLowerCase();
+        const value = tokens[index + 1]?.startsWith("--") ? true : tokens[++index] ?? true;
+        flags[key] = value;
+    }
+    return { command: command.toLowerCase(), flags };
+}
+function tokenize(input) { return input.match(/(?:[^\s"]+|"[^"]*")+/g)?.map((value) => value.replace(/^"|"$/g, "")) ?? []; }
+//# sourceMappingURL=commands.js.map

package/dist/bot/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../bot/commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAK;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC;IACzC,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACtC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;QACnF,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC"}

package/dist/bot/permissions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * command permissions keep bot actions explicit and platform neutral.
+ */
+/** Creates a command guard from caller supplied command and scope policies. */
+export declare function commandguard(options?: {}): {
+    check: (input?: {}) => {
+        allowed: boolean;
+        command: string;
+        missing: any;
+        platform: any;
+    };
+};
+//# sourceMappingURL=permissions.d.ts.map

package/dist/bot/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../bot/permissions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,OAAO,KAAK;;;;;;;EAUxC"}

package/dist/bot/permissions.js

@@ -0,0 +1,16 @@
+/**
+ * command permissions keep bot actions explicit and platform neutral.
+ */
+/** Creates a command guard from caller supplied command and scope policies. */
+export function commandguard(options = {}) {
+    const policies = options.policies ?? {};
+    function check(input = {}) {
+        const command = String(input.command ?? "");
+        const policy = policies[command] ?? { scopes: [] };
+        const scopes = input.scopes ?? [];
+        const missing = (policy.scopes ?? []).filter((scope) => !scopes.includes(scope));
+        return { allowed: missing.length === 0, command, missing, platform: input.platform };
+    }
+    return { check };
+}
+//# sourceMappingURL=permissions.js.map

package/dist/bot/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../bot/permissions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,OAAO,GAAG,EAAE;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IACxC,SAAS,KAAK,CAAC,KAAK,GAAG,EAAE;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;IACvF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/browser/actions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * browser actions normalize adapter outcomes and preserve failure metadata for agents and replay.
+ */
+export declare const browseractions: readonly string[];
+/** Creates a stable action result independent of the underlying browser vendor. */
+export declare function actionresult(action: any, options?: {}): {
+    version: number;
+    action: any;
+    ok: boolean;
+    startedat: number;
+    finishedat: number;
+    tabid: string;
+    frameid: string;
+    snapshotid: any;
+    value: any;
+    metadata: any;
+};
+/** Creates a stable action failure without leaking adapter internals or credentials. */
+export declare function actionfailure(action: any, error: any, options?: {}): {
+    version: number;
+    action: string;
+    ok: boolean;
+    code: string;
+    message: string;
+    retryable: boolean;
+    tabid: string;
+    frameid: string;
+    snapshotid: any;
+    metadata: any;
+};
+/** Executes a bounded list of actions through an injected adapter and keeps per-action outcomes. */
+export declare function actionbatch(adapter: any, actions?: any[], options?: {}): Promise<any[]>;
+//# sourceMappingURL=actions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../browser/actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc,mBAA4G,CAAC;AAExI,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,MAAM,KAAA,EAAE,OAAO,KAAK;;;;;;;;;;;EAGhD;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,MAAM,KAAA,EAAE,KAAK,KAAA,EAAE,OAAO,KAAK;;;;;;;;;;;EAGxD;AAED,oGAAoG;AACpG,wBAAsB,WAAW,CAAC,OAAO,KAAA,EAAE,OAAO,QAAK,EAAE,OAAO,KAAK,kBAapE"}

package/dist/browser/actions.js

@@ -0,0 +1,44 @@
+/**
+ * browser actions normalize adapter outcomes and preserve failure metadata for agents and replay.
+ */
+export const browseractions = Object.freeze(["navigate", "click", "type", "fill", "key", "scroll", "upload", "screenshot", "snapshot"]);
+/** Creates a stable action result independent of the underlying browser vendor. */
+export function actionresult(action, options = {}) {
+    if (!browseractions.includes(action))
+        throw new TypeError(`unsupported browser action: ${action}`);
+    return { version: 1, action, ok: true, startedat: Number(options.startedat ?? Date.now()), finishedat: Number(options.finishedat ?? Date.now()), tabid: options.tabid === undefined ? undefined : String(options.tabid), frameid: options.frameid === undefined ? undefined : String(options.frameid), snapshotid: options.snapshotid, value: options.value, metadata: options.metadata ?? {} };
+}
+/** Creates a stable action failure without leaking adapter internals or credentials. */
+export function actionfailure(action, error, options = {}) {
+    if (!action || typeof action !== "string")
+        throw new TypeError("browser action failure requires an action name");
+    return { version: 1, action, ok: false, code: String(options.code ?? error?.code ?? "BROWSER_ACTION_FAILED"), message: String(error?.message ?? error ?? "browser action failed"), retryable: Boolean(options.retryable ?? error?.retryable), tabid: options.tabid === undefined ? undefined : String(options.tabid), frameid: options.frameid === undefined ? undefined : String(options.frameid), snapshotid: options.snapshotid, metadata: options.metadata ?? {} };
+}
+/** Executes a bounded list of actions through an injected adapter and keeps per-action outcomes. */
+export async function actionbatch(adapter, actions = [], options = {}) {
+    if (!adapter || typeof adapter !== "object")
+        throw new TypeError("browser action batch requires an adapter");
+    if (!Array.isArray(actions) || actions.length > (options.maxactions ?? 100))
+        throw new TypeError("browser action batch is invalid or too large");
+    const results = [];
+    for (const item of actions) {
+        const action = String(item?.action ?? "");
+        const method = adapter[action];
+        if (typeof method !== "function") {
+            results.push(actionfailure(action, new Error(`browser adapter does not support ${action}`), { code: "UNSUPPORTED_ACTION" }));
+            continue;
+        }
+        const startedat = Date.now();
+        try {
+            const value = await method(item.options ?? item.value);
+            results.push(actionresult(action, { ...item, startedat, finishedat: Date.now(), value }));
+        }
+        catch (error) {
+            results.push(actionfailure(action, error, { ...item, tabid: item.tabid, frameid: item.frameid, snapshotid: item.snapshotid }));
+            if (options.stoponerror)
+                break;
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=actions.js.map

package/dist/browser/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../browser/actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;AAExI,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,EAAE;IAC/C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;IACnG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;AAClY,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,EAAE;IACvD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACjH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,uBAAuB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,IAAI,uBAAuB,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,KAAK,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;AACzc,CAAC;AAED,oGAAoG;AACpG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE;IACnE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAC7G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACjJ,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,oCAAoC,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC7K,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YAAC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAAC,CAAC;QAC1J,OAAO,KAAK,EAAE,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YAAC,IAAI,OAAO,CAAC,WAAW;gBAAE,MAAM;QAAC,CAAC;IACnL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/browser/agent.d.ts

@@ -0,0 +1,21 @@
+/**
+ * browser agent delegates browser actions to an injected runtime adapter.
+ */
+export declare function browseragent(adapter: any): {
+    navigate: (options: any) => any;
+    click: (target: any) => any;
+    type: (value: any) => any;
+    screenshot: (options: any) => any;
+    html: () => any;
+    text: () => any;
+    title: () => any;
+    scrolltobottom: (options: any) => any;
+    executecommands: (commands: any) => any;
+    fill: (...args: any[]) => any;
+    key: (...args: any[]) => any;
+    upload: (...args: any[]) => any;
+    snapshot: (...args: any[]) => any;
+    tabs: (...args: any[]) => any;
+    frames: (...args: any[]) => any;
+};
+//# sourceMappingURL=agent.d.ts.map

package/dist/browser/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../browser/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,KAAA;;;;;;;;;;;;;;;;EAKnC"}

package/dist/browser/agent.js

@@ -0,0 +1,13 @@
+/**
+ * browser agent delegates browser actions to an injected runtime adapter.
+ */
+export function browseragent(adapter) {
+    const required = ["navigate", "click", "type", "screenshot", "html", "text", "title", "scrolltobottom", "executecommands"];
+    for (const name of required)
+        if (typeof adapter?.[name] !== "function")
+            throw new TypeError(`browser adapter requires ${name}`);
+    const optional = (name) => (...args) => { if (typeof adapter[name] !== "function")
+        throw new Error(`browser adapter does not support ${name}`); return adapter[name](...args); };
+    return { navigate: (options) => adapter.navigate(options), click: (target) => adapter.click(target), type: (value) => adapter.type(value), screenshot: (options) => adapter.screenshot(options), html: () => adapter.html(), text: () => adapter.text(), title: () => adapter.title(), scrolltobottom: (options) => adapter.scrolltobottom(options), executecommands: (commands) => adapter.executecommands(commands), fill: optional("fill"), key: optional("key"), upload: optional("upload"), snapshot: optional("snapshot"), tabs: optional("tabs"), frames: optional("frames") };
+}
+//# sourceMappingURL=agent.js.map

package/dist/browser/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../browser/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAAO;IAClC,MAAM,QAAQ,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAC;IAC3H,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,IAAI,OAAO,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IAChI,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACjL,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AACxjB,CAAC"}

package/dist/browser/context.d.ts

@@ -0,0 +1,43 @@
+/**
+ * browser context tracks tabs and frames without owning a browser implementation.
+ */
+/** Creates a serializable browser context registry for an injected browser adapter. */
+export declare function browsercontext(options?: {}): {
+    sessionid: string;
+    opentab: (input?: {}) => {
+        id: any;
+        url: any;
+        title: any;
+        active: any;
+        frames: any[];
+    };
+    closetab: (id: any) => boolean;
+    setactive: (id: any) => {
+        id: any;
+        url: any;
+        title: any;
+        active: any;
+        frames: any[];
+    };
+    openframe: (tabid: any, input?: {}) => any;
+    closeframe: (tabid: any, frameid: any) => boolean;
+    activetab: () => {
+        id: any;
+        url: any;
+        title: any;
+        active: any;
+        frames: any[];
+    };
+    describe: () => {
+        sessionid: string;
+        activeid: string;
+        tabs: {
+            id: any;
+            url: any;
+            title: any;
+            active: any;
+            frames: any[];
+        }[];
+    };
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/browser/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../browser/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8C1C"}

package/dist/browser/context.js

@@ -0,0 +1,54 @@
+/**
+ * browser context tracks tabs and frames without owning a browser implementation.
+ */
+/** Creates a serializable browser context registry for an injected browser adapter. */
+export function browsercontext(options = {}) {
+    const sessionid = String(options.sessionid ?? `context${Date.now().toString(36)}`);
+    const tabs = new Map();
+    let activeid = options.activeid === undefined ? undefined : String(options.activeid);
+    function opentab(input = {}) {
+        const id = String(input.id ?? `tab${tabs.size + 1}`);
+        const tab = { id, url: String(input.url ?? "about:blank"), title: String(input.title ?? ""), active: Boolean(input.active), frames: new Map() };
+        tabs.set(id, tab);
+        if (tab.active || activeid === undefined) {
+            activeid = id;
+            tab.active = true;
+        }
+        return describetab(tab);
+    }
+    function closetab(id) {
+        const key = String(id);
+        if (!tabs.delete(key))
+            return false;
+        if (activeid === key)
+            activeid = tabs.keys().next().value;
+        if (activeid && tabs.has(activeid))
+            tabs.get(activeid).active = true;
+        return true;
+    }
+    function setactive(id) {
+        const key = String(id);
+        const tab = tabs.get(key);
+        if (!tab)
+            throw new Error(`unknown browser tab: ${key}`);
+        for (const item of tabs.values())
+            item.active = false;
+        tab.active = true;
+        activeid = key;
+        return describetab(tab);
+    }
+    function openframe(tabid, input = {}) {
+        const tab = requiretab(tabid);
+        const id = String(input.id ?? `frame${tab.frames.size + 1}`);
+        tab.frames.set(id, { id, url: String(input.url ?? tab.url), parentid: input.parentid === undefined ? undefined : String(input.parentid), name: String(input.name ?? "") });
+        return { ...tab.frames.get(id) };
+    }
+    function closeframe(tabid, frameid) { return Boolean(requiretab(tabid).frames.delete(String(frameid))); }
+    function activetab() { return activeid === undefined ? undefined : describetab(requiretab(activeid)); }
+    function describe() { return { sessionid, activeid, tabs: [...tabs.values()].map(describetab) }; }
+    return { sessionid, opentab, closetab, setactive, openframe, closeframe, activetab, describe };
+    function requiretab(id) { const tab = tabs.get(String(id)); if (!tab)
+        throw new Error(`unknown browser tab: ${id}`); return tab; }
+    function describetab(tab) { return { id: tab.id, url: tab.url, title: tab.title, active: tab.active, frames: [...tab.frames.values()].map((frame) => ({ ...frame })) }; }
+}
+//# sourceMappingURL=context.js.map

package/dist/browser/context.js.map

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

package/dist/browser/fingerprint.d.ts

@@ -0,0 +1,4 @@
+export declare function fingerprintprofile(name?: string, overrides?: {}): any;
+export declare function fingerprintvalidate(profile: any): boolean;
+export declare function fingerprintfor(sessionid: any, options?: {}): any;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/browser/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../browser/fingerprint.ts"],"names":[],"mappings":"AASA,wBAAgB,kBAAkB,CAAC,IAAI,SAAmB,EAAE,SAAS,KAAK,OAAoF;AAC9J,wBAAgB,mBAAmB,CAAC,OAAO,KAAA,WAAyJ;AACpM,wBAAgB,cAAc,CAAC,SAAS,KAAA,EAAE,OAAO,KAAK,OAAoO"}

package/{browser → dist/browser}/fingerprint.js

@@ -2,11 +2,11 @@
  * fingerprint profiles keep session settings coherent without modifying browser internals.
  */
 const profiles = Object.freeze({
-  desktopwindows: { os: "windows", platform: "Win32", browser: "chrome", locale: "en-US", timezone: "America/New_York", touch: false, devicepixelratio: 1 },
-  desktopmacos: { os: "macos", platform: "MacIntel", browser: "safari", locale: "en-US", timezone: "America/Los_Angeles", touch: false, devicepixelratio: 2 },
-  mobileandroid: { os: "android", platform: "Linux armv8l", browser: "chrome", locale: "en-US", timezone: "America/Chicago", touch: true, devicepixelratio: 2.75 }
+    desktopwindows: { os: "windows", platform: "Win32", browser: "chrome", locale: "en-US", timezone: "America/New_York", touch: false, devicepixelratio: 1 },
+    desktopmacos: { os: "macos", platform: "MacIntel", browser: "safari", locale: "en-US", timezone: "America/Los_Angeles", touch: false, devicepixelratio: 2 },
+    mobileandroid: { os: "android", platform: "Linux armv8l", browser: "chrome", locale: "en-US", timezone: "America/Chicago", touch: true, devicepixelratio: 2.75 }
 });
-
 export function fingerprintprofile(name = "desktopwindows", overrides = {}) { return { ...(profiles[name] ?? profiles.desktopwindows), ...overrides, name }; }
 export function fingerprintvalidate(profile) { return Boolean(profile?.os && profile?.platform && profile?.browser && profile?.locale && profile?.timezone && typeof profile.touch === "boolean"); }
 export function fingerprintfor(sessionid, options = {}) { const names = options.profiles ?? Object.keys(profiles); const index = [...String(sessionid)].reduce((sum, value) => sum + value.charCodeAt(0), 0) % names.length; return fingerprintprofile(names[index], options.overrides); }
+//# sourceMappingURL=fingerprint.js.map

package/dist/browser/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../browser/fingerprint.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,cAAc,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE;IACzJ,YAAY,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,EAAE;IAC3J,aAAa,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE;CACjK,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAG,gBAAgB,EAAE,SAAS,GAAG,EAAE,IAAI,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9J,MAAM,UAAU,mBAAmB,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,QAAQ,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;AACpM,MAAM,UAAU,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * browser surface exports vendor-neutral context, snapshots, actions and recording contracts.
+ */
+export * from "./agent.js";
+export * from "./actions.js";
+export * from "./context.js";
+export * from "./fingerprint.js";
+export * from "./recorder.js";
+export * from "./session.js";
+export * from "./snapshot.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../browser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/{browser → dist/browser}/index.js

@@ -8,3 +8,4 @@ export * from "./fingerprint.js";
 export * from "./recorder.js";
 export * from "./session.js";
 export * from "./snapshot.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../browser/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/browser/playwright.d.ts

@@ -0,0 +1,11 @@
+/**
+ * browser playwright adapter keeps the optional Node browser provider outside the transport-neutral surface.
+ */
+/** Creates a caller-owned Playwright browser session when the optional peer is installed. */
+export declare function createplaywrightsession(options?: {}): Promise<{
+    browser: any;
+    context: any;
+    page: any;
+    close: () => any;
+}>;
+//# sourceMappingURL=playwright.d.ts.map

package/dist/browser/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../browser/playwright.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6FAA6F;AAC7F,wBAAsB,uBAAuB,CAAC,OAAO,KAAK;;;;;GAgBzD"}

package/dist/browser/playwright.js

@@ -0,0 +1,24 @@
+/**
+ * browser playwright adapter keeps the optional Node browser provider outside the transport-neutral surface.
+ */
+/** Creates a caller-owned Playwright browser session when the optional peer is installed. */
+export async function createplaywrightsession(options = {}) {
+    let playwright;
+    try {
+        playwright = await import("playwright");
+    }
+    catch (error) {
+        const missing = new Error("optional peer dependency 'playwright' is required for the Playwright adapter", { cause: error });
+        missing.code = "OPTIONAL_DEPENDENCY_MISSING";
+        throw missing;
+    }
+    const browsername = options.browser ?? "chromium";
+    const browsertype = playwright[browsername];
+    if (!browsertype || typeof browsertype.launch !== "function")
+        throw new TypeError(`unsupported Playwright browser: ${browsername}`);
+    const browser = await browsertype.launch({ headless: options.headless ?? true, ...(options.launch ?? {}) });
+    const context = await browser.newContext(options.context ?? {});
+    const page = await context.newPage();
+    return { browser, context, page, close: () => browser.close() };
+}
+//# sourceMappingURL=playwright.js.map

package/dist/browser/playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../../browser/playwright.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAO,GAAG,EAAE;IACxD,IAAI,UAAU,CAAC;IACf,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,8EAA8E,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5H,OAAO,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC7C,MAAM,OAAO,CAAC;IAChB,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC;IAClD,MAAM,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,CAAC,MAAM,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,WAAW,EAAE,CAAC,CAAC;IACpI,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5G,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;AAClE,CAAC"}