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

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":"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"}

package/dist/bot/file-picker-route.d.ts

@@ -0,0 +1,8 @@
+import type { Page } from "playwright";
+export interface FilePickerRoute {
+    restore(): Promise<{
+        pickerCalled: boolean;
+    }>;
+}
+export declare function routeFilePickerToChooser(page: Page): Promise<FilePickerRoute>;
+//# sourceMappingURL=file-picker-route.d.ts.map

package/dist/bot/file-picker-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-picker-route.d.ts","sourceRoot":"","sources":["../../src/bot/file-picker-route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,IAAI,EAAE,MAAM,YAAY,CAAC;AAgG9C,MAAM,WAAW,eAAe;IAE9B,OAAO,IAAI,OAAO,CAAC;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAwBnF"}

package/dist/bot/file-picker-route.js

@@ -0,0 +1,94 @@
+// Some upload controls call window.showOpenFilePicker (File System Access API)
+// instead of clicking an <input type=file>. Chromium opens that picker without
+// a file input, so Playwright never emits "filechooser" and the upload times
+// out. MEASURED 2026-10-14 on Dreamina's "Add first frame" card: one trusted
+// click calls showOpenFilePicker with user activation and nothing else.
+//
+// While an upload is armed, replace showOpenFilePicker in each frame with a
+// version that clicks a detached file input instead. The click still runs
+// inside the page's activated call, so the existing chooser interception
+// receives it, and the page gets back handles whose getFile() returns the
+// attached file. The original function is put back once the chooser wait ends.
+const ROUTE_KEY = "trusty-squire.file-picker-route";
+function installRoute(key) {
+    const w = window;
+    const slot = Symbol.for(key);
+    const original = w.showOpenFilePicker;
+    if (typeof original !== "function" || w[slot] !== undefined)
+        return false;
+    const state = { original, calls: 0 };
+    Object.defineProperty(w, slot, { value: state, configurable: true });
+    w.showOpenFilePicker = function showOpenFilePicker(options) {
+        state.calls += 1;
+        return new Promise((resolve, reject) => {
+            const input = document.createElement("input");
+            input.type = "file";
+            input.multiple = options?.multiple === true;
+            input.accept = (options?.types ?? [])
+                .flatMap((type) => Object.entries(type?.accept ?? {}))
+                .flatMap(([mime, extensions]) => [mime, ...[].concat(extensions)])
+                .join(",");
+            const abort = () => reject(new DOMException("The user aborted a request.", "AbortError"));
+            input.addEventListener("cancel", abort, { once: true });
+            input.addEventListener("change", () => {
+                const files = Array.from(input.files ?? []);
+                if (files.length === 0)
+                    return abort();
+                resolve(files.map((file) => {
+                    const handle = Object.create(FileSystemFileHandle.prototype);
+                    Object.defineProperties(handle, {
+                        kind: { value: "file" },
+                        name: { value: file.name },
+                        getFile: { value: async () => file },
+                    });
+                    return handle;
+                }));
+            }, { once: true });
+            input.click();
+        });
+    };
+    return true;
+}
+function removeRoute(key) {
+    const w = window;
+    const slot = Symbol.for(key);
+    const state = w[slot];
+    if (state === undefined)
+        return 0;
+    w.showOpenFilePicker = state.original;
+    delete w[slot];
+    return state.calls;
+}
+// Patchright runs frame.evaluate in an isolated world unless the third argument
+// is false, and the page's own showOpenFilePicker lives in the main world.
+// Playwright rejects a third argument and already evaluates in the main world.
+async function evaluateInMainWorld(frame, fn, key) {
+    const evaluate = frame.evaluate;
+    try {
+        return await evaluate.call(frame, fn, key, false);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith("Too many arguments"))
+            return await frame.evaluate(fn, key);
+        throw error;
+    }
+}
+export async function routeFilePickerToChooser(page) {
+    let frames = [];
+    try {
+        frames = page.frames();
+    }
+    catch {
+        // A page without frames has no picker to route.
+    }
+    const routed = (await Promise.all(frames.map(async (frame) => (await evaluateInMainWorld(frame, installRoute, ROUTE_KEY).catch(() => false))
+        ? frame
+        : null))).filter((frame) => frame !== null);
+    return {
+        async restore() {
+            const calls = await Promise.all(routed.map((frame) => evaluateInMainWorld(frame, removeRoute, ROUTE_KEY).catch(() => 0)));
+            return { pickerCalled: calls.some((count) => count > 0) };
+        },
+    };
+}
+//# sourceMappingURL=file-picker-route.js.map

package/dist/bot/file-picker-route.js.map

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

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>;