@elizaos/core 1.0.7 → 1.0.9

package/dist/index.d.ts

@@ -1,12 +1,10 @@
-import { S as Service, 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, e as State, f as Role, 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-CGCNwsoH.js';
-export { ba as ActionEventPayload, al as ActionExample, ak as AgentStatus, aR as AudioProcessingParams, Y as BaseMetadata, aJ as BaseModelParams, ae as CacheKeyPrefix, ag as ChunkRow, ai as ComponentData, F as ContentType, bk as ControlMessage, a1 as CustomMetadata, a$ as DbConnection, a0 as DescriptionMetadata, aI as DetokenizeTextParams, af as DirectoryItem, Z as DocumentMetadata, aV as EmbeddingSearchResult, N as EnhancedState, b6 as EntityPayload, ao as EvaluationExample, bb as EvaluatorEventPayload, bg as EventDataObject, bf as EventHandler, b4 as EventPayload, be as EventPayloadMap, b2 as EventType, _ as FragmentMetadata, aH as GenerateTextParams, am as Handler, aO as ImageDescriptionParams, aN as ImageGenerationParams, b8 as InvokePayload, av as IsValidServiceType, aT as JSONSchema, ac as KnowledgeItem, ad as KnowledgeScope, D as Media, aW as MemoryRetrievalOptions, X as MemoryScope, aX as MemorySearchOptions, V as MemoryType, Q as MemoryTypeAlias, aj as MessageExample, a2 as MessageMemory, $ as MessageMetadata, b7 as MessagePayload, bd as MessageReceivedHandlerParams, b0 as MetadataObject, bc as ModelEventPayload, aG as ModelType, aY as MultiRoomMemoryOptions, aU as ObjectGenerationParams, b3 as PlatformPrefix, aq as PluginEvents, as as Project, ar as ProjectAgent, ap as ProviderResult, ah as RoomMetadata, b9 as RunEventPayload, bj as SOCKET_MESSAGE_TYPE, bn as ServiceBuilder, ax as ServiceClassMap, aF as ServiceConfig, bp as ServiceDefinition, aD as ServiceError, ay as ServiceInstance, az as ServiceRegistry, aA as ServiceType, at as ServiceTypeRegistry, au as ServiceTypeValue, K as StateArray, J as StateObject, G as StateValue, bi as TaskMetadata, bl as TestCase, bm as TestSuite, aL as TextEmbeddingParams, aK as TextGenerationParams, aQ as TextToSpeechParams, aM as TokenizeTextParams, aP as TranscriptionParams, bh as TypedEventHandler, aB as TypedService, aw as TypedServiceClass, aZ as UnifiedMemoryOptions, a_ as UnifiedSearchOptions, b1 as VECTOR_DIMS, an as Validator, aS as VideoProcessingParams, b5 as WorldPayload, B as asUUID, a3 as createMessageMemory, bo as createService, aE as createServiceError, bq as defineService, ab as getMemoryText, aC as getTypedService, a8 as isCustomMetadata, a7 as isDescriptionMetadata, a9 as isDocumentMemory, a4 as isDocumentMetadata, aa as isFragmentMemory, a5 as isFragmentMetadata, a6 as isMessageMetadata } from './index-CGCNwsoH.js';
-import { Keypair } from '@solana/web3.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-BQQJMuGB.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-BQQJMuGB.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-sJIakXg4.js';
+import './types-CTfMiLYi.js';
 import './specs/v1/messages.js';
 import './specs/v1/types.js';
 import 'stream';
@@ -102,14 +100,6 @@ 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.
@@ -119,20 +109,86 @@ 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;
+    vendorConfig?: Metadata;
 }
 
 /**
- * Represents a single asset holding within a wallet.
- * This provides a standardized view of a token or native currency.
+ * A standardized representation of a token holding.
  */
-interface WalletAsset {
-    name: string;
-    symbol: string;
+interface TokenBalance {
     address: string;
-    decimals: number;
     balance: string;
-    uiAmount: number;
+    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;
 }
@@ -149,7 +205,7 @@ interface WalletPortfolio {
  * 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";
+    static readonly serviceType: "wallet";
     readonly capabilityDescription = "Provides standardized access to wallet balances and portfolios.";
     /**
      * Retrieves the entire portfolio of assets held by the wallet.
@@ -164,20 +220,17 @@ declare abstract class IWalletService extends Service {
      * @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 token balance.
- */
-type TokenBalance = {
-    mintAddress: string;
-    amount: string;
-    uiAmount?: number;
-    decimals: number;
-    symbol?: string;
-    name?: string;
-    logoURI?: string;
-};
 /**
  * A standardized representation of a liquidity pool from any DEX.
  */
@@ -202,7 +255,7 @@ type PoolInfo = {
     apy?: number;
     tvl?: number;
     fee?: number;
-    metadata?: Record<string, any>;
+    metadata?: Metadata;
 };
 /**
  * A standardized representation of a user's position in a liquidity pool.
@@ -215,7 +268,7 @@ type LpPositionDetails = {
     valueUsd?: number;
     accruedFees?: TokenBalance[];
     rewards?: TokenBalance[];
-    metadata?: Record<string, any>;
+    metadata?: Metadata;
 };
 /**
  * A standardized result for blockchain transactions.
@@ -252,7 +305,7 @@ declare abstract class ILpService extends Service {
      * @returns A promise resolving to a transaction result, including the LP tokens received.
      */
     abstract addLiquidity(params: {
-        userVault: Keypair;
+        userVault: any;
         poolId: string;
         tokenAAmountLamports: string;
         tokenBAmountLamports?: string;
@@ -268,7 +321,7 @@ declare abstract class ILpService extends Service {
      * @returns A promise resolving to a transaction result, including the tokens received.
      */
     abstract removeLiquidity(params: {
-        userVault: Keypair;
+        userVault: any;
         poolId: string;
         lpTokenAmountLamports: string;
         slippageBps: number;
@@ -328,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.
@@ -512,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.
@@ -825,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>\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 ACTION ORDERING RULES:\n- Actions are executed in the ORDER you list them - the order MATTERS!\n- REPLY should come FIRST to acknowledge the user's request before executing other actions\n- Common patterns:\n  - For requests requiring tool use: REPLY,CALL_MCP_TOOL (acknowledge first, then gather info)\n  - For task execution: REPLY,SEND_MESSAGE or REPLY,EVM_SWAP_TOKENS (acknowledge first, then do the task)\n  - For multi-step operations: REPLY,ACTION1,ACTION2 (acknowledge first, then complete all steps)\n- REPLY is used to acknowledge and inform the user about what you're going to do\n- Follow-up actions execute the actual tasks after acknowledgment\n- Use IGNORE only when you should not respond at all\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, IN THE ORDER THEY SHOULD BE EXECUTED (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 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>";
@@ -859,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;
@@ -934,8 +974,8 @@ declare class AgentRuntime implements IAgentRuntime {
     logger: any;
     private settings;
     private servicesInitQueue;
-    instrumentationService: InstrumentationService;
-    tracer: any;
+    private currentRunId?;
+    private currentActionContext?;
     constructor(opts: {
         conversationLength?: number;
         agentId?: UUID;
@@ -949,14 +989,28 @@ 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;
+    /**
+     * Create a new run ID for tracking a sequence of model calls
+     */
+    createRunId(): UUID;
+    /**
+     * Start a new run for tracking prompts
+     */
+    startRun(): UUID;
+    /**
+     * End the current run
+     */
+    endRun(): void;
+    /**
+     * Get the current run ID (creates one if it doesn't exist)
+     */
+    getCurrentRunId(): UUID;
     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;
@@ -1098,6 +1152,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: {
@@ -1171,75 +1226,10 @@ declare class AgentRuntime implements IAgentRuntime {
         count?: number;
         tableName?: string;
     }): Promise<Memory[]>;
+    runMigrations(migrationsPaths?: string[]): Promise<void>;
+    isReady(): Promise<boolean>;
 }
 
-/**
- * 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.
- */
-interface ITokenDataService {
-    /**
-     * A unique identifier for the service, matching how it's registered.
-     */
-    readonly serviceName: 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.
-     */
-    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.
-     */
-    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.
-     */
-    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.
-     */
-    getTokensByAddresses(addresses: string[], chain: string): Promise<TokenData[]>;
-}
-/**
- * Constant for the TokenDataService name.
- * Ideally, this would be part of a shared enum in @elizaos/core.
- */
-declare const TOKEN_DATA_SERVICE_NAME = "TokenDataService";
-
 /**
  * Creates a new Setting object based on provided config settings.
  * @param {Omit<Setting, "value">} configSetting - The configuration settings for the new Setting object.
@@ -1500,4 +1490,4 @@ declare function stringToUuid(target: string | number): UUID;
 
 declare const defaultSpec: typeof v2;
 
-export { Action, Agent, AgentRuntime, ChannelType, Character, Component, Content, DatabaseAdapter, type DeriveKeyAttestationData, Entity, Evaluator, HandlerCallback, IAgentRuntime, IDatabaseAdapter, type IInstrumentationService, ILpService, type ITokenDataService, IWalletService, type InstrumentationConfig, InstrumentationService, Log, type LpPositionDetails, Memory, MemoryMetadata, 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, TOKEN_DATA_SERVICE_NAME, TargetInfo, Task, TaskWorker, type TeeAgent, type TeePluginConfig, TeeType, type TeeVendorConfig, 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 };
+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

@@ -7,8 +7,8 @@ import {
   DatabaseAdapter,
   EventType,
   ILpService,
+  ITokenDataService,
   IWalletService,
-  InstrumentationService,
   KnowledgeScope,
   MemoryType,
   ModelType,
@@ -21,7 +21,6 @@ import {
   ServiceBuilder,
   ServiceType,
   TEEMode,
-  TOKEN_DATA_SERVICE_NAME,
   TeeType,
   VECTOR_DIMS,
   addHeader,
@@ -89,13 +88,13 @@ import {
   v1_exports,
   v2_exports,
   validateUuid
-} from "./chunk-Y4TJIR4A.js";
+} from "./chunk-4RZR75QG.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,
@@ -105,8 +104,8 @@ export {
   DatabaseAdapter,
   EventType,
   ILpService,
+  ITokenDataService,
   IWalletService,
-  InstrumentationService,
   KnowledgeScope,
   MemoryType,
   ModelType,
@@ -119,7 +118,6 @@ export {
   ServiceBuilder,
   ServiceType,
   TEEMode,
-  TOKEN_DATA_SERVICE_NAME,
   TeeType,
   VECTOR_DIMS,
   addHeader,

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-sJIakXg4.js';
+import { A as ActionExample$1, C as Content } from '../../types-CTfMiLYi.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-sJIakXg4.js';
+import '../../types-CTfMiLYi.js';

package/dist/specs/v1/index.js

@@ -7,7 +7,7 @@ import {
   formatTimestamp3 as formatTimestamp,
   generateUuidFromString,
   getActorDetails
-} from "../../chunk-Y4TJIR4A.js";
+} from "../../chunk-4RZR75QG.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-Y4TJIR4A.js";
+} from "../../chunk-4RZR75QG.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,

package/dist/specs/v1/posts.js

@@ -1,12 +1,12 @@
 import {
   formatPosts3 as formatPosts
-} from "../../chunk-Y4TJIR4A.js";
+} from "../../chunk-4RZR75QG.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 {
   formatPosts
 };

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

@@ -1,5 +1,5 @@
 import { Provider as Provider$2 } from './types.js';
-import { P as Provider$1 } from '../../types-sJIakXg4.js';
+import { P as Provider$1 } from '../../types-CTfMiLYi.js';
 import 'stream';
 
 /**

package/dist/specs/v1/provider.js

@@ -3,7 +3,7 @@ import {
   toV2Provider
 } from "../../chunk-JX2SRFHQ.js";
 import "../../chunk-YIBXLDIR.js";
-import "../../chunk-SIAA4J6H.js";
+import "../../chunk-R5U7XKVJ.js";
 export {
   fromV2Provider,
   toV2Provider

package/dist/specs/v1/runtime.js

@@ -1,12 +1,12 @@
 import {
   AgentRuntime3 as AgentRuntime
-} from "../../chunk-Y4TJIR4A.js";
+} from "../../chunk-4RZR75QG.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
 };

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

@@ -1,4 +1,4 @@
-import { S as State$1 } from '../../types-sJIakXg4.js';
+import { S as State$1 } from '../../types-CTfMiLYi.js';
 import { State as State$2 } from './types.js';
 import 'stream';
 

package/dist/specs/v1/state.js

@@ -2,7 +2,7 @@ import {
   fromV2State,
   toV2State
 } from "../../chunk-YIBXLDIR.js";
-import "../../chunk-SIAA4J6H.js";
+import "../../chunk-R5U7XKVJ.js";
 export {
   fromV2State,
   toV2State