@farazirfan/costar-server-executor 1.0.0

package/dist/media/input-files.js

@@ -0,0 +1,277 @@
+import { logWarn } from "../logger.js";
+import { closeDispatcher, createPinnedDispatcher, resolvePinnedHostname, } from "../infra/net/ssrf.js";
+let canvasModulePromise = null;
+let pdfJsModulePromise = null;
+// Lazy-load optional PDF/image deps so non-PDF paths don't require native installs.
+async function loadCanvasModule() {
+    if (!canvasModulePromise) {
+        canvasModulePromise = import("@napi-rs/canvas").catch((err) => {
+            canvasModulePromise = null;
+            throw new Error(`Optional dependency @napi-rs/canvas is required for PDF image extraction: ${String(err)}`);
+        });
+    }
+    return canvasModulePromise;
+}
+async function loadPdfJsModule() {
+    if (!pdfJsModulePromise) {
+        pdfJsModulePromise = import("pdfjs-dist/legacy/build/pdf.mjs").catch((err) => {
+            pdfJsModulePromise = null;
+            throw new Error(`Optional dependency pdfjs-dist is required for PDF extraction: ${String(err)}`);
+        });
+    }
+    return pdfJsModulePromise;
+}
+export const DEFAULT_INPUT_IMAGE_MIMES = ["image/jpeg", "image/png", "image/gif", "image/webp"];
+export const DEFAULT_INPUT_FILE_MIMES = [
+    "text/plain",
+    "text/markdown",
+    "text/html",
+    "text/csv",
+    "application/json",
+    "application/pdf",
+];
+export const DEFAULT_INPUT_IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+export const DEFAULT_INPUT_FILE_MAX_BYTES = 5 * 1024 * 1024;
+export const DEFAULT_INPUT_FILE_MAX_CHARS = 200_000;
+export const DEFAULT_INPUT_MAX_REDIRECTS = 3;
+export const DEFAULT_INPUT_TIMEOUT_MS = 10_000;
+export const DEFAULT_INPUT_PDF_MAX_PAGES = 4;
+export const DEFAULT_INPUT_PDF_MAX_PIXELS = 4_000_000;
+export const DEFAULT_INPUT_PDF_MIN_TEXT_CHARS = 200;
+function isRedirectStatus(status) {
+    return status === 301 || status === 302 || status === 303 || status === 307 || status === 308;
+}
+export function normalizeMimeType(value) {
+    if (!value)
+        return undefined;
+    const [raw] = value.split(";");
+    const normalized = raw?.trim().toLowerCase();
+    return normalized || undefined;
+}
+export function parseContentType(value) {
+    if (!value)
+        return {};
+    const parts = value.split(";").map((part) => part.trim());
+    const mimeType = normalizeMimeType(parts[0]);
+    const charset = parts
+        .map((part) => part.match(/^charset=(.+)$/i)?.[1]?.trim())
+        .find((part) => part && part.length > 0);
+    return { mimeType, charset };
+}
+export function normalizeMimeList(values, fallback) {
+    const input = values && values.length > 0 ? values : fallback;
+    return new Set(input.map((value) => normalizeMimeType(value)).filter(Boolean));
+}
+export async function fetchWithGuard(params) {
+    let currentUrl = params.url;
+    let redirectCount = 0;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), params.timeoutMs);
+    try {
+        while (true) {
+            const parsedUrl = new URL(currentUrl);
+            if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+                throw new Error(`Invalid URL protocol: ${parsedUrl.protocol}. Only HTTP/HTTPS allowed.`);
+            }
+            const pinned = await resolvePinnedHostname(parsedUrl.hostname);
+            const dispatcher = createPinnedDispatcher(pinned);
+            try {
+                const response = await fetch(parsedUrl, {
+                    signal: controller.signal,
+                    headers: { "User-Agent": "OpenClaw-Gateway/1.0" },
+                    redirect: "manual",
+                    dispatcher,
+                });
+                if (isRedirectStatus(response.status)) {
+                    const location = response.headers.get("location");
+                    if (!location) {
+                        throw new Error(`Redirect missing location header (${response.status})`);
+                    }
+                    redirectCount += 1;
+                    if (redirectCount > params.maxRedirects) {
+                        throw new Error(`Too many redirects (limit: ${params.maxRedirects})`);
+                    }
+                    void response.body?.cancel();
+                    currentUrl = new URL(location, parsedUrl).toString();
+                    continue;
+                }
+                if (!response.ok) {
+                    throw new Error(`Failed to fetch: ${response.status} ${response.statusText}`);
+                }
+                const contentLength = response.headers.get("content-length");
+                if (contentLength) {
+                    const size = parseInt(contentLength, 10);
+                    if (size > params.maxBytes) {
+                        throw new Error(`Content too large: ${size} bytes (limit: ${params.maxBytes} bytes)`);
+                    }
+                }
+                const buffer = Buffer.from(await response.arrayBuffer());
+                if (buffer.byteLength > params.maxBytes) {
+                    throw new Error(`Content too large: ${buffer.byteLength} bytes (limit: ${params.maxBytes} bytes)`);
+                }
+                const contentType = response.headers.get("content-type") || undefined;
+                const parsed = parseContentType(contentType);
+                const mimeType = parsed.mimeType ?? "application/octet-stream";
+                return { buffer, mimeType, contentType };
+            }
+            finally {
+                await closeDispatcher(dispatcher);
+            }
+        }
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+function decodeTextContent(buffer, charset) {
+    const encoding = charset?.trim().toLowerCase() || "utf-8";
+    try {
+        return new TextDecoder(encoding).decode(buffer);
+    }
+    catch {
+        return new TextDecoder("utf-8").decode(buffer);
+    }
+}
+function clampText(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars);
+}
+async function extractPdfContent(params) {
+    const { buffer, limits } = params;
+    const { getDocument } = await loadPdfJsModule();
+    const pdf = await getDocument({
+        data: new Uint8Array(buffer),
+        disableWorker: true,
+    }).promise;
+    const maxPages = Math.min(pdf.numPages, limits.pdf.maxPages);
+    const textParts = [];
+    for (let pageNum = 1; pageNum <= maxPages; pageNum += 1) {
+        const page = await pdf.getPage(pageNum);
+        const textContent = await page.getTextContent();
+        const pageText = textContent.items
+            .map((item) => ("str" in item ? String(item.str) : ""))
+            .filter(Boolean)
+            .join(" ");
+        if (pageText)
+            textParts.push(pageText);
+    }
+    const text = textParts.join("\n\n");
+    if (text.trim().length >= limits.pdf.minTextChars) {
+        return { text, images: [] };
+    }
+    let canvasModule;
+    try {
+        canvasModule = await loadCanvasModule();
+    }
+    catch (err) {
+        logWarn(`media: PDF image extraction skipped; ${String(err)}`);
+        return { text, images: [] };
+    }
+    const { createCanvas } = canvasModule;
+    const images = [];
+    for (let pageNum = 1; pageNum <= maxPages; pageNum += 1) {
+        const page = await pdf.getPage(pageNum);
+        const viewport = page.getViewport({ scale: 1 });
+        const maxPixels = limits.pdf.maxPixels;
+        const pixelBudget = Math.max(1, maxPixels);
+        const pagePixels = viewport.width * viewport.height;
+        const scale = Math.min(1, Math.sqrt(pixelBudget / pagePixels));
+        const scaled = page.getViewport({ scale: Math.max(0.1, scale) });
+        const canvas = createCanvas(Math.ceil(scaled.width), Math.ceil(scaled.height));
+        await page.render({
+            canvas: canvas,
+            viewport: scaled,
+        }).promise;
+        const png = canvas.toBuffer("image/png");
+        images.push({ type: "image", data: png.toString("base64"), mimeType: "image/png" });
+    }
+    return { text, images };
+}
+export async function extractImageContentFromSource(source, limits) {
+    if (source.type === "base64") {
+        if (!source.data) {
+            throw new Error("input_image base64 source missing 'data' field");
+        }
+        const mimeType = normalizeMimeType(source.mediaType) ?? "image/png";
+        if (!limits.allowedMimes.has(mimeType)) {
+            throw new Error(`Unsupported image MIME type: ${mimeType}`);
+        }
+        const buffer = Buffer.from(source.data, "base64");
+        if (buffer.byteLength > limits.maxBytes) {
+            throw new Error(`Image too large: ${buffer.byteLength} bytes (limit: ${limits.maxBytes} bytes)`);
+        }
+        return { type: "image", data: source.data, mimeType };
+    }
+    if (source.type === "url" && source.url) {
+        if (!limits.allowUrl) {
+            throw new Error("input_image URL sources are disabled by config");
+        }
+        const result = await fetchWithGuard({
+            url: source.url,
+            maxBytes: limits.maxBytes,
+            timeoutMs: limits.timeoutMs,
+            maxRedirects: limits.maxRedirects,
+        });
+        if (!limits.allowedMimes.has(result.mimeType)) {
+            throw new Error(`Unsupported image MIME type from URL: ${result.mimeType}`);
+        }
+        return { type: "image", data: result.buffer.toString("base64"), mimeType: result.mimeType };
+    }
+    throw new Error("input_image must have 'source.url' or 'source.data'");
+}
+export async function extractFileContentFromSource(params) {
+    const { source, limits } = params;
+    const filename = source.filename || "file";
+    let buffer;
+    let mimeType;
+    let charset;
+    if (source.type === "base64") {
+        if (!source.data) {
+            throw new Error("input_file base64 source missing 'data' field");
+        }
+        const parsed = parseContentType(source.mediaType);
+        mimeType = parsed.mimeType;
+        charset = parsed.charset;
+        buffer = Buffer.from(source.data, "base64");
+    }
+    else if (source.type === "url" && source.url) {
+        if (!limits.allowUrl) {
+            throw new Error("input_file URL sources are disabled by config");
+        }
+        const result = await fetchWithGuard({
+            url: source.url,
+            maxBytes: limits.maxBytes,
+            timeoutMs: limits.timeoutMs,
+            maxRedirects: limits.maxRedirects,
+        });
+        const parsed = parseContentType(result.contentType);
+        mimeType = parsed.mimeType ?? normalizeMimeType(result.mimeType);
+        charset = parsed.charset;
+        buffer = result.buffer;
+    }
+    else {
+        throw new Error("input_file must have 'source.url' or 'source.data'");
+    }
+    if (buffer.byteLength > limits.maxBytes) {
+        throw new Error(`File too large: ${buffer.byteLength} bytes (limit: ${limits.maxBytes} bytes)`);
+    }
+    if (!mimeType) {
+        throw new Error("input_file missing media type");
+    }
+    if (!limits.allowedMimes.has(mimeType)) {
+        throw new Error(`Unsupported file MIME type: ${mimeType}`);
+    }
+    if (mimeType === "application/pdf") {
+        const extracted = await extractPdfContent({ buffer, limits });
+        const text = extracted.text ? clampText(extracted.text, limits.maxChars) : "";
+        return {
+            filename,
+            text,
+            images: extracted.images.length > 0 ? extracted.images : undefined,
+        };
+    }
+    const text = clampText(decodeTextContent(buffer, charset), limits.maxChars);
+    return { filename, text };
+}
+//# sourceMappingURL=input-files.js.map

package/dist/media/input-files.js.map

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

package/dist/media/mime.d.ts

@@ -0,0 +1,16 @@
+import { type MediaKind } from "./constants.js";
+export declare function getFileExtension(filePath?: string | null): string | undefined;
+export declare function isAudioFileName(fileName?: string | null): boolean;
+export declare function detectMime(opts: {
+    buffer?: Buffer;
+    headerMime?: string | null;
+    filePath?: string;
+}): Promise<string | undefined>;
+export declare function extensionForMime(mime?: string | null): string | undefined;
+export declare function isGifMedia(opts: {
+    contentType?: string | null;
+    fileName?: string | null;
+}): boolean;
+export declare function imageMimeFromFormat(format?: string | null): string | undefined;
+export declare function kindFromMime(mime?: string | null): MediaKind;
+//# sourceMappingURL=mime.d.ts.map

package/dist/media/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../src/media/mime.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,gBAAgB,CAAC;AAmEnE,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAY7E;AAED,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAIjE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE9B;AA8BD,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAIV;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,CAmB9E;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAE5D"}

package/dist/media/mime.js

@@ -0,0 +1,151 @@
+import path from "node:path";
+import { fileTypeFromBuffer } from "file-type";
+import { mediaKindFromMime } from "./constants.js";
+// Map common mimes to preferred file extensions.
+const EXT_BY_MIME = {
+    "image/heic": ".heic",
+    "image/heif": ".heif",
+    "image/jpeg": ".jpg",
+    "image/png": ".png",
+    "image/webp": ".webp",
+    "image/gif": ".gif",
+    "audio/ogg": ".ogg",
+    "audio/mpeg": ".mp3",
+    "audio/x-m4a": ".m4a",
+    "audio/mp4": ".m4a",
+    "video/mp4": ".mp4",
+    "video/quicktime": ".mov",
+    "application/pdf": ".pdf",
+    "application/json": ".json",
+    "application/zip": ".zip",
+    "application/gzip": ".gz",
+    "application/x-tar": ".tar",
+    "application/x-7z-compressed": ".7z",
+    "application/vnd.rar": ".rar",
+    "application/msword": ".doc",
+    "application/vnd.ms-excel": ".xls",
+    "application/vnd.ms-powerpoint": ".ppt",
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ".docx",
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ".xlsx",
+    "application/vnd.openxmlformats-officedocument.presentationml.presentation": ".pptx",
+    "text/csv": ".csv",
+    "text/plain": ".txt",
+    "text/markdown": ".md",
+};
+const MIME_BY_EXT = {
+    ...Object.fromEntries(Object.entries(EXT_BY_MIME).map(([mime, ext]) => [ext, mime])),
+    // Additional extension aliases
+    ".jpeg": "image/jpeg",
+};
+const AUDIO_FILE_EXTENSIONS = new Set([
+    ".aac",
+    ".flac",
+    ".m4a",
+    ".mp3",
+    ".oga",
+    ".ogg",
+    ".opus",
+    ".wav",
+]);
+function normalizeHeaderMime(mime) {
+    if (!mime)
+        return undefined;
+    const cleaned = mime.split(";")[0]?.trim().toLowerCase();
+    return cleaned || undefined;
+}
+async function sniffMime(buffer) {
+    if (!buffer)
+        return undefined;
+    try {
+        const type = await fileTypeFromBuffer(buffer);
+        return type?.mime ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function getFileExtension(filePath) {
+    if (!filePath)
+        return undefined;
+    try {
+        if (/^https?:\/\//i.test(filePath)) {
+            const url = new URL(filePath);
+            return path.extname(url.pathname).toLowerCase() || undefined;
+        }
+    }
+    catch {
+        // fall back to plain path parsing
+    }
+    const ext = path.extname(filePath).toLowerCase();
+    return ext || undefined;
+}
+export function isAudioFileName(fileName) {
+    const ext = getFileExtension(fileName);
+    if (!ext)
+        return false;
+    return AUDIO_FILE_EXTENSIONS.has(ext);
+}
+export function detectMime(opts) {
+    return detectMimeImpl(opts);
+}
+function isGenericMime(mime) {
+    if (!mime)
+        return true;
+    const m = mime.toLowerCase();
+    return m === "application/octet-stream" || m === "application/zip";
+}
+async function detectMimeImpl(opts) {
+    const ext = getFileExtension(opts.filePath);
+    const extMime = ext ? MIME_BY_EXT[ext] : undefined;
+    const headerMime = normalizeHeaderMime(opts.headerMime);
+    const sniffed = await sniffMime(opts.buffer);
+    // Prefer sniffed types, but don't let generic container types override a more
+    // specific extension mapping (e.g. XLSX vs ZIP).
+    if (sniffed && (!isGenericMime(sniffed) || !extMime))
+        return sniffed;
+    if (extMime)
+        return extMime;
+    if (headerMime && !isGenericMime(headerMime))
+        return headerMime;
+    if (sniffed)
+        return sniffed;
+    if (headerMime)
+        return headerMime;
+    return undefined;
+}
+export function extensionForMime(mime) {
+    if (!mime)
+        return undefined;
+    return EXT_BY_MIME[mime.toLowerCase()];
+}
+export function isGifMedia(opts) {
+    if (opts.contentType?.toLowerCase() === "image/gif")
+        return true;
+    const ext = getFileExtension(opts.fileName);
+    return ext === ".gif";
+}
+export function imageMimeFromFormat(format) {
+    if (!format)
+        return undefined;
+    switch (format.toLowerCase()) {
+        case "jpg":
+        case "jpeg":
+            return "image/jpeg";
+        case "heic":
+            return "image/heic";
+        case "heif":
+            return "image/heif";
+        case "png":
+            return "image/png";
+        case "webp":
+            return "image/webp";
+        case "gif":
+            return "image/gif";
+        default:
+            return undefined;
+    }
+}
+export function kindFromMime(mime) {
+    return mediaKindFromMime(mime);
+}
+//# sourceMappingURL=mime.js.map

package/dist/media/mime.js.map

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

package/dist/media/parse.d.ts

@@ -0,0 +1,9 @@
+export declare const MEDIA_TOKEN_RE: RegExp;
+export declare function normalizeMediaSource(src: string): string;
+export declare function splitMediaFromOutput(raw: string): {
+    text: string;
+    mediaUrls?: string[];
+    mediaUrl?: string;
+    audioAsVoice?: boolean;
+};
+//# sourceMappingURL=parse.d.ts.map

package/dist/media/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/media/parse.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,QAA8B,CAAC;AAE1D,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,UAE/C;AAiCD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAoJA"}

package/dist/media/parse.js

@@ -0,0 +1,176 @@
+// Shared helpers for parsing MEDIA tokens from command/stdout text.
+import { parseFenceSpans } from "../markdown/fences.js";
+import { parseAudioTag } from "./audio-tags.js";
+// Allow optional wrapping backticks and punctuation after the token; capture the core token.
+export const MEDIA_TOKEN_RE = /\bMEDIA:\s*`?([^\n]+)`?/gi;
+export function normalizeMediaSource(src) {
+    return src.startsWith("file://") ? src.replace("file://", "") : src;
+}
+function cleanCandidate(raw) {
+    return raw.replace(/^[`"'[{(]+/, "").replace(/[`"'\\})\],]+$/, "");
+}
+function isValidMedia(candidate, opts) {
+    if (!candidate)
+        return false;
+    if (candidate.length > 4096)
+        return false;
+    if (!opts?.allowSpaces && /\s/.test(candidate))
+        return false;
+    if (/^https?:\/\//i.test(candidate))
+        return true;
+    if (candidate.startsWith("/"))
+        return true;
+    if (candidate.startsWith("./"))
+        return true;
+    if (candidate.startsWith("../"))
+        return true;
+    if (candidate.startsWith("~"))
+        return true;
+    return false;
+}
+function unwrapQuoted(value) {
+    const trimmed = value.trim();
+    if (trimmed.length < 2)
+        return undefined;
+    const first = trimmed[0];
+    const last = trimmed[trimmed.length - 1];
+    if (first !== last)
+        return undefined;
+    if (first !== `"` && first !== "'" && first !== "`")
+        return undefined;
+    return trimmed.slice(1, -1).trim();
+}
+// Check if a character offset is inside any fenced code block
+function isInsideFence(fenceSpans, offset) {
+    return fenceSpans.some((span) => offset >= span.start && offset < span.end);
+}
+export function splitMediaFromOutput(raw) {
+    // KNOWN: Leading whitespace is semantically meaningful in Markdown (lists, indented fences).
+    // We only trim the end; token cleanup below handles removing `MEDIA:` lines.
+    const trimmedRaw = raw.trimEnd();
+    if (!trimmedRaw.trim())
+        return { text: "" };
+    const media = [];
+    let foundMediaToken = false;
+    // Parse fenced code blocks to avoid extracting MEDIA tokens from inside them
+    const fenceSpans = parseFenceSpans(trimmedRaw);
+    // Collect tokens line by line so we can strip them cleanly.
+    const lines = trimmedRaw.split("\n");
+    const keptLines = [];
+    let lineOffset = 0; // Track character offset for fence checking
+    for (const line of lines) {
+        // Skip MEDIA extraction if this line is inside a fenced code block
+        if (isInsideFence(fenceSpans, lineOffset)) {
+            keptLines.push(line);
+            lineOffset += line.length + 1; // +1 for newline
+            continue;
+        }
+        const trimmedStart = line.trimStart();
+        if (!trimmedStart.startsWith("MEDIA:")) {
+            keptLines.push(line);
+            lineOffset += line.length + 1; // +1 for newline
+            continue;
+        }
+        const matches = Array.from(line.matchAll(MEDIA_TOKEN_RE));
+        if (matches.length === 0) {
+            keptLines.push(line);
+            lineOffset += line.length + 1; // +1 for newline
+            continue;
+        }
+        foundMediaToken = true;
+        const pieces = [];
+        let cursor = 0;
+        let hasValidMedia = false;
+        for (const match of matches) {
+            const start = match.index ?? 0;
+            pieces.push(line.slice(cursor, start));
+            const payload = match[1];
+            const unwrapped = unwrapQuoted(payload);
+            const payloadValue = unwrapped ?? payload;
+            const parts = unwrapped ? [unwrapped] : payload.split(/\s+/).filter(Boolean);
+            const mediaStartIndex = media.length;
+            let validCount = 0;
+            const invalidParts = [];
+            for (const part of parts) {
+                const candidate = normalizeMediaSource(cleanCandidate(part));
+                if (isValidMedia(candidate, unwrapped ? { allowSpaces: true } : undefined)) {
+                    media.push(candidate);
+                    hasValidMedia = true;
+                    validCount += 1;
+                }
+                else {
+                    invalidParts.push(part);
+                }
+            }
+            const trimmedPayload = payloadValue.trim();
+            const looksLikeLocalPath = trimmedPayload.startsWith("/") ||
+                trimmedPayload.startsWith("./") ||
+                trimmedPayload.startsWith("../") ||
+                trimmedPayload.startsWith("~") ||
+                trimmedPayload.startsWith("file://");
+            if (!unwrapped &&
+                validCount === 1 &&
+                invalidParts.length > 0 &&
+                /\s/.test(payloadValue) &&
+                looksLikeLocalPath) {
+                const fallback = normalizeMediaSource(cleanCandidate(payloadValue));
+                if (isValidMedia(fallback, { allowSpaces: true })) {
+                    media.splice(mediaStartIndex, media.length - mediaStartIndex, fallback);
+                    hasValidMedia = true;
+                    validCount = 1;
+                    invalidParts.length = 0;
+                }
+            }
+            if (!hasValidMedia) {
+                const fallback = normalizeMediaSource(cleanCandidate(payloadValue));
+                if (isValidMedia(fallback, { allowSpaces: true })) {
+                    media.push(fallback);
+                    hasValidMedia = true;
+                    invalidParts.length = 0;
+                }
+            }
+            if (hasValidMedia && invalidParts.length > 0) {
+                pieces.push(invalidParts.join(" "));
+            }
+            cursor = start + match[0].length;
+        }
+        pieces.push(line.slice(cursor));
+        const cleanedLine = pieces
+            .join("")
+            .replace(/[ \t]{2,}/g, " ")
+            .trim();
+        // If the line becomes empty, drop it.
+        if (cleanedLine) {
+            keptLines.push(cleanedLine);
+        }
+        lineOffset += line.length + 1; // +1 for newline
+    }
+    let cleanedText = keptLines
+        .join("\n")
+        .replace(/[ \t]+\n/g, "\n")
+        .replace(/[ \t]{2,}/g, " ")
+        .replace(/\n{2,}/g, "\n")
+        .trim();
+    // Detect and strip [[audio_as_voice]] tag
+    const audioTagResult = parseAudioTag(cleanedText);
+    const hasAudioAsVoice = audioTagResult.audioAsVoice;
+    if (audioTagResult.hadTag) {
+        cleanedText = audioTagResult.text.replace(/\n{2,}/g, "\n").trim();
+    }
+    if (media.length === 0) {
+        const result = {
+            // Return cleaned text if we found a media token OR audio tag, otherwise original
+            text: foundMediaToken || hasAudioAsVoice ? cleanedText : trimmedRaw,
+        };
+        if (hasAudioAsVoice)
+            result.audioAsVoice = true;
+        return result;
+    }
+    return {
+        text: cleanedText,
+        mediaUrls: media,
+        mediaUrl: media[0],
+        ...(hasAudioAsVoice ? { audioAsVoice: true } : {}),
+    };
+}
+//# sourceMappingURL=parse.js.map