@bedolla/enrivision 0.1.4 → 0.1.6

package/dist/tools/AnalyzeMediaInputResolver.js

@@ -0,0 +1,430 @@
+/**
+ * ANALYZE MEDIA INPUT RESOLVER
+ *
+ * Turns validated `path`/`paths` arguments into local files ready for
+ * upload: URL inputs are materialized through bounded streaming downloads,
+ * every input is readability-checked, and its effective upload content type
+ * is resolved.
+ *
+ * Content-type rule: the server-reported content type is authoritative and
+ * always wins over the extension-derived guess, so `image/webp` served from
+ * `/a.png` can never degrade to `image/png`; the generic
+ * `application/octet-stream` never wins.
+ *
+ * @module tools/AnalyzeMediaInputResolver
+ */
+import { constants } from "node:fs";
+import { lstat, open, stat } from "node:fs/promises";
+import { basename } from "node:path";
+import { lookup as mimeLookup } from "mime-types";
+import { MediaUrlFetcher } from "../shared/mediaUrlFetcher.js";
+import { describeFileIdentity } from "./AnalyzeMediaResumableUploader.js";
+import { ANALYZE_MEDIA_LIMITS } from "./AnalyzeMediaContract.js";
+/**
+ * Reports whether one filesystem error carries the given `code`.
+ *
+ * @param error - Caught error value.
+ * @param code - Expected Node.js error code (for example `"ELOOP"`).
+ * @returns True when the error carries the code.
+ */
+function isErrnoCode(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+/**
+ * Resolves validated media arguments into upload-ready local files.
+ */
+export class AnalyzeMediaInputResolver {
+    /**
+     * Do-not-follow flag for strict-mode opens (`0` where advisory).
+     *
+     * @remarks
+     * `O_NOFOLLOW` is honored on POSIX; on Windows it is advisory at best,
+     * so the `dev:ino` handle-identity comparison stays the real gate there.
+     */
+    static NO_FOLLOW_FLAG = process.platform === "win32" ? 0 : constants.O_NOFOLLOW;
+    /**
+     * Bounded http(s) media fetcher used for URL inputs.
+     */
+    urlFetcher;
+    /**
+     * Creates a new {@link AnalyzeMediaInputResolver}.
+     *
+     * @param urlFetcher - URL fetcher used to materialize http(s) inputs.
+     */
+    constructor(urlFetcher) {
+        this.urlFetcher = urlFetcher;
+    }
+    /**
+     * Resolves validated params into local upload-ready inputs.
+     *
+     * @remarks
+     * When `paths` carries at least one entry it wins over `path` (documented
+     * in the tool schema).
+     *
+     * @param params - Validated tool parameters.
+     * @param signal - Optional cancellation signal forwarded to URL downloads.
+     * @returns Resolved inputs plus owned downloads awaiting cleanup.
+     * @throws Error with an Spanish-first bilingual message when no input was provided, a download fails, or a file is unreadable.
+     */
+    async resolve(params, signal) {
+        const requestedPaths = Array.isArray(params.paths) && params.paths.length > 0
+            ? [...params.paths]
+            : typeof params.path === "string" && params.path.trim()
+                ? [params.path.trim()]
+                : [];
+        if (requestedPaths.length === 0) {
+            throw new Error("Proporcione 'path' o 'paths'. / Provide 'path' or 'paths'.");
+        }
+        const materialized = [];
+        const inputs = [];
+        // Fail fast once the resolved bytes exceed the 4 GiB upload ceiling so
+        // a 100-URL set stops materializing instead of downloading ~6 GiB of
+        // temp files before the tar packager rejects the set.
+        // Multi-entry sets are image-only: each entry is validated right after
+        // it materializes (authoritative check on the effective content type),
+        // so the first non-image entry fails before the rest is downloaded.
+        const isImageSet = requestedPaths.length > 1;
+        let resolvedBytes = 0;
+        try {
+            for (const requested of requestedPaths) {
+                if (!MediaUrlFetcher.isHttpUrl(requested)) {
+                    const local = await this.resolveLocalFile(requested);
+                    this.throwOnNonImageSetEntry(local.localPath, local.contentType, isImageSet);
+                    resolvedBytes += local.sizeBytes;
+                    this.throwOnUploadCeilingExceeded(resolvedBytes, inputs.length + 1, isImageSet);
+                    inputs.push(local);
+                    continue;
+                }
+                // A lone oversized URL escalates to server-side `source_url`
+                // ingest instead of failing: the fetcher already passed its SSRF
+                // guards before hitting the size cap, and multi-entry sets stay
+                // local-only (the server tar flow has no URL-ingest branch).
+                if (!isImageSet) {
+                    try {
+                        const fetched = await this.urlFetcher.fetch(requested, { signal });
+                        materialized.push(fetched);
+                        const downloaded = await this.resolveDownloadedFile(fetched);
+                        resolvedBytes += downloaded.sizeBytes;
+                        this.throwOnUploadCeilingExceeded(resolvedBytes, inputs.length + 1, isImageSet);
+                        inputs.push(downloaded);
+                        continue;
+                    }
+                    catch (error) {
+                        if (signal?.aborted !== true && MediaUrlFetcher.isSizeCapError(error)) {
+                            for (const fetched of materialized) {
+                                await fetched.cleanup();
+                            }
+                            return { inputs: [], materialized: [], remoteUrl: requested };
+                        }
+                        throw error;
+                    }
+                }
+                const fetched = await this.urlFetcher.fetch(requested, { signal });
+                materialized.push(fetched);
+                const downloaded = await this.resolveDownloadedFile(fetched);
+                this.throwOnNonImageSetEntry(downloaded.localPath, downloaded.contentType, isImageSet);
+                resolvedBytes += downloaded.sizeBytes;
+                this.throwOnUploadCeilingExceeded(resolvedBytes, inputs.length + 1, isImageSet);
+                inputs.push(downloaded);
+            }
+        }
+        catch (error) {
+            for (const fetched of materialized) {
+                await fetched.cleanup();
+            }
+            throw error;
+        }
+        return { inputs, materialized };
+    }
+    /**
+     * Fails fast when resolved bytes already exceed the upload ceiling.
+     *
+     * @remarks
+     * Multi-entry sets travel as one tar archive (headers, padding, manifest,
+     * end marker), so the fail-fast estimates the tar framing overhead (see
+     * {@link estimateMediaSetTarBytes}) instead of the raw byte sum: a set
+     * summing to 3.99 GiB raw would otherwise materialize ~100 temp downloads
+     * only for the packager to reject it once framing pushes it over 4 GiB.
+     * Over-estimating is correct for a fail-fast.
+     *
+     * @param resolvedBytes - Running total of resolved input bytes.
+     * @param entryCount - Resolved entries so far (including the latest).
+     * @param isImageSet - Whether the call resolves a multi-entry set.
+     * @throws Error with an Spanish-first bilingual message when the set already exceeds 4 GiB.
+     */
+    throwOnUploadCeilingExceeded(resolvedBytes, entryCount, isImageSet) {
+        const effectiveBytes = isImageSet
+            ? estimateMediaSetTarBytes(resolvedBytes, entryCount)
+            : resolvedBytes;
+        if (effectiveBytes > ANALYZE_MEDIA_LIMITS.maxUploadBytes) {
+            throw new Error(isImageSet
+                ? `El conjunto de archivos excede el límite de subida de 4 GiB (${String(effectiveBytes)} bytes estimados con tar overhead); divida el conjunto en varias llamadas. / File set exceeds the 4 GiB upload limit (${String(effectiveBytes)} bytes estimated with tar overhead); split the set into several calls.`
+                : `El archivo excede el límite de subida de 4 GiB (${String(effectiveBytes)} bytes); use un archivo más liviano. / File exceeds the 4 GiB upload limit (${String(effectiveBytes)} bytes); use a lighter file.`);
+        }
+    }
+    /**
+     * Resolves one local file into an upload-ready input.
+     *
+     * @param localPath - Absolute local file path.
+     * @returns Upload-ready input.
+     * @throws Error with an Spanish-first bilingual message when the file is missing or unreadable.
+     */
+    async resolveLocalFile(localPath) {
+        const staged = await this.assertReadableFile(localPath);
+        const sizeBytes = staged.sizeBytes;
+        const contentType = this.detectMimeType(localPath);
+        // Fail fast before any upload session exists: a 4 GiB non-media file
+        // must never be uploaded only for the server to reject it.
+        if (!MediaUrlFetcher.isAllowedMediaContentType(contentType)) {
+            throw new Error(`El archivo local no es media analizable (${localPath}, content-type: ${contentType}). Solo se aceptan imagen, video, audio, PDF y documentos de Office. / Local file is not analyzable media (${localPath}, content-type: ${contentType}). Only image, video, audio, PDF, and Office documents are accepted.`);
+        }
+        return {
+            localPath,
+            filename: basename(localPath),
+            sizeBytes,
+            contentType,
+            extensionSynthesized: false,
+            stagedIdentity: staged.stagedIdentity,
+        };
+    }
+    /**
+     * Rejects a non-image entry of a multi-entry set right after it materializes.
+     *
+     * @remarks
+     * The tar packager repeats this check authoritatively before packing; the
+     * early check here only stops the resolver from downloading the rest of
+     * the set after the first failure. Single inputs keep any allowed type.
+     *
+     * @param localPath - Materialized local path (for error messages).
+     * @param contentType - Effective content type of the entry.
+     * @param isImageSet - Whether the call resolves a multi-entry set.
+     * @throws Error with an Spanish-first bilingual message when a set entry is not an image.
+     */
+    throwOnNonImageSetEntry(localPath, contentType, isImageSet) {
+        if (isImageSet && !contentType.toLowerCase().startsWith("image/")) {
+            throw new Error(`paths debe contener sólo archivos de imagen. No es imagen: ${localPath} (${contentType}) / paths must contain only image files. Not an image: ${localPath} (${contentType}).`);
+        }
+    }
+    /**
+     * Resolves one downloaded URL file into an upload-ready input.
+     *
+     * @param fetched - Owned download result.
+     * @returns Upload-ready input preferring the server content type when the extension was synthesized.
+     * @throws Error with an Spanish-first bilingual message when the downloaded file is unreadable.
+     */
+    async resolveDownloadedFile(fetched) {
+        const staged = await this.assertReadableFile(fetched.localPath);
+        const sizeBytes = staged.sizeBytes;
+        const urlContentType = fetched.contentType;
+        const contentType = this.resolveEffectiveContentType(fetched.localPath, urlContentType);
+        // Same allowlist as local files: a download that resolves to
+        // non-media (blanked disallowed type plus an uninferred extension)
+        // fails before any upload session exists, never mid-upload.
+        if (!MediaUrlFetcher.isAllowedMediaContentType(contentType)) {
+            throw new Error(`La URL no sirvió un archivo de media válido (${fetched.localPath}, content-type: ${contentType}). Solo se aceptan imagen, video, audio, PDF y documentos de Office. / URL did not serve a valid media file (${fetched.localPath}, content-type: ${contentType}). Only image, video, audio, PDF, and Office documents are accepted.`);
+        }
+        return {
+            localPath: fetched.localPath,
+            filename: basename(fetched.localPath),
+            sizeBytes,
+            contentType,
+            urlContentType,
+            extensionSynthesized: fetched.extensionSynthesized,
+            stagedIdentity: staged.stagedIdentity,
+        };
+    }
+    /**
+     * Resolves the upload content type for one media input.
+     *
+     * @remarks
+     * The server-reported content type is authoritative: whenever it differs
+     * from the extension-derived guess it wins (a synthesized download
+     * extension is only a filesystem hint, and a mismatched authored
+     * extension such as `/a.png` serving `image/webp` must never shadow the
+     * real type). The generic `application/octet-stream` never wins.
+     *
+     * @param localPath - Local file path (already materialized for URLs).
+     * @param urlContentType - Server-reported content type for downloaded URLs.
+     * @returns Effective MIME type.
+     */
+    resolveEffectiveContentType(localPath, urlContentType) {
+        const reported = typeof urlContentType === "string" ? urlContentType.trim().toLowerCase() : "";
+        if (reported !== "" && reported !== "application/octet-stream") {
+            return reported;
+        }
+        return this.detectMimeType(localPath);
+    }
+    /**
+     * Detects a MIME type using the file extension.
+     *
+     * @param filePath - File path.
+     * @returns MIME type string.
+     */
+    detectMimeType(filePath) {
+        const detected = mimeLookup(filePath);
+        if (typeof detected === "string" && detected.trim()) {
+            return detected.trim();
+        }
+        return "application/octet-stream";
+    }
+    /**
+     * Validates that a path exists and is a readable file.
+     *
+     * @remarks
+     * `path` follows symlinks by design (the MCP host trusts the model with
+     * host-file access, like the documented DNS-rebinding residual in
+     * `mediaUrlFetcher.ts`). Operators that need strict mode set
+     * `ENRIVISION_DENY_SYMLINKS=1` to reject symlinked inputs with a Spanish
+     * error instead.
+     *
+     * @param filePath - Local filesystem path.
+     * @returns File size in bytes.
+     * @throws Error with an Spanish-first bilingual message when the file is missing, not readable, a rejected symlink, or exceeds 4 GiB.
+     */
+    async assertReadableFile(filePath) {
+        if (process.env["ENRIVISION_DENY_SYMLINKS"] === "1") {
+            return this.assertReadableFileWithoutSymlinks(filePath);
+        }
+        let fileStat;
+        try {
+            fileStat = await stat(filePath);
+        }
+        catch (error) {
+            this.throwOnMissingFile(filePath, error);
+            throw new Error(`Archivo no encontrado: ${filePath} / File not found: ${filePath}.`);
+        }
+        // Ensure the file is readable.
+        const handle = await open(filePath, "r");
+        try {
+            // Stage the identity from `fstat` on the opened handle (never the
+            // path stat): the uploader compares it at open time so a same-size
+            // replacement between resolve and upload fails loudly.
+            const openedStat = await handle.stat();
+            return {
+                sizeBytes: this.checkFileStat(filePath, fileStat.size, fileStat.isFile()),
+                stagedIdentity: describeFileIdentity(openedStat),
+            };
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    /**
+     * Validates one file without ever trusting a path re-stat.
+     *
+     * @remarks
+     * `lstat` + `stat` + `open` on the same path races: a symlink swapped in
+     * between the check and the open defeats `ENRIVISION_DENY_SYMLINKS`.
+     * Opening with `O_NOFOLLOW` (POSIX) makes a swapped-in symlink fail with
+     * `ELOOP` instead, and the size/kind verdicts come from `fstat` on the
+     * opened handle — never from a second path lookup. The `dev:ino`
+     * comparison additionally rejects a real file swapped between `lstat`
+     * and `open` on platforms where `O_NOFOLLOW` is advisory.
+     *
+     * @param filePath - Local filesystem path.
+     * @returns File size in bytes plus the staged `fstat` identity.
+     * @throws Error with an Spanish-first bilingual message when the file is missing, a symlink, swapped mid-check, or exceeds 4 GiB.
+     */
+    async assertReadableFileWithoutSymlinks(filePath) {
+        let linkStat;
+        try {
+            linkStat = await lstat(filePath);
+            if (linkStat.isSymbolicLink()) {
+                throw new Error(`No se permiten enlaces simbólicos: ${filePath} / Symbolic links are not allowed: ${filePath}.`);
+            }
+        }
+        catch (error) {
+            this.throwOnMissingFile(filePath, error);
+            throw new Error(`Archivo no encontrado: ${filePath} / File not found: ${filePath}.`);
+        }
+        let handle;
+        try {
+            handle = await open(filePath, constants.O_RDONLY | AnalyzeMediaInputResolver.NO_FOLLOW_FLAG);
+        }
+        catch (error) {
+            if (isErrnoCode(error, "ELOOP")) {
+                throw new Error(`No se permiten enlaces simbólicos: ${filePath} / Symbolic links are not allowed: ${filePath}.`);
+            }
+            this.throwOnMissingFile(filePath, error);
+            throw new Error(`Archivo no encontrado: ${filePath} / File not found: ${filePath}.`);
+        }
+        try {
+            const openedStat = await handle.stat();
+            if (openedStat.dev !== linkStat.dev || openedStat.ino !== linkStat.ino) {
+                throw new Error(`El archivo cambió durante la validación (${filePath}); reintente la llamada. / File changed during validation (${filePath}); retry the call.`);
+            }
+            return {
+                sizeBytes: this.checkFileStat(filePath, openedStat.size, openedStat.isFile()),
+                stagedIdentity: describeFileIdentity(openedStat),
+            };
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    /**
+     * Applies the shared size/kind verdicts to one stat result.
+     *
+     * @param filePath - Local filesystem path (for error messages).
+     * @param size - File size in bytes.
+     * @param isFile - Whether the stat target is a regular file.
+     * @returns File size in bytes.
+     * @throws Error with an Spanish-first bilingual message when the target is not a file, is empty, or exceeds 4 GiB.
+     */
+    checkFileStat(filePath, size, isFile) {
+        if (!isFile) {
+            throw new Error(`No es un archivo: ${filePath} / Not a file: ${filePath}.`);
+        }
+        if (size === 0) {
+            throw new Error(`El archivo está vacío (0 bytes): ${filePath}. No hay nada que analizar. / File is empty (0 bytes): ${filePath}. Nothing to analyze.`);
+        }
+        if (size > ANALYZE_MEDIA_LIMITS.maxUploadBytes) {
+            throw new Error(`El archivo excede el límite de subida de 4 GiB: ${filePath} (${String(size)} bytes). / File exceeds the 4 GiB upload limit: ${filePath} (${String(size)} bytes).`);
+        }
+        return size;
+    }
+    /**
+     * Maps filesystem lookup failures to the stable not-found error.
+     *
+     * @param filePath - Local filesystem path (for error messages).
+     * @param error - Raw filesystem error.
+     * @throws Error with an Spanish-first bilingual message when the file is missing; rethrows unreadable-file errors otherwise.
+     */
+    throwOnMissingFile(filePath, error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            throw new Error(`Archivo no encontrado: ${filePath} / File not found: ${filePath}.`);
+        }
+        if (error instanceof Error && /no se permiten enlaces/i.test(error.message)) {
+            throw error;
+        }
+        throw new Error(`No se puede leer el archivo: ${filePath} / Cannot read file: ${filePath}.`);
+    }
+}
+/**
+ * Estimates the tar archive size for a multi-image set before packing.
+ *
+ * @remarks
+ * Fail-fast estimator (over-estimates on purpose): raw bytes plus one 512 B
+ * header per file, the manifest entry (512 B header plus content padded to
+ * 512 B), worst-case content padding (511 B per file), and the 1024 B end
+ * marker. The manifest term budgets 256 B of envelope plus 512 B per entry
+ * (worst case: 255 B basenames plus content type plus JSON overhead), so
+ * long filenames never under-estimate. Used by the resolver so a set that
+ * only fits raw never pays ~100 temp downloads before the packager rejects
+ * it.
+ *
+ * @param rawBytes - Summed input bytes.
+ * @param fileCount - Number of files in the set.
+ * @returns Estimated tar size in bytes.
+ */
+export function estimateMediaSetTarBytes(rawBytes, fileCount) {
+    const manifestContentBytes = 256 + Math.max(0, fileCount) * 512;
+    const manifestPaddedBytes = Math.ceil(manifestContentBytes / 512) * 512;
+    return (Math.max(0, rawBytes) +
+        Math.max(0, fileCount) * 512 +
+        512 +
+        manifestPaddedBytes +
+        Math.max(0, fileCount) * 511 +
+        1024);
+}
+//# sourceMappingURL=AnalyzeMediaInputResolver.js.map

package/dist/tools/AnalyzeMediaInputResolver.js.map

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