@trusty-squire/mcp 1.1.34 → 1.1.35-rc.1

package/dist/bot/download-transfer.d.ts

@@ -0,0 +1,12 @@
+import { type Socket } from "node:net";
+export declare const DOWNLOAD_HANDLE_PREFIX = "trusty-squire-download ";
+/** Broker side: stream one redeemed handle, then close the socket. */
+export declare function serveDownloadHandle(socket: Socket, handle: string): void;
+export interface FetchedDownload {
+    path: string;
+    size_bytes: number;
+    sha256: string;
+}
+/** Agent side: redeem a handle and write the file into destDir. */
+export declare function fetchDownloadHandle(socketPath: string, handle: string, destDir: string): Promise<FetchedDownload>;
+//# sourceMappingURL=download-transfer.d.ts.map

package/dist/bot/download-transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-transfer.d.ts","sourceRoot":"","sources":["../../src/bot/download-transfer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AASzD,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAUhE,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAcxE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,CAAC,CAmD1B"}

package/dist/bot/download-transfer.js

@@ -0,0 +1,103 @@
+import { createHash } from "node:crypto";
+import { createReadStream, createWriteStream } from "node:fs";
+import { link, rm } from "node:fs/promises";
+import { createConnection } from "node:net";
+import { join, parse as parsePath } from "node:path";
+import { pipeline } from "node:stream/promises";
+import { redeemDownloadHandle } from "./downloads.js";
+// Delivers a download handle over the shared MCP socket to a process on the
+// agent's machine. The client sends this prefix plus the handle as its first
+// line, instead of an agent identity. The broker replies with one JSON header
+// line, then the raw file bytes.
+export const DOWNLOAD_HANDLE_PREFIX = "trusty-squire-download ";
+/** Broker side: stream one redeemed handle, then close the socket. */
+export function serveDownloadHandle(socket, handle) {
+    const redeemed = redeemDownloadHandle(handle);
+    if (redeemed === null) {
+        socket.end(`${JSON.stringify({ ok: false, error: "unknown_or_expired_handle" })}\n`);
+        return;
+    }
+    const header = {
+        ok: true,
+        filename: redeemed.filename,
+        size_bytes: redeemed.size_bytes,
+        sha256: redeemed.sha256,
+    };
+    socket.write(`${JSON.stringify(header)}\n`);
+    void pipeline(createReadStream(redeemed.path), socket).catch(() => socket.destroy());
+}
+/** Agent side: redeem a handle and write the file into destDir. */
+export async function fetchDownloadHandle(socketPath, handle, destDir) {
+    const socket = createConnection(socketPath);
+    socket.write(`${DOWNLOAD_HANDLE_PREFIX}${handle}\n`);
+    const header = await new Promise((resolve, reject) => {
+        let buffered = Buffer.alloc(0);
+        const onData = (chunk) => {
+            buffered = Buffer.concat([buffered, chunk]);
+            const end = buffered.indexOf(10);
+            if (end < 0) {
+                if (buffered.length > 4096)
+                    reject(new Error("download handle reply has no header"));
+                return;
+            }
+            socket.off("data", onData);
+            socket.off("error", reject);
+            socket.pause();
+            try {
+                resolve({
+                    header: JSON.parse(buffered.subarray(0, end).toString("utf8")),
+                    rest: buffered.subarray(end + 1),
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        };
+        socket.on("data", onData);
+        socket.once("error", reject);
+        socket.once("end", () => reject(new Error("broker closed the connection before replying")));
+    });
+    if (!header.header.ok || !header.header.filename || !header.header.sha256) {
+        socket.destroy();
+        throw new Error(`download handle refused: ${header.header.error ?? "invalid reply"}`);
+    }
+    const { filename, sha256: expected } = header.header;
+    const partial = join(destDir, `.${parsePath(filename).base}.${process.pid}.partial`);
+    const hash = createHash("sha256");
+    let size = 0;
+    const out = createWriteStream(partial, { flags: "wx", mode: 0o600 });
+    try {
+        socket.unshift(header.rest);
+        socket.on("data", (chunk) => {
+            hash.update(chunk);
+            size += chunk.length;
+        });
+        await pipeline(socket, out);
+        const sha256 = hash.digest("hex");
+        if (sha256 !== expected)
+            throw new Error("received file does not match the download sha256");
+        const path = await claimName(partial, destDir, filename);
+        return { path, size_bytes: size, sha256 };
+    }
+    finally {
+        await rm(partial, { force: true });
+    }
+}
+// Hard-link the finished file under the first free name, so an existing file
+// is never overwritten.
+async function claimName(partial, destDir, filename) {
+    const { name, ext } = parsePath(filename);
+    for (let attempt = 0; attempt < 100; attempt += 1) {
+        const path = join(destDir, attempt === 0 ? filename : `${name} (${attempt})${ext}`);
+        try {
+            await link(partial, path);
+            return path;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+        }
+    }
+    throw new Error("dest_dir already holds 100 files with this name");
+}
+//# sourceMappingURL=download-transfer.js.map

package/dist/bot/download-transfer.js.map

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

package/dist/bot/downloads.d.ts

@@ -0,0 +1,64 @@
+import type { Page } from "playwright";
+export type DownloadState = "in_progress" | "complete" | "failed";
+export interface DownloadRecord {
+    download_id: string;
+    state: DownloadState;
+    filename: string;
+    mime_type: string;
+    /** Absolute path on the broker host. Set once the file is in the session folder. */
+    path: string | null;
+    size_bytes: number | null;
+    sha256: string | null;
+    error?: string;
+}
+export declare function downloadsRoot(): string;
+/** A single path segment: no separators, control characters, or dot names. */
+export declare function safeDownloadFilename(suggested: string): string;
+export declare function sha256File(path: string): Promise<string>;
+/** One session's downloads. Records never cross to another tracker. */
+export declare class SessionDownloads {
+    private readonly entries;
+    private readonly watched;
+    private readonly contentTypes;
+    private folder;
+    private committedBytes;
+    private sequence;
+    /** Record every download this page starts. Idempotent per page. */
+    watch(page: Page): void;
+    /** Records whose state changed since the last report, oldest first. */
+    takeReport(): DownloadRecord[];
+    get(downloadId: string): DownloadRecord | undefined;
+    list(): DownloadRecord[];
+    /** Sequence marker; `since(marker)` returns downloads started after it. */
+    marker(): number;
+    since(marker: number): DownloadRecord[];
+    hasInProgress(): boolean;
+    /** Wait until no download started after `marker` is in progress, or until `timeoutMs` passes. */
+    settle(timeoutMs: number, signal?: AbortSignal, marker?: number): Promise<void>;
+    /** Wait for one download to finish. Returns the record in its latest state. */
+    wait(downloadId: string, timeoutMs: number, signal?: AbortSignal): Promise<DownloadRecord | undefined>;
+    /** Cancel running downloads, revoke handles, and delete the session folder. */
+    dispose(): Promise<void>;
+    private sessionFolder;
+    private begin;
+    private finish;
+}
+export interface DownloadHandle {
+    id: string;
+    expires_at: string;
+}
+interface HandleEntry {
+    owner: SessionDownloads;
+    path: string;
+    filename: string;
+    size_bytes: number;
+    sha256: string;
+    expiresAt: number;
+}
+/** A short-lived, single-use bearer for one completed download. */
+export declare function mintDownloadHandle(owner: SessionDownloads, record: DownloadRecord): DownloadHandle;
+export type RedeemedHandle = Omit<HandleEntry, "owner" | "expiresAt">;
+/** Consume a handle. Unknown, used, and expired handles all refuse alike. */
+export declare function redeemDownloadHandle(id: string): RedeemedHandle | null;
+export {};
+//# sourceMappingURL=downloads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.d.ts","sourceRoot":"","sources":["../../src/bot/downloads.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAY,IAAI,EAAY,MAAM,YAAY,CAAC;AAO3D,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAYD,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM9D;AAQD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9D;AAMD,uEAAuE;AACvE,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAK;IAErB,mEAAmE;IACnE,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAsBvB,uEAAuE;IACvE,UAAU,IAAI,cAAc,EAAE;IAU9B,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKnD,IAAI,IAAI,cAAc,EAAE;IAIxB,2EAA2E;IAC3E,MAAM,IAAI,MAAM;IAIhB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAIvC,aAAa,IAAI,OAAO;IAIxB,iGAAiG;IAC3F,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAShF,+EAA+E;IACzE,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAOtC,+EAA+E;IACzE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,KAAK;YAuBC,MAAM;CAmCrB;AA4BD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,cAAc,GACrB,cAAc,CAgBhB;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,WAAW,CAAC,CAAC;AAEtE,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAUtE"}

package/dist/bot/downloads.js

@@ -0,0 +1,300 @@
+import { createHash, randomBytes } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { mkdir, mkdtemp, rm, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, extname, join } from "node:path";
+import { pipeline } from "node:stream/promises";
+const DEFAULT_SESSION_CAP_BYTES = 2 * 1024 * 1024 * 1024;
+const DEFAULT_HANDLE_TTL_MS = 5 * 60_000;
+const RECENT_RESPONSE_LIMIT = 64;
+const MIME_BY_EXTENSION = {
+    ".bin": "application/octet-stream",
+    ".csv": "text/csv",
+    ".gif": "image/gif",
+    ".gz": "application/gzip",
+    ".html": "text/html",
+    ".jpeg": "image/jpeg",
+    ".jpg": "image/jpeg",
+    ".json": "application/json",
+    ".mov": "video/quicktime",
+    ".mp3": "audio/mpeg",
+    ".mp4": "video/mp4",
+    ".pdf": "application/pdf",
+    ".png": "image/png",
+    ".svg": "image/svg+xml",
+    ".txt": "text/plain",
+    ".wav": "audio/wav",
+    ".webm": "video/webm",
+    ".webp": "image/webp",
+    ".zip": "application/zip",
+};
+export function downloadsRoot() {
+    const configured = process.env.TRUSTY_SQUIRE_DOWNLOADS_DIR?.trim();
+    return configured ? configured : join(homedir(), ".trusty-squire", "downloads");
+}
+function sessionCapBytes() {
+    const parsed = Number(process.env.TRUSTY_SQUIRE_DOWNLOAD_SESSION_CAP_BYTES);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_SESSION_CAP_BYTES;
+}
+function handleTtlMs() {
+    const parsed = Number(process.env.TRUSTY_SQUIRE_DOWNLOAD_HANDLE_TTL_MS);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_HANDLE_TTL_MS;
+}
+/** A single path segment: no separators, control characters, or dot names. */
+export function safeDownloadFilename(suggested) {
+    const cleaned = basename(suggested.replace(/[\\/]/g, "_"))
+        .replace(/[\u0000-\u001f\u007f]/g, "")
+        .trim()
+        .slice(0, 200);
+    return cleaned === "" || cleaned === "." || cleaned === ".." ? "download" : cleaned;
+}
+function mimeFor(filename, contentType) {
+    const declared = contentType?.split(";")[0]?.trim().toLowerCase();
+    if (declared)
+        return declared;
+    return MIME_BY_EXTENSION[extname(filename).toLowerCase()] ?? "application/octet-stream";
+}
+export async function sha256File(path) {
+    const hash = createHash("sha256");
+    await pipeline(createReadStream(path), hash);
+    return hash.digest("hex");
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** One session's downloads. Records never cross to another tracker. */
+export class SessionDownloads {
+    entries = new Map();
+    watched = new WeakSet();
+    contentTypes = new Map();
+    folder = null;
+    committedBytes = 0;
+    sequence = 0;
+    /** Record every download this page starts. Idempotent per page. */
+    watch(page) {
+        if (this.watched.has(page))
+            return;
+        this.watched.add(page);
+        const onResponse = (response) => {
+            const contentType = response.headers()["content-type"];
+            if (contentType === undefined)
+                return;
+            this.contentTypes.delete(response.url());
+            this.contentTypes.set(response.url(), contentType);
+            if (this.contentTypes.size > RECENT_RESPONSE_LIMIT) {
+                const oldest = this.contentTypes.keys().next().value;
+                if (oldest !== undefined)
+                    this.contentTypes.delete(oldest);
+            }
+        };
+        const onDownload = (download) => this.begin(download);
+        page.on("response", onResponse);
+        page.on("download", onDownload);
+        page.once("close", () => {
+            page.off("response", onResponse);
+            page.off("download", onDownload);
+        });
+    }
+    /** Records whose state changed since the last report, oldest first. */
+    takeReport() {
+        const changed = [];
+        for (const entry of this.entries.values()) {
+            if (entry.reported === entry.version)
+                continue;
+            entry.reported = entry.version;
+            changed.push({ ...entry.record });
+        }
+        return changed;
+    }
+    get(downloadId) {
+        const entry = this.entries.get(downloadId);
+        return entry === undefined ? undefined : { ...entry.record };
+    }
+    list() {
+        return [...this.entries.values()].map((entry) => ({ ...entry.record }));
+    }
+    /** Sequence marker; `since(marker)` returns downloads started after it. */
+    marker() {
+        return this.sequence;
+    }
+    since(marker) {
+        return [...this.entries.values()].slice(marker).map((entry) => ({ ...entry.record }));
+    }
+    hasInProgress() {
+        return [...this.entries.values()].some((entry) => entry.record.state === "in_progress");
+    }
+    /** Wait until no download started after `marker` is in progress, or until `timeoutMs` passes. */
+    async settle(timeoutMs, signal, marker = 0) {
+        const pending = [...this.entries.values()]
+            .slice(marker)
+            .filter((entry) => entry.record.state === "in_progress")
+            .map((entry) => entry.settled);
+        if (pending.length === 0)
+            return;
+        await waitBounded(Promise.all(pending), timeoutMs, signal);
+    }
+    /** Wait for one download to finish. Returns the record in its latest state. */
+    async wait(downloadId, timeoutMs, signal) {
+        const entry = this.entries.get(downloadId);
+        if (entry === undefined)
+            return undefined;
+        if (entry.record.state === "in_progress")
+            await waitBounded(entry.settled, timeoutMs, signal);
+        return { ...entry.record };
+    }
+    /** Cancel running downloads, revoke handles, and delete the session folder. */
+    async dispose() {
+        const entries = [...this.entries.values()];
+        this.entries.clear();
+        this.sequence = 0;
+        this.committedBytes = 0;
+        revokeHandlesFor(this);
+        await Promise.all(entries.map(async (entry) => {
+            await entry.download?.cancel().catch(() => undefined);
+            await entry.download?.delete().catch(() => undefined);
+        }));
+        const folder = this.folder;
+        this.folder = null;
+        if (folder !== null) {
+            const path = await folder.catch(() => null);
+            if (path !== null)
+                await rm(path, { recursive: true, force: true });
+        }
+    }
+    sessionFolder() {
+        if (this.folder === null) {
+            const root = downloadsRoot();
+            this.folder = mkdir(root, { recursive: true, mode: 0o700 }).then(async () => await mkdtemp(join(root, "session-")));
+        }
+        return this.folder;
+    }
+    begin(download) {
+        const downloadId = `dl-${randomBytes(6).toString("hex")}`;
+        const filename = safeDownloadFilename(download.suggestedFilename());
+        const entry = {
+            record: {
+                download_id: downloadId,
+                state: "in_progress",
+                filename,
+                mime_type: mimeFor(filename, this.contentTypes.get(download.url())),
+                path: null,
+                size_bytes: null,
+                sha256: null,
+            },
+            version: 1,
+            reported: 0,
+            settled: Promise.resolve(),
+            download,
+        };
+        this.entries.set(downloadId, entry);
+        this.sequence += 1;
+        entry.settled = this.finish(entry, download);
+    }
+    async finish(entry, download) {
+        const update = (patch) => {
+            if (this.entries.get(entry.record.download_id) !== entry)
+                return;
+            entry.record = { ...entry.record, ...patch };
+            entry.version += 1;
+        };
+        let counted = 0;
+        try {
+            const staged = await download.path();
+            const failure = await download.failure();
+            if (failure !== null)
+                throw new Error(failure);
+            const size = (await stat(staged)).size;
+            if (this.committedBytes + size > sessionCapBytes())
+                throw new Error("session_download_cap_exceeded");
+            this.committedBytes += size;
+            counted = size;
+            const folder = join(await this.sessionFolder(), entry.record.download_id);
+            await mkdir(folder, { mode: 0o700 });
+            const path = join(folder, entry.record.filename);
+            await download.saveAs(path);
+            await download.delete().catch(() => undefined);
+            const sha256 = await sha256File(path);
+            if (this.entries.get(entry.record.download_id) !== entry) {
+                await rm(folder, { recursive: true, force: true });
+                return;
+            }
+            update({ state: "complete", path, size_bytes: size, sha256 });
+        }
+        catch (error) {
+            if (this.entries.get(entry.record.download_id) === entry)
+                this.committedBytes -= counted;
+            await download.delete().catch(() => undefined);
+            update({ state: "failed", error: errorText(error) });
+        }
+        finally {
+            entry.download = null;
+        }
+    }
+}
+async function waitBounded(work, timeoutMs, signal) {
+    let timer;
+    let onAbort;
+    try {
+        await Promise.race([
+            work,
+            new Promise((resolve) => {
+                timer = setTimeout(resolve, timeoutMs);
+            }),
+            new Promise((_, reject) => {
+                if (signal === undefined)
+                    return;
+                onAbort = () => reject(signal.reason ?? new Error("operation_cancelled"));
+                if (signal.aborted)
+                    onAbort();
+                else
+                    signal.addEventListener("abort", onAbort, { once: true });
+            }),
+        ]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        if (onAbort !== undefined)
+            signal?.removeEventListener("abort", onAbort);
+    }
+}
+const handles = new Map();
+function revokeHandlesFor(owner) {
+    for (const [id, entry] of handles)
+        if (entry.owner === owner)
+            handles.delete(id);
+}
+/** A short-lived, single-use bearer for one completed download. */
+export function mintDownloadHandle(owner, record) {
+    if (record.state !== "complete" || record.path === null || record.sha256 === null)
+        throw new Error("Only a complete download can be handed out");
+    const now = Date.now();
+    for (const [id, entry] of handles)
+        if (entry.expiresAt <= now)
+            handles.delete(id);
+    const id = `dlh-${randomBytes(24).toString("base64url")}`;
+    const expiresAt = now + handleTtlMs();
+    handles.set(id, {
+        owner,
+        path: record.path,
+        filename: record.filename,
+        size_bytes: record.size_bytes ?? 0,
+        sha256: record.sha256,
+        expiresAt,
+    });
+    return { id, expires_at: new Date(expiresAt).toISOString() };
+}
+/** Consume a handle. Unknown, used, and expired handles all refuse alike. */
+export function redeemDownloadHandle(id) {
+    const entry = handles.get(id);
+    handles.delete(id);
+    if (entry === undefined || entry.expiresAt <= Date.now())
+        return null;
+    return {
+        path: entry.path,
+        filename: entry.filename,
+        size_bytes: entry.size_bytes,
+        sha256: entry.sha256,
+    };
+}
+//# sourceMappingURL=downloads.js.map

package/dist/bot/downloads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloads.js","sourceRoot":"","sources":["../../src/bot/downloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AA8BhD,MAAM,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACzD,MAAM,qBAAqB,GAAG,CAAC,GAAG,MAAM,CAAC;AACzC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,MAAM,iBAAiB,GAA2B;IAChD,MAAM,EAAE,0BAA0B;IAClC,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,WAAW;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,CAAC;IACnE,OAAO,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IAC5E,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,yBAAyB,CAAC;AACpF,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACxE,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;SACvD,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC;SACrC,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjB,OAAO,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;AACtF,CAAC;AAED,SAAS,OAAO,CAAC,QAAgB,EAAE,WAA+B;IAChE,MAAM,QAAQ,GAAG,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,uEAAuE;AACvE,MAAM,OAAO,gBAAgB;IACV,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,OAAO,GAAG,IAAI,OAAO,EAAQ,CAAC;IAC9B,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,MAAM,GAA2B,IAAI,CAAC;IACtC,cAAc,GAAG,CAAC,CAAC;IACnB,QAAQ,GAAG,CAAC,CAAC;IAErB,mEAAmE;IACnE,KAAK,CAAC,IAAU;QACd,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,UAAU,GAAG,CAAC,QAAkB,EAAQ,EAAE;YAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC,CAAC;YACvD,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO;YACtC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,qBAAqB,EAAE,CAAC;gBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBACrD,IAAI,MAAM,KAAK,SAAS;oBAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,QAAkB,EAAQ,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uEAAuE;IACvE,UAAU;QACR,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAO;gBAAE,SAAS;YAC/C,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,2EAA2E;IAC3E,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAc;QAClB,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,aAAa;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC;IAC1F,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,MAAoB,EAAE,MAAM,GAAG,CAAC;QAC9D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aACvC,KAAK,CAAC,MAAM,CAAC;aACb,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,aAAa,CAAC;aACvD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACjC,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,IAAI,CACR,UAAkB,EAClB,SAAiB,EACjB,MAAoB;QAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,aAAa;YAAE,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC9F,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,OAAO;QACX,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC1B,MAAM,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC,CAAC,CACH,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,IAAI,KAAK,IAAI;gBAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAC9D,KAAK,IAAI,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAClD,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,QAAkB;QAC9B,MAAM,UAAU,GAAG,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACpE,MAAM,KAAK,GAAU;YACnB,MAAM,EAAE;gBACN,WAAW,EAAE,UAAU;gBACvB,KAAK,EAAE,aAAa;gBACpB,QAAQ;gBACR,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;gBACnE,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,IAAI;aACb;YACD,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,CAAC;YACX,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;YAC1B,QAAQ;SACT,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,KAAY,EAAE,QAAkB;QACnD,MAAM,MAAM,GAAG,CAAC,KAA8B,EAAQ,EAAE;YACtD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK;gBAAE,OAAO;YACjE,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;YAC7C,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QACrB,CAAC,CAAC;QACF,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,OAAO,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;YACvC,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,eAAe,EAAE;gBAChD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC;YAC5B,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,aAAa,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1E,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK,EAAE,CAAC;gBACzD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YACD,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK;gBAAE,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC;YACzF,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;CACF;AAED,KAAK,UAAU,WAAW,CACxB,IAAsB,EACtB,SAAiB,EACjB,MAAoB;IAEpB,IAAI,KAAiC,CAAC;IACtC,IAAI,OAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,IAAI;YACJ,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAC5B,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YACzC,CAAC,CAAC;YACF,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC9B,IAAI,MAAM,KAAK,SAAS;oBAAE,OAAO;gBACjC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;gBAC1E,IAAI,MAAM,CAAC,OAAO;oBAAE,OAAO,EAAE,CAAC;;oBACzB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAgBD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE/C,SAAS,gBAAgB,CAAC,KAAuB;IAC/C,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,OAAO;QAAE,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAChC,KAAuB,EACvB,MAAsB;IAEtB,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAC/E,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,OAAO;QAAE,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG;YAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClF,MAAM,EAAE,GAAG,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;IAC1D,MAAM,SAAS,GAAG,GAAG,GAAG,WAAW,EAAE,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;QACd,KAAK;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS;KACV,CAAC,CAAC;IACH,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;AAC/D,CAAC;AAID,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC"}

package/dist/bot/observe/observe.d.ts

@@ -32,6 +32,7 @@ export declare function compactV2PublicObservation(session: Session, fields: {
     hint?: string;
     page_readiness?: Observation["page_readiness"];
 }, outputFormat?: "compact" | "full"): Observation;
+export declare const CHROME_DOWNLOADS_HINT = "chrome://downloads is Chrome's internal downloads page, which observe cannot read. Use operate_download with session_id and a download_id from the downloads list in an operate_* step result.";
 export declare function observeQuery(sessionId: string, query: string, role?: SafeControlV2["role"], cursor?: string): Promise<Record<string, unknown>>;
 export declare function observedOAuthChallenge(sessionId: string): Promise<Observation["oauth"] | undefined>;
 export declare function observedThreeDsChallenge(sessionId: string): Promise<Observation["three_ds"] | undefined>;

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

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/bot/observe/observe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/bot/observe/observe.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAS,IAAI,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAKxD,OAAO,EACL,qBAAqB,EAWrB,KAAK,aAAa,EAGlB,KAAK,WAAW,EAEjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAe3D,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,SAAS,GAChD,IAAI,CAGN;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GACd,uBAAuB,CAAC,MAAM,CAAC,GAAG,SAAS,CAE7C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAO1E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,CAajG;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,SAAS,GAChD,IAAI,CAGN;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CACX,OAAO,EACP,eAAe,GAAG,uBAAuB,GAAG,gBAAgB,GAAG,mBAAmB,CACnF,GACA,IAAI,CAMN;AAwBD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AA+CD,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,GAChB,sBAAsB,CAKxB;AA0KD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,SAA4C,GACnF,MAAM,CAUR;AAKD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAO7E;AAyGD,6EAA6E;AAC7E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,SAAS,kBAAkB,EAAE,EACvC,IAAI,GAAE,uBAAuB,CAAC,MAAM,CAAC,GAAG,SAAwC,EAChF,OAAO,GAAE,WAAW,CAAC,kBAAkB,EAAE,MAAM,CAA6C,GAC3F;IAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAevD;AA+ED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE;IACN,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;CAChD,EACD,YAAY,GAAE,SAAS,GAAG,MAAe,GACxC,WAAW,CAuBb;AAED,eAAO,MAAM,qBAAqB,mMACgK,CAAC;AAmTnM,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASlC;AAqHD,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAW3C;AA8BD,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAmD9C;AAiED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAmB7F;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,SAAS,GAAG,MAAkB,EACvC,aAAa,CAAC,EAAE,sBAAsB,EACtC,UAAU,CAAC,EAAE,uBAAuB,CAAC,MAAM,CAAC,EAC5C,qBAAqB,UAAQ,EAC7B,YAAY,GAAE,SAAS,GAAG,MAAe,EACzC,kBAAkB,UAAQ,EAC1B,iBAAiB,UAAO,EACxB,YAAY,UAAQ,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,KAAK,IAAI,GAC5D,OAAO,CAAC,WAAW,CAAC,CA0ItB"}

package/dist/bot/observe/observe.js

@@ -490,6 +490,17 @@ export function compactV2PublicObservation(session, fields, outputFormat = "full
         throw new Error("compact-v2 budget metadata exceeded");
     return degraded;
 }
+export const CHROME_DOWNLOADS_HINT = "chrome://downloads is Chrome's internal downloads page, which observe cannot read. Use operate_download with session_id and a download_id from the downloads list in an operate_* step result.";
+// Chrome renders its downloads page in internal components that the page
+// reader cannot see. Point the agent at the session's download records instead.
+function chromeDownloadsObservation(session, page, outputFormat = "compact") {
+    const url = page.url();
+    if (!/^chrome:\/\/downloads(?:[/?#]|$)/.test(url))
+        return undefined;
+    invalidateCompactV2Snapshot(session);
+    retainSessionElements(session, []);
+    return compactV2PublicObservation(session, { url, stage: safeStageV2(url, []), guidance: CHROME_DOWNLOADS_HINT }, outputFormat);
+}
 function pendingPageObservation(session, page, readiness, outputFormat = "compact", hint) {
     invalidateCompactV2Snapshot(session);
     retainSessionElements(session, []);
@@ -776,6 +787,9 @@ async function observeQueryOwned(sessionId, query, role, cursor) {
     // and semantic page hints once, together, before filtering.
     const queryPage = sourcePage ?? session.browser.activePage();
     if (queryPage !== null && queryPage !== undefined) {
+        const downloadsPage = chromeDownloadsObservation(session, queryPage);
+        if (downloadsPage !== undefined)
+            return { ...downloadsPage };
         const readiness = await waitForPageReady(queryPage, { kind: "observation" });
         if (!readiness.ready)
             return { ...pendingPageObservation(session, queryPage, readiness) };
@@ -1039,6 +1053,9 @@ export async function observeSession(session, _detail = "compact", startMetadata
         }
         const observationPage = sourcePage ?? session.browser.activePage();
         if (observationPage !== null && observationPage !== undefined) {
+            const downloadsPage = chromeDownloadsObservation(session, observationPage, outputFormat);
+            if (downloadsPage !== undefined)
+                return downloadsPage;
             const readiness = await waitForPageReady(observationPage, { kind: "observation" });
             if (!readiness.ready) {
                 return pendingPageObservation(session, observationPage, readiness, outputFormat, startMetadata?.hintPages?.[0]);