auspex 0.4.3 → 0.5.0

package/dist/macro/replay.d.ts

@@ -0,0 +1,26 @@
+import type { LaunchOptions } from "playwright";
+import type { Page } from "playwright-core";
+import type { CookieParam, ProxyConfig } from "../types.js";
+import type { AuspexMacro, MacroReplayOptions, MacroReplayResult } from "./schema.js";
+/** Same knobs as `Auspex` browser runs: stealth launch + context + `replayMacro`. */
+export interface MacroReplayLaunchOptions extends MacroReplayOptions {
+    proxy?: ProxyConfig;
+    cookies?: CookieParam[];
+    extraHTTPHeaders?: Record<string, string>;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    locale?: string;
+    timezoneId?: string;
+    userAgent?: string;
+    /** Merged into `launchStealthBrowser` (e.g. `{ headless: false }`) */
+    browserLaunchOptions?: LaunchOptions;
+}
+/**
+ * Launches stealth Chromium, creates a context (aligned with the agent defaults), runs
+ * {@link replayMacro}, then closes browser resources. Use when you do not already hold a `Page`.
+ */
+export declare function replayMacroWithBrowser(macro: AuspexMacro, options?: MacroReplayLaunchOptions): Promise<MacroReplayResult>;
+export declare function replayMacro(page: Page, macro: AuspexMacro, options?: MacroReplayOptions): Promise<MacroReplayResult>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/macro/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/macro/replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,KAAK,EAAe,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAQtF,qFAAqF;AACrF,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,aAAa,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CA+C5B;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CA+D5B"}

package/dist/macro/replay.js

@@ -0,0 +1,121 @@
+import { launchStealthBrowser, STEALTH_INIT_SCRIPT, CHROME_UA } from "../browser/stealth.js";
+import { DEFAULTS } from "../config/defaults.js";
+import { executeAction } from "../browser/executor.js";
+import { validateUrl } from "../security/url-validator.js";
+/**
+ * Matches `runAgentLoop`: no inter-step `actionDelayMs` after `wait`/`goto` (intrinsic timing)
+ * or after `search` (same as `continue` before the delay block in the agent).
+ */
+const SKIP_INTER_STEP_DELAY_AFTER = new Set(["wait", "goto", "search"]);
+/**
+ * Launches stealth Chromium, creates a context (aligned with the agent defaults), runs
+ * {@link replayMacro}, then closes browser resources. Use when you do not already hold a `Page`.
+ */
+export async function replayMacroWithBrowser(macro, options = {}) {
+    const launchOpts = { ...options.browserLaunchOptions };
+    if (options.proxy) {
+        launchOpts.proxy = {
+            server: options.proxy.server,
+            username: options.proxy.username,
+            password: options.proxy.password,
+        };
+    }
+    const browser = await launchStealthBrowser(launchOpts);
+    try {
+        const contextOptions = {
+            userAgent: options.userAgent ?? CHROME_UA,
+            viewport: options.viewport ?? { width: 1920, height: 1080 },
+            locale: options.locale ?? "pt-BR",
+            timezoneId: options.timezoneId ?? "America/Sao_Paulo",
+            extraHTTPHeaders: options.extraHTTPHeaders,
+        };
+        const context = await browser.newContext(contextOptions);
+        if (options.cookies && options.cookies.length > 0) {
+            const host = new URL(macro.startUrl).hostname;
+            await context.addCookies(options.cookies.map((c) => ({
+                name: c.name,
+                value: c.value,
+                domain: c.domain ?? host,
+                path: c.path ?? "/",
+                httpOnly: c.httpOnly,
+                secure: c.secure,
+                sameSite: c.sameSite,
+                expires: c.expires,
+            })));
+        }
+        await context.addInitScript(STEALTH_INIT_SCRIPT);
+        const page = await context.newPage();
+        try {
+            return await replayMacro(page, macro, options);
+        }
+        finally {
+            await context.close().catch(() => { });
+        }
+    }
+    finally {
+        await browser.close().catch(() => { });
+    }
+}
+export async function replayMacro(page, macro, options = {}) {
+    const urlOptions = {
+        allowedDomains: options.allowedDomains,
+        blockedDomains: options.blockedDomains,
+    };
+    const actionDelayMs = options.actionDelayMs ?? DEFAULTS.actionDelayMs;
+    const gotoTimeoutMs = options.gotoTimeoutMs ?? DEFAULTS.gotoTimeoutMs;
+    const signal = options.signal;
+    const needsSearch = macro.steps.some((s) => s.type === "search");
+    if (needsSearch && !options.searxngClient) {
+        return {
+            status: "error",
+            error: "macro.steps contains search but searxngClient was not provided",
+        };
+    }
+    const dismissDialog = (dialog) => dialog.dismiss().catch(() => { });
+    page.on("dialog", dismissDialog);
+    try {
+        try {
+            await validateUrl(macro.startUrl, urlOptions);
+            await page.goto(macro.startUrl, { waitUntil: "domcontentloaded", timeout: gotoTimeoutMs });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { status: "error", error: `Initial navigation failed: ${msg}` };
+        }
+        for (const step of macro.steps) {
+            if (signal?.aborted) {
+                return { status: "error", error: "Aborted by user" };
+            }
+            if (step.type === "search") {
+                const client = options.searxngClient;
+                if (!client) {
+                    return { status: "error", error: "searxngClient required for search step" };
+                }
+                try {
+                    await client.search(step.query, 5);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return { status: "error", error: `search failed: ${msg}` };
+                }
+            }
+            else {
+                try {
+                    await executeAction(page, step, urlOptions);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return { status: "error", error: `step ${step.type} failed: ${msg}` };
+                }
+            }
+            if (!SKIP_INTER_STEP_DELAY_AFTER.has(step.type) && actionDelayMs > 0) {
+                await page.waitForTimeout(actionDelayMs);
+            }
+        }
+        return { status: "ok" };
+    }
+    finally {
+        page.off("dialog", dismissDialog);
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/macro/replay.js.map

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

package/dist/macro/schema.d.ts

@@ -0,0 +1,440 @@
+import { z } from "zod";
+import type { SearXNGClient } from "../search/searxng-client.js";
+export declare const macroStepSchema: z.ZodEffects<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"search">;
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "search";
+    query: string;
+}, {
+    type: "search";
+    query: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"click">;
+    selector: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    type: "click";
+    selector: string;
+}, {
+    type: "click";
+    selector: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"type">;
+    selector: z.ZodEffects<z.ZodString, string, string>;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "type";
+    selector: string;
+    text: string;
+}, {
+    type: "type";
+    selector: string;
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"select">;
+    selector: z.ZodEffects<z.ZodString, string, string>;
+    value: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "select";
+    value: string;
+    selector: string;
+}, {
+    type: "select";
+    value: string;
+    selector: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"pressKey">;
+    key: z.ZodEnum<["Enter", "Tab", "Escape", "Backspace", "Delete", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown", "Space", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "pressKey";
+    key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+}, {
+    type: "pressKey";
+    key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"hover">;
+    selector: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    type: "hover";
+    selector: string;
+}, {
+    type: "hover";
+    selector: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"goto">;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "goto";
+    url: string;
+}, {
+    type: "goto";
+    url: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"wait">;
+    ms: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    type: "wait";
+    ms: number;
+}, {
+    type: "wait";
+    ms: number;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"scroll">;
+    direction: z.ZodEnum<["up", "down"]>;
+    amount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "scroll";
+    direction: "up" | "down";
+    amount?: number | undefined;
+}, {
+    type: "scroll";
+    direction: "up" | "down";
+    amount?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    result: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "done";
+    result: string;
+}, {
+    type: "done";
+    result: string;
+}>]>, {
+    type: "search";
+    query: string;
+} | {
+    type: "click";
+    selector: string;
+} | {
+    type: "type";
+    selector: string;
+    text: string;
+} | {
+    type: "select";
+    value: string;
+    selector: string;
+} | {
+    type: "pressKey";
+    key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+} | {
+    type: "hover";
+    selector: string;
+} | {
+    type: "goto";
+    url: string;
+} | {
+    type: "wait";
+    ms: number;
+} | {
+    type: "scroll";
+    direction: "up" | "down";
+    amount?: number | undefined;
+} | {
+    type: "done";
+    result: string;
+}, {
+    type: "search";
+    query: string;
+} | {
+    type: "click";
+    selector: string;
+} | {
+    type: "type";
+    selector: string;
+    text: string;
+} | {
+    type: "select";
+    value: string;
+    selector: string;
+} | {
+    type: "pressKey";
+    key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+} | {
+    type: "hover";
+    selector: string;
+} | {
+    type: "goto";
+    url: string;
+} | {
+    type: "wait";
+    ms: number;
+} | {
+    type: "scroll";
+    direction: "up" | "down";
+    amount?: number | undefined;
+} | {
+    type: "done";
+    result: string;
+}>;
+export declare const auspexMacroSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    startUrl: z.ZodString;
+    sourceTier: z.ZodEnum<["http", "playwright"]>;
+    steps: z.ZodArray<z.ZodEffects<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"search">;
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "search";
+        query: string;
+    }, {
+        type: "search";
+        query: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"click">;
+        selector: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        type: "click";
+        selector: string;
+    }, {
+        type: "click";
+        selector: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"type">;
+        selector: z.ZodEffects<z.ZodString, string, string>;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "type";
+        selector: string;
+        text: string;
+    }, {
+        type: "type";
+        selector: string;
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"select">;
+        selector: z.ZodEffects<z.ZodString, string, string>;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "select";
+        value: string;
+        selector: string;
+    }, {
+        type: "select";
+        value: string;
+        selector: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"pressKey">;
+        key: z.ZodEnum<["Enter", "Tab", "Escape", "Backspace", "Delete", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Home", "End", "PageUp", "PageDown", "Space", "F1", "F2", "F3", "F4", "F5", "F6", "F7", "F8", "F9", "F10", "F11", "F12"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "pressKey";
+        key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+    }, {
+        type: "pressKey";
+        key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"hover">;
+        selector: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        type: "hover";
+        selector: string;
+    }, {
+        type: "hover";
+        selector: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"goto">;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "goto";
+        url: string;
+    }, {
+        type: "goto";
+        url: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"wait">;
+        ms: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        type: "wait";
+        ms: number;
+    }, {
+        type: "wait";
+        ms: number;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"scroll">;
+        direction: z.ZodEnum<["up", "down"]>;
+        amount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type: "scroll";
+        direction: "up" | "down";
+        amount?: number | undefined;
+    }, {
+        type: "scroll";
+        direction: "up" | "down";
+        amount?: number | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"done">;
+        result: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "done";
+        result: string;
+    }, {
+        type: "done";
+        result: string;
+    }>]>, {
+        type: "search";
+        query: string;
+    } | {
+        type: "click";
+        selector: string;
+    } | {
+        type: "type";
+        selector: string;
+        text: string;
+    } | {
+        type: "select";
+        value: string;
+        selector: string;
+    } | {
+        type: "pressKey";
+        key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+    } | {
+        type: "hover";
+        selector: string;
+    } | {
+        type: "goto";
+        url: string;
+    } | {
+        type: "wait";
+        ms: number;
+    } | {
+        type: "scroll";
+        direction: "up" | "down";
+        amount?: number | undefined;
+    } | {
+        type: "done";
+        result: string;
+    }, {
+        type: "search";
+        query: string;
+    } | {
+        type: "click";
+        selector: string;
+    } | {
+        type: "type";
+        selector: string;
+        text: string;
+    } | {
+        type: "select";
+        value: string;
+        selector: string;
+    } | {
+        type: "pressKey";
+        key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+    } | {
+        type: "hover";
+        selector: string;
+    } | {
+        type: "goto";
+        url: string;
+    } | {
+        type: "wait";
+        ms: number;
+    } | {
+        type: "scroll";
+        direction: "up" | "down";
+        amount?: number | undefined;
+    } | {
+        type: "done";
+        result: string;
+    }>, "many">;
+    capturedResult: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    startUrl: string;
+    sourceTier: "http" | "playwright";
+    steps: ({
+        type: "search";
+        query: string;
+    } | {
+        type: "click";
+        selector: string;
+    } | {
+        type: "type";
+        selector: string;
+        text: string;
+    } | {
+        type: "select";
+        value: string;
+        selector: string;
+    } | {
+        type: "pressKey";
+        key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+    } | {
+        type: "hover";
+        selector: string;
+    } | {
+        type: "goto";
+        url: string;
+    } | {
+        type: "wait";
+        ms: number;
+    } | {
+        type: "scroll";
+        direction: "up" | "down";
+        amount?: number | undefined;
+    } | {
+        type: "done";
+        result: string;
+    })[];
+    capturedResult?: string | undefined;
+}, {
+    version: 1;
+    startUrl: string;
+    sourceTier: "http" | "playwright";
+    steps: ({
+        type: "search";
+        query: string;
+    } | {
+        type: "click";
+        selector: string;
+    } | {
+        type: "type";
+        selector: string;
+        text: string;
+    } | {
+        type: "select";
+        value: string;
+        selector: string;
+    } | {
+        type: "pressKey";
+        key: "Enter" | "Tab" | "Escape" | "Backspace" | "Delete" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "Home" | "End" | "PageUp" | "PageDown" | "Space" | "F1" | "F2" | "F3" | "F4" | "F5" | "F6" | "F7" | "F8" | "F9" | "F10" | "F11" | "F12";
+    } | {
+        type: "hover";
+        selector: string;
+    } | {
+        type: "goto";
+        url: string;
+    } | {
+        type: "wait";
+        ms: number;
+    } | {
+        type: "scroll";
+        direction: "up" | "down";
+        amount?: number | undefined;
+    } | {
+        type: "done";
+        result: string;
+    })[];
+    capturedResult?: string | undefined;
+}>;
+export type AuspexMacro = z.infer<typeof auspexMacroSchema>;
+export declare class MacroParseError extends Error {
+    constructor(message: string);
+}
+export type MacroReplayStatus = "ok" | "error";
+export interface MacroReplayResult {
+    status: MacroReplayStatus;
+    error?: string;
+}
+export interface MacroReplayOptions {
+    allowedDomains?: string[];
+    blockedDomains?: string[];
+    /** Delay in ms after each step except `wait`, `goto`, and `search` (matches the agent loop). Default: 500 */
+    actionDelayMs?: number;
+    /** Timeout for `page.goto` of `startUrl` and per-step `goto`. Default: 15000 */
+    gotoTimeoutMs?: number;
+    /** Required when `macro.steps` contains `type: "search"` */
+    searxngClient?: SearXNGClient;
+    /** Passed through for replay (not stored in macro) */
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/macro/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/macro/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO1B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6GAA6G;IAC7G,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,sDAAsD;IACtD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/macro/schema.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { actionSchema } from "../security/action-validator.js";
+export const macroStepSchema = actionSchema.superRefine((val, ctx) => {
+    if (val.type === "done") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Macro step cannot be type done",
+        });
+    }
+});
+export const auspexMacroSchema = z.object({
+    version: z.literal(1),
+    startUrl: z.string().url(),
+    sourceTier: z.enum(["http", "playwright"]),
+    steps: z.array(macroStepSchema),
+    capturedResult: z.string().optional(),
+});
+export class MacroParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MacroParseError";
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/macro/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/macro/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAG/D,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACnE,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACxB,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,gCAAgC;SAC1C,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC/B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAIH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/macro/serialize.d.ts

@@ -0,0 +1,4 @@
+import { type AuspexMacro } from "./schema.js";
+export declare function macroToJsonString(macro: AuspexMacro): string;
+export declare function parseMacroJson(json: string): AuspexMacro;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/macro/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/macro/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEnF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAaxD"}

package/dist/macro/serialize.js

@@ -0,0 +1,20 @@
+import { MacroParseError, auspexMacroSchema } from "./schema.js";
+export function macroToJsonString(macro) {
+    return JSON.stringify(macro);
+}
+export function parseMacroJson(json) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new MacroParseError("Invalid JSON");
+    }
+    const r = auspexMacroSchema.safeParse(parsed);
+    if (!r.success) {
+        const msg = r.error.issues.map((i) => i.message).join("; ");
+        throw new MacroParseError(msg || "Invalid macro");
+    }
+    return r.data;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/macro/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/macro/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAEnF,MAAM,UAAU,iBAAiB,CAAC,KAAkB;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,eAAe,CAAC,cAAc,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,CAAC,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,IAAI,eAAe,CAAC,GAAG,IAAI,eAAe,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,CAAC;AAChB,CAAC"}