@elizaos/api-client 1.4.2 → 1.4.3-alpha.0

package/dist/core/src/types/web-search.d.ts

@@ -0,0 +1,112 @@
+import { Service } from './service';
+export interface SearchOptions {
+    limit?: number;
+    offset?: number;
+    language?: string;
+    region?: string;
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    fileType?: string;
+    site?: string;
+    sortBy?: 'relevance' | 'date' | 'popularity';
+    safeSearch?: 'strict' | 'moderate' | 'off';
+}
+export interface SearchResult {
+    title: string;
+    url: string;
+    description: string;
+    displayUrl?: string;
+    thumbnail?: string;
+    publishedDate?: Date;
+    source?: string;
+    relevanceScore?: number;
+    snippet?: string;
+}
+export interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+    totalResults?: number;
+    searchTime?: number;
+    suggestions?: string[];
+    nextPageToken?: string;
+    relatedSearches?: string[];
+}
+export interface NewsSearchOptions extends SearchOptions {
+    category?: 'general' | 'business' | 'entertainment' | 'health' | 'science' | 'sports' | 'technology';
+    freshness?: 'day' | 'week' | 'month';
+}
+export interface ImageSearchOptions extends SearchOptions {
+    size?: 'small' | 'medium' | 'large' | 'wallpaper' | 'any';
+    color?: 'color' | 'monochrome' | 'red' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | 'pink' | 'brown' | 'black' | 'gray' | 'white';
+    type?: 'photo' | 'clipart' | 'line' | 'animated';
+    layout?: 'square' | 'wide' | 'tall' | 'any';
+    license?: 'any' | 'public' | 'share' | 'sharecommercially' | 'modify';
+}
+export interface VideoSearchOptions extends SearchOptions {
+    duration?: 'short' | 'medium' | 'long' | 'any';
+    resolution?: 'high' | 'standard' | 'any';
+    quality?: 'high' | 'standard' | 'any';
+}
+/**
+ * Interface for web search services
+ */
+export declare abstract class IWebSearchService extends Service {
+    static readonly serviceType: "web_search";
+    readonly capabilityDescription = "Web search and content discovery capabilities";
+    /**
+     * Perform a general web search
+     * @param query - Search query
+     * @param options - Search options
+     * @returns Promise resolving to search results
+     */
+    abstract search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Search for news articles
+     * @param query - Search query
+     * @param options - News search options
+     * @returns Promise resolving to news search results
+     */
+    abstract searchNews(query: string, options?: NewsSearchOptions): Promise<SearchResponse>;
+    /**
+     * Search for images
+     * @param query - Search query
+     * @param options - Image search options
+     * @returns Promise resolving to image search results
+     */
+    abstract searchImages(query: string, options?: ImageSearchOptions): Promise<SearchResponse>;
+    /**
+     * Search for videos
+     * @param query - Search query
+     * @param options - Video search options
+     * @returns Promise resolving to video search results
+     */
+    abstract searchVideos(query: string, options?: VideoSearchOptions): Promise<SearchResponse>;
+    /**
+     * Get search suggestions for a query
+     * @param query - Partial search query
+     * @returns Promise resolving to array of suggestions
+     */
+    abstract getSuggestions(query: string): Promise<string[]>;
+    /**
+     * Get trending searches
+     * @param region - Optional region code
+     * @returns Promise resolving to trending search queries
+     */
+    abstract getTrendingSearches(region?: string): Promise<string[]>;
+    /**
+     * Get detailed information about a specific URL
+     * @param url - URL to analyze
+     * @returns Promise resolving to page information
+     */
+    abstract getPageInfo(url: string): Promise<{
+        title: string;
+        description: string;
+        content: string;
+        metadata: Record<string, string>;
+        images: string[];
+        links: string[];
+    }>;
+}
+//# sourceMappingURL=web-search.d.ts.map

package/dist/core/src/types/web-search.d.ts.map

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

package/dist/core/src/utils/buffer.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Browser and Node.js compatible buffer abstraction
+ * This module provides a unified interface for buffer operations
+ * that works in both browser and Node.js environments.
+ *
+ * In browsers, we use Uint8Array as a Buffer replacement.
+ * In Node.js, we use the native Buffer.
+ */
+/**
+ * Type representing a buffer-like object that works in both environments
+ */
+export type BufferLike = Buffer | Uint8Array;
+/**
+ * Convert a hex string to a buffer-like object
+ * @param hex - The hexadecimal string to convert
+ * @returns A BufferLike object
+ */
+export declare function fromHex(hex: string): BufferLike;
+/**
+ * Convert a string to a buffer-like object
+ * @param str - The string to convert
+ * @param encoding - The encoding to use (default: 'utf8')
+ * @returns A BufferLike object
+ */
+export declare function fromString(str: string, encoding?: 'utf8' | 'utf-8' | 'base64'): BufferLike;
+/**
+ * Convert a buffer-like object to a hexadecimal string
+ * @param buffer - The buffer to convert
+ * @returns A hexadecimal string
+ */
+export declare function toHex(buffer: BufferLike): string;
+/**
+ * Convert a buffer-like object to a string
+ * @param buffer - The buffer to convert
+ * @param encoding - The encoding to use (default: 'utf8')
+ * @returns A string
+ */
+export declare function toString(buffer: BufferLike, encoding?: 'utf8' | 'utf-8' | 'base64' | 'hex'): string;
+/**
+ * Check if an object is a Buffer or buffer-like object
+ * @param obj - The object to check
+ * @returns True if the object is buffer-like
+ */
+export declare function isBuffer(obj: any): obj is BufferLike;
+/**
+ * Create a buffer of a specific size filled with zeros
+ * @param size - The size of the buffer
+ * @returns A BufferLike object
+ */
+export declare function alloc(size: number): BufferLike;
+/**
+ * Create a buffer from an array of bytes
+ * @param bytes - Array of byte values
+ * @returns A BufferLike object
+ */
+export declare function fromBytes(bytes: number[] | Uint8Array): BufferLike;
+/**
+ * Concatenate multiple buffers
+ * @param buffers - Array of buffers to concatenate
+ * @returns A new BufferLike object
+ */
+export declare function concat(buffers: BufferLike[]): BufferLike;
+/**
+ * Slice a buffer to create a new buffer
+ * @param buffer - The buffer to slice
+ * @param start - Start index
+ * @param end - End index (optional)
+ * @returns A new BufferLike object
+ */
+export declare function slice(buffer: BufferLike, start: number, end?: number): BufferLike;
+/**
+ * Compare two buffers for equality
+ * @param a - First buffer
+ * @param b - Second buffer
+ * @returns True if buffers are equal
+ */
+export declare function equals(a: BufferLike, b: BufferLike): boolean;
+/**
+ * Get the byte length of a buffer
+ * @param buffer - The buffer
+ * @returns The byte length
+ */
+export declare function byteLength(buffer: BufferLike): number;
+/**
+ * Create a random buffer of specified size
+ * @param size - The size of the buffer
+ * @returns A BufferLike object filled with random bytes
+ */
+export declare function randomBytes(size: number): BufferLike;
+export declare const BufferUtils: {
+    fromHex: typeof fromHex;
+    fromString: typeof fromString;
+    fromBytes: typeof fromBytes;
+    toHex: typeof toHex;
+    toString: typeof toString;
+    isBuffer: typeof isBuffer;
+    alloc: typeof alloc;
+    concat: typeof concat;
+    slice: typeof slice;
+    equals: typeof equals;
+    byteLength: typeof byteLength;
+    randomBytes: typeof randomBytes;
+};
+export type { BufferLike as Buffer };
+//# sourceMappingURL=buffer.d.ts.map

package/dist/core/src/utils/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../../../core/src/utils/buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAS7C;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAiB/C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,MAAM,GAAG,OAAO,GAAG,QAAiB,GAC7C,UAAU,CAqBZ;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAchD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,QAAQ,GAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAc,GACrD,MAAM,CA0BR;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,UAAU,CAkBpD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAM9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,UAAU,CAMlE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CAsBxD;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,CAOjF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CAe5D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAwBpD;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAC;AAGF,YAAY,EAAE,UAAU,IAAI,MAAM,EAAE,CAAC"}

package/dist/core/src/utils/environment.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Browser and Node.js compatible environment variable abstraction
+ * This module provides a unified 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 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 (filtered for safety)
+     */
+    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 };
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../../../core/src/utils/environment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,kBAAkB,CAgBtD;AA0CD;;GAEG;AACH,cAAM,WAAW;IACf,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,YAAY,CAAC,CAA0B;IAC/C,OAAO,CAAC,KAAK,CAA8C;;IAU3D;;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;IAkC3D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI;IAqBxD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAKzB;;OAEG;IACH,MAAM,IAAI,iBAAiB;IAkB3B;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,OAAO;IAWtD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAWjE;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB;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,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnF;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"}

package/dist/core/src/utils/server-health.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Server health check utilities for waiting for servers to be ready
+ */
+export interface ServerHealthOptions {
+    port: number;
+    endpoint?: string;
+    maxWaitTime?: number;
+    pollInterval?: number;
+    requestTimeout?: number;
+    host?: string;
+    protocol?: 'http' | 'https';
+}
+/**
+ * Wait for server to be ready by polling health endpoint
+ * @param options - Configuration options for server health check
+ */
+export declare function waitForServerReady(options: ServerHealthOptions): Promise<void>;
+/**
+ * Simple ping check for server availability (no stabilization wait)
+ * @param options - Configuration options for server ping
+ */
+export declare function pingServer(options: ServerHealthOptions): Promise<boolean>;
+//# sourceMappingURL=server-health.d.ts.map

package/dist/core/src/utils/server-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-health.d.ts","sourceRoot":"","sources":["../../../../../core/src/utils/server-health.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDpF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC/E"}

package/dist/core/src/utils.d.ts

@@ -0,0 +1,177 @@
+import type { Entity, IAgentRuntime, Memory, State, TemplateType } from './types';
+import { UUID, ContentType } from './types';
+/**
+ * Composes a context string by replacing placeholders in a template with corresponding values from the state.
+ *
+ * This function takes a template string with placeholders in the format `{{placeholder}}` and a state object.
+ * It replaces each placeholder with the value from the state object that matches the placeholder's name.
+ * If a matching key is not found in the state object for a given placeholder, the placeholder is replaced with an empty string.
+ *
+ * @param {Object} params - The parameters for composing the context.
+ * @param {State} params.state - The state object containing values to replace the placeholders in the template.
+ * @param {TemplateType} params.template - The template string or function containing placeholders to be replaced with state values.
+ * @returns {string} The composed context string with placeholders replaced by corresponding state values.
+ *
+ * @example
+ * // Given a state object and a template
+ * const state = { userName: "Alice", userAge: 30 };
+ * const template = "Hello, {{userName}}! You are {{userAge}} years old";
+ *
+ * // Composing the context with simple string replacement will result in:
+ * // "Hello, Alice! You are 30 years old."
+ * const contextSimple = composePromptFromState({ state, template });
+ *
+ * // Using composePromptFromState with a template function for dynamic template
+ * const template = ({ state }) => {
+ * const tone = Math.random() > 0.5 ? "kind" : "rude";
+ *   return `Hello, {{userName}}! You are {{userAge}} years old. Be ${tone}`;
+ * };
+ * const contextSimple = composePromptFromState({ state, template });
+ */
+/**
+ * Function to compose a prompt using a provided template and state.
+ * It compiles the template (upgrading double braces to triple braces for non-HTML escaping)
+ * and then populates it with values from the state. Additionally, it processes the
+ * resulting string with `composeRandomUser` to replace placeholders like `{{nameX}}`.
+ *
+ * @param {Object} options - Object containing state and template information.
+ * @param {State} options.state - The state object containing values to fill the template.
+ * @param {TemplateType} options.template - The template string or function to be used for composing the prompt.
+ * @returns {string} The composed prompt output, with state values and random user names populated.
+ */
+export declare const composePrompt: ({ state, template, }: {
+    state: {
+        [key: string]: string;
+    };
+    template: TemplateType;
+}) => string;
+/**
+ * Function to compose a prompt using a provided template and state.
+ *
+ * @param {Object} options - Object containing state and template information.
+ * @param {State} options.state - The state object containing values to fill the template.
+ * @param {TemplateType} options.template - The template to be used for composing the prompt.
+ * @returns {string} The composed prompt output.
+ */
+export declare const composePromptFromState: ({ state, template, }: {
+    state: State;
+    template: TemplateType;
+}) => string;
+/**
+ * Adds a header to a body of text.
+ *
+ * This function takes a header string and a body string and returns a new string with the header prepended to the body.
+ * If the body string is empty, the header is returned as is.
+ *
+ * @param {string} header - The header to add to the body.
+ * @param {string} body - The body to which to add the header.
+ * @returns {string} The body with the header prepended.
+ *
+ * @example
+ * // Given a header and a body
+ * const header = "Header";
+ * const body = "Body";
+ *
+ * // Adding the header to the body will result in:
+ * // "Header\nBody"
+ * const text = addHeader(header, body);
+ */
+export declare const addHeader: (header: string, body: string) => string;
+export declare const formatPosts: ({ messages, entities, conversationHeader, }: {
+    messages: Memory[];
+    entities: Entity[];
+    conversationHeader?: boolean;
+}) => string;
+/**
+ * Format messages into a string
+ * @param {Object} params - The formatting parameters
+ * @param {Memory[]} params.messages - List of messages to format
+ * @param {Entity[]} params.entities - List of entities for name resolution
+ * @returns {string} Formatted message string with timestamps and user information
+ */
+export declare const formatMessages: ({ messages, entities, }: {
+    messages: Memory[];
+    entities: Entity[];
+}) => string;
+export declare const formatTimestamp: (messageDate: number) => string;
+/**
+ * Parses key-value pairs from a simple XML structure within a given text.
+ * It looks for an XML block (e.g., <response>...</response>) and extracts
+ * text content from direct child elements (e.g., <key>value</key>).
+ *
+ * Note: This uses regex and is suitable for simple, predictable XML structures.
+ * For complex XML, a proper parsing library is recommended.
+ *
+ * @param text - The input text containing the XML structure.
+ * @returns An object with key-value pairs extracted from the XML, or null if parsing fails.
+ */
+export declare function parseKeyValueXml(text: string): Record<string, any> | null;
+/**
+ * Parses a JSON object from a given text. The function looks for a JSON block wrapped in triple backticks
+ * with `json` language identifier, and if not found, it searches for an object pattern within the text.
+ * It then attempts to parse the JSON string into a JavaScript object. If parsing is successful and the result
+ * is an object (but not an array), it returns the object; otherwise, it tries to parse an array if the result
+ * is an array, or returns null if parsing is unsuccessful or the result is neither an object nor an array.
+ *
+ * @param text - The input text from which to extract and parse the JSON object.
+ * @returns An object parsed from the JSON string if successful; otherwise, null or the result of parsing an array.
+ */
+export declare function parseJSONObjectFromText(text: string): Record<string, any> | null;
+/**
+ * Normalizes a JSON-like string by correcting formatting issues:
+ * - Removes extra spaces after '{' and before '}'.
+ * - Wraps unquoted values in double quotes.
+ * - Converts single-quoted values to double-quoted.
+ * - Ensures consistency in key-value formatting.
+ * - Normalizes mixed adjacent quote pairs.
+ *
+ * This is useful for cleaning up improperly formatted JSON strings
+ * before parsing them into valid JSON.
+ *
+ * @param str - The JSON-like string to normalize.
+ * @returns A properly formatted JSON string.
+ */
+export declare const normalizeJsonString: (str: string) => string;
+/**
+ * Truncate text to fit within the character limit, ensuring it ends at a complete sentence.
+ */
+export declare function truncateToCompleteSentence(text: string, maxLength: number): string;
+export declare function splitChunks(content: string, chunkSize?: number, bleed?: number): Promise<string[]>;
+/**
+ * Trims the provided text prompt to a specified token limit using a tokenizer model and type.
+ */
+export declare function trimTokens(prompt: string, maxTokens: number, runtime: IAgentRuntime): Promise<string>;
+export declare function safeReplacer(): (_key: string, value: any) => any;
+/**
+ * Parses a string to determine its boolean equivalent.
+ *
+ * Recognized affirmative values: "YES", "Y", "TRUE", "T", "1", "ON", "ENABLE"
+ * Recognized negative values: "NO", "N", "FALSE", "F", "0", "OFF", "DISABLE"
+ *
+ * @param {string | undefined | null} value - The input text to parse
+ * @returns {boolean} - Returns `true` for affirmative inputs, `false` for negative or unrecognized inputs
+ */
+export declare function parseBooleanFromText(value: string | undefined | null): boolean;
+/**
+ * Validates a UUID value.
+ *
+ * @param {unknown} value - The value to validate.
+ * @returns {UUID | null} Returns the validated UUID value or null if validation fails.
+ */
+export declare function validateUuid(value: unknown): UUID | null;
+/**
+ * Converts a string or number to a UUID.
+ *
+ * @param {string | number} target - The string or number to convert to a UUID.
+ * @returns {UUID} The UUID generated from the input target.
+ * @throws {TypeError} Throws an error if the input target is not a string.
+ */
+export declare function stringToUuid(target: string | number): UUID;
+/**
+ * Pre-warm the SHA-1 cache with common values using WebCrypto
+ * Call this during initialization to improve performance
+ */
+export declare function prewarmUuidCache(values: string[]): Promise<void>;
+export declare const getContentTypeFromMimeType: (mimeType: string) => ContentType | undefined;
+export declare function getLocalServerUrl(path: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../core/src/utils.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAW,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAa,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA8BvD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,GAAI,sBAG3B;IACD,KAAK,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACjC,QAAQ,EAAE,YAAY,CAAC;CACxB,WAKA,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,sBAGpC;IACD,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;CACxB,WAiBA,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,WAErD,CAAC;AAkCF,eAAO,MAAM,WAAW,GAAI,6CAIzB;IACD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,WAiDA,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,yBAG5B;IACD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,WA6DA,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,aAAa,MAAM,WAoBlD,CAAC;AAIF;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAgOzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAwBhF;AAED;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,WAc9C,CAAC;AAaF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA0BlF;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBjG;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,mBAwBzF;AAED,wBAAgB,YAAY,KAET,MAAM,MAAM,EAAE,OAAO,GAAG,SAS1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAiB9E;AAMD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAGxD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B1D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtE;AA8ND,eAAO,MAAM,0BAA0B,GAAI,UAAU,MAAM,KAAG,WAAW,GAAG,SAQ3E,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD"}