@elizaos/core 1.0.6 → 1.0.7

package/dist/{index-S6eSMHDH.d.ts → index-CGCNwsoH.d.ts}

@@ -1,4 +1,4 @@
-import { a as Action$1, I as IDatabaseAdapter$1, U as UUID$1, E as Entity$1, b as Component$1, M as Memory$1, L as Log$1, c as MemoryMetadata$1, W as World$1, R as Room$1, d as Participant$1, e as Relationship$1, f as Agent$1, T as Task$1, g as IAgentRuntime$1, h as Role$1, i as ServiceTypeName$1, j as Service$1, k as Route$1, l as Character$1, P as Provider$1, m as Evaluator$1, n as Plugin$1, o as RuntimeSettings$1, S as State$1, H as HandlerCallback$1, p as ModelTypeName$1, q as ModelResultMap$1, r as ModelParamsMap$1, s as TaskWorker$1, t as TargetInfo$1, C as Content$1, u as TemplateType$1, v as ActionEventPayload$1, A as ActionExample$1, w as AgentStatus$1, x as AudioProcessingParams$1, B as BaseMetadata$1, y as BaseModelParams$1, z as CacheKeyPrefix$1, D as ChannelType$1, F as ChunkRow$1, G as ComponentData$1, J as ContentType$1, K as ControlMessage$1, N as CustomMetadata$1, O as DbConnection$1, Q as DeriveKeyAttestationData$1, V as DescriptionMetadata$1, X as DetokenizeTextParams$1, Y as DirectoryItem$1, Z as DocumentMetadata$1, _ as EmbeddingSearchResult$1, $ as EnhancedState$1, a0 as EntityPayload$1, a1 as EvaluationExample$1, a2 as EvaluatorEventPayload$1, a3 as EventDataObject$1, a4 as EventHandler$1, a5 as EventPayload$1, a6 as EventPayloadMap$1, a7 as EventType$1, a8 as FragmentMetadata$1, a9 as GenerateTextParams$1, aa as Handler$1, ab as ImageDescriptionParams$1, ac as ImageGenerationParams$1, ad as InvokePayload$1, ae as IsValidServiceType$1, af as JSONSchema$1, ag as KnowledgeItem$1, ah as KnowledgeScope$1, ai as Media$1, aj as MemoryRetrievalOptions$1, ak as MemoryScope$1, al as MemorySearchOptions$1, am as MemoryType$1, an as MemoryTypeAlias$1, ao as MessageExample$1, ap as MessageMemory$1, aq as MessageMetadata$1, ar as MessagePayload$1, as as MessageReceivedHandlerParams$1, at as MetadataObject$1, au as ModelEventPayload$1, av as ModelHandler$1, aw as ModelType$1, ax as MultiRoomMemoryOptions$1, ay as ObjectGenerationParams$1, az as OnboardingConfig$1, aA as PlatformPrefix$1, aB as PluginEvents$1, aC as Project$1, aD as ProjectAgent$1, aE as ProviderResult$1, aF as RemoteAttestationMessage$1, aG as RemoteAttestationQuote$1, aH as RoomMetadata$1, aI as RunEventPayload$1, aJ as SOCKET_MESSAGE_TYPE$1, aK as SendHandlerFunction$1, aL as ServiceClassMap$1, aM as ServiceConfig$1, aN as ServiceError$1, aO as ServiceInstance$1, aP as ServiceRegistry$1, aQ as ServiceType$1, aR as ServiceTypeRegistry$1, aS as ServiceTypeValue$1, aT as Setting$1, aU as StateArray$1, aV as StateObject$1, aW as StateValue$1, aX as TEEMode$1, aY as TaskMetadata$1, aZ as TeeAgent$1, a_ as TeePluginConfig$1, a$ as TeeType$1, b0 as TeeVendorConfig$1, b1 as TestCase$1, b2 as TestSuite$1, b3 as TextEmbeddingParams$1, b4 as TextGenerationParams$1, b5 as TextToSpeechParams$1, b6 as TokenizeTextParams$1, b7 as TranscriptionParams$1, b8 as TypedEventHandler$1, b9 as TypedService$1, ba as TypedServiceClass$1, bb as UnifiedMemoryOptions$1, bc as UnifiedSearchOptions$1, bd as VECTOR_DIMS$1, be as Validator$1, bf as VideoProcessingParams$1, bg as WorldPayload$1, bh as WorldSettings$1, bi as asUUID$1, bj as createMessageMemory$1, bk as createServiceError$1, bl as getMemoryText$1, bm as getTypedService$1, bn as isCustomMetadata$1, bo as isDescriptionMetadata$1, bp as isDocumentMemory$1, bq as isDocumentMetadata$1, br as isFragmentMemory$1, bs as isFragmentMetadata$1, bt as isMessageMetadata$1 } from './types-D9v-eW3g.js';
+import { a as Action$1, I as IDatabaseAdapter$1, U as UUID$1, E as Entity$1, b as Component$1, M as Memory$1, L as Log$1, c as MemoryMetadata$1, W as World$1, R as Room$1, d as Participant$1, e as Relationship$1, f as Agent$1, T as Task$1, g as IAgentRuntime$1, h as Role$1, i as ServiceTypeName$1, j as Service$1, k as Route$1, l as Character$1, P as Provider$1, m as Evaluator$1, n as Plugin$1, o as RuntimeSettings$1, S as State$1, H as HandlerCallback$1, p as ModelTypeName$1, q as ModelResultMap$1, r as ModelParamsMap$1, s as TaskWorker$1, t as TargetInfo$1, C as Content$1, u as TemplateType$1, v as ActionEventPayload$1, A as ActionExample$1, w as AgentStatus$1, x as AudioProcessingParams$1, B as BaseMetadata$1, y as BaseModelParams$1, z as CacheKeyPrefix$1, D as ChannelType$1, F as ChunkRow$1, G as ComponentData$1, J as ContentType$1, K as ControlMessage$1, N as CustomMetadata$1, O as DbConnection$1, Q as DeriveKeyAttestationData, V as DescriptionMetadata$1, X as DetokenizeTextParams$1, Y as DirectoryItem$1, Z as DocumentMetadata$1, _ as EmbeddingSearchResult$1, $ as EnhancedState$1, a0 as EntityPayload$1, a1 as EvaluationExample$1, a2 as EvaluatorEventPayload$1, a3 as EventDataObject$1, a4 as EventHandler$1, a5 as EventPayload$1, a6 as EventPayloadMap$1, a7 as EventType$1, a8 as FragmentMetadata$1, a9 as GenerateTextParams$1, aa as Handler$1, ab as ImageDescriptionParams$1, ac as ImageGenerationParams$1, ad as InvokePayload$1, ae as IsValidServiceType$1, af as JSONSchema$1, ag as KnowledgeItem$1, ah as KnowledgeScope$1, ai as Media$1, aj as MemoryRetrievalOptions$1, ak as MemoryScope$1, al as MemorySearchOptions$1, am as MemoryType$1, an as MemoryTypeAlias$1, ao as MessageExample$1, ap as MessageMemory$1, aq as MessageMetadata$1, ar as MessagePayload$1, as as MessageReceivedHandlerParams$1, at as MetadataObject$1, au as ModelEventPayload$1, av as ModelHandler$1, aw as ModelType$1, ax as MultiRoomMemoryOptions$1, ay as ObjectGenerationParams$1, az as OnboardingConfig$1, aA as PlatformPrefix$1, aB as PluginEvents$1, aC as Project$1, aD as ProjectAgent$1, aE as ProviderResult$1, aF as RemoteAttestationMessage, aG as RemoteAttestationQuote, aH as RoomMetadata$1, aI as RunEventPayload$1, aJ as SOCKET_MESSAGE_TYPE$1, aK as SendHandlerFunction$1, aL as ServiceClassMap$1, aM as ServiceConfig$1, aN as ServiceError$1, aO as ServiceInstance$1, aP as ServiceRegistry$1, aQ as ServiceType$1, aR as ServiceTypeRegistry$1, aS as ServiceTypeValue$1, aT as Setting$1, aU as StateArray$1, aV as StateObject$1, aW as StateValue$1, aX as TEEMode, aY as TaskMetadata$1, aZ as TeeAgent, a_ as TeePluginConfig, a$ as TeeType, b0 as TeeVendorConfig, b1 as TestCase$1, b2 as TestSuite$1, b3 as TextEmbeddingParams$1, b4 as TextGenerationParams$1, b5 as TextToSpeechParams$1, b6 as TokenizeTextParams$1, b7 as TranscriptionParams$1, b8 as TypedEventHandler$1, b9 as TypedService$1, ba as TypedServiceClass$1, bb as UnifiedMemoryOptions$1, bc as UnifiedSearchOptions$1, bd as VECTOR_DIMS$1, be as Validator$1, bf as VideoProcessingParams$1, bg as WorldPayload$1, bh as WorldSettings$1, bi as asUUID$1, bj as createMessageMemory$1, bk as createServiceError$1, bl as getMemoryText$1, bm as getTypedService$1, bn as isCustomMetadata$1, bo as isDescriptionMetadata$1, bp as isDocumentMemory$1, bq as isDocumentMetadata$1, br as isFragmentMemory$1, bs as isFragmentMetadata$1, bt as isMessageMetadata$1 } from './types-sJIakXg4.js';
 
 /**
  * Defines a custom type UUID representing a universally unique identifier
@@ -39,124 +39,32 @@ interface Content {
     [key: string]: unknown;
 }
 /**
- * Example content with associated user for demonstration purposes
- */
-interface ActionExample {
-    /** User associated with the example */
-    name: string;
-    /** Content of the example */
-    content: Content;
-}
-type ModelTypeName = (typeof ModelType)[keyof typeof ModelType] | string;
-/**
- * Defines the recognized types of models that the agent runtime can use.
- * These include models for text generation (small, large, reasoning, completion),
- * text embedding, tokenization (encode/decode), image generation and description,
- * audio transcription, text-to-speech, and generic object generation.
- * This constant is used throughout the system, particularly in `AgentRuntime.useModel`,
- * `AgentRuntime.registerModel`, and in `ModelParamsMap` / `ModelResultMap` to ensure
- * type safety and clarity when working with different AI models.
- * String values are used for extensibility with custom model types.
- */
-declare const ModelType: {
-    readonly SMALL: "TEXT_SMALL";
-    readonly MEDIUM: "TEXT_LARGE";
-    readonly LARGE: "TEXT_LARGE";
-    readonly TEXT_SMALL: "TEXT_SMALL";
-    readonly TEXT_LARGE: "TEXT_LARGE";
-    readonly TEXT_EMBEDDING: "TEXT_EMBEDDING";
-    readonly TEXT_TOKENIZER_ENCODE: "TEXT_TOKENIZER_ENCODE";
-    readonly TEXT_TOKENIZER_DECODE: "TEXT_TOKENIZER_DECODE";
-    readonly TEXT_REASONING_SMALL: "REASONING_SMALL";
-    readonly TEXT_REASONING_LARGE: "REASONING_LARGE";
-    readonly TEXT_COMPLETION: "TEXT_COMPLETION";
-    readonly IMAGE: "IMAGE";
-    readonly IMAGE_DESCRIPTION: "IMAGE_DESCRIPTION";
-    readonly TRANSCRIPTION: "TRANSCRIPTION";
-    readonly TEXT_TO_SPEECH: "TEXT_TO_SPEECH";
-    readonly AUDIO: "AUDIO";
-    readonly VIDEO: "VIDEO";
-    readonly OBJECT_SMALL: "OBJECT_SMALL";
-    readonly OBJECT_LARGE: "OBJECT_LARGE";
-};
-/**
- * Core service type registry that can be extended by plugins via module augmentation.
- * Plugins can extend this interface to add their own service types:
- *
- * @example
- * ```typescript
- * declare module '@elizaos/core' {
- *   interface ServiceTypeRegistry {
- *     MY_CUSTOM_SERVICE: 'my_custom_service';
- *   }
- * }
- * ```
- */
-interface ServiceTypeRegistry {
-    TRANSCRIPTION: 'transcription';
-    VIDEO: 'video';
-    BROWSER: 'browser';
-    PDF: 'pdf';
-    REMOTE_FILES: 'aws_s3';
-    WEB_SEARCH: 'web_search';
-    EMAIL: 'email';
-    TEE: 'tee';
-    TASK: 'task';
-    INSTRUMENTATION: 'instrumentation';
-}
-/**
- * Type for service names that includes both core services and any plugin-registered services
- */
-type ServiceTypeName = ServiceTypeRegistry[keyof ServiceTypeRegistry];
-/**
- * Helper type to extract service type values from the registry
- */
-type ServiceTypeValue<K extends keyof ServiceTypeRegistry> = ServiceTypeRegistry[K];
-/**
- * Helper type to check if a service type exists in the registry
- */
-type IsValidServiceType<T extends string> = T extends ServiceTypeName ? true : false;
-/**
- * Type-safe service class definition
+ * Represents a media attachment
  */
-type TypedServiceClass<T extends ServiceTypeName> = {
-    new (runtime?: IAgentRuntime): Service;
-    serviceType: T;
-    start(runtime: IAgentRuntime): Promise<Service>;
+type Media = {
+    /** Unique identifier */
+    id: string;
+    /** Media URL */
+    url: string;
+    /** Media title */
+    title?: string;
+    /** Media source */
+    source?: string;
+    /** Media description */
+    description?: string;
+    /** Text content */
+    text?: string;
+    /** Content type */
+    contentType?: ContentType;
 };
-/**
- * Map of service type names to their implementation classes
- */
-interface ServiceClassMap {
+declare enum ContentType {
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio",
+    DOCUMENT = "document",
+    LINK = "link"
 }
-/**
- * Helper to infer service instance type from service type name
- */
-type ServiceInstance<T extends ServiceTypeName> = T extends keyof ServiceClassMap ? InstanceType<ServiceClassMap[T]> : Service;
-/**
- * Runtime service registry type
- */
-type ServiceRegistry<T extends ServiceTypeName = ServiceTypeName> = Map<T, Service>;
-/**
- * Enumerates the recognized types of services that can be registered and used by the agent runtime.
- * Services provide specialized functionalities like audio transcription, video processing,
- * web browsing, PDF handling, file storage (e.g., AWS S3), web search, email integration,
- * secure execution via TEE (Trusted Execution Environment), task management, and instrumentation.
- * This constant is used in `AgentRuntime` for service registration and retrieval (e.g., `getService`).
- * Each service typically implements the `Service` abstract class or a more specific interface like `IVideoService`.
- */
-declare const ServiceType: {
-    readonly TRANSCRIPTION: "transcription";
-    readonly VIDEO: "video";
-    readonly BROWSER: "browser";
-    readonly PDF: "pdf";
-    readonly REMOTE_FILES: "aws_s3";
-    readonly WEB_SEARCH: "web_search";
-    readonly EMAIL: "email";
-    readonly TEE: "tee";
-    readonly TASK: "task";
-    readonly INSTRUMENTATION: "instrumentation";
-};
+
 /**
  * Represents the current state or context of a conversation or agent interaction.
  * This interface is a flexible container for various pieces of information that define the agent's
@@ -178,6 +86,44 @@ interface State {
     };
     text: string;
 }
+/**
+ * Defines the possible primitive types or structured types for a value within the agent's state.
+ * This type is used to provide more specific typing for properties within `StateObject` and `StateArray`,
+ * moving away from a generic 'any' type for better type safety and clarity in state management.
+ */
+type StateValue = string | number | boolean | null | StateObject | StateArray;
+/**
+ * Represents a generic object structure within the agent's state, where keys are strings
+ * and values can be any `StateValue`. This allows for nested objects within the state.
+ * It's a fundamental part of the `EnhancedState` interface.
+ */
+interface StateObject {
+    [key: string]: StateValue;
+}
+/**
+ * Represents an array of `StateValue` types within the agent's state.
+ * This allows for lists of mixed or uniform types to be stored in the state,
+ * contributing to the structured definition of `EnhancedState`.
+ */
+type StateArray = StateValue[];
+/**
+ * Enhanced State interface with more specific types for its core properties.
+ * This interface provides a more structured representation of an agent's conversational state,
+ * building upon the base `State` by typing `values` and `data` as `StateObject`.
+ * The `text` property typically holds a textual summary or context derived from the state.
+ * Additional dynamic properties are still allowed via the index signature `[key: string]: StateValue;`.
+ */
+interface EnhancedState {
+    /** Holds directly accessible state values, often used for template rendering or quick lookups. */
+    values: StateObject;
+    /** Stores more complex or structured data, potentially namespaced by providers or internal systems. */
+    data: StateObject;
+    /** A textual representation or summary of the current state, often used as context for models. */
+    text: string;
+    /** Allows for additional dynamic properties to be added to the state object. */
+    [key: string]: StateValue;
+}
+
 /**
  * Memory type enumeration for built-in memory types
  */
@@ -271,145 +217,135 @@ interface Memory {
     metadata?: MemoryMetadata;
 }
 /**
- * Represents a log entry
+ * Specialized memory type for messages with enhanced type checking
  */
-interface Log {
-    /** Optional unique identifier */
-    id?: UUID;
-    /** Associated entity ID */
-    entityId: UUID;
-    /** Associated room ID */
-    roomId?: UUID;
-    /** Log body */
-    body: {
-        [key: string]: unknown;
+interface MessageMemory extends Memory {
+    metadata: MessageMetadata;
+    content: Content & {
+        text: string;
     };
-    /** Log type */
-    type: string;
-    /** Log creation timestamp */
-    createdAt: Date;
 }
 /**
- * Example message for demonstration
+ * Factory function to create a new message memory with proper defaults
  */
-interface MessageExample {
-    /** Associated user */
-    name: string;
-    /** Message content */
-    content: Content;
-}
+declare function createMessageMemory(params: {
+    id?: UUID;
+    entityId: UUID;
+    agentId?: UUID;
+    roomId: UUID;
+    content: Content & {
+        text: string;
+    };
+    embedding?: number[];
+}): MessageMemory;
 /**
- * Handler function type for processing messages
+ * Type guard to check if a memory metadata is a DocumentMetadata
+ * @param metadata The metadata to check
+ * @returns True if the metadata is a DocumentMetadata
  */
-type Handler = (runtime: IAgentRuntime, message: Memory, state?: State, options?: {
-    [key: string]: unknown;
-}, callback?: HandlerCallback, responses?: Memory[]) => Promise<unknown>;
+declare function isDocumentMetadata(metadata: MemoryMetadata): metadata is DocumentMetadata;
 /**
- * Callback function type for handlers
+ * Type guard to check if a memory metadata is a FragmentMetadata
+ * @param metadata The metadata to check
+ * @returns True if the metadata is a FragmentMetadata
  */
-type HandlerCallback = (response: Content, files?: any) => Promise<Memory[]>;
+declare function isFragmentMetadata(metadata: MemoryMetadata): metadata is FragmentMetadata;
 /**
- * Validator function type for actions/evaluators
+ * Type guard to check if a memory metadata is a MessageMetadata
+ * @param metadata The metadata to check
+ * @returns True if the metadata is a MessageMetadata
  */
-type Validator = (runtime: IAgentRuntime, message: Memory, state?: State) => Promise<boolean>;
+declare function isMessageMetadata(metadata: MemoryMetadata): metadata is MessageMetadata;
 /**
- * Represents an action the agent can perform
+ * Type guard to check if a memory metadata is a DescriptionMetadata
+ * @param metadata The metadata to check
+ * @returns True if the metadata is a DescriptionMetadata
  */
-interface Action {
-    /** Similar action descriptions */
-    similes?: string[];
-    /** Detailed description */
-    description: string;
-    /** Example usages */
-    examples?: ActionExample[][];
-    /** Handler function */
-    handler: Handler;
-    /** Action name */
-    name: string;
-    /** Validation function */
-    validate: Validator;
-}
+declare function isDescriptionMetadata(metadata: MemoryMetadata): metadata is DescriptionMetadata;
 /**
- * Example for evaluating agent behavior
- */
-interface EvaluationExample {
-    /** Evaluation context */
-    prompt: string;
-    /** Example messages */
-    messages: Array<ActionExample>;
-    /** Expected outcome */
-    outcome: string;
-}
+ * Type guard to check if a memory metadata is a CustomMetadata
+ * @param metadata The metadata to check
+ * @returns True if the metadata is a CustomMetadata
+ */
+declare function isCustomMetadata(metadata: MemoryMetadata): metadata is CustomMetadata;
 /**
- * Evaluator for assessing agent responses
+ * Memory type guard for document memories
  */
-interface Evaluator {
-    /** Whether to always run */
-    alwaysRun?: boolean;
-    /** Detailed description */
-    description: string;
-    /** Similar evaluator descriptions */
-    similes?: string[];
-    /** Example evaluations */
-    examples: EvaluationExample[];
-    /** Handler function */
-    handler: Handler;
-    /** Evaluator name */
-    name: string;
-    /** Validation function */
-    validate: Validator;
+declare function isDocumentMemory(memory: Memory): memory is Memory & {
+    metadata: DocumentMetadata;
+};
+/**
+ * Memory type guard for fragment memories
+ */
+declare function isFragmentMemory(memory: Memory): memory is Memory & {
+    metadata: FragmentMetadata;
+};
+/**
+ * Safely access the text content of a memory
+ * @param memory The memory to extract text from
+ * @param defaultValue Optional default value if no text is found
+ * @returns The text content or default value
+ */
+declare function getMemoryText(memory: Memory, defaultValue?: string): string;
+
+/**
+ * Represents a single item of knowledge that can be processed and stored by the agent.
+ * Knowledge items consist of content (text and optional structured data) and metadata.
+ * These items are typically added to the agent's knowledge base via `AgentRuntime.addKnowledge`
+ * and retrieved using `AgentRuntime.getKnowledge`.
+ * The `id` is a unique identifier for the knowledge item, often derived from its source or content.
+ */
+type KnowledgeItem = {
+    /** A Universally Unique Identifier for this specific knowledge item. */
+    id: UUID;
+    /** The actual content of the knowledge item, which must include text and can have other fields. */
+    content: Content;
+    /** Optional metadata associated with this knowledge item, conforming to `MemoryMetadata`. */
+    metadata?: MemoryMetadata;
+};
+/**
+ * Defines the scope or visibility of knowledge items within the agent's system.
+ * - `SHARED`: Indicates knowledge that is broadly accessible, potentially across different agents or users if the system architecture permits.
+ * - `PRIVATE`: Indicates knowledge that is restricted, typically to the specific agent or user context it belongs to.
+ * This enum is used to manage access and retrieval of knowledge items, often in conjunction with `AgentRuntime.addKnowledge` or `AgentRuntime.getKnowledge` scopes.
+ */
+declare enum KnowledgeScope {
+    SHARED = "shared",
+    PRIVATE = "private"
 }
-interface ProviderResult {
-    values?: {
-        [key: string]: any;
-    };
-    data?: {
-        [key: string]: any;
-    };
-    text?: string;
+/**
+ * Specifies prefixes for keys used in caching mechanisms, helping to namespace cached data.
+ * For example, `KNOWLEDGE` might be used to prefix keys for cached knowledge embeddings or processed documents.
+ * This helps in organizing the cache and avoiding key collisions.
+ * Used internally by caching strategies, potentially within `IDatabaseAdapter` cache methods or runtime caching layers.
+ */
+declare enum CacheKeyPrefix {
+    KNOWLEDGE = "knowledge"
 }
 /**
- * Provider for external data/services
+ * Represents an item within a directory listing, specifically for knowledge loading.
+ * When an agent's `Character.knowledge` configuration includes a directory, this type
+ * is used to specify the path to that directory and whether its contents should be treated as shared.
+ * - `directory`: The path to the directory containing knowledge files.
+ * - `shared`: An optional boolean (defaults to false) indicating if the knowledge from this directory is considered shared or private.
  */
-interface Provider {
-    /** Provider name */
-    name: string;
-    /** Description of the provider */
-    description?: string;
-    /** Whether the provider is dynamic */
-    dynamic?: boolean;
-    /** Position of the provider in the provider list, positive or negative */
-    position?: number;
-    /**
-     * Whether the provider is private
-     *
-     * Private providers are not displayed in the regular provider list, they have to be called explicitly
-     */
-    private?: boolean;
-    /** Data retrieval function */
-    get: (runtime: IAgentRuntime, message: Memory, state: State) => Promise<ProviderResult>;
+interface DirectoryItem {
+    /** The path to the directory containing knowledge files. */
+    directory: string;
+    /** If true, knowledge from this directory is considered shared; otherwise, it's private. Defaults to false. */
+    shared?: boolean;
 }
 /**
- * Represents a relationship between users
+ * Represents a row structure, typically from a database query related to text chunking or processing.
+ * This interface is quite minimal and seems to be a placeholder or a base for more specific chunk-related types.
+ * The `id` would be the unique identifier for the chunk.
+ * It might be used when splitting large documents into smaller, manageable pieces for embedding or analysis.
  */
-interface Relationship {
-    /** Unique identifier */
-    id: UUID;
-    /** First user ID */
-    sourceEntityId: UUID;
-    /** Second user ID */
-    targetEntityId: UUID;
-    /** Agent ID */
-    agentId: UUID;
-    /** Tags for filtering/categorizing relationships */
-    tags: string[];
-    /** Additional metadata about the relationship */
-    metadata: {
-        [key: string]: any;
-    };
-    /** Optional creation timestamp */
-    createdAt?: string;
+interface ChunkRow {
+    /** The unique identifier for this chunk of text. */
+    id: string;
 }
+
 interface Component {
     id: UUID;
     entityId: UUID;
@@ -440,6 +376,18 @@ interface Entity {
     /** Optional array of components */
     components?: Component[];
 }
+/**
+ * Defines roles within a system, typically for access control or permissions, often within a `World`.
+ * - `OWNER`: Represents the highest level of control, typically the creator or primary administrator.
+ * - `ADMIN`: Represents administrative privileges, usually a subset of owner capabilities.
+ * - `NONE`: Indicates no specific role or default, minimal permissions.
+ * These roles are often used in `World.metadata.roles` to assign roles to entities.
+ */
+declare enum Role {
+    OWNER = "OWNER",
+    ADMIN = "ADMIN",
+    NONE = "NONE"
+}
 type World = {
     id: UUID;
     name?: string;
@@ -456,6 +404,18 @@ type World = {
     };
 };
 type RoomMetadata = Record<string, unknown>;
+declare enum ChannelType {
+    SELF = "SELF",// Messages to self
+    DM = "DM",// Direct messages between two participants
+    GROUP = "GROUP",// Group messages with multiple participants
+    VOICE_DM = "VOICE_DM",// Voice direct messages
+    VOICE_GROUP = "VOICE_GROUP",// Voice channels with multiple participants
+    FEED = "FEED",// Social media feed
+    THREAD = "THREAD",// Threaded conversation
+    WORLD = "WORLD",// World channel
+    FORUM = "FORUM",// Forum discussion
+    API = "API"
+}
 type Room = {
     id: UUID;
     name?: string;
@@ -477,117 +437,42 @@ interface Participant {
     entity: Entity;
 }
 /**
- * Represents a media attachment
+ * Represents a relationship between users
  */
-type Media = {
+interface Relationship {
     /** Unique identifier */
-    id: string;
-    /** Media URL */
-    url: string;
-    /** Media title */
-    title?: string;
-    /** Media source */
-    source?: string;
-    /** Media description */
-    description?: string;
-    /** Text content */
-    text?: string;
-    /** Content type */
-    contentType?: ContentType;
-};
-declare enum ContentType {
-    IMAGE = "image",
-    VIDEO = "video",
-    AUDIO = "audio",
-    DOCUMENT = "document",
-    LINK = "link"
-}
-declare enum ChannelType {
-    SELF = "SELF",// Messages to self
-    DM = "DM",// Direct messages between two participants
-    GROUP = "GROUP",// Group messages with multiple participants
-    VOICE_DM = "VOICE_DM",// Voice direct messages
-    VOICE_GROUP = "VOICE_GROUP",// Voice channels with multiple participants
-    FEED = "FEED",// Social media feed
-    THREAD = "THREAD",// Threaded conversation
-    WORLD = "WORLD",// World channel
-    FORUM = "FORUM",// Forum discussion
-    API = "API"
-}
-/**
- * Client instance
- */
-declare abstract class Service {
-    /** Runtime instance */
-    protected runtime: IAgentRuntime;
-    constructor(runtime?: IAgentRuntime);
-    abstract stop(): Promise<void>;
-    /** Service type */
-    static serviceType: string;
-    /** Service name */
-    abstract capabilityDescription: string;
-    /** Service configuration */
-    config?: {
+    id: UUID;
+    /** First user ID */
+    sourceEntityId: UUID;
+    /** Second user ID */
+    targetEntityId: UUID;
+    /** Agent ID */
+    agentId: UUID;
+    /** Tags for filtering/categorizing relationships */
+    tags: string[];
+    /** Additional metadata about the relationship */
+    metadata: {
         [key: string]: any;
     };
-    /** Start service connection */
-    static start(_runtime: IAgentRuntime): Promise<Service>;
-    /** Stop service connection */
-    static stop(_runtime: IAgentRuntime): Promise<unknown>;
+    /** Optional creation timestamp */
+    createdAt?: string;
 }
-type Route = {
-    type: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'STATIC';
-    path: string;
-    filePath?: string;
-    public?: boolean;
-    name?: string extends {
-        public: true;
-    } ? string : string | undefined;
-    handler?: (req: any, res: any, runtime: IAgentRuntime) => Promise<void>;
-    isMultipart?: boolean;
-};
 /**
- * Plugin for extending agent functionality
+ * A generic type for the `data` field within a `Component`.
+ * While `Record<string, unknown>` allows for flexibility, developers are encouraged
+ * to define more specific types for component data where possible to improve type safety
+ * and code maintainability. This type serves as a base for various component implementations.
  */
-type PluginEvents = {
-    [K in keyof EventPayloadMap]?: EventHandler<K>[];
-} & {
-    [key: string]: ((params: EventPayload) => Promise<any>)[];
-};
-interface Plugin {
-    name: string;
-    description: string;
-    init?: (config: Record<string, string>, runtime: IAgentRuntime) => Promise<void>;
-    config?: {
-        [key: string]: any;
-    };
-    services?: (typeof Service)[];
-    componentTypes?: {
-        name: string;
-        schema: Record<string, unknown>;
-        validator?: (data: any) => boolean;
-    }[];
-    actions?: Action[];
-    providers?: Provider[];
-    evaluators?: Evaluator[];
-    adapter?: IDatabaseAdapter;
-    models?: {
-        [key: string]: (...args: any[]) => Promise<any>;
-    };
-    events?: PluginEvents;
-    routes?: Route[];
-    tests?: TestSuite[];
-    dependencies?: string[];
-    priority?: number;
-}
-interface ProjectAgent {
-    character: Character;
-    init?: (runtime: IAgentRuntime) => Promise<void>;
-    plugins?: Plugin[];
-    tests?: TestSuite | TestSuite[];
-}
-interface Project {
-    agents: ProjectAgent[];
+type ComponentData = Record<string, unknown>;
+
+/**
+ * Example message for demonstration
+ */
+interface MessageExample {
+    /** Associated user */
+    name: string;
+    /** Message content */
+    content: Content;
 }
 type TemplateType = string | ((options: {
     state: State | {
@@ -637,10 +522,7 @@ interface Character {
     knowledge?: (string | {
         path: string;
         shared?: boolean;
-    } | {
-        directory: string;
-        shared?: boolean;
-    })[];
+    } | DirectoryItem)[];
     /** Available plugins */
     plugins?: string[];
     /** Optional configuration */
@@ -677,6 +559,90 @@ interface Agent extends Character {
     createdAt: number;
     updatedAt: number;
 }
+
+/**
+ * Defines the contract for a Task Worker, which is responsible for executing a specific type of task.
+ * Task workers are registered with the `AgentRuntime` and are invoked when a `Task` of their designated `name` needs processing.
+ * This pattern allows for modular and extensible background task processing.
+ */
+interface TaskWorker {
+    /** The unique name of the task type this worker handles. This name links `Task` instances to this worker. */
+    name: string;
+    /**
+     * The core execution logic for the task. This function is called by the runtime when a task needs to be processed.
+     * It receives the `AgentRuntime`, task-specific `options`, and the `Task` object itself.
+     */
+    execute: (runtime: IAgentRuntime, options: {
+        [key: string]: unknown;
+    }, task: Task) => Promise<void>;
+    /**
+     * Optional validation function that can be used to determine if a task is valid or should be executed,
+     * often based on the current message and state. This might be used by an action or evaluator
+     * before creating or queueing a task.
+     */
+    validate?: (runtime: IAgentRuntime, message: Memory, state: State) => Promise<boolean>;
+}
+/**
+ * Defines metadata associated with a `Task`.
+ * This can include scheduling information like `updateInterval` or UI-related details
+ * for presenting task options to a user.
+ * The `[key: string]: unknown;` allows for additional, unspecified metadata fields.
+ */
+type TaskMetadata = {
+    /** Optional. If the task is recurring, this specifies the interval in milliseconds between updates or executions. */
+    updateInterval?: number;
+    /** Optional. Describes options or parameters that can be configured for this task, often for UI presentation. */
+    options?: {
+        name: string;
+        description: string;
+    }[];
+    /** Allows for other dynamic metadata properties related to the task. */
+    [key: string]: unknown;
+};
+/**
+ * Represents a task to be performed, often in the background or at a later time.
+ * Tasks are managed by the `AgentRuntime` and processed by registered `TaskWorker`s.
+ * They can be associated with a room, world, and tagged for categorization and retrieval.
+ * The `IDatabaseAdapter` handles persistence of task data.
+ */
+interface Task {
+    /** Optional. A Universally Unique Identifier for the task. Generated if not provided. */
+    id?: UUID;
+    /** The name of the task, which should correspond to a registered `TaskWorker.name`. */
+    name: string;
+    /** Optional. Timestamp of the last update to this task. */
+    updatedAt?: number;
+    /** Optional. Metadata associated with the task, conforming to `TaskMetadata`. */
+    metadata?: TaskMetadata;
+    /** A human-readable description of what the task does or its purpose. */
+    description: string;
+    /** Optional. The UUID of the room this task is associated with. */
+    roomId?: UUID;
+    /** Optional. The UUID of the world this task is associated with. */
+    worldId?: UUID;
+    entityId?: UUID;
+    tags: string[];
+}
+
+/**
+ * Represents a log entry
+ */
+interface Log {
+    /** Optional unique identifier */
+    id?: UUID;
+    /** Associated entity ID */
+    entityId: UUID;
+    /** Associated room ID */
+    roomId?: UUID;
+    /** Log body */
+    body: {
+        [key: string]: unknown;
+    };
+    /** Log type */
+    type: string;
+    /** Log creation timestamp */
+    createdAt: Date;
+}
 /**
  * Interface for database operations
  */
@@ -694,7 +660,6 @@ interface IDatabaseAdapter {
     createAgent(agent: Partial<Agent>): Promise<boolean>;
     updateAgent(agentId: UUID, agent: Partial<Agent>): Promise<boolean>;
     deleteAgent(agentId: UUID): Promise<boolean>;
-    ensureAgentExists(agent: Partial<Agent>): Promise<Agent>;
     ensureEmbeddingDimension(dimension: number): Promise<void>;
     /** Get entity by IDs */
     getEntityByIds(entityIds: UUID[]): Promise<Entity[] | null>;
@@ -912,444 +877,105 @@ interface UnifiedSearchOptions extends UnifiedMemoryOptions {
     similarity?: number;
 }
 /**
- * Information describing the target of a message.
+ * Represents a generic database connection object.
+ * The actual type of this connection will depend on the specific database adapter implementation
+ * (e.g., a connection pool object for PostgreSQL, a client instance for a NoSQL database).
+ * This `unknown` type serves as a placeholder in the abstract `IDatabaseAdapter`.
  */
-interface TargetInfo {
-    source: string;
-    roomId?: UUID;
-    channelId?: string;
-    serverId?: string;
-    entityId?: UUID;
-    threadId?: string;
+type DbConnection = unknown;
+/**
+ * A generic type for metadata objects, often used in various parts of the system like
+ * `Relationship` metadata or other extensible data structures.
+ * It allows for arbitrary key-value pairs where values are of `unknown` type,
+ * encouraging consumers to perform type checking or casting.
+ */
+type MetadataObject = Record<string, unknown>;
+declare const VECTOR_DIMS: {
+    readonly SMALL: 384;
+    readonly MEDIUM: 512;
+    readonly LARGE: 768;
+    readonly XL: 1024;
+    readonly XXL: 1536;
+    readonly XXXL: 3072;
+};
+
+type ModelTypeName = (typeof ModelType)[keyof typeof ModelType] | string;
+/**
+ * Defines the recognized types of models that the agent runtime can use.
+ * These include models for text generation (small, large, reasoning, completion),
+ * text embedding, tokenization (encode/decode), image generation and description,
+ * audio transcription, text-to-speech, and generic object generation.
+ * This constant is used throughout the system, particularly in `AgentRuntime.useModel`,
+ * `AgentRuntime.registerModel`, and in `ModelParamsMap` / `ModelResultMap` to ensure
+ * type safety and clarity when working with different AI models.
+ * String values are used for extensibility with custom model types.
+ */
+declare const ModelType: {
+    readonly SMALL: "TEXT_SMALL";
+    readonly MEDIUM: "TEXT_LARGE";
+    readonly LARGE: "TEXT_LARGE";
+    readonly TEXT_SMALL: "TEXT_SMALL";
+    readonly TEXT_LARGE: "TEXT_LARGE";
+    readonly TEXT_EMBEDDING: "TEXT_EMBEDDING";
+    readonly TEXT_TOKENIZER_ENCODE: "TEXT_TOKENIZER_ENCODE";
+    readonly TEXT_TOKENIZER_DECODE: "TEXT_TOKENIZER_DECODE";
+    readonly TEXT_REASONING_SMALL: "REASONING_SMALL";
+    readonly TEXT_REASONING_LARGE: "REASONING_LARGE";
+    readonly TEXT_COMPLETION: "TEXT_COMPLETION";
+    readonly IMAGE: "IMAGE";
+    readonly IMAGE_DESCRIPTION: "IMAGE_DESCRIPTION";
+    readonly TRANSCRIPTION: "TRANSCRIPTION";
+    readonly TEXT_TO_SPEECH: "TEXT_TO_SPEECH";
+    readonly AUDIO: "AUDIO";
+    readonly VIDEO: "VIDEO";
+    readonly OBJECT_SMALL: "OBJECT_SMALL";
+    readonly OBJECT_LARGE: "OBJECT_LARGE";
+};
+/**
+ * Parameters for generating text using a language model.
+ * This structure is typically passed to `AgentRuntime.useModel` when the `modelType` is one of
+ * `ModelType.TEXT_SMALL`, `ModelType.TEXT_LARGE`, `ModelType.TEXT_REASONING_SMALL`,
+ * `ModelType.TEXT_REASONING_LARGE`, or `ModelType.TEXT_COMPLETION`.
+ * It includes essential information like the prompt, model type, and various generation controls.
+ */
+type GenerateTextParams = {
+    /** The `AgentRuntime` instance, providing access to models and other services. */
+    runtime: IAgentRuntime;
+    /** The input string or prompt that the language model will use to generate text. */
+    prompt: string;
+    /** Specifies the type of text generation model to use (e.g., TEXT_LARGE, REASONING_SMALL). */
+    modelType: ModelTypeName;
+    /** Optional. The maximum number of tokens to generate in the response. */
+    maxTokens?: number;
+    /** Optional. Controls randomness (0.0-1.0). Lower values are more deterministic, higher are more creative. */
+    temperature?: number;
+    /** Optional. Penalizes new tokens based on their existing frequency in the text so far. */
+    frequencyPenalty?: number;
+    /** Optional. Penalizes new tokens based on whether they appear in the text so far. */
+    presencePenalty?: number;
+    /** Optional. A list of sequences at which the model will stop generating further tokens. */
+    stopSequences?: string[];
+};
+/**
+ * Parameters for detokenizing text, i.e., converting a sequence of numerical tokens back into a string.
+ * This is the reverse operation of tokenization.
+ * This structure is used with `AgentRuntime.useModel` when the `modelType` is `ModelType.TEXT_TOKENIZER_DECODE`.
+ */
+interface DetokenizeTextParams {
+    /** An array of numerical tokens to be converted back into text. */
+    tokens: number[];
+    /** The model type used for detokenization, ensuring consistency with the original tokenization. */
+    modelType: ModelTypeName;
 }
 /**
- * Function signature for handlers responsible for sending messages to specific platforms.
+ * Base parameters common to all model types
  */
-type SendHandlerFunction = (runtime: IAgentRuntime, target: TargetInfo, content: Content) => Promise<void>;
+interface BaseModelParams {
+    /** The agent runtime for accessing services and utilities */
+    runtime: IAgentRuntime;
+}
 /**
- * Represents the core runtime environment for an agent.
- * Defines methods for database interaction, plugin management, event handling,
- * state composition, model usage, and task management.
- */
-interface IAgentRuntime extends IDatabaseAdapter {
-    agentId: UUID;
-    character: Character;
-    providers: Provider[];
-    actions: Action[];
-    evaluators: Evaluator[];
-    plugins: Plugin[];
-    services: Map<ServiceTypeName, Service>;
-    events: Map<string, ((params: any) => Promise<void>)[]>;
-    fetch?: typeof fetch | null;
-    routes: Route[];
-    registerPlugin(plugin: Plugin): Promise<void>;
-    initialize(): Promise<void>;
-    getConnection(): Promise<any>;
-    getService<T extends Service>(service: ServiceTypeName | string): T | null;
-    getAllServices(): Map<ServiceTypeName, Service>;
-    registerService(service: typeof Service): Promise<void>;
-    registerDatabaseAdapter(adapter: IDatabaseAdapter): void;
-    setSetting(key: string, value: string | boolean | null | any, secret?: boolean): void;
-    getSetting(key: string): string | boolean | null | any;
-    getConversationLength(): number;
-    processActions(message: Memory, responses: Memory[], state?: State, callback?: HandlerCallback): Promise<void>;
-    evaluate(message: Memory, state?: State, didRespond?: boolean, callback?: HandlerCallback, responses?: Memory[]): Promise<Evaluator[] | null>;
-    registerProvider(provider: Provider): void;
-    registerAction(action: Action): void;
-    registerEvaluator(evaluator: Evaluator): void;
-    ensureConnections(entities: Entity[], rooms: Room[], source: string, world: World): Promise<void>;
-    ensureConnection({ entityId, roomId, metadata, userName, worldName, name, source, channelId, serverId, type, worldId, userId, }: {
-        entityId: UUID;
-        roomId: UUID;
-        userName?: string;
-        name?: string;
-        worldName?: string;
-        source?: string;
-        channelId?: string;
-        serverId?: string;
-        type: ChannelType;
-        worldId: UUID;
-        userId?: UUID;
-        metadata?: Record<string, any>;
-    }): Promise<void>;
-    ensureParticipantInRoom(entityId: UUID, roomId: UUID): Promise<void>;
-    ensureWorldExists(world: World): Promise<void>;
-    ensureRoomExists(room: Room): Promise<void>;
-    composeState(message: Memory, includeList?: string[], onlyInclude?: boolean, skipCache?: boolean): Promise<State>;
-    /**
-     * Use a model with strongly typed parameters and return values based on model type
-     * @template T - The model type to use
-     * @template R - The expected return type, defaults to the type defined in ModelResultMap[T]
-     * @param {T} modelType - The type of model to use
-     * @param {ModelParamsMap[T] | any} params - The parameters for the model, typed based on model type
-     * @returns {Promise<R>} - The model result, typed based on the provided generic type parameter
-     */
-    useModel<T extends ModelTypeName, R = ModelResultMap[T]>(modelType: T, params: Omit<ModelParamsMap[T], 'runtime'> | any): Promise<R>;
-    registerModel(modelType: ModelTypeName | string, handler: (params: any) => Promise<any>, provider: string, priority?: number): void;
-    getModel(modelType: ModelTypeName | string): ((runtime: IAgentRuntime, params: any) => Promise<any>) | undefined;
-    registerEvent(event: string, handler: (params: any) => Promise<void>): void;
-    getEvent(event: string): ((params: any) => Promise<void>)[] | undefined;
-    emitEvent(event: string | string[], params: any): Promise<void>;
-    registerTaskWorker(taskHandler: TaskWorker): void;
-    getTaskWorker(name: string): TaskWorker | undefined;
-    stop(): Promise<void>;
-    addEmbeddingToMemory(memory: Memory): Promise<Memory>;
-    getEntityById(entityId: UUID): Promise<Entity | null>;
-    getRoom(roomId: UUID): Promise<Room | null>;
-    createEntity(entity: Entity): Promise<boolean>;
-    createRoom({ id, name, source, type, channelId, serverId, worldId }: Room): Promise<UUID>;
-    addParticipant(entityId: UUID, roomId: UUID): Promise<boolean>;
-    getRooms(worldId: UUID): Promise<Room[]>;
-    /**
-     * Registers a handler function responsible for sending messages to a specific source/platform.
-     * @param source - The unique identifier string for the source (e.g., 'discord', 'telegram').
-     * @param handler - The SendHandlerFunction to be called for this source.
-     */
-    registerSendHandler(source: string, handler: SendHandlerFunction): void;
-    /**
-     * Sends a message to a specified target using the appropriate registered handler.
-     * @param target - Information describing the target recipient and platform.
-     * @param content - The message content to send.
-     * @returns Promise resolving when the message sending process is initiated or completed.
-     */
-    sendMessageToTarget(target: TargetInfo, content: Content): Promise<void>;
-}
-/**
- * Interface representing settings with string key-value pairs.
- */
-interface RuntimeSettings {
-    [key: string]: string | undefined;
-}
-/**
- * Represents a single item of knowledge that can be processed and stored by the agent.
- * Knowledge items consist of content (text and optional structured data) and metadata.
- * These items are typically added to the agent's knowledge base via `AgentRuntime.addKnowledge`
- * and retrieved using `AgentRuntime.getKnowledge`.
- * The `id` is a unique identifier for the knowledge item, often derived from its source or content.
- */
-type KnowledgeItem = {
-    /** A Universally Unique Identifier for this specific knowledge item. */
-    id: UUID;
-    /** The actual content of the knowledge item, which must include text and can have other fields. */
-    content: Content;
-    /** Optional metadata associated with this knowledge item, conforming to `MemoryMetadata`. */
-    metadata?: MemoryMetadata;
-};
-/**
- * Defines the scope or visibility of knowledge items within the agent's system.
- * - `SHARED`: Indicates knowledge that is broadly accessible, potentially across different agents or users if the system architecture permits.
- * - `PRIVATE`: Indicates knowledge that is restricted, typically to the specific agent or user context it belongs to.
- * This enum is used to manage access and retrieval of knowledge items, often in conjunction with `AgentRuntime.addKnowledge` or `AgentRuntime.getKnowledge` scopes.
- */
-declare enum KnowledgeScope {
-    SHARED = "shared",
-    PRIVATE = "private"
-}
-/**
- * Specifies prefixes for keys used in caching mechanisms, helping to namespace cached data.
- * For example, `KNOWLEDGE` might be used to prefix keys for cached knowledge embeddings or processed documents.
- * This helps in organizing the cache and avoiding key collisions.
- * Used internally by caching strategies, potentially within `IDatabaseAdapter` cache methods or runtime caching layers.
- */
-declare enum CacheKeyPrefix {
-    KNOWLEDGE = "knowledge"
-}
-/**
- * Represents an item within a directory listing, specifically for knowledge loading.
- * When an agent's `Character.knowledge` configuration includes a directory, this type
- * is used to specify the path to that directory and whether its contents should be treated as shared.
- * - `directory`: The path to the directory containing knowledge files.
- * - `shared`: An optional boolean (defaults to false) indicating if the knowledge from this directory is considered shared or private.
- */
-interface DirectoryItem {
-    /** The path to the directory containing knowledge files. */
-    directory: string;
-    /** If true, knowledge from this directory is considered shared; otherwise, it's private. Defaults to false. */
-    shared?: boolean;
-}
-/**
- * Represents a row structure, typically from a database query related to text chunking or processing.
- * This interface is quite minimal and seems to be a placeholder or a base for more specific chunk-related types.
- * The `id` would be the unique identifier for the chunk.
- * It might be used when splitting large documents into smaller, manageable pieces for embedding or analysis.
- */
-interface ChunkRow {
-    /** The unique identifier for this chunk of text. */
-    id: string;
-}
-/**
- * Parameters for generating text using a language model.
- * This structure is typically passed to `AgentRuntime.useModel` when the `modelType` is one of
- * `ModelType.TEXT_SMALL`, `ModelType.TEXT_LARGE`, `ModelType.TEXT_REASONING_SMALL`,
- * `ModelType.TEXT_REASONING_LARGE`, or `ModelType.TEXT_COMPLETION`.
- * It includes essential information like the prompt, model type, and various generation controls.
- */
-type GenerateTextParams = {
-    /** The `AgentRuntime` instance, providing access to models and other services. */
-    runtime: IAgentRuntime;
-    /** The input string or prompt that the language model will use to generate text. */
-    prompt: string;
-    /** Specifies the type of text generation model to use (e.g., TEXT_LARGE, REASONING_SMALL). */
-    modelType: ModelTypeName;
-    /** Optional. The maximum number of tokens to generate in the response. */
-    maxTokens?: number;
-    /** Optional. Controls randomness (0.0-1.0). Lower values are more deterministic, higher are more creative. */
-    temperature?: number;
-    /** Optional. Penalizes new tokens based on their existing frequency in the text so far. */
-    frequencyPenalty?: number;
-    /** Optional. Penalizes new tokens based on whether they appear in the text so far. */
-    presencePenalty?: number;
-    /** Optional. A list of sequences at which the model will stop generating further tokens. */
-    stopSequences?: string[];
-};
-/**
- * Parameters for detokenizing text, i.e., converting a sequence of numerical tokens back into a string.
- * This is the reverse operation of tokenization.
- * This structure is used with `AgentRuntime.useModel` when the `modelType` is `ModelType.TEXT_TOKENIZER_DECODE`.
- */
-interface DetokenizeTextParams {
-    /** An array of numerical tokens to be converted back into text. */
-    tokens: number[];
-    /** The model type used for detokenization, ensuring consistency with the original tokenization. */
-    modelType: ModelTypeName;
-}
-/**
- * Represents a test case for evaluating agent or plugin functionality.
- * Each test case has a name and a function that contains the test logic.
- * The test function receives the `IAgentRuntime` instance, allowing it to interact with the agent's capabilities.
- * Test cases are typically grouped into `TestSuite`s.
- */
-interface TestCase {
-    /** A descriptive name for the test case, e.g., "should respond to greetings". */
-    name: string;
-    /**
-     * The function that executes the test logic. It can be synchronous or asynchronous.
-     * It receives the `IAgentRuntime` to interact with the agent and its services.
-     * The function should typically contain assertions to verify expected outcomes.
-     */
-    fn: (runtime: IAgentRuntime) => Promise<void> | void;
-}
-/**
- * Represents a suite of related test cases for an agent or plugin.
- * This helps in organizing tests and running them collectively.
- * A `ProjectAgent` can define one or more `TestSuite`s.
- */
-interface TestSuite {
-    /** A descriptive name for the test suite, e.g., "Core Functionality Tests". */
-    name: string;
-    /** An array of `TestCase` objects that belong to this suite. */
-    tests: TestCase[];
-}
-/**
- * Represents an agent's registration details within a Trusted Execution Environment (TEE) context.
- * This is typically stored in a database table (e.g., `TeeAgent`) to manage agents operating in a TEE.
- * It allows for multiple registrations of the same `agentId` to support scenarios where an agent might restart,
- * generating a new keypair and attestation each time.
- */
-interface TeeAgent {
-    /** Primary key for the TEE agent registration record (e.g., a UUID or auto-incrementing ID). */
-    id: string;
-    /** The core identifier of the agent, which can be duplicated across multiple TEE registrations. */
-    agentId: string;
-    /** The human-readable name of the agent. */
-    agentName: string;
-    /** Timestamp (e.g., Unix epoch in milliseconds) when this TEE registration was created. */
-    createdAt: number;
-    /** The public key associated with this specific TEE agent instance/session. */
-    publicKey: string;
-    /** The attestation document proving the authenticity and integrity of the TEE instance. */
-    attestation: string;
-}
-/**
- * Defines the operational modes for a Trusted Execution Environment (TEE).
- * This enum is used to configure how TEE functionalities are engaged, allowing for
- * different setups for local development, Docker-based development, and production.
- */
-declare enum TEEMode {
-    /** TEE functionality is completely disabled. */
-    OFF = "OFF",
-    /** For local development, potentially using a TEE simulator. */
-    LOCAL = "LOCAL",// For local development with simulator
-    /** For Docker-based development environments, possibly with a TEE simulator. */
-    DOCKER = "DOCKER",// For docker development with simulator
-    /** For production deployments, using actual TEE hardware without a simulator. */
-    PRODUCTION = "PRODUCTION"
-}
-/**
- * Represents a quote obtained during remote attestation for a Trusted Execution Environment (TEE).
- * This quote is a piece of evidence provided by the TEE, cryptographically signed, which can be
- * verified by a relying party to ensure the TEE's integrity and authenticity.
- */
-interface RemoteAttestationQuote {
-    /** The attestation quote data, typically a base64 encoded string or similar format. */
-    quote: string;
-    /** Timestamp (e.g., Unix epoch in milliseconds) when the quote was generated or received. */
-    timestamp: number;
-}
-/**
- * Data structure used in the attestation process for deriving a key within a Trusted Execution Environment (TEE).
- * This information helps establish a secure channel or verify the identity of the agent instance
- * requesting key derivation.
- */
-interface DeriveKeyAttestationData {
-    /** The unique identifier of the agent for which the key derivation is being attested. */
-    agentId: string;
-    /** The public key of the agent instance involved in the key derivation process. */
-    publicKey: string;
-    /** Optional subject or context information related to the key derivation. */
-    subject?: string;
-}
-/**
- * Represents a message that has been attested by a Trusted Execution Environment (TEE).
- * This structure binds a message to an agent's identity and a timestamp, all within the
- * context of a remote attestation process, ensuring the message originated from a trusted TEE instance.
- */
-interface RemoteAttestationMessage {
-    /** The unique identifier of the agent sending the attested message. */
-    agentId: string;
-    /** Timestamp (e.g., Unix epoch in milliseconds) when the message was attested or sent. */
-    timestamp: number;
-    /** The actual message content, including details about the entity, room, and the content itself. */
-    message: {
-        entityId: string;
-        roomId: string;
-        content: string;
-    };
-}
-/**
- * Enumerates different types or vendors of Trusted Execution Environments (TEEs).
- * This allows the system to adapt to specific TEE technologies, like Intel TDX on DSTACK.
- */
-declare enum TeeType {
-    /** Represents Intel Trusted Domain Extensions (TDX) running on DSTACK infrastructure. */
-    TDX_DSTACK = "tdx_dstack"
-}
-/**
- * Configuration options specific to a particular Trusted Execution Environment (TEE) vendor.
- * This allows for vendor-specific settings to be passed to the TEE plugin or service.
- * The structure is a generic key-value map, as configurations can vary widely between vendors.
- */
-interface TeeVendorConfig {
-    [key: string]: unknown;
-}
-/**
- * Configuration for a TEE (Trusted Execution Environment) plugin.
- * This allows specifying the TEE vendor and any vendor-specific configurations.
- * It's used to initialize and configure TEE-related functionalities within the agent system.
- */
-interface TeePluginConfig {
-    /** Optional. The name or identifier of the TEE vendor (e.g., 'tdx_dstack' from `TeeType`). */
-    vendor?: string;
-    /** Optional. Vendor-specific configuration options, conforming to `TeeVendorConfig`. */
-    vendorConfig?: TeeVendorConfig;
-}
-/**
- * Defines the contract for a Task Worker, which is responsible for executing a specific type of task.
- * Task workers are registered with the `AgentRuntime` and are invoked when a `Task` of their designated `name` needs processing.
- * This pattern allows for modular and extensible background task processing.
- */
-interface TaskWorker {
-    /** The unique name of the task type this worker handles. This name links `Task` instances to this worker. */
-    name: string;
-    /**
-     * The core execution logic for the task. This function is called by the runtime when a task needs to be processed.
-     * It receives the `AgentRuntime`, task-specific `options`, and the `Task` object itself.
-     */
-    execute: (runtime: IAgentRuntime, options: {
-        [key: string]: unknown;
-    }, task: Task) => Promise<void>;
-    /**
-     * Optional validation function that can be used to determine if a task is valid or should be executed,
-     * often based on the current message and state. This might be used by an action or evaluator
-     * before creating or queueing a task.
-     */
-    validate?: (runtime: IAgentRuntime, message: Memory, state: State) => Promise<boolean>;
-}
-/**
- * Defines metadata associated with a `Task`.
- * This can include scheduling information like `updateInterval` or UI-related details
- * for presenting task options to a user.
- * The `[key: string]: unknown;` allows for additional, unspecified metadata fields.
- */
-type TaskMetadata = {
-    /** Optional. If the task is recurring, this specifies the interval in milliseconds between updates or executions. */
-    updateInterval?: number;
-    /** Optional. Describes options or parameters that can be configured for this task, often for UI presentation. */
-    options?: {
-        name: string;
-        description: string;
-    }[];
-    /** Allows for other dynamic metadata properties related to the task. */
-    [key: string]: unknown;
-};
-/**
- * Represents a task to be performed, often in the background or at a later time.
- * Tasks are managed by the `AgentRuntime` and processed by registered `TaskWorker`s.
- * They can be associated with a room, world, and tagged for categorization and retrieval.
- * The `IDatabaseAdapter` handles persistence of task data.
- */
-interface Task {
-    /** Optional. A Universally Unique Identifier for the task. Generated if not provided. */
-    id?: UUID;
-    /** The name of the task, which should correspond to a registered `TaskWorker.name`. */
-    name: string;
-    /** Optional. Timestamp of the last update to this task. */
-    updatedAt?: number;
-    /** Optional. Metadata associated with the task, conforming to `TaskMetadata`. */
-    metadata?: TaskMetadata;
-    /** A human-readable description of what the task does or its purpose. */
-    description: string;
-    /** Optional. The UUID of the room this task is associated with. */
-    roomId?: UUID;
-    /** Optional. The UUID of the world this task is associated with. */
-    worldId?: UUID;
-    entityId?: UUID;
-    tags: string[];
-}
-/**
- * Defines roles within a system, typically for access control or permissions, often within a `World`.
- * - `OWNER`: Represents the highest level of control, typically the creator or primary administrator.
- * - `ADMIN`: Represents administrative privileges, usually a subset of owner capabilities.
- * - `NONE`: Indicates no specific role or default, minimal permissions.
- * These roles are often used in `World.metadata.roles` to assign roles to entities.
- */
-declare enum Role {
-    OWNER = "OWNER",
-    ADMIN = "ADMIN",
-    NONE = "NONE"
-}
-interface Setting {
-    name: string;
-    description: string;
-    usageDescription: string;
-    value: string | boolean | null;
-    required: boolean;
-    public?: boolean;
-    secret?: boolean;
-    validation?: (value: any) => boolean;
-    dependsOn?: string[];
-    onSetAction?: (value: any) => string;
-    visibleIf?: (settings: {
-        [key: string]: Setting;
-    }) => boolean;
-}
-interface WorldSettings {
-    [key: string]: Setting;
-}
-interface OnboardingConfig {
-    settings: {
-        [key: string]: Omit<Setting, 'value'>;
-    };
-}
-/**
- * Base parameters common to all model types
- */
-interface BaseModelParams {
-    /** The agent runtime for accessing services and utilities */
-    runtime: IAgentRuntime;
-}
-/**
- * Parameters for text generation models
+ * Parameters for text generation models
  */
 interface TextGenerationParams extends BaseModelParams {
     /** The prompt to generate text from */
@@ -1516,6 +1142,71 @@ interface ModelResultMap {
     [ModelType.OBJECT_LARGE]: any;
     [key: string]: any;
 }
+/**
+ * Defines the structure for a model handler registration within the `AgentRuntime`.
+ * Each model (e.g., for text generation, embedding) is associated with a handler function,
+ * the name of the provider (plugin or system) that registered it, and an optional priority.
+ * The `priority` (higher is more preferred) helps in selecting which handler to use if multiple
+ * handlers are registered for the same model type. The `registrationOrder` (not in type, but used in runtime)
+ * serves as a tie-breaker. See `AgentRuntime.registerModel` and `AgentRuntime.getModel`.
+ */
+interface ModelHandler {
+    /** The function that executes the model, taking runtime and parameters, and returning a Promise. */
+    handler: (runtime: IAgentRuntime, params: Record<string, unknown>) => Promise<unknown>;
+    /** The name of the provider (e.g., plugin name) that registered this model handler. */
+    provider: string;
+    /**
+     * Optional priority for this model handler. Higher numbers indicate higher priority.
+     * This is used by `AgentRuntime.getModel` to select the most appropriate handler
+     * when multiple are available for a given model type. Defaults to 0 if not specified.
+     */
+    priority?: number;
+    registrationOrder?: number;
+}
+
+/**
+ * Information describing the target of a message.
+ */
+interface TargetInfo {
+    source: string;
+    roomId?: UUID;
+    channelId?: string;
+    serverId?: string;
+    entityId?: UUID;
+    threadId?: string;
+}
+/**
+ * Function signature for handlers responsible for sending messages to specific platforms.
+ */
+type SendHandlerFunction = (runtime: IAgentRuntime, target: TargetInfo, content: Content) => Promise<void>;
+declare enum SOCKET_MESSAGE_TYPE {
+    ROOM_JOINING = 1,
+    SEND_MESSAGE = 2,
+    MESSAGE = 3,
+    ACK = 4,
+    THINKING = 5,
+    CONTROL = 6
+}
+/**
+ * Interface for control messages sent from the backend to the frontend
+ * to manage UI state and interaction capabilities
+ */
+interface ControlMessage {
+    /** Message type identifier */
+    type: 'control';
+    /** Control message payload */
+    payload: {
+        /** Action to perform */
+        action: 'disable_input' | 'enable_input';
+        /** Optional target element identifier */
+        target?: string;
+        /** Additional optional parameters */
+        [key: string]: unknown;
+    };
+    /** Room ID to ensure signal is directed to the correct chat window */
+    roomId: UUID;
+}
+
 /**
  * Standard event types across all platforms
  */
@@ -1678,42 +1369,129 @@ interface EventPayloadMap {
     [EventType.MODEL_USED]: ModelEventPayload;
 }
 /**
- * Event handler function type
+ * Event handler function type
+ */
+type EventHandler<T extends keyof EventPayloadMap> = (payload: EventPayloadMap[T]) => Promise<void>;
+/**
+ * Represents a generic data object that can be passed as a payload in an event.
+ * This type is often used in `TypedEventHandler` to provide a flexible yet somewhat
+ * structured way to handle event data. Specific event handlers might cast this to a
+ * more concrete type based on the event being processed.
+ */
+type EventDataObject = Record<string, unknown>;
+/**
+ * Defines a more specific type for event handlers, expecting an `EventDataObject`.
+ * This aims to improve upon generic 'any' type handlers, providing a clearer contract
+ * for functions that respond to events emitted within the agent runtime (see `emitEvent` in `AgentRuntime`).
+ * Handlers can be synchronous or asynchronous.
+ */
+type TypedEventHandler = (data: EventDataObject) => Promise<void> | void;
+
+/**
+ * Core service type registry that can be extended by plugins via module augmentation.
+ * Plugins can extend this interface to add their own service types:
+ *
+ * @example
+ * ```typescript
+ * declare module '@elizaos/core' {
+ *   interface ServiceTypeRegistry {
+ *     MY_CUSTOM_SERVICE: 'my_custom_service';
+ *   }
+ * }
+ * ```
+ */
+interface ServiceTypeRegistry {
+    TRANSCRIPTION: 'transcription';
+    VIDEO: 'video';
+    BROWSER: 'browser';
+    PDF: 'pdf';
+    REMOTE_FILES: 'aws_s3';
+    WEB_SEARCH: 'web_search';
+    EMAIL: 'email';
+    TEE: 'tee';
+    TASK: 'task';
+    INSTRUMENTATION: 'instrumentation';
+    WALLET: 'wallet';
+    LP_POOL: 'lp_pool';
+    TOKEN_DATA: 'token_data';
+}
+/**
+ * Type for service names that includes both core services and any plugin-registered services
+ */
+type ServiceTypeName = ServiceTypeRegistry[keyof ServiceTypeRegistry];
+/**
+ * Helper type to extract service type values from the registry
+ */
+type ServiceTypeValue<K extends keyof ServiceTypeRegistry> = ServiceTypeRegistry[K];
+/**
+ * Helper type to check if a service type exists in the registry
+ */
+type IsValidServiceType<T extends string> = T extends ServiceTypeName ? true : false;
+/**
+ * Type-safe service class definition
+ */
+type TypedServiceClass<T extends ServiceTypeName> = {
+    new (runtime?: IAgentRuntime): Service;
+    serviceType: T;
+    start(runtime: IAgentRuntime): Promise<Service>;
+};
+/**
+ * Map of service type names to their implementation classes
+ */
+interface ServiceClassMap {
+}
+/**
+ * Helper to infer service instance type from service type name
  */
-type EventHandler<T extends keyof EventPayloadMap> = (payload: EventPayloadMap[T]) => Promise<void>;
+type ServiceInstance<T extends ServiceTypeName> = T extends keyof ServiceClassMap ? InstanceType<ServiceClassMap[T]> : Service;
 /**
- * Update the Plugin interface with typed events
+ * Runtime service registry type
  */
-declare enum SOCKET_MESSAGE_TYPE {
-    ROOM_JOINING = 1,
-    SEND_MESSAGE = 2,
-    MESSAGE = 3,
-    ACK = 4,
-    THINKING = 5,
-    CONTROL = 6
-}
+type ServiceRegistry<T extends ServiceTypeName = ServiceTypeName> = Map<T, Service>;
 /**
- * Specialized memory type for messages with enhanced type checking
+ * Enumerates the recognized types of services that can be registered and used by the agent runtime.
+ * Services provide specialized functionalities like audio transcription, video processing,
+ * web browsing, PDF handling, file storage (e.g., AWS S3), web search, email integration,
+ * secure execution via TEE (Trusted Execution Environment), task management, and instrumentation.
+ * This constant is used in `AgentRuntime` for service registration and retrieval (e.g., `getService`).
+ * Each service typically implements the `Service` abstract class or a more specific interface like `IVideoService`.
  */
-interface MessageMemory extends Memory {
-    metadata: MessageMetadata;
-    content: Content & {
-        text: string;
-    };
-}
+declare const ServiceType: {
+    readonly TRANSCRIPTION: "transcription";
+    readonly VIDEO: "video";
+    readonly BROWSER: "browser";
+    readonly PDF: "pdf";
+    readonly REMOTE_FILES: "aws_s3";
+    readonly WEB_SEARCH: "web_search";
+    readonly EMAIL: "email";
+    readonly TEE: "tee";
+    readonly TASK: "task";
+    readonly INSTRUMENTATION: "instrumentation";
+    readonly WALLET: "wallet";
+    readonly LP_POOL: "lp_pool";
+    readonly TOKEN_DATA: "token_data";
+};
 /**
- * Factory function to create a new message memory with proper defaults
+ * Client instance
  */
-declare function createMessageMemory(params: {
-    id?: UUID;
-    entityId: UUID;
-    agentId?: UUID;
-    roomId: UUID;
-    content: Content & {
-        text: string;
+declare abstract class Service {
+    /** Runtime instance */
+    protected runtime: IAgentRuntime;
+    constructor(runtime?: IAgentRuntime);
+    abstract stop(): Promise<void>;
+    /** Service type */
+    static serviceType: string;
+    /** Service name */
+    abstract capabilityDescription: string;
+    /** Service configuration */
+    config?: {
+        [key: string]: any;
     };
-    embedding?: number[];
-}): MessageMemory;
+    /** Start service connection */
+    static start(_runtime: IAgentRuntime): Promise<Service>;
+    /** Stop service connection */
+    static stop(_runtime: IAgentRuntime): Promise<unknown>;
+}
 /**
  * Generic service interface that provides better type checking for services
  * @template ConfigType The configuration type for this service
@@ -1743,196 +1521,327 @@ interface TypedService<ConfigType extends {
  */
 declare function getTypedService<T extends TypedService<any, any>>(runtime: IAgentRuntime, serviceType: ServiceTypeName): T | null;
 /**
- * Type guard to check if a memory metadata is a DocumentMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a DocumentMetadata
+ * Standardized service error type for consistent error handling
  */
-declare function isDocumentMetadata(metadata: MemoryMetadata): metadata is DocumentMetadata;
+interface ServiceError {
+    code: string;
+    message: string;
+    details?: unknown;
+    cause?: Error;
+}
 /**
- * Type guard to check if a memory metadata is a FragmentMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a FragmentMetadata
+ * Safely create a ServiceError from any caught error
  */
-declare function isFragmentMetadata(metadata: MemoryMetadata): metadata is FragmentMetadata;
+declare function createServiceError(error: unknown, code?: string): ServiceError;
 /**
- * Type guard to check if a memory metadata is a MessageMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a MessageMetadata
+ * A generic type for service configurations.
+ * Services (like `IVideoService`, `IBrowserService`) can have their own specific configuration
+ * structures. This type allows for a flexible way to pass configuration objects,
+ * typically used during service initialization within a plugin or the `AgentRuntime`.
  */
-declare function isMessageMetadata(metadata: MemoryMetadata): metadata is MessageMetadata;
+type ServiceConfig = Record<string, unknown>;
+
 /**
- * Type guard to check if a memory metadata is a DescriptionMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a DescriptionMetadata
+ * Represents a test case for evaluating agent or plugin functionality.
+ * Each test case has a name and a function that contains the test logic.
+ * The test function receives the `IAgentRuntime` instance, allowing it to interact with the agent's capabilities.
+ * Test cases are typically grouped into `TestSuite`s.
  */
-declare function isDescriptionMetadata(metadata: MemoryMetadata): metadata is DescriptionMetadata;
+interface TestCase {
+    /** A descriptive name for the test case, e.g., "should respond to greetings". */
+    name: string;
+    /**
+     * The function that executes the test logic. It can be synchronous or asynchronous.
+     * It receives the `IAgentRuntime` to interact with the agent and its services.
+     * The function should typically contain assertions to verify expected outcomes.
+     */
+    fn: (runtime: IAgentRuntime) => Promise<void> | void;
+}
 /**
- * Type guard to check if a memory metadata is a CustomMetadata
- * @param metadata The metadata to check
- * @returns True if the metadata is a CustomMetadata
+ * Represents a suite of related test cases for an agent or plugin.
+ * This helps in organizing tests and running them collectively.
+ * A `ProjectAgent` can define one or more `TestSuite`s.
  */
-declare function isCustomMetadata(metadata: MemoryMetadata): metadata is CustomMetadata;
+interface TestSuite {
+    /** A descriptive name for the test suite, e.g., "Core Functionality Tests". */
+    name: string;
+    /** An array of `TestCase` objects that belong to this suite. */
+    tests: TestCase[];
+}
+
+type Route = {
+    type: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'STATIC';
+    path: string;
+    filePath?: string;
+    public?: boolean;
+    name?: string extends {
+        public: true;
+    } ? string : string | undefined;
+    handler?: (req: any, res: any, runtime: IAgentRuntime) => Promise<void>;
+    isMultipart?: boolean;
+};
 /**
- * Standardized service error type for consistent error handling
+ * Plugin for extending agent functionality
  */
-interface ServiceError {
-    code: string;
-    message: string;
-    details?: unknown;
-    cause?: Error;
+type PluginEvents = {
+    [K in keyof EventPayloadMap]?: EventHandler<K>[];
+} & {
+    [key: string]: ((params: any) => Promise<any>)[];
+};
+interface Plugin {
+    name: string;
+    description: string;
+    init?: (config: Record<string, string>, runtime: IAgentRuntime) => Promise<void>;
+    config?: {
+        [key: string]: any;
+    };
+    services?: (typeof Service)[];
+    componentTypes?: {
+        name: string;
+        schema: Record<string, unknown>;
+        validator?: (data: any) => boolean;
+    }[];
+    actions?: Action[];
+    providers?: Provider[];
+    evaluators?: Evaluator[];
+    adapter?: IDatabaseAdapter;
+    models?: {
+        [key: string]: (...args: any[]) => Promise<any>;
+    };
+    events?: PluginEvents;
+    routes?: Route[];
+    tests?: TestSuite[];
+    dependencies?: string[];
+    priority?: number;
+}
+interface ProjectAgent {
+    character: Character;
+    init?: (runtime: IAgentRuntime) => Promise<void>;
+    plugins?: Plugin[];
+    tests?: TestSuite | TestSuite[];
+}
+interface Project {
+    agents: ProjectAgent[];
+}
+
+/**
+ * Represents the core runtime environment for an agent.
+ * Defines methods for database interaction, plugin management, event handling,
+ * state composition, model usage, and task management.
+ */
+interface IAgentRuntime extends IDatabaseAdapter {
+    agentId: UUID;
+    character: Character;
+    providers: Provider[];
+    actions: Action[];
+    evaluators: Evaluator[];
+    plugins: Plugin[];
+    services: Map<ServiceTypeName, Service>;
+    events: Map<string, ((params: any) => Promise<void>)[]>;
+    fetch?: typeof fetch | null;
+    routes: Route[];
+    registerPlugin(plugin: Plugin): Promise<void>;
+    initialize(): Promise<void>;
+    getConnection(): Promise<any>;
+    getService<T extends Service>(service: ServiceTypeName | string): T | null;
+    getAllServices(): Map<ServiceTypeName, Service>;
+    registerService(service: typeof Service): Promise<void>;
+    registerDatabaseAdapter(adapter: IDatabaseAdapter): void;
+    setSetting(key: string, value: string | boolean | null | any, secret?: boolean): void;
+    getSetting(key: string): string | boolean | null | any;
+    getConversationLength(): number;
+    processActions(message: Memory, responses: Memory[], state?: State, callback?: HandlerCallback): Promise<void>;
+    evaluate(message: Memory, state?: State, didRespond?: boolean, callback?: HandlerCallback, responses?: Memory[]): Promise<Evaluator[] | null>;
+    registerProvider(provider: Provider): void;
+    registerAction(action: Action): void;
+    registerEvaluator(evaluator: Evaluator): void;
+    ensureConnections(entities: Entity[], rooms: Room[], source: string, world: World): Promise<void>;
+    ensureConnection({ entityId, roomId, metadata, userName, worldName, name, source, channelId, serverId, type, worldId, userId, }: {
+        entityId: UUID;
+        roomId: UUID;
+        userName?: string;
+        name?: string;
+        worldName?: string;
+        source?: string;
+        channelId?: string;
+        serverId?: string;
+        type: any;
+        worldId: UUID;
+        userId?: UUID;
+        metadata?: Record<string, any>;
+    }): Promise<void>;
+    ensureParticipantInRoom(entityId: UUID, roomId: UUID): Promise<void>;
+    ensureWorldExists(world: World): Promise<void>;
+    ensureRoomExists(room: Room): Promise<void>;
+    composeState(message: Memory, includeList?: string[], onlyInclude?: boolean, skipCache?: boolean): Promise<State>;
+    /**
+     * Use a model with strongly typed parameters and return values based on model type
+     * @template T - The model type to use
+     * @template R - The expected return type, defaults to the type defined in ModelResultMap[T]
+     * @param {T} modelType - The type of model to use
+     * @param {ModelParamsMap[T] | any} params - The parameters for the model, typed based on model type
+     * @returns {Promise<R>} - The model result, typed based on the provided generic type parameter
+     */
+    useModel<T extends ModelTypeName, R = ModelResultMap[T]>(modelType: T, params: Omit<ModelParamsMap[T], 'runtime'> | any): Promise<R>;
+    registerModel(modelType: ModelTypeName | string, handler: (params: any) => Promise<any>, provider: string, priority?: number): void;
+    getModel(modelType: ModelTypeName | string): ((runtime: IAgentRuntime, params: any) => Promise<any>) | undefined;
+    registerEvent(event: string, handler: (params: any) => Promise<void>): void;
+    getEvent(event: string): ((params: any) => Promise<void>)[] | undefined;
+    emitEvent(event: string | string[], params: any): Promise<void>;
+    registerTaskWorker(taskHandler: TaskWorker): void;
+    getTaskWorker(name: string): TaskWorker | undefined;
+    stop(): Promise<void>;
+    addEmbeddingToMemory(memory: Memory): Promise<Memory>;
+    getEntityById(entityId: UUID): Promise<Entity | null>;
+    getRoom(roomId: UUID): Promise<Room | null>;
+    createEntity(entity: Entity): Promise<boolean>;
+    createRoom({ id, name, source, type, channelId, serverId, worldId }: Room): Promise<UUID>;
+    addParticipant(entityId: UUID, roomId: UUID): Promise<boolean>;
+    getRooms(worldId: UUID): Promise<Room[]>;
+    /**
+     * Registers a handler function responsible for sending messages to a specific source/platform.
+     * @param source - The unique identifier string for the source (e.g., 'discord', 'telegram').
+     * @param handler - The SendHandlerFunction to be called for this source.
+     */
+    registerSendHandler(source: string, handler: SendHandlerFunction): void;
+    /**
+     * Sends a message to a specified target using the appropriate registered handler.
+     * @param target - Information describing the target recipient and platform.
+     * @param content - The message content to send.
+     * @returns Promise resolving when the message sending process is initiated or completed.
+     */
+    sendMessageToTarget(target: TargetInfo, content: Content): Promise<void>;
 }
+
 /**
- * Memory type guard for document memories
- */
-declare function isDocumentMemory(memory: Memory): memory is Memory & {
-    metadata: DocumentMetadata;
-};
-/**
- * Memory type guard for fragment memories
- */
-declare function isFragmentMemory(memory: Memory): memory is Memory & {
-    metadata: FragmentMetadata;
-};
-/**
- * Safely access the text content of a memory
- * @param memory The memory to extract text from
- * @param defaultValue Optional default value if no text is found
- * @returns The text content or default value
+ * Example content with associated user for demonstration purposes
  */
-declare function getMemoryText(memory: Memory, defaultValue?: string): string;
+interface ActionExample {
+    /** User associated with the example */
+    name: string;
+    /** Content of the example */
+    content: Content;
+}
 /**
- * Safely create a ServiceError from any caught error
+ * Callback function type for handlers
  */
-declare function createServiceError(error: unknown, code?: string): ServiceError;
+type HandlerCallback = (response: Content, files?: any) => Promise<Memory[]>;
 /**
- * Replace 'any' types with more specific types
+ * Handler function type for processing messages
  */
+type Handler = (runtime: IAgentRuntime, message: Memory, state?: State, options?: {
+    [key: string]: unknown;
+}, callback?: HandlerCallback, responses?: Memory[]) => Promise<unknown>;
 /**
- * Defines the possible primitive types or structured types for a value within the agent's state.
- * This type is used to provide more specific typing for properties within `StateObject` and `StateArray`,
- * moving away from a generic 'any' type for better type safety and clarity in state management.
+ * Validator function type for actions/evaluators
  */
-type StateValue = string | number | boolean | null | StateObject | StateArray;
+type Validator = (runtime: IAgentRuntime, message: Memory, state?: State) => Promise<boolean>;
 /**
- * Represents a generic object structure within the agent's state, where keys are strings
- * and values can be any `StateValue`. This allows for nested objects within the state.
- * It's a fundamental part of the `EnhancedState` interface.
+ * Represents an action the agent can perform
  */
-interface StateObject {
-    [key: string]: StateValue;
+interface Action {
+    /** Similar action descriptions */
+    similes?: string[];
+    /** Detailed description */
+    description: string;
+    /** Example usages */
+    examples?: ActionExample[][];
+    /** Handler function */
+    handler: Handler;
+    /** Action name */
+    name: string;
+    /** Validation function */
+    validate: Validator;
 }
 /**
- * Represents an array of `StateValue` types within the agent's state.
- * This allows for lists of mixed or uniform types to be stored in the state,
- * contributing to the structured definition of `EnhancedState`.
- */
-type StateArray = StateValue[];
-/**
- * Enhanced State interface with more specific types for its core properties.
- * This interface provides a more structured representation of an agent's conversational state,
- * building upon the base `State` by typing `values` and `data` as `StateObject`.
- * The `text` property typically holds a textual summary or context derived from the state.
- * Additional dynamic properties are still allowed via the index signature `[key: string]: StateValue;`.
+ * Example for evaluating agent behavior
  */
-interface EnhancedState {
-    /** Holds directly accessible state values, often used for template rendering or quick lookups. */
-    values: StateObject;
-    /** Stores more complex or structured data, potentially namespaced by providers or internal systems. */
-    data: StateObject;
-    /** A textual representation or summary of the current state, often used as context for models. */
-    text: string;
-    /** Allows for additional dynamic properties to be added to the state object. */
-    [key: string]: StateValue;
+interface EvaluationExample {
+    /** Evaluation context */
+    prompt: string;
+    /** Example messages */
+    messages: Array<ActionExample>;
+    /** Expected outcome */
+    outcome: string;
 }
 /**
- * A generic type for the `data` field within a `Component`.
- * While `Record<string, unknown>` allows for flexibility, developers are encouraged
- * to define more specific types for component data where possible to improve type safety
- * and code maintainability. This type serves as a base for various component implementations.
- */
-type ComponentData = Record<string, unknown>;
-/**
- * Represents a generic data object that can be passed as a payload in an event.
- * This type is often used in `TypedEventHandler` to provide a flexible yet somewhat
- * structured way to handle event data. Specific event handlers might cast this to a
- * more concrete type based on the event being processed.
- */
-type EventDataObject = Record<string, unknown>;
-/**
- * Defines a more specific type for event handlers, expecting an `EventDataObject`.
- * This aims to improve upon generic 'any' type handlers, providing a clearer contract
- * for functions that respond to events emitted within the agent runtime (see `emitEvent` in `AgentRuntime`).
- * Handlers can be synchronous or asynchronous.
- */
-type TypedEventHandler = (data: EventDataObject) => Promise<void> | void;
-/**
- * Represents a generic database connection object.
- * The actual type of this connection will depend on the specific database adapter implementation
- * (e.g., a connection pool object for PostgreSQL, a client instance for a NoSQL database).
- * This `unknown` type serves as a placeholder in the abstract `IDatabaseAdapter`.
- */
-type DbConnection = unknown;
-/**
- * A generic type for metadata objects, often used in various parts of the system like
- * `Relationship` metadata or other extensible data structures.
- * It allows for arbitrary key-value pairs where values are of `unknown` type,
- * encouraging consumers to perform type checking or casting.
+ * Evaluator for assessing agent responses
  */
-type MetadataObject = Record<string, unknown>;
+interface Evaluator {
+    /** Whether to always run */
+    alwaysRun?: boolean;
+    /** Detailed description */
+    description: string;
+    /** Similar evaluator descriptions */
+    similes?: string[];
+    /** Example evaluations */
+    examples: EvaluationExample[];
+    /** Handler function */
+    handler: Handler;
+    /** Evaluator name */
+    name: string;
+    /** Validation function */
+    validate: Validator;
+}
+interface ProviderResult {
+    values?: {
+        [key: string]: any;
+    };
+    data?: {
+        [key: string]: any;
+    };
+    text?: string;
+}
 /**
- * Defines the structure for a model handler registration within the `AgentRuntime`.
- * Each model (e.g., for text generation, embedding) is associated with a handler function,
- * the name of the provider (plugin or system) that registered it, and an optional priority.
- * The `priority` (higher is more preferred) helps in selecting which handler to use if multiple
- * handlers are registered for the same model type. The `registrationOrder` (not in type, but used in runtime)
- * serves as a tie-breaker. See `AgentRuntime.registerModel` and `AgentRuntime.getModel`.
+ * Provider for external data/services
  */
-interface ModelHandler {
-    /** The function that executes the model, taking runtime and parameters, and returning a Promise. */
-    handler: (runtime: IAgentRuntime, params: Record<string, unknown>) => Promise<unknown>;
-    /** The name of the provider (e.g., plugin name) that registered this model handler. */
-    provider: string;
+interface Provider {
+    /** Provider name */
+    name: string;
+    /** Description of the provider */
+    description?: string;
+    /** Whether the provider is dynamic */
+    dynamic?: boolean;
+    /** Position of the provider in the provider list, positive or negative */
+    position?: number;
     /**
-     * Optional priority for this model handler. Higher numbers indicate higher priority.
-     * This is used by `AgentRuntime.getModel` to select the most appropriate handler
-     * when multiple are available for a given model type. Defaults to 0 if not specified.
+     * Whether the provider is private
+     *
+     * Private providers are not displayed in the regular provider list, they have to be called explicitly
      */
-    priority?: number;
-    registrationOrder?: number;
+    private?: boolean;
+    /** Data retrieval function */
+    get: (runtime: IAgentRuntime, message: Memory, state: State) => Promise<ProviderResult>;
 }
+
 /**
- * A generic type for service configurations.
- * Services (like `IVideoService`, `IBrowserService`) can have their own specific configuration
- * structures. This type allows for a flexible way to pass configuration objects,
- * typically used during service initialization within a plugin or the `AgentRuntime`.
- */
-type ServiceConfig = Record<string, unknown>;
-declare const VECTOR_DIMS: {
-    readonly SMALL: 384;
-    readonly MEDIUM: 512;
-    readonly LARGE: 768;
-    readonly XL: 1024;
-    readonly XXL: 1536;
-    readonly XXXL: 3072;
-};
-/**
- * Interface for control messages sent from the backend to the frontend
- * to manage UI state and interaction capabilities
+ * Interface representing settings with string key-value pairs.
  */
-interface ControlMessage {
-    /** Message type identifier */
-    type: 'control';
-    /** Control message payload */
-    payload: {
-        /** Action to perform */
-        action: 'disable_input' | 'enable_input';
-        /** Optional target element identifier */
-        target?: string;
-        /** Additional optional parameters */
-        [key: string]: unknown;
+interface RuntimeSettings {
+    [key: string]: string | undefined;
+}
+interface Setting {
+    name: string;
+    description: string;
+    usageDescription: string;
+    value: string | boolean | null;
+    required: boolean;
+    public?: boolean;
+    secret?: boolean;
+    validation?: (value: any) => boolean;
+    dependsOn?: string[];
+    onSetAction?: (value: any) => string;
+    visibleIf?: (settings: {
+        [key: string]: Setting;
+    }) => boolean;
+}
+interface WorldSettings {
+    [key: string]: Setting;
+}
+interface OnboardingConfig {
+    settings: {
+        [key: string]: Omit<Setting, 'value'>;
     };
-    /** Room ID to ensure signal is directed to the correct chat window */
-    roomId: UUID;
 }
 
 /**
@@ -2384,12 +2293,6 @@ declare abstract class DatabaseAdapter<DB = unknown> implements IDatabaseAdapter
      * @returns A Promise that resolves to a boolean indicating success or failure of the deletion.
      */
     abstract deleteAgent(agentId: UUID$1): Promise<boolean>;
-    /**
-     * Ensures an agent exists in the database.
-     * @param agent The agent object to ensure exists.
-     * @returns A Promise that resolves when the agent has been ensured to exist.
-     */
-    abstract ensureAgentExists(agent: Partial<Agent$1>): Promise<Agent$1>;
     /**
      * Ensures an embedding dimension exists in the database.
      * @param dimension The dimension to ensure exists.
@@ -3057,12 +2960,20 @@ type v2_AgentRuntime = AgentRuntime;
 declare const v2_AgentRuntime: typeof AgentRuntime;
 type v2_DatabaseAdapter<DB = unknown> = DatabaseAdapter<DB>;
 declare const v2_DatabaseAdapter: typeof DatabaseAdapter;
+declare const v2_DeriveKeyAttestationData: typeof DeriveKeyAttestationData;
+declare const v2_RemoteAttestationMessage: typeof RemoteAttestationMessage;
+declare const v2_RemoteAttestationQuote: typeof RemoteAttestationQuote;
 type v2_Semaphore = Semaphore;
 declare const v2_Semaphore: typeof Semaphore;
 type v2_ServerOwnershipState = ServerOwnershipState;
 type v2_ServiceBuilder<TService extends Service$1 = Service$1> = ServiceBuilder<TService>;
 declare const v2_ServiceBuilder: typeof ServiceBuilder;
 type v2_ServiceDefinition<T extends Service$1 = Service$1> = ServiceDefinition<T>;
+declare const v2_TEEMode: typeof TEEMode;
+declare const v2_TeeAgent: typeof TeeAgent;
+declare const v2_TeePluginConfig: typeof TeePluginConfig;
+declare const v2_TeeType: typeof TeeType;
+declare const v2_TeeVendorConfig: typeof TeeVendorConfig;
 declare const v2_addHeader: typeof addHeader;
 declare const v2_booleanFooter: typeof booleanFooter;
 declare const v2_composeActionExamples: typeof composeActionExamples;
@@ -3111,7 +3022,7 @@ declare const v2_unsaltWorldSettings: typeof unsaltWorldSettings;
 declare const v2_updateWorldSettings: typeof updateWorldSettings;
 declare const v2_validateUuid: typeof validateUuid;
 declare namespace v2 {
-  export { Action$1 as Action, ActionEventPayload$1 as ActionEventPayload, ActionExample$1 as ActionExample, Agent$1 as Agent, v2_AgentRuntime as AgentRuntime, AgentStatus$1 as AgentStatus, AudioProcessingParams$1 as AudioProcessingParams, BaseMetadata$1 as BaseMetadata, BaseModelParams$1 as BaseModelParams, CacheKeyPrefix$1 as CacheKeyPrefix, ChannelType$1 as ChannelType, Character$1 as Character, ChunkRow$1 as ChunkRow, Component$1 as Component, ComponentData$1 as ComponentData, Content$1 as Content, ContentType$1 as ContentType, ControlMessage$1 as ControlMessage, CustomMetadata$1 as CustomMetadata, v2_DatabaseAdapter as DatabaseAdapter, DbConnection$1 as DbConnection, DeriveKeyAttestationData$1 as DeriveKeyAttestationData, DescriptionMetadata$1 as DescriptionMetadata, DetokenizeTextParams$1 as DetokenizeTextParams, DirectoryItem$1 as DirectoryItem, DocumentMetadata$1 as DocumentMetadata, EmbeddingSearchResult$1 as EmbeddingSearchResult, EnhancedState$1 as EnhancedState, Entity$1 as Entity, EntityPayload$1 as EntityPayload, EvaluationExample$1 as EvaluationExample, Evaluator$1 as Evaluator, EvaluatorEventPayload$1 as EvaluatorEventPayload, EventDataObject$1 as EventDataObject, EventHandler$1 as EventHandler, EventPayload$1 as EventPayload, EventPayloadMap$1 as EventPayloadMap, EventType$1 as EventType, FragmentMetadata$1 as FragmentMetadata, GenerateTextParams$1 as GenerateTextParams, Handler$1 as Handler, HandlerCallback$1 as HandlerCallback, IAgentRuntime$1 as IAgentRuntime, IDatabaseAdapter$1 as IDatabaseAdapter, ImageDescriptionParams$1 as ImageDescriptionParams, ImageGenerationParams$1 as ImageGenerationParams, InvokePayload$1 as InvokePayload, IsValidServiceType$1 as IsValidServiceType, JSONSchema$1 as JSONSchema, KnowledgeItem$1 as KnowledgeItem, KnowledgeScope$1 as KnowledgeScope, Log$1 as Log, Media$1 as Media, Memory$1 as Memory, MemoryMetadata$1 as MemoryMetadata, MemoryRetrievalOptions$1 as MemoryRetrievalOptions, MemoryScope$1 as MemoryScope, MemorySearchOptions$1 as MemorySearchOptions, MemoryType$1 as MemoryType, MemoryTypeAlias$1 as MemoryTypeAlias, MessageExample$1 as MessageExample, MessageMemory$1 as MessageMemory, MessageMetadata$1 as MessageMetadata, MessagePayload$1 as MessagePayload, MessageReceivedHandlerParams$1 as MessageReceivedHandlerParams, MetadataObject$1 as MetadataObject, ModelEventPayload$1 as ModelEventPayload, ModelHandler$1 as ModelHandler, ModelParamsMap$1 as ModelParamsMap, ModelResultMap$1 as ModelResultMap, ModelType$1 as ModelType, ModelTypeName$1 as ModelTypeName, MultiRoomMemoryOptions$1 as MultiRoomMemoryOptions, ObjectGenerationParams$1 as ObjectGenerationParams, OnboardingConfig$1 as OnboardingConfig, Participant$1 as Participant, PlatformPrefix$1 as PlatformPrefix, Plugin$1 as Plugin, PluginEvents$1 as PluginEvents, Project$1 as Project, ProjectAgent$1 as ProjectAgent, Provider$1 as Provider, ProviderResult$1 as ProviderResult, Relationship$1 as Relationship, RemoteAttestationMessage$1 as RemoteAttestationMessage, RemoteAttestationQuote$1 as RemoteAttestationQuote, Role$1 as Role, Room$1 as Room, RoomMetadata$1 as RoomMetadata, Route$1 as Route, RunEventPayload$1 as RunEventPayload, RuntimeSettings$1 as RuntimeSettings, SOCKET_MESSAGE_TYPE$1 as SOCKET_MESSAGE_TYPE, v2_Semaphore as Semaphore, SendHandlerFunction$1 as SendHandlerFunction, type v2_ServerOwnershipState as ServerOwnershipState, Service$1 as Service, v2_ServiceBuilder as ServiceBuilder, ServiceClassMap$1 as ServiceClassMap, ServiceConfig$1 as ServiceConfig, type v2_ServiceDefinition as ServiceDefinition, ServiceError$1 as ServiceError, ServiceInstance$1 as ServiceInstance, ServiceRegistry$1 as ServiceRegistry, ServiceType$1 as ServiceType, ServiceTypeName$1 as ServiceTypeName, ServiceTypeRegistry$1 as ServiceTypeRegistry, ServiceTypeValue$1 as ServiceTypeValue, Setting$1 as Setting, State$1 as State, StateArray$1 as StateArray, StateObject$1 as StateObject, StateValue$1 as StateValue, TEEMode$1 as TEEMode, TargetInfo$1 as TargetInfo, Task$1 as Task, TaskMetadata$1 as TaskMetadata, TaskWorker$1 as TaskWorker, TeeAgent$1 as TeeAgent, TeePluginConfig$1 as TeePluginConfig, TeeType$1 as TeeType, TeeVendorConfig$1 as TeeVendorConfig, TemplateType$1 as TemplateType, TestCase$1 as TestCase, TestSuite$1 as TestSuite, TextEmbeddingParams$1 as TextEmbeddingParams, TextGenerationParams$1 as TextGenerationParams, TextToSpeechParams$1 as TextToSpeechParams, TokenizeTextParams$1 as TokenizeTextParams, TranscriptionParams$1 as TranscriptionParams, TypedEventHandler$1 as TypedEventHandler, TypedService$1 as TypedService, TypedServiceClass$1 as TypedServiceClass, UUID$1 as UUID, UnifiedMemoryOptions$1 as UnifiedMemoryOptions, UnifiedSearchOptions$1 as UnifiedSearchOptions, VECTOR_DIMS$1 as VECTOR_DIMS, Validator$1 as Validator, VideoProcessingParams$1 as VideoProcessingParams, World$1 as World, WorldPayload$1 as WorldPayload, WorldSettings$1 as WorldSettings, v2_addHeader as addHeader, asUUID$1 as asUUID, v2_booleanFooter as booleanFooter, v2_composeActionExamples as composeActionExamples, v2_composePrompt as composePrompt, v2_composePromptFromState as composePromptFromState, createMessageMemory$1 as createMessageMemory, v2_createService as createService, createServiceError$1 as createServiceError, v2_createSettingFromConfig as createSettingFromConfig, v2_createUniqueUuid as createUniqueUuid, v2_decryptObjectValues as decryptObjectValues, decryptStringValue as decryptSecret, v2_decryptStringValue as decryptStringValue, v2_decryptedCharacter as decryptedCharacter, v2_defineService as defineService, v2_elizaLogger as elizaLogger, v2_encryptObjectValues as encryptObjectValues, v2_encryptStringValue as encryptStringValue, v2_encryptedCharacter as encryptedCharacter, v2_findEntityByName as findEntityByName, v2_findWorldsForOwner as findWorldsForOwner, v2_formatActionNames as formatActionNames, v2_formatActions as formatActions, v2_formatEntities as formatEntities, v2_formatMessages as formatMessages, v2_formatPosts as formatPosts, v2_formatTimestamp as formatTimestamp, v2_getEntityDetails as getEntityDetails, getMemoryText$1 as getMemoryText, v2_getSalt as getSalt, getTypedService$1 as getTypedService, v2_getUserServerRole as getUserServerRole, v2_getWorldSettings as getWorldSettings, v2_imageDescriptionTemplate as imageDescriptionTemplate, v2_initializeOnboarding as initializeOnboarding, isCustomMetadata$1 as isCustomMetadata, isDescriptionMetadata$1 as isDescriptionMetadata, isDocumentMemory$1 as isDocumentMemory, isDocumentMetadata$1 as isDocumentMetadata, isFragmentMemory$1 as isFragmentMemory, isFragmentMetadata$1 as isFragmentMetadata, isMessageMetadata$1 as isMessageMetadata, v2_logger as logger, v2_messageHandlerTemplate as messageHandlerTemplate, v2_parseBooleanFromText as parseBooleanFromText, v2_parseJSONObjectFromText as parseJSONObjectFromText, v2_parseKeyValueXml as parseKeyValueXml, v2_postCreationTemplate as postCreationTemplate, v2_safeReplacer as safeReplacer, v2_saltSettingValue as saltSettingValue, v2_saltWorldSettings as saltWorldSettings, v2_shouldRespondTemplate as shouldRespondTemplate, v2_stringToUuid as stringToUuid, v2_trimTokens as trimTokens, v2_truncateToCompleteSentence as truncateToCompleteSentence, v2_unsaltSettingValue as unsaltSettingValue, v2_unsaltWorldSettings as unsaltWorldSettings, v2_updateWorldSettings as updateWorldSettings, v2_validateUuid as validateUuid };
+  export { Action$1 as Action, ActionEventPayload$1 as ActionEventPayload, ActionExample$1 as ActionExample, Agent$1 as Agent, v2_AgentRuntime as AgentRuntime, AgentStatus$1 as AgentStatus, AudioProcessingParams$1 as AudioProcessingParams, BaseMetadata$1 as BaseMetadata, BaseModelParams$1 as BaseModelParams, CacheKeyPrefix$1 as CacheKeyPrefix, ChannelType$1 as ChannelType, Character$1 as Character, ChunkRow$1 as ChunkRow, Component$1 as Component, ComponentData$1 as ComponentData, Content$1 as Content, ContentType$1 as ContentType, ControlMessage$1 as ControlMessage, CustomMetadata$1 as CustomMetadata, v2_DatabaseAdapter as DatabaseAdapter, DbConnection$1 as DbConnection, v2_DeriveKeyAttestationData as DeriveKeyAttestationData, DescriptionMetadata$1 as DescriptionMetadata, DetokenizeTextParams$1 as DetokenizeTextParams, DirectoryItem$1 as DirectoryItem, DocumentMetadata$1 as DocumentMetadata, EmbeddingSearchResult$1 as EmbeddingSearchResult, EnhancedState$1 as EnhancedState, Entity$1 as Entity, EntityPayload$1 as EntityPayload, EvaluationExample$1 as EvaluationExample, Evaluator$1 as Evaluator, EvaluatorEventPayload$1 as EvaluatorEventPayload, EventDataObject$1 as EventDataObject, EventHandler$1 as EventHandler, EventPayload$1 as EventPayload, EventPayloadMap$1 as EventPayloadMap, EventType$1 as EventType, FragmentMetadata$1 as FragmentMetadata, GenerateTextParams$1 as GenerateTextParams, Handler$1 as Handler, HandlerCallback$1 as HandlerCallback, IAgentRuntime$1 as IAgentRuntime, IDatabaseAdapter$1 as IDatabaseAdapter, ImageDescriptionParams$1 as ImageDescriptionParams, ImageGenerationParams$1 as ImageGenerationParams, InvokePayload$1 as InvokePayload, IsValidServiceType$1 as IsValidServiceType, JSONSchema$1 as JSONSchema, KnowledgeItem$1 as KnowledgeItem, KnowledgeScope$1 as KnowledgeScope, Log$1 as Log, Media$1 as Media, Memory$1 as Memory, MemoryMetadata$1 as MemoryMetadata, MemoryRetrievalOptions$1 as MemoryRetrievalOptions, MemoryScope$1 as MemoryScope, MemorySearchOptions$1 as MemorySearchOptions, MemoryType$1 as MemoryType, MemoryTypeAlias$1 as MemoryTypeAlias, MessageExample$1 as MessageExample, MessageMemory$1 as MessageMemory, MessageMetadata$1 as MessageMetadata, MessagePayload$1 as MessagePayload, MessageReceivedHandlerParams$1 as MessageReceivedHandlerParams, MetadataObject$1 as MetadataObject, ModelEventPayload$1 as ModelEventPayload, ModelHandler$1 as ModelHandler, ModelParamsMap$1 as ModelParamsMap, ModelResultMap$1 as ModelResultMap, ModelType$1 as ModelType, ModelTypeName$1 as ModelTypeName, MultiRoomMemoryOptions$1 as MultiRoomMemoryOptions, ObjectGenerationParams$1 as ObjectGenerationParams, OnboardingConfig$1 as OnboardingConfig, Participant$1 as Participant, PlatformPrefix$1 as PlatformPrefix, Plugin$1 as Plugin, PluginEvents$1 as PluginEvents, Project$1 as Project, ProjectAgent$1 as ProjectAgent, Provider$1 as Provider, ProviderResult$1 as ProviderResult, Relationship$1 as Relationship, v2_RemoteAttestationMessage as RemoteAttestationMessage, v2_RemoteAttestationQuote as RemoteAttestationQuote, Role$1 as Role, Room$1 as Room, RoomMetadata$1 as RoomMetadata, Route$1 as Route, RunEventPayload$1 as RunEventPayload, RuntimeSettings$1 as RuntimeSettings, SOCKET_MESSAGE_TYPE$1 as SOCKET_MESSAGE_TYPE, v2_Semaphore as Semaphore, SendHandlerFunction$1 as SendHandlerFunction, type v2_ServerOwnershipState as ServerOwnershipState, Service$1 as Service, v2_ServiceBuilder as ServiceBuilder, ServiceClassMap$1 as ServiceClassMap, ServiceConfig$1 as ServiceConfig, type v2_ServiceDefinition as ServiceDefinition, ServiceError$1 as ServiceError, ServiceInstance$1 as ServiceInstance, ServiceRegistry$1 as ServiceRegistry, ServiceType$1 as ServiceType, ServiceTypeName$1 as ServiceTypeName, ServiceTypeRegistry$1 as ServiceTypeRegistry, ServiceTypeValue$1 as ServiceTypeValue, Setting$1 as Setting, State$1 as State, StateArray$1 as StateArray, StateObject$1 as StateObject, StateValue$1 as StateValue, v2_TEEMode as TEEMode, TargetInfo$1 as TargetInfo, Task$1 as Task, TaskMetadata$1 as TaskMetadata, TaskWorker$1 as TaskWorker, v2_TeeAgent as TeeAgent, v2_TeePluginConfig as TeePluginConfig, v2_TeeType as TeeType, v2_TeeVendorConfig as TeeVendorConfig, TemplateType$1 as TemplateType, TestCase$1 as TestCase, TestSuite$1 as TestSuite, TextEmbeddingParams$1 as TextEmbeddingParams, TextGenerationParams$1 as TextGenerationParams, TextToSpeechParams$1 as TextToSpeechParams, TokenizeTextParams$1 as TokenizeTextParams, TranscriptionParams$1 as TranscriptionParams, TypedEventHandler$1 as TypedEventHandler, TypedService$1 as TypedService, TypedServiceClass$1 as TypedServiceClass, UUID$1 as UUID, UnifiedMemoryOptions$1 as UnifiedMemoryOptions, UnifiedSearchOptions$1 as UnifiedSearchOptions, VECTOR_DIMS$1 as VECTOR_DIMS, Validator$1 as Validator, VideoProcessingParams$1 as VideoProcessingParams, World$1 as World, WorldPayload$1 as WorldPayload, WorldSettings$1 as WorldSettings, v2_addHeader as addHeader, asUUID$1 as asUUID, v2_booleanFooter as booleanFooter, v2_composeActionExamples as composeActionExamples, v2_composePrompt as composePrompt, v2_composePromptFromState as composePromptFromState, createMessageMemory$1 as createMessageMemory, v2_createService as createService, createServiceError$1 as createServiceError, v2_createSettingFromConfig as createSettingFromConfig, v2_createUniqueUuid as createUniqueUuid, v2_decryptObjectValues as decryptObjectValues, decryptStringValue as decryptSecret, v2_decryptStringValue as decryptStringValue, v2_decryptedCharacter as decryptedCharacter, v2_defineService as defineService, v2_elizaLogger as elizaLogger, v2_encryptObjectValues as encryptObjectValues, v2_encryptStringValue as encryptStringValue, v2_encryptedCharacter as encryptedCharacter, v2_findEntityByName as findEntityByName, v2_findWorldsForOwner as findWorldsForOwner, v2_formatActionNames as formatActionNames, v2_formatActions as formatActions, v2_formatEntities as formatEntities, v2_formatMessages as formatMessages, v2_formatPosts as formatPosts, v2_formatTimestamp as formatTimestamp, v2_getEntityDetails as getEntityDetails, getMemoryText$1 as getMemoryText, v2_getSalt as getSalt, getTypedService$1 as getTypedService, v2_getUserServerRole as getUserServerRole, v2_getWorldSettings as getWorldSettings, v2_imageDescriptionTemplate as imageDescriptionTemplate, v2_initializeOnboarding as initializeOnboarding, isCustomMetadata$1 as isCustomMetadata, isDescriptionMetadata$1 as isDescriptionMetadata, isDocumentMemory$1 as isDocumentMemory, isDocumentMetadata$1 as isDocumentMetadata, isFragmentMemory$1 as isFragmentMemory, isFragmentMetadata$1 as isFragmentMetadata, isMessageMetadata$1 as isMessageMetadata, v2_logger as logger, v2_messageHandlerTemplate as messageHandlerTemplate, v2_parseBooleanFromText as parseBooleanFromText, v2_parseJSONObjectFromText as parseJSONObjectFromText, v2_parseKeyValueXml as parseKeyValueXml, v2_postCreationTemplate as postCreationTemplate, v2_safeReplacer as safeReplacer, v2_saltSettingValue as saltSettingValue, v2_saltWorldSettings as saltWorldSettings, v2_shouldRespondTemplate as shouldRespondTemplate, v2_stringToUuid as stringToUuid, v2_trimTokens as trimTokens, v2_truncateToCompleteSentence as truncateToCompleteSentence, v2_unsaltSettingValue as unsaltSettingValue, v2_unsaltWorldSettings as unsaltWorldSettings, v2_updateWorldSettings as updateWorldSettings, v2_validateUuid as validateUuid };
 }
 
-export { type MemoryScope as $, type Action as A, asUUID as B, type Component as C, type ActionExample as D, type Entity as E, ModelType as F, type ServiceTypeRegistry as G, type HandlerCallback as H, type IDatabaseAdapter as I, type ServiceTypeValue as J, type IsValidServiceType as K, type Log as L, type Memory as M, type TypedServiceClass as N, type OnboardingConfig as O, type Participant as P, type ServiceClassMap as Q, type Room as R, type State as S, type Task as T, type UUID as U, type ServiceInstance as V, type World as W, type ServiceRegistry as X, ServiceType as Y, type MemoryTypeAlias as Z, MemoryType as _, type MemoryMetadata as a, type EvaluatorEventPayload as a$, type BaseMetadata as a0, type DocumentMetadata as a1, type FragmentMetadata as a2, type MessageMetadata as a3, type DescriptionMetadata as a4, type CustomMetadata as a5, type MessageExample as a6, type Handler as a7, type Validator as a8, type EvaluationExample as a9, type DeriveKeyAttestationData as aA, type RemoteAttestationMessage as aB, TeeType as aC, type TeeVendorConfig as aD, type TeePluginConfig as aE, type TaskMetadata as aF, type BaseModelParams as aG, type TextGenerationParams as aH, type TextEmbeddingParams as aI, type TokenizeTextParams as aJ, type ImageGenerationParams as aK, type ImageDescriptionParams as aL, type TranscriptionParams as aM, type TextToSpeechParams as aN, type AudioProcessingParams as aO, type VideoProcessingParams as aP, type JSONSchema as aQ, type ObjectGenerationParams as aR, EventType as aS, PlatformPrefix as aT, type EventPayload as aU, type WorldPayload as aV, type EntityPayload as aW, type MessagePayload as aX, type InvokePayload as aY, type RunEventPayload as aZ, type ActionEventPayload as a_, type ProviderResult as aa, type RoomMetadata as ab, type Media as ac, ContentType as ad, type PluginEvents as ae, type ProjectAgent as af, type Project as ag, AgentStatus as ah, type EmbeddingSearchResult as ai, type MemoryRetrievalOptions as aj, type MemorySearchOptions as ak, type MultiRoomMemoryOptions as al, type UnifiedMemoryOptions as am, type UnifiedSearchOptions as an, type KnowledgeItem as ao, KnowledgeScope as ap, CacheKeyPrefix as aq, type DirectoryItem as ar, type ChunkRow as as, type GenerateTextParams as at, type DetokenizeTextParams as au, type TestCase as av, type TestSuite as aw, type TeeAgent as ax, TEEMode as ay, type RemoteAttestationQuote as az, type Relationship as b, updateWorldSettings as b$, type ModelEventPayload as b0, type MessageReceivedHandlerParams as b1, type EventPayloadMap as b2, type EventHandler as b3, SOCKET_MESSAGE_TYPE as b4, type MessageMemory as b5, createMessageMemory as b6, type TypedService as b7, getTypedService as b8, isDocumentMetadata as b9, formatActionNames as bA, formatActions as bB, DatabaseAdapter as bC, findEntityByName as bD, createUniqueUuid as bE, getEntityDetails as bF, formatEntities as bG, logger as bH, elizaLogger as bI, shouldRespondTemplate as bJ, messageHandlerTemplate as bK, postCreationTemplate as bL, booleanFooter as bM, imageDescriptionTemplate as bN, type ServerOwnershipState as bO, getUserServerRole as bP, findWorldsForOwner as bQ, Semaphore as bR, AgentRuntime as bS, decryptStringValue as bT, createSettingFromConfig as bU, getSalt as bV, encryptStringValue as bW, saltSettingValue as bX, unsaltSettingValue as bY, saltWorldSettings as bZ, unsaltWorldSettings as b_, isFragmentMetadata as ba, isMessageMetadata as bb, isDescriptionMetadata as bc, isCustomMetadata as bd, type ServiceError as be, isDocumentMemory as bf, isFragmentMemory as bg, getMemoryText as bh, createServiceError as bi, type StateValue as bj, type StateObject as bk, type StateArray as bl, type EnhancedState as bm, type ComponentData as bn, type EventDataObject as bo, type TypedEventHandler as bp, type DbConnection as bq, type MetadataObject as br, type ServiceConfig as bs, VECTOR_DIMS as bt, type ControlMessage as bu, ServiceBuilder$1 as bv, createService$1 as bw, type ServiceDefinition$1 as bx, defineService$1 as by, composeActionExamples as bz, type Agent as c, getWorldSettings as c0, initializeOnboarding as c1, encryptedCharacter as c2, decryptedCharacter as c3, encryptObjectValues as c4, decryptObjectValues as c5, composePrompt as c6, composePromptFromState as c7, addHeader as c8, formatPosts as c9, formatMessages as ca, formatTimestamp as cb, validateUuid as cc, stringToUuid as cd, truncateToCompleteSentence as ce, parseKeyValueXml as cf, parseJSONObjectFromText as cg, parseBooleanFromText as ch, safeReplacer as ci, trimTokens as cj, ServiceBuilder as ck, createService as cl, type ServiceDefinition as cm, defineService as cn, type IAgentRuntime as d, Role as e, Service as f, type Character as g, type Evaluator as h, type Provider as i, type Plugin as j, type ServiceTypeName as k, type ModelHandler as l, type Route as m, type RuntimeSettings as n, ChannelType as o, type ModelTypeName as p, type ModelResultMap as q, type ModelParamsMap as r, type TaskWorker as s, type SendHandlerFunction as t, type TargetInfo as u, type Content as v, type Setting as w, type WorldSettings as x, type TemplateType as y, v2 as z };
+export { type MessageMetadata as $, type Action as A, asUUID as B, type Component as C, type Media as D, type Entity as E, ContentType as F, type StateValue as G, type HandlerCallback as H, type IDatabaseAdapter as I, type StateObject as J, type StateArray as K, type Log as L, type Memory as M, type EnhancedState as N, type OnboardingConfig as O, type Participant as P, type MemoryTypeAlias as Q, type Room as R, Service as S, type Task as T, type UUID as U, MemoryType as V, type World as W, type MemoryScope as X, type BaseMetadata as Y, type DocumentMetadata as Z, type FragmentMetadata as _, type MemoryMetadata as a, type DbConnection as a$, type DescriptionMetadata as a0, type CustomMetadata as a1, type MessageMemory as a2, createMessageMemory as a3, isDocumentMetadata as a4, isFragmentMetadata as a5, isMessageMetadata as a6, isDescriptionMetadata as a7, isCustomMetadata as a8, isDocumentMemory as a9, ServiceType as aA, type TypedService as aB, getTypedService as aC, type ServiceError as aD, createServiceError as aE, type ServiceConfig as aF, ModelType as aG, type GenerateTextParams as aH, type DetokenizeTextParams as aI, type BaseModelParams as aJ, type TextGenerationParams as aK, type TextEmbeddingParams as aL, type TokenizeTextParams as aM, type ImageGenerationParams as aN, type ImageDescriptionParams as aO, type TranscriptionParams as aP, type TextToSpeechParams as aQ, type AudioProcessingParams as aR, type VideoProcessingParams as aS, type JSONSchema as aT, type ObjectGenerationParams as aU, type EmbeddingSearchResult as aV, type MemoryRetrievalOptions as aW, type MemorySearchOptions as aX, type MultiRoomMemoryOptions as aY, type UnifiedMemoryOptions as aZ, type UnifiedSearchOptions as a_, isFragmentMemory as aa, getMemoryText as ab, type KnowledgeItem as ac, KnowledgeScope as ad, CacheKeyPrefix as ae, type DirectoryItem as af, type ChunkRow as ag, type RoomMetadata as ah, type ComponentData as ai, type MessageExample as aj, AgentStatus as ak, type ActionExample as al, type Handler as am, type Validator as an, type EvaluationExample as ao, type ProviderResult as ap, type PluginEvents as aq, type ProjectAgent as ar, type Project as as, type ServiceTypeRegistry as at, type ServiceTypeValue as au, type IsValidServiceType as av, type TypedServiceClass as aw, type ServiceClassMap as ax, type ServiceInstance as ay, type ServiceRegistry as az, type Relationship as b, composePromptFromState as b$, type MetadataObject as b0, VECTOR_DIMS as b1, EventType as b2, PlatformPrefix as b3, type EventPayload as b4, type WorldPayload as b5, type EntityPayload as b6, type MessagePayload as b7, type InvokePayload as b8, type RunEventPayload as b9, elizaLogger as bA, shouldRespondTemplate as bB, messageHandlerTemplate as bC, postCreationTemplate as bD, booleanFooter as bE, imageDescriptionTemplate as bF, type ServerOwnershipState as bG, getUserServerRole as bH, findWorldsForOwner as bI, Semaphore as bJ, AgentRuntime as bK, decryptStringValue as bL, createSettingFromConfig as bM, getSalt as bN, encryptStringValue as bO, saltSettingValue as bP, unsaltSettingValue as bQ, saltWorldSettings as bR, unsaltWorldSettings as bS, updateWorldSettings as bT, getWorldSettings as bU, initializeOnboarding as bV, encryptedCharacter as bW, decryptedCharacter as bX, encryptObjectValues as bY, decryptObjectValues as bZ, composePrompt as b_, type ActionEventPayload as ba, type EvaluatorEventPayload as bb, type ModelEventPayload as bc, type MessageReceivedHandlerParams as bd, type EventPayloadMap as be, type EventHandler as bf, type EventDataObject as bg, type TypedEventHandler as bh, type TaskMetadata as bi, SOCKET_MESSAGE_TYPE as bj, type ControlMessage as bk, type TestCase as bl, type TestSuite as bm, ServiceBuilder$1 as bn, createService$1 as bo, type ServiceDefinition$1 as bp, defineService$1 as bq, composeActionExamples as br, formatActionNames as bs, formatActions as bt, DatabaseAdapter as bu, findEntityByName as bv, createUniqueUuid as bw, getEntityDetails as bx, formatEntities as by, logger as bz, type Agent as c, addHeader as c0, formatPosts as c1, formatMessages as c2, formatTimestamp as c3, validateUuid as c4, stringToUuid as c5, truncateToCompleteSentence as c6, parseKeyValueXml as c7, parseJSONObjectFromText as c8, parseBooleanFromText as c9, safeReplacer as ca, trimTokens as cb, ServiceBuilder as cc, createService as cd, type ServiceDefinition as ce, defineService as cf, type IAgentRuntime as d, type State as e, Role as f, type Character as g, type Evaluator as h, type Provider as i, type Plugin as j, type ServiceTypeName as k, type ModelHandler as l, type Route as m, type RuntimeSettings as n, ChannelType as o, type ModelTypeName as p, type ModelResultMap as q, type ModelParamsMap as r, type TaskWorker as s, type SendHandlerFunction as t, type TargetInfo as u, type Content as v, type Setting as w, type WorldSettings as x, type TemplateType as y, v2 as z };