@hashgraphonline/conversational-agent 0.1.209 → 0.1.211

package/dist/cjs/index.d.ts

@@ -1,7 +1,7 @@
 export { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';
 export { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';
 export { InscribePlugin } from './plugins/inscribe/InscribePlugin';
-export { HbarTransferPlugin } from './plugins/hbar-transfer/HbarTransferPlugin';
+export { HbarPlugin } from './plugins/hbar/HbarPlugin';
 export { HCS10Plugin as OpenConvAIPlugin } from './plugins/hcs-10/HCS10Plugin';
 export { ConversationalAgent } from './conversational-agent';
 export type { ConversationalAgentOptions } from './conversational-agent';
@@ -11,6 +11,8 @@ export { createAgent } from './agent-factory';
 export { LangChainProvider, type AIProvider, type VercelAIProvider, type BAMLProvider, } from './providers';
 export * from 'hedera-agent-kit';
 export type { IStateManager } from '@hashgraphonline/standards-agent-kit';
-export type { MCPServerConfig, MCPConnectionStatus, MCPToolInfo } from './mcp/types';
-export { MCPServers, createMCPConfig, validateServerConfig } from './mcp/helpers';
+export type { MCPServerConfig, MCPConnectionStatus, MCPToolInfo, } from './mcp/types';
+export { MCPServers, createMCPConfig, validateServerConfig, } from './mcp/helpers';
 export * from './memory';
+export { createEntityTools, ResolveEntitiesTool, ExtractEntitiesTool, } from './tools/EntityResolverTool';
+export { ContentStoreManager } from './services/ContentStoreManager';

package/dist/cjs/langchain-agent.d.ts

@@ -1,10 +1,12 @@
 import { BaseAgent, ConversationContext, ChatResponse, OperationalMode, UsageStats } from './base-agent';
+import { MCPConnectionStatus } from './mcp/types';
 
 export declare class LangChainAgent extends BaseAgent {
     private executor;
     private systemMessage;
     private mcpManager?;
     private smartMemory;
+    private mcpConnectionStatus;
     boot(): Promise<void>;
     chat(message: string, context?: ConversationContext): Promise<ChatResponse>;
     shutdown(): Promise<void>;
@@ -12,18 +14,19 @@ export declare class LangChainAgent extends BaseAgent {
     getUsageStats(): UsageStats;
     getUsageLog(): UsageStats[];
     clearUsageStats(): void;
+    getMCPConnectionStatus(): Map<string, MCPConnectionStatus>;
     private createAgentKit;
     private createExecutor;
     private handleError;
     private initializeMCP;
     /**
-     * Connect to MCP servers asynchronously after agent boot
+     * Connect to MCP servers asynchronously after agent boot with background timeout pattern
      */
     connectMCPServers(): Promise<void>;
     /**
-     * Connect to a single MCP server
+     * Connect to a single MCP server in background with timeout
      */
-    private connectServer;
+    private connectServerInBackground;
     /**
      * Check if a string is valid JSON
      */

package/dist/cjs/memory/SmartMemoryManager.d.ts

@@ -69,16 +69,22 @@ export interface MemoryStats {
     usagePercentage: number;
 }
 /**
+ * TODO: investigate using chroma / rag for long term memory
  * Smart memory manager that combines active memory window with long-term storage
  * Provides context-aware memory management with automatic pruning and searchable history
  */
 export declare class SmartMemoryManager {
     private memoryWindow;
-    private contentStorage;
+    private _contentStorage;
     private tokenCounter;
     private config;
     private static readonly DEFAULT_CONFIG;
     constructor(config?: SmartMemoryConfig);
+    /**
+     * Get the content storage instance for file/content reference operations
+     * @returns ContentStorage instance
+     */
+    get contentStorage(): ContentStorage;
     /**
      * Add a message to the active memory window
      * Automatically handles pruning and storage of displaced messages

package/dist/cjs/memory/TokenCounter.d.ts

@@ -10,7 +10,7 @@ export declare class TokenCounter {
     private modelName;
     private static readonly MESSAGE_OVERHEAD;
     private static readonly ROLE_OVERHEAD;
-    constructor(modelName?: TiktokenModel);
+    constructor(modelName?: string | TiktokenModel);
     /**
      * Count tokens in raw text content
      * @param text - The text to count tokens for

package/dist/cjs/plugins/hbar/AirdropToolWrapper.d.ts

@@ -0,0 +1,43 @@
+import { StructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+
+export declare class AirdropToolWrapper extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        tokenId: z.ZodString;
+        recipients: z.ZodArray<z.ZodObject<{
+            accountId: z.ZodString;
+            amount: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+        }, "strip", z.ZodTypeAny, {
+            accountId: string;
+            amount: string | number;
+        }, {
+            accountId: string;
+            amount: string | number;
+        }>, "many">;
+        memo: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        tokenId: string;
+        recipients: {
+            accountId: string;
+            amount: string | number;
+        }[];
+        memo?: string | undefined;
+    }, {
+        tokenId: string;
+        recipients: {
+            accountId: string;
+            amount: string | number;
+        }[];
+        memo?: string | undefined;
+    }>;
+    private originalTool;
+    private agentKit;
+    private logger;
+    constructor(originalTool: StructuredTool, agentKit: unknown);
+    _call(input: z.infer<typeof this.schema>): Promise<string>;
+    private convertToSmallestUnits;
+    private getTokenInfo;
+    private queryTokenInfo;
+}

package/dist/{types/plugins/hbar-transfer/HbarTransferPlugin.d.ts → cjs/plugins/hbar/HbarPlugin.d.ts}

@@ -1,6 +1,6 @@
 import { GenericPluginContext, HederaTool, BasePlugin } from 'hedera-agent-kit';
 
-export declare class HbarTransferPlugin extends BasePlugin {
+export declare class HbarPlugin extends BasePlugin {
     id: string;
     name: string;
     description: string;
@@ -8,6 +8,7 @@ export declare class HbarTransferPlugin extends BasePlugin {
     author: string;
     namespace: string;
     private tools;
+    private originalAirdropTool;
     initialize(context: GenericPluginContext): Promise<void>;
     private initializeTools;
     getTools(): HederaTool[];

package/dist/{types/plugins/hbar-transfer → cjs/plugins/hbar}/TransferHbarTool.d.ts

@@ -29,7 +29,7 @@ declare const TransferHbarZodSchemaCore: z.ZodObject<{
 /**
  * A Hedera transaction tool for transferring HBAR between accounts.
  * Supports single and multi-party transfers with automatic balance validation.
- * Extends BaseHederaTransactionTool to handle HBAR transfer transactions on the Hedera network.
+ * Extends BaseHederaTransactionTool to handle HBAR transfer transactions on the Hedera Hashgraph.
  */
 export declare class TransferHbarTool extends BaseHederaTransactionTool<typeof TransferHbarZodSchemaCore> {
     name: string;

package/dist/cjs/plugins/hbar/index.d.ts

@@ -0,0 +1,3 @@
+export * from './TransferHbarTool';
+export * from './AccountBuilder';
+export * from './types';

package/dist/cjs/plugins/index.d.ts

@@ -1,4 +1,5 @@
 export { HCS10Plugin } from './hcs-10';
 export { HCS2Plugin } from './hcs-2';
 export { InscribePlugin } from './inscribe';
-export { HbarTransferPlugin } from './hbar-transfer';
+export { HbarPlugin } from './hbar/HbarPlugin';
+export * from './hbar';

package/dist/cjs/services/EntityResolver.d.ts

@@ -0,0 +1,26 @@
+import { EntityAssociation } from '../memory/SmartMemoryManager';
+
+export interface EntityResolverConfig {
+    apiKey: string;
+    modelName?: string;
+}
+/**
+ * LLM-based entity resolver that replaces brittle regex patterns
+ */
+export declare class EntityResolver {
+    private llm;
+    constructor(config: EntityResolverConfig);
+    /**
+     * Resolve entity references using LLM instead of regex
+     */
+    resolveReferences(message: string, entities: EntityAssociation[]): Promise<string>;
+    /**
+     * Extract entities from agent response using LLM
+     */
+    extractEntities(response: unknown, userMessage: string): Promise<Array<{
+        id: string;
+        name: string;
+        type: string;
+        transactionId?: string;
+    }>>;
+}

package/dist/cjs/tools/EntityResolverTool.d.ts

@@ -0,0 +1,104 @@
+import { StructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+
+declare const ResolveEntitiesSchema: z.ZodObject<{
+    message: z.ZodString;
+    entities: z.ZodArray<z.ZodObject<{
+        entityId: z.ZodString;
+        entityName: z.ZodString;
+        entityType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        entityName: string;
+        entityType: string;
+    }, {
+        entityId: string;
+        entityName: string;
+        entityType: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    entities: {
+        entityId: string;
+        entityName: string;
+        entityType: string;
+    }[];
+}, {
+    message: string;
+    entities: {
+        entityId: string;
+        entityName: string;
+        entityType: string;
+    }[];
+}>;
+declare const ExtractEntitiesSchema: z.ZodObject<{
+    response: z.ZodString;
+    userMessage: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    response: string;
+    userMessage: string;
+}, {
+    response: string;
+    userMessage: string;
+}>;
+export declare class ResolveEntitiesTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        message: z.ZodString;
+        entities: z.ZodArray<z.ZodObject<{
+            entityId: z.ZodString;
+            entityName: z.ZodString;
+            entityType: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            entityId: string;
+            entityName: string;
+            entityType: string;
+        }, {
+            entityId: string;
+            entityName: string;
+            entityType: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        entities: {
+            entityId: string;
+            entityName: string;
+            entityType: string;
+        }[];
+    }, {
+        message: string;
+        entities: {
+            entityId: string;
+            entityName: string;
+            entityType: string;
+        }[];
+    }>;
+    private llm;
+    constructor(apiKey: string, modelName?: string);
+    _call(input: z.infer<typeof ResolveEntitiesSchema>): Promise<string>;
+    private groupEntitiesByType;
+    private buildEntityContext;
+}
+export declare class ExtractEntitiesTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        response: z.ZodString;
+        userMessage: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        response: string;
+        userMessage: string;
+    }, {
+        response: string;
+        userMessage: string;
+    }>;
+    private llm;
+    constructor(apiKey: string, modelName?: string);
+    _call(input: z.infer<typeof ExtractEntitiesSchema>): Promise<string>;
+}
+export declare function createEntityTools(apiKey: string, modelName?: string): {
+    resolveEntities: ResolveEntitiesTool;
+    extractEntities: ExtractEntitiesTool;
+};
+export {};

package/dist/cjs/types/inscription.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Inscription quote response from standards-agent-kit
+ */
+export interface InscriptionQuote {
+    totalCostHbar: string;
+    validUntil: string;
+    breakdown: {
+        transfers: Array<{
+            type: string;
+            amount: string;
+            description: string;
+        }>;
+    };
+}
+/**
+ * Parameters for inscription tool calls with quote support
+ */
+export interface InscriptionToolParams {
+    [key: string]: unknown;
+    quoteOnly?: boolean;
+}
+/**
+ * Result from inscription tool execution
+ */
+export interface InscriptionResult {
+    success: boolean;
+    transactionId?: string;
+    message: string;
+    quote?: InscriptionQuote;
+}
+/**
+ * User confirmation status for inscription
+ */
+export interface InscriptionConfirmation {
+    confirmed: boolean;
+    reason?: string;
+}

package/dist/esm/index.js

@@ -1,7 +1,7 @@
 import { HCS10Plugin, HCS10Plugin as HCS10Plugin2 } from "./index2.js";
 import { HCS2Plugin } from "./index3.js";
 import { InscribePlugin } from "./index4.js";
-import { HbarTransferPlugin } from "./index5.js";
+import { HbarPlugin } from "./index5.js";
 import { ConversationalAgent } from "./index6.js";
 import { BaseAgent } from "./index7.js";
 import { LangChainAgent } from "./index8.js";
@@ -13,22 +13,28 @@ import { TokenCounter } from "./index12.js";
 import { MemoryWindow } from "./index13.js";
 import { ContentStorage } from "./index14.js";
 import { SmartMemoryManager } from "./index15.js";
+import { ExtractEntitiesTool, ResolveEntitiesTool, createEntityTools } from "./index16.js";
+import { ContentStoreManager } from "./index17.js";
 export {
   BaseAgent,
   ContentStorage,
+  ContentStoreManager,
   ConversationalAgent,
+  ExtractEntitiesTool,
   HCS10Plugin,
   HCS2Plugin,
-  HbarTransferPlugin,
+  HbarPlugin,
   InscribePlugin,
   LangChainAgent,
   LangChainProvider,
   MCPServers,
   MemoryWindow,
   HCS10Plugin2 as OpenConvAIPlugin,
+  ResolveEntitiesTool,
   SmartMemoryManager,
   TokenCounter,
   createAgent,
+  createEntityTools,
   createMCPConfig,
   validateServerConfig
 };

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;"}

package/dist/esm/index12.js

@@ -1,11 +1,10 @@
 import { encoding_for_model } from "tiktoken";
 const _TokenCounter = class _TokenCounter {
   constructor(modelName = "gpt-4o") {
-    this.modelName = modelName;
+    this.modelName = String(modelName);
     try {
       this.encoding = encoding_for_model(modelName);
     } catch {
-      console.warn(`Model ${modelName} not found, falling back to gpt-4o encoding`);
       this.encoding = encoding_for_model("gpt-4o");
       this.modelName = "gpt-4o";
     }
@@ -23,7 +22,6 @@ const _TokenCounter = class _TokenCounter {
       const tokens = this.encoding.encode(text);
       return tokens.length;
     } catch (error) {
-      console.warn("Error counting tokens, falling back to word-based estimation:", error);
       return Math.ceil(text.split(/\s+/).length * 1.3);
     }
   }
@@ -114,7 +112,6 @@ const _TokenCounter = class _TokenCounter {
     try {
       this.encoding.free();
     } catch {
-      console.warn("Error disposing encoding");
     }
   }
 };

package/dist/esm/index12.js.map

@@ -1 +1 @@
-{"version":3,"file":"index12.js","sources":["../../src/memory/TokenCounter.ts"],"sourcesContent":["import { encoding_for_model } from 'tiktoken';\nimport type { TiktokenModel } from 'tiktoken';\nimport type { BaseMessage } from '@langchain/core/messages';\n\n/**\n * Token counter utility for OpenAI models using tiktoken encoding\n * Provides accurate token counting for text content and chat messages\n */\nexport class TokenCounter {\n  private encoding: ReturnType<typeof encoding_for_model>;\n  private modelName: TiktokenModel;\n\n  private static readonly MESSAGE_OVERHEAD = 3;\n  private static readonly ROLE_OVERHEAD = 1;\n\n  constructor(modelName: TiktokenModel = 'gpt-4o') {\n    this.modelName = modelName;\n    try {\n      this.encoding = encoding_for_model(modelName);\n    } catch {\n      console.warn(`Model ${modelName} not found, falling back to gpt-4o encoding`);\n      this.encoding = encoding_for_model('gpt-4o');\n      this.modelName = 'gpt-4o';\n    }\n  }\n\n  /**\n   * Count tokens in raw text content\n   * @param text - The text to count tokens for\n   * @returns Number of tokens\n   */\n  countTokens(text: string): number {\n    if (!text || text.trim() === '') {\n      return 0;\n    }\n\n    try {\n      const tokens = this.encoding.encode(text);\n      return tokens.length;\n    } catch (error) {\n      console.warn('Error counting tokens, falling back to word-based estimation:', error);\n      return Math.ceil(text.split(/\\s+/).length * 1.3);\n    }\n  }\n\n  /**\n   * Count tokens for a single chat message including role overhead\n   * @param message - The message to count tokens for\n   * @returns Number of tokens including message formatting overhead\n   */\n  countMessageTokens(message: BaseMessage): number {\n    const contentTokens = this.countTokens(String(message.content ?? ''));\n    const roleTokens = this.countTokens(this.getMessageRole(message));\n    \n    return contentTokens + roleTokens + TokenCounter.MESSAGE_OVERHEAD + TokenCounter.ROLE_OVERHEAD;\n  }\n\n  /**\n   * Count tokens for multiple messages\n   * @param messages - Array of messages to count\n   * @returns Total token count for all messages\n   */\n  countMessagesTokens(messages: BaseMessage[]): number {\n    if (!messages || messages.length === 0) {\n      return 0;\n    }\n\n    let total = 0;\n    for (const message of messages) {\n      total += this.countMessageTokens(message);\n    }\n    return total;\n  }\n\n  /**\n   * Estimate tokens for system prompt\n   * System prompts have slightly different overhead in chat completions\n   * @param systemPrompt - The system prompt text\n   * @returns Estimated token count\n   */\n  estimateSystemPromptTokens(systemPrompt: string): number {\n    if (!systemPrompt || systemPrompt.trim() === '') {\n      return 0;\n    }\n\n    const contentTokens = this.countTokens(systemPrompt);\n    const roleTokens = this.countTokens('system');\n    \n    return contentTokens + roleTokens + TokenCounter.MESSAGE_OVERHEAD + TokenCounter.ROLE_OVERHEAD;\n  }\n\n  /**\n   * Get total context size estimate including system prompt and messages\n   * @param systemPrompt - System prompt text\n   * @param messages - Conversation messages\n   * @returns Total estimated token count\n   */\n  estimateContextSize(systemPrompt: string, messages: BaseMessage[]): number {\n    const systemTokens = this.estimateSystemPromptTokens(systemPrompt);\n    const messageTokens = this.countMessagesTokens(messages);\n    \n    const completionOverhead = 10;\n    \n    return systemTokens + messageTokens + completionOverhead;\n  }\n\n  /**\n   * Get the role string for a message\n   * @param message - The message to get the role for\n   * @returns Role string ('user', 'assistant', 'system', etc.)\n   */\n  private getMessageRole(message: BaseMessage): string {\n    const messageType = message._getType();\n    switch (messageType) {\n      case 'human':\n        return 'user';\n      case 'ai':\n        return 'assistant';\n      case 'system':\n        return 'system';\n      case 'function':\n        return 'function';\n      case 'tool':\n        return 'tool';\n      default:\n        return 'user';\n    }\n  }\n\n  /**\n   * Get the model name being used for token counting\n   * @returns The tiktoken model name\n   */\n  getModelName(): string {\n    return this.modelName;\n  }\n\n  /**\n   * Clean up encoding resources\n   */\n  dispose(): void {\n    try {\n      this.encoding.free();\n    } catch {\n      console.warn('Error disposing encoding');\n    }\n  }\n}"],"names":[],"mappings":";AAQO,MAAM,gBAAN,MAAM,cAAa;AAAA,EAOxB,YAAY,YAA2B,UAAU;AAC/C,SAAK,YAAY;AACjB,QAAI;AACF,WAAK,WAAW,mBAAmB,SAAS;AAAA,IAC9C,QAAQ;AACN,cAAQ,KAAK,SAAS,SAAS,6CAA6C;AAC5E,WAAK,WAAW,mBAAmB,QAAQ;AAC3C,WAAK,YAAY;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAY,MAAsB;AAChC,QAAI,CAAC,QAAQ,KAAK,KAAA,MAAW,IAAI;AAC/B,aAAO;AAAA,IACT;AAEA,QAAI;AACF,YAAM,SAAS,KAAK,SAAS,OAAO,IAAI;AACxC,aAAO,OAAO;AAAA,IAChB,SAAS,OAAO;AACd,cAAQ,KAAK,iEAAiE,KAAK;AACnF,aAAO,KAAK,KAAK,KAAK,MAAM,KAAK,EAAE,SAAS,GAAG;AAAA,IACjD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB,SAA8B;AAC/C,UAAM,gBAAgB,KAAK,YAAY,OAAO,QAAQ,WAAW,EAAE,CAAC;AACpE,UAAM,aAAa,KAAK,YAAY,KAAK,eAAe,OAAO,CAAC;AAEhE,WAAO,gBAAgB,aAAa,cAAa,mBAAmB,cAAa;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,oBAAoB,UAAiC;AACnD,QAAI,CAAC,YAAY,SAAS,WAAW,GAAG;AACtC,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ;AACZ,eAAW,WAAW,UAAU;AAC9B,eAAS,KAAK,mBAAmB,OAAO;AAAA,IAC1C;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,2BAA2B,cAA8B;AACvD,QAAI,CAAC,gBAAgB,aAAa,KAAA,MAAW,IAAI;AAC/C,aAAO;AAAA,IACT;AAEA,UAAM,gBAAgB,KAAK,YAAY,YAAY;AACnD,UAAM,aAAa,KAAK,YAAY,QAAQ;AAE5C,WAAO,gBAAgB,aAAa,cAAa,mBAAmB,cAAa;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,cAAsB,UAAiC;AACzE,UAAM,eAAe,KAAK,2BAA2B,YAAY;AACjE,UAAM,gBAAgB,KAAK,oBAAoB,QAAQ;AAEvD,UAAM,qBAAqB;AAE3B,WAAO,eAAe,gBAAgB;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,eAAe,SAA8B;AACnD,UAAM,cAAc,QAAQ,SAAA;AAC5B,YAAQ,aAAA;AAAA,MACN,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT;AACE,eAAO;AAAA,IAAA;AAAA,EAEb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAuB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,QAAI;AACF,WAAK,SAAS,KAAA;AAAA,IAChB,QAAQ;AACN,cAAQ,KAAK,0BAA0B;AAAA,IACzC;AAAA,EACF;AACF;AAvIE,cAAwB,mBAAmB;AAC3C,cAAwB,gBAAgB;AALnC,IAAM,eAAN;"}
+{"version":3,"file":"index12.js","sources":["../../src/memory/TokenCounter.ts"],"sourcesContent":["import { encoding_for_model } from 'tiktoken';\nimport type { TiktokenModel } from 'tiktoken';\nimport type { BaseMessage } from '@langchain/core/messages';\n\n/**\n * Token counter utility for OpenAI models using tiktoken encoding\n * Provides accurate token counting for text content and chat messages\n */\nexport class TokenCounter {\n  private encoding: ReturnType<typeof encoding_for_model>;\n  private modelName: string;\n\n  private static readonly MESSAGE_OVERHEAD = 3;\n  private static readonly ROLE_OVERHEAD = 1;\n\n  constructor(modelName: string | TiktokenModel = 'gpt-4o') {\n    this.modelName = String(modelName);\n    try {\n      this.encoding = encoding_for_model(modelName as TiktokenModel);\n    } catch {\n      this.encoding = encoding_for_model('gpt-4o');\n      this.modelName = 'gpt-4o';\n    }\n  }\n\n  /**\n   * Count tokens in raw text content\n   * @param text - The text to count tokens for\n   * @returns Number of tokens\n   */\n  countTokens(text: string): number {\n    if (!text || text.trim() === '') {\n      return 0;\n    }\n\n    try {\n      const tokens = this.encoding.encode(text);\n      return tokens.length;\n    } catch (error) {\n      return Math.ceil(text.split(/\\s+/).length * 1.3);\n    }\n  }\n\n  /**\n   * Count tokens for a single chat message including role overhead\n   * @param message - The message to count tokens for\n   * @returns Number of tokens including message formatting overhead\n   */\n  countMessageTokens(message: BaseMessage): number {\n    const contentTokens = this.countTokens(String(message.content ?? ''));\n    const roleTokens = this.countTokens(this.getMessageRole(message));\n    \n    return contentTokens + roleTokens + TokenCounter.MESSAGE_OVERHEAD + TokenCounter.ROLE_OVERHEAD;\n  }\n\n  /**\n   * Count tokens for multiple messages\n   * @param messages - Array of messages to count\n   * @returns Total token count for all messages\n   */\n  countMessagesTokens(messages: BaseMessage[]): number {\n    if (!messages || messages.length === 0) {\n      return 0;\n    }\n\n    let total = 0;\n    for (const message of messages) {\n      total += this.countMessageTokens(message);\n    }\n    return total;\n  }\n\n  /**\n   * Estimate tokens for system prompt\n   * System prompts have slightly different overhead in chat completions\n   * @param systemPrompt - The system prompt text\n   * @returns Estimated token count\n   */\n  estimateSystemPromptTokens(systemPrompt: string): number {\n    if (!systemPrompt || systemPrompt.trim() === '') {\n      return 0;\n    }\n\n    const contentTokens = this.countTokens(systemPrompt);\n    const roleTokens = this.countTokens('system');\n    \n    return contentTokens + roleTokens + TokenCounter.MESSAGE_OVERHEAD + TokenCounter.ROLE_OVERHEAD;\n  }\n\n  /**\n   * Get total context size estimate including system prompt and messages\n   * @param systemPrompt - System prompt text\n   * @param messages - Conversation messages\n   * @returns Total estimated token count\n   */\n  estimateContextSize(systemPrompt: string, messages: BaseMessage[]): number {\n    const systemTokens = this.estimateSystemPromptTokens(systemPrompt);\n    const messageTokens = this.countMessagesTokens(messages);\n    \n    const completionOverhead = 10;\n    \n    return systemTokens + messageTokens + completionOverhead;\n  }\n\n  /**\n   * Get the role string for a message\n   * @param message - The message to get the role for\n   * @returns Role string ('user', 'assistant', 'system', etc.)\n   */\n  private getMessageRole(message: BaseMessage): string {\n    const messageType = message._getType();\n    switch (messageType) {\n      case 'human':\n        return 'user';\n      case 'ai':\n        return 'assistant';\n      case 'system':\n        return 'system';\n      case 'function':\n        return 'function';\n      case 'tool':\n        return 'tool';\n      default:\n        return 'user';\n    }\n  }\n\n  /**\n   * Get the model name being used for token counting\n   * @returns The tiktoken model name\n   */\n  getModelName(): string {\n    return this.modelName;\n  }\n\n  /**\n   * Clean up encoding resources\n   */\n  dispose(): void {\n    try {\n      this.encoding.free();\n    } catch {\n    }\n  }\n}"],"names":[],"mappings":";AAQO,MAAM,gBAAN,MAAM,cAAa;AAAA,EAOxB,YAAY,YAAoC,UAAU;AACxD,SAAK,YAAY,OAAO,SAAS;AACjC,QAAI;AACF,WAAK,WAAW,mBAAmB,SAA0B;AAAA,IAC/D,QAAQ;AACN,WAAK,WAAW,mBAAmB,QAAQ;AAC3C,WAAK,YAAY;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAY,MAAsB;AAChC,QAAI,CAAC,QAAQ,KAAK,KAAA,MAAW,IAAI;AAC/B,aAAO;AAAA,IACT;AAEA,QAAI;AACF,YAAM,SAAS,KAAK,SAAS,OAAO,IAAI;AACxC,aAAO,OAAO;AAAA,IAChB,SAAS,OAAO;AACd,aAAO,KAAK,KAAK,KAAK,MAAM,KAAK,EAAE,SAAS,GAAG;AAAA,IACjD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB,SAA8B;AAC/C,UAAM,gBAAgB,KAAK,YAAY,OAAO,QAAQ,WAAW,EAAE,CAAC;AACpE,UAAM,aAAa,KAAK,YAAY,KAAK,eAAe,OAAO,CAAC;AAEhE,WAAO,gBAAgB,aAAa,cAAa,mBAAmB,cAAa;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,oBAAoB,UAAiC;AACnD,QAAI,CAAC,YAAY,SAAS,WAAW,GAAG;AACtC,aAAO;AAAA,IACT;AAEA,QAAI,QAAQ;AACZ,eAAW,WAAW,UAAU;AAC9B,eAAS,KAAK,mBAAmB,OAAO;AAAA,IAC1C;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,2BAA2B,cAA8B;AACvD,QAAI,CAAC,gBAAgB,aAAa,KAAA,MAAW,IAAI;AAC/C,aAAO;AAAA,IACT;AAEA,UAAM,gBAAgB,KAAK,YAAY,YAAY;AACnD,UAAM,aAAa,KAAK,YAAY,QAAQ;AAE5C,WAAO,gBAAgB,aAAa,cAAa,mBAAmB,cAAa;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,cAAsB,UAAiC;AACzE,UAAM,eAAe,KAAK,2BAA2B,YAAY;AACjE,UAAM,gBAAgB,KAAK,oBAAoB,QAAQ;AAEvD,UAAM,qBAAqB;AAE3B,WAAO,eAAe,gBAAgB;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,eAAe,SAA8B;AACnD,UAAM,cAAc,QAAQ,SAAA;AAC5B,YAAQ,aAAA;AAAA,MACN,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT;AACE,eAAO;AAAA,IAAA;AAAA,EAEb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAuB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,QAAI;AACF,WAAK,SAAS,KAAA;AAAA,IAChB,QAAQ;AAAA,IACR;AAAA,EACF;AACF;AApIE,cAAwB,mBAAmB;AAC3C,cAAwB,gBAAgB;AALnC,IAAM,eAAN;"}

package/dist/esm/index13.js

@@ -51,7 +51,6 @@ const _MemoryWindow = class _MemoryWindow {
         }
       }
       if (prunedMessages.length > 1e3) {
-        console.warn("MemoryWindow: Excessive pruning detected, stopping to prevent infinite loop");
         break;
       }
     }

package/dist/esm/index13.js.map

@@ -1 +1 @@
-{"version":3,"file":"index13.js","sources":["../../src/memory/MemoryWindow.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport { TokenCounter } from './TokenCounter';\n\n/**\n * Result of adding a message to the memory window\n */\nexport interface AddMessageResult {\n  /** Whether the message was successfully added */\n  added: boolean;\n  /** Messages that were pruned to make room */\n  prunedMessages: BaseMessage[];\n  /** Current token count after operation */\n  currentTokenCount: number;\n  /** Remaining token capacity */\n  remainingCapacity: number;\n}\n\n/**\n * Memory window that manages conversation history with token-based size limits\n * Automatically prunes old messages to stay within token limits while preserving conversational context\n */\nexport class MemoryWindow {\n  private messages: BaseMessage[] = [];\n  private maxTokens: number;\n  private reserveTokens: number;\n  private tokenCounter: TokenCounter;\n  private systemPrompt: string = '';\n  private systemPromptTokens: number = 0;\n\n  public static readonly DEFAULT_MAX_TOKENS = 8000;\n  public static readonly DEFAULT_RESERVE_TOKENS = 1000;\n  public static readonly PRUNING_BATCH_SIZE = 2;\n\n  constructor(\n    maxTokens: number = MemoryWindow.DEFAULT_MAX_TOKENS,\n    reserveTokens: number = MemoryWindow.DEFAULT_RESERVE_TOKENS,\n    tokenCounter?: TokenCounter\n  ) {\n    if (reserveTokens >= maxTokens) {\n      throw new Error('Reserve tokens must be less than max tokens');\n    }\n\n    this.maxTokens = maxTokens;\n    this.reserveTokens = reserveTokens;\n    this.tokenCounter = tokenCounter || new TokenCounter();\n  }\n\n  /**\n   * Add a message to the memory window, pruning old messages if necessary\n   * @param message - The message to add\n   * @returns Result of the add operation including any pruned messages\n   */\n  addMessage(message: BaseMessage): AddMessageResult {\n    this.tokenCounter.countMessageTokens(message);\n    \n    this.messages.push(message);\n    \n    const currentTokens = this.getCurrentTokenCount();\n    const availableTokens = this.maxTokens - this.reserveTokens;\n    \n    let prunedMessages: BaseMessage[] = [];\n    \n    if (currentTokens > availableTokens) {\n      this.messages.pop();\n      \n      prunedMessages = this.pruneToFit();\n      \n      this.messages.push(message);\n    }\n\n    return {\n      added: true,\n      prunedMessages,\n      currentTokenCount: this.getCurrentTokenCount(),\n      remainingCapacity: this.getRemainingTokenCapacity()\n    };\n  }\n\n  /**\n   * Prune old messages to fit within token limits\n   * Removes messages in pairs to maintain conversational flow\n   * @returns Array of pruned messages\n   */\n  pruneToFit(): BaseMessage[] {\n    const prunedMessages: BaseMessage[] = [];\n    const targetTokens = this.maxTokens - this.reserveTokens;\n    \n    while (this.getCurrentTokenCount() > targetTokens && this.messages.length > 0) {\n      const batchSize = Math.min(MemoryWindow.PRUNING_BATCH_SIZE, this.messages.length);\n      \n      for (let i = 0; i < batchSize; i++) {\n        const prunedMessage = this.messages.shift();\n        if (prunedMessage) {\n          prunedMessages.push(prunedMessage);\n        }\n      }\n      \n      if (prunedMessages.length > 1000) {\n        console.warn('MemoryWindow: Excessive pruning detected, stopping to prevent infinite loop');\n        break;\n      }\n    }\n\n    return prunedMessages;\n  }\n\n  /**\n   * Get current token count including system prompt and messages\n   * @returns Current token count\n   */\n  getCurrentTokenCount(): number {\n    const messageTokens = this.tokenCounter.countMessagesTokens(this.messages);\n    return this.systemPromptTokens + messageTokens;\n  }\n\n  /**\n   * Get remaining token capacity before hitting the reserve limit\n   * @returns Remaining tokens that can be used\n   */\n  getRemainingTokenCapacity(): number {\n    return Math.max(0, this.maxTokens - this.getCurrentTokenCount());\n  }\n\n  /**\n   * Check if a message can be added without exceeding limits\n   * @param message - The message to check\n   * @returns True if message can be added within reserve limits\n   */\n  canAddMessage(message: BaseMessage): boolean {\n    const messageTokens = this.tokenCounter.countMessageTokens(message);\n    const currentTokens = this.getCurrentTokenCount();\n    const wouldExceedReserve = (currentTokens + messageTokens) > (this.maxTokens - this.reserveTokens);\n    \n    if (messageTokens > this.maxTokens) {\n      return false;\n    }\n    \n    return !wouldExceedReserve || this.messages.length > 0;\n  }\n\n  /**\n   * Get all messages in the memory window\n   * @returns Copy of current messages array\n   */\n  getMessages(): BaseMessage[] {\n    return [...this.messages];\n  }\n\n  /**\n   * Clear all messages from the memory window\n   */\n  clear(): void {\n    this.messages = [];\n  }\n\n  /**\n   * Set the system prompt and update token calculations\n   * @param systemPrompt - The system prompt text\n   */\n  setSystemPrompt(systemPrompt: string): void {\n    this.systemPrompt = systemPrompt;\n    this.systemPromptTokens = this.tokenCounter.estimateSystemPromptTokens(systemPrompt);\n  }\n\n  /**\n   * Get the current system prompt\n   * @returns Current system prompt\n   */\n  getSystemPrompt(): string {\n    return this.systemPrompt;\n  }\n\n  /**\n   * Get current configuration\n   * @returns Memory window configuration\n   */\n  getConfig() {\n    return {\n      maxTokens: this.maxTokens,\n      reserveTokens: this.reserveTokens,\n      currentTokens: this.getCurrentTokenCount(),\n      messageCount: this.messages.length,\n      systemPromptTokens: this.systemPromptTokens\n    };\n  }\n\n  /**\n   * Update token limits\n   * @param maxTokens - New maximum token limit\n   * @param reserveTokens - New reserve token amount\n   */\n  updateLimits(maxTokens: number, reserveTokens?: number): void {\n    if (reserveTokens !== undefined && reserveTokens >= maxTokens) {\n      throw new Error('Reserve tokens must be less than max tokens');\n    }\n\n    this.maxTokens = maxTokens;\n    if (reserveTokens !== undefined) {\n      this.reserveTokens = reserveTokens;\n    }\n\n    if (this.getCurrentTokenCount() > (this.maxTokens - this.reserveTokens)) {\n      this.pruneToFit();\n    }\n  }\n\n  /**\n   * Get statistics about the memory window\n   * @returns Memory usage statistics\n   */\n  getStats() {\n    const currentTokens = this.getCurrentTokenCount();\n    const capacity = this.maxTokens;\n    const usagePercentage = (currentTokens / capacity) * 100;\n    \n    return {\n      totalMessages: this.messages.length,\n      currentTokens,\n      maxTokens: capacity,\n      reserveTokens: this.reserveTokens,\n      systemPromptTokens: this.systemPromptTokens,\n      usagePercentage: Math.round(usagePercentage * 100) / 100,\n      remainingCapacity: this.getRemainingTokenCapacity(),\n      canAcceptMore: this.getRemainingTokenCapacity() > this.reserveTokens\n    };\n  }\n\n  /**\n   * Clean up resources\n   */\n  dispose(): void {\n    this.clear();\n    this.tokenCounter.dispose();\n  }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"index13.js","sources":["../../src/memory/MemoryWindow.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport { TokenCounter } from './TokenCounter';\n\n/**\n * Result of adding a message to the memory window\n */\nexport interface AddMessageResult {\n  /** Whether the message was successfully added */\n  added: boolean;\n  /** Messages that were pruned to make room */\n  prunedMessages: BaseMessage[];\n  /** Current token count after operation */\n  currentTokenCount: number;\n  /** Remaining token capacity */\n  remainingCapacity: number;\n}\n\n/**\n * Memory window that manages conversation history with token-based size limits\n * Automatically prunes old messages to stay within token limits while preserving conversational context\n */\nexport class MemoryWindow {\n  private messages: BaseMessage[] = [];\n  private maxTokens: number;\n  private reserveTokens: number;\n  private tokenCounter: TokenCounter;\n  private systemPrompt: string = '';\n  private systemPromptTokens: number = 0;\n\n  public static readonly DEFAULT_MAX_TOKENS = 8000;\n  public static readonly DEFAULT_RESERVE_TOKENS = 1000;\n  public static readonly PRUNING_BATCH_SIZE = 2;\n\n  constructor(\n    maxTokens: number = MemoryWindow.DEFAULT_MAX_TOKENS,\n    reserveTokens: number = MemoryWindow.DEFAULT_RESERVE_TOKENS,\n    tokenCounter?: TokenCounter\n  ) {\n    if (reserveTokens >= maxTokens) {\n      throw new Error('Reserve tokens must be less than max tokens');\n    }\n\n    this.maxTokens = maxTokens;\n    this.reserveTokens = reserveTokens;\n    this.tokenCounter = tokenCounter || new TokenCounter();\n  }\n\n  /**\n   * Add a message to the memory window, pruning old messages if necessary\n   * @param message - The message to add\n   * @returns Result of the add operation including any pruned messages\n   */\n  addMessage(message: BaseMessage): AddMessageResult {\n    this.tokenCounter.countMessageTokens(message);\n    \n    this.messages.push(message);\n    \n    const currentTokens = this.getCurrentTokenCount();\n    const availableTokens = this.maxTokens - this.reserveTokens;\n    \n    let prunedMessages: BaseMessage[] = [];\n    \n    if (currentTokens > availableTokens) {\n      this.messages.pop();\n      \n      prunedMessages = this.pruneToFit();\n      \n      this.messages.push(message);\n    }\n\n    return {\n      added: true,\n      prunedMessages,\n      currentTokenCount: this.getCurrentTokenCount(),\n      remainingCapacity: this.getRemainingTokenCapacity()\n    };\n  }\n\n  /**\n   * Prune old messages to fit within token limits\n   * Removes messages in pairs to maintain conversational flow\n   * @returns Array of pruned messages\n   */\n  pruneToFit(): BaseMessage[] {\n    const prunedMessages: BaseMessage[] = [];\n    const targetTokens = this.maxTokens - this.reserveTokens;\n    \n    while (this.getCurrentTokenCount() > targetTokens && this.messages.length > 0) {\n      const batchSize = Math.min(MemoryWindow.PRUNING_BATCH_SIZE, this.messages.length);\n      \n      for (let i = 0; i < batchSize; i++) {\n        const prunedMessage = this.messages.shift();\n        if (prunedMessage) {\n          prunedMessages.push(prunedMessage);\n        }\n      }\n      \n      if (prunedMessages.length > 1000) {\n        break;\n      }\n    }\n\n    return prunedMessages;\n  }\n\n  /**\n   * Get current token count including system prompt and messages\n   * @returns Current token count\n   */\n  getCurrentTokenCount(): number {\n    const messageTokens = this.tokenCounter.countMessagesTokens(this.messages);\n    return this.systemPromptTokens + messageTokens;\n  }\n\n  /**\n   * Get remaining token capacity before hitting the reserve limit\n   * @returns Remaining tokens that can be used\n   */\n  getRemainingTokenCapacity(): number {\n    return Math.max(0, this.maxTokens - this.getCurrentTokenCount());\n  }\n\n  /**\n   * Check if a message can be added without exceeding limits\n   * @param message - The message to check\n   * @returns True if message can be added within reserve limits\n   */\n  canAddMessage(message: BaseMessage): boolean {\n    const messageTokens = this.tokenCounter.countMessageTokens(message);\n    const currentTokens = this.getCurrentTokenCount();\n    const wouldExceedReserve = (currentTokens + messageTokens) > (this.maxTokens - this.reserveTokens);\n    \n    if (messageTokens > this.maxTokens) {\n      return false;\n    }\n    \n    return !wouldExceedReserve || this.messages.length > 0;\n  }\n\n  /**\n   * Get all messages in the memory window\n   * @returns Copy of current messages array\n   */\n  getMessages(): BaseMessage[] {\n    return [...this.messages];\n  }\n\n  /**\n   * Clear all messages from the memory window\n   */\n  clear(): void {\n    this.messages = [];\n  }\n\n  /**\n   * Set the system prompt and update token calculations\n   * @param systemPrompt - The system prompt text\n   */\n  setSystemPrompt(systemPrompt: string): void {\n    this.systemPrompt = systemPrompt;\n    this.systemPromptTokens = this.tokenCounter.estimateSystemPromptTokens(systemPrompt);\n  }\n\n  /**\n   * Get the current system prompt\n   * @returns Current system prompt\n   */\n  getSystemPrompt(): string {\n    return this.systemPrompt;\n  }\n\n  /**\n   * Get current configuration\n   * @returns Memory window configuration\n   */\n  getConfig() {\n    return {\n      maxTokens: this.maxTokens,\n      reserveTokens: this.reserveTokens,\n      currentTokens: this.getCurrentTokenCount(),\n      messageCount: this.messages.length,\n      systemPromptTokens: this.systemPromptTokens\n    };\n  }\n\n  /**\n   * Update token limits\n   * @param maxTokens - New maximum token limit\n   * @param reserveTokens - New reserve token amount\n   */\n  updateLimits(maxTokens: number, reserveTokens?: number): void {\n    if (reserveTokens !== undefined && reserveTokens >= maxTokens) {\n      throw new Error('Reserve tokens must be less than max tokens');\n    }\n\n    this.maxTokens = maxTokens;\n    if (reserveTokens !== undefined) {\n      this.reserveTokens = reserveTokens;\n    }\n\n    if (this.getCurrentTokenCount() > (this.maxTokens - this.reserveTokens)) {\n      this.pruneToFit();\n    }\n  }\n\n  /**\n   * Get statistics about the memory window\n   * @returns Memory usage statistics\n   */\n  getStats() {\n    const currentTokens = this.getCurrentTokenCount();\n    const capacity = this.maxTokens;\n    const usagePercentage = (currentTokens / capacity) * 100;\n    \n    return {\n      totalMessages: this.messages.length,\n      currentTokens,\n      maxTokens: capacity,\n      reserveTokens: this.reserveTokens,\n      systemPromptTokens: this.systemPromptTokens,\n      usagePercentage: Math.round(usagePercentage * 100) / 100,\n      remainingCapacity: this.getRemainingTokenCapacity(),\n      canAcceptMore: this.getRemainingTokenCapacity() > this.reserveTokens\n    };\n  }\n\n  /**\n   * Clean up resources\n   */\n  dispose(): void {\n    this.clear();\n    this.tokenCounter.dispose();\n  }\n}"],"names":[],"mappings":"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"}

package/dist/esm/index14.js

@@ -1,5 +1,5 @@
-import { ReferenceIdGenerator } from "./index22.js";
-import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index23.js";
+import { ReferenceIdGenerator } from "./index24.js";
+import { DEFAULT_CONTENT_REFERENCE_CONFIG, ContentReferenceError } from "./index25.js";
 const _ContentStorage = class _ContentStorage {
   constructor(maxStorage = _ContentStorage.DEFAULT_MAX_STORAGE, referenceConfig) {
     this.messages = [];
@@ -88,7 +88,6 @@ const _ContentStorage = class _ContentStorage {
         const regex = new RegExp(query, caseSensitive ? "g" : "gi");
         matches = this.messages.filter((stored) => regex.test(stored.message.content)).map((stored) => stored.message);
       } catch (error) {
-        console.warn("Invalid regex pattern:", query, error);
         return [];
       }
     } else {
@@ -306,7 +305,6 @@ const _ContentStorage = class _ContentStorage {
     } catch (error) {
       const duration = Date.now() - startTime;
       this.recordPerformanceMetric("creation", duration);
-      console.error("[ContentStorage] Failed to store content:", error);
       throw new ContentReferenceError(
         `Failed to store content: ${error instanceof Error ? error.message : "Unknown error"}`,
         "system_error",
@@ -373,7 +371,6 @@ const _ContentStorage = class _ContentStorage {
       const duration = Date.now() - startTime;
       this.recordPerformanceMetric("resolution", duration);
       this.referenceStats.failedResolutions++;
-      console.error(`[ContentStorage] Error resolving reference ${referenceId}:`, error);
       return {
         success: false,
         error: `System error resolving reference: ${error instanceof Error ? error.message : "Unknown error"}`,
@@ -507,7 +504,6 @@ const _ContentStorage = class _ContentStorage {
       const duration = Date.now() - startTime;
       this.recordPerformanceMetric("cleanup", duration);
       const errorMessage = `Cleanup process failed: ${error instanceof Error ? error.message : "Unknown error"}`;
-      console.error("[ContentStorage]", errorMessage);
       errors.push(errorMessage);
       return { cleanedUp, errors };
     }
@@ -631,7 +627,6 @@ const _ContentStorage = class _ContentStorage {
       try {
         await this.performCleanup();
       } catch (error) {
-        console.error("Error in scheduled reference cleanup:", error);
       }
     }, this.referenceConfig.cleanupIntervalMs);
   }