@elizaos/core 2.0.0-alpha.52 → 2.0.0-alpha.53

package/dist/utils/channel-utils.d.ts

@@ -0,0 +1,274 @@
+/**
+ * Channel Utilities for elizaOS
+ *
+ * Generic cross-platform utilities for messaging channels.
+ * These utilities are platform-agnostic and can be used by any channel plugin.
+ *
+ * @module utils/channel-utils
+ */
+/**
+ * Normalized chat type - the canonical representation of chat types across platforms.
+ */
+export type NormalizedChatType = "direct" | "group" | "channel";
+/**
+ * Normalize a raw chat type string to a canonical form.
+ * Handles various platform-specific naming conventions.
+ *
+ * @param raw - The raw chat type string from the platform
+ * @returns Normalized chat type
+ */
+export declare function normalizeChatType(raw?: string): NormalizedChatType;
+/**
+ * Parameters for resolving mention gating.
+ */
+export type MentionGateParams = {
+    /** Whether the agent requires an @mention to respond */
+    requireMention: boolean;
+    /** Whether the platform can detect mentions */
+    canDetectMention: boolean;
+    /** Whether the agent was explicitly mentioned */
+    wasMentioned: boolean;
+    /** Whether there's an implicit mention (e.g., reply to agent) */
+    implicitMention?: boolean;
+    /** Whether to bypass mention requirements */
+    shouldBypassMention?: boolean;
+};
+/**
+ * Result of mention gating resolution.
+ */
+export type MentionGateResult = {
+    /** Whether the agent should consider itself mentioned */
+    effectiveWasMentioned: boolean;
+    /** Whether to skip processing this message */
+    shouldSkip: boolean;
+};
+/**
+ * Extended parameters for mention gating with bypass logic.
+ */
+export type MentionGateWithBypassParams = {
+    isGroup: boolean;
+    requireMention: boolean;
+    canDetectMention: boolean;
+    wasMentioned: boolean;
+    implicitMention?: boolean;
+    hasAnyMention?: boolean;
+    allowTextCommands: boolean;
+    hasControlCommand: boolean;
+    commandAuthorized: boolean;
+};
+/**
+ * Extended result with bypass information.
+ */
+export type MentionGateWithBypassResult = MentionGateResult & {
+    shouldBypassMention: boolean;
+};
+/**
+ * Resolve whether to process a message based on mention requirements.
+ *
+ * @param params - Mention gating parameters
+ * @returns Gating result indicating if message should be processed
+ */
+export declare function resolveMentionGating(params: MentionGateParams): MentionGateResult;
+/**
+ * Resolve mention gating with command bypass logic.
+ * Allows authorized control commands to bypass mention requirements.
+ *
+ * @param params - Extended mention gating parameters
+ * @returns Extended gating result with bypass information
+ */
+export declare function resolveMentionGatingWithBypass(params: MentionGateWithBypassParams): MentionGateWithBypassResult;
+/**
+ * Callbacks for managing typing indicators.
+ */
+export type TypingCallbacks = {
+    /** Called when a reply starts (show typing indicator) */
+    onReplyStart: () => Promise<void>;
+    /** Called when idle (hide typing indicator) */
+    onIdle?: () => void;
+};
+/**
+ * Parameters for creating typing callbacks.
+ */
+export type TypingCallbackParams = {
+    /** Function to start typing indicator */
+    start: () => Promise<void>;
+    /** Function to stop typing indicator */
+    stop?: () => Promise<void>;
+    /** Error handler for start failures */
+    onStartError: (err: unknown) => void;
+    /** Error handler for stop failures */
+    onStopError?: (err: unknown) => void;
+};
+/**
+ * Create typing indicator callbacks with error handling.
+ *
+ * @param params - Typing callback parameters
+ * @returns Callbacks for managing typing state
+ */
+export declare function createTypingCallbacks(params: TypingCallbackParams): TypingCallbacks;
+/**
+ * Scope for acknowledgment reactions (e.g., "👀" seen indicators).
+ */
+export type AckReactionScope = "all" | "direct" | "group-all" | "group-mentions" | "off" | "none";
+/**
+ * WhatsApp-specific acknowledgment reaction mode.
+ */
+export type WhatsAppAckReactionMode = "always" | "mentions" | "never";
+/**
+ * Parameters for determining if an ack reaction should be sent.
+ */
+export type AckReactionGateParams = {
+    scope: AckReactionScope | undefined;
+    isDirect: boolean;
+    isGroup: boolean;
+    isMentionableGroup: boolean;
+    requireMention: boolean;
+    canDetectMention: boolean;
+    effectiveWasMentioned: boolean;
+    shouldBypassMention?: boolean;
+};
+/**
+ * Determine if an acknowledgment reaction should be sent.
+ *
+ * @param params - Ack reaction parameters
+ * @returns Whether to send the ack reaction
+ */
+export declare function shouldAckReaction(params: AckReactionGateParams): boolean;
+/**
+ * WhatsApp-specific ack reaction logic.
+ *
+ * @param params - WhatsApp ack reaction parameters
+ * @returns Whether to send the ack reaction
+ */
+export declare function shouldAckReactionForWhatsApp(params: {
+    emoji: string;
+    isDirect: boolean;
+    isGroup: boolean;
+    directEnabled: boolean;
+    groupMode: WhatsAppAckReactionMode;
+    wasMentioned: boolean;
+    groupActivated: boolean;
+}): boolean;
+/**
+ * Parameters for removing ack reaction after reply.
+ */
+export type RemoveAckReactionParams = {
+    removeAfterReply: boolean;
+    ackReactionPromise: Promise<boolean> | null;
+    ackReactionValue: string | null;
+    remove: () => Promise<void>;
+    onError?: (err: unknown) => void;
+};
+/**
+ * Remove acknowledgment reaction after reply is sent.
+ *
+ * @param params - Parameters for removal
+ */
+export declare function removeAckReactionAfterReply(params: RemoveAckReactionParams): void;
+/**
+ * Parameters for resolving a sender's display label.
+ */
+export type SenderLabelParams = {
+    name?: string;
+    username?: string;
+    tag?: string;
+    e164?: string;
+    id?: string;
+};
+/**
+ * Resolve a display label for a message sender.
+ * Prefers name, then username, then tag, with ID appended if different.
+ *
+ * @param params - Sender identification parameters
+ * @returns Display label or null if no information available
+ */
+export declare function resolveSenderLabel(params: SenderLabelParams): string | null;
+/**
+ * List all possible sender label candidates.
+ *
+ * @param params - Sender identification parameters
+ * @returns Array of possible labels
+ */
+export declare function listSenderLabelCandidates(params: SenderLabelParams): string[];
+/**
+ * Source type for location data.
+ */
+export type LocationSource = "pin" | "place" | "live";
+/**
+ * Normalized location data structure.
+ */
+export type NormalizedLocation = {
+    latitude: number;
+    longitude: number;
+    accuracy?: number;
+    name?: string;
+    address?: string;
+    isLive?: boolean;
+    source?: LocationSource;
+    caption?: string;
+};
+/**
+ * Format a location as human-readable text with emoji indicators.
+ *
+ * @param location - Normalized location data
+ * @returns Formatted location string
+ */
+export declare function formatLocationText(location: NormalizedLocation): string;
+/**
+ * Location context fields for message processing.
+ */
+export type LocationContext = {
+    LocationLat: number;
+    LocationLon: number;
+    LocationAccuracy?: number;
+    LocationName?: string;
+    LocationAddress?: string;
+    LocationSource: LocationSource;
+    LocationIsLive: boolean;
+};
+/**
+ * Convert a normalized location to context fields.
+ *
+ * @param location - Normalized location data
+ * @returns Location context fields
+ */
+export declare function toLocationContext(location: NormalizedLocation): LocationContext;
+/**
+ * Log function signature.
+ */
+export type LogFn = (message: string) => void;
+/**
+ * Log when an inbound message is dropped.
+ *
+ * @param params - Log parameters
+ */
+export declare function logInboundDrop(params: {
+    log: LogFn;
+    channel: string;
+    reason: string;
+    target?: string;
+}): void;
+/**
+ * Log a typing indicator failure.
+ *
+ * @param params - Log parameters
+ */
+export declare function logTypingFailure(params: {
+    log: LogFn;
+    channel: string;
+    target?: string;
+    action?: "start" | "stop";
+    error: unknown;
+}): void;
+/**
+ * Log an acknowledgment cleanup failure.
+ *
+ * @param params - Log parameters
+ */
+export declare function logAckFailure(params: {
+    log: LogFn;
+    channel: string;
+    target?: string;
+    error: unknown;
+}): void;
+//# sourceMappingURL=channel-utils.d.ts.map

package/dist/utils/channel-utils.d.ts.map

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

package/dist/utils/crypto-compat.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Browser and Node.js compatible crypto abstraction
+ * Provides cross-platform interface for cryptographic operations
+ *
+ * @module crypto-compat
+ *
+ * This module provides both synchronous (Node.js only) and asynchronous (cross-platform)
+ * APIs for cryptographic operations. Use async methods for browser compatibility.
+ *
+ * @example
+ * ```typescript
+ * // Node.js synchronous API
+ * const hash = createHash('sha256').update('data').digest();
+ *
+ * // Cross-platform async API
+ * const hash = await createHashAsync('sha256', 'data');
+ * ```
+ */
+/**
+ * Create a hash object for incremental hashing (cross-platform - synchronous)
+ *
+ * This function works in both Node.js and browser environments. In browsers, it uses
+ * crypto-browserify to provide synchronous hashing compatible with Node.js crypto API.
+ *
+ * @param algorithm - Hash algorithm ('sha256', 'sha1', 'sha512')
+ * @returns Hash object with update() and digest() methods
+ */
+export declare function createHash(algorithm: string): {
+    update(data: string | Uint8Array): ReturnType<typeof createHash>;
+    digest(): Uint8Array;
+};
+/**
+ * Create a hash asynchronously (works in both Node.js and browser)
+ *
+ * This is the recommended method for cross-platform code.
+ *
+ * @param algorithm - Hash algorithm ('sha256', 'sha1', 'sha512')
+ * @param data - Data to hash
+ * @returns Hash result
+ */
+export declare function createHashAsync(algorithm: string, data: string | Uint8Array): Promise<Uint8Array>;
+/**
+ * Create a cipher for encryption (cross-platform - synchronous)
+ *
+ * @param algorithm - Cipher algorithm (only 'aes-256-cbc' is supported)
+ * @param key - 256-bit (32-byte) encryption key
+ * @param iv - 128-bit (16-byte) initialization vector
+ * @returns Cipher object with update() and final() methods
+ */
+export declare function createCipheriv(algorithm: string, key: Uint8Array, iv: Uint8Array): {
+    update(data: string, inputEncoding: string, outputEncoding: string): string;
+    final(encoding: string): string;
+};
+/**
+ * Create a decipher for decryption (cross-platform - synchronous)
+ *
+ * @param algorithm - Cipher algorithm (only 'aes-256-cbc' is supported)
+ * @param key - 256-bit (32-byte) decryption key
+ * @param iv - 128-bit (16-byte) initialization vector
+ * @returns Decipher object with update() and final() methods
+ */
+export declare function createDecipheriv(algorithm: string, key: Uint8Array, iv: Uint8Array): {
+    update(data: string, inputEncoding: string, outputEncoding: string): string;
+    final(encoding: string): string;
+};
+/**
+ * Encrypt data asynchronously (works in both Node.js and browser)
+ *
+ * This is the recommended method for cross-platform code using AES-256-CBC.
+ *
+ * @param key - 256-bit (32-byte) encryption key
+ * @param iv - 128-bit (16-byte) initialization vector
+ * @param data - Data to encrypt
+ * @returns Encrypted data
+ */
+export declare function encryptAsync(key: Uint8Array, iv: Uint8Array, data: Uint8Array): Promise<Uint8Array>;
+/**
+ * Decrypt data asynchronously (works in both Node.js and browser)
+ *
+ * This is the recommended method for cross-platform code using AES-256-CBC.
+ *
+ * @param key - 256-bit (32-byte) decryption key
+ * @param iv - 128-bit (16-byte) initialization vector
+ * @param data - Data to decrypt
+ * @returns Decrypted data
+ */
+export declare function decryptAsync(key: Uint8Array, iv: Uint8Array, data: Uint8Array): Promise<Uint8Array>;
+/**
+ * Encrypt using AES-256-GCM (synchronous; Node.js or crypto-browserify).
+ *
+ * This is used for cross-language secret encryption with integrity protection.
+ */
+export declare function encryptAes256Gcm(key: Uint8Array, iv: Uint8Array, plaintext: Uint8Array, aad?: Uint8Array): {
+    ciphertext: Uint8Array;
+    tag: Uint8Array;
+};
+/**
+ * Decrypt using AES-256-GCM (synchronous; Node.js or crypto-browserify).
+ */
+export declare function decryptAes256Gcm(key: Uint8Array, iv: Uint8Array, ciphertext: Uint8Array, tag: Uint8Array, aad?: Uint8Array): Uint8Array;
+//# sourceMappingURL=crypto-compat.d.ts.map

package/dist/utils/crypto-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-compat.d.ts","sourceRoot":"","sources":["../../src/utils/crypto-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiLH;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACjE,MAAM,IAAI,UAAU,CAAC;CACrB,CA2BA;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,UAAU,GACvB,OAAO,CAAC,UAAU,CAAC,CAYrB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,UAAU,GACZ;IACF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC,CAqDA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,UAAU,GACZ;IACF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5E,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC,CAqDA;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CACjC,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,UAAU,GACd,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CACjC,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,UAAU,GACd,OAAO,CAAC,UAAU,CAAC,CAWrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,UAAU,EACd,SAAS,EAAE,UAAU,EACrB,GAAG,CAAC,EAAE,UAAU,GACd;IAAE,UAAU,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,CA4B7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,UAAU,EACd,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,UAAU,EACf,GAAG,CAAC,EAAE,UAAU,GACd,UAAU,CAiCZ"}

package/dist/utils/environment.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Browser and Node.js compatible environment variable abstraction
+ * This module provides a cross-platform interface for accessing environment variables
+ * that works in both browser and Node.js environments.
+ */
+/**
+ * Type representing the runtime environment
+ */
+export type RuntimeEnvironment = "node" | "browser" | "unknown";
+/**
+ * Interface for environment configuration
+ */
+export interface EnvironmentConfig {
+    [key: string]: string | boolean | number | undefined;
+}
+/**
+ * Detect the current runtime environment
+ */
+export declare function detectEnvironment(): RuntimeEnvironment;
+/**
+ * Environment abstraction class
+ */
+declare class Environment {
+    private readonly runtime;
+    private browserStore;
+    private cache;
+    constructor();
+    /**
+     * Get the current runtime environment
+     */
+    getRuntime(): RuntimeEnvironment;
+    /**
+     * Check if running in Node.js
+     */
+    isNode(): boolean;
+    /**
+     * Check if running in browser
+     */
+    isBrowser(): boolean;
+    /**
+     * Get an environment variable
+     */
+    get(key: string, defaultValue?: string): string | undefined;
+    /**
+     * Set an environment variable (mainly for browser/testing)
+     */
+    set(key: string, value: string | boolean | number): void;
+    /**
+     * Check if an environment variable exists
+     */
+    has(key: string): boolean;
+    /**
+     * Get all environment variables
+     */
+    getAll(): EnvironmentConfig;
+    /**
+     * Get a boolean environment variable
+     */
+    getBoolean(key: string, defaultValue?: boolean): boolean;
+    /**
+     * Get a number environment variable
+     */
+    getNumber(key: string, defaultValue?: number): number | undefined;
+    /**
+     * Clear the cache (useful for testing)
+     */
+    clearCache(): void;
+}
+/**
+ * Get the singleton Environment instance
+ */
+export declare function getEnvironment(): Environment;
+/**
+ * Convenience function to get an environment variable
+ */
+export declare function getEnv(key: string, defaultValue?: string): string | undefined;
+/**
+ * Convenience function to set an environment variable
+ */
+export declare function setEnv(key: string, value: string | boolean | number): void;
+/**
+ * Convenience function to check if an environment variable exists
+ */
+export declare function hasEnv(key: string): boolean;
+/**
+ * Convenience function to get a boolean environment variable
+ */
+export declare function getBooleanEnv(key: string, defaultValue?: boolean): boolean;
+/**
+ * Convenience function to get a number environment variable
+ */
+export declare function getNumberEnv(key: string, defaultValue?: number): number | undefined;
+/**
+ * Initialize browser environment with config
+ * This should be called early in browser apps to set up environment
+ */
+export declare function initBrowserEnvironment(config: EnvironmentConfig): void;
+/**
+ * Export the current runtime for convenience
+ */
+export declare const currentRuntime: RuntimeEnvironment;
+/**
+ * Re-export the Environment class for advanced usage
+ */
+export { Environment };
+/**
+ * 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 declare function findEnvFile(startDir?: string, filenames?: string[]): string | 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 declare function loadEnvFile(envPath?: string): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/utils/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/utils/environment.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAoBtD;AA0CD;;GAEG;AACH,cAAM,WAAW;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,KAAK,CAA8C;;IAS3D;;OAEG;IACH,UAAU,IAAI,kBAAkB;IAIhC;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAqB3D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI;IAaxD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,MAAM,IAAI,iBAAiB;IAY3B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO;IAKtD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IASjE;;OAEG;IACH,UAAU,IAAI,IAAI;CAGlB;AAOD;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAK5C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAEpB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAStE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,oBAAsB,CAAC;AAElD;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,CAAC;AAMvB;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,GAAE,MAAM,EAA2B,GAC1C,MAAM,GAAG,IAAI,CA0Bf;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAqBrD"}

package/dist/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/dist/utils/json-llm.d.ts.map

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

package/dist/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/dist/utils/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../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/dist/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/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../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"}