@elizaos/ui 2.0.0-beta.2 → 2.0.3-beta.2

package/utils/eliza-globals.js

@@ -1,48 +1 @@
-function getElizaWindow() {
-    return typeof window === "undefined" ? null : window;
-}
-function readTrimmedString(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-export function getElizaApiBase() {
-    const elizaWindow = getElizaWindow();
-    return (readTrimmedString(elizaWindow?.__ELIZA_API_BASE__) ??
-        readTrimmedString(elizaWindow?.__ELIZAOS_API_BASE__));
-}
-export function getElizaApiToken() {
-    const elizaWindow = getElizaWindow();
-    return (readTrimmedString(elizaWindow?.__ELIZA_API_TOKEN__) ??
-        readTrimmedString(elizaWindow?.__ELIZAOS_API_TOKEN__));
-}
-export function setElizaApiBase(value) {
-    const elizaWindow = getElizaWindow();
-    if (elizaWindow) {
-        elizaWindow.__ELIZAOS_API_BASE__ = value;
-        elizaWindow.__ELIZA_API_BASE__ = value;
-    }
-}
-export function clearElizaApiBase() {
-    const elizaWindow = getElizaWindow();
-    if (elizaWindow) {
-        Reflect.deleteProperty(elizaWindow, "__ELIZAOS_API_BASE__");
-        Reflect.deleteProperty(elizaWindow, "__ELIZA_API_BASE__");
-    }
-}
-export function setElizaApiToken(value) {
-    const elizaWindow = getElizaWindow();
-    if (elizaWindow) {
-        elizaWindow.__ELIZAOS_API_TOKEN__ = value;
-        elizaWindow.__ELIZA_API_TOKEN__ = value;
-    }
-}
-export function clearElizaApiToken() {
-    const elizaWindow = getElizaWindow();
-    if (elizaWindow) {
-        Reflect.deleteProperty(elizaWindow, "__ELIZAOS_API_TOKEN__");
-        Reflect.deleteProperty(elizaWindow, "__ELIZA_API_TOKEN__");
-    }
-}
+export { clearElizaApiBase, clearElizaApiToken, getElizaApiBase, getElizaApiToken, setElizaApiBase, setElizaApiToken, } from "@elizaos/shared";

package/utils/errors.d.ts

@@ -1,13 +1,2 @@
-/**
- * Shared error classification helpers.
- *
- * Consolidates the timeout detection pattern that was independently
- * implemented in cloud-routes.ts and cloud-connection.ts.
- */
-/** Classify an error as a fetch/AbortSignal timeout. */
-export declare function isTimeoutError(error: unknown): boolean;
-/** Classify a fetch Response as a redirect (3xx). */
-export declare function isRedirectResponse(response: Response): boolean;
-/** Extract a human-readable message from an unknown caught value. */
-export declare function errorMessage(error: unknown): string;
+export { errorMessage, isRedirectResponse, isTimeoutError, } from "@elizaos/shared";
 //# sourceMappingURL=errors.d.ts.map

package/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKtD;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE9D;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/utils/errors.js

@@ -1,25 +1 @@
-/**
- * Shared error classification helpers.
- *
- * Consolidates the timeout detection pattern that was independently
- * implemented in cloud-routes.ts and cloud-connection.ts.
- */
-/** Classify an error as a fetch/AbortSignal timeout. */
-export function isTimeoutError(error) {
-    if (!(error instanceof Error))
-        return false;
-    if (error.name === "TimeoutError" || error.name === "AbortError")
-        return true;
-    const msg = error.message.toLowerCase();
-    return msg.includes("timed out") || msg.includes("timeout");
-}
-/** Classify a fetch Response as a redirect (3xx). */
-export function isRedirectResponse(response) {
-    return response.status >= 300 && response.status < 400;
-}
-/** Extract a human-readable message from an unknown caught value. */
-export function errorMessage(error) {
-    if (error instanceof Error)
-        return error.message;
-    return String(error);
-}
+export { errorMessage, isRedirectResponse, isTimeoutError, } from "@elizaos/shared";

package/utils/format.d.ts

@@ -1,66 +1,12 @@
+export { formatByteSize, formatDateTime, formatDurationMs, formatShortDate, formatTime, formatUptime, } from "@elizaos/shared";
+type RelativeTimeTranslator = (key: string, vars?: Record<string, string | number | boolean | null | undefined>) => string;
 /**
- * Shared formatting helpers for Eliza app views.
- */
-/**
- * Format an uptime duration in seconds into a compact human string.
+ * Canonical "time ago" formatter for UI surfaces.
  *
- * When `verbose` is true the output uses every non-zero unit (e.g. "2d 3h 15m").
- * Otherwise the two most-significant units are returned (e.g. "2d 3h").
- */
-export declare function formatUptime(seconds?: number, verbose?: boolean): string;
-type ByteSizeFormatterOptions = {
-    /**
-     * Fallback string for invalid or negative byte values.
-     */
-    unknownLabel?: string;
-    /**
-     * Precision for KB / MB / GB / TB values.
-     */
-    kbPrecision?: number;
-    mbPrecision?: number;
-    gbPrecision?: number;
-    tbPrecision?: number;
-};
-type DateFormatOptions = {
-    /**
-     * Fallback string for empty/invalid dates.
-     */
-    fallback?: string;
-    /**
-     * Optional locale override.
-     */
-    locale?: string;
-};
-type DurationFormatOptions = {
-    /**
-     * Fallback string for non-positive/invalid durations.
-     */
-    fallback?: string;
-    /**
-     * Optional translation function for localized duration labels.
-     * When provided, uses i18n keys like "format.duration.seconds" etc.
-     */
-    t?: (key: string, vars?: Record<string, string | number>) => string;
-};
-/**
- * Format a byte count in human-readable units.
- */
-export declare function formatByteSize(bytes: number, options?: ByteSizeFormatterOptions): string;
-/**
- * Format timestamp / date for locale display (`toLocaleString`).
- */
-export declare function formatDateTime(value: number | string | Date | null | undefined, options?: DateFormatOptions): string;
-/**
- * Format timestamp / date as locale time only (`toLocaleTimeString`).
- */
-export declare function formatTime(value: number | string | Date | null | undefined, options?: DateFormatOptions): string;
-/**
- * Format timestamp / date as locale date only (`toLocaleDateString`).
- */
-export declare function formatShortDate(value: number | string | Date | null | undefined, options?: DateFormatOptions): string;
-/**
- * Format an elapsed duration in milliseconds into a compact human string.
+ * The bucketing (just-now / minutes / hours / days, then an absolute date
+ * past one week) is shared. Callers in i18n contexts pass a `t` translator
+ * keyed under `conversations.*`; callers without i18n omit it and receive the
+ * English defaults. Past one week the value falls back to a locale date.
  */
-export declare function formatDurationMs(ms?: number | null, options?: DurationFormatOptions): string;
-export {};
+export declare function formatRelativeTime(value: string | number | Date, t?: RelativeTimeTranslator): string;
 //# sourceMappingURL=format.d.ts.map

package/utils/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAoBxE;AAED,KAAK,wBAAwB,GAAG;IAC9B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;CACrE,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAChD,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAChD,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAChD,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAoBR"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../../src/utils/format.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,KAAK,sBAAsB,GAAG,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,KAChE,MAAM,CAAC;AAEZ;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC7B,CAAC,CAAC,EAAE,sBAAsB,GACzB,MAAM,CA4BR"}

package/utils/format.js

@@ -1,121 +1,38 @@
+export { formatByteSize, formatDateTime, formatDurationMs, formatShortDate, formatTime, formatUptime, } from "@elizaos/shared";
 /**
- * Shared formatting helpers for Eliza app views.
- */
-/**
- * Format an uptime duration in seconds into a compact human string.
+ * Canonical "time ago" formatter for UI surfaces.
  *
- * When `verbose` is true the output uses every non-zero unit (e.g. "2d 3h 15m").
- * Otherwise the two most-significant units are returned (e.g. "2d 3h").
- */
-export function formatUptime(seconds, verbose) {
-    if (seconds == null || seconds < 0)
-        return "—";
-    const d = Math.floor(seconds / 86400);
-    const h = Math.floor((seconds % 86400) / 3600);
-    const m = Math.floor((seconds % 3600) / 60);
-    const s = Math.floor(seconds % 60);
-    if (verbose) {
-        const parts = [];
-        if (d > 0)
-            parts.push(`${d}d`);
-        if (h > 0)
-            parts.push(`${h}h`);
-        if (m > 0)
-            parts.push(`${m}m`);
-        if (parts.length === 0)
-            parts.push(`${s}s`);
-        return parts.join(" ");
-    }
-    if (d > 0)
-        return `${d}d ${h}h`;
-    if (h > 0)
-        return `${h}h ${m}m`;
-    if (m > 0)
-        return `${m}m`;
-    return `${s}s`;
-}
-/**
- * Format a byte count in human-readable units.
- */
-export function formatByteSize(bytes, options = {}) {
-    const { unknownLabel = "unknown", kbPrecision = 1, mbPrecision = 1, gbPrecision = 1, tbPrecision = 1, } = options;
-    if (!Number.isFinite(bytes) || bytes < 0)
-        return unknownLabel;
-    if (bytes >= 1024 ** 4) {
-        return `${(bytes / 1024 ** 4).toFixed(tbPrecision)} TB`;
-    }
-    if (bytes >= 1024 ** 3) {
-        return `${(bytes / 1024 ** 3).toFixed(gbPrecision)} GB`;
-    }
-    if (bytes >= 1024 ** 2) {
-        return `${(bytes / 1024 ** 2).toFixed(mbPrecision)} MB`;
-    }
-    if (bytes >= 1024) {
-        return `${(bytes / 1024).toFixed(kbPrecision)} KB`;
-    }
-    return `${bytes} B`;
-}
-/**
- * Format timestamp / date for locale display (`toLocaleString`).
+ * The bucketing (just-now / minutes / hours / days, then an absolute date
+ * past one week) is shared. Callers in i18n contexts pass a `t` translator
+ * keyed under `conversations.*`; callers without i18n omit it and receive the
+ * English defaults. Past one week the value falls back to a locale date.
  */
-export function formatDateTime(value, options = {}) {
-    const { fallback = "—", locale } = options;
-    if (value == null || value === "")
-        return fallback;
-    const parsed = value instanceof Date ? value : new Date(value);
-    if (!Number.isFinite(parsed.getTime()))
-        return fallback;
-    return parsed.toLocaleString(locale);
-}
-/**
- * Format timestamp / date as locale time only (`toLocaleTimeString`).
- */
-export function formatTime(value, options = {}) {
-    const { fallback = "—", locale } = options;
-    if (value == null || value === "")
-        return fallback;
-    const parsed = value instanceof Date ? value : new Date(value);
-    if (!Number.isFinite(parsed.getTime()))
-        return fallback;
-    return parsed.toLocaleTimeString(locale);
-}
-/**
- * Format timestamp / date as locale date only (`toLocaleDateString`).
- */
-export function formatShortDate(value, options = {}) {
-    const { fallback = "—", locale } = options;
-    if (value == null || value === "")
-        return fallback;
-    const parsed = value instanceof Date ? value : new Date(value);
-    if (!Number.isFinite(parsed.getTime()))
-        return fallback;
-    return parsed.toLocaleDateString(locale, {
-        year: "numeric",
-        month: "short",
-        day: "numeric",
-    });
-}
-/**
- * Format an elapsed duration in milliseconds into a compact human string.
- */
-export function formatDurationMs(ms, options = {}) {
-    const { fallback = "—", t } = options;
-    if (ms == null || !Number.isFinite(ms) || ms < 0)
-        return fallback;
-    if (ms < 60_000) {
-        const value = Math.round(ms / 1000);
-        return t ? t("format.duration.seconds", { value }) : `${value}s`;
-    }
-    if (ms < 3_600_000) {
-        const value = Math.round(ms / 60_000);
-        return t ? t("format.duration.minutes", { value }) : `${value}m`;
-    }
-    if (ms < 86_400_000) {
-        const hours = ms / 3_600_000;
-        const value = hours === Math.floor(hours) ? hours : Number(hours.toFixed(1));
-        return t ? t("format.duration.hours", { value }) : `${value}h`;
-    }
-    const days = ms / 86_400_000;
-    const value = days === Math.floor(days) ? days : Number(days.toFixed(1));
-    return t ? t("format.duration.days", { value }) : `${value}d`;
+export function formatRelativeTime(value, t) {
+    const date = value instanceof Date ? value : new Date(value);
+    const time = date.getTime();
+    if (!Number.isFinite(time)) {
+        return t ? t("conversations.justNow") : "just now";
+    }
+    const diffMs = Date.now() - time;
+    const diffMins = Math.floor(diffMs / 60_000);
+    const diffHours = Math.floor(diffMs / 3_600_000);
+    const diffDays = Math.floor(diffMs / 86_400_000);
+    if (diffMins < 1)
+        return t ? t("conversations.justNow") : "just now";
+    if (diffMins < 60) {
+        return t
+            ? t("conversations.minutesAgo", { count: diffMins })
+            : `${diffMins}m ago`;
+    }
+    if (diffHours < 24) {
+        return t
+            ? t("conversations.hoursAgo", { count: diffHours })
+            : `${diffHours}h ago`;
+    }
+    if (diffDays < 7) {
+        return t
+            ? t("conversations.daysAgo", { count: diffDays })
+            : `${diffDays}d ago`;
+    }
+    return date.toLocaleDateString();
 }

package/utils/globals.js

@@ -1,4 +1,4 @@
-import { logger } from "@elizaos/core";
+import { logger } from "@elizaos/logger";
 import { theme } from "../terminal/theme.js";
 const LOG_LEVEL_PRIORITY = {
     trace: 10,

package/utils/host-capabilities.d.ts

@@ -0,0 +1,39 @@
+/**
+ * host-capabilities.ts — UI-side mirror of the workflow engine's host
+ * capability detection.
+ *
+ * The canonical truth lives in `@elizaos/plugin-workflow/src/utils/host-
+ * capabilities.ts`. This module duplicates the detection because the UI
+ * package must not depend on a plugin runtime (presentation → infrastructure
+ * is a layer-direction violation), and the detection is a tiny pure check.
+ *
+ * Keep the two in sync. The label strings here are user-facing copy and
+ * should match the ones in the plugin so users see consistent wording
+ * across engine-emitted errors and UI banners.
+ */
+export interface UiHostCapabilities {
+    /** Host process stays alive across schedule firings. */
+    longRunning: boolean;
+    /** True when running inside a Capacitor (iOS/Android) shell. */
+    isMobile: boolean;
+    /** True for a pure browser tab (no Capacitor, no Node). */
+    isBrowser: boolean;
+    /** Human-readable host label for banners and warnings. */
+    label: string;
+}
+export declare function detectUiHostCapabilities(): UiHostCapabilities;
+/**
+ * Short cadence threshold below which mobile and browser hosts cannot
+ * keep up. iOS/Android background-runner wakes are bounded to ~15 minutes
+ * (WorkManager floor; BGTaskScheduler is opportunistic and typically wakes
+ * less often). Anything tighter than this is misleading on those hosts.
+ */
+export declare const SHORT_INTERVAL_THRESHOLD_MS: number;
+export interface IntervalHostWarning {
+    /** Translation-ready message body. */
+    message: string;
+    /** Whether to surface the warning at all. */
+    show: boolean;
+}
+export declare function intervalHostWarning(host: UiHostCapabilities, intervalMs: number): IntervalHostWarning;
+//# sourceMappingURL=host-capabilities.d.ts.map

package/utils/host-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-capabilities.d.ts","sourceRoot":"","sources":["../../../../../src/utils/host-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAoD7D;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,QAAiB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,kBAAkB,EACxB,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAmBrB"}

package/utils/host-capabilities.js

@@ -0,0 +1,85 @@
+/**
+ * host-capabilities.ts — UI-side mirror of the workflow engine's host
+ * capability detection.
+ *
+ * The canonical truth lives in `@elizaos/plugin-workflow/src/utils/host-
+ * capabilities.ts`. This module duplicates the detection because the UI
+ * package must not depend on a plugin runtime (presentation → infrastructure
+ * is a layer-direction violation), and the detection is a tiny pure check.
+ *
+ * Keep the two in sync. The label strings here are user-facing copy and
+ * should match the ones in the plugin so users see consistent wording
+ * across engine-emitted errors and UI banners.
+ */
+export function detectUiHostCapabilities() {
+    // Cloudflare Workers — short-lived per request, no persistent process.
+    if (typeof navigator !== "undefined" &&
+        typeof navigator?.userAgent === "string" &&
+        navigator.userAgent.includes("Cloudflare-Workers")) {
+        return {
+            longRunning: false,
+            isMobile: false,
+            isBrowser: false,
+            label: "Cloudflare Worker",
+        };
+    }
+    // Capacitor (iOS / Android). `longRunning` is conditional on a registered
+    // BackgroundRunner plugin: without it, the JS context suspends within
+    // seconds of backgrounding. We probe the plugin instance rather than
+    // trusting a build-time flag.
+    const capacitor = Reflect.get(globalThis, "Capacitor");
+    if (capacitor && typeof capacitor === "object") {
+        const plugins = Reflect.get(capacitor, "Plugins");
+        const bgRunner = plugins && typeof plugins === "object"
+            ? Reflect.get(plugins, "BackgroundRunner")
+            : undefined;
+        const hasBgRunner = typeof bgRunner === "object" && bgRunner !== null;
+        return {
+            longRunning: hasBgRunner,
+            isMobile: true,
+            isBrowser: false,
+            label: hasBgRunner ? "Mobile" : "Mobile (foreground-only)",
+        };
+    }
+    // Browser without Capacitor — pure web. Tabs can be discarded by the OS.
+    if (typeof window !== "undefined" && typeof process === "undefined") {
+        return {
+            longRunning: false,
+            isMobile: false,
+            isBrowser: true,
+            label: "Browser",
+        };
+    }
+    // Node — server / desktop. Stays alive.
+    return {
+        longRunning: true,
+        isMobile: false,
+        isBrowser: false,
+        label: "Desktop",
+    };
+}
+/**
+ * Short cadence threshold below which mobile and browser hosts cannot
+ * keep up. iOS/Android background-runner wakes are bounded to ~15 minutes
+ * (WorkManager floor; BGTaskScheduler is opportunistic and typically wakes
+ * less often). Anything tighter than this is misleading on those hosts.
+ */
+export const SHORT_INTERVAL_THRESHOLD_MS = 15 * 60 * 1000;
+export function intervalHostWarning(host, intervalMs) {
+    if (intervalMs >= SHORT_INTERVAL_THRESHOLD_MS) {
+        return { show: false, message: "" };
+    }
+    if (host.isMobile) {
+        return {
+            show: true,
+            message: "Mobile devices can only check at most every 15 minutes. This trigger will fire at the host's minimum cadence (~15 min).",
+        };
+    }
+    if (host.isBrowser) {
+        return {
+            show: true,
+            message: "Browser tabs can be discarded by the OS. This trigger may stop firing when the tab is hidden.",
+        };
+    }
+    return { show: false, message: "" };
+}

package/utils/image-attachment.d.ts

@@ -0,0 +1,35 @@
+import type { ImageAttachment } from "../api/client-types-chat";
+/**
+ * Server-side cap (MAX_CHAT_IMAGES) mirrored client-side so the user gets
+ * immediate feedback rather than a 400 after upload. Applies to all attachment
+ * kinds, not just images.
+ */
+export declare const MAX_CHAT_IMAGES = 4;
+/** `accept` attribute for the chat upload <input> — images, audio, video, PDFs, text docs. */
+export declare const CHAT_UPLOAD_ACCEPT = "image/*,audio/*,video/*,application/pdf,text/plain,text/csv,text/markdown";
+/** True when a file's MIME type is an attachment kind chat upload accepts. */
+export declare function isSupportedChatUpload(file: File): boolean;
+/** Map a MIME type to the rendered attachment kind (for preview tiles). */
+export declare function chatUploadKind(mimeType: string): "image" | "audio" | "video" | "document";
+/**
+ * Generate a downscaled JPEG thumbnail for a large image, entirely client-side
+ * via `<canvas>` (works in every browser/desktop/iOS/Android webview — no
+ * native deps). Returns base64 (no data-URL prefix) + mime, or null when the
+ * file isn't a raster image, is already small, or can't be decoded. JPEG +
+ * `<canvas>.toDataURL` is used for universal webview support (WebP/OffscreenCanvas
+ * are not reliable on older WKWebView).
+ */
+export declare function createImageThumbnail(file: File): Promise<{
+    data: string;
+    mimeType: string;
+} | null>;
+/**
+ * Read supported files (images, audio, video, PDFs, text docs) into base64
+ * {@link ImageAttachment} payloads (the `data:<mime>;base64,` prefix stripped).
+ * Image uploads also get a client-generated thumbnail when large enough.
+ * Unsupported files are skipped; the promise rejects if any read fails so the
+ * caller can surface it rather than silently dropping an attachment. Shared by
+ * the chat composer and the continuous chat overlay.
+ */
+export declare function filesToImageAttachments(files: FileList | File[]): Promise<ImageAttachment[]>;
+//# sourceMappingURL=image-attachment.d.ts.map

package/utils/image-attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-attachment.d.ts","sourceRoot":"","sources":["../../../../../src/utils/image-attachment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,8EAC8C,CAAC;AAE9E,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAWzD;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAM1C;AAuBD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAgCpD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC,CA4B5B"}

package/utils/image-attachment.js

@@ -0,0 +1,124 @@
+/**
+ * Server-side cap (MAX_CHAT_IMAGES) mirrored client-side so the user gets
+ * immediate feedback rather than a 400 after upload. Applies to all attachment
+ * kinds, not just images.
+ */
+export const MAX_CHAT_IMAGES = 4;
+/** `accept` attribute for the chat upload <input> — images, audio, video, PDFs, text docs. */
+export const CHAT_UPLOAD_ACCEPT = "image/*,audio/*,video/*,application/pdf,text/plain,text/csv,text/markdown";
+/** True when a file's MIME type is an attachment kind chat upload accepts. */
+export function isSupportedChatUpload(file) {
+    const mime = file.type.toLowerCase();
+    return (mime.startsWith("image/") ||
+        mime.startsWith("audio/") ||
+        mime.startsWith("video/") ||
+        mime === "application/pdf" ||
+        mime === "text/plain" ||
+        mime === "text/csv" ||
+        mime === "text/markdown");
+}
+/** Map a MIME type to the rendered attachment kind (for preview tiles). */
+export function chatUploadKind(mimeType) {
+    const mime = mimeType.toLowerCase();
+    if (mime.startsWith("image/"))
+        return "image";
+    if (mime.startsWith("audio/"))
+        return "audio";
+    if (mime.startsWith("video/"))
+        return "video";
+    return "document";
+}
+/** Longest edge (px) of a generated thumbnail. */
+const THUMBNAIL_MAX_DIM = 512;
+/** Don't bother thumbnailing images smaller than this — the original is light enough. */
+const THUMBNAIL_MIN_SOURCE_BYTES = 96 * 1024;
+function readFileAsImageElement(file) {
+    return new Promise((resolve, reject) => {
+        const url = URL.createObjectURL(file);
+        const img = new Image();
+        img.onload = () => {
+            URL.revokeObjectURL(url);
+            resolve(img);
+        };
+        img.onerror = () => {
+            URL.revokeObjectURL(url);
+            reject(new Error("Failed to decode image"));
+        };
+        img.src = url;
+    });
+}
+/**
+ * Generate a downscaled JPEG thumbnail for a large image, entirely client-side
+ * via `<canvas>` (works in every browser/desktop/iOS/Android webview — no
+ * native deps). Returns base64 (no data-URL prefix) + mime, or null when the
+ * file isn't a raster image, is already small, or can't be decoded. JPEG +
+ * `<canvas>.toDataURL` is used for universal webview support (WebP/OffscreenCanvas
+ * are not reliable on older WKWebView).
+ */
+export async function createImageThumbnail(file) {
+    const mime = file.type.toLowerCase();
+    if (!mime.startsWith("image/") ||
+        mime === "image/gif" ||
+        mime === "image/svg+xml") {
+        return null;
+    }
+    if (file.size < THUMBNAIL_MIN_SOURCE_BYTES)
+        return null;
+    if (typeof document === "undefined")
+        return null;
+    try {
+        const img = await readFileAsImageElement(file);
+        const longest = Math.max(img.width, img.height);
+        if (!longest)
+            return null;
+        const scale = THUMBNAIL_MAX_DIM / longest;
+        if (scale >= 1)
+            return null; // already within the thumbnail bound
+        const width = Math.max(1, Math.round(img.width * scale));
+        const height = Math.max(1, Math.round(img.height * scale));
+        const canvas = document.createElement("canvas");
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext("2d");
+        if (!ctx)
+            return null;
+        ctx.drawImage(img, 0, 0, width, height);
+        const dataUrl = canvas.toDataURL("image/jpeg", 0.72);
+        const commaIdx = dataUrl.indexOf(",");
+        if (commaIdx < 0 || !dataUrl.startsWith("data:image/"))
+            return null;
+        return { data: dataUrl.slice(commaIdx + 1), mimeType: "image/jpeg" };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read supported files (images, audio, video, PDFs, text docs) into base64
+ * {@link ImageAttachment} payloads (the `data:<mime>;base64,` prefix stripped).
+ * Image uploads also get a client-generated thumbnail when large enough.
+ * Unsupported files are skipped; the promise rejects if any read fails so the
+ * caller can surface it rather than silently dropping an attachment. Shared by
+ * the chat composer and the continuous chat overlay.
+ */
+export function filesToImageAttachments(files) {
+    const supported = Array.from(files).filter(isSupportedChatUpload);
+    return Promise.all(supported.map((file) => new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = async () => {
+            const result = reader.result;
+            const commaIdx = result.indexOf(",");
+            const data = commaIdx >= 0 ? result.slice(commaIdx + 1) : result;
+            const thumbnail = await createImageThumbnail(file).catch(() => null);
+            resolve({
+                data,
+                mimeType: file.type,
+                name: file.name,
+                ...(thumbnail ? { thumbnail } : {}),
+            });
+        };
+        reader.onerror = () => reject(reader.error ?? new Error("Failed to read file"));
+        reader.onabort = () => reject(new Error("File read aborted"));
+        reader.readAsDataURL(file);
+    })));
+}