@hashgraphonline/conversational-agent 0.1.206 → 0.1.208

package/dist/esm/index24.js

@@ -1,38 +1,68 @@
-const DEFAULT_CONTENT_REFERENCE_CONFIG = {
-  sizeThresholdBytes: 10 * 1024,
-  // 10KB
-  maxAgeMs: 60 * 60 * 1e3,
-  // 1 hour
-  maxReferences: 100,
-  maxTotalStorageBytes: 100 * 1024 * 1024,
-  // 100MB
-  enableAutoCleanup: true,
-  cleanupIntervalMs: 5 * 60 * 1e3,
-  // 5 minutes
-  enablePersistence: false,
-  storageBackend: "memory",
-  cleanupPolicies: {
-    recent: { maxAgeMs: 30 * 60 * 1e3, priority: 1 },
-    // 30 minutes, highest priority
-    userContent: { maxAgeMs: 2 * 60 * 60 * 1e3, priority: 2 },
-    // 2 hours
-    agentGenerated: { maxAgeMs: 60 * 60 * 1e3, priority: 3 },
-    // 1 hour
-    default: { maxAgeMs: 60 * 60 * 1e3, priority: 4 }
-    // 1 hour, lowest priority
+import { createHash } from "crypto";
+class ReferenceIdGenerator {
+  /**
+   * Generate a content-based reference ID using SHA-256 hashing
+   * 
+   * @param content The content to generate a reference ID for
+   * @returns Deterministic reference ID based on content hash
+   */
+  static generateId(content) {
+    const hash = createHash("sha256");
+    hash.update(content);
+    return hash.digest("base64url");
   }
-};
-class ContentReferenceError extends Error {
-  constructor(message, type, referenceId, suggestedActions) {
-    super(message);
-    this.type = type;
-    this.referenceId = referenceId;
-    this.suggestedActions = suggestedActions;
-    this.name = "ContentReferenceError";
+  /**
+   * Validate that a string is a properly formatted reference ID
+   * 
+   * @param id The ID to validate
+   * @returns true if the ID is valid format
+   */
+  static isValidReferenceId(id) {
+    if (!id || typeof id !== "string") {
+      return false;
+    }
+    if (id.length !== 43) {
+      return false;
+    }
+    return /^[A-Za-z0-9_-]+$/.test(id);
+  }
+  /**
+   * Extract reference ID from ref:// format
+   * 
+   * @param input Input string that may contain a reference ID
+   * @returns Extracted reference ID or null if not found
+   */
+  static extractReferenceId(input) {
+    if (!input || typeof input !== "string") {
+      return null;
+    }
+    const refFormatMatch = input.match(/^ref:\/\/([A-Za-z0-9_-]{43})$/);
+    if (refFormatMatch) {
+      return refFormatMatch[1];
+    }
+    return this.isValidReferenceId(input) ? input : null;
+  }
+  /**
+   * Format a reference ID in the standard ref:// format
+   * 
+   * @param referenceId The reference ID to format
+   * @returns Formatted reference string
+   */
+  static formatReference(referenceId) {
+    return `ref://${referenceId}`;
+  }
+  /**
+   * Generate a test reference ID (for testing purposes only)
+   * 
+   * @param testSeed A test seed to generate a fake but valid ID format
+   * @returns A valid format reference ID for testing
+   */
+  static generateTestId(testSeed) {
+    const content = Buffer.from(`test-${testSeed}-${Date.now()}`);
+    return this.generateId(content);
   }
 }
 export {
-  ContentReferenceError,
-  DEFAULT_CONTENT_REFERENCE_CONFIG
+  ReferenceIdGenerator
 };
 //# sourceMappingURL=index24.js.map

package/dist/esm/index24.js.map

@@ -1 +1 @@
-{"version":3,"file":"index24.js","sources":["../../src/types/content-reference.ts"],"sourcesContent":["/**\n * Content Reference System Types\n * \n * Shared interfaces for the Reference-Based Content System that handles\n * large content storage with unique reference IDs to optimize context window usage.\n */\n\n/**\n * Unique identifier for stored content references\n * Format: Cryptographically secure 32-byte identifier with base64url encoding\n */\nexport type ReferenceId = string;\n\n/**\n * Lifecycle state of a content reference\n */\nexport type ReferenceLifecycleState = 'active' | 'expired' | 'cleanup_pending' | 'invalid';\n\n/**\n * Content types supported by the reference system\n */\nexport type ContentType = 'text' | 'json' | 'html' | 'markdown' | 'binary' | 'unknown';\n\n/**\n * Sources that created the content reference\n */\nexport type ContentSource = 'mcp_tool' | 'user_upload' | 'agent_generated' | 'system';\n\n/**\n * Metadata associated with stored content\n */\nexport interface ContentMetadata {\n  /** Content type classification */\n  contentType: ContentType;\n  \n  /** MIME type of the original content */\n  mimeType?: string;\n  \n  /** Size in bytes of the stored content */\n  sizeBytes: number;\n  \n  /** When the content was originally stored */\n  createdAt: Date;\n  \n  /** Last time the content was accessed via reference resolution */\n  lastAccessedAt: Date;\n  \n  /** Source that created this content reference */\n  source: ContentSource;\n  \n  /** Name of the MCP tool that generated the content (if applicable) */\n  mcpToolName?: string;\n  \n  /** Original filename or suggested name for the content */\n  fileName?: string;\n  \n  /** Number of times this reference has been resolved */\n  accessCount: number;\n  \n  /** Tags for categorization and cleanup policies */\n  tags?: string[];\n  \n  /** Custom metadata from the source */\n  customMetadata?: Record<string, unknown>;\n}\n\n/**\n * Core content reference object passed through agent context\n * Designed to be lightweight (<100 tokens) while providing enough \n * information for agent decision-making\n */\nexport interface ContentReference {\n  /** Unique identifier for resolving the content */\n  referenceId: ReferenceId;\n  \n  /** Current lifecycle state */\n  state: ReferenceLifecycleState;\n  \n  /** Brief description or preview of the content (max 200 chars) */\n  preview: string;\n  \n  /** Essential metadata for agent decision-making */\n  metadata: Pick<ContentMetadata, 'contentType' | 'sizeBytes' | 'source' | 'fileName' | 'mimeType'>;\n  \n  /** When this reference was created */\n  createdAt: Date;\n  \n  /** Special format indicator for reference IDs in content */\n  readonly format: 'ref://{id}';\n}\n\n/**\n * Result of attempting to resolve a content reference\n */\nexport interface ReferenceResolutionResult {\n  /** Whether the resolution was successful */\n  success: boolean;\n  \n  /** The resolved content if successful */\n  content?: Buffer;\n  \n  /** Complete metadata if successful */\n  metadata?: ContentMetadata;\n  \n  /** Error message if resolution failed */\n  error?: string;\n  \n  /** Specific error type for targeted error handling */\n  errorType?: 'not_found' | 'expired' | 'corrupted' | 'access_denied' | 'system_error';\n  \n  /** Suggested actions for recovery */\n  suggestedActions?: string[];\n}\n\n/**\n * Configuration for content reference storage and lifecycle\n */\nexport interface ContentReferenceConfig {\n  /** Size threshold above which content should be stored as references (default: 10KB) */\n  sizeThresholdBytes: number;\n  \n  /** Maximum age for unused references before cleanup (default: 1 hour) */\n  maxAgeMs: number;\n  \n  /** Maximum number of references to store simultaneously */\n  maxReferences: number;\n  \n  /** Maximum total storage size for all references */\n  maxTotalStorageBytes: number;\n  \n  /** Whether to enable automatic cleanup */\n  enableAutoCleanup: boolean;\n  \n  /** Interval for cleanup checks in milliseconds */\n  cleanupIntervalMs: number;\n  \n  /** Whether to persist references across restarts */\n  enablePersistence: boolean;\n  \n  /** Storage backend configuration */\n  storageBackend: 'memory' | 'filesystem' | 'hybrid';\n  \n  /** Cleanup policies for different content types */\n  cleanupPolicies: {\n    /** Policy for content marked as \"recent\" from MCP tools */\n    recent: { maxAgeMs: number; priority: number };\n    \n    /** Policy for user-uploaded content */\n    userContent: { maxAgeMs: number; priority: number };\n    \n    /** Policy for agent-generated content */\n    agentGenerated: { maxAgeMs: number; priority: number };\n    \n    /** Default policy for other content */\n    default: { maxAgeMs: number; priority: number };\n  };\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONTENT_REFERENCE_CONFIG: ContentReferenceConfig = {\n  sizeThresholdBytes: 10 * 1024, // 10KB\n  maxAgeMs: 60 * 60 * 1000, // 1 hour\n  maxReferences: 100,\n  maxTotalStorageBytes: 100 * 1024 * 1024, // 100MB\n  enableAutoCleanup: true,\n  cleanupIntervalMs: 5 * 60 * 1000, // 5 minutes\n  enablePersistence: false,\n  storageBackend: 'memory',\n  cleanupPolicies: {\n    recent: { maxAgeMs: 30 * 60 * 1000, priority: 1 }, // 30 minutes, highest priority\n    userContent: { maxAgeMs: 2 * 60 * 60 * 1000, priority: 2 }, // 2 hours\n    agentGenerated: { maxAgeMs: 60 * 60 * 1000, priority: 3 }, // 1 hour\n    default: { maxAgeMs: 60 * 60 * 1000, priority: 4 } // 1 hour, lowest priority\n  }\n};\n\n/**\n * Statistics about content reference usage and storage\n */\nexport interface ContentReferenceStats {\n  /** Total number of active references */\n  activeReferences: number;\n  \n  /** Total storage used by all references in bytes */\n  totalStorageBytes: number;\n  \n  /** Number of references cleaned up in last cleanup cycle */\n  recentlyCleanedUp: number;\n  \n  /** Number of successful reference resolutions since startup */\n  totalResolutions: number;\n  \n  /** Number of failed resolution attempts */\n  failedResolutions: number;\n  \n  /** Average content size in bytes */\n  averageContentSize: number;\n  \n  /** Most frequently accessed reference ID */\n  mostAccessedReferenceId?: ReferenceId;\n  \n  /** Storage utilization percentage */\n  storageUtilization: number;\n  \n  /** Performance metrics */\n  performanceMetrics: {\n    /** Average time to create a reference in milliseconds */\n    averageCreationTimeMs: number;\n    \n    /** Average time to resolve a reference in milliseconds */\n    averageResolutionTimeMs: number;\n    \n    /** Average cleanup time in milliseconds */\n    averageCleanupTimeMs: number;\n  };\n}\n\n/**\n * Error types for content reference operations\n */\nexport class ContentReferenceError extends Error {\n  constructor(\n    message: string,\n    public readonly type: ReferenceResolutionResult['errorType'],\n    public readonly referenceId?: ReferenceId,\n    public readonly suggestedActions?: string[]\n  ) {\n    super(message);\n    this.name = 'ContentReferenceError';\n  }\n}\n\n/**\n * Interface for content reference storage implementations\n */\nexport interface ContentReferenceStore {\n  /**\n   * Store content and return a reference\n   */\n  storeContent(\n    content: Buffer,\n    metadata: Omit<ContentMetadata, 'createdAt' | 'lastAccessedAt' | 'accessCount'>\n  ): Promise<ContentReference>;\n  \n  /**\n   * Resolve a reference to its content\n   */\n  resolveReference(referenceId: ReferenceId): Promise<ReferenceResolutionResult>;\n  \n  /**\n   * Check if a reference exists and is valid\n   */\n  hasReference(referenceId: ReferenceId): Promise<boolean>;\n  \n  /**\n   * Mark a reference for cleanup\n   */\n  cleanupReference(referenceId: ReferenceId): Promise<boolean>;\n  \n  /**\n   * Get current storage statistics\n   */\n  getStats(): Promise<ContentReferenceStats>;\n  \n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<ContentReferenceConfig>): Promise<void>;\n  \n  /**\n   * Perform cleanup based on current policies\n   */\n  performCleanup(): Promise<{ cleanedUp: number; errors: string[] }>;\n  \n  /**\n   * Dispose of resources\n   */\n  dispose(): Promise<void>;\n}"],"names":[],"mappings":"AAiKO,MAAM,mCAA2D;AAAA,EACtE,oBAAoB,KAAK;AAAA;AAAA,EACzB,UAAU,KAAK,KAAK;AAAA;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB,MAAM,OAAO;AAAA;AAAA,EACnC,mBAAmB;AAAA,EACnB,mBAAmB,IAAI,KAAK;AAAA;AAAA,EAC5B,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,IACf,QAAQ,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,IAC9C,aAAa,EAAE,UAAU,IAAI,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,IACvD,gBAAgB,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,IACtD,SAAS,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,EAAE;AAErD;AA8CO,MAAM,8BAA8B,MAAM;AAAA,EAC/C,YACE,SACgB,MACA,aACA,kBAChB;AACA,UAAM,OAAO;AAJG,SAAA,OAAA;AACA,SAAA,cAAA;AACA,SAAA,mBAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}
+{"version":3,"file":"index24.js","sources":["../../src/memory/ReferenceIdGenerator.ts"],"sourcesContent":["import { createHash } from 'crypto';\nimport { ReferenceId } from '../types/content-reference';\n\n/**\n * Content-based reference ID generator using SHA-256 (HCS-1 style)\n * \n * Generates deterministic reference IDs based on content hashing.\n * Same content always produces the same reference ID.\n */\nexport class ReferenceIdGenerator {\n  /**\n   * Generate a content-based reference ID using SHA-256 hashing\n   * \n   * @param content The content to generate a reference ID for\n   * @returns Deterministic reference ID based on content hash\n   */\n  static generateId(content: Buffer): ReferenceId {\n    const hash = createHash('sha256');\n    hash.update(content);\n    return hash.digest('base64url');\n  }\n  \n  /**\n   * Validate that a string is a properly formatted reference ID\n   * \n   * @param id The ID to validate\n   * @returns true if the ID is valid format\n   */\n  static isValidReferenceId(id: string): id is ReferenceId {\n    if (!id || typeof id !== 'string') {\n      return false;\n    }\n    \n    // Check length (base64url encoding of SHA-256 hash = 43 chars)\n    if (id.length !== 43) {\n      return false;\n    }\n    \n    // Check character set (base64url: A-Z, a-z, 0-9, -, _)\n    return /^[A-Za-z0-9_-]+$/.test(id);\n  }\n  \n  /**\n   * Extract reference ID from ref:// format\n   * \n   * @param input Input string that may contain a reference ID\n   * @returns Extracted reference ID or null if not found\n   */\n  static extractReferenceId(input: string): ReferenceId | null {\n    if (!input || typeof input !== 'string') {\n      return null;\n    }\n    \n    // Check for ref:// format\n    const refFormatMatch = input.match(/^ref:\\/\\/([A-Za-z0-9_-]{43})$/);\n    if (refFormatMatch) {\n      return refFormatMatch[1] as ReferenceId;\n    }\n    \n    // Check if input is directly a valid reference ID\n    return this.isValidReferenceId(input) ? input : null;\n  }\n  \n  /**\n   * Format a reference ID in the standard ref:// format\n   * \n   * @param referenceId The reference ID to format\n   * @returns Formatted reference string\n   */\n  static formatReference(referenceId: ReferenceId): string {\n    return `ref://${referenceId}`;\n  }\n  \n  /**\n   * Generate a test reference ID (for testing purposes only)\n   * \n   * @param testSeed A test seed to generate a fake but valid ID format\n   * @returns A valid format reference ID for testing\n   */\n  static generateTestId(testSeed: string): ReferenceId {\n    const content = Buffer.from(`test-${testSeed}-${Date.now()}`);\n    return this.generateId(content);\n  }\n}"],"names":[],"mappings":";AASO,MAAM,qBAAqB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhC,OAAO,WAAW,SAA8B;AAC9C,UAAM,OAAO,WAAW,QAAQ;AAChC,SAAK,OAAO,OAAO;AACnB,WAAO,KAAK,OAAO,WAAW;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,IAA+B;AACvD,QAAI,CAAC,MAAM,OAAO,OAAO,UAAU;AACjC,aAAO;AAAA,IACT;AAGA,QAAI,GAAG,WAAW,IAAI;AACpB,aAAO;AAAA,IACT;AAGA,WAAO,mBAAmB,KAAK,EAAE;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,OAAmC;AAC3D,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,aAAO;AAAA,IACT;AAGA,UAAM,iBAAiB,MAAM,MAAM,+BAA+B;AAClE,QAAI,gBAAgB;AAClB,aAAO,eAAe,CAAC;AAAA,IACzB;AAGA,WAAO,KAAK,mBAAmB,KAAK,IAAI,QAAQ;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,gBAAgB,aAAkC;AACvD,WAAO,SAAS,WAAW;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,eAAe,UAA+B;AACnD,UAAM,UAAU,OAAO,KAAK,QAAQ,QAAQ,IAAI,KAAK,IAAA,CAAK,EAAE;AAC5D,WAAO,KAAK,WAAW,OAAO;AAAA,EAChC;AACF;"}

package/dist/esm/index25.js

@@ -0,0 +1,38 @@
+const DEFAULT_CONTENT_REFERENCE_CONFIG = {
+  sizeThresholdBytes: 10 * 1024,
+  // 10KB
+  maxAgeMs: 60 * 60 * 1e3,
+  // 1 hour
+  maxReferences: 100,
+  maxTotalStorageBytes: 100 * 1024 * 1024,
+  // 100MB
+  enableAutoCleanup: true,
+  cleanupIntervalMs: 5 * 60 * 1e3,
+  // 5 minutes
+  enablePersistence: false,
+  storageBackend: "memory",
+  cleanupPolicies: {
+    recent: { maxAgeMs: 30 * 60 * 1e3, priority: 1 },
+    // 30 minutes, highest priority
+    userContent: { maxAgeMs: 2 * 60 * 60 * 1e3, priority: 2 },
+    // 2 hours
+    agentGenerated: { maxAgeMs: 60 * 60 * 1e3, priority: 3 },
+    // 1 hour
+    default: { maxAgeMs: 60 * 60 * 1e3, priority: 4 }
+    // 1 hour, lowest priority
+  }
+};
+class ContentReferenceError extends Error {
+  constructor(message, type, referenceId, suggestedActions) {
+    super(message);
+    this.type = type;
+    this.referenceId = referenceId;
+    this.suggestedActions = suggestedActions;
+    this.name = "ContentReferenceError";
+  }
+}
+export {
+  ContentReferenceError,
+  DEFAULT_CONTENT_REFERENCE_CONFIG
+};
+//# sourceMappingURL=index25.js.map

package/dist/esm/index25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index25.js","sources":["../../src/types/content-reference.ts"],"sourcesContent":["/**\n * Content Reference System Types\n * \n * Shared interfaces for the Reference-Based Content System that handles\n * large content storage with unique reference IDs to optimize context window usage.\n */\n\n/**\n * Unique identifier for stored content references\n * Format: Cryptographically secure 32-byte identifier with base64url encoding\n */\nexport type ReferenceId = string;\n\n/**\n * Lifecycle state of a content reference\n */\nexport type ReferenceLifecycleState = 'active' | 'expired' | 'cleanup_pending' | 'invalid';\n\n/**\n * Content types supported by the reference system\n */\nexport type ContentType = 'text' | 'json' | 'html' | 'markdown' | 'binary' | 'unknown';\n\n/**\n * Sources that created the content reference\n */\nexport type ContentSource = 'mcp_tool' | 'user_upload' | 'agent_generated' | 'system';\n\n/**\n * Metadata associated with stored content\n */\nexport interface ContentMetadata {\n  /** Content type classification */\n  contentType: ContentType;\n  \n  /** MIME type of the original content */\n  mimeType?: string;\n  \n  /** Size in bytes of the stored content */\n  sizeBytes: number;\n  \n  /** When the content was originally stored */\n  createdAt: Date;\n  \n  /** Last time the content was accessed via reference resolution */\n  lastAccessedAt: Date;\n  \n  /** Source that created this content reference */\n  source: ContentSource;\n  \n  /** Name of the MCP tool that generated the content (if applicable) */\n  mcpToolName?: string;\n  \n  /** Original filename or suggested name for the content */\n  fileName?: string;\n  \n  /** Number of times this reference has been resolved */\n  accessCount: number;\n  \n  /** Tags for categorization and cleanup policies */\n  tags?: string[];\n  \n  /** Custom metadata from the source */\n  customMetadata?: Record<string, unknown>;\n}\n\n/**\n * Core content reference object passed through agent context\n * Designed to be lightweight (<100 tokens) while providing enough \n * information for agent decision-making\n */\nexport interface ContentReference {\n  /** Unique identifier for resolving the content */\n  referenceId: ReferenceId;\n  \n  /** Current lifecycle state */\n  state: ReferenceLifecycleState;\n  \n  /** Brief description or preview of the content (max 200 chars) */\n  preview: string;\n  \n  /** Essential metadata for agent decision-making */\n  metadata: Pick<ContentMetadata, 'contentType' | 'sizeBytes' | 'source' | 'fileName' | 'mimeType'>;\n  \n  /** When this reference was created */\n  createdAt: Date;\n  \n  /** Special format indicator for reference IDs in content */\n  readonly format: 'ref://{id}';\n}\n\n/**\n * Result of attempting to resolve a content reference\n */\nexport interface ReferenceResolutionResult {\n  /** Whether the resolution was successful */\n  success: boolean;\n  \n  /** The resolved content if successful */\n  content?: Buffer;\n  \n  /** Complete metadata if successful */\n  metadata?: ContentMetadata;\n  \n  /** Error message if resolution failed */\n  error?: string;\n  \n  /** Specific error type for targeted error handling */\n  errorType?: 'not_found' | 'expired' | 'corrupted' | 'access_denied' | 'system_error';\n  \n  /** Suggested actions for recovery */\n  suggestedActions?: string[];\n}\n\n/**\n * Configuration for content reference storage and lifecycle\n */\nexport interface ContentReferenceConfig {\n  /** Size threshold above which content should be stored as references (default: 10KB) */\n  sizeThresholdBytes: number;\n  \n  /** Maximum age for unused references before cleanup (default: 1 hour) */\n  maxAgeMs: number;\n  \n  /** Maximum number of references to store simultaneously */\n  maxReferences: number;\n  \n  /** Maximum total storage size for all references */\n  maxTotalStorageBytes: number;\n  \n  /** Whether to enable automatic cleanup */\n  enableAutoCleanup: boolean;\n  \n  /** Interval for cleanup checks in milliseconds */\n  cleanupIntervalMs: number;\n  \n  /** Whether to persist references across restarts */\n  enablePersistence: boolean;\n  \n  /** Storage backend configuration */\n  storageBackend: 'memory' | 'filesystem' | 'hybrid';\n  \n  /** Cleanup policies for different content types */\n  cleanupPolicies: {\n    /** Policy for content marked as \"recent\" from MCP tools */\n    recent: { maxAgeMs: number; priority: number };\n    \n    /** Policy for user-uploaded content */\n    userContent: { maxAgeMs: number; priority: number };\n    \n    /** Policy for agent-generated content */\n    agentGenerated: { maxAgeMs: number; priority: number };\n    \n    /** Default policy for other content */\n    default: { maxAgeMs: number; priority: number };\n  };\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONTENT_REFERENCE_CONFIG: ContentReferenceConfig = {\n  sizeThresholdBytes: 10 * 1024, // 10KB\n  maxAgeMs: 60 * 60 * 1000, // 1 hour\n  maxReferences: 100,\n  maxTotalStorageBytes: 100 * 1024 * 1024, // 100MB\n  enableAutoCleanup: true,\n  cleanupIntervalMs: 5 * 60 * 1000, // 5 minutes\n  enablePersistence: false,\n  storageBackend: 'memory',\n  cleanupPolicies: {\n    recent: { maxAgeMs: 30 * 60 * 1000, priority: 1 }, // 30 minutes, highest priority\n    userContent: { maxAgeMs: 2 * 60 * 60 * 1000, priority: 2 }, // 2 hours\n    agentGenerated: { maxAgeMs: 60 * 60 * 1000, priority: 3 }, // 1 hour\n    default: { maxAgeMs: 60 * 60 * 1000, priority: 4 } // 1 hour, lowest priority\n  }\n};\n\n/**\n * Statistics about content reference usage and storage\n */\nexport interface ContentReferenceStats {\n  /** Total number of active references */\n  activeReferences: number;\n  \n  /** Total storage used by all references in bytes */\n  totalStorageBytes: number;\n  \n  /** Number of references cleaned up in last cleanup cycle */\n  recentlyCleanedUp: number;\n  \n  /** Number of successful reference resolutions since startup */\n  totalResolutions: number;\n  \n  /** Number of failed resolution attempts */\n  failedResolutions: number;\n  \n  /** Average content size in bytes */\n  averageContentSize: number;\n  \n  /** Most frequently accessed reference ID */\n  mostAccessedReferenceId?: ReferenceId;\n  \n  /** Storage utilization percentage */\n  storageUtilization: number;\n  \n  /** Performance metrics */\n  performanceMetrics: {\n    /** Average time to create a reference in milliseconds */\n    averageCreationTimeMs: number;\n    \n    /** Average time to resolve a reference in milliseconds */\n    averageResolutionTimeMs: number;\n    \n    /** Average cleanup time in milliseconds */\n    averageCleanupTimeMs: number;\n  };\n}\n\n/**\n * Error types for content reference operations\n */\nexport class ContentReferenceError extends Error {\n  constructor(\n    message: string,\n    public readonly type: ReferenceResolutionResult['errorType'],\n    public readonly referenceId?: ReferenceId,\n    public readonly suggestedActions?: string[]\n  ) {\n    super(message);\n    this.name = 'ContentReferenceError';\n  }\n}\n\n/**\n * Interface for content reference storage implementations\n */\nexport interface ContentReferenceStore {\n  /**\n   * Store content and return a reference\n   */\n  storeContent(\n    content: Buffer,\n    metadata: Omit<ContentMetadata, 'createdAt' | 'lastAccessedAt' | 'accessCount'>\n  ): Promise<ContentReference>;\n  \n  /**\n   * Resolve a reference to its content\n   */\n  resolveReference(referenceId: ReferenceId): Promise<ReferenceResolutionResult>;\n  \n  /**\n   * Check if a reference exists and is valid\n   */\n  hasReference(referenceId: ReferenceId): Promise<boolean>;\n  \n  /**\n   * Mark a reference for cleanup\n   */\n  cleanupReference(referenceId: ReferenceId): Promise<boolean>;\n  \n  /**\n   * Get current storage statistics\n   */\n  getStats(): Promise<ContentReferenceStats>;\n  \n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<ContentReferenceConfig>): Promise<void>;\n  \n  /**\n   * Perform cleanup based on current policies\n   */\n  performCleanup(): Promise<{ cleanedUp: number; errors: string[] }>;\n  \n  /**\n   * Dispose of resources\n   */\n  dispose(): Promise<void>;\n}"],"names":[],"mappings":"AAiKO,MAAM,mCAA2D;AAAA,EACtE,oBAAoB,KAAK;AAAA;AAAA,EACzB,UAAU,KAAK,KAAK;AAAA;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB,MAAM,OAAO;AAAA;AAAA,EACnC,mBAAmB;AAAA,EACnB,mBAAmB,IAAI,KAAK;AAAA;AAAA,EAC5B,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,IACf,QAAQ,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,IAC9C,aAAa,EAAE,UAAU,IAAI,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,IACvD,gBAAgB,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,IACtD,SAAS,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA;AAAA,EAAE;AAErD;AA8CO,MAAM,8BAA8B,MAAM;AAAA,EAC/C,YACE,SACgB,MACA,aACA,kBAChB;AACA,UAAM,OAAO;AAJG,SAAA,OAAA;AACA,SAAA,cAAA;AACA,SAAA,mBAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}

package/dist/esm/index8.js

@@ -1,11 +1,12 @@
-import { createOpenAIToolsAgent, AgentExecutor } from "langchain/agents";
+import { createOpenAIToolsAgent } from "langchain/agents";
+import { ContentAwareAgentExecutor } from "./index15.js";
 import { ChatPromptTemplate, MessagesPlaceholder } from "@langchain/core/prompts";
 import { ChatOpenAI } from "@langchain/openai";
 import { TokenUsageCallbackHandler, calculateTokenCostSync, getAllHederaCorePlugins, HederaAgentKit } from "hedera-agent-kit";
 import { BaseAgent } from "./index7.js";
-import { MCPClientManager } from "./index15.js";
-import { convertMCPToolToLangChain } from "./index16.js";
-import { SmartMemoryManager } from "./index17.js";
+import { MCPClientManager } from "./index16.js";
+import { convertMCPToolToLangChain } from "./index17.js";
+import { SmartMemoryManager } from "./index18.js";
 class LangChainAgent extends BaseAgent {
   constructor() {
     super(...arguments);
@@ -234,7 +235,7 @@ class LangChainAgent extends BaseAgent {
       tools: langchainTools,
       prompt
     });
-    this.executor = new AgentExecutor({
+    this.executor = new ContentAwareAgentExecutor({
       agent,
       tools: langchainTools,
       verbose: this.config.debug?.verbose ?? false,

package/dist/esm/index8.js.map

@@ -1 +1 @@
-{"version":3,"file":"index8.js","sources":["../../src/langchain-agent.ts"],"sourcesContent":["import type { BaseChatModel } from '@langchain/core/language_models/chat_models';\nimport type { StructuredTool } from '@langchain/core/tools';\nimport { createOpenAIToolsAgent, AgentExecutor } from 'langchain/agents';\nimport {\n  ChatPromptTemplate,\n  MessagesPlaceholder,\n} from '@langchain/core/prompts';\nimport { ChatOpenAI } from '@langchain/openai';\nimport {\n  calculateTokenCostSync,\n  getAllHederaCorePlugins,\n  HederaAgentKit,\n  TokenUsageCallbackHandler,\n} from 'hedera-agent-kit';\nimport type { TokenUsage, CostCalculation } from 'hedera-agent-kit';\nimport {\n  BaseAgent,\n  type ConversationContext,\n  type ChatResponse,\n  type OperationalMode,\n  type UsageStats,\n} from './base-agent';\nimport { MCPClientManager } from './mcp/MCPClientManager';\nimport { convertMCPToolToLangChain } from './mcp/adapters/langchain';\nimport { SmartMemoryManager } from './memory/SmartMemoryManager';\n\nexport class LangChainAgent extends BaseAgent {\n  private executor: AgentExecutor | undefined;\n  private systemMessage = '';\n  private mcpManager?: MCPClientManager;\n  private smartMemory: SmartMemoryManager | undefined;\n\n  async boot(): Promise<void> {\n    if (this.initialized) {\n      this.logger.warn('Agent already initialized');\n      return;\n    }\n\n    try {\n      this.agentKit = await this.createAgentKit();\n      await this.agentKit.initialize();\n\n      const modelName =\n        this.config.ai?.modelName ||\n        process.env.OPENAI_MODEL_NAME ||\n        'gpt-4o-mini';\n      this.tokenTracker = new TokenUsageCallbackHandler(modelName);\n\n      const allTools = this.agentKit.getAggregatedLangChainTools();\n      this.tools = this.filterTools(allTools);\n\n      if (this.config.mcp?.servers && this.config.mcp.servers.length > 0) {\n        await this.initializeMCP();\n      }\n\n      this.smartMemory = new SmartMemoryManager({\n        modelName,\n        maxTokens: 90000,\n        reserveTokens: 10000,\n        storageLimit: 1000\n      });\n      \n      this.logger.info('SmartMemoryManager initialized:', {\n        modelName,\n        toolsCount: this.tools.length,\n        maxTokens: 90000,\n        reserveTokens: 10000\n      });\n\n      this.systemMessage = this.buildSystemPrompt();\n      \n      // Set the system prompt in smart memory\n      this.smartMemory.setSystemPrompt(this.systemMessage);\n\n      await this.createExecutor();\n\n      this.initialized = true;\n      this.logger.info('LangChain Hedera agent initialized');\n    } catch (error) {\n      this.logger.error('Failed to initialize agent:', error);\n      throw error;\n    }\n  }\n\n  async chat(\n    message: string,\n    context?: ConversationContext\n  ): Promise<ChatResponse> {\n    if (!this.initialized || !this.executor || !this.smartMemory) {\n      throw new Error('Agent not initialized. Call boot() first.');\n    }\n\n    try {\n      this.logger.info('LangChainAgent.chat called with:', { message, contextLength: context?.messages?.length || 0 });\n      \n      // If context is provided, populate smart memory with previous messages\n      if (context?.messages && context.messages.length > 0) {\n        // Clear existing memory and add messages from context\n        this.smartMemory.clear();\n        \n        for (const msg of context.messages) {\n          this.smartMemory.addMessage(msg);\n        }\n      }\n      \n      // Add the current user message to memory\n      const { HumanMessage } = await import('@langchain/core/messages');\n      this.smartMemory.addMessage(new HumanMessage(message));\n      \n      const memoryStats = this.smartMemory.getMemoryStats();\n      this.logger.info('Memory stats before execution:', {\n        totalMessages: memoryStats.totalActiveMessages,\n        currentTokens: memoryStats.currentTokenCount,\n        maxTokens: memoryStats.maxTokens,\n        usagePercentage: memoryStats.usagePercentage,\n        toolsCount: this.tools.length\n      });\n      \n      const result = await this.executor.invoke({\n        input: message,\n        chat_history: this.smartMemory.getMessages(),\n      });\n\n      this.logger.info('LangChainAgent executor result:', result);\n\n      let response: ChatResponse = {\n        output: result.output || '',\n        message: result.output || '',\n        notes: [],\n        intermediateSteps: result.intermediateSteps,\n      };\n\n      // Extract tool calls from intermediate steps\n      if (result.intermediateSteps && Array.isArray(result.intermediateSteps)) {\n        const toolCalls = result.intermediateSteps.map((step: any, index: number) => ({\n          id: `call_${index}`,\n          name: step.action?.tool || 'unknown',\n          args: step.action?.toolInput || {},\n          output: typeof step.observation === 'string' ? step.observation : JSON.stringify(step.observation)\n        }));\n        \n        if (toolCalls.length > 0) {\n          response.tool_calls = toolCalls;\n        }\n      }\n\n      const parsedSteps = result?.intermediateSteps?.[0]?.observation;\n      if (\n        parsedSteps &&\n        typeof parsedSteps === 'string' &&\n        this.isJSON(parsedSteps)\n      ) {\n        try {\n          const parsed = JSON.parse(parsedSteps);\n          response = { ...response, ...parsed };\n        } catch (error) {\n          this.logger.error('Error parsing intermediate steps:', error);\n        }\n      }\n\n      if (!response.output || response.output.trim() === '') {\n        response.output = 'Agent action complete.';\n      }\n\n      // Add the AI response to memory\n      if (response.output) {\n        const { AIMessage } = await import('@langchain/core/messages');\n        this.smartMemory.addMessage(new AIMessage(response.output));\n      }\n\n      if (this.tokenTracker) {\n        const tokenUsage = this.tokenTracker.getLatestTokenUsage();\n        if (tokenUsage) {\n          response.tokenUsage = tokenUsage;\n          response.cost = calculateTokenCostSync(tokenUsage);\n        }\n      }\n\n      const finalMemoryStats = this.smartMemory.getMemoryStats();\n      response.metadata = {\n        ...response.metadata,\n        memoryStats: {\n          activeMessages: finalMemoryStats.totalActiveMessages,\n          tokenUsage: finalMemoryStats.currentTokenCount,\n          maxTokens: finalMemoryStats.maxTokens,\n          usagePercentage: finalMemoryStats.usagePercentage\n        }\n      };\n\n      this.logger.info('LangChainAgent.chat returning response:', response);\n      return response;\n    } catch (error) {\n      this.logger.error('LangChainAgent.chat error:', error);\n      return this.handleError(error);\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.mcpManager) {\n      await this.mcpManager.disconnectAll();\n    }\n\n    if (this.smartMemory) {\n      this.smartMemory.dispose();\n      this.smartMemory = undefined;\n    }\n\n    this.executor = undefined;\n    this.agentKit = undefined;\n    this.tools = [];\n    this.initialized = false;\n    this.logger.info('Agent cleaned up');\n  }\n\n  switchMode(mode: OperationalMode): void {\n    if (this.config.execution) {\n      this.config.execution.operationalMode = mode;\n    } else {\n      this.config.execution = { operationalMode: mode };\n    }\n\n    if (this.agentKit) {\n      this.agentKit.operationalMode = mode;\n    }\n\n    this.systemMessage = this.buildSystemPrompt();\n    this.logger.info(`Operational mode switched to: ${mode}`);\n  }\n\n  getUsageStats(): UsageStats {\n    if (!this.tokenTracker) {\n      return {\n        promptTokens: 0,\n        completionTokens: 0,\n        totalTokens: 0,\n        cost: { totalCost: 0 } as CostCalculation,\n      };\n    }\n\n    const usage = this.tokenTracker.getTotalTokenUsage();\n    const cost = calculateTokenCostSync(usage);\n    return { ...usage, cost };\n  }\n\n  getUsageLog(): UsageStats[] {\n    if (!this.tokenTracker) {\n      return [];\n    }\n\n    return this.tokenTracker.getTokenUsageHistory().map((usage) => ({\n      ...usage,\n      cost: calculateTokenCostSync(usage),\n    }));\n  }\n\n  clearUsageStats(): void {\n    if (this.tokenTracker) {\n      this.tokenTracker.reset();\n      this.logger.info('Usage statistics cleared');\n    }\n  }\n\n\n  private async createAgentKit(): Promise<HederaAgentKit> {\n    const corePlugins = getAllHederaCorePlugins();\n    const extensionPlugins = this.config.extensions?.plugins || [];\n    const plugins = [...corePlugins, ...extensionPlugins];\n\n    const operationalMode =\n      this.config.execution?.operationalMode || 'returnBytes';\n    const modelName = this.config.ai?.modelName || 'gpt-4o';\n\n    return new HederaAgentKit(\n      this.config.signer,\n      { plugins },\n      operationalMode,\n      this.config.execution?.userAccountId,\n      this.config.execution?.scheduleUserTransactionsInBytesMode ?? true,\n      undefined,\n      modelName,\n      this.config.extensions?.mirrorConfig,\n      this.config.debug?.silent ?? false\n    );\n  }\n\n  private async createExecutor(): Promise<void> {\n    let llm: BaseChatModel;\n    if (this.config.ai?.provider && this.config.ai.provider.getModel) {\n      llm = this.config.ai.provider.getModel() as BaseChatModel;\n    } else if (this.config.ai?.llm) {\n      llm = this.config.ai.llm as BaseChatModel;\n    } else {\n      const apiKey = this.config.ai?.apiKey || process.env.OPENAI_API_KEY;\n      if (!apiKey) {\n        throw new Error('OpenAI API key required');\n      }\n\n      llm = new ChatOpenAI({\n        apiKey,\n        modelName: this.config.ai?.modelName || 'gpt-4o-mini',\n        temperature: this.config.ai?.temperature ?? 0.1,\n        callbacks: this.tokenTracker ? [this.tokenTracker] : [],\n      });\n    }\n\n    const prompt = ChatPromptTemplate.fromMessages([\n      ['system', this.systemMessage],\n      new MessagesPlaceholder('chat_history'),\n      ['human', '{input}'],\n      new MessagesPlaceholder('agent_scratchpad'),\n    ]);\n\n    const langchainTools = this.tools as unknown as StructuredTool[];\n\n    const agent = await createOpenAIToolsAgent({\n      llm,\n      tools: langchainTools,\n      prompt,\n    });\n\n    // Create executor without memory - we handle memory manually with SmartMemoryManager\n    this.executor = new AgentExecutor({\n      agent,\n      tools: langchainTools,\n      verbose: this.config.debug?.verbose ?? false,\n      returnIntermediateSteps: true,\n    });\n  }\n\n  private handleError(error: unknown): ChatResponse {\n    const errorMessage =\n      error instanceof Error ? error.message : 'Unknown error';\n    this.logger.error('Chat error:', error);\n\n    let tokenUsage: TokenUsage | undefined;\n    let cost: CostCalculation | undefined;\n\n    if (this.tokenTracker) {\n      tokenUsage = this.tokenTracker.getLatestTokenUsage();\n      if (tokenUsage) {\n        cost = calculateTokenCostSync(tokenUsage);\n      }\n    }\n\n    const errorResponse: ChatResponse = {\n      output: 'Sorry, I encountered an error processing your request.',\n      message: 'Error processing request.',\n      error: errorMessage,\n      notes: [],\n    };\n\n    if (tokenUsage) {\n      errorResponse.tokenUsage = tokenUsage;\n    }\n\n    if (cost) {\n      errorResponse.cost = cost;\n    }\n\n    return errorResponse;\n  }\n\n  private async initializeMCP(): Promise<void> {\n    this.mcpManager = new MCPClientManager(this.logger);\n\n    for (const serverConfig of this.config.mcp!.servers!) {\n      if (serverConfig.autoConnect === false) {\n        this.logger.info(\n          `Skipping MCP server ${serverConfig.name} (autoConnect=false)`\n        );\n        continue;\n      }\n\n      const status = await this.mcpManager.connectServer(serverConfig);\n\n      if (status.connected) {\n        this.logger.info(\n          `Connected to MCP server ${status.serverName} with ${status.tools.length} tools`\n        );\n\n        for (const mcpTool of status.tools) {\n          const langchainTool = convertMCPToolToLangChain(\n            mcpTool,\n            this.mcpManager,\n            serverConfig\n          );\n          this.tools.push(langchainTool);\n        }\n      } else {\n        this.logger.error(\n          `Failed to connect to MCP server ${status.serverName}: ${status.error}`\n        );\n      }\n    }\n  }\n\n  /**\n   * Check if a string is valid JSON\n   */\n  private isJSON(str: string): boolean {\n    if (typeof str !== 'string') return false;\n\n    const trimmed = str.trim();\n    if (!trimmed) return false;\n\n    if (\n      !(trimmed.startsWith('{') && trimmed.endsWith('}')) &&\n      !(trimmed.startsWith('[') && trimmed.endsWith(']'))\n    ) {\n      return false;\n    }\n\n    try {\n      JSON.parse(trimmed);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index8.js","sources":["../../src/langchain-agent.ts"],"sourcesContent":["import type { BaseChatModel } from '@langchain/core/language_models/chat_models';\nimport type { StructuredTool } from '@langchain/core/tools';\nimport { createOpenAIToolsAgent } from 'langchain/agents';\nimport { ContentAwareAgentExecutor } from './langchain/ContentAwareAgentExecutor';\nimport {\n  ChatPromptTemplate,\n  MessagesPlaceholder,\n} from '@langchain/core/prompts';\nimport { ChatOpenAI } from '@langchain/openai';\nimport {\n  calculateTokenCostSync,\n  getAllHederaCorePlugins,\n  HederaAgentKit,\n  TokenUsageCallbackHandler,\n} from 'hedera-agent-kit';\nimport type { TokenUsage, CostCalculation } from 'hedera-agent-kit';\nimport {\n  BaseAgent,\n  type ConversationContext,\n  type ChatResponse,\n  type OperationalMode,\n  type UsageStats,\n} from './base-agent';\nimport { MCPClientManager } from './mcp/MCPClientManager';\nimport { convertMCPToolToLangChain } from './mcp/adapters/langchain';\nimport { SmartMemoryManager } from './memory/SmartMemoryManager';\n\nexport class LangChainAgent extends BaseAgent {\n  private executor: ContentAwareAgentExecutor | undefined;\n  private systemMessage = '';\n  private mcpManager?: MCPClientManager;\n  private smartMemory: SmartMemoryManager | undefined;\n\n  async boot(): Promise<void> {\n    if (this.initialized) {\n      this.logger.warn('Agent already initialized');\n      return;\n    }\n\n    try {\n      this.agentKit = await this.createAgentKit();\n      await this.agentKit.initialize();\n\n      const modelName =\n        this.config.ai?.modelName ||\n        process.env.OPENAI_MODEL_NAME ||\n        'gpt-4o-mini';\n      this.tokenTracker = new TokenUsageCallbackHandler(modelName);\n\n      const allTools = this.agentKit.getAggregatedLangChainTools();\n      this.tools = this.filterTools(allTools);\n\n      if (this.config.mcp?.servers && this.config.mcp.servers.length > 0) {\n        await this.initializeMCP();\n      }\n\n      this.smartMemory = new SmartMemoryManager({\n        modelName,\n        maxTokens: 90000,\n        reserveTokens: 10000,\n        storageLimit: 1000\n      });\n      \n      this.logger.info('SmartMemoryManager initialized:', {\n        modelName,\n        toolsCount: this.tools.length,\n        maxTokens: 90000,\n        reserveTokens: 10000\n      });\n\n      this.systemMessage = this.buildSystemPrompt();\n      \n      // Set the system prompt in smart memory\n      this.smartMemory.setSystemPrompt(this.systemMessage);\n\n      await this.createExecutor();\n\n      this.initialized = true;\n      this.logger.info('LangChain Hedera agent initialized');\n    } catch (error) {\n      this.logger.error('Failed to initialize agent:', error);\n      throw error;\n    }\n  }\n\n  async chat(\n    message: string,\n    context?: ConversationContext\n  ): Promise<ChatResponse> {\n    if (!this.initialized || !this.executor || !this.smartMemory) {\n      throw new Error('Agent not initialized. Call boot() first.');\n    }\n\n    try {\n      this.logger.info('LangChainAgent.chat called with:', { message, contextLength: context?.messages?.length || 0 });\n      \n      // If context is provided, populate smart memory with previous messages\n      if (context?.messages && context.messages.length > 0) {\n        // Clear existing memory and add messages from context\n        this.smartMemory.clear();\n        \n        for (const msg of context.messages) {\n          this.smartMemory.addMessage(msg);\n        }\n      }\n      \n      // Add the current user message to memory\n      const { HumanMessage } = await import('@langchain/core/messages');\n      this.smartMemory.addMessage(new HumanMessage(message));\n      \n      const memoryStats = this.smartMemory.getMemoryStats();\n      this.logger.info('Memory stats before execution:', {\n        totalMessages: memoryStats.totalActiveMessages,\n        currentTokens: memoryStats.currentTokenCount,\n        maxTokens: memoryStats.maxTokens,\n        usagePercentage: memoryStats.usagePercentage,\n        toolsCount: this.tools.length\n      });\n      \n      const result = await this.executor.invoke({\n        input: message,\n        chat_history: this.smartMemory.getMessages(),\n      });\n\n      this.logger.info('LangChainAgent executor result:', result);\n\n      let response: ChatResponse = {\n        output: result.output || '',\n        message: result.output || '',\n        notes: [],\n        intermediateSteps: result.intermediateSteps,\n      };\n\n      // Extract tool calls from intermediate steps\n      if (result.intermediateSteps && Array.isArray(result.intermediateSteps)) {\n        const toolCalls = result.intermediateSteps.map((step: any, index: number) => ({\n          id: `call_${index}`,\n          name: step.action?.tool || 'unknown',\n          args: step.action?.toolInput || {},\n          output: typeof step.observation === 'string' ? step.observation : JSON.stringify(step.observation)\n        }));\n        \n        if (toolCalls.length > 0) {\n          response.tool_calls = toolCalls;\n        }\n      }\n\n      const parsedSteps = result?.intermediateSteps?.[0]?.observation;\n      if (\n        parsedSteps &&\n        typeof parsedSteps === 'string' &&\n        this.isJSON(parsedSteps)\n      ) {\n        try {\n          const parsed = JSON.parse(parsedSteps);\n          response = { ...response, ...parsed };\n        } catch (error) {\n          this.logger.error('Error parsing intermediate steps:', error);\n        }\n      }\n\n      if (!response.output || response.output.trim() === '') {\n        response.output = 'Agent action complete.';\n      }\n\n      // Add the AI response to memory\n      if (response.output) {\n        const { AIMessage } = await import('@langchain/core/messages');\n        this.smartMemory.addMessage(new AIMessage(response.output));\n      }\n\n      if (this.tokenTracker) {\n        const tokenUsage = this.tokenTracker.getLatestTokenUsage();\n        if (tokenUsage) {\n          response.tokenUsage = tokenUsage;\n          response.cost = calculateTokenCostSync(tokenUsage);\n        }\n      }\n\n      const finalMemoryStats = this.smartMemory.getMemoryStats();\n      response.metadata = {\n        ...response.metadata,\n        memoryStats: {\n          activeMessages: finalMemoryStats.totalActiveMessages,\n          tokenUsage: finalMemoryStats.currentTokenCount,\n          maxTokens: finalMemoryStats.maxTokens,\n          usagePercentage: finalMemoryStats.usagePercentage\n        }\n      };\n\n      this.logger.info('LangChainAgent.chat returning response:', response);\n      return response;\n    } catch (error) {\n      this.logger.error('LangChainAgent.chat error:', error);\n      return this.handleError(error);\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.mcpManager) {\n      await this.mcpManager.disconnectAll();\n    }\n\n    if (this.smartMemory) {\n      this.smartMemory.dispose();\n      this.smartMemory = undefined;\n    }\n\n    this.executor = undefined;\n    this.agentKit = undefined;\n    this.tools = [];\n    this.initialized = false;\n    this.logger.info('Agent cleaned up');\n  }\n\n  switchMode(mode: OperationalMode): void {\n    if (this.config.execution) {\n      this.config.execution.operationalMode = mode;\n    } else {\n      this.config.execution = { operationalMode: mode };\n    }\n\n    if (this.agentKit) {\n      this.agentKit.operationalMode = mode;\n    }\n\n    this.systemMessage = this.buildSystemPrompt();\n    this.logger.info(`Operational mode switched to: ${mode}`);\n  }\n\n  getUsageStats(): UsageStats {\n    if (!this.tokenTracker) {\n      return {\n        promptTokens: 0,\n        completionTokens: 0,\n        totalTokens: 0,\n        cost: { totalCost: 0 } as CostCalculation,\n      };\n    }\n\n    const usage = this.tokenTracker.getTotalTokenUsage();\n    const cost = calculateTokenCostSync(usage);\n    return { ...usage, cost };\n  }\n\n  getUsageLog(): UsageStats[] {\n    if (!this.tokenTracker) {\n      return [];\n    }\n\n    return this.tokenTracker.getTokenUsageHistory().map((usage) => ({\n      ...usage,\n      cost: calculateTokenCostSync(usage),\n    }));\n  }\n\n  clearUsageStats(): void {\n    if (this.tokenTracker) {\n      this.tokenTracker.reset();\n      this.logger.info('Usage statistics cleared');\n    }\n  }\n\n\n  private async createAgentKit(): Promise<HederaAgentKit> {\n    const corePlugins = getAllHederaCorePlugins();\n    const extensionPlugins = this.config.extensions?.plugins || [];\n    const plugins = [...corePlugins, ...extensionPlugins];\n\n    const operationalMode =\n      this.config.execution?.operationalMode || 'returnBytes';\n    const modelName = this.config.ai?.modelName || 'gpt-4o';\n\n    return new HederaAgentKit(\n      this.config.signer,\n      { plugins },\n      operationalMode,\n      this.config.execution?.userAccountId,\n      this.config.execution?.scheduleUserTransactionsInBytesMode ?? true,\n      undefined,\n      modelName,\n      this.config.extensions?.mirrorConfig,\n      this.config.debug?.silent ?? false\n    );\n  }\n\n  private async createExecutor(): Promise<void> {\n    let llm: BaseChatModel;\n    if (this.config.ai?.provider && this.config.ai.provider.getModel) {\n      llm = this.config.ai.provider.getModel() as BaseChatModel;\n    } else if (this.config.ai?.llm) {\n      llm = this.config.ai.llm as BaseChatModel;\n    } else {\n      const apiKey = this.config.ai?.apiKey || process.env.OPENAI_API_KEY;\n      if (!apiKey) {\n        throw new Error('OpenAI API key required');\n      }\n\n      llm = new ChatOpenAI({\n        apiKey,\n        modelName: this.config.ai?.modelName || 'gpt-4o-mini',\n        temperature: this.config.ai?.temperature ?? 0.1,\n        callbacks: this.tokenTracker ? [this.tokenTracker] : [],\n      });\n    }\n\n    const prompt = ChatPromptTemplate.fromMessages([\n      ['system', this.systemMessage],\n      new MessagesPlaceholder('chat_history'),\n      ['human', '{input}'],\n      new MessagesPlaceholder('agent_scratchpad'),\n    ]);\n\n    const langchainTools = this.tools as unknown as StructuredTool[];\n\n    const agent = await createOpenAIToolsAgent({\n      llm,\n      tools: langchainTools,\n      prompt,\n    });\n\n    // Create executor without memory - we handle memory manually with SmartMemoryManager\n    this.executor = new ContentAwareAgentExecutor({\n      agent,\n      tools: langchainTools,\n      verbose: this.config.debug?.verbose ?? false,\n      returnIntermediateSteps: true,\n    });\n  }\n\n  private handleError(error: unknown): ChatResponse {\n    const errorMessage =\n      error instanceof Error ? error.message : 'Unknown error';\n    this.logger.error('Chat error:', error);\n\n    let tokenUsage: TokenUsage | undefined;\n    let cost: CostCalculation | undefined;\n\n    if (this.tokenTracker) {\n      tokenUsage = this.tokenTracker.getLatestTokenUsage();\n      if (tokenUsage) {\n        cost = calculateTokenCostSync(tokenUsage);\n      }\n    }\n\n    const errorResponse: ChatResponse = {\n      output: 'Sorry, I encountered an error processing your request.',\n      message: 'Error processing request.',\n      error: errorMessage,\n      notes: [],\n    };\n\n    if (tokenUsage) {\n      errorResponse.tokenUsage = tokenUsage;\n    }\n\n    if (cost) {\n      errorResponse.cost = cost;\n    }\n\n    return errorResponse;\n  }\n\n  private async initializeMCP(): Promise<void> {\n    this.mcpManager = new MCPClientManager(this.logger);\n\n    for (const serverConfig of this.config.mcp!.servers!) {\n      if (serverConfig.autoConnect === false) {\n        this.logger.info(\n          `Skipping MCP server ${serverConfig.name} (autoConnect=false)`\n        );\n        continue;\n      }\n\n      const status = await this.mcpManager.connectServer(serverConfig);\n\n      if (status.connected) {\n        this.logger.info(\n          `Connected to MCP server ${status.serverName} with ${status.tools.length} tools`\n        );\n\n        for (const mcpTool of status.tools) {\n          const langchainTool = convertMCPToolToLangChain(\n            mcpTool,\n            this.mcpManager,\n            serverConfig\n          );\n          this.tools.push(langchainTool);\n        }\n      } else {\n        this.logger.error(\n          `Failed to connect to MCP server ${status.serverName}: ${status.error}`\n        );\n      }\n    }\n  }\n\n  /**\n   * Check if a string is valid JSON\n   */\n  private isJSON(str: string): boolean {\n    if (typeof str !== 'string') return false;\n\n    const trimmed = str.trim();\n    if (!trimmed) return false;\n\n    if (\n      !(trimmed.startsWith('{') && trimmed.endsWith('}')) &&\n      !(trimmed.startsWith('[') && trimmed.endsWith(']'))\n    ) {\n      return false;\n    }\n\n    try {\n      JSON.parse(trimmed);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/types/langchain/ContentAwareAgentExecutor.d.ts

@@ -0,0 +1,14 @@
+import { AgentExecutor } from 'langchain/agents';
+
+/**
+ * Custom AgentExecutor that intercepts large tool outputs and converts them to content references
+ * before they are sent to the LLM to avoid token limit issues.
+ *
+ * Note: The content reference conversion is already handled in the MCP adapter,
+ * so this class currently just extends AgentExecutor without modifications.
+ * We keep it as a placeholder for future enhancements.
+ */
+export declare class ContentAwareAgentExecutor extends AgentExecutor {
+    private logger;
+    constructor(config: any);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/conversational-agent",
-  "version": "0.1.206",
+  "version": "0.1.208",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",

package/src/langchain/ContentAwareAgentExecutor.ts

@@ -0,0 +1,20 @@
+import { AgentExecutor } from 'langchain/agents';
+import type { ChainValues } from '@langchain/core/utils/types';
+import { Logger } from '@hashgraphonline/standards-sdk';
+
+/**
+ * Custom AgentExecutor that intercepts large tool outputs and converts them to content references
+ * before they are sent to the LLM to avoid token limit issues.
+ * 
+ * Note: The content reference conversion is already handled in the MCP adapter,
+ * so this class currently just extends AgentExecutor without modifications.
+ * We keep it as a placeholder for future enhancements.
+ */
+export class ContentAwareAgentExecutor extends AgentExecutor {
+  private logger: Logger;
+
+  constructor(config: any) {
+    super(config);
+    this.logger = new Logger({ module: 'ContentAwareAgentExecutor' });
+  }
+}

package/src/langchain-agent.ts

@@ -1,6 +1,7 @@
 import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
 import type { StructuredTool } from '@langchain/core/tools';
-import { createOpenAIToolsAgent, AgentExecutor } from 'langchain/agents';
+import { createOpenAIToolsAgent } from 'langchain/agents';
+import { ContentAwareAgentExecutor } from './langchain/ContentAwareAgentExecutor';
 import {
   ChatPromptTemplate,
   MessagesPlaceholder,
@@ -25,7 +26,7 @@ import { convertMCPToolToLangChain } from './mcp/adapters/langchain';
 import { SmartMemoryManager } from './memory/SmartMemoryManager';
 
 export class LangChainAgent extends BaseAgent {
-  private executor: AgentExecutor | undefined;
+  private executor: ContentAwareAgentExecutor | undefined;
   private systemMessage = '';
   private mcpManager?: MCPClientManager;
   private smartMemory: SmartMemoryManager | undefined;
@@ -319,7 +320,7 @@ export class LangChainAgent extends BaseAgent {
     });
 
     // Create executor without memory - we handle memory manually with SmartMemoryManager
-    this.executor = new AgentExecutor({
+    this.executor = new ContentAwareAgentExecutor({
       agent,
       tools: langchainTools,
       verbose: this.config.debug?.verbose ?? false,

package/src/mcp/adapters/langchain.ts

@@ -2,6 +2,8 @@ import { DynamicStructuredTool } from '@langchain/core/tools';
 import { z } from 'zod';
 import type { MCPToolInfo, MCPServerConfig } from '../types';
 import type { MCPClientManager } from '../MCPClientManager';
+import { ContentStoreService, shouldUseReference } from '@hashgraphonline/standards-sdk';
+import type { ContentSource } from '../../types/content-reference';
 
 /**
  * Convert an MCP tool to a LangChain DynamicStructuredTool
@@ -69,6 +71,36 @@ export function convertMCPToolToLangChain(
           responseText = JSON.stringify(result);
         }
 
+        // Check if content should be stored as reference
+        const responseBuffer = Buffer.from(responseText, 'utf8');
+        console.log(`[MCP Adapter] Response size: ${responseBuffer.length} bytes, tool: ${tool.serverName}_${tool.name}`);
+        
+        // Use a lower threshold for MCP tools (10KB) to avoid token limit issues
+        const MCP_REFERENCE_THRESHOLD = 10 * 1024; // 10KB
+        const shouldStoreMCPContent = responseBuffer.length > MCP_REFERENCE_THRESHOLD;
+        
+        if (shouldStoreMCPContent || shouldUseReference(responseBuffer)) {
+          console.log(`[MCP Adapter] Content exceeds threshold (${responseBuffer.length} > ${MCP_REFERENCE_THRESHOLD}), storing as reference`);
+          const contentStore = ContentStoreService.getInstance();
+          if (contentStore) {
+            try {
+              const referenceId = await contentStore.storeContent(responseBuffer, {
+                contentType: 'text' as ContentSource,
+                source: 'mcp',
+                mcpToolName: `${tool.serverName}_${tool.name}`,
+                originalSize: responseBuffer.length
+              });
+              console.log(`[MCP Adapter] Stored content as reference: content-ref:${referenceId}`);
+              return `content-ref:${referenceId}`;
+            } catch (storeError) {
+              // If storage fails, fall back to returning the content
+              console.warn('Failed to store large MCP content as reference:', storeError);
+            }
+          } else {
+            console.warn('[MCP Adapter] ContentStoreService not available');
+          }
+        }
+
         return responseText;
       } catch (error) {
         const errorMessage =