@elizaos/core 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -109,42 +109,52 @@ declare enum ModelClass {
     EMBEDDING = "embedding",
     IMAGE = "image"
 }
+/**
+ * Model settings
+ */
+type ModelSettings$1 = {
+    /** Model name */
+    name: string;
+    /** Maximum input tokens */
+    maxInputTokens: number;
+    /** Maximum output tokens */
+    maxOutputTokens: number;
+    /** Optional frequency penalty */
+    frequency_penalty?: number;
+    /** Optional presence penalty */
+    presence_penalty?: number;
+    /** Optional repetition penalty */
+    repetition_penalty?: number;
+    /** Stop sequences */
+    stop: string[];
+    /** Temperature setting */
+    temperature: number;
+    /** Optional telemetry configuration (experimental) */
+    experimental_telemetry?: TelemetrySettings;
+};
+/** Image model settings */
+type ImageModelSettings = {
+    name: string;
+    steps?: number;
+};
+/** Embedding model settings */
+type EmbeddingModelSettings = {
+    name: string;
+    dimensions?: number;
+};
 /**
  * Configuration for an AI model
  */
 type Model = {
     /** Optional API endpoint */
     endpoint?: string;
-    /** Model settings */
-    settings: {
-        /** Maximum input tokens */
-        maxInputTokens: number;
-        /** Maximum output tokens */
-        maxOutputTokens: number;
-        /** Optional frequency penalty */
-        frequency_penalty?: number;
-        /** Optional presence penalty */
-        presence_penalty?: number;
-        /** Optional repetition penalty */
-        repetition_penalty?: number;
-        /** Stop sequences */
-        stop: string[];
-        /** Temperature setting */
-        temperature: number;
-        /** Optional telemetry configuration (experimental) */
-        experimental_telemetry?: TelemetrySettings;
-    };
-    /** Optional image generation settings */
-    imageSettings?: {
-        steps?: number;
-    };
     /** Model names by size class */
     model: {
-        [ModelClass.SMALL]: string;
-        [ModelClass.MEDIUM]: string;
-        [ModelClass.LARGE]: string;
-        [ModelClass.EMBEDDING]?: string;
-        [ModelClass.IMAGE]?: string;
+        [ModelClass.SMALL]?: ModelSettings$1;
+        [ModelClass.MEDIUM]?: ModelSettings$1;
+        [ModelClass.LARGE]?: ModelSettings$1;
+        [ModelClass.EMBEDDING]?: EmbeddingModelSettings;
+        [ModelClass.IMAGE]?: ImageModelSettings;
     };
 };
 /**
@@ -160,6 +170,7 @@ type Models = {
     [ModelProviderName.TOGETHER]: Model;
     [ModelProviderName.LLAMALOCAL]: Model;
     [ModelProviderName.GOOGLE]: Model;
+    [ModelProviderName.MISTRAL]: Model;
     [ModelProviderName.CLAUDE_VERTEX]: Model;
     [ModelProviderName.REDPILL]: Model;
     [ModelProviderName.OPENROUTER]: Model;
@@ -173,8 +184,11 @@ type Models = {
     [ModelProviderName.NANOGPT]: Model;
     [ModelProviderName.HYPERBOLIC]: Model;
     [ModelProviderName.VENICE]: Model;
+    [ModelProviderName.NINETEEN_AI]: Model;
     [ModelProviderName.AKASH_CHAT_API]: Model;
     [ModelProviderName.LIVEPEER]: Model;
+    [ModelProviderName.DEEPSEEK]: Model;
+    [ModelProviderName.INFERA]: Model;
 };
 /**
  * Available model providers
@@ -189,6 +203,7 @@ declare enum ModelProviderName {
     TOGETHER = "together",
     LLAMALOCAL = "llama_local",
     GOOGLE = "google",
+    MISTRAL = "mistral",
     CLAUDE_VERTEX = "claude_vertex",
     REDPILL = "redpill",
     OPENROUTER = "openrouter",
@@ -202,8 +217,12 @@ declare enum ModelProviderName {
     NANOGPT = "nanogpt",
     HYPERBOLIC = "hyperbolic",
     VENICE = "venice",
+    NINETEEN_AI = "nineteen_ai",
     AKASH_CHAT_API = "akash_chat_api",
-    LIVEPEER = "livepeer"
+    LIVEPEER = "livepeer",
+    LETZAI = "letzai",
+    DEEPSEEK = "deepseek",
+    INFERA = "infera"
 }
 /**
  * Represents the current state/context of a conversation
@@ -261,6 +280,8 @@ interface State {
     knowledge?: string;
     /** Optional knowledge data */
     knowledgeData?: KnowledgeItem[];
+    /** Optional knowledge data */
+    ragKnowledgeData?: RAGKnowledgeItem[];
     /** Additional dynamic properties */
     [key: string]: unknown;
 }
@@ -480,7 +501,8 @@ declare enum Clients {
     FARCASTER = "farcaster",
     LENS = "lens",
     AUTO = "auto",
-    SLACK = "slack"
+    SLACK = "slack",
+    GITHUB = "github"
 }
 interface IAgentConfig {
     [key: string]: string;
@@ -517,6 +539,9 @@ interface ModelConfiguration {
     maxInputTokens?: number;
     experimental_telemetry?: TelemetrySettings;
 }
+type TemplateType = string | ((options: {
+    state: State;
+}) => string);
 /**
  * Configuration for an agent character
  */
@@ -539,30 +564,30 @@ type Character = {
     modelEndpointOverride?: string;
     /** Optional prompt templates */
     templates?: {
-        goalsTemplate?: string;
-        factsTemplate?: string;
-        messageHandlerTemplate?: string;
-        shouldRespondTemplate?: string;
-        continueMessageHandlerTemplate?: string;
-        evaluationTemplate?: string;
-        twitterSearchTemplate?: string;
-        twitterActionTemplate?: string;
-        twitterPostTemplate?: string;
-        twitterMessageHandlerTemplate?: string;
-        twitterShouldRespondTemplate?: string;
-        farcasterPostTemplate?: string;
-        lensPostTemplate?: string;
-        farcasterMessageHandlerTemplate?: string;
-        lensMessageHandlerTemplate?: string;
-        farcasterShouldRespondTemplate?: string;
-        lensShouldRespondTemplate?: string;
-        telegramMessageHandlerTemplate?: string;
-        telegramShouldRespondTemplate?: string;
-        discordVoiceHandlerTemplate?: string;
-        discordShouldRespondTemplate?: string;
-        discordMessageHandlerTemplate?: string;
-        slackMessageHandlerTemplate?: string;
-        slackShouldRespondTemplate?: string;
+        goalsTemplate?: TemplateType;
+        factsTemplate?: TemplateType;
+        messageHandlerTemplate?: TemplateType;
+        shouldRespondTemplate?: TemplateType;
+        continueMessageHandlerTemplate?: TemplateType;
+        evaluationTemplate?: TemplateType;
+        twitterSearchTemplate?: TemplateType;
+        twitterActionTemplate?: TemplateType;
+        twitterPostTemplate?: TemplateType;
+        twitterMessageHandlerTemplate?: TemplateType;
+        twitterShouldRespondTemplate?: TemplateType;
+        farcasterPostTemplate?: TemplateType;
+        lensPostTemplate?: TemplateType;
+        farcasterMessageHandlerTemplate?: TemplateType;
+        lensMessageHandlerTemplate?: TemplateType;
+        farcasterShouldRespondTemplate?: TemplateType;
+        lensShouldRespondTemplate?: TemplateType;
+        telegramMessageHandlerTemplate?: TemplateType;
+        telegramShouldRespondTemplate?: TemplateType;
+        discordVoiceHandlerTemplate?: TemplateType;
+        discordShouldRespondTemplate?: TemplateType;
+        discordMessageHandlerTemplate?: TemplateType;
+        slackMessageHandlerTemplate?: TemplateType;
+        slackShouldRespondTemplate?: TemplateType;
     };
     /** Character biography */
     bio: string | string[];
@@ -577,7 +602,10 @@ type Character = {
     /** Character traits */
     adjectives: string[];
     /** Optional knowledge base */
-    knowledge?: string[];
+    knowledge?: (string | {
+        path: string;
+        shared?: boolean;
+    })[];
     /** Supported client platforms */
     clients: Clients[];
     /** Available plugins */
@@ -623,6 +651,7 @@ type Character = {
             [key: string]: any[];
         };
         transcription?: TranscriptionProvider;
+        ragKnowledge?: boolean;
     };
     /** Optional client-specific config */
     clientConfig?: {
@@ -678,6 +707,8 @@ type Character = {
     nft?: {
         prompt: string;
     };
+    /**Optinal Parent characters to inherit information from */
+    extends?: string[];
 };
 /**
  * Interface for database operations
@@ -708,6 +739,7 @@ interface IDatabaseAdapter {
         tableName: string;
         agentId: UUID;
         roomIds: UUID[];
+        limit?: number;
     }): Promise<Memory[]>;
     getCachedEmbeddings(params: {
         query_table_name: string;
@@ -789,6 +821,23 @@ interface IDatabaseAdapter {
     getRelationships(params: {
         userId: UUID;
     }): Promise<Relationship[]>;
+    getKnowledge(params: {
+        id?: UUID;
+        agentId: UUID;
+        limit?: number;
+        query?: string;
+        conversationContext?: string;
+    }): Promise<RAGKnowledgeItem[]>;
+    searchKnowledge(params: {
+        agentId: UUID;
+        embedding: Float32Array;
+        match_threshold: number;
+        match_count: number;
+        searchText?: string;
+    }): Promise<RAGKnowledgeItem[]>;
+    createKnowledge(knowledge: RAGKnowledgeItem): Promise<void>;
+    removeKnowledge(id: UUID): Promise<void>;
+    clearKnowledge(agentId: UUID, shared?: boolean): Promise<void>;
 }
 interface IDatabaseCacheAdapter {
     getCache(params: {
@@ -824,6 +873,7 @@ interface IMemoryManager {
     getMemoryById(id: UUID): Promise<Memory | null>;
     getMemoriesByRoomIds(params: {
         roomIds: UUID[];
+        limit?: number;
     }): Promise<Memory[]>;
     searchMemoriesByEmbedding(embedding: number[], opts: {
         match_threshold?: number;
@@ -836,6 +886,33 @@ interface IMemoryManager {
     removeAllMemories(roomId: UUID): Promise<void>;
     countMemories(roomId: UUID, unique?: boolean): Promise<number>;
 }
+interface IRAGKnowledgeManager {
+    runtime: IAgentRuntime;
+    tableName: string;
+    getKnowledge(params: {
+        query?: string;
+        id?: UUID;
+        limit?: number;
+        conversationContext?: string;
+        agentId?: UUID;
+    }): Promise<RAGKnowledgeItem[]>;
+    createKnowledge(item: RAGKnowledgeItem): Promise<void>;
+    removeKnowledge(id: UUID): Promise<void>;
+    searchKnowledge(params: {
+        agentId: UUID;
+        embedding: Float32Array | number[];
+        match_threshold?: number;
+        match_count?: number;
+        searchText?: string;
+    }): Promise<RAGKnowledgeItem[]>;
+    clearKnowledge(shared?: boolean): Promise<void>;
+    processFile(file: {
+        path: string;
+        content: string;
+        type: "pdf" | "md" | "txt";
+        isShared: boolean;
+    }): Promise<void>;
+}
 type CacheOptions = {
     expires?: number;
 };
@@ -874,10 +951,12 @@ interface IAgentRuntime {
     descriptionManager: IMemoryManager;
     documentsManager: IMemoryManager;
     knowledgeManager: IMemoryManager;
+    ragKnowledgeManager: IRAGKnowledgeManager;
     loreManager: IMemoryManager;
     cacheManager: ICacheManager;
     services: Map<ServiceType, Service>;
     clients: Record<string, any>;
+    verifiableInferenceAdapter?: IVerifiableInferenceAdapter | null;
     initialize(): Promise<void>;
     registerMemoryManager(manager: IMemoryManager): void;
     getMemoryManager(name: string): IMemoryManager | null;
@@ -886,7 +965,7 @@ interface IAgentRuntime {
     getSetting(key: string): string | null;
     getConversationLength(): number;
     processActions(message: Memory, responses: Memory[], state?: State, callback?: HandlerCallback): Promise<void>;
-    evaluate(message: Memory, state?: State, didRespond?: boolean, callback?: HandlerCallback): Promise<string[]>;
+    evaluate(message: Memory, state?: State, didRespond?: boolean, callback?: HandlerCallback): Promise<string[] | null>;
     ensureParticipantExists(userId: UUID, roomId: UUID): Promise<void>;
     ensureUserExists(userId: UUID, userName: string | null, name: string | null, source: string | null): Promise<void>;
     registerAction(action: Action): void;
@@ -946,6 +1025,44 @@ interface IAwsS3Service extends Service {
     }>;
     generateSignedUrl(fileName: string, expiresIn: number): Promise<string>;
 }
+interface UploadIrysResult {
+    success: boolean;
+    url?: string;
+    error?: string;
+    data?: any;
+}
+interface DataIrysFetchedFromGQL {
+    success: boolean;
+    data: any;
+    error?: string;
+}
+interface GraphQLTag {
+    name: string;
+    values: any[];
+}
+declare const enum IrysMessageType {
+    REQUEST = "REQUEST",
+    DATA_STORAGE = "DATA_STORAGE",
+    REQUEST_RESPONSE = "REQUEST_RESPONSE"
+}
+declare const enum IrysDataType {
+    FILE = "FILE",
+    IMAGE = "IMAGE",
+    OTHER = "OTHER"
+}
+interface IrysTimestamp {
+    from: number;
+    to: number;
+}
+interface IIrysService extends Service {
+    getDataFromAnAgent(agentsWalletPublicKeys: string[], tags: GraphQLTag[], timestamp: IrysTimestamp): Promise<DataIrysFetchedFromGQL>;
+    workerUploadDataOnIrys(data: any, dataType: IrysDataType, messageType: IrysMessageType, serviceCategory: string[], protocol: string[], validationThreshold: number[], minimumProviders: number[], testProvider: boolean[], reputation: number[]): Promise<UploadIrysResult>;
+    providerUploadDataOnIrys(data: any, dataType: IrysDataType, serviceCategory: string[], protocol: string[]): Promise<UploadIrysResult>;
+}
+interface ITeeLogService extends Service {
+    getInstance(): ITeeLogService;
+    log(agentId: string, roomId: string, userId: string, type: string, content: string): Promise<boolean>;
+}
 type SearchImage = {
     url: string;
     description?: string;
@@ -976,7 +1093,10 @@ declare enum ServiceType {
     INTIFACE = "intiface",
     AWS_S3 = "aws_s3",
     BUTTPLUG = "buttplug",
-    SLACK = "slack"
+    SLACK = "slack",
+    IRYS = "irys",
+    TEE_LOG = "tee_log",
+    GOPLUS_SECURITY = "goplus_security"
 }
 declare enum LoggingLevel {
     DEBUG = "debug",
@@ -987,6 +1107,27 @@ type KnowledgeItem = {
     id: UUID;
     content: Content;
 };
+interface RAGKnowledgeItem {
+    id: UUID;
+    agentId: UUID;
+    content: {
+        text: string;
+        metadata?: {
+            isMain?: boolean;
+            isChunk?: boolean;
+            originalId?: UUID;
+            chunkIndex?: number;
+            source?: string;
+            type?: string;
+            isShared?: boolean;
+            [key: string]: unknown;
+        };
+    };
+    embedding?: Float32Array;
+    createdAt?: number;
+    similarity?: number;
+    score?: number;
+}
 interface ActionResponse {
     like: boolean;
     retweet: boolean;
@@ -996,6 +1137,60 @@ interface ActionResponse {
 interface ISlackService extends Service {
     client: any;
 }
+/**
+ * Available verifiable inference providers
+ */
+declare enum VerifiableInferenceProvider {
+    RECLAIM = "reclaim",
+    OPACITY = "opacity",
+    PRIMUS = "primus"
+}
+/**
+ * Options for verifiable inference
+ */
+interface VerifiableInferenceOptions {
+    /** Custom endpoint URL */
+    endpoint?: string;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Provider-specific options */
+    providerOptions?: Record<string, unknown>;
+}
+/**
+ * Result of a verifiable inference request
+ */
+interface VerifiableInferenceResult {
+    /** Generated text */
+    text: string;
+    /** Proof */
+    proof: any;
+    /** Proof id */
+    id?: string;
+    /** Provider information */
+    provider: VerifiableInferenceProvider;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Interface for verifiable inference adapters
+ */
+interface IVerifiableInferenceAdapter {
+    options: any;
+    /**
+     * Generate text with verifiable proof
+     * @param context The input text/prompt
+     * @param modelClass The model class/name to use
+     * @param options Additional provider-specific options
+     * @returns Promise containing the generated text and proof data
+     */
+    generateText(context: string, modelClass: string, options?: VerifiableInferenceOptions): Promise<VerifiableInferenceResult>;
+    /**
+     * Verify the proof of a generated response
+     * @param result The result containing response and proof to verify
+     * @returns Promise indicating if the proof is valid
+     */
+    verifyProof(result: VerifiableInferenceResult): Promise<boolean>;
+}
 declare enum TokenizerType {
     Auto = "auto",
     TikToken = "tiktoken"
@@ -1005,6 +1200,10 @@ declare enum TranscriptionProvider {
     Deepgram = "deepgram",
     Local = "local"
 }
+declare enum ActionTimelineType {
+    ForYou = "foryou",
+    Following = "following"
+}
 
 /**
  * Composes a set of example conversations based on provided actions and a specified count.
@@ -1038,7 +1237,7 @@ declare function formatActions(actions: Action[]): string;
  *
  * @param {Object} params - The parameters for composing the context.
  * @param {State} params.state - The state object containing values to replace the placeholders in the template.
- * @param {string} params.template - The template string containing placeholders to be replaced with state values.
+ * @param {TemplateType} params.template - The template string or function containing placeholders to be replaced with state values.
  * @param {"handlebars" | undefined} [params.templatingEngine] - The templating engine to use for compiling and evaluating the template (optional, default: `undefined`).
  * @returns {string} The composed context string with placeholders replaced by corresponding state values.
  *
@@ -1050,10 +1249,17 @@ declare function formatActions(actions: Action[]): string;
  * // Composing the context with simple string replacement will result in:
  * // "Hello, Alice! You are 30 years old."
  * const contextSimple = composeContext({ state, template });
+ *
+ * // Using composeContext with a template function for dynamic template
+ * const template = ({ state }) => {
+ * const tone = Math.random() > 0.5 ? "kind" : "rude";
+ *   return `Hello, {{userName}}! You are {{userAge}} years old. Be ${tone}`;
+ * };
+ * const contextSimple = composeContext({ state, template });
  */
 declare const composeContext: ({ state, template, templatingEngine, }: {
     state: State;
-    template: string;
+    template: TemplateType;
     templatingEngine?: "handlebars";
 }) => string;
 /**
@@ -1190,6 +1396,7 @@ declare abstract class DatabaseAdapter<DB = any> implements IDatabaseAdapter {
         agentId: UUID;
         roomIds: UUID[];
         tableName: string;
+        limit?: number;
     }): Promise<Memory[]>;
     abstract getMemoryById(id: UUID): Promise<Memory | null>;
     /**
@@ -1422,6 +1629,43 @@ declare abstract class DatabaseAdapter<DB = any> implements IDatabaseAdapter {
     abstract getRelationships(params: {
         userId: UUID;
     }): Promise<Relationship[]>;
+    /**
+    * Retrieves knowledge items based on specified parameters.
+    * @param params Object containing search parameters
+    * @returns Promise resolving to array of knowledge items
+    */
+    abstract getKnowledge(params: {
+        id?: UUID;
+        agentId: UUID;
+        limit?: number;
+        query?: string;
+        conversationContext?: string;
+    }): Promise<RAGKnowledgeItem[]>;
+    abstract searchKnowledge(params: {
+        agentId: UUID;
+        embedding: Float32Array;
+        match_threshold: number;
+        match_count: number;
+        searchText?: string;
+    }): Promise<RAGKnowledgeItem[]>;
+    /**
+     * Creates a new knowledge item in the database.
+     * @param knowledge The knowledge item to create
+     * @returns Promise resolving when creation is complete
+     */
+    abstract createKnowledge(knowledge: RAGKnowledgeItem): Promise<void>;
+    /**
+     * Removes a knowledge item and its associated chunks from the database.
+     * @param id The ID of the knowledge item to remove
+     * @returns Promise resolving when removal is complete
+     */
+    abstract removeKnowledge(id: UUID): Promise<void>;
+    /**
+     * Removes an agents full knowledge database and its associated chunks from the database.
+     * @param agentId The Agent ID of the knowledge items to remove
+     * @returns Promise resolving when removal is complete
+     */
+    abstract clearKnowledge(agentId: UUID, shared?: boolean): Promise<void>;
     /**
      * Executes an operation with circuit breaker protection.
      * @param operation A function that returns a Promise to be executed with circuit breaker protection
@@ -1439,6 +1683,7 @@ declare const EmbeddingProvider: {
     readonly OpenAI: "OpenAI";
     readonly Ollama: "Ollama";
     readonly GaiaNet: "GaiaNet";
+    readonly Heurist: "Heurist";
     readonly BGE: "BGE";
 };
 type EmbeddingProviderType = (typeof EmbeddingProvider)[keyof typeof EmbeddingProvider];
@@ -1531,15 +1776,18 @@ declare function trimTokens(context: string, maxTokens: number, runtime: IAgentR
  * @param opts.max_context_length The maximum length of the context to apply to the generateText.
  * @returns The completed message.
  */
-declare function generateText({ runtime, context, modelClass, tools, onStepFinish, maxSteps, stop, customSystemPrompt, }: {
+declare function generateText({ runtime, context, modelClass, tools, onStepFinish, maxSteps, stop, customSystemPrompt, verifiableInference, verifiableInferenceOptions, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
     tools?: Record<string, Tool>;
     onStepFinish?: (event: StepResult) => Promise<void> | void;
     maxSteps?: number;
     stop?: string[];
     customSystemPrompt?: string;
+    verifiableInference?: boolean;
+    verifiableInferenceAdapter?: IVerifiableInferenceAdapter;
+    verifiableInferenceOptions?: VerifiableInferenceOptions;
 }): Promise<string>;
 /**
  * Sends a message to the model to determine if it should respond to the given context.
@@ -1558,7 +1806,7 @@ declare function generateText({ runtime, context, modelClass, tools, onStepFinis
 declare function generateShouldRespond({ runtime, context, modelClass, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
 }): Promise<"RESPOND" | "IGNORE" | "STOP" | null>;
 /**
  * Splits content into chunks of specified size with optional overlapping bleed sections
@@ -1586,7 +1834,7 @@ declare function splitChunks(content: string, chunkSize?: number, bleed?: number
 declare function generateTrueOrFalse({ runtime, context, modelClass, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
 }): Promise<boolean>;
 /**
  * Send a message to the model and parse the response as a string array
@@ -1606,17 +1854,17 @@ declare function generateTrueOrFalse({ runtime, context, modelClass, }: {
 declare function generateTextArray({ runtime, context, modelClass, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
 }): Promise<string[]>;
 declare function generateObjectDeprecated({ runtime, context, modelClass, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
 }): Promise<any>;
 declare function generateObjectArray({ runtime, context, modelClass, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
 }): Promise<any[]>;
 /**
  * Send a message to the model for generateText.
@@ -1633,7 +1881,7 @@ declare function generateObjectArray({ runtime, context, modelClass, }: {
 declare function generateMessageResponse({ runtime, context, modelClass, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
 }): Promise<Content>;
 declare const generateImage: (data: {
     prompt: string;
@@ -1673,6 +1921,9 @@ interface GenerationOptions {
     stop?: string[];
     mode?: "auto" | "json" | "tool";
     experimental_providerMetadata?: Record<string, unknown>;
+    verifiableInference?: boolean;
+    verifiableInferenceAdapter?: IVerifiableInferenceAdapter;
+    verifiableInferenceOptions?: VerifiableInferenceOptions;
 }
 /**
  * Base settings for model generation.
@@ -1693,7 +1944,7 @@ interface ModelSettings {
  * @returns {Promise<any[]>} - A promise that resolves to an array of generated objects.
  * @throws {Error} - Throws an error if the provider is unsupported or if generation fails.
  */
-declare const generateObject: ({ runtime, context, modelClass, schema, schemaName, schemaDescription, stop, mode, }: GenerationOptions) => Promise<GenerateObjectResult<unknown>>;
+declare const generateObject: ({ runtime, context, modelClass, schema, schemaName, schemaDescription, stop, mode, verifiableInference, verifiableInferenceAdapter, verifiableInferenceOptions, }: GenerationOptions) => Promise<GenerateObjectResult<unknown>>;
 /**
  * Interface for provider-specific generation options.
  */
@@ -1708,8 +1959,11 @@ interface ProviderOptions {
     mode?: "auto" | "json" | "tool";
     experimental_providerMetadata?: Record<string, unknown>;
     modelOptions: ModelSettings;
-    modelClass: string;
+    modelClass: ModelClass;
     context: string;
+    verifiableInference?: boolean;
+    verifiableInferenceAdapter?: IVerifiableInferenceAdapter;
+    verifiableInferenceOptions?: VerifiableInferenceOptions;
 }
 /**
  * Handles AI generation based on the specified provider.
@@ -1721,7 +1975,7 @@ declare function handleProvider(options: ProviderOptions): Promise<GenerateObjec
 declare function generateTweetActions({ runtime, context, modelClass, }: {
     runtime: IAgentRuntime;
     context: string;
-    modelClass: string;
+    modelClass: ModelClass;
 }): Promise<ActionResponse | null>;
 
 declare const getGoals: ({ runtime, roomId, userId, onlyInProgress, count, }: {
@@ -1824,6 +2078,7 @@ declare class MemoryManager implements IMemoryManager {
     createMemory(memory: Memory, unique?: boolean): Promise<void>;
     getMemoriesByRoomIds(params: {
         roomIds: UUID[];
+        limit?: number;
     }): Promise<Memory[]>;
     getMemoryById(id: UUID): Promise<Memory | null>;
     /**
@@ -1875,8 +2130,10 @@ declare const formatMessages: ({ messages, actors, }: {
 declare const formatTimestamp: (messageDate: number) => string;
 
 declare const models: Models;
-declare function getModel(provider: ModelProviderName, type: ModelClass): string;
-declare function getEndpoint(provider: ModelProviderName): string;
+declare function getModelSettings(provider: ModelProviderName, type: ModelClass): ModelSettings$1 | undefined;
+declare function getImageModelSettings(provider: ModelProviderName): ImageModelSettings | undefined;
+declare function getEmbeddingModelSettings(provider: ModelProviderName): EmbeddingModelSettings | undefined;
+declare function getEndpoint(provider: ModelProviderName): any;
 
 declare const formatPosts: ({ messages, actors, conversationHeader, }: {
     messages: Memory[];
@@ -1956,8 +2213,8 @@ declare class AgentRuntime implements IAgentRuntime {
      */
     imageModelProvider: ModelProviderName;
     /**
-    * The model to use for describing images.
-    */
+     * The model to use for describing images.
+     */
     imageVisionModelProvider: ModelProviderName;
     /**
      * Fetch function to use
@@ -1988,10 +2245,12 @@ declare class AgentRuntime implements IAgentRuntime {
      * Searchable document fragments
      */
     knowledgeManager: IMemoryManager;
+    ragKnowledgeManager: IRAGKnowledgeManager;
     services: Map<ServiceType, Service>;
     memoryManagers: Map<string, IMemoryManager>;
     cacheManager: ICacheManager;
     clients: Record<string, any>;
+    verifiableInferenceAdapter?: IVerifiableInferenceAdapter;
     registerMemoryManager(manager: IMemoryManager): void;
     getMemoryManager(tableName: string): IMemoryManager | null;
     getService<T extends Service>(service: ServiceType): T | null;
@@ -2031,6 +2290,7 @@ declare class AgentRuntime implements IAgentRuntime {
         speechModelPath?: string;
         cacheManager: ICacheManager;
         logging?: boolean;
+        verifiableInferenceAdapter?: IVerifiableInferenceAdapter;
     });
     initialize(): Promise<void>;
     stop(): Promise<void>;
@@ -2041,6 +2301,13 @@ declare class AgentRuntime implements IAgentRuntime {
      * @param knowledge An array of knowledge items containing id, path, and content.
      */
     private processCharacterKnowledge;
+    /**
+     * Processes character knowledge by creating document memories and fragment memories.
+     * This function takes an array of knowledge items, creates a document knowledge for each item if it doesn't exist,
+     * then chunks the content into fragments, embeds each fragment, and creates fragment knowledge.
+     * An array of knowledge items or objects containing id, path, and content.
+     */
+    private processCharacterRAGKnowledge;
     getSetting(key: string): any;
     /**
      * Get the number of messages that are kept in the conversation buffer.
@@ -2076,7 +2343,7 @@ declare class AgentRuntime implements IAgentRuntime {
      * @param callback The handler callback
      * @returns The results of the evaluation.
      */
-    evaluate(message: Memory, state?: State, didRespond?: boolean, callback?: HandlerCallback): Promise<string[]>;
+    evaluate(message: Memory, state: State, didRespond?: boolean, callback?: HandlerCallback): Promise<string[]>;
     /**
      * Ensure the existence of a participant in the room. If the participant does not exist, they are added to the room.
      * @param userId - The user ID to ensure the existence of.
@@ -2109,6 +2376,8 @@ declare class AgentRuntime implements IAgentRuntime {
         [key: string]: unknown;
     }): Promise<State>;
     updateRecentMessageState(state: State): Promise<State>;
+    getVerifiableInferenceAdapter(): IVerifiableInferenceAdapter | undefined;
+    setVerifiableInferenceAdapter(adapter: IVerifiableInferenceAdapter): void;
 }
 
 interface Settings {
@@ -2215,7 +2484,13 @@ declare const postActionResponseFooter = "Choose any combination of [LIKE], [RET
 declare const parseActionResponseFromText: (text: string) => {
     actions: ActionResponse;
 };
+/**
+ * Truncate text to fit within the character limit, ensuring it ends at a complete sentence.
+ */
+declare function truncateToCompleteSentence(text: string, maxLength: number): string;
 
+declare const uuidSchema: z.ZodType<UUID>;
+declare function validateUuid(value: unknown): UUID | null;
 declare function stringToUuid(target: string | number): UUID;
 
 declare const envSchema: z.ZodObject<{
@@ -2302,7 +2577,16 @@ declare const CharacterSchema: z.ZodObject<{
     postExamples: z.ZodArray<z.ZodString, "many">;
     topics: z.ZodArray<z.ZodString, "many">;
     adjectives: z.ZodArray<z.ZodString, "many">;
-    knowledge: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    knowledge: z.ZodOptional<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+        shared: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        path?: string;
+        shared?: boolean;
+    }, {
+        path?: string;
+        shared?: boolean;
+    }>]>, "many">>;
     clients: z.ZodArray<z.ZodNativeEnum<typeof Clients>, "many">;
     plugins: z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -2436,10 +2720,14 @@ declare const CharacterSchema: z.ZodObject<{
     }, {
         prompt?: string;
     }>>;
+    extends: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     bio?: string | string[];
     lore?: string[];
-    knowledge?: string[];
+    knowledge?: (string | {
+        path?: string;
+        shared?: boolean;
+    })[];
     settings?: {
         model?: string;
         secrets?: Record<string, string>;
@@ -2503,10 +2791,14 @@ declare const CharacterSchema: z.ZodObject<{
     nft?: {
         prompt?: string;
     };
+    extends?: string[];
 }, {
     bio?: string | string[];
     lore?: string[];
-    knowledge?: string[];
+    knowledge?: (string | {
+        path?: string;
+        shared?: boolean;
+    })[];
     settings?: {
         model?: string;
         secrets?: Record<string, string>;
@@ -2570,6 +2862,7 @@ declare const CharacterSchema: z.ZodObject<{
     nft?: {
         prompt?: string;
     };
+    extends?: string[];
 }>;
 type CharacterConfig = z.infer<typeof CharacterSchema>;
 declare function validateCharacterConfig(json: unknown): CharacterConfig;
@@ -2618,4 +2911,68 @@ declare const _default: {
     preprocess: typeof preprocess;
 };
 
-export { type Account, type Action, type ActionExample, type ActionResponse, type Actor, AgentRuntime, CacheManager, type CacheOptions, CacheStore, type Character, type CharacterConfig, CharacterSchema, type Client, Clients, type Content, type ConversationExample, DatabaseAdapter, DbCacheAdapter, type EmbeddingConfig, EmbeddingProvider, type EmbeddingProviderType, type EnvConfig, type EvaluationExample, type Evaluator, FsCacheAdapter, type GenerationOptions, type Goal, GoalStatus, type Handler, type HandlerCallback, type IAgentConfig, type IAgentRuntime, type IAwsS3Service, type IBrowserService, type ICacheAdapter, type ICacheManager, type IDatabaseAdapter, type IDatabaseCacheAdapter, type IImageDescriptionService, type IMemoryManager, type IPdfService, type ISlackService, type ISpeechService, type ITextGenerationService, type ITranscriptionService, type IVideoService, type KnowledgeItem, LoggingLevel, type Media, type Memory, MemoryCacheAdapter, MemoryManager, type MessageExample, type Model, ModelClass, type ModelConfiguration, ModelProviderName, type Models, type Objective, type Participant, type Plugin, type Provider, type Relationship, type Room, type SearchImage, type SearchResponse, type SearchResult, Service, ServiceType, type State, type TelemetrySettings, TokenizerType, TranscriptionProvider, type UUID, type Validator, addHeader, booleanFooter, composeActionExamples, composeContext, composeRandomUser, configureSettings, createGoal, createRelationship, defaultCharacter, elizaLogger, embed, envSchema, evaluationTemplate, findNearestEnvFile, formatActionNames, formatActions, formatActors, formatEvaluatorExampleDescriptions, formatEvaluatorExamples, formatEvaluatorNames, formatEvaluators, formatGoalsAsString, formatMessages, formatPosts, formatRelationships, formatTimestamp, generateCaption, generateImage, generateMessageResponse, generateObject, generateObjectArray, generateObjectDeprecated, generateShouldRespond, generateText, generateTextArray, generateTrueOrFalse, generateTweetActions, generateWebSearch, getActorDetails, getEmbeddingConfig, getEmbeddingType, getEmbeddingZeroVector, getEndpoint, getEnvVariable, getGoals, getModel, getProviders, getRelationship, getRelationships, handleProvider, hasEnvVariable, _default as knowledge, loadEnvConfig, messageCompletionFooter, models, parseActionResponseFromText, parseBooleanFromText, parseJSONObjectFromText, parseJsonArrayFromText, parseShouldRespondFromText, postActionResponseFooter, settings, shouldRespondFooter, splitChunks, stringArrayFooter, stringToUuid, trimTokens, updateGoal, validateCharacterConfig, validateEnv };
+/**
+ * Manage knowledge in the database.
+ */
+declare class RAGKnowledgeManager implements IRAGKnowledgeManager {
+    /**
+     * The AgentRuntime instance associated with this manager.
+     */
+    runtime: IAgentRuntime;
+    /**
+     * The name of the database table this manager operates on.
+     */
+    tableName: string;
+    /**
+     * Constructs a new KnowledgeManager instance.
+     * @param opts Options for the manager.
+     * @param opts.tableName The name of the table this manager will operate on.
+     * @param opts.runtime The AgentRuntime instance associated with this manager.
+     */
+    constructor(opts: {
+        tableName: string;
+        runtime: IAgentRuntime;
+    });
+    private readonly defaultRAGMatchThreshold;
+    private readonly defaultRAGMatchCount;
+    /**
+     * Common English stop words to filter out from query analysis
+     */
+    private readonly stopWords;
+    /**
+     * Filters out stop words and returns meaningful terms
+     */
+    private getQueryTerms;
+    /**
+     * Preprocesses text content for better RAG performance.
+     * @param content The text content to preprocess.
+     * @returns The preprocessed text.
+     */
+    private preprocess;
+    private hasProximityMatch;
+    getKnowledge(params: {
+        query?: string;
+        id?: UUID;
+        conversationContext?: string;
+        limit?: number;
+        agentId?: UUID;
+    }): Promise<RAGKnowledgeItem[]>;
+    createKnowledge(item: RAGKnowledgeItem): Promise<void>;
+    searchKnowledge(params: {
+        agentId: UUID;
+        embedding: Float32Array | number[];
+        match_threshold?: number;
+        match_count?: number;
+        searchText?: string;
+    }): Promise<RAGKnowledgeItem[]>;
+    removeKnowledge(id: UUID): Promise<void>;
+    clearKnowledge(shared?: boolean): Promise<void>;
+    processFile(file: {
+        path: string;
+        content: string;
+        type: "pdf" | "md" | "txt";
+        isShared?: boolean;
+    }): Promise<void>;
+}
+
+export { type Account, type Action, type ActionExample, type ActionResponse, ActionTimelineType, type Actor, AgentRuntime, CacheManager, type CacheOptions, CacheStore, type Character, type CharacterConfig, CharacterSchema, type Client, Clients, type Content, type ConversationExample, type DataIrysFetchedFromGQL, DatabaseAdapter, DbCacheAdapter, type EmbeddingConfig, type EmbeddingModelSettings, EmbeddingProvider, type EmbeddingProviderType, type EnvConfig, type EvaluationExample, type Evaluator, FsCacheAdapter, type GenerationOptions, type Goal, GoalStatus, type GraphQLTag, type Handler, type HandlerCallback, type IAgentConfig, type IAgentRuntime, type IAwsS3Service, type IBrowserService, type ICacheAdapter, type ICacheManager, type IDatabaseAdapter, type IDatabaseCacheAdapter, type IImageDescriptionService, type IIrysService, type IMemoryManager, type IPdfService, type IRAGKnowledgeManager, type ISlackService, type ISpeechService, type ITeeLogService, type ITextGenerationService, type ITranscriptionService, type IVerifiableInferenceAdapter, type IVideoService, type ImageModelSettings, IrysDataType, IrysMessageType, type IrysTimestamp, type KnowledgeItem, LoggingLevel, type Media, type Memory, MemoryCacheAdapter, MemoryManager, type MessageExample, type Model, ModelClass, type ModelConfiguration, ModelProviderName, type ModelSettings$1 as ModelSettings, type Models, type Objective, type Participant, type Plugin, type Provider, type RAGKnowledgeItem, RAGKnowledgeManager, type Relationship, type Room, type SearchImage, type SearchResponse, type SearchResult, Service, ServiceType, type State, type TelemetrySettings, type TemplateType, TokenizerType, TranscriptionProvider, type UUID, type UploadIrysResult, type Validator, type VerifiableInferenceOptions, VerifiableInferenceProvider, type VerifiableInferenceResult, addHeader, booleanFooter, composeActionExamples, composeContext, composeRandomUser, configureSettings, createGoal, createRelationship, defaultCharacter, elizaLogger, embed, envSchema, evaluationTemplate, findNearestEnvFile, formatActionNames, formatActions, formatActors, formatEvaluatorExampleDescriptions, formatEvaluatorExamples, formatEvaluatorNames, formatEvaluators, formatGoalsAsString, formatMessages, formatPosts, formatRelationships, formatTimestamp, generateCaption, generateImage, generateMessageResponse, generateObject, generateObjectArray, generateObjectDeprecated, generateShouldRespond, generateText, generateTextArray, generateTrueOrFalse, generateTweetActions, generateWebSearch, getActorDetails, getEmbeddingConfig, getEmbeddingModelSettings, getEmbeddingType, getEmbeddingZeroVector, getEndpoint, getEnvVariable, getGoals, getImageModelSettings, getModelSettings, getProviders, getRelationship, getRelationships, handleProvider, hasEnvVariable, _default as knowledge, loadEnvConfig, messageCompletionFooter, models, parseActionResponseFromText, parseBooleanFromText, parseJSONObjectFromText, parseJsonArrayFromText, parseShouldRespondFromText, postActionResponseFooter, settings, shouldRespondFooter, splitChunks, stringArrayFooter, stringToUuid, trimTokens, truncateToCompleteSentence, updateGoal, uuidSchema, validateCharacterConfig, validateEnv, validateUuid };