@farazirfan/costar-server-executor 1.0.0

package/dist/logging/subsystem.js

@@ -0,0 +1,235 @@
+import { Chalk } from "chalk";
+import { CHAT_CHANNEL_ORDER } from "../channels/registry.js";
+import { defaultRuntime } from "../runtime.js";
+import { getConsoleSettings, shouldLogSubsystemToConsole } from "./console.js";
+import { isVerbose } from "../globals.js";
+import { levelToMinLevel } from "./levels.js";
+import { getChildLogger } from "./logger.js";
+import { loggingState } from "./state.js";
+import { clearActiveProgressLine } from "../terminal/progress-line.js";
+function shouldLogToConsole(level, settings) {
+    if (settings.level === "silent")
+        return false;
+    const current = levelToMinLevel(level);
+    const min = levelToMinLevel(settings.level);
+    return current <= min;
+}
+function isRichConsoleEnv() {
+    const term = (process.env.TERM ?? "").toLowerCase();
+    if (process.env.COLORTERM || process.env.TERM_PROGRAM)
+        return true;
+    return term.length > 0 && term !== "dumb";
+}
+function getColorForConsole() {
+    const hasForceColor = typeof process.env.FORCE_COLOR === "string" &&
+        process.env.FORCE_COLOR.trim().length > 0 &&
+        process.env.FORCE_COLOR.trim() !== "0";
+    if (process.env.NO_COLOR && !hasForceColor)
+        return new Chalk({ level: 0 });
+    const hasTty = Boolean(process.stdout.isTTY || process.stderr.isTTY);
+    return hasTty || isRichConsoleEnv() ? new Chalk({ level: 1 }) : new Chalk({ level: 0 });
+}
+const SUBSYSTEM_COLORS = ["cyan", "green", "yellow", "blue", "magenta", "red"];
+const SUBSYSTEM_COLOR_OVERRIDES = {
+    "gmail-watcher": "blue",
+};
+const SUBSYSTEM_PREFIXES_TO_DROP = ["gateway", "channels", "providers"];
+const SUBSYSTEM_MAX_SEGMENTS = 2;
+const CHANNEL_SUBSYSTEM_PREFIXES = new Set(CHAT_CHANNEL_ORDER);
+function pickSubsystemColor(color, subsystem) {
+    const override = SUBSYSTEM_COLOR_OVERRIDES[subsystem];
+    if (override)
+        return color[override];
+    let hash = 0;
+    for (let i = 0; i < subsystem.length; i += 1) {
+        hash = (hash * 31 + subsystem.charCodeAt(i)) | 0;
+    }
+    const idx = Math.abs(hash) % SUBSYSTEM_COLORS.length;
+    const name = SUBSYSTEM_COLORS[idx];
+    return color[name];
+}
+function formatSubsystemForConsole(subsystem) {
+    const parts = subsystem.split("/").filter(Boolean);
+    const original = parts.join("/") || subsystem;
+    while (parts.length > 0 &&
+        SUBSYSTEM_PREFIXES_TO_DROP.includes(parts[0])) {
+        parts.shift();
+    }
+    if (parts.length === 0)
+        return original;
+    if (CHANNEL_SUBSYSTEM_PREFIXES.has(parts[0])) {
+        return parts[0];
+    }
+    if (parts.length > SUBSYSTEM_MAX_SEGMENTS) {
+        return parts.slice(-SUBSYSTEM_MAX_SEGMENTS).join("/");
+    }
+    return parts.join("/");
+}
+export function stripRedundantSubsystemPrefixForConsole(message, displaySubsystem) {
+    if (!displaySubsystem)
+        return message;
+    // Common duplication: "[discord] discord: ..." (when a message manually includes the subsystem tag).
+    if (message.startsWith("[")) {
+        const closeIdx = message.indexOf("]");
+        if (closeIdx > 1) {
+            const bracketTag = message.slice(1, closeIdx);
+            if (bracketTag.toLowerCase() === displaySubsystem.toLowerCase()) {
+                let i = closeIdx + 1;
+                while (message[i] === " ")
+                    i += 1;
+                return message.slice(i);
+            }
+        }
+    }
+    const prefix = message.slice(0, displaySubsystem.length);
+    if (prefix.toLowerCase() !== displaySubsystem.toLowerCase())
+        return message;
+    const next = message.slice(displaySubsystem.length, displaySubsystem.length + 1);
+    if (next !== ":" && next !== " ")
+        return message;
+    let i = displaySubsystem.length;
+    while (message[i] === " ")
+        i += 1;
+    if (message[i] === ":")
+        i += 1;
+    while (message[i] === " ")
+        i += 1;
+    return message.slice(i);
+}
+function formatConsoleLine(opts) {
+    const displaySubsystem = opts.style === "json" ? opts.subsystem : formatSubsystemForConsole(opts.subsystem);
+    if (opts.style === "json") {
+        return JSON.stringify({
+            time: new Date().toISOString(),
+            level: opts.level,
+            subsystem: displaySubsystem,
+            message: opts.message,
+            ...opts.meta,
+        });
+    }
+    const color = getColorForConsole();
+    const prefix = `[${displaySubsystem}]`;
+    const prefixColor = pickSubsystemColor(color, displaySubsystem);
+    const levelColor = opts.level === "error" || opts.level === "fatal"
+        ? color.red
+        : opts.level === "warn"
+            ? color.yellow
+            : opts.level === "debug" || opts.level === "trace"
+                ? color.gray
+                : color.cyan;
+    const displayMessage = stripRedundantSubsystemPrefixForConsole(opts.message, displaySubsystem);
+    const time = (() => {
+        if (opts.style === "pretty") {
+            return color.gray(new Date().toISOString().slice(11, 19));
+        }
+        if (loggingState.consoleTimestampPrefix) {
+            return color.gray(new Date().toISOString());
+        }
+        return "";
+    })();
+    const prefixToken = prefixColor(prefix);
+    const head = [time, prefixToken].filter(Boolean).join(" ");
+    return `${head} ${levelColor(displayMessage)}`;
+}
+function writeConsoleLine(level, line) {
+    clearActiveProgressLine();
+    const sanitized = process.platform === "win32" && process.env.GITHUB_ACTIONS === "true"
+        ? line.replace(/[\uD800-\uDBFF][\uDC00-\uDFFF]/g, "?").replace(/[\uD800-\uDFFF]/g, "?")
+        : line;
+    const sink = loggingState.rawConsole ?? console;
+    if (loggingState.forceConsoleToStderr || level === "error" || level === "fatal") {
+        (sink.error ?? console.error)(sanitized);
+    }
+    else if (level === "warn") {
+        (sink.warn ?? console.warn)(sanitized);
+    }
+    else {
+        (sink.log ?? console.log)(sanitized);
+    }
+}
+function logToFile(fileLogger, level, message, meta) {
+    if (level === "silent")
+        return;
+    const safeLevel = level;
+    const method = fileLogger[safeLevel];
+    if (typeof method !== "function")
+        return;
+    if (meta && Object.keys(meta).length > 0) {
+        method.call(fileLogger, meta, message);
+    }
+    else {
+        method.call(fileLogger, message);
+    }
+}
+export function createSubsystemLogger(subsystem) {
+    let fileLogger = null;
+    const getFileLogger = () => {
+        if (!fileLogger)
+            fileLogger = getChildLogger({ subsystem });
+        return fileLogger;
+    };
+    const emit = (level, message, meta) => {
+        const consoleSettings = getConsoleSettings();
+        let consoleMessageOverride;
+        let fileMeta = meta;
+        if (meta && Object.keys(meta).length > 0) {
+            const { consoleMessage, ...rest } = meta;
+            if (typeof consoleMessage === "string") {
+                consoleMessageOverride = consoleMessage;
+            }
+            fileMeta = Object.keys(rest).length > 0 ? rest : undefined;
+        }
+        logToFile(getFileLogger(), level, message, fileMeta);
+        if (!shouldLogToConsole(level, { level: consoleSettings.level }))
+            return;
+        if (!shouldLogSubsystemToConsole(subsystem))
+            return;
+        const consoleMessage = consoleMessageOverride ?? message;
+        if (!isVerbose() &&
+            subsystem === "agent/embedded" &&
+            /(sessionId|runId)=probe-/.test(consoleMessage)) {
+            return;
+        }
+        const line = formatConsoleLine({
+            level,
+            subsystem,
+            message: consoleSettings.style === "json" ? message : consoleMessage,
+            style: consoleSettings.style,
+            meta: fileMeta,
+        });
+        writeConsoleLine(level, line);
+    };
+    const logger = {
+        subsystem,
+        trace: (message, meta) => emit("trace", message, meta),
+        debug: (message, meta) => emit("debug", message, meta),
+        info: (message, meta) => emit("info", message, meta),
+        warn: (message, meta) => emit("warn", message, meta),
+        error: (message, meta) => emit("error", message, meta),
+        fatal: (message, meta) => emit("fatal", message, meta),
+        raw: (message) => {
+            logToFile(getFileLogger(), "info", message, { raw: true });
+            if (shouldLogSubsystemToConsole(subsystem)) {
+                if (!isVerbose() &&
+                    subsystem === "agent/embedded" &&
+                    /(sessionId|runId)=probe-/.test(message)) {
+                    return;
+                }
+                writeConsoleLine("info", message);
+            }
+        },
+        child: (name) => createSubsystemLogger(`${subsystem}/${name}`),
+    };
+    return logger;
+}
+export function runtimeForLogger(logger, exit = defaultRuntime.exit) {
+    return {
+        log: (message) => logger.info(message),
+        error: (message) => logger.error(message),
+        exit,
+    };
+}
+export function createSubsystemRuntime(subsystem, exit = defaultRuntime.exit) {
+    return runtimeForLogger(createSubsystemLogger(subsystem), exit);
+}
+//# sourceMappingURL=subsystem.js.map

package/dist/logging/subsystem.js.map

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

package/dist/media/audio-tags.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extract audio mode tag from text.
+ * Supports [[audio_as_voice]] to send audio as voice bubble instead of file.
+ * Default is file (preserves backward compatibility).
+ */
+export declare function parseAudioTag(text?: string): {
+    text: string;
+    audioAsVoice: boolean;
+    hadTag: boolean;
+};
+//# sourceMappingURL=audio-tags.d.ts.map

package/dist/media/audio-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-tags.d.ts","sourceRoot":"","sources":["../../src/media/audio-tags.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB,CAOA"}

package/dist/media/audio-tags.js

@@ -0,0 +1,15 @@
+import { parseInlineDirectives } from "../utils/directive-tags.js";
+/**
+ * Extract audio mode tag from text.
+ * Supports [[audio_as_voice]] to send audio as voice bubble instead of file.
+ * Default is file (preserves backward compatibility).
+ */
+export function parseAudioTag(text) {
+    const result = parseInlineDirectives(text, { stripReplyTags: false });
+    return {
+        text: result.text,
+        audioAsVoice: result.audioAsVoice,
+        hadTag: result.hasAudioTag,
+    };
+}
+//# sourceMappingURL=audio-tags.js.map

package/dist/media/audio-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-tags.js","sourceRoot":"","sources":["../../src/media/audio-tags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IAKzC,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,MAAM,EAAE,MAAM,CAAC,WAAW;KAC3B,CAAC;AACJ,CAAC"}

package/dist/media/audio.d.ts

@@ -0,0 +1,5 @@
+export declare function isVoiceCompatibleAudio(opts: {
+    contentType?: string | null;
+    fileName?: string | null;
+}): boolean;
+//# sourceMappingURL=audio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/media/audio.ts"],"names":[],"mappings":"AAIA,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GAAG,OAAO,CAUV"}

package/dist/media/audio.js

@@ -0,0 +1,16 @@
+import { getFileExtension } from "./mime.js";
+const VOICE_AUDIO_EXTENSIONS = new Set([".oga", ".ogg", ".opus"]);
+export function isVoiceCompatibleAudio(opts) {
+    const mime = opts.contentType?.toLowerCase();
+    if (mime && (mime.includes("ogg") || mime.includes("opus"))) {
+        return true;
+    }
+    const fileName = opts.fileName?.trim();
+    if (!fileName)
+        return false;
+    const ext = getFileExtension(fileName);
+    if (!ext)
+        return false;
+    return VOICE_AUDIO_EXTENSIONS.has(ext);
+}
+//# sourceMappingURL=audio.js.map

package/dist/media/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/media/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAElE,MAAM,UAAU,sBAAsB,CAAC,IAGtC;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC;IAC7C,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,OAAO,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/media/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const MAX_IMAGE_BYTES: number;
+export declare const MAX_AUDIO_BYTES: number;
+export declare const MAX_VIDEO_BYTES: number;
+export declare const MAX_DOCUMENT_BYTES: number;
+export type MediaKind = "image" | "audio" | "video" | "document" | "unknown";
+export declare function mediaKindFromMime(mime?: string | null): MediaKind;
+export declare function maxBytesForKind(kind: MediaKind): number;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/media/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,QAAkB,CAAC;AAC/C,eAAO,MAAM,eAAe,QAAmB,CAAC;AAChD,eAAO,MAAM,eAAe,QAAmB,CAAC;AAChD,eAAO,MAAM,kBAAkB,QAAoB,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7E,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAQjE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAavD"}

package/dist/media/constants.js

@@ -0,0 +1,34 @@
+export const MAX_IMAGE_BYTES = 6 * 1024 * 1024; // 6MB
+export const MAX_AUDIO_BYTES = 16 * 1024 * 1024; // 16MB
+export const MAX_VIDEO_BYTES = 16 * 1024 * 1024; // 16MB
+export const MAX_DOCUMENT_BYTES = 100 * 1024 * 1024; // 100MB
+export function mediaKindFromMime(mime) {
+    if (!mime)
+        return "unknown";
+    if (mime.startsWith("image/"))
+        return "image";
+    if (mime.startsWith("audio/"))
+        return "audio";
+    if (mime.startsWith("video/"))
+        return "video";
+    if (mime === "application/pdf")
+        return "document";
+    if (mime.startsWith("application/"))
+        return "document";
+    return "unknown";
+}
+export function maxBytesForKind(kind) {
+    switch (kind) {
+        case "image":
+            return MAX_IMAGE_BYTES;
+        case "audio":
+            return MAX_AUDIO_BYTES;
+        case "video":
+            return MAX_VIDEO_BYTES;
+        case "document":
+            return MAX_DOCUMENT_BYTES;
+        default:
+            return MAX_DOCUMENT_BYTES;
+    }
+}
+//# sourceMappingURL=constants.js.map

package/dist/media/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/media/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM;AACtD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;AACxD,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAI7D,MAAM,UAAU,iBAAiB,CAAC,IAAoB;IACpD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,IAAI,KAAK,iBAAiB;QAAE,OAAO,UAAU,CAAC;IAClD,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,UAAU,CAAC;IACvD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,eAAe,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,eAAe,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,eAAe,CAAC;QACzB,KAAK,UAAU;YACb,OAAO,kBAAkB,CAAC;QAC5B;YACE,OAAO,kBAAkB,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/media/fetch.d.ts

@@ -0,0 +1,20 @@
+type FetchMediaResult = {
+    buffer: Buffer;
+    contentType?: string;
+    fileName?: string;
+};
+export type MediaFetchErrorCode = "max_bytes" | "http_error" | "fetch_failed";
+export declare class MediaFetchError extends Error {
+    readonly code: MediaFetchErrorCode;
+    constructor(code: MediaFetchErrorCode, message: string);
+}
+export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+type FetchMediaOptions = {
+    url: string;
+    fetchImpl?: FetchLike;
+    filePathHint?: string;
+    maxBytes?: number;
+};
+export declare function fetchRemoteMedia(options: FetchMediaOptions): Promise<FetchMediaResult>;
+export {};
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/media/fetch.ts"],"names":[],"mappings":"AAIA,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,CAAC;AAE9E,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAKvD;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5F,KAAK,iBAAiB,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAoCF,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0E5F"}

package/dist/media/fetch.js

@@ -0,0 +1,152 @@
+import path from "node:path";
+import { detectMime, extensionForMime } from "./mime.js";
+export class MediaFetchError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "MediaFetchError";
+    }
+}
+function stripQuotes(value) {
+    return value.replace(/^["']|["']$/g, "");
+}
+function parseContentDispositionFileName(header) {
+    if (!header)
+        return undefined;
+    const starMatch = /filename\*\s*=\s*([^;]+)/i.exec(header);
+    if (starMatch?.[1]) {
+        const cleaned = stripQuotes(starMatch[1].trim());
+        const encoded = cleaned.split("''").slice(1).join("''") || cleaned;
+        try {
+            return path.basename(decodeURIComponent(encoded));
+        }
+        catch {
+            return path.basename(encoded);
+        }
+    }
+    const match = /filename\s*=\s*([^;]+)/i.exec(header);
+    if (match?.[1])
+        return path.basename(stripQuotes(match[1].trim()));
+    return undefined;
+}
+async function readErrorBodySnippet(res, maxChars = 200) {
+    try {
+        const text = await res.text();
+        if (!text)
+            return undefined;
+        const collapsed = text.replace(/\s+/g, " ").trim();
+        if (!collapsed)
+            return undefined;
+        if (collapsed.length <= maxChars)
+            return collapsed;
+        return `${collapsed.slice(0, maxChars)}…`;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function fetchRemoteMedia(options) {
+    const { url, fetchImpl, filePathHint, maxBytes } = options;
+    const fetcher = fetchImpl ?? globalThis.fetch;
+    if (!fetcher) {
+        throw new Error("fetch is not available");
+    }
+    let res;
+    try {
+        res = await fetcher(url);
+    }
+    catch (err) {
+        throw new MediaFetchError("fetch_failed", `Failed to fetch media from ${url}: ${String(err)}`);
+    }
+    if (!res.ok) {
+        const statusText = res.statusText ? ` ${res.statusText}` : "";
+        const redirected = res.url && res.url !== url ? ` (redirected to ${res.url})` : "";
+        let detail = `HTTP ${res.status}${statusText}`;
+        if (!res.body) {
+            detail = `HTTP ${res.status}${statusText}; empty response body`;
+        }
+        else {
+            const snippet = await readErrorBodySnippet(res);
+            if (snippet)
+                detail += `; body: ${snippet}`;
+        }
+        throw new MediaFetchError("http_error", `Failed to fetch media from ${url}${redirected}: ${detail}`);
+    }
+    const contentLength = res.headers.get("content-length");
+    if (maxBytes && contentLength) {
+        const length = Number(contentLength);
+        if (Number.isFinite(length) && length > maxBytes) {
+            throw new MediaFetchError("max_bytes", `Failed to fetch media from ${url}: content length ${length} exceeds maxBytes ${maxBytes}`);
+        }
+    }
+    const buffer = maxBytes
+        ? await readResponseWithLimit(res, maxBytes)
+        : Buffer.from(await res.arrayBuffer());
+    let fileNameFromUrl;
+    try {
+        const parsed = new URL(url);
+        const base = path.basename(parsed.pathname);
+        fileNameFromUrl = base || undefined;
+    }
+    catch {
+        // ignore parse errors; leave undefined
+    }
+    const headerFileName = parseContentDispositionFileName(res.headers.get("content-disposition"));
+    let fileName = headerFileName || fileNameFromUrl || (filePathHint ? path.basename(filePathHint) : undefined);
+    const filePathForMime = headerFileName && path.extname(headerFileName) ? headerFileName : (filePathHint ?? url);
+    const contentType = await detectMime({
+        buffer,
+        headerMime: res.headers.get("content-type"),
+        filePath: filePathForMime,
+    });
+    if (fileName && !path.extname(fileName) && contentType) {
+        const ext = extensionForMime(contentType);
+        if (ext)
+            fileName = `${fileName}${ext}`;
+    }
+    return {
+        buffer,
+        contentType: contentType ?? undefined,
+        fileName,
+    };
+}
+async function readResponseWithLimit(res, maxBytes) {
+    const body = res.body;
+    if (!body || typeof body.getReader !== "function") {
+        const fallback = Buffer.from(await res.arrayBuffer());
+        if (fallback.length > maxBytes) {
+            throw new MediaFetchError("max_bytes", `Failed to fetch media from ${res.url || "response"}: payload exceeds maxBytes ${maxBytes}`);
+        }
+        return fallback;
+    }
+    const reader = body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value?.length) {
+                total += value.length;
+                if (total > maxBytes) {
+                    try {
+                        await reader.cancel();
+                    }
+                    catch { }
+                    throw new MediaFetchError("max_bytes", `Failed to fetch media from ${res.url || "response"}: payload exceeds maxBytes ${maxBytes}`);
+                }
+                chunks.push(value);
+            }
+        }
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch { }
+    }
+    return Buffer.concat(chunks.map((chunk) => Buffer.from(chunk)), total);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/media/fetch.js.map

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

package/dist/media/host.d.ts

@@ -0,0 +1,12 @@
+import { type RuntimeEnv } from "../runtime.js";
+export type HostedMedia = {
+    url: string;
+    id: string;
+    size: number;
+};
+export declare function ensureMediaHosted(source: string, opts?: {
+    port?: number;
+    startServer?: boolean;
+    runtime?: RuntimeEnv;
+}): Promise<HostedMedia>;
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/media/host.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAUhE,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,UAAU,CAAC;CACjB,GACL,OAAO,CAAC,WAAW,CAAC,CA4BtB"}

package/dist/media/host.js

@@ -0,0 +1,44 @@
+import fs from "node:fs/promises";
+import { ensurePortAvailable, PortInUseError } from "../infra/ports.js";
+import { getTailnetHostname } from "../infra/tailscale.js";
+import { logInfo } from "../logger.js";
+import { defaultRuntime } from "../runtime.js";
+import { formatCliCommand } from "../cli/command-format.js";
+import { startMediaServer } from "./server.js";
+import { saveMediaSource } from "./store.js";
+const DEFAULT_PORT = 42873;
+const TTL_MS = 2 * 60 * 1000;
+let mediaServer = null;
+export async function ensureMediaHosted(source, opts = {}) {
+    const port = opts.port ?? DEFAULT_PORT;
+    const runtime = opts.runtime ?? defaultRuntime;
+    const saved = await saveMediaSource(source);
+    const hostname = await getTailnetHostname();
+    // Decide whether we must start a media server.
+    const needsServerStart = await isPortFree(port);
+    if (needsServerStart && !opts.startServer) {
+        await fs.rm(saved.path).catch(() => { });
+        throw new Error(`Media hosting requires the webhook/Funnel server. Start \`${formatCliCommand("openclaw webhook")}\`/\`${formatCliCommand("openclaw up")}\` or re-run with --serve-media.`);
+    }
+    if (needsServerStart && opts.startServer) {
+        if (!mediaServer) {
+            mediaServer = await startMediaServer(port, TTL_MS, runtime);
+            logInfo(`🦞 Started temporary media host on http://localhost:${port}/media/:id (TTL ${TTL_MS / 1000}s)`, runtime);
+            mediaServer.unref?.();
+        }
+    }
+    const url = `https://${hostname}/media/${saved.id}`;
+    return { url, id: saved.id, size: saved.size };
+}
+async function isPortFree(port) {
+    try {
+        await ensurePortAvailable(port);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof PortInUseError)
+            return false;
+        throw err;
+    }
+}
+//# sourceMappingURL=host.js.map

package/dist/media/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/media/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAmB,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,YAAY,GAAG,KAAK,CAAC;AAC3B,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7B,IAAI,WAAW,GAAiC,IAAI,CAAC;AAQrD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,OAII,EAAE;IAEN,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;IAE/C,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAE5C,+CAA+C;IAC/C,MAAM,gBAAgB,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,gBAAgB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,6DAA6D,gBAAgB,CAAC,kBAAkB,CAAC,QAAQ,gBAAgB,CAAC,aAAa,CAAC,kCAAkC,CAC3K,CAAC;IACJ,CAAC;IACD,IAAI,gBAAgB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC5D,OAAO,CACL,uDAAuD,IAAI,mBAAmB,MAAM,GAAG,IAAI,IAAI,EAC/F,OAAO,CACR,CAAC;YACF,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,WAAW,QAAQ,UAAU,KAAK,CAAC,EAAE,EAAE,CAAC;IACpD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,cAAc;YAAE,OAAO,KAAK,CAAC;QAChD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}