@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/utils/environment.js

@@ -0,0 +1,290 @@
+import { parseBooleanValue } from "./boolean.js";
+/**
+ * Detect the current runtime environment
+ */
+export function detectEnvironment() {
+    // Check for Node.js
+    if (typeof process !== "undefined" &&
+        process.versions &&
+        process.versions.node) {
+        return "node";
+    }
+    // Check for browser
+    if (typeof globalThis !== "undefined" &&
+        typeof globalThis.window !== "undefined" &&
+        typeof globalThis.document !== "undefined") {
+        return "browser";
+    }
+    return "unknown";
+}
+/**
+ * Environment variable storage for browser environments
+ */
+class BrowserEnvironmentStore {
+    store = {};
+    constructor() {
+        // Load from window.ENV if available (common pattern for browser apps)
+        const globalWindow = globalThis.window;
+        if (globalWindow?.ENV) {
+            this.store = { ...globalWindow.ENV };
+        }
+        // Also check for __ENV__ (another common pattern)
+        const globalEnv = globalThis.__ENV__;
+        if (globalEnv) {
+            this.store = { ...this.store, ...globalEnv };
+        }
+    }
+    get(key) {
+        const value = this.store[key];
+        return value !== undefined ? String(value) : undefined;
+    }
+    set(key, value) {
+        this.store[key] = value;
+    }
+    has(key) {
+        return key in this.store;
+    }
+    getAll() {
+        return { ...this.store };
+    }
+}
+/**
+ * Environment abstraction class
+ */
+class Environment {
+    runtime;
+    browserStore = null;
+    cache = new Map();
+    constructor() {
+        this.runtime = detectEnvironment();
+        if (this.runtime === "browser") {
+            this.browserStore = new BrowserEnvironmentStore();
+        }
+    }
+    /**
+     * Get the current runtime environment
+     */
+    getRuntime() {
+        return this.runtime;
+    }
+    /**
+     * Check if running in Node.js
+     */
+    isNode() {
+        return this.runtime === "node";
+    }
+    /**
+     * Check if running in browser
+     */
+    isBrowser() {
+        return this.runtime === "browser";
+    }
+    /**
+     * Get an environment variable
+     */
+    get(key, defaultValue) {
+        // Check cache first
+        if (this.cache.has(key)) {
+            const cached = this.cache.get(key);
+            return cached ?? defaultValue;
+        }
+        let value;
+        if (this.runtime === "node") {
+            value = process.env[key];
+        }
+        else if (this.browserStore) {
+            value = this.browserStore.get(key);
+        }
+        // Cache the result
+        this.cache.set(key, value);
+        return value ?? defaultValue;
+    }
+    /**
+     * Set an environment variable (mainly for browser/testing)
+     */
+    set(key, value) {
+        const stringValue = String(value);
+        // Clear cache
+        this.cache.delete(key);
+        if (this.runtime === "node") {
+            process.env[key] = stringValue;
+        }
+        else if (this.browserStore) {
+            this.browserStore.set(key, value);
+        }
+    }
+    /**
+     * Check if an environment variable exists
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Get all environment variables
+     */
+    getAll() {
+        if (this.runtime === "node") {
+            return { ...process.env };
+        }
+        if (this.browserStore) {
+            return this.browserStore.getAll();
+        }
+        return {};
+    }
+    /**
+     * Get a boolean environment variable
+     */
+    getBoolean(key, defaultValue = false) {
+        const value = this.get(key);
+        return parseBooleanValue(value) ?? defaultValue;
+    }
+    /**
+     * Get a number environment variable
+     */
+    getNumber(key, defaultValue) {
+        const value = this.get(key);
+        if (value === undefined) {
+            return defaultValue;
+        }
+        const parsed = Number(value);
+        return Number.isNaN(parsed) ? defaultValue : parsed;
+    }
+    /**
+     * Clear the cache (useful for testing)
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+/**
+ * Singleton instance of the Environment class
+ */
+let environmentInstance = null;
+/**
+ * Get the singleton Environment instance
+ */
+export function getEnvironment() {
+    if (!environmentInstance) {
+        environmentInstance = new Environment();
+    }
+    return environmentInstance;
+}
+/**
+ * Convenience function to get an environment variable
+ */
+export function getEnv(key, defaultValue) {
+    return getEnvironment().get(key, defaultValue);
+}
+/**
+ * Convenience function to set an environment variable
+ */
+export function setEnv(key, value) {
+    getEnvironment().set(key, value);
+}
+/**
+ * Convenience function to check if an environment variable exists
+ */
+export function hasEnv(key) {
+    return getEnvironment().has(key);
+}
+/**
+ * Convenience function to get a boolean environment variable
+ */
+export function getBooleanEnv(key, defaultValue = false) {
+    return getEnvironment().getBoolean(key, defaultValue);
+}
+/**
+ * Convenience function to get a number environment variable
+ */
+export function getNumberEnv(key, defaultValue) {
+    return getEnvironment().getNumber(key, defaultValue);
+}
+/**
+ * Initialize browser environment with config
+ * This should be called early in browser apps to set up environment
+ */
+export function initBrowserEnvironment(config) {
+    const env = getEnvironment();
+    if (env.isBrowser()) {
+        for (const [key, value] of Object.entries(config)) {
+            if (value !== undefined) {
+                env.set(key, value);
+            }
+        }
+    }
+}
+/**
+ * Export the current runtime for convenience
+ */
+export const currentRuntime = detectEnvironment();
+/**
+ * Re-export the Environment class for advanced usage
+ */
+export { Environment };
+// ============================================================================
+// .env File Loading (Node.js only)
+// ============================================================================
+/**
+ * Find the .env file by traversing up the directory tree
+ * Searches from startDir upwards until it finds a .env file or reaches the root
+ *
+ * @param startDir - Directory to start searching from (defaults to process.cwd())
+ * @param filenames - Array of filenames to search for (defaults to ['.env', '.env.local'])
+ * @returns Path to the .env file if found, null otherwise
+ */
+export function findEnvFile(startDir, filenames = [".env", ".env.local"]) {
+    if (typeof process === "undefined" || !process.cwd) {
+        return null;
+    }
+    const moduleBuiltin = process.getBuiltinModule?.("module");
+    const nodeRequire = moduleBuiltin?.createRequire?.(import.meta.url);
+    if (!nodeRequire) {
+        return null;
+    }
+    const fs = nodeRequire("node:fs");
+    const path = nodeRequire("node:path");
+    let currentDir = startDir || process.cwd();
+    while (true) {
+        for (const filename of filenames) {
+            const candidate = path.join(currentDir, filename);
+            if (fs.existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            break;
+        }
+        currentDir = parentDir;
+    }
+    return null;
+}
+/**
+ * Load environment variables from .env file into process.env
+ *
+ * Node.js only - does nothing in browser environments
+ *
+ * @param envPath - Optional explicit path to .env file. If not provided, will search upwards from cwd
+ * @returns true if .env was found and loaded successfully
+ * @throws Error if the .env file exists but cannot be parsed
+ */
+export function loadEnvFile(envPath) {
+    if (typeof process === "undefined" || !process.cwd) {
+        return false;
+    }
+    const moduleBuiltin = process.getBuiltinModule?.("module");
+    const nodeRequire = moduleBuiltin?.createRequire?.(import.meta.url);
+    if (!nodeRequire) {
+        return false;
+    }
+    const dotenv = nodeRequire("dotenv");
+    const resolvedPath = envPath || findEnvFile();
+    if (!resolvedPath) {
+        return false;
+    }
+    const result = dotenv.config({ path: resolvedPath });
+    if (result.error) {
+        throw new Error(`Failed to parse .env file at ${resolvedPath}: ${result.error.message}`);
+    }
+    return true;
+}

package/packages/typescript/src/utils/example-names.d.ts

@@ -0,0 +1,3 @@
+export declare const EXAMPLE_NAMES: readonly ["Avery", "Blake", "Casey", "Cleo", "Drew", "Emery", "Finley", "Harper", "Indigo", "Jules", "Kai", "Lane", "Logan", "Morgan", "Nova", "Parker", "Quinn", "Reese", "River", "Rowan", "Sage", "Skyler", "Taylor", "Wren"];
+export declare function pickRandomExampleName(index?: number): string;
+//# sourceMappingURL=example-names.d.ts.map

package/packages/typescript/src/utils/example-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-names.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/example-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,kOAyBhB,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,KAAK,SAAI,GAAG,MAAM,CAKvD"}

package/packages/typescript/src/utils/example-names.js

@@ -0,0 +1,30 @@
+export const EXAMPLE_NAMES = [
+    "Avery",
+    "Blake",
+    "Casey",
+    "Cleo",
+    "Drew",
+    "Emery",
+    "Finley",
+    "Harper",
+    "Indigo",
+    "Jules",
+    "Kai",
+    "Lane",
+    "Logan",
+    "Morgan",
+    "Nova",
+    "Parker",
+    "Quinn",
+    "Reese",
+    "River",
+    "Rowan",
+    "Sage",
+    "Skyler",
+    "Taylor",
+    "Wren",
+];
+export function pickRandomExampleName(index = 0) {
+    const offset = Math.floor(Math.random() * EXAMPLE_NAMES.length);
+    return (EXAMPLE_NAMES[(offset + index) % EXAMPLE_NAMES.length] ?? `user${index + 1}`);
+}

package/packages/typescript/src/utils/json-llm.d.ts

@@ -0,0 +1,17 @@
+/**
+ * JSON parsing helpers for LLM output.
+ *
+ * WHY: Model output commonly includes trailing commas, single quotes, unquoted
+ * keys, or fenced code blocks. Keep the tolerant extraction/parsing path in a
+ * dedicated helper so callers parsing LLM text do not each reinvent it.
+ */
+/**
+ * Extract and parse JSON from text using JSON5 for LLM output tolerance.
+ * Throws on parse failure for invalid JSON.
+ *
+ * @param text - The input text containing JSON
+ * @returns Parsed object/array
+ * @throws {Error} If the JSON is invalid or parsing fails
+ */
+export declare function extractAndParseJSONObjectFromText(text: string): Record<string, unknown> | unknown[];
+//# sourceMappingURL=json-llm.d.ts.map

package/packages/typescript/src/utils/json-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-llm.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/json-llm.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAChD,IAAI,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAerC"}

package/packages/typescript/src/utils/json-llm.js

@@ -0,0 +1,32 @@
+/**
+ * JSON parsing helpers for LLM output.
+ *
+ * WHY: Model output commonly includes trailing commas, single quotes, unquoted
+ * keys, or fenced code blocks. Keep the tolerant extraction/parsing path in a
+ * dedicated helper so callers parsing LLM text do not each reinvent it.
+ */
+import JSON5 from "json5";
+const jsonBlockPattern = /```(?:json|json5)?\s*\r?\n?([\s\S]*?)\r?\n?```/i;
+/**
+ * Extract and parse JSON from text using JSON5 for LLM output tolerance.
+ * Throws on parse failure for invalid JSON.
+ *
+ * @param text - The input text containing JSON
+ * @returns Parsed object/array
+ * @throws {Error} If the JSON is invalid or parsing fails
+ */
+export function extractAndParseJSONObjectFromText(text) {
+    if (!text || typeof text !== "string") {
+        throw new Error("Invalid input: text must be a non-empty string");
+    }
+    // First try to extract JSON from code blocks if present
+    const match = text.match(jsonBlockPattern);
+    const textToParse = match ? match[1].trim() : text.trim();
+    // Use JSON5.parse directly - it already handles unquoted keys, single quotes, trailing commas
+    try {
+        return JSON5.parse(textToParse);
+    }
+    catch {
+        throw new Error("Failed to parse invalid JSON");
+    }
+}

package/packages/typescript/src/utils/model-errors.d.ts

@@ -0,0 +1,3 @@
+export declare function getErrorMessage(error: unknown): string;
+export declare function isTransientModelError(error: unknown): boolean;
+//# sourceMappingURL=model-errors.d.ts.map

package/packages/typescript/src/utils/model-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-errors.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/model-errors.ts"],"names":[],"mappings":"AAiBA,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK7D"}

package/packages/typescript/src/utils/model-errors.js

@@ -0,0 +1,23 @@
+const TRANSIENT_MODEL_ERROR_PATTERNS = [
+    "service temporarily unavailable",
+    "temporarily unavailable",
+    "rate limit",
+    "too many requests",
+    "overloaded",
+    "socket connection was closed unexpectedly",
+    "econnreset",
+    "econnrefused",
+    "etimedout",
+    "timeout",
+    "timed out",
+    "503",
+    "502",
+    "504",
+];
+export function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function isTransientModelError(error) {
+    const message = getErrorMessage(error).toLowerCase();
+    return TRANSIENT_MODEL_ERROR_PATTERNS.some((pattern) => message.includes(pattern));
+}

package/packages/typescript/src/utils/node.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Node.js-specific utilities that should not be imported in browser environments
+ * Import directly from ./paths and ./server-health
+ */
+export declare function getLocalServerUrl(path: string): string;
+export * from "./paths";
+export * from "./server-health";
+//# sourceMappingURL=node.d.ts.map

package/packages/typescript/src/utils/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAGD,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/packages/typescript/src/utils/node.js

@@ -0,0 +1,12 @@
+/**
+ * Node.js-specific utilities that should not be imported in browser environments
+ * Import directly from ./paths and ./server-health
+ */
+import { getEnv } from "./environment";
+export function getLocalServerUrl(path) {
+    const port = getEnv("SERVER_PORT", "3000");
+    return `http://localhost:${port}${path}`;
+}
+// Re-export Node-specific utilities
+export * from "./paths";
+export * from "./server-health";

package/packages/typescript/src/utils/paths.d.ts

@@ -0,0 +1,97 @@
+/**
+ * elizaOS data directory paths configuration
+ * This module provides a standard interface for accessing data directory paths
+ * that can be customized via environment variables.
+ */
+/**
+ * Interface for elizaOS paths configuration
+ */
+export interface ElizaPathsConfig {
+    dataDir: string;
+    databaseDir: string;
+    charactersDir: string;
+    generatedDir: string;
+    uploadsAgentsDir: string;
+    uploadsChannelsDir: string;
+}
+/**
+ * elizaOS paths management class
+ * Provides centralized access to all elizaOS data directory paths
+ */
+declare class ElizaPaths {
+    private cache;
+    /**
+     * Get the base data directory
+     */
+    getDataDir(): string;
+    /**
+     * Get the database directory (backward compatible with PGLITE_DATA_DIR)
+     */
+    getDatabaseDir(): string;
+    /**
+     * Get the characters storage directory
+     */
+    getCharactersDir(): string;
+    /**
+     * Get the AI-generated content directory
+     */
+    getGeneratedDir(): string;
+    /**
+     * Get the agent uploads directory
+     */
+    getUploadsAgentsDir(): string;
+    /**
+     * Get the channel uploads directory
+     */
+    getUploadsChannelsDir(): string;
+    /**
+     * Get all paths as a configuration object
+     */
+    getAllPaths(): ElizaPathsConfig;
+    /**
+     * Clear the cache (useful for testing)
+     */
+    clearCache(): void;
+    /**
+     * Get a path by config key, using cache
+     */
+    private getPath;
+}
+/**
+ * Get the singleton ElizaPaths instance
+ */
+export declare function getElizaPaths(): ElizaPaths;
+/**
+ * Convenience function to get the data directory
+ */
+export declare function getDataDir(): string;
+/**
+ * Convenience function to get the database directory
+ */
+export declare function getDatabaseDir(): string;
+/**
+ * Convenience function to get the characters directory
+ */
+export declare function getCharactersDir(): string;
+/**
+ * Convenience function to get the generated content directory
+ */
+export declare function getGeneratedDir(): string;
+/**
+ * Convenience function to get the agent uploads directory
+ */
+export declare function getUploadsAgentsDir(): string;
+/**
+ * Convenience function to get the channel uploads directory
+ */
+export declare function getUploadsChannelsDir(): string;
+/**
+ * Convenience function to get all paths
+ */
+export declare function getAllElizaPaths(): ElizaPathsConfig;
+/**
+ * Reset the singleton instance (mainly for testing)
+ */
+export declare function resetPaths(): void;
+export {};
+//# sourceMappingURL=paths.d.ts.map

package/packages/typescript/src/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../../../typescript/src/utils/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAuCD;;;GAGG;AACH,cAAM,UAAU;IACf,OAAO,CAAC,KAAK,CAA6B;IAE1C;;OAEG;IACH,UAAU,IAAI,MAAM;IASpB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,WAAW,IAAI,gBAAgB;IAW/B;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,CAAC,OAAO;CAgBf;AAOD;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAK1C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAKjC"}