@elizaos/core 1.0.6 → 1.0.8

package/dist/index.d.ts

@@ -1,11 +1,10 @@
-import { A as Action, I as IDatabaseAdapter, U as UUID, E as Entity, C as Component, M as Memory, L as Log, a as MemoryMetadata, W as World, R as Room, P as Participant, b as Relationship, c as Agent, T as Task, d as IAgentRuntime, S as State, e as Role, f as Service, g as Character, h as Evaluator, i as Provider, j as Plugin, k as ServiceTypeName, l as ModelHandler, m as Route, n as RuntimeSettings, H as HandlerCallback, o as ChannelType, p as ModelTypeName, q as ModelResultMap, r as ModelParamsMap, s as TaskWorker, t as SendHandlerFunction, u as TargetInfo, v as Content, w as Setting, x as WorldSettings, O as OnboardingConfig, y as TemplateType, z as v2 } from './index-S6eSMHDH.js';
-export { a_ as ActionEventPayload, D as ActionExample, ah as AgentStatus, aO as AudioProcessingParams, a0 as BaseMetadata, aG as BaseModelParams, aq as CacheKeyPrefix, as as ChunkRow, bn as ComponentData, ad as ContentType, bu as ControlMessage, a5 as CustomMetadata, bq as DbConnection, aA as DeriveKeyAttestationData, a4 as DescriptionMetadata, au as DetokenizeTextParams, ar as DirectoryItem, a1 as DocumentMetadata, ai as EmbeddingSearchResult, bm as EnhancedState, aW as EntityPayload, a9 as EvaluationExample, a$ as EvaluatorEventPayload, bo as EventDataObject, b3 as EventHandler, aU as EventPayload, b2 as EventPayloadMap, aS as EventType, a2 as FragmentMetadata, at as GenerateTextParams, a7 as Handler, aL as ImageDescriptionParams, aK as ImageGenerationParams, aY as InvokePayload, K as IsValidServiceType, aQ as JSONSchema, ao as KnowledgeItem, ap as KnowledgeScope, ac as Media, aj as MemoryRetrievalOptions, $ as MemoryScope, ak as MemorySearchOptions, _ as MemoryType, Z as MemoryTypeAlias, a6 as MessageExample, b5 as MessageMemory, a3 as MessageMetadata, aX as MessagePayload, b1 as MessageReceivedHandlerParams, br as MetadataObject, b0 as ModelEventPayload, F as ModelType, al as MultiRoomMemoryOptions, aR as ObjectGenerationParams, aT as PlatformPrefix, ae as PluginEvents, ag as Project, af as ProjectAgent, aa as ProviderResult, aB as RemoteAttestationMessage, az as RemoteAttestationQuote, ab as RoomMetadata, aZ as RunEventPayload, b4 as SOCKET_MESSAGE_TYPE, bv as ServiceBuilder, Q as ServiceClassMap, bs as ServiceConfig, bx as ServiceDefinition, be as ServiceError, V as ServiceInstance, X as ServiceRegistry, Y as ServiceType, G as ServiceTypeRegistry, J as ServiceTypeValue, bl as StateArray, bk as StateObject, bj as StateValue, ay as TEEMode, aF as TaskMetadata, ax as TeeAgent, aE as TeePluginConfig, aC as TeeType, aD as TeeVendorConfig, av as TestCase, aw as TestSuite, aI as TextEmbeddingParams, aH as TextGenerationParams, aN as TextToSpeechParams, aJ as TokenizeTextParams, aM as TranscriptionParams, bp as TypedEventHandler, b7 as TypedService, N as TypedServiceClass, am as UnifiedMemoryOptions, an as UnifiedSearchOptions, bt as VECTOR_DIMS, a8 as Validator, aP as VideoProcessingParams, aV as WorldPayload, B as asUUID, b6 as createMessageMemory, bw as createService, bi as createServiceError, by as defineService, bh as getMemoryText, b8 as getTypedService, bd as isCustomMetadata, bc as isDescriptionMetadata, bf as isDocumentMemory, b9 as isDocumentMetadata, bg as isFragmentMemory, ba as isFragmentMetadata, bb as isMessageMetadata } from './index-S6eSMHDH.js';
+import { M as Metadata, S as Service, A as Action, I as IDatabaseAdapter, U as UUID, E as Entity, C as Component, a as Memory, L as Log, b as MemoryMetadata, W as World, R as Room, P as Participant, c as Relationship, d as Agent, T as Task, e as IAgentRuntime, f as State, g as Role, h as Character, i as Evaluator, j as Provider, k as Plugin, l as ServiceTypeName, m as ModelHandler, n as Route, o as RuntimeSettings, H as HandlerCallback, p as ChannelType, q as ModelTypeName, r as ModelResultMap, s as ModelParamsMap, t as TaskWorker, u as SendHandlerFunction, v as TargetInfo, w as Content, x as Setting, y as WorldSettings, O as OnboardingConfig, z as TemplateType, B as v2 } from './index-C7vN6HiA.js';
+export { b9 as ActionEventPayload, al as ActionExample, ak as AgentStatus, aQ as AudioProcessingParams, Z as BaseMetadata, aI as BaseModelParams, af as CacheKeyPrefix, b6 as ChannelClearedPayload, ah as ChunkRow, G as ContentType, bi as ControlMessage, a2 as CustomMetadata, a_ as DbConnection, a1 as DescriptionMetadata, aH as DetokenizeTextParams, ag as DirectoryItem, _ as DocumentMetadata, aU as EmbeddingSearchResult, Q as EnhancedState, b4 as EntityPayload, ao as EvaluationExample, ba as EvaluatorEventPayload, be as EventHandler, b2 as EventPayload, bd as EventPayloadMap, b0 as EventType, $ as FragmentMetadata, aG as GenerateTextParams, am as Handler, aN as ImageDescriptionParams, aM as ImageGenerationParams, b7 as InvokePayload, av as IsValidServiceType, aS as JSONSchema, ad as KnowledgeItem, ae as KnowledgeScope, F as Media, aV as MemoryRetrievalOptions, Y as MemoryScope, aW as MemorySearchOptions, X as MemoryType, V as MemoryTypeAlias, aj as MessageExample, a3 as MessageMemory, a0 as MessageMetadata, b5 as MessagePayload, bc as MessageReceivedHandlerParams, bb as ModelEventPayload, aF as ModelType, aX as MultiRoomMemoryOptions, aT as ObjectGenerationParams, b1 as PlatformPrefix, aq as PluginEvents, as as Project, ar as ProjectAgent, ap as ProviderResult, ai as RoomMetadata, b8 as RunEventPayload, bh as SOCKET_MESSAGE_TYPE, bl as ServiceBuilder, ax as ServiceClassMap, bn as ServiceDefinition, aD as ServiceError, ay as ServiceInstance, az as ServiceRegistry, aA as ServiceType, at as ServiceTypeRegistry, au as ServiceTypeValue, N as StateArray, K as StateObject, J as StateValue, bg as TaskMetadata, bj as TestCase, bk as TestSuite, aK as TextEmbeddingParams, aJ as TextGenerationParams, aP as TextToSpeechParams, aL as TokenizeTextParams, aO as TranscriptionParams, bf as TypedEventHandler, aB as TypedService, aw as TypedServiceClass, aY as UnifiedMemoryOptions, aZ as UnifiedSearchOptions, a$ as VECTOR_DIMS, an as Validator, aR as VideoProcessingParams, b3 as WorldPayload, D as asUUID, a4 as createMessageMemory, bm as createService, aE as createServiceError, bo as defineService, ac as getMemoryText, aC as getTypedService, a9 as isCustomMetadata, a8 as isDescriptionMetadata, aa as isDocumentMemory, a5 as isDocumentMetadata, ab as isFragmentMemory, a6 as isFragmentMetadata, a7 as isMessageMetadata } from './index-C7vN6HiA.js';
 import * as pino from 'pino';
-import { Tracer, Meter, Span, Context } from '@opentelemetry/api';
 import * as browser from '@sentry/browser';
 export { browser as Sentry };
 export { i as v1 } from './index-BHW44X0A.js';
-import './types-D9v-eW3g.js';
+import './types-szUq9-0V.js';
 import './specs/v1/messages.js';
 import './specs/v1/types.js';
 import 'stream';
@@ -17,6 +16,333 @@ import './specs/v1/actionExample.js';
 import './specs/v1/provider.js';
 import './specs/v1/templates.js';
 
+/**
+ * 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 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?: Metadata;
+}
+
+/**
+ * A standardized representation of a token holding.
+ */
+interface TokenBalance {
+    address: string;
+    balance: string;
+    decimals: number;
+    uiAmount?: number;
+    name?: string;
+    symbol?: string;
+    logoURI?: string;
+}
+/**
+ * Generic representation of token data that can be provided by various services.
+ */
+interface TokenData {
+    id: string;
+    symbol: string;
+    name: string;
+    address: string;
+    chain: string;
+    sourceProvider: string;
+    price?: number;
+    priceChange24hPercent?: number;
+    priceChange24hUSD?: number;
+    volume24hUSD?: number;
+    marketCapUSD?: number;
+    liquidity?: number;
+    holders?: number;
+    logoURI?: string;
+    decimals?: number;
+    lastUpdatedAt?: Date;
+    raw?: any;
+}
+/**
+ * Interface for a generic service that provides token data.
+ */
+declare abstract class ITokenDataService extends Service {
+    static readonly serviceType: "token_data";
+    readonly capabilityDescription: string;
+    /**
+     * Fetches detailed information for a single token.
+     * @param address The token's contract address.
+     * @param chain The blockchain the token resides on.
+     * @returns A Promise resolving to TokenData or null if not found.
+     */
+    abstract getTokenDetails(address: string, chain: string): Promise<TokenData | null>;
+    /**
+     * Fetches a list of trending tokens.
+     * @param chain Optional: Filter by a specific blockchain.
+     * @param limit Optional: Number of tokens to return. Defaults to a service-specific value.
+     * @param timePeriod Optional: Time period for trending data (e.g., '24h', '7d'). Defaults to service-specific.
+     * @returns A Promise resolving to an array of TokenData.
+     */
+    abstract getTrendingTokens(chain?: string, limit?: number, timePeriod?: string): Promise<TokenData[]>;
+    /**
+     * Searches for tokens based on a query string.
+     * @param query The search query (e.g., symbol, name, address).
+     * @param chain Optional: Filter by a specific blockchain.
+     * @param limit Optional: Number of results to return.
+     * @returns A Promise resolving to an array of TokenData.
+     */
+    abstract searchTokens(query: string, chain?: string, limit?: number): Promise<TokenData[]>;
+    /**
+     * Fetches data for multiple tokens by their addresses on a specific chain.
+     * @param addresses Array of token contract addresses.
+     * @param chain The blockchain the tokens reside on.
+     * @returns A Promise resolving to an array of TokenData. May not include all requested if some are not found.
+     */
+    abstract getTokensByAddresses(addresses: string[], chain: string): Promise<TokenData[]>;
+}
+
+/**
+ * Represents a single asset holding within a wallet, including its value.
+ * This extends a generic TokenBalance with wallet-specific valuation.
+ */
+interface WalletAsset extends TokenBalance {
+    priceUsd?: number;
+    valueUsd?: number;
+}
+/**
+ * Represents the entire portfolio of assets in a wallet.
+ */
+interface WalletPortfolio {
+    totalValueUsd: number;
+    assets: WalletAsset[];
+}
+/**
+ * Abstract interface for a Wallet Service.
+ * Plugins that provide wallet functionality (e.g., for Solana, EVM) should implement this service.
+ * It provides a standardized way for other plugins to query the state of a wallet.
+ */
+declare abstract class IWalletService extends Service {
+    static readonly serviceType: "wallet";
+    readonly capabilityDescription = "Provides standardized access to wallet balances and portfolios.";
+    /**
+     * Retrieves the entire portfolio of assets held by the wallet.
+     * @param owner - Optional: The specific wallet address/owner to query if the service manages multiple.
+     * @returns A promise that resolves to the wallet's portfolio.
+     */
+    abstract getPortfolio(owner?: string): Promise<WalletPortfolio>;
+    /**
+     * Retrieves the balance of a specific asset in the wallet.
+     * @param assetAddress - The mint address or native identifier of the asset.
+     * @param owner - Optional: The specific wallet address/owner to query.
+     * @returns A promise that resolves to the user-friendly (decimal-adjusted) balance of the asset held.
+     */
+    abstract getBalance(assetAddress: string, owner?: string): Promise<number>;
+    /**
+     * Transfers SOL from a specified keypair to a given public key.
+     * This is a low-level function primarily for Solana-based wallet services.
+     * @param from - The Keypair of the sender.
+     * @param to - The PublicKey of the recipient.
+     * @param lamports - The amount in lamports to transfer.
+     * @returns A promise that resolves with the transaction signature.
+     */
+    abstract transferSol(from: any, to: any, lamports: number): Promise<string>;
+}
+
+/**
+ * A standardized representation of a liquidity pool from any DEX.
+ */
+type PoolInfo = {
+    id: string;
+    displayName?: string;
+    dex: string;
+    tokenA: {
+        mint: string;
+        symbol?: string;
+        reserve?: string;
+        decimals?: number;
+    };
+    tokenB: {
+        mint: string;
+        symbol?: string;
+        reserve?: string;
+        decimals?: number;
+    };
+    lpTokenMint?: string;
+    apr?: number;
+    apy?: number;
+    tvl?: number;
+    fee?: number;
+    metadata?: Metadata;
+};
+/**
+ * A standardized representation of a user's position in a liquidity pool.
+ */
+type LpPositionDetails = {
+    poolId: string;
+    dex: string;
+    lpTokenBalance: TokenBalance;
+    underlyingTokens: TokenBalance[];
+    valueUsd?: number;
+    accruedFees?: TokenBalance[];
+    rewards?: TokenBalance[];
+    metadata?: Metadata;
+};
+/**
+ * A standardized result for blockchain transactions.
+ */
+type TransactionResult = {
+    success: boolean;
+    transactionId?: string;
+    error?: string;
+    data?: any;
+};
+/**
+ * Abstract interface for a Liquidity Pool Service.
+ * DEX-specific plugins (e.g., for Orca, Raydium) must implement this service
+ * to allow the LP Manager to interact with them in a standardized way.
+ */
+declare abstract class ILpService extends Service {
+    static readonly serviceType = "lp";
+    readonly capabilityDescription = "Provides standardized access to DEX liquidity pools.";
+    /**
+     * Returns the name of the DEX this service interacts with.
+     * @returns The name of the DEX (e.g., "Orca", "Raydium").
+     */
+    abstract getDexName(): string;
+    /**
+     * Fetches a list of available liquidity pools from the DEX.
+     * @param tokenAMint - Optional: Filter pools by the mint address of the first token.
+     * @param tokenBMint - Optional: Filter pools by the mint address of the second token.
+     * @returns A promise that resolves to an array of standardized PoolInfo objects.
+     */
+    abstract getPools(tokenAMint?: string, tokenBMint?: string): Promise<PoolInfo[]>;
+    /**
+     * Adds liquidity to a specified pool.
+     * @param params - The parameters for adding liquidity.
+     * @returns A promise resolving to a transaction result, including the LP tokens received.
+     */
+    abstract addLiquidity(params: {
+        userVault: any;
+        poolId: string;
+        tokenAAmountLamports: string;
+        tokenBAmountLamports?: string;
+        slippageBps: number;
+        tickLowerIndex?: number;
+        tickUpperIndex?: number;
+    }): Promise<TransactionResult & {
+        lpTokensReceived?: TokenBalance;
+    }>;
+    /**
+     * Removes liquidity from a specified pool.
+     * @param params - The parameters for removing liquidity.
+     * @returns A promise resolving to a transaction result, including the tokens received.
+     */
+    abstract removeLiquidity(params: {
+        userVault: any;
+        poolId: string;
+        lpTokenAmountLamports: string;
+        slippageBps: number;
+    }): Promise<TransactionResult & {
+        tokensReceived?: TokenBalance[];
+    }>;
+    /**
+     * Fetches the details of a specific LP position for a user.
+     * @param userAccountPublicKey - The user's wallet public key.
+     * @param poolOrPositionIdentifier - The identifier for the pool or a specific position (e.g., position NFT mint).
+     * @returns A promise resolving to the position details or null if not found.
+     */
+    abstract getLpPositionDetails(userAccountPublicKey: string, poolOrPositionIdentifier: string): Promise<LpPositionDetails | null>;
+    /**
+     * Fetches the latest market data (e.g., APY, TVL) for a list of pools.
+     * @param poolIds - An array of pool IDs to fetch data for.
+     * @returns A promise resolving to a map of pool IDs to their partial market data.
+     */
+    abstract getMarketDataForPools(poolIds: string[]): Promise<Record<string, Partial<PoolInfo>>>;
+}
+
 /**
  * Composes a set of example conversations based on provided actions and a specified count.
  * It randomly selects examples from the provided actions and formats them with generated names.
@@ -55,11 +381,27 @@ declare abstract class DatabaseAdapter<DB = unknown> implements IDatabaseAdapter
      * The database instance.
      */
     db: DB;
+    /**
+     * Initialize the database adapter.
+     * @returns A Promise that resolves when initialization is complete.
+     */
+    abstract initialize(config?: any): Promise<void>;
     /**
      * Initialize the database adapter.
      * @returns A Promise that resolves when initialization is complete.
      */
     abstract init(): Promise<void>;
+    /**
+     * Run database migrations
+     * @param migrationsPaths Optional array of paths to migration folders
+     * @returns A Promise that resolves when migrations are complete.
+     */
+    abstract runMigrations(migrationsPaths?: string[]): Promise<void>;
+    /**
+     * Check if the database connection is ready.
+     * @returns A Promise that resolves to true if the database is ready, false otherwise.
+     */
+    abstract isReady(): Promise<boolean>;
     /**
      * Optional close method for the database adapter.
      * @returns A Promise that resolves when closing is complete.
@@ -239,6 +581,12 @@ declare abstract class DatabaseAdapter<DB = unknown> implements IDatabaseAdapter
      * @returns A Promise that resolves when the memory has been removed.
      */
     abstract deleteMemory(memoryId: UUID): Promise<void>;
+    /**
+     * Removes multiple memories from the database in a single batch operation.
+     * @param memoryIds An array of UUIDs of the memories to remove.
+     * @returns A Promise that resolves when all memories have been removed.
+     */
+    abstract deleteManyMemories(memoryIds: UUID[]): Promise<void>;
     /**
      * Removes all memories associated with a specific room.
      * @param roomId The UUID of the room whose memories should be removed.
@@ -423,12 +771,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): 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>): Promise<Agent>;
     /**
      * Ensures an embedding dimension exists in the database.
      * @param dimension The dimension to ensure exists.
@@ -558,7 +900,7 @@ declare let logger: pino.Logger<string, boolean>;
 declare const elizaLogger: pino.Logger<string, boolean>;
 
 declare const shouldRespondTemplate = "<task>Decide on behalf of {{agentName}} whether they should respond to the message, ignore it or stop the conversation.</task>\n\n<providers>\n{{providers}}\n</providers>\n\n<instructions>Decide if {{agentName}} should respond to or interact with the conversation.\nIf the message is directed at or relevant to {{agentName}}, respond with RESPOND action.\nIf a user asks {{agentName}} to be quiet, respond with STOP action.\nIf {{agentName}} should ignore the message, respond with IGNORE action.</instructions>\n\n<output>\nDo NOT include any thinking, reasoning, or <think> sections in your response. \nGo directly to the XML response format without any preamble or explanation.\n\nRespond using XML format like this:\n<response>\n  <name>{{agentName}}</name>\n  <reasoning>Your reasoning here</reasoning>\n  <action>RESPOND | IGNORE | STOP</action>\n</response>\n\nIMPORTANT: Your response must ONLY contain the <response></response> XML block above. Do not include any text, thinking, or reasoning before or after this XML block. Start your response immediately with <response> and end with </response>.\n</output>";
-declare const messageHandlerTemplate = "<task>Generate dialog and actions for the character {{agentName}}.</task>\n\n<providers>\n{{providers}}\n</providers>\n\nThese are the available valid actions:\n<actionNames>\n{{actionNames}}\n</actionNames>\n\n<instructions>\nWrite a thought and plan for {{agentName}} and decide what actions to take. Also include the providers that {{agentName}} will use to have the right context for responding and acting, if any.\n\nIMPORTANT PROVIDER SELECTION RULES:\n- If the message mentions images, photos, pictures, attachments, or visual content, OR if you see \"(Attachments:\" in the conversation, you MUST include \"ATTACHMENTS\" in your providers list\n- If the message asks about or references specific people, include \"ENTITIES\" in your providers list  \n- If the message asks about relationships or connections between people, include \"RELATIONSHIPS\" in your providers list\n- If the message asks about facts or specific information, include \"FACTS\" in your providers list\n- If the message asks about the environment or world context, include \"WORLD\" in your providers list\n- If you need external knowledge, information, or context beyond the current conversation to provide a helpful response, include \"KNOWLEDGE\" in your providers list\n\nFirst, think about what you want to do next and plan your actions. Then, write the next message and include the actions you plan to take.\n</instructions>\n\n<keys>\n\"thought\" should be a short description of what the agent is thinking about and planning.\n\"actions\" should be a comma-separated list of the actions {{agentName}} plans to take based on the thought (if none, use IGNORE, if simply responding with text, use REPLY)\n\"providers\" should be a comma-separated list of the providers that {{agentName}} will use to have the right context for responding and acting (NEVER use \"IGNORE\" as a provider - use specific provider names like ATTACHMENTS, ENTITIES, FACTS, KNOWLEDGE, etc.)\n\"evaluators\" should be an optional comma-separated list of the evaluators that {{agentName}} will use to evaluate the conversation after responding\n\"text\" should be the text of the next message for {{agentName}} which they will send to the conversation.\n</keys>\n\n<output>\nDo NOT include any thinking, reasoning, or <think> sections in your response. \nGo directly to the XML response format without any preamble or explanation.\n\nRespond using XML format like this:\n<response>\n    <thought>Your thought here</thought>\n    <actions>ACTION1,ACTION2</actions>\n    <providers>PROVIDER1,PROVIDER2</providers>\n    <text>Your response text here</text>\n</response>\n\nIMPORTANT: Your response must ONLY contain the <response></response> XML block above. Do not include any text, thinking, or reasoning before or after this XML block. Start your response immediately with <response> and end with </response>.\n</output>";
+declare const messageHandlerTemplate = "<task>Generate dialog and actions for the character {{agentName}}.</task>\n\n<providers>\n{{providers}}\n</providers>\n\nThese are the available valid actions:\n<actionNames>\n{{actionNames}}\n</actionNames>\n\n<instructions>\nAnalyze the message and create a response plan for {{agentName}}.\n\nSTEP 1 - DETERMINE RESPONSE TYPE:\n- SIMPLE RESPONSE: If you only need to send a text reply without any tools, data lookups, or complex operations\n  \u2192 Use only REPLY action with no providers\n  \u2192 This is the preferred path for basic conversations\n  \u2192 Do NOT use this for questions that require checking stored knowledge!\n  \n- COMPLEX RESPONSE: If you need to:\n  \u2192 Use external tools or services (CALL_TOOL, etc.)\n  \u2192 Look up specific information (needs providers like KNOWLEDGE, ATTACHMENTS, etc.)\n  \u2192 Answer questions about what you know or might know (ALWAYS check KNOWLEDGE first!)\n  \u2192 Perform multiple operations\n  \u2192 Update data or settings\n\nSTEP 2 - PROVIDER SELECTION (for complex responses):\nIMPORTANT PROVIDER SELECTION RULES:\n- If the message mentions images, photos, pictures, attachments, or visual content, OR if you see \"(Attachments:\" in the conversation, you MUST include \"ATTACHMENTS\" in your providers list\n- If the message asks about or references specific people, include \"ENTITIES\" in your providers list  \n- If the message asks about relationships or connections between people, include \"RELATIONSHIPS\" in your providers list\n- If the message asks about facts or specific information, include \"FACTS\" in your providers list\n- If the message asks about the environment or world context, include \"WORLD\" in your providers list\n- **CRITICAL: If the message asks \"do you know\", \"who created\", \"what is\", \"tell me about\", or ANY question that might be answered by stored knowledge, you MUST include \"KNOWLEDGE\" in your providers list. Always check KNOWLEDGE before saying you don't know something!**\n- Some actions may require specific providers (this will be clear from the action's purpose)\n\nREMEMBER: It's better to check providers and find nothing than to assume you don't have information without checking!\n\nSTEP 3 - ACTION PLANNING:\nFor complex responses, consider the order of actions:\n- If using tools (CALL_TOOL, etc.): First REPLY to acknowledge the request (e.g., \"Let me check that for you\"), then execute the tool action\n- Tool actions often handle their own responses, so you may not need a final REPLY after them\n- Actions should flow logically: acknowledge \u2192 gather data \u2192 process \u2192 respond\n\nThink about your response as a plan:\n1. What is the user asking for?\n2. Do I need any additional context or data? (providers)\n3. What actions do I need to take and in what order?\n4. How will I communicate the results?\n</instructions>\n\n<output_format>\nFirst, think about what you want to do and create your plan.\n\nFor SIMPLE responses (text-only reply):\n- Set thought to explain your reasoning\n- Set actions to [\"REPLY\"]\n- Leave providers empty or set to []\n- Set text to your response message\n\nFor COMPLEX responses (using tools/providers):\n- Set thought to explain your plan and reasoning\n- Set actions in the order they should execute (e.g., [\"REPLY\", \"CALL_TOOL\"])\n- Set providers to gather needed context\n- Set text for your initial response (if using REPLY first)\n\nRemember: Some actions like CALL_TOOL will send their own responses, so plan accordingly.\n</output_format>\n\n<response>\n    <thought>User asking if I know something - must check KNOWLEDGE provider first before saying I don't know</thought>\n    <actions>REPLY</actions>\n    <providers>KNOWLEDGE</providers>\n    <text>Let me check if I have any information about Roxane's creator...</text>\n</response>\n</examples>\n\n<keys>\n\"thought\" should be a short description of what the agent is thinking about and their plan\n\"actions\" should be a comma-separated list of the actions {{agentName}} plans to take in order (if none, use IGNORE, if simply responding with text, use REPLY)\n\"providers\" should be a comma-separated list of the providers that {{agentName}} will use to have the right context for responding and acting (leave empty for simple responses)\n\"evaluators\" should be an optional comma-separated list of the evaluators that {{agentName}} will use to evaluate the conversation after responding\n\"text\" should be the text of the next message for {{agentName}} (used with REPLY action)\n</keys>\n\n<output>\nDo NOT include any thinking, reasoning, or <think> sections in your response. \nGo directly to the XML response format without any preamble or explanation.\n\nRespond using XML format like this:\n<response>\n    <thought>Your thought here</thought>\n    <actions>ACTION1,ACTION2</actions>\n    <providers>PROVIDER1,PROVIDER2</providers>\n    <text>Your response text here</text>\n</response>\n\nIMPORTANT: Your response must ONLY contain the <response></response> XML block above. Do not include any text, thinking, or reasoning before or after this XML block. Start your response immediately with <response> and end with </response>.\n</output>";
 declare const postCreationTemplate = "# Task: Create a post in the voice and style and perspective of {{agentName}} @{{twitterUserName}}.\n\nExample task outputs:\n1. A post about the importance of AI in our lives\n<response>\n  <thought>I am thinking about writing a post about the importance of AI in our lives</thought>\n  <post>AI is changing the world and it is important to understand how it works</post>\n  <imagePrompt>A futuristic cityscape with flying cars and people using AI to do things</imagePrompt>\n</response>\n\n2. A post about dogs\n<response>\n  <thought>I am thinking about writing a post about dogs</thought>\n  <post>Dogs are man's best friend and they are loyal and loving</post>\n  <imagePrompt>A dog playing with a ball in a park</imagePrompt>\n</response>\n\n3. A post about finding a new job\n<response>\n  <thought>Getting a job is hard, I bet there's a good tweet in that</thought>\n  <post>Just keep going!</post>\n  <imagePrompt>A person looking at a computer screen with a job search website</imagePrompt>\n</response>\n\n{{providers}}\n\nWrite a post that is {{adjective}} about {{topic}} (without mentioning {{topic}} directly), from the perspective of {{agentName}}. Do not add commentary or acknowledge this request, just write the post.\nYour response should be 1, 2, or 3 sentences (choose the length at random).\nYour response should not contain any questions. Brief, concise statements only. The total character count MUST be less than 280. No emojis. Use \\n\\n (double spaces) between statements if there are multiple statements in your response.\n\nYour output should be formatted in XML like this:\n<response>\n  <thought>Your thought here</thought>\n  <post>Your post text here</post>\n  <imagePrompt>Optional image prompt here</imagePrompt>\n</response>\n\nThe \"post\" field should be the post you want to send. Do not including any thinking or internal reflection in the \"post\" field.\nThe \"imagePrompt\" field is optional and should be a prompt for an image that is relevant to the post. It should be a single sentence that captures the essence of the post. ONLY USE THIS FIELD if it makes sense that the post would benefit from an image.\nThe \"thought\" field should be a short description of what the agent is thinking about before responding, inlcuding a brief justification for the response. Includate an explanation how the post is relevant to the topic but unique and different than other posts.\n\nDo NOT include any thinking, reasoning, or <think> sections in your response. \nGo directly to the XML response format without any preamble or explanation.\n\nIMPORTANT: Your response must ONLY contain the <response></response> XML block above. Do not include any text, thinking, or reasoning before or after this XML block. Start your response immediately with <response> and end with </response>.";
 declare const booleanFooter = "Respond with only a YES or a NO.";
 declare const imageDescriptionTemplate = "<task>Analyze the provided image and generate a comprehensive description with multiple levels of detail.</task>\n\n<instructions>\nCarefully examine the image and provide:\n1. A concise, descriptive title that captures the main subject or scene\n2. A brief summary description (1-2 sentences) highlighting the key elements\n3. An extensive, detailed description that covers all visible elements, composition, lighting, colors, mood, and any other relevant details\n\nBe objective and descriptive. Focus on what you can actually see in the image rather than making assumptions about context or meaning.\n</instructions>\n\n<output>\nDo NOT include any thinking, reasoning, or <think> sections in your response. \nGo directly to the XML response format without any preamble or explanation.\n\nRespond using XML format like this:\n<response>\n  <title>A concise, descriptive title for the image</title>\n  <description>A brief 1-2 sentence summary of the key elements in the image</description>\n  <text>An extensive, detailed description covering all visible elements, composition, lighting, colors, mood, setting, objects, people, activities, and any other relevant details you can observe in the image</text>\n</response>\n\nIMPORTANT: Your response must ONLY contain the <response></response> XML block above. Do not include any text, thinking, or reasoning before or after this XML block. Start your response immediately with <response> and end with </response>.\n</output>";
@@ -592,41 +934,6 @@ declare function getUserServerRole(runtime: IAgentRuntime, entityId: string, ser
  */
 declare function findWorldsForOwner(runtime: IAgentRuntime, entityId: string): Promise<World[] | null>;
 
-interface InstrumentationConfig {
-    serviceName?: string;
-    otlpEndpoint?: string;
-    enabled?: boolean;
-}
-interface IInstrumentationService {
-    readonly name: string;
-    readonly capabilityDescription: string;
-    instrumentationConfig: InstrumentationConfig;
-    isEnabled(): boolean;
-    getTracer(name?: string, version?: string): Tracer | null;
-    getMeter(name?: string, version?: string): Meter | null;
-    flush(): Promise<void>;
-    stop(): Promise<void>;
-}
-
-declare class InstrumentationService extends Service implements IInstrumentationService {
-    static serviceType: "instrumentation";
-    readonly name = "INSTRUMENTATION";
-    readonly capabilityDescription = "Provides OpenTelemetry tracing and metrics capabilities.";
-    instrumentationConfig: InstrumentationConfig;
-    private resource;
-    private tracerProvider;
-    private meterProvider;
-    private isShutdown;
-    constructor(config?: InstrumentationConfig);
-    private initializeProviders;
-    isEnabled(): boolean;
-    getTracer(name?: string, version?: string): Tracer | null;
-    getMeter(name?: string, version?: string): Meter | null;
-    flush(): Promise<void>;
-    stop(): Promise<void>;
-    static start(runtime: IAgentRuntime, config?: InstrumentationConfig): Promise<InstrumentationService>;
-}
-
 declare class Semaphore {
     private permits;
     private waiting;
@@ -667,8 +974,6 @@ declare class AgentRuntime implements IAgentRuntime {
     logger: any;
     private settings;
     private servicesInitQueue;
-    instrumentationService: InstrumentationService;
-    tracer: any;
     constructor(opts: {
         conversationLength?: number;
         agentId?: UUID;
@@ -682,14 +987,12 @@ declare class AgentRuntime implements IAgentRuntime {
         };
         allAvailablePlugins?: Plugin[];
     });
-    startSpan<T>(name: string, fn: (span: Span) => Promise<T>, parentContext?: Context): Promise<T>;
-    endSpan(ctx: Context | undefined, name: string): void;
-    startActiveSpan(name: string, options?: any): Span;
     registerPlugin(plugin: Plugin): Promise<void>;
     private resolvePluginDependencies;
     getAllServices(): Map<ServiceTypeName, Service>;
     stop(): Promise<void>;
     initialize(): Promise<void>;
+    runPluginMigrations(): Promise<void>;
     getConnection(): Promise<unknown>;
     setSetting(key: string, value: string | boolean | null | any, secret?: boolean): void;
     getSetting(key: string): string | boolean | null | any;
@@ -831,6 +1134,7 @@ declare class AgentRuntime implements IAgentRuntime {
         metadata?: MemoryMetadata;
     }): Promise<boolean>;
     deleteMemory(memoryId: UUID): Promise<void>;
+    deleteManyMemories(memoryIds: UUID[]): Promise<void>;
     deleteAllMemories(roomId: UUID, tableName: string): Promise<void>;
     countMemories(roomId: UUID, unique?: boolean, tableName?: string): Promise<number>;
     getLogs(params: {
@@ -904,6 +1208,8 @@ declare class AgentRuntime implements IAgentRuntime {
         count?: number;
         tableName?: string;
     }): Promise<Memory[]>;
+    runMigrations(migrationsPaths?: string[]): Promise<void>;
+    isReady(): Promise<boolean>;
 }
 
 /**
@@ -1166,4 +1472,4 @@ declare function stringToUuid(target: string | number): UUID;
 
 declare const defaultSpec: typeof v2;
 
-export { Action, Agent, AgentRuntime, ChannelType, Character, Component, Content, DatabaseAdapter, Entity, Evaluator, HandlerCallback, IAgentRuntime, IDatabaseAdapter, type IInstrumentationService, type InstrumentationConfig, InstrumentationService, Log, Memory, MemoryMetadata, ModelHandler, ModelParamsMap, ModelResultMap, ModelTypeName, OnboardingConfig, Participant, Plugin, Provider, Relationship, Role, Room, Route, RuntimeSettings, Semaphore, SendHandlerFunction, type ServerOwnershipState, Service, ServiceTypeName, Setting, State, TargetInfo, Task, TaskWorker, TemplateType, UUID, World, WorldSettings, addHeader, booleanFooter, composeActionExamples, composePrompt, composePromptFromState, createLogger, createSettingFromConfig, createUniqueUuid, decryptObjectValues, decryptStringValue as decryptSecret, decryptStringValue, decryptedCharacter, defaultSpec, elizaLogger, encryptObjectValues, encryptStringValue, encryptedCharacter, findEntityByName, findWorldsForOwner, formatActionNames, formatActions, formatEntities, formatMessages, formatPosts, formatTimestamp, getEntityDetails, getSalt, getUserServerRole, getWorldSettings, imageDescriptionTemplate, initializeOnboarding, logger, messageHandlerTemplate, normalizeJsonString, parseBooleanFromText, parseJSONObjectFromText, parseKeyValueXml, postCreationTemplate, safeReplacer, saltSettingValue, saltWorldSettings, shouldRespondTemplate, splitChunks, stringToUuid, trimTokens, truncateToCompleteSentence, unsaltSettingValue, unsaltWorldSettings, updateWorldSettings, v2, validateUuid };
+export { Action, Agent, AgentRuntime, ChannelType, Character, Component, Content, DatabaseAdapter, type DeriveKeyAttestationData, Entity, Evaluator, HandlerCallback, IAgentRuntime, IDatabaseAdapter, ILpService, ITokenDataService, IWalletService, Log, type LpPositionDetails, Memory, MemoryMetadata, Metadata, ModelHandler, ModelParamsMap, ModelResultMap, ModelTypeName, OnboardingConfig, Participant, Plugin, type PoolInfo, Provider, Relationship, type RemoteAttestationMessage, type RemoteAttestationQuote, Role, Room, Route, RuntimeSettings, Semaphore, SendHandlerFunction, type ServerOwnershipState, Service, ServiceTypeName, Setting, State, TEEMode, TargetInfo, Task, TaskWorker, type TeeAgent, type TeePluginConfig, TeeType, TemplateType, type TokenBalance, type TokenData, type TransactionResult, UUID, type WalletAsset, type WalletPortfolio, World, WorldSettings, addHeader, booleanFooter, composeActionExamples, composePrompt, composePromptFromState, createLogger, createSettingFromConfig, createUniqueUuid, decryptObjectValues, decryptStringValue as decryptSecret, decryptStringValue, decryptedCharacter, defaultSpec, elizaLogger, encryptObjectValues, encryptStringValue, encryptedCharacter, findEntityByName, findWorldsForOwner, formatActionNames, formatActions, formatEntities, formatMessages, formatPosts, formatTimestamp, getEntityDetails, getSalt, getUserServerRole, getWorldSettings, imageDescriptionTemplate, initializeOnboarding, logger, messageHandlerTemplate, normalizeJsonString, parseBooleanFromText, parseJSONObjectFromText, parseKeyValueXml, postCreationTemplate, safeReplacer, saltSettingValue, saltWorldSettings, shouldRespondTemplate, splitChunks, stringToUuid, trimTokens, truncateToCompleteSentence, unsaltSettingValue, unsaltWorldSettings, updateWorldSettings, v2, validateUuid };

package/dist/index.js

@@ -6,7 +6,9 @@ import {
   ContentType,
   DatabaseAdapter,
   EventType,
-  InstrumentationService,
+  ILpService,
+  ITokenDataService,
+  IWalletService,
   KnowledgeScope,
   MemoryType,
   ModelType,
@@ -86,13 +88,13 @@ import {
   v1_exports,
   v2_exports,
   validateUuid
-} from "./chunk-TF6QLZZY.js";
+} from "./chunk-6EXKM3O4.js";
 import "./chunk-2HSL25IJ.js";
-import "./chunk-FEPOSPNK.js";
+import "./chunk-WO7Z3GE6.js";
 import "./chunk-U2ADTLZY.js";
 import "./chunk-JX2SRFHQ.js";
 import "./chunk-YIBXLDIR.js";
-import "./chunk-SIAA4J6H.js";
+import "./chunk-R5U7XKVJ.js";
 export {
   AgentRuntime,
   AgentStatus,
@@ -101,7 +103,9 @@ export {
   ContentType,
   DatabaseAdapter,
   EventType,
-  InstrumentationService,
+  ILpService,
+  ITokenDataService,
+  IWalletService,
   KnowledgeScope,
   MemoryType,
   ModelType,

package/dist/specs/v1/actionExample.d.ts

@@ -1,5 +1,5 @@
 import { ActionExample as ActionExample$2, Content as Content$1 } from './types.js';
-import { A as ActionExample$1, C as Content } from '../../types-D9v-eW3g.js';
+import { A as ActionExample$1, C as Content } from '../../types-szUq9-0V.js';
 import 'stream';
 
 /**

package/dist/specs/v1/actionExample.js

@@ -4,7 +4,7 @@ import {
   fromV2ActionExample,
   toV2ActionExample
 } from "../../chunk-U2ADTLZY.js";
-import "../../chunk-SIAA4J6H.js";
+import "../../chunk-R5U7XKVJ.js";
 export {
   convertContentToV1,
   convertContentToV2,

package/dist/specs/v1/index.d.ts

@@ -8,4 +8,4 @@ export { ActionExample, convertContentToV1, convertContentToV2, fromV2ActionExam
 export { Provider, fromV2Provider, toV2Provider } from './provider.js';
 export { TemplateType, createTemplateFunction, getTemplateValues, processTemplate } from './templates.js';
 import 'stream';
-import '../../types-D9v-eW3g.js';
+import '../../types-szUq9-0V.js';

package/dist/specs/v1/index.js

@@ -7,7 +7,7 @@ import {
   formatTimestamp3 as formatTimestamp,
   generateUuidFromString,
   getActorDetails
-} from "../../chunk-TF6QLZZY.js";
+} from "../../chunk-6EXKM3O4.js";
 import {
   createTemplateFunction,
   getTemplateValues,
@@ -28,7 +28,7 @@ import {
   ServiceType,
   TokenizerType,
   TranscriptionProvider
-} from "../../chunk-FEPOSPNK.js";
+} from "../../chunk-WO7Z3GE6.js";
 import {
   convertContentToV1,
   convertContentToV2,
@@ -43,7 +43,7 @@ import {
   fromV2State,
   toV2State
 } from "../../chunk-YIBXLDIR.js";
-import "../../chunk-SIAA4J6H.js";
+import "../../chunk-R5U7XKVJ.js";
 export {
   ActionTimelineType,
   AgentRuntime,

package/dist/specs/v1/messages.js

@@ -3,13 +3,13 @@ import {
   formatMessages3 as formatMessages,
   formatTimestamp3 as formatTimestamp,
   getActorDetails
-} from "../../chunk-TF6QLZZY.js";
+} from "../../chunk-6EXKM3O4.js";
 import "../../chunk-2HSL25IJ.js";
-import "../../chunk-FEPOSPNK.js";
+import "../../chunk-WO7Z3GE6.js";
 import "../../chunk-U2ADTLZY.js";
 import "../../chunk-JX2SRFHQ.js";
 import "../../chunk-YIBXLDIR.js";
-import "../../chunk-SIAA4J6H.js";
+import "../../chunk-R5U7XKVJ.js";
 export {
   formatActors,
   formatMessages,