@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/attachments/ocr.js

@@ -0,0 +1,170 @@
+import { CliError } from "@wirecat/cli-base";
+import { imageSize } from "image-size";
+import { isCliFailure } from "../cli/failures.js";
+import { withRecovery } from "../cli/recovery.js";
+import { MAX_MODEL_IMAGE_BYTES } from "../models/types.js";
+import { MAX_TEXT_CHARS } from "./extract.js";
+const MAX_PAGES = 20;
+const MAX_PIXELS = 20_000_000;
+const cancelled = (signal) => {
+    if (signal?.aborted)
+        throw new CliError("cancelled", "attachment OCR cancelled");
+};
+const imageOf = (bytes) => {
+    if (bytes.byteLength > MAX_MODEL_IMAGE_BYTES)
+        return undefined;
+    const { width, height, type } = imageSize(bytes);
+    if (!Number.isSafeInteger(width) || !Number.isSafeInteger(height) || width < 1 || height < 1)
+        throw new Error("invalid image dimensions");
+    if (width * height > MAX_PIXELS || width > 8000 || height > 8000)
+        return undefined;
+    const mimeType = type === "jpg" ? "image/jpeg" : type === "png" ? "image/png" : type === "webp" ? "image/webp" : null;
+    if (mimeType === null)
+        return undefined;
+    return { mimeType, data: Buffer.from(bytes).toString("base64") };
+};
+const checkedText = (text) => {
+    if (typeof text !== "string" || !text.trim() || text.length > MAX_TEXT_CHARS)
+        throw new Error("empty or oversized OCR result");
+    return text;
+};
+export const ocrImage = async (bytes, pipeline, signal) => {
+    cancelled(signal);
+    try {
+        const image = imageOf(bytes);
+        if (image === undefined)
+            return { status: "needs-agent", extractor: pipeline.extractor };
+        const text = checkedText(await pipeline.transcribe(image));
+        cancelled(signal);
+        return { status: "extracted", text, extractor: pipeline.extractor, pages: 1, ocrPages: 1 };
+    }
+    catch (error) {
+        cancelled(signal);
+        return {
+            status: "unreadable",
+            extractor: pipeline.extractor,
+            error: error instanceof CliError && error.code === "rate_limited" ? "rate_limited" : "ocr_failed",
+            issue: withRecovery({
+                code: isCliFailure(error) ? error.code : "provider_error",
+                message: "OCR provider refused this item; retry or skip it",
+                ...(isCliFailure(error) && typeof error.details?.retry_after_ms === "number"
+                    ? { retry_after_ms: error.details.retry_after_ms }
+                    : {}),
+            }),
+        };
+    }
+};
+export const ocrPdf = async (bytes, pipeline, load, signal) => {
+    cancelled(signal);
+    let unpdf;
+    try {
+        unpdf = (await load("unpdf"));
+    }
+    catch {
+        return { status: "engine-missing", engine: "unpdf" };
+    }
+    let document;
+    let rendered;
+    const close = () => {
+        void document?.loadingTask.destroy().catch(() => { });
+        void rendered?.loadingTask.destroy().catch(() => { });
+    };
+    try {
+        // Inspect page text before loading the optional renderer; text-only PDFs stay local.
+        document = await unpdf.getDocumentProxy(new Uint8Array(bytes), {
+            isEvalSupported: false,
+            verbosity: 0,
+            maxImageSize: MAX_PIXELS,
+        });
+        signal?.addEventListener("abort", close, { once: true });
+        cancelled(signal);
+        if (!Number.isSafeInteger(document.numPages) || document.numPages < 1 || document.numPages > MAX_PAGES)
+            return { status: "too-large" };
+        const texts = [];
+        let ocrPages = 0;
+        let canvas;
+        try {
+            for (let index = 1; index <= document.numPages; index += 1) {
+                cancelled(signal);
+                const page = await document.getPage(index);
+                let text;
+                try {
+                    const content = await page.getTextContent();
+                    text = content.items
+                        .map((item) => `${item.str ?? ""}${item.hasEOL ? "\n" : " "}`)
+                        .join("")
+                        .trim();
+                    if (!text) {
+                        if (typeof unpdf.createIsomorphicCanvasFactory !== "function" ||
+                            typeof unpdf.renderPageAsImage !== "function")
+                            return { status: "engine-missing", engine: "unpdf" };
+                        if (canvas === undefined) {
+                            try {
+                                canvas = await load("@napi-rs/canvas");
+                            }
+                            catch {
+                                return { status: "engine-missing", engine: "@napi-rs/canvas" };
+                            }
+                            const CanvasFactory = await unpdf.createIsomorphicCanvasFactory(async () => canvas);
+                            rendered = await unpdf.getDocumentProxy(new Uint8Array(bytes), {
+                                CanvasFactory,
+                                isEvalSupported: false,
+                                verbosity: 0,
+                                maxImageSize: MAX_PIXELS,
+                            });
+                        }
+                        const viewport = page.getViewport({ scale: 1 });
+                        if (![viewport.width, viewport.height].every((value) => Number.isFinite(value) && value > 0))
+                            throw new Error("invalid PDF dimensions");
+                        const scale = Math.min(2, 2000 / viewport.width, 2000 / viewport.height);
+                        const image = imageOf(new Uint8Array(await unpdf.renderPageAsImage(rendered, index, {
+                            scale,
+                            canvasImport: async () => canvas,
+                        })));
+                        if (!image)
+                            return { status: "too-large" };
+                        text = checkedText(await pipeline.transcribe(image));
+                        ocrPages += 1;
+                    }
+                }
+                finally {
+                    page.cleanup();
+                }
+                cancelled(signal);
+                texts.push(text);
+                if (texts.reduce((sum, one) => sum + one.length + 2, 0) > MAX_TEXT_CHARS)
+                    return { status: "too-large" };
+            }
+            return {
+                status: "extracted",
+                text: texts.join("\n\n"),
+                extractor: pipeline.extractor,
+                pages: document.numPages,
+                ocrPages,
+            };
+        }
+        finally {
+            await rendered?.loadingTask.destroy();
+        }
+    }
+    catch (error) {
+        cancelled(signal);
+        return {
+            status: "unreadable",
+            extractor: pipeline.extractor,
+            error: error instanceof CliError && error.code === "rate_limited" ? "rate_limited" : "ocr_failed",
+            issue: withRecovery({
+                code: isCliFailure(error) ? error.code : "provider_error",
+                message: "OCR provider refused this item; retry or skip it",
+                ...(isCliFailure(error) && typeof error.details?.retry_after_ms === "number"
+                    ? { retry_after_ms: error.details.retry_after_ms }
+                    : {}),
+            }),
+        };
+    }
+    finally {
+        signal?.removeEventListener("abort", close);
+        await document?.loadingTask.destroy();
+    }
+};
+//# sourceMappingURL=ocr.js.map

package/dist/attachments/ocr.js.map

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

package/dist/attachments/pdf-preview.d.ts

@@ -0,0 +1,7 @@
+import { type LoadEngine } from "./extract.js";
+export declare const pdfPreview: (bytes: Uint8Array, page: number, signal?: AbortSignal, load?: LoadEngine, env?: NodeJS.ProcessEnv) => Promise<{
+    bytes: Buffer<ArrayBufferLike>;
+    page: number;
+    pageCount: number;
+}>;
+//# sourceMappingURL=pdf-preview.d.ts.map

package/dist/attachments/pdf-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-preview.d.ts","sourceRoot":"","sources":["../../src/attachments/pdf-preview.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAA;AAsB5D,eAAO,MAAM,UAAU,UACd,UAAU,QACX,MAAM,WACH,WAAW,SACd,UAAU,QACX,MAAM,CAAC,UAAU;;;;EA8EvB,CAAA"}

package/dist/attachments/pdf-preview.js

@@ -0,0 +1,83 @@
+import { CliError } from "@wirecat/cli-base";
+import { imageSize } from "image-size";
+import { importEngine } from "./extract.js";
+import { pdfPreviewLimits } from "./limits.js";
+export const pdfPreview = async (bytes, page, signal, load = importEngine, env = process.env) => {
+    const limits = pdfPreviewLimits(env);
+    const cancelled = () => {
+        if (signal?.aborted)
+            throw new CliError("cancelled", "PDF preview cancelled");
+    };
+    cancelled();
+    if (!Number.isSafeInteger(page) || page < 1)
+        throw new CliError("validation_error", "PDF page must be a position from 1");
+    const optional = async (name) => {
+        try {
+            return await load(name);
+        }
+        catch {
+            throw new CliError("validation_error", `PDF page previews need the optional package ${name}`);
+        }
+    };
+    const engine = (await optional("unpdf"));
+    if (typeof engine.createIsomorphicCanvasFactory !== "function" || typeof engine.renderPageAsImage !== "function")
+        throw new CliError("validation_error", "PDF page previews need unpdf with rendering support (1.8.1 or later)");
+    const canvas = await optional("@napi-rs/canvas");
+    cancelled();
+    let document;
+    let closed;
+    const close = () => {
+        if (document && !closed)
+            closed = document.loadingTask.destroy().catch(() => { });
+    };
+    try {
+        const CanvasFactory = await engine.createIsomorphicCanvasFactory(async () => canvas);
+        document = await engine.getDocumentProxy(new Uint8Array(bytes), {
+            CanvasFactory,
+            isEvalSupported: false,
+            verbosity: 0,
+            maxImageSize: Math.max(20_000_000, limits.pixels * limits.pixels),
+        });
+        signal?.addEventListener("abort", close, { once: true });
+        cancelled();
+        if (!Number.isSafeInteger(document.numPages) || document.numPages < 1)
+            throw new CliError("validation_error", "PDF page count must be a positive integer");
+        if (page > document.numPages)
+            throw new CliError("validation_error", "PDF page is past the end of the document");
+        const selected = await document.getPage(page);
+        let image;
+        try {
+            const viewport = selected.getViewport({ scale: 1 });
+            if (![viewport.width, viewport.height].every((value) => Number.isFinite(value) && value > 0))
+                throw new Error("invalid dimensions");
+            image = Buffer.from(await engine.renderPageAsImage(document, page, {
+                scale: Math.min(4, limits.pixels / viewport.width, limits.pixels / viewport.height),
+                canvasImport: async () => canvas,
+            }));
+        }
+        finally {
+            selected.cleanup();
+        }
+        cancelled();
+        if (image.byteLength > limits.bytes)
+            throw new CliError("validation_error", `PDF preview exceeds ${limits.bytes / 1024 / 1024} MiB; configure MESSAGING_PDF_PREVIEW_MAX_MIB`);
+        const { width, height, type } = imageSize(image);
+        if (type !== "png" || width < 1 || height < 1)
+            throw new CliError("validation_error", "PDF preview has unsupported image dimensions or format");
+        if (width > limits.pixels || height > limits.pixels)
+            throw new CliError("validation_error", `PDF preview dimensions exceed ${limits.pixels} pixels per side; configure MESSAGING_PDF_PREVIEW_MAX_PIXELS`);
+        return { bytes: image, page, pageCount: document.numPages };
+    }
+    catch (error) {
+        cancelled();
+        if (error instanceof CliError)
+            throw error;
+        throw new CliError("validation_error", "the retained PDF cannot be rendered");
+    }
+    finally {
+        signal?.removeEventListener("abort", close);
+        close();
+        await closed;
+    }
+};
+//# sourceMappingURL=pdf-preview.js.map

package/dist/attachments/pdf-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-preview.js","sourceRoot":"","sources":["../../src/attachments/pdf-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,YAAY,EAAmB,MAAM,cAAc,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAqB9C,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,KAAiB,EACjB,IAAY,EACZ,MAAoB,EACpB,IAAI,GAAe,YAAY,EAC/B,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,EAAE;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,SAAS,GAAG,GAAG,EAAE;QACrB,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAA;IAC/E,CAAC,CAAA;IACD,SAAS,EAAE,CAAA;IACX,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;QACzC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,oCAAoC,CAAC,CAAA;IAC9E,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAiC,EAAE,EAAE;QAC3D,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,+CAA+C,IAAI,EAAE,CAAC,CAAA;QAC/F,CAAC;IACH,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAW,CAAA;IAClD,IAAI,OAAO,MAAM,CAAC,6BAA6B,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,iBAAiB,KAAK,UAAU;QAC9G,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,sEAAsE,CAAC,CAAA;IAChH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAAC,CAAA;IAChD,SAAS,EAAE,CAAA;IACX,IAAI,QAA8B,CAAA;IAClC,IAAI,MAAiC,CAAA;IACrC,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,QAAQ,IAAI,CAAC,MAAM;YAAE,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAClF,CAAC,CAAA;IACD,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,CAAA;QACpF,QAAQ,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE;YAC9D,aAAa;YACb,eAAe,EAAE,KAAK;YACtB,SAAS,EAAE,CAAC;YACZ,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;SAClE,CAAC,CAAA;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACxD,SAAS,EAAE,CAAA;QACX,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,GAAG,CAAC;YACnE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,2CAA2C,CAAC,CAAA;QACrF,IAAI,IAAI,GAAG,QAAQ,CAAC,QAAQ;YAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAA;QAChH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC7C,IAAI,KAAa,CAAA;QACjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;YACnD,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;gBAC1F,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;YACvC,KAAK,GAAG,MAAM,CAAC,IAAI,CACjB,MAAM,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE;gBAC7C,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACnF,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM;aACjC,CAAC,CACH,CAAA;QACH,CAAC;gBAAS,CAAC;YACT,QAAQ,CAAC,OAAO,EAAE,CAAA;QACpB,CAAC;QACD,SAAS,EAAE,CAAA;QACX,IAAI,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK;YACjC,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,uBAAuB,MAAM,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,+CAA+C,CACjG,CAAA;QACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;QAChD,IAAI,IAAI,KAAK,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC;YAC3C,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,wDAAwD,CAAC,CAAA;QAClG,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM;YACjD,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,iCAAiC,MAAM,CAAC,MAAM,8DAA8D,CAC7G,CAAA;QACH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAA;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,EAAE,CAAA;QACX,IAAI,KAAK,YAAY,QAAQ;YAAE,MAAM,KAAK,CAAA;QAC1C,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,qCAAqC,CAAC,CAAA;IAC/E,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC3C,KAAK,EAAE,CAAA;QACP,MAAM,MAAM,CAAA;IACd,CAAC;AACH,CAAC,CAAA"}

package/dist/attachments/sheets.d.ts

@@ -0,0 +1,29 @@
+export interface SheetCell {
+    /** From 1, as the spreadsheet numbers it. */
+    row: number;
+    /** From 1: A is 1. */
+    column: number;
+    /** As displayed; empty means no value. */
+    value: string;
+}
+export interface Sheet {
+    name: string;
+    cells: readonly SheetCell[];
+}
+export declare const columnName: (column: number) => string;
+/**
+ * Sheets as text a search snippet can stand on: each row repeats its column names, so a row found on
+ * its own still says what its values are.
+ *
+ * ```
+ * # Budget
+ * Row 2: Item: Rent; Amount: 1200
+ * ```
+ *
+ * Empty cells are left out. Stops at `maxChars`, at a row boundary, and says so with `truncated`.
+ */
+export declare const sheetText: (sheets: readonly Sheet[], maxChars?: number) => {
+    text: string;
+    truncated: boolean;
+};
+//# sourceMappingURL=sheets.d.ts.map

package/dist/attachments/sheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheets.d.ts","sourceRoot":"","sources":["../../src/attachments/sheets.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,SAAS,EAAE,CAAA;CAC5B;AAED,eAAO,MAAM,UAAU,WAAY,MAAM,KAAG,MAK3C,CAAA;AAkBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,WACZ,SAAS,KAAK,EAAE,aACd,MAAM,KACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAoCpC,CAAA"}

package/dist/attachments/sheets.js

@@ -0,0 +1,70 @@
+import { MAX_TEXT_CHARS } from "./limits.js";
+export const columnName = (column) => {
+    let name = "";
+    for (let rest = column; rest > 0; rest = Math.floor((rest - 1) / 26))
+        name = String.fromCharCode(65 + ((rest - 1) % 26)) + name;
+    return name;
+};
+const NUMBER_LIKE = /^[-+]?[\d\s.,]+%?$|^\d{4}-\d{2}-\d{2}/;
+/**
+ * The first non-empty row names the columns when every value in it is text, no two alike, and rows
+ * follow it; otherwise columns go by their letters.
+ */
+const headerOf = (rows) => {
+    const [first, ...rest] = rows;
+    if (!first || rest.length === 0)
+        return undefined;
+    const values = [...first[1].values()];
+    if (values.some((value) => NUMBER_LIKE.test(value)) || new Set(values).size !== values.length)
+        return undefined;
+    return first[1];
+};
+const oneLine = (value) => value.replace(/\s*[\r\n]+\s*/g, " ").trim();
+/**
+ * Sheets as text a search snippet can stand on: each row repeats its column names, so a row found on
+ * its own still says what its values are.
+ *
+ * ```
+ * # Budget
+ * Row 2: Item: Rent; Amount: 1200
+ * ```
+ *
+ * Empty cells are left out. Stops at `maxChars`, at a row boundary, and says so with `truncated`.
+ */
+export const sheetText = (sheets, maxChars = MAX_TEXT_CHARS) => {
+    const parts = [];
+    let length = 0;
+    const add = (line) => {
+        if (length + line.length > maxChars)
+            return false;
+        parts.push(line);
+        length += line.length;
+        return true;
+    };
+    for (const sheet of sheets) {
+        const byRow = new Map();
+        for (const { row, column, value } of sheet.cells) {
+            const shown = oneLine(value);
+            if (shown === "")
+                continue;
+            const cells = byRow.get(row) ?? new Map();
+            cells.set(column, shown);
+            byRow.set(row, cells);
+        }
+        const rows = [...byRow.entries()]
+            .sort(([a], [b]) => a - b)
+            .map(([row, cells]) => [row, new Map([...cells.entries()].sort(([a], [b]) => a - b))]);
+        if (rows.length === 0)
+            continue;
+        const header = headerOf(rows);
+        if (!add(`${parts.length ? "\n" : ""}# ${oneLine(sheet.name)}\n`))
+            return { text: parts.join("").trim(), truncated: true };
+        for (const [row, cells] of header ? rows.slice(1) : rows) {
+            const fields = [...cells.entries()].map(([column, value]) => `${header?.get(column) ?? columnName(column)}: ${value}`);
+            if (!add(`Row ${row}: ${fields.join("; ")}\n`))
+                return { text: parts.join("").trim(), truncated: true };
+        }
+    }
+    return { text: parts.join("").trim(), truncated: false };
+};
+//# sourceMappingURL=sheets.js.map

package/dist/attachments/sheets.js.map

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

package/dist/attachments/transfer.d.ts

@@ -0,0 +1,25 @@
+export declare const MAX_CHUNK_BYTES: number;
+export interface ByteWindow {
+    offsetBytes?: number;
+    chunkBytes?: number;
+    ifSha256?: string;
+    signal?: AbortSignal;
+}
+export declare const validateWindow: ({ offsetBytes, chunkBytes, ifSha256 }: ByteWindow) => {
+    offsetBytes: number;
+    chunkBytes: number;
+};
+/** Hash and capture the requested bytes in one bounded pass; never return a filesystem path. */
+export declare const retainedBytes: (path: string, options: ByteWindow, captureFile?: boolean, env?: NodeJS.ProcessEnv) => Promise<{
+    totalBytes: number;
+    sha256: string;
+    offsetBytes: number;
+    readBytes: number;
+    nextOffsetBytes: number | null;
+    complete: boolean;
+    base64: string;
+    head: Buffer<ArrayBuffer>;
+    capturedFile: Buffer<ArrayBuffer> | undefined;
+}>;
+export declare const transferMime: (head: Buffer, hint: string | null, name?: string | null) => string;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/attachments/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../src/attachments/transfer.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,QAAc,CAAA;AAC1C,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AACD,eAAO,MAAM,cAAc,0CAAwD,UAAU;;;CAc5F,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,aAAa,SAClB,MAAM,WACH,UAAU,+BAEd,MAAM,CAAC,UAAU;;;;;;;;;;EA8EvB,CAAA;AAED,eAAO,MAAM,YAAY,SAAU,MAAM,QAAQ,MAAM,GAAG,IAAI,SAAQ,MAAM,GAAG,IAAI,KAAU,MAgB5F,CAAA"}

package/dist/attachments/transfer.js

@@ -0,0 +1,121 @@
+import { createHash } from "node:crypto";
+import { constants } from "node:fs";
+import { lstat, open } from "node:fs/promises";
+import { CliError } from "@wirecat/cli-base";
+import { attachmentMaxBytes } from "./limits.js";
+export const MAX_CHUNK_BYTES = 1024 * 1024;
+export const validateWindow = ({ offsetBytes = 0, chunkBytes = 524288, ifSha256 }) => {
+    if (!Number.isSafeInteger(offsetBytes) ||
+        offsetBytes < 0 ||
+        !Number.isSafeInteger(chunkBytes) ||
+        chunkBytes < 1 ||
+        chunkBytes > MAX_CHUNK_BYTES ||
+        (ifSha256 !== undefined && !/^[a-f0-9]{64}$/i.test(ifSha256)))
+        throw new CliError("validation_error", "use a nonnegative byte offset, a chunk of 1–1048576 bytes and a SHA-256 hash");
+    return { offsetBytes, chunkBytes };
+};
+/** Hash and capture the requested bytes in one bounded pass; never return a filesystem path. */
+export const retainedBytes = async (path, options, captureFile = false, env = process.env) => {
+    const maxBytes = attachmentMaxBytes(env);
+    const { offsetBytes, chunkBytes } = validateWindow(options);
+    const cancelled = () => {
+        if (options.signal?.aborted)
+            throw new CliError("cancelled", "file transfer cancelled");
+    };
+    cancelled();
+    try {
+        const before = await lstat(path);
+        if (!before.isFile() || before.isSymbolicLink())
+            throw new CliError("validation_error", "the retained attachment must be a regular file");
+        if (before.size > maxBytes)
+            throw new CliError("validation_error", `the retained attachment exceeds ${maxBytes / 1024 / 1024} MiB; configure MESSAGING_ATTACHMENT_MAX_MIB`);
+        if (offsetBytes > before.size)
+            throw new CliError("validation_error", "the byte offset is past the end of this attachment");
+        const handle = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0) | (constants.O_NONBLOCK ?? 0));
+        try {
+            const opened = await handle.stat();
+            if (!opened.isFile() || opened.ino !== before.ino || opened.dev !== before.dev || opened.size !== before.size)
+                throw new CliError("validation_error", "the retained attachment changed; restart its transfer");
+            const bytes = Buffer.alloc(Math.min(chunkBytes, opened.size - offsetBytes));
+            const capturedFile = captureFile ? Buffer.alloc(opened.size) : undefined;
+            const head = Buffer.alloc(32);
+            const hash = createHash("sha256");
+            let seen = 0;
+            let copied = 0;
+            const scratch = Buffer.alloc(65536);
+            while (true) {
+                cancelled();
+                const { bytesRead } = await handle.read(scratch, 0, scratch.length, seen);
+                if (bytesRead === 0)
+                    break;
+                const chunk = scratch.subarray(0, bytesRead);
+                if (seen + chunk.length > maxBytes || seen + chunk.length > opened.size)
+                    throw new CliError("validation_error", "the retained attachment changed; restart its transfer");
+                hash.update(chunk);
+                if (capturedFile)
+                    chunk.copy(capturedFile, seen);
+                if (seen < head.length)
+                    chunk.copy(head, seen, 0, Math.min(chunk.length, head.length - seen));
+                const start = Math.max(0, offsetBytes - seen);
+                const end = Math.min(chunk.length, offsetBytes + bytes.length - seen);
+                if (end > start)
+                    copied += chunk.copy(bytes, seen + start - offsetBytes, start, end);
+                seen += chunk.length;
+            }
+            cancelled();
+            const after = await handle.stat();
+            if (seen !== opened.size ||
+                copied !== bytes.length ||
+                after.size !== opened.size ||
+                after.mtimeMs !== opened.mtimeMs ||
+                after.ctimeMs !== opened.ctimeMs)
+                throw new CliError("validation_error", "the retained attachment changed; restart its transfer");
+            const sha256 = hash.digest("hex");
+            if (options.ifSha256 !== undefined && options.ifSha256.toLowerCase() !== sha256)
+                throw new CliError("validation_error", "the attachment SHA-256 changed; restart its transfer");
+            return {
+                totalBytes: seen,
+                sha256,
+                offsetBytes,
+                readBytes: bytes.length,
+                nextOffsetBytes: offsetBytes + bytes.length < seen ? offsetBytes + bytes.length : null,
+                complete: offsetBytes === 0 && bytes.length === seen,
+                base64: bytes.toString("base64"),
+                head,
+                capturedFile,
+            };
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch (error) {
+        if (error instanceof CliError)
+            throw error;
+        cancelled();
+        throw new CliError("not_found", "the retained attachment cannot be read; download it again");
+    }
+};
+export const transferMime = (head, hint, name = null) => {
+    if (head.subarray(0, 5).toString() === "%PDF-")
+        return "application/pdf";
+    if (head.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])))
+        return "image/png";
+    if (head[0] === 255 && head[1] === 216 && head[2] === 255)
+        return "image/jpeg";
+    if (head.subarray(0, 4).toString() === "RIFF" && head.subarray(8, 12).toString() === "WEBP")
+        return "image/webp";
+    const extension = name?.split(".").pop()?.toLowerCase();
+    const known = {
+        txt: "text/plain",
+        csv: "text/csv",
+        json: "application/json",
+        docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+        xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        epub: "application/epub+zip",
+    };
+    if (hint === null && extension !== undefined && known[extension] !== undefined)
+        return known[extension];
+    return hint !== null && /^[a-z0-9.+-]+\/[a-z0-9.+-]+$/i.test(hint) ? hint : "application/octet-stream";
+};
+//# sourceMappingURL=transfer.js.map

package/dist/attachments/transfer.js.map

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

package/dist/background/folders.d.ts

@@ -0,0 +1,16 @@
+import type { AppIdentity } from "../cli/app.js";
+export interface FolderOptions {
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    lsof?: (dirs: string[]) => string[];
+    holders?: (oldState: string) => string[];
+    warn?: (line: string) => void;
+}
+/**
+ * Moves the CLI's folders, the shared store's and the shared cache's out of `~/Library` on macOS, at
+ * program start, then the store and models into the WireCat folder. A move that cannot happen now warns,
+ * and this run keeps using the old folders, so the next run tries again. Only a state no command should run
+ * on stops it: two different stores, a move that could not be put back, another process still moving.
+ */
+export declare const migrateFolders: (app: Pick<AppIdentity, "command" | "appName" | "envPrefix">, options?: FolderOptions) => void;
+//# sourceMappingURL=folders.d.ts.map

package/dist/background/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../src/background/folders.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAA;IACnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,EAAE,CAAA;IACxC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAaD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QACpB,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC,YAClD,aAAa,SA0BvB,CAAA"}

package/dist/background/folders.js

@@ -0,0 +1,52 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, legacyMacPaths, migrateLegacyMacPaths } from "@wirecat/cli-base";
+import { liveServes, migrateToWirecatFolder } from "./wirecat-folder.js";
+/** An installed `serve` agent logs into the state folder; launchd does not create a folder that moved away. */
+const repointAgents = (appName, from, to, env) => {
+    const agents = join(env.HOME ?? "", "Library", "LaunchAgents");
+    if (!existsSync(agents))
+        return;
+    for (const name of readdirSync(agents).filter((file) => file.startsWith(`${appName}.serve.`))) {
+        const path = join(agents, name);
+        const text = readFileSync(path, "utf8");
+        if (text.includes(`${from}/`))
+            writeFileSync(path, text.replaceAll(`${from}/`, `${to}/`));
+    }
+};
+/**
+ * Moves the CLI's folders, the shared store's and the shared cache's out of `~/Library` on macOS, at
+ * program start, then the store and models into the WireCat folder. A move that cannot happen now warns,
+ * and this run keeps using the old folders, so the next run tries again. Only a state no command should run
+ * on stops it: two different stores, a move that could not be put back, another process still moving.
+ */
+export const migrateFolders = (app, options = {}) => {
+    const { env = process.env, platform = process.platform, lsof } = options;
+    const warn = options.warn ?? ((line) => process.stderr.write(`${line}\n`));
+    const owners = [
+        [app.appName, app.envPrefix],
+        ["cli-messaging", "MESSAGING"],
+        ["cli-common", "CLI_COMMON"],
+    ];
+    for (const [appName, prefix] of owners) {
+        try {
+            const serving = platform === "darwin" ? liveServes(legacyMacPaths(appName, env).state) : [];
+            if (serving.length > 0)
+                throw new CliError("configuration_error", `a serve is running (${serving.join(", ")}) — stop it and run again`);
+            const moves = migrateLegacyMacPaths({ appName, prefix, env, platform, ...(lsof ? { holders: lsof } : {}) });
+            const state = moves.find((move) => move.kind === "state");
+            if (state)
+                repointAgents(appName, state.from, state.to, env);
+        }
+        catch (error) {
+            const legacy = legacyMacPaths(appName, env);
+            for (const kind of ["config", "state", "cache"])
+                if (existsSync(legacy[kind]))
+                    env[`${prefix}_${kind.toUpperCase()}_DIR`] = legacy[kind];
+            warn(`${app.command}: kept ${appName}'s files in ~/Library for now — ${error.message}`);
+        }
+    }
+    const holders = options.holders ?? (lsof ? (dir) => lsof([dir]) : undefined);
+    migrateToWirecatFolder(app, { env, platform, warn, ...(holders ? { holders } : {}) });
+};
+//# sourceMappingURL=folders.js.map