@elizaos/shared 2.0.0-beta.1 → 2.0.3-beta.3

package/utils/browser-tabs-renderer-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-tabs-renderer-registry.js","sourceRoot":"","sources":["../../src/utils/browser-tabs-renderer-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,MAAM,YAAY,GAAG,iCAA0C,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAotCzC,CAAC;AAQF,MAAM,UAAU,0BAA0B,CACxC,IAAoC;IAEpC,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/utils/documents-upload-image.js

@@ -0,0 +1,147 @@
+export const MAX_DOCUMENT_IMAGE_PROCESSING_BYTES = 5 * 1_048_576;
+const TARGET_DOCUMENT_IMAGE_BYTES = Math.floor(MAX_DOCUMENT_IMAGE_PROCESSING_BYTES * 0.9);
+const IMAGE_OUTPUT_TYPE = "image/jpeg";
+const IMAGE_MAX_DIMENSION = 2560;
+const IMAGE_MIN_DIMENSION = 320;
+const IMAGE_SCALE_STEP = 0.82;
+const IMAGE_QUALITY_STEPS = [0.92, 0.84, 0.76, 0.68, 0.6, 0.52, 0.44];
+const IMAGE_EXTENSIONS = [".png", ".jpg", ".jpeg", ".webp", ".gif"];
+function browserCompressionPlatform() {
+    return {
+        isAvailable: () => typeof document !== "undefined" &&
+            typeof URL !== "undefined" &&
+            typeof URL.createObjectURL === "function" &&
+            typeof Image !== "undefined",
+        loadImageSource: async (file) => {
+            const objectUrl = URL.createObjectURL(file);
+            try {
+                const image = await new Promise((resolve, reject) => {
+                    const nextImage = new Image();
+                    nextImage.onload = () => resolve(nextImage);
+                    nextImage.onerror = () => reject(new Error(`Failed to load image "${file.name}"`));
+                    nextImage.src = objectUrl;
+                });
+                return {
+                    source: image,
+                    width: image.naturalWidth || image.width,
+                    height: image.naturalHeight || image.height,
+                };
+            }
+            finally {
+                URL.revokeObjectURL(objectUrl);
+            }
+        },
+        renderBlob: async ({ source, width, height, outputType, quality }) => {
+            const canvas = document.createElement("canvas");
+            canvas.width = width;
+            canvas.height = height;
+            const context = canvas.getContext("2d");
+            if (!context)
+                throw new Error("Canvas 2D context is unavailable");
+            if (outputType === IMAGE_OUTPUT_TYPE) {
+                context.fillStyle = "#ffffff";
+                context.fillRect(0, 0, width, height);
+            }
+            context.drawImage(source, 0, 0, width, height);
+            return new Promise((resolve, reject) => {
+                canvas.toBlob((blob) => {
+                    if (!blob) {
+                        reject(new Error("Failed to encode optimized image"));
+                        return;
+                    }
+                    resolve(blob);
+                }, outputType, quality);
+            });
+        },
+    };
+}
+function clampDimensions(width, height, maxDimension) {
+    const largestEdge = Math.max(width, height);
+    if (largestEdge <= maxDimension) {
+        return { width, height };
+    }
+    const scale = maxDimension / largestEdge;
+    return {
+        width: Math.max(1, Math.round(width * scale)),
+        height: Math.max(1, Math.round(height * scale)),
+    };
+}
+function cloneUploadFile(file, blob) {
+    const cloned = new File([blob], file.name, {
+        type: blob.type || file.type,
+        lastModified: file.lastModified,
+    });
+    if (typeof file.webkitRelativePath === "string") {
+        Object.defineProperty(cloned, "webkitRelativePath", {
+            value: file.webkitRelativePath,
+            configurable: true,
+        });
+    }
+    return cloned;
+}
+export function isDocumentImageFile(file) {
+    if (file.type.startsWith("image/"))
+        return true;
+    const lowerName = file.name.toLowerCase();
+    return IMAGE_EXTENSIONS.some((extension) => lowerName.endsWith(extension));
+}
+export async function maybeCompressDocumentUploadImage(file, platform = browserCompressionPlatform()) {
+    if (!isDocumentImageFile(file) ||
+        file.size <= MAX_DOCUMENT_IMAGE_PROCESSING_BYTES ||
+        !platform.isAvailable()) {
+        return {
+            file,
+            optimized: false,
+            originalSize: file.size,
+            optimizedSize: file.size,
+        };
+    }
+    const image = await platform.loadImageSource(file);
+    let { width, height } = clampDimensions(image.width, image.height, IMAGE_MAX_DIMENSION);
+    let bestBlob = null;
+    while (true) {
+        for (const quality of IMAGE_QUALITY_STEPS) {
+            const blob = await platform.renderBlob({
+                source: image.source,
+                width,
+                height,
+                outputType: IMAGE_OUTPUT_TYPE,
+                quality,
+            });
+            if (!bestBlob || blob.size < bestBlob.size) {
+                bestBlob = blob;
+            }
+            if (blob.size <= TARGET_DOCUMENT_IMAGE_BYTES) {
+                return {
+                    file: cloneUploadFile(file, blob),
+                    optimized: true,
+                    originalSize: file.size,
+                    optimizedSize: blob.size,
+                };
+            }
+        }
+        const largestEdge = Math.max(width, height);
+        if (largestEdge <= IMAGE_MIN_DIMENSION)
+            break;
+        const nextScale = Math.max(IMAGE_MIN_DIMENSION / largestEdge, IMAGE_SCALE_STEP);
+        if (nextScale >= 1)
+            break;
+        width = Math.max(1, Math.round(width * nextScale));
+        height = Math.max(1, Math.round(height * nextScale));
+    }
+    if (bestBlob && bestBlob.size < file.size) {
+        return {
+            file: cloneUploadFile(file, bestBlob),
+            optimized: true,
+            originalSize: file.size,
+            optimizedSize: bestBlob.size,
+        };
+    }
+    return {
+        file,
+        optimized: false,
+        originalSize: file.size,
+        optimizedSize: file.size,
+    };
+}
+//# sourceMappingURL=documents-upload-image.js.map

package/utils/documents-upload-image.js.map

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

package/utils/env.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Environment variable normalization helpers.
+ *
+ * Consolidates the `normalizeSecret` / `normalizeEnvValue` pattern that was
+ * independently implemented in cloud connection, steward bridge, and wallet
+ * trade helpers.
+ */
+/**
+ * Normalize an env value: trim whitespace, return `undefined` for empty/missing.
+ * Accepts `unknown` so callers don't need to narrow first (useful for config objects).
+ */
+export declare function normalizeEnvValue(value: unknown): string | undefined;
+/**
+ * Same as `normalizeEnvValue` but returns `null` instead of `undefined`.
+ * Convenient when building option objects where `null` means "absent".
+ */
+export declare function normalizeEnvValueOrNull(value: unknown): string | null;
+/**
+ * Returns `true` if a boolean-ish env var is falsy (`"0"`, `"false"`, `"off"`, `"no"`).
+ * Missing or empty values return `false` (i.e. the feature is enabled by default).
+ */
+export declare function isEnvDisabled(value: string | undefined): boolean;
+/**
+ * Sync app brand env vars → elizaOS equivalents.
+ */
+export { syncBrandEnvToEliza, syncElizaEnvToBrand, } from "../config/boot-config.js";
+export declare const DEFAULT_APP_ROUTE_PLUGIN_MODULES: string[];
+export interface SyncElizaEnvAliasOptions {
+    brandedPrefix?: string;
+    cloudManagedAgentsApiSegment?: string;
+    appRoutePluginModules?: readonly string[];
+}
+export declare function syncAppEnvToEliza(): void;
+export declare function syncElizaEnvAliases(options?: SyncElizaEnvAliasOptions): void;
+//# sourceMappingURL=env.d.ts.map

package/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIpE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAErE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIhE;AAED;;GAEG;AACH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AASlC,eAAO,MAAM,gCAAgC,UAS5C,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AA+DD,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,IAAI,CA6B5E"}

package/utils/env.js

@@ -0,0 +1,133 @@
+/**
+ * Environment variable normalization helpers.
+ *
+ * Consolidates the `normalizeSecret` / `normalizeEnvValue` pattern that was
+ * independently implemented in cloud connection, steward bridge, and wallet
+ * trade helpers.
+ */
+/**
+ * Normalize an env value: trim whitespace, return `undefined` for empty/missing.
+ * Accepts `unknown` so callers don't need to narrow first (useful for config objects).
+ */
+export function normalizeEnvValue(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+/**
+ * Same as `normalizeEnvValue` but returns `null` instead of `undefined`.
+ * Convenient when building option objects where `null` means "absent".
+ */
+export function normalizeEnvValueOrNull(value) {
+    return normalizeEnvValue(value) ?? null;
+}
+/**
+ * Returns `true` if a boolean-ish env var is falsy (`"0"`, `"false"`, `"off"`, `"no"`).
+ * Missing or empty values return `false` (i.e. the feature is enabled by default).
+ */
+export function isEnvDisabled(value) {
+    const raw = value?.trim().toLowerCase();
+    if (!raw)
+        return false;
+    return raw === "0" || raw === "false" || raw === "off" || raw === "no";
+}
+/**
+ * Sync app brand env vars → elizaOS equivalents.
+ */
+export { syncBrandEnvToEliza, syncElizaEnvToBrand, } from "../config/boot-config.js";
+import { getBootConfig, syncBrandEnvToEliza, syncElizaEnvToBrand, } from "../config/boot-config.js";
+const DEFAULT_BRANDED_PREFIX = "ELIZA";
+export const DEFAULT_APP_ROUTE_PLUGIN_MODULES = [
+    "@elizaos/plugin-vincent",
+    "@elizaos/plugin-shopify-ui",
+    "@elizaos/plugin-steward-app",
+    "@elizaos/plugin-personal-assistant",
+    "@elizaos/plugin-github",
+    "@elizaos/plugin-computeruse",
+    "@elizaos/plugin-elizacloud",
+    "@elizaos/plugin-workflow",
+];
+function normalizeBrandedPrefix(prefix) {
+    const normalized = String(prefix ?? DEFAULT_BRANDED_PREFIX)
+        .trim()
+        .replace(/[^A-Za-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "")
+        .toUpperCase();
+    if (!normalized) {
+        throw new Error("Branded env prefix must resolve to a non-empty identifier");
+    }
+    return normalized;
+}
+function buildEnvPairs(brandedPrefix) {
+    const prefixed = (suffix) => `${brandedPrefix}_${suffix}`;
+    return [
+        [prefixed("NAMESPACE"), "ELIZA_NAMESPACE"],
+        [prefixed("STATE_DIR"), "ELIZA_STATE_DIR"],
+        [prefixed("CONFIG_PATH"), "ELIZA_CONFIG_PATH"],
+        [prefixed("OAUTH_DIR"), "ELIZA_OAUTH_DIR"],
+        [prefixed("AGENT_ORCHESTRATOR"), "ELIZA_AGENT_ORCHESTRATOR"],
+        [prefixed("CLOUD_PROVISIONED"), "ELIZA_CLOUD_PROVISIONED"],
+        [
+            prefixed("CHAT_GENERATION_TIMEOUT_MS"),
+            "ELIZA_CHAT_GENERATION_TIMEOUT_MS",
+        ],
+        [prefixed("SKIP_LOCAL_PLUGIN_ROLES"), "ELIZA_SKIP_LOCAL_PLUGIN_ROLES"],
+        [prefixed("SETTINGS_DEBUG"), "ELIZA_SETTINGS_DEBUG"],
+        [`VITE_${prefixed("SETTINGS_DEBUG")}`, "VITE_ELIZA_SETTINGS_DEBUG"],
+        [
+            prefixed("GOOGLE_OAUTH_DESKTOP_CLIENT_ID"),
+            "ELIZA_GOOGLE_OAUTH_DESKTOP_CLIENT_ID",
+        ],
+        [prefixed("API_PORT"), "ELIZA_API_PORT"],
+        [prefixed("API_BIND"), "ELIZA_API_BIND"],
+        [prefixed("API_TOKEN"), "ELIZA_API_TOKEN"],
+        [prefixed("ALLOWED_ORIGINS"), "ELIZA_ALLOWED_ORIGINS"],
+        [prefixed("ALLOWED_HOSTS"), "ELIZA_ALLOWED_HOSTS"],
+        [prefixed("ALLOW_NULL_ORIGIN"), "ELIZA_ALLOW_NULL_ORIGIN"],
+        [prefixed("DISABLE_AUTO_API_TOKEN"), "ELIZA_DISABLE_AUTO_API_TOKEN"],
+        [prefixed("HOME_PORT"), "ELIZA_HOME_PORT"],
+        [prefixed("GATEWAY_PORT"), "ELIZA_GATEWAY_PORT"],
+        [prefixed("API_BASE"), "ELIZA_API_BASE"],
+        [prefixed("API_BASE_URL"), "ELIZA_API_BASE_URL"],
+        [prefixed("DESKTOP_API_BASE"), "ELIZA_DESKTOP_API_BASE"],
+        [prefixed("DESKTOP_TEST_API_BASE"), "ELIZA_DESKTOP_TEST_API_BASE"],
+        [
+            prefixed("DESKTOP_SKIP_EMBEDDED_AGENT"),
+            "ELIZA_DESKTOP_SKIP_EMBEDDED_AGENT",
+        ],
+        [prefixed("RENDERER_URL"), "ELIZA_RENDERER_URL"],
+        [prefixed("APP_ROUTE_PLUGIN_MODULES"), "ELIZA_APP_ROUTE_PLUGIN_MODULES"],
+        [prefixed("PORT"), "ELIZA_UI_PORT"],
+    ];
+}
+export function syncAppEnvToEliza() {
+    const aliases = getBootConfig().envAliases;
+    if (aliases)
+        syncBrandEnvToEliza(aliases);
+}
+export function syncElizaEnvAliases(options) {
+    if (options) {
+        const env = globalThis.process?.env;
+        if (!env)
+            return;
+        const brandedPrefix = normalizeBrandedPrefix(options.brandedPrefix);
+        for (const [from, to] of buildEnvPairs(brandedPrefix)) {
+            if (env[to] === undefined && env[from] !== undefined) {
+                env[to] = env[from];
+            }
+        }
+        if (!env.ELIZA_CLOUD_MANAGED_AGENTS_API_SEGMENT) {
+            env.ELIZA_CLOUD_MANAGED_AGENTS_API_SEGMENT =
+                options.cloudManagedAgentsApiSegment ?? "eliza";
+        }
+        if (!env.ELIZA_APP_ROUTE_PLUGIN_MODULES) {
+            env.ELIZA_APP_ROUTE_PLUGIN_MODULES = (options.appRoutePluginModules ?? DEFAULT_APP_ROUTE_PLUGIN_MODULES).join(",");
+        }
+        return;
+    }
+    const aliases = getBootConfig().envAliases;
+    if (aliases)
+        syncElizaEnvToBrand(aliases);
+}
+//# sourceMappingURL=env.js.map

package/utils/env.js.map

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

package/utils/errors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared error classification helpers.
+ *
+ * Consolidates the timeout detection pattern that was independently
+ * implemented in cloud-routes.ts and cloud-connection.ts.
+ */
+import { formatError } from "@elizaos/core";
+/** 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 const errorMessage: typeof formatError;
+//# sourceMappingURL=errors.d.ts.map

package/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,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,eAAO,MAAM,YAAY,oBAAc,CAAC"}

package/utils/errors.js

@@ -0,0 +1,23 @@
+/**
+ * Shared error classification helpers.
+ *
+ * Consolidates the timeout detection pattern that was independently
+ * implemented in cloud-routes.ts and cloud-connection.ts.
+ */
+import { formatError } from "@elizaos/core";
+/** 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 const errorMessage = formatError;
+//# sourceMappingURL=errors.js.map

package/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAC9E,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,OAAO,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;AACzD,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC"}

package/utils/exec-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-safety.d.ts","sourceRoot":"","sources":["../../src/utils/exec-safety.ts"],"names":[],"mappings":"AAcA,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,OAAO,CAQT"}

package/utils/exec-safety.js

@@ -0,0 +1,25 @@
+const UNSAFE_CHARS = /[\0\r\n;&|`$<>"']/;
+const BARE_NAME = /^[A-Za-z0-9._+-]+$/;
+const PATH_WITH_ARGS = /\s+(?:-{1,2}\S+|[A-Za-z0-9._+-]+)(?:\s|$)/;
+function isLikelyPath(value) {
+    return (value.startsWith(".") ||
+        value.startsWith("~") ||
+        value.includes("/") ||
+        value.includes("\\") ||
+        /^[A-Za-z]:[\\/]/.test(value));
+}
+export function isSafeExecutableValue(value) {
+    const trimmed = value?.trim();
+    if (!trimmed)
+        return false;
+    if (UNSAFE_CHARS.test(trimmed))
+        return false;
+    if (PATH_WITH_ARGS.test(trimmed))
+        return false;
+    if (isLikelyPath(trimmed))
+        return true;
+    if (trimmed.startsWith("-"))
+        return false;
+    return BARE_NAME.test(trimmed);
+}
+//# sourceMappingURL=exec-safety.js.map

package/utils/exec-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-safety.js","sourceRoot":"","sources":["../../src/utils/exec-safety.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,mBAAmB,CAAC;AACzC,MAAM,SAAS,GAAG,oBAAoB,CAAC;AACvC,MAAM,cAAc,GAAG,2CAA2C,CAAC;AAEnE,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAgC;IAEhC,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,YAAY,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/utils/format.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Shared formatting helpers for Eliza app views.
+ */
+/**
+ * Format an uptime duration in seconds into a compact human string.
+ *
+ * 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;
+    /**
+     * Uniform precision applied to all of KB / MB / GB / TB. Individual
+     * per-unit overrides below take precedence when supplied.
+     */
+    precision?: number;
+    /**
+     * 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 | null | undefined, options?: ByteSizeFormatterOptions): string;
+type UsdFormatOptions = {
+    /**
+     * Fallback string for null / undefined / non-numeric input.
+     */
+    fallback?: string;
+};
+/**
+ * Format a numeric amount as a USD currency string (`$1,234.56`).
+ *
+ * Accepts numbers or numeric strings; non-numeric input yields `fallback`.
+ * Uses the en-US `Intl.NumberFormat` currency style (grouped, 2 fraction
+ * digits) — the canonical money display for dashboard views.
+ */
+export declare function formatUsd(value: number | string | null | undefined, options?: UsdFormatOptions): 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.
+ */
+export declare function formatDurationMs(ms?: number | null, options?: DurationFormatOptions): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

package/utils/format.d.ts.map

@@ -0,0 +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;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;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,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,GAAE,wBAA6B,GACrC,MAAM,CA0BR;AAED,KAAK,gBAAgB,GAAG;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAQR;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"}

package/utils/format.js

@@ -0,0 +1,140 @@
+/**
+ * Shared formatting helpers for Eliza app views.
+ */
+/**
+ * Format an uptime duration in seconds into a compact human string.
+ *
+ * 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", precision, kbPrecision = precision ?? 1, mbPrecision = precision ?? 1, gbPrecision = precision ?? 1, tbPrecision = precision ?? 1, } = options;
+    if (bytes == null || !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 a numeric amount as a USD currency string (`$1,234.56`).
+ *
+ * Accepts numbers or numeric strings; non-numeric input yields `fallback`.
+ * Uses the en-US `Intl.NumberFormat` currency style (grouped, 2 fraction
+ * digits) — the canonical money display for dashboard views.
+ */
+export function formatUsd(value, options = {}) {
+    const { fallback = "—" } = options;
+    const amount = typeof value === "string" ? Number.parseFloat(value) : value;
+    if (amount == null || !Number.isFinite(amount))
+        return fallback;
+    return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: "USD",
+    }).format(amount);
+}
+/**
+ * Format timestamp / date for locale display (`toLocaleString`).
+ */
+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`;
+}
+//# sourceMappingURL=format.js.map