@elizaos/core 0.1.8 → 0.1.9

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { Readable } from 'stream';
 import { GenerateObjectResult, CoreTool, StepResult as StepResult$1 } from 'ai';
 import { ZodSchema, z } from 'zod';
+import * as pino from 'pino';
 
 /**
  * Represents a UUID string in the format "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
@@ -169,6 +170,7 @@ type Models = {
     [ModelProviderName.LLAMACLOUD]: Model;
     [ModelProviderName.TOGETHER]: Model;
     [ModelProviderName.LLAMALOCAL]: Model;
+    [ModelProviderName.LMSTUDIO]: Model;
     [ModelProviderName.GOOGLE]: Model;
     [ModelProviderName.MISTRAL]: Model;
     [ModelProviderName.CLAUDE_VERTEX]: Model;
@@ -184,11 +186,14 @@ type Models = {
     [ModelProviderName.NANOGPT]: Model;
     [ModelProviderName.HYPERBOLIC]: Model;
     [ModelProviderName.VENICE]: Model;
+    [ModelProviderName.NVIDIA]: Model;
     [ModelProviderName.NINETEEN_AI]: Model;
     [ModelProviderName.AKASH_CHAT_API]: Model;
     [ModelProviderName.LIVEPEER]: Model;
     [ModelProviderName.DEEPSEEK]: Model;
     [ModelProviderName.INFERA]: Model;
+    [ModelProviderName.BEDROCK]: Model;
+    [ModelProviderName.ATOMA]: Model;
 };
 /**
  * Available model providers
@@ -202,6 +207,7 @@ declare enum ModelProviderName {
     LLAMACLOUD = "llama_cloud",
     TOGETHER = "together",
     LLAMALOCAL = "llama_local",
+    LMSTUDIO = "lmstudio",
     GOOGLE = "google",
     MISTRAL = "mistral",
     CLAUDE_VERTEX = "claude_vertex",
@@ -217,12 +223,15 @@ declare enum ModelProviderName {
     NANOGPT = "nanogpt",
     HYPERBOLIC = "hyperbolic",
     VENICE = "venice",
+    NVIDIA = "nvidia",
     NINETEEN_AI = "nineteen_ai",
     AKASH_CHAT_API = "akash_chat_api",
     LIVEPEER = "livepeer",
     LETZAI = "letzai",
     DEEPSEEK = "deepseek",
-    INFERA = "infera"
+    INFERA = "infera",
+    BEDROCK = "bedrock",
+    ATOMA = "atoma"
 }
 /**
  * Represents the current state/context of a conversation
@@ -494,15 +503,21 @@ type Plugin = {
  * Available client platforms
  */
 declare enum Clients {
+    ALEXA = "alexa",
     DISCORD = "discord",
     DIRECT = "direct",
     TWITTER = "twitter",
     TELEGRAM = "telegram",
+    TELEGRAM_ACCOUNT = "telegram-account",
     FARCASTER = "farcaster",
     LENS = "lens",
     AUTO = "auto",
     SLACK = "slack",
-    GITHUB = "github"
+    GITHUB = "github",
+    INSTAGRAM = "instagram",
+    SIMSAI = "simsai",
+    XMTP = "xmtp",
+    DEVA = "deva"
 }
 interface IAgentConfig {
     [key: string]: string;
@@ -552,6 +567,8 @@ type Character = {
     name: string;
     /** Optional username */
     username?: string;
+    /** Optional email */
+    email?: string;
     /** Optional system prompt */
     system?: string;
     /** Model provider to use */
@@ -575,6 +592,10 @@ type Character = {
         twitterPostTemplate?: TemplateType;
         twitterMessageHandlerTemplate?: TemplateType;
         twitterShouldRespondTemplate?: TemplateType;
+        twitterVoiceHandlerTemplate?: TemplateType;
+        instagramPostTemplate?: TemplateType;
+        instagramMessageHandlerTemplate?: TemplateType;
+        instagramShouldRespondTemplate?: TemplateType;
         farcasterPostTemplate?: TemplateType;
         lensPostTemplate?: TemplateType;
         farcasterMessageHandlerTemplate?: TemplateType;
@@ -583,11 +604,21 @@ type Character = {
         lensShouldRespondTemplate?: TemplateType;
         telegramMessageHandlerTemplate?: TemplateType;
         telegramShouldRespondTemplate?: TemplateType;
+        telegramAutoPostTemplate?: string;
+        telegramPinnedMessageTemplate?: string;
+        discordAutoPostTemplate?: string;
+        discordAnnouncementHypeTemplate?: string;
         discordVoiceHandlerTemplate?: TemplateType;
         discordShouldRespondTemplate?: TemplateType;
         discordMessageHandlerTemplate?: TemplateType;
         slackMessageHandlerTemplate?: TemplateType;
         slackShouldRespondTemplate?: TemplateType;
+        jeeterPostTemplate?: string;
+        jeeterSearchTemplate?: string;
+        jeeterInteractionTemplate?: string;
+        jeeterMessageHandlerTemplate?: string;
+        jeeterShouldRespondTemplate?: string;
+        devaPostTemplate?: string;
     };
     /** Character biography */
     bio: string | string[];
@@ -620,6 +651,7 @@ type Character = {
             steps?: number;
             width?: number;
             height?: number;
+            cfgScale?: number;
             negativePrompt?: string;
             numIterations?: number;
             guidanceScale?: number;
@@ -629,6 +661,7 @@ type Character = {
             count?: number;
             stylePreset?: string;
             hideWatermark?: boolean;
+            safeMode?: boolean;
         };
         voice?: {
             model?: string;
@@ -664,6 +697,15 @@ type Character = {
             teamAgentIds?: string[];
             teamLeaderId?: string;
             teamMemberInterestKeywords?: string[];
+            allowedChannelIds?: string[];
+            autoPost?: {
+                enabled?: boolean;
+                monitorTime?: number;
+                inactivityThreshold?: number;
+                mainChannelId?: string;
+                announcementChannelIds?: string[];
+                minTimeBetweenPosts?: number;
+            };
         };
         telegram?: {
             shouldIgnoreBotMessages?: boolean;
@@ -676,6 +718,14 @@ type Character = {
             teamAgentIds?: string[];
             teamLeaderId?: string;
             teamMemberInterestKeywords?: string[];
+            autoPost?: {
+                enabled?: boolean;
+                monitorTime?: number;
+                inactivityThreshold?: number;
+                mainChannelId?: string;
+                pinnedMessagesGroups?: string[];
+                minTimeBetweenPosts?: number;
+            };
         };
         slack?: {
             shouldIgnoreBotMessages?: boolean;
@@ -703,13 +753,43 @@ type Character = {
         bio: string;
         nicknames?: string[];
     };
+    /** Optional Instagram profile */
+    instagramProfile?: {
+        id: string;
+        username: string;
+        bio: string;
+        nicknames?: string[];
+    };
+    /** Optional SimsAI profile */
+    simsaiProfile?: {
+        id: string;
+        username: string;
+        screenName: string;
+        bio: string;
+    };
     /** Optional NFT prompt */
     nft?: {
         prompt: string;
     };
     /**Optinal Parent characters to inherit information from */
     extends?: string[];
+    twitterSpaces?: TwitterSpaceDecisionOptions;
 };
+interface TwitterSpaceDecisionOptions {
+    maxSpeakers?: number;
+    topics?: string[];
+    typicalDurationMinutes?: number;
+    idleKickTimeoutMs?: number;
+    minIntervalBetweenSpacesMinutes?: number;
+    businessHoursOnly?: boolean;
+    randomChance?: number;
+    enableIdleMonitor?: boolean;
+    enableSttTts?: boolean;
+    enableRecording?: boolean;
+    voiceId?: string;
+    sttLanguage?: string;
+    speakerMaxDurationMs?: number;
+}
 /**
  * Interface for database operations
  */
@@ -735,6 +815,7 @@ interface IDatabaseAdapter {
         end?: number;
     }): Promise<Memory[]>;
     getMemoryById(id: UUID): Promise<Memory | null>;
+    getMemoriesByIds(ids: UUID[], tableName?: string): Promise<Memory[]>;
     getMemoriesByRoomIds(params: {
         tableName: string;
         agentId: UUID;
@@ -912,6 +993,8 @@ interface IRAGKnowledgeManager {
         type: "pdf" | "md" | "txt";
         isShared: boolean;
     }): Promise<void>;
+    cleanupDeletedKnowledgeFiles(): Promise<void>;
+    generateScopedId(path: string, isShared: boolean): UUID;
 }
 type CacheOptions = {
     expires?: number;
@@ -1040,12 +1123,12 @@ interface GraphQLTag {
     name: string;
     values: any[];
 }
-declare const enum IrysMessageType {
+declare enum IrysMessageType {
     REQUEST = "REQUEST",
     DATA_STORAGE = "DATA_STORAGE",
     REQUEST_RESPONSE = "REQUEST_RESPONSE"
 }
-declare const enum IrysDataType {
+declare enum IrysDataType {
     FILE = "FILE",
     IMAGE = "IMAGE",
     OTHER = "OTHER"
@@ -1063,25 +1146,6 @@ 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;
-};
-type SearchResult = {
-    title: string;
-    url: string;
-    content: string;
-    rawContent?: string;
-    score: number;
-    publishedDate?: string;
-};
-type SearchResponse = {
-    answer?: string;
-    query: string;
-    responseTime: number;
-    images: SearchImage[];
-    results: SearchResult[];
-};
 declare enum ServiceType {
     IMAGE_DESCRIPTION = "image_description",
     TRANSCRIPTION = "transcription",
@@ -1094,9 +1158,12 @@ declare enum ServiceType {
     AWS_S3 = "aws_s3",
     BUTTPLUG = "buttplug",
     SLACK = "slack",
+    VERIFIABLE_LOGGING = "verifiable_logging",
     IRYS = "irys",
     TEE_LOG = "tee_log",
-    GOPLUS_SECURITY = "goplus_security"
+    GOPLUS_SECURITY = "goplus_security",
+    WEB_SEARCH = "web_search",
+    EMAIL_AUTOMATION = "email_automation"
 }
 declare enum LoggingLevel {
     DEBUG = "debug",
@@ -1204,6 +1271,20 @@ declare enum ActionTimelineType {
     ForYou = "foryou",
     Following = "following"
 }
+declare enum KnowledgeScope {
+    SHARED = "shared",
+    PRIVATE = "private"
+}
+declare enum CacheKeyPrefix {
+    KNOWLEDGE = "knowledge"
+}
+interface DirectoryItem {
+    directory: string;
+    shared?: boolean;
+}
+interface ChunkRow {
+    id: string;
+}
 
 /**
  * Composes a set of example conversations based on provided actions and a specified count.
@@ -1399,6 +1480,13 @@ declare abstract class DatabaseAdapter<DB = any> implements IDatabaseAdapter {
         limit?: number;
     }): Promise<Memory[]>;
     abstract getMemoryById(id: UUID): Promise<Memory | null>;
+    /**
+     * Retrieves multiple memories by their IDs
+     * @param memoryIds Array of UUIDs of the memories to retrieve
+     * @param tableName Optional table name to filter memories by type
+     * @returns Promise resolving to array of Memory objects
+     */
+    abstract getMemoriesByIds(memoryIds: UUID[], tableName?: string): Promise<Memory[]>;
     /**
      * Retrieves cached embeddings based on the specified query parameters.
      * @param params An object containing parameters for the embedding retrieval.
@@ -1630,10 +1718,10 @@ declare abstract class DatabaseAdapter<DB = any> implements IDatabaseAdapter {
         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
-    */
+     * 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;
@@ -1826,7 +1914,6 @@ declare function splitChunks(content: string, chunkSize?: number, bleed?: number
  * @param opts.presence_penalty The presence penalty to apply (0.0 to 2.0)
  * @param opts.temperature The temperature to control randomness (0.0 to 2.0)
  * @param opts.serverUrl The URL of the API server
- * @param opts.token The API token for authentication
  * @param opts.max_context_length Maximum allowed context length in tokens
  * @param opts.max_response_length Maximum allowed response length in tokens
  * @returns Promise resolving to a boolean value parsed from the model's response
@@ -1896,6 +1983,8 @@ declare const generateImage: (data: {
     jobId?: string;
     stylePreset?: string;
     hideWatermark?: boolean;
+    safeMode?: boolean;
+    cfgScale?: number;
 }, runtime: IAgentRuntime) => Promise<{
     success: boolean;
     data?: string[];
@@ -1907,7 +1996,6 @@ declare const generateCaption: (data: {
     title: string;
     description: string;
 }>;
-declare const generateWebSearch: (query: string, runtime: IAgentRuntime) => Promise<SearchResponse>;
 /**
  * Configuration options for generating objects with a model.
  */
@@ -2169,10 +2257,6 @@ declare function formatRelationships({ runtime, userId, }: {
     userId: UUID;
 }): Promise<`${string}-${string}-${string}-${string}-${string}`[]>;
 
-/**
- * Represents the runtime environment for an agent, handling message processing,
- * action registration, and interaction with external services like OpenAI and Supabase.
- */
 declare class AgentRuntime implements IAgentRuntime {
     #private;
     /**
@@ -2246,6 +2330,7 @@ declare class AgentRuntime implements IAgentRuntime {
      */
     knowledgeManager: IMemoryManager;
     ragKnowledgeManager: IRAGKnowledgeManager;
+    private readonly knowledgeRoot;
     services: Map<ServiceType, Service>;
     memoryManagers: Map<string, IMemoryManager>;
     cacheManager: ICacheManager;
@@ -2308,6 +2393,11 @@ declare class AgentRuntime implements IAgentRuntime {
      * An array of knowledge items or objects containing id, path, and content.
      */
     private processCharacterRAGKnowledge;
+    /**
+     * Processes directory-based RAG knowledge by recursively loading and processing files.
+     * @param dirConfig The directory configuration containing path and shared flag
+     */
+    private processCharacterRAGDirectory;
     getSetting(key: string): any;
     /**
      * Get the number of messages that are kept in the conversation buffer.
@@ -2417,34 +2507,9 @@ declare function getEnvVariable(key: string, defaultValue?: string): string | un
 declare function hasEnvVariable(key: string): boolean;
 declare const settings: Settings;
 
-declare class ElizaLogger {
-    #private;
-    constructor();
-    private isNode;
-    verbose: boolean;
-    closeByNewLine: boolean;
-    useIcons: boolean;
-    logsTitle: string;
-    warningsTitle: string;
-    errorsTitle: string;
-    informationsTitle: string;
-    successesTitle: string;
-    debugsTitle: string;
-    assertsTitle: string;
-    clear(): void;
-    print(foregroundColor?: string, backgroundColor?: string, ...strings: any[]): void;
-    log(...strings: any[]): void;
-    warn(...strings: any[]): void;
-    error(...strings: any[]): void;
-    info(...strings: any[]): void;
-    debug(...strings: any[]): void;
-    success(...strings: any[]): void;
-    assert(...strings: any[]): void;
-    progress(message: string): void;
-}
-declare const elizaLogger: ElizaLogger;
+declare const elizaLogger: pino.Logger<string, boolean>;
 
-declare const messageCompletionFooter = "\nResponse format should be formatted in a JSON block like this:\n```json\n{ \"user\": \"{{agentName}}\", \"text\": \"string\", \"action\": \"string\" }\n```";
+declare const messageCompletionFooter = "\nResponse format should be formatted in a valid JSON block like this:\n```json\n{ \"user\": \"{{agentName}}\", \"text\": \"<string>\", \"action\": \"<string>\" }\n```\n\nThe \u201Caction\u201D field should be one of the options in [Available Actions] and the \"text\" field should be the response you want to send.\n";
 declare const shouldRespondFooter = "The available options are [RESPOND], [IGNORE], or [STOP]. Choose the most appropriate option.\nIf {{agentName}} is talking too much, you can choose [IGNORE]\n\nYour response must include one of the options.";
 declare const parseShouldRespondFromText: (text: string) => "RESPOND" | "IGNORE" | "STOP" | null;
 declare const booleanFooter = "Respond with only a YES or a NO.";
@@ -2458,7 +2523,7 @@ declare const booleanFooter = "Respond with only a YES or a NO.";
  * @returns {boolean|null} - Returns `true` for affirmative inputs, `false` for negative inputs, and `null` for unrecognized inputs or null/undefined.
  */
 declare const parseBooleanFromText: (text: string) => boolean;
-declare const stringArrayFooter = "Respond with a JSON array containing the values in a JSON block formatted for markdown with this structure:\n```json\n[\n  'value',\n  'value'\n]\n```\n\nYour response must include the JSON block.";
+declare const stringArrayFooter = "Respond with a JSON array containing the values in a valid JSON block formatted for markdown with this structure:\n```json\n[\n  'value',\n  'value'\n]\n```\n\nYour response must include the valid JSON block.";
 /**
  * Parses a JSON array from a given text. The function looks for a JSON block wrapped in triple backticks
  * with `json` language identifier, and if not found, it searches for an array pattern within the text.
@@ -2480,6 +2545,38 @@ declare function parseJsonArrayFromText(text: string): any[];
  * @returns An object parsed from the JSON string if successful; otherwise, null or the result of parsing an array.
  */
 declare function parseJSONObjectFromText(text: string): Record<string, any> | null;
+/**
+ * Extracts specific attributes (e.g., user, text, action) from a JSON-like string using regex.
+ * @param response - The cleaned string response to extract attributes from.
+ * @param attributesToExtract - An array of attribute names to extract.
+ * @returns An object containing the extracted attributes.
+ */
+declare function extractAttributes(response: string, attributesToExtract?: string[]): {
+    [key: string]: string | undefined;
+};
+/**
+ * Normalizes a JSON-like string by correcting formatting issues:
+ * - Removes extra spaces after '{' and before '}'.
+ * - Wraps unquoted values in double quotes.
+ * - Converts single-quoted values to double-quoted.
+ * - Ensures consistency in key-value formatting.
+ * - Normalizes mixed adjacent quote pairs.
+ *
+ * This is useful for cleaning up improperly formatted JSON strings
+ * before parsing them into valid JSON.
+ *
+ * @param str - The JSON-like string to normalize.
+ * @returns A properly formatted JSON string.
+ */
+declare const normalizeJsonString: (str: string) => string;
+/**
+ * Cleans a JSON-like response string by removing unnecessary markers, line breaks, and extra whitespace.
+ * This is useful for handling improperly formatted JSON responses from external sources.
+ *
+ * @param response - The raw JSON-like string response to clean.
+ * @returns The cleaned string, ready for parsing or further processing.
+ */
+declare function cleanJsonResponse(response: string): string;
 declare const postActionResponseFooter = "Choose any combination of [LIKE], [RETWEET], [QUOTE], and [REPLY] that are appropriate. Each action must be on its own line. Your response must only include the chosen actions.";
 declare const parseActionResponseFromText: (text: string) => {
     actions: ActionResponse;
@@ -2554,6 +2651,7 @@ declare const CharacterSchema: z.ZodObject<{
             attachments?: any[];
         }>, z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, "strip", z.ZodTypeAny, {
+        user?: string;
         content?: {
             text?: string;
             action?: string;
@@ -2562,8 +2660,8 @@ declare const CharacterSchema: z.ZodObject<{
             inReplyTo?: string;
             attachments?: any[];
         } & Record<string, unknown>;
-        user?: string;
     }, {
+        user?: string;
         content?: {
             text?: string;
             action?: string;
@@ -2572,7 +2670,6 @@ declare const CharacterSchema: z.ZodObject<{
             inReplyTo?: string;
             attachments?: any[];
         } & Record<string, unknown>;
-        user?: string;
     }>, "many">, "many">;
     postExamples: z.ZodArray<z.ZodString, "many">;
     topics: z.ZodArray<z.ZodString, "many">;
@@ -2581,11 +2678,20 @@ declare const CharacterSchema: z.ZodObject<{
         path: z.ZodString;
         shared: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        path?: string;
         shared?: boolean;
+        path?: string;
     }, {
+        shared?: boolean;
         path?: string;
+    }>, z.ZodObject<{
+        directory: z.ZodString;
+        shared: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
         shared?: boolean;
+        directory?: string;
+    }, {
+        shared?: boolean;
+        directory?: string;
     }>]>, "many">>;
     clients: z.ZodArray<z.ZodNativeEnum<typeof Clients>, "many">;
     plugins: z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodArray<z.ZodObject<{
@@ -2599,16 +2705,16 @@ declare const CharacterSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         actions?: any[];
         providers?: any[];
-        description?: string;
         name?: string;
+        description?: string;
         evaluators?: any[];
         services?: any[];
         clients?: any[];
     }, {
         actions?: any[];
         providers?: any[];
-        description?: string;
         name?: string;
+        description?: string;
         evaluators?: any[];
         services?: any[];
         clients?: any[];
@@ -2725,8 +2831,11 @@ declare const CharacterSchema: z.ZodObject<{
     bio?: string | string[];
     lore?: string[];
     knowledge?: (string | {
+        shared?: boolean;
         path?: string;
+    } | {
         shared?: boolean;
+        directory?: string;
     })[];
     settings?: {
         model?: string;
@@ -2737,15 +2846,16 @@ declare const CharacterSchema: z.ZodObject<{
         };
         embeddingModel?: string;
     };
-    system?: string;
-    id?: string;
+    modelProvider?: ModelProviderName;
     name?: string;
+    id?: string;
+    system?: string;
     topics?: string[];
     clients?: Clients[];
-    modelProvider?: ModelProviderName;
     modelEndpointOverride?: string;
     templates?: Record<string, string>;
     messageExamples?: {
+        user?: string;
         content?: {
             text?: string;
             action?: string;
@@ -2754,15 +2864,14 @@ declare const CharacterSchema: z.ZodObject<{
             inReplyTo?: string;
             attachments?: any[];
         } & Record<string, unknown>;
-        user?: string;
     }[][];
     postExamples?: string[];
     adjectives?: string[];
     plugins?: string[] | {
         actions?: any[];
         providers?: any[];
-        description?: string;
         name?: string;
+        description?: string;
         evaluators?: any[];
         services?: any[];
         clients?: any[];
@@ -2796,8 +2905,11 @@ declare const CharacterSchema: z.ZodObject<{
     bio?: string | string[];
     lore?: string[];
     knowledge?: (string | {
+        shared?: boolean;
         path?: string;
+    } | {
         shared?: boolean;
+        directory?: string;
     })[];
     settings?: {
         model?: string;
@@ -2808,15 +2920,16 @@ declare const CharacterSchema: z.ZodObject<{
         };
         embeddingModel?: string;
     };
-    system?: string;
-    id?: string;
+    modelProvider?: ModelProviderName;
     name?: string;
+    id?: string;
+    system?: string;
     topics?: string[];
     clients?: Clients[];
-    modelProvider?: ModelProviderName;
     modelEndpointOverride?: string;
     templates?: Record<string, string>;
     messageExamples?: {
+        user?: string;
         content?: {
             text?: string;
             action?: string;
@@ -2825,15 +2938,14 @@ declare const CharacterSchema: z.ZodObject<{
             inReplyTo?: string;
             attachments?: any[];
         } & Record<string, unknown>;
-        user?: string;
     }[][];
     postExamples?: string[];
     adjectives?: string[];
     plugins?: string[] | {
         actions?: any[];
         providers?: any[];
-        description?: string;
         name?: string;
+        description?: string;
         evaluators?: any[];
         services?: any[];
         clients?: any[];
@@ -2923,6 +3035,10 @@ declare class RAGKnowledgeManager implements IRAGKnowledgeManager {
      * The name of the database table this manager operates on.
      */
     tableName: string;
+    /**
+     * The root directory where RAG knowledge files are located (internal)
+     */
+    knowledgeRoot: string;
     /**
      * Constructs a new KnowledgeManager instance.
      * @param opts Options for the manager.
@@ -2932,6 +3048,7 @@ declare class RAGKnowledgeManager implements IRAGKnowledgeManager {
     constructor(opts: {
         tableName: string;
         runtime: IAgentRuntime;
+        knowledgeRoot: string;
     });
     private readonly defaultRAGMatchThreshold;
     private readonly defaultRAGMatchCount;
@@ -2967,6 +3084,16 @@ declare class RAGKnowledgeManager implements IRAGKnowledgeManager {
     }): Promise<RAGKnowledgeItem[]>;
     removeKnowledge(id: UUID): Promise<void>;
     clearKnowledge(shared?: boolean): Promise<void>;
+    /**
+     * Lists all knowledge entries for an agent without semantic search or reranking.
+     * Used primarily for administrative tasks like cleanup.
+     *
+     * @param agentId The agent ID to fetch knowledge entries for
+     * @returns Array of RAGKnowledgeItem entries
+     */
+    listAllKnowledge(agentId: UUID): Promise<RAGKnowledgeItem[]>;
+    cleanupDeletedKnowledgeFiles(): Promise<void>;
+    generateScopedId(path: string, isShared: boolean): UUID;
     processFile(file: {
         path: string;
         content: string;
@@ -2975,4 +3102,4 @@ declare class RAGKnowledgeManager implements IRAGKnowledgeManager {
     }): 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 };
+export { type Account, type Action, type ActionExample, type ActionResponse, ActionTimelineType, type Actor, AgentRuntime, CacheKeyPrefix, CacheManager, type CacheOptions, CacheStore, type Character, type CharacterConfig, CharacterSchema, type ChunkRow, type Client, Clients, type Content, type ConversationExample, type DataIrysFetchedFromGQL, DatabaseAdapter, DbCacheAdapter, type DirectoryItem, 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, KnowledgeScope, 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, Service, ServiceType, type State, type TelemetrySettings, type TemplateType, TokenizerType, TranscriptionProvider, type TwitterSpaceDecisionOptions, type UUID, type UploadIrysResult, type Validator, type VerifiableInferenceOptions, VerifiableInferenceProvider, type VerifiableInferenceResult, addHeader, booleanFooter, cleanJsonResponse, composeActionExamples, composeContext, composeRandomUser, configureSettings, createGoal, createRelationship, defaultCharacter, elizaLogger, embed, envSchema, evaluationTemplate, extractAttributes, findNearestEnvFile, formatActionNames, formatActions, formatActors, formatEvaluatorExampleDescriptions, formatEvaluatorExamples, formatEvaluatorNames, formatEvaluators, formatGoalsAsString, formatMessages, formatPosts, formatRelationships, formatTimestamp, generateCaption, generateImage, generateMessageResponse, generateObject, generateObjectArray, generateObjectDeprecated, generateShouldRespond, generateText, generateTextArray, generateTrueOrFalse, generateTweetActions, getActorDetails, getEmbeddingConfig, getEmbeddingModelSettings, getEmbeddingType, getEmbeddingZeroVector, getEndpoint, getEnvVariable, getGoals, getImageModelSettings, getModelSettings, getProviders, getRelationship, getRelationships, handleProvider, hasEnvVariable, _default as knowledge, loadEnvConfig, messageCompletionFooter, models, normalizeJsonString, parseActionResponseFromText, parseBooleanFromText, parseJSONObjectFromText, parseJsonArrayFromText, parseShouldRespondFromText, postActionResponseFooter, settings, shouldRespondFooter, splitChunks, stringArrayFooter, stringToUuid, trimTokens, truncateToCompleteSentence, updateGoal, uuidSchema, validateCharacterConfig, validateEnv, validateUuid };