@hashgraphonline/conversational-agent 0.2.215 → 0.2.217

package/dist/esm/index22.js.map

@@ -1 +1 @@
-{"version":3,"file":"index22.js","sources":["../../src/memory/reference-id-generator.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('hex');\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    if (id.length !== 64) {\n      return false;\n    }\n    \n    return /^[a-f0-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    const refFormatMatch = input.match(/^ref:\\/\\/([a-f0-9]{64})$/);\n    if (refFormatMatch) {\n      return refFormatMatch[1] as ReferenceId;\n    }\n    \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,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,IAA+B;AACvD,QAAI,CAAC,MAAM,OAAO,OAAO,UAAU;AACjC,aAAO;AAAA,IACT;AAEA,QAAI,GAAG,WAAW,IAAI;AACpB,aAAO;AAAA,IACT;AAEA,WAAO,cAAc,KAAK,EAAE;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,OAAmC;AAC3D,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,aAAO;AAAA,IACT;AAEA,UAAM,iBAAiB,MAAM,MAAM,0BAA0B;AAC7D,QAAI,gBAAgB;AAClB,aAAO,eAAe,CAAC;AAAA,IACzB;AAEA,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;"}
+{"version":3,"file":"index22.js","sources":["../../src/memory/content-storage.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport { ReferenceIdGenerator } from './reference-id-generator';\nimport {\n  ReferenceId,\n  ContentReference,\n  ContentMetadata,\n  ReferenceResolutionResult,\n  ContentReferenceConfig,\n  ContentReferenceStore,\n  ContentReferenceStats,\n  ContentReferenceError,\n  ContentType,\n  ContentSource,\n  ReferenceLifecycleState,\n  DEFAULT_CONTENT_REFERENCE_CONFIG,\n} from '../types/content-reference';\n\n/**\n * Stored message with metadata\n */\ninterface StoredMessage {\n  message: BaseMessage;\n  storedAt: Date;\n  id: string;\n}\n\n/**\n * Search options for message queries\n */\ninterface SearchOptions {\n  /** Whether to perform case-sensitive search */\n  caseSensitive?: boolean;\n  /** Maximum number of results to return */\n  limit?: number;\n  /** Whether to use regex pattern matching */\n  useRegex?: boolean;\n}\n\n/**\n * Result of storing messages\n */\ninterface StoreResult {\n  /** Number of messages successfully stored */\n  stored: number;\n  /** Number of old messages dropped to make room */\n  dropped: number;\n}\n\n/**\n * Storage statistics\n */\nexport interface StorageStats {\n  /** Total number of messages currently stored */\n  totalMessages: number;\n  /** Maximum storage capacity */\n  maxStorageLimit: number;\n  /** Percentage of storage used */\n  usagePercentage: number;\n  /** Timestamp of oldest message */\n  oldestMessageTime: Date | undefined;\n  /** Timestamp of newest message */\n  newestMessageTime: Date | undefined;\n}\n\n/**\n * Stored content with reference metadata\n */\ninterface StoredContent {\n  /** The actual content buffer */\n  content: Buffer;\n\n  /** Complete metadata */\n  metadata: ContentMetadata;\n\n  /** Current lifecycle state */\n  state: ReferenceLifecycleState;\n\n  /** When this reference expires (if applicable) */\n  expiresAt?: Date;\n}\n\n/**\n * Content storage for managing pruned conversation messages and large content references\n * Provides searchable storage with time-based querying and automatic cleanup.\n *\n * Extended to support reference-based storage for large content to optimize context window usage.\n */\nexport class ContentStorage implements ContentReferenceStore {\n  private messages: StoredMessage[] = [];\n  private maxStorage: number;\n  private idCounter: number = 0;\n\n  private contentStore: Map<ReferenceId, StoredContent> = new Map();\n  private referenceConfig: ContentReferenceConfig;\n  private cleanupTimer?: NodeJS.Timeout;\n  private referenceStats: Omit<ContentReferenceStats, 'performanceMetrics'> & {\n    performanceMetrics: ContentReferenceStats['performanceMetrics'] & {\n      creationTimes: number[];\n      resolutionTimes: number[];\n      cleanupTimes: number[];\n    };\n  };\n\n  public static readonly DEFAULT_MAX_STORAGE = 1000;\n\n  constructor(\n    maxStorage: number = ContentStorage.DEFAULT_MAX_STORAGE,\n    referenceConfig?: Partial<ContentReferenceConfig>\n  ) {\n    this.maxStorage = maxStorage;\n\n    this.referenceConfig = {\n      ...DEFAULT_CONTENT_REFERENCE_CONFIG,\n      ...referenceConfig,\n    };\n    this.referenceStats = {\n      activeReferences: 0,\n      totalStorageBytes: 0,\n      recentlyCleanedUp: 0,\n      totalResolutions: 0,\n      failedResolutions: 0,\n      averageContentSize: 0,\n      storageUtilization: 0,\n      performanceMetrics: {\n        averageCreationTimeMs: 0,\n        averageResolutionTimeMs: 0,\n        averageCleanupTimeMs: 0,\n        creationTimes: [],\n        resolutionTimes: [],\n        cleanupTimes: [],\n      },\n    };\n\n    if (this.referenceConfig.enableAutoCleanup) {\n      this.startReferenceCleanupTimer();\n    }\n  }\n\n  /**\n   * Store messages in the content storage\n   * Automatically drops oldest messages if storage limit is exceeded\n   * @param messages - Messages to store\n   * @returns Result indicating how many messages were stored and dropped\n   */\n  storeMessages(messages: BaseMessage[]): StoreResult {\n    if (messages.length === 0) {\n      return { stored: 0, dropped: 0 };\n    }\n\n    const now = new Date();\n    let dropped = 0;\n\n    const storedMessages: StoredMessage[] = messages.map((message) => ({\n      message,\n      storedAt: now,\n      id: this.generateId(),\n    }));\n\n    this.messages.push(...storedMessages);\n\n    while (this.messages.length > this.maxStorage) {\n      this.messages.shift();\n      dropped++;\n    }\n\n    return {\n      stored: storedMessages.length,\n      dropped,\n    };\n  }\n\n  /**\n   * Get the most recent messages from storage\n   * @param count - Number of recent messages to retrieve\n   * @returns Array of recent messages in chronological order\n   */\n  getRecentMessages(count: number): BaseMessage[] {\n    if (count <= 0 || this.messages.length === 0) {\n      return [];\n    }\n\n    const startIndex = Math.max(0, this.messages.length - count);\n    return this.messages.slice(startIndex).map((stored) => stored.message);\n  }\n\n  /**\n   * Search for messages containing specific text or patterns\n   * @param query - Search term or regex pattern\n   * @param options - Search configuration options\n   * @returns Array of matching messages\n   */\n  searchMessages(query: string, options: SearchOptions = {}): BaseMessage[] {\n    if (!query || this.messages.length === 0) {\n      return [];\n    }\n\n    const { caseSensitive = false, limit, useRegex = false } = options;\n\n    let matches: BaseMessage[] = [];\n\n    if (useRegex) {\n      try {\n        const regex = new RegExp(query, caseSensitive ? 'g' : 'gi');\n        matches = this.messages\n          .filter((stored) => regex.test(stored.message.content as string))\n          .map((stored) => stored.message);\n      } catch {\n        return [];\n      }\n    } else {\n      const searchTerm = caseSensitive ? query : query.toLowerCase();\n      matches = this.messages\n        .filter((stored) => {\n          const content = stored.message.content as string;\n          const searchContent = caseSensitive ? content : content.toLowerCase();\n          return searchContent.includes(searchTerm);\n        })\n        .map((stored) => stored.message);\n    }\n\n    return limit ? matches.slice(0, limit) : matches;\n  }\n\n  /**\n   * Get messages from a specific time range\n   * @param startTime - Start of time range (inclusive)\n   * @param endTime - End of time range (inclusive)\n   * @returns Array of messages within the time range\n   */\n  getMessagesFromTimeRange(startTime: Date, endTime: Date): BaseMessage[] {\n    if (startTime > endTime || this.messages.length === 0) {\n      return [];\n    }\n\n    return this.messages\n      .filter(\n        (stored) => stored.storedAt >= startTime && stored.storedAt <= endTime\n      )\n      .map((stored) => stored.message);\n  }\n\n  /**\n   * Get storage statistics and usage information\n   * @returns Current storage statistics\n   */\n  getStorageStats(): StorageStats {\n    const totalMessages = this.messages.length;\n    const usagePercentage =\n      totalMessages > 0\n        ? Math.round((totalMessages / this.maxStorage) * 100)\n        : 0;\n\n    let oldestMessageTime: Date | undefined;\n    let newestMessageTime: Date | undefined;\n\n    if (totalMessages > 0) {\n      oldestMessageTime = this.messages[0].storedAt;\n      newestMessageTime = this.messages[totalMessages - 1].storedAt;\n    }\n\n    return {\n      totalMessages,\n      maxStorageLimit: this.maxStorage,\n      usagePercentage,\n      oldestMessageTime,\n      newestMessageTime,\n    };\n  }\n\n  /**\n   * Clear all stored messages\n   */\n  clear(): void {\n    this.messages = [];\n    this.idCounter = 0;\n  }\n\n  /**\n   * Get total number of stored messages\n   * @returns Number of messages currently in storage\n   */\n  getTotalStoredMessages(): number {\n    return this.messages.length;\n  }\n\n  /**\n   * Update the maximum storage limit\n   * @param newLimit - New maximum storage limit\n   */\n  updateStorageLimit(newLimit: number): void {\n    if (newLimit <= 0) {\n      throw new Error('Storage limit must be greater than 0');\n    }\n\n    this.maxStorage = newLimit;\n\n    while (this.messages.length > this.maxStorage) {\n      this.messages.shift();\n    }\n  }\n\n  /**\n   * Get messages by message type\n   * @param messageType - Type of messages to retrieve ('human', 'ai', 'system', etc.)\n   * @param limit - Maximum number of messages to return\n   * @returns Array of messages of the specified type\n   */\n  getMessagesByType(messageType: string, limit?: number): BaseMessage[] {\n    const filtered = this.messages\n      .filter((stored) => stored.message._getType() === messageType)\n      .map((stored) => stored.message);\n\n    return limit ? filtered.slice(0, limit) : filtered;\n  }\n\n  /**\n   * Get the current storage configuration\n   * @returns Storage configuration object\n   */\n  getConfig(): {\n    maxStorage: number;\n    currentUsage: number;\n    utilizationPercentage: number;\n  } {\n    return {\n      maxStorage: this.maxStorage,\n      currentUsage: this.messages.length,\n      utilizationPercentage: (this.messages.length / this.maxStorage) * 100,\n    };\n  }\n\n  /**\n   * Generate a unique ID for stored messages\n   * @returns Unique string identifier\n   */\n  private generateId(): string {\n    return `msg_${++this.idCounter}_${Date.now()}`;\n  }\n\n  /**\n   * Get messages stored within the last N minutes\n   * @param minutes - Number of minutes to look back\n   * @returns Array of messages from the last N minutes\n   */\n  getRecentMessagesByTime(minutes: number): BaseMessage[] {\n    if (minutes <= 0 || this.messages.length === 0) {\n      return [];\n    }\n\n    const cutoffTime = new Date(Date.now() - minutes * 60 * 1000);\n\n    return this.messages\n      .filter((stored) => stored.storedAt >= cutoffTime)\n      .map((stored) => stored.message);\n  }\n\n  /**\n   * Export messages to a JSON-serializable format\n   * @returns Serializable representation of stored messages\n   */\n  exportMessages(): Array<{\n    content: string;\n    type: string;\n    storedAt: string;\n    id: string;\n  }> {\n    return this.messages.map((stored) => ({\n      content:\n        typeof stored.message.content === 'string'\n          ? stored.message.content\n          : JSON.stringify(stored.message.content),\n      type: stored.message._getType(),\n      storedAt: stored.storedAt.toISOString(),\n      id: stored.id,\n    }));\n  }\n\n  /**\n   * Determine if content should be stored as a reference based on size\n   */\n  shouldUseReference(content: Buffer | string): boolean {\n    const size = Buffer.isBuffer(content)\n      ? content.length\n      : Buffer.byteLength(content, 'utf8');\n    return size > this.referenceConfig.sizeThresholdBytes;\n  }\n\n  /**\n   * Store content and return a reference if it exceeds the size threshold\n   * Otherwise returns null to indicate direct content should be used\n   *\n   * Special case: Image files are ALWAYS stored as references regardless of size\n   * because they need special handling for inscription tools\n   */\n  async storeContentIfLarge(\n    content: Buffer | string,\n    metadata: {\n      contentType?: ContentType;\n      mimeType?: string;\n      source: ContentSource;\n      mcpToolName?: string;\n      fileName?: string;\n      tags?: string[];\n      customMetadata?: Record<string, unknown>;\n    }\n  ): Promise<ContentReference | null> {\n    const buffer = Buffer.isBuffer(content)\n      ? content\n      : Buffer.from(content, 'utf8');\n\n    const isImageFile = this.isImageContent(\n      metadata.mimeType,\n      metadata.fileName\n    );\n\n    if (!isImageFile && !this.shouldUseReference(buffer)) {\n      return null;\n    }\n\n    const storeMetadata: Omit<\n      ContentMetadata,\n      'createdAt' | 'lastAccessedAt' | 'accessCount'\n    > = {\n      contentType:\n        metadata.contentType ||\n        this.detectContentType(buffer, metadata.mimeType),\n      sizeBytes: buffer.length,\n      source: metadata.source,\n      tags: [],\n    };\n\n    if (metadata.mimeType !== undefined) {\n      storeMetadata.mimeType = metadata.mimeType;\n    }\n    if (metadata.mcpToolName !== undefined) {\n      storeMetadata.mcpToolName = metadata.mcpToolName;\n    }\n    if (metadata.fileName !== undefined) {\n      storeMetadata.fileName = metadata.fileName;\n    }\n    if (metadata.tags !== undefined) {\n      storeMetadata.tags = metadata.tags;\n    }\n    if (metadata.customMetadata !== undefined) {\n      storeMetadata.customMetadata = metadata.customMetadata;\n    }\n\n    return await this.storeContent(buffer, storeMetadata);\n  }\n\n  /**\n   * Store content and return a reference (implements ContentReferenceStore)\n   */\n  async storeContent(\n    content: Buffer,\n    metadata: Omit<\n      ContentMetadata,\n      'createdAt' | 'lastAccessedAt' | 'accessCount'\n    >\n  ): Promise<ContentReference> {\n    const startTime = Date.now();\n\n    try {\n      const now = new Date();\n      const referenceId = ReferenceIdGenerator.generateId(content);\n\n      const fullMetadata: ContentMetadata = {\n        ...metadata,\n        createdAt: now,\n        lastAccessedAt: now,\n        accessCount: 0,\n      };\n\n      const storedContent: StoredContent = {\n        content,\n        metadata: fullMetadata,\n        state: 'active',\n      };\n\n      const expirationTime = this.calculateExpirationTime(metadata.source);\n      if (expirationTime !== undefined) {\n        storedContent.expiresAt = expirationTime;\n      }\n\n      this.contentStore.set(referenceId, storedContent);\n\n      this.updateStatsAfterStore(content.length);\n\n      await this.enforceReferenceStorageLimits();\n\n      const preview = this.createContentPreview(\n        content,\n        fullMetadata.contentType\n      );\n\n      const referenceMetadata: Pick<\n        ContentMetadata,\n        'contentType' | 'sizeBytes' | 'source' | 'fileName' | 'mimeType'\n      > = {\n        contentType: fullMetadata.contentType,\n        sizeBytes: fullMetadata.sizeBytes,\n        source: fullMetadata.source,\n      };\n\n      if (fullMetadata.fileName !== undefined) {\n        referenceMetadata.fileName = fullMetadata.fileName;\n      }\n      if (fullMetadata.mimeType !== undefined) {\n        referenceMetadata.mimeType = fullMetadata.mimeType;\n      }\n\n      const reference: ContentReference = {\n        referenceId,\n        state: 'active',\n        preview,\n        metadata: referenceMetadata,\n        createdAt: now,\n        format: 'ref://{id}' as const,\n      };\n\n      const duration = Date.now() - startTime;\n      this.recordPerformanceMetric('creation', duration);\n\n      return reference;\n    } catch (error) {\n      const duration = Date.now() - startTime;\n      this.recordPerformanceMetric('creation', duration);\n\n      throw new ContentReferenceError(\n        `Failed to store content: ${\n          error instanceof Error ? error.message : 'Unknown error'\n        }`,\n        'system_error',\n        undefined,\n        ['Try again', 'Check storage limits', 'Contact administrator']\n      );\n    }\n  }\n\n  /**\n   * Resolve a reference to its content (implements ContentReferenceStore)\n   */\n  async resolveReference(\n    referenceId: ReferenceId\n  ): Promise<ReferenceResolutionResult> {\n    const startTime = Date.now();\n\n    try {\n      if (!ReferenceIdGenerator.isValidReferenceId(referenceId)) {\n        this.referenceStats.failedResolutions++;\n        return {\n          success: false,\n          error: 'Invalid reference ID format',\n          errorType: 'not_found',\n          suggestedActions: [\n            'Check the reference ID format',\n            'Ensure the reference ID is complete',\n          ],\n        };\n      }\n\n      const storedContent = this.contentStore.get(referenceId);\n\n      if (!storedContent) {\n        this.referenceStats.failedResolutions++;\n        return {\n          success: false,\n          error: 'Reference not found',\n          errorType: 'not_found',\n          suggestedActions: [\n            'Verify the reference ID',\n            'Check if the content has expired',\n            'Request fresh content',\n          ],\n        };\n      }\n\n      if (storedContent.expiresAt && storedContent.expiresAt < new Date()) {\n        storedContent.state = 'expired';\n        this.referenceStats.failedResolutions++;\n        return {\n          success: false,\n          error: 'Reference has expired',\n          errorType: 'expired',\n          suggestedActions: [\n            'Request fresh content',\n            'Use alternative content source',\n          ],\n        };\n      }\n\n      if (storedContent.state !== 'active') {\n        this.referenceStats.failedResolutions++;\n        return {\n          success: false,\n          error: `Reference is ${storedContent.state}`,\n          errorType:\n            storedContent.state === 'expired' ? 'expired' : 'corrupted',\n          suggestedActions: [\n            'Request fresh content',\n            'Check reference validity',\n          ],\n        };\n      }\n\n      storedContent.metadata.lastAccessedAt = new Date();\n      storedContent.metadata.accessCount++;\n\n      this.referenceStats.totalResolutions++;\n\n      const duration = Date.now() - startTime;\n      this.recordPerformanceMetric('resolution', duration);\n\n      return {\n        success: true,\n        content: storedContent.content,\n        metadata: storedContent.metadata,\n      };\n    } catch (error) {\n      const duration = Date.now() - startTime;\n      this.recordPerformanceMetric('resolution', duration);\n\n      this.referenceStats.failedResolutions++;\n\n      return {\n        success: false,\n        error: `System error resolving reference: ${\n          error instanceof Error ? error.message : 'Unknown error'\n        }`,\n        errorType: 'system_error',\n        suggestedActions: ['Try again', 'Contact administrator'],\n      };\n    }\n  }\n\n  /**\n   * Check if a reference exists and is valid\n   */\n  async hasReference(referenceId: ReferenceId): Promise<boolean> {\n    if (!ReferenceIdGenerator.isValidReferenceId(referenceId)) {\n      return false;\n    }\n\n    const storedContent = this.contentStore.get(referenceId);\n    if (!storedContent) {\n      return false;\n    }\n\n    if (storedContent.expiresAt && storedContent.expiresAt < new Date()) {\n      storedContent.state = 'expired';\n      return false;\n    }\n\n    return storedContent.state === 'active';\n  }\n\n  /**\n   * Mark a reference for cleanup\n   */\n  async cleanupReference(referenceId: ReferenceId): Promise<boolean> {\n    const storedContent = this.contentStore.get(referenceId);\n    if (!storedContent) {\n      return false;\n    }\n\n    this.referenceStats.totalStorageBytes -= storedContent.content.length;\n    this.referenceStats.activeReferences--;\n    this.referenceStats.recentlyCleanedUp++;\n\n    this.contentStore.delete(referenceId);\n\n    return true;\n  }\n\n  /**\n   * Get current reference storage statistics (implements ContentReferenceStore)\n   */\n  async getStats(): Promise<ContentReferenceStats> {\n    this.updateReferenceStorageStats();\n\n    return {\n      ...this.referenceStats,\n      performanceMetrics: {\n        averageCreationTimeMs: this.calculateAverage(\n          this.referenceStats.performanceMetrics.creationTimes\n        ),\n        averageResolutionTimeMs: this.calculateAverage(\n          this.referenceStats.performanceMetrics.resolutionTimes\n        ),\n        averageCleanupTimeMs: this.calculateAverage(\n          this.referenceStats.performanceMetrics.cleanupTimes\n        ),\n      },\n    };\n  }\n\n  /**\n   * Update reference configuration\n   */\n  async updateConfig(config: Partial<ContentReferenceConfig>): Promise<void> {\n    this.referenceConfig = { ...this.referenceConfig, ...config };\n\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      delete this.cleanupTimer;\n    }\n\n    if (this.referenceConfig.enableAutoCleanup) {\n      this.startReferenceCleanupTimer();\n    }\n  }\n\n  /**\n   * Perform cleanup based on current policies (implements ContentReferenceStore)\n   */\n  async performCleanup(): Promise<{ cleanedUp: number; errors: string[] }> {\n    const startTime = Date.now();\n    const errors: string[] = [];\n    let cleanedUp = 0;\n\n    try {\n      const now = new Date();\n      const toCleanup: ReferenceId[] = [];\n\n      for (const [referenceId, storedContent] of this.contentStore.entries()) {\n        let shouldCleanup = false;\n\n        if (storedContent.expiresAt && storedContent.expiresAt < now) {\n          shouldCleanup = true;\n          storedContent.state = 'expired';\n        }\n\n        const ageMs =\n          now.getTime() - storedContent.metadata.createdAt.getTime();\n        const policy = this.getCleanupPolicy(storedContent.metadata.source);\n\n        if (ageMs > policy.maxAgeMs) {\n          shouldCleanup = true;\n        }\n\n        if (storedContent.state === 'cleanup_pending') {\n          shouldCleanup = true;\n        }\n\n        if (shouldCleanup) {\n          toCleanup.push(referenceId);\n        }\n      }\n\n      toCleanup.sort((a, b) => {\n        const aContent = this.contentStore.get(a)!;\n        const bContent = this.contentStore.get(b)!;\n        const aPriority = this.getCleanupPolicy(\n          aContent.metadata.source\n        ).priority;\n        const bPriority = this.getCleanupPolicy(\n          bContent.metadata.source\n        ).priority;\n        return bPriority - aPriority;\n      });\n\n      for (const referenceId of toCleanup) {\n        try {\n          const success = await this.cleanupReference(referenceId);\n          if (success) {\n            cleanedUp++;\n          }\n        } catch (error) {\n          errors.push(\n            `Failed to cleanup ${referenceId}: ${\n              error instanceof Error ? error.message : 'Unknown error'\n            }`\n          );\n        }\n      }\n\n      if (this.contentStore.size > this.referenceConfig.maxReferences) {\n        const sortedByAge = Array.from(this.contentStore.entries()).sort(\n          ([, a], [, b]) =>\n            a.metadata.lastAccessedAt.getTime() -\n            b.metadata.lastAccessedAt.getTime()\n        );\n\n        const excessCount =\n          this.contentStore.size - this.referenceConfig.maxReferences;\n        for (let i = 0; i < excessCount && i < sortedByAge.length; i++) {\n          const [referenceId] = sortedByAge[i];\n          try {\n            const success = await this.cleanupReference(referenceId);\n            if (success) {\n              cleanedUp++;\n            }\n          } catch (error) {\n            errors.push(\n              `Failed to cleanup excess reference ${referenceId}: ${\n                error instanceof Error ? error.message : 'Unknown error'\n              }`\n            );\n          }\n        }\n      }\n\n      const duration = Date.now() - startTime;\n      this.recordPerformanceMetric('cleanup', duration);\n\n      return { cleanedUp, errors };\n    } catch (error) {\n      const duration = Date.now() - startTime;\n      this.recordPerformanceMetric('cleanup', duration);\n\n      const errorMessage = `Cleanup process failed: ${\n        error instanceof Error ? error.message : 'Unknown error'\n      }`;\n      errors.push(errorMessage);\n\n      return { cleanedUp, errors };\n    }\n  }\n\n  /**\n   * Get reference configuration for debugging\n   */\n  getReferenceConfig(): ContentReferenceConfig {\n    return { ...this.referenceConfig };\n  }\n\n  private async enforceReferenceStorageLimits(): Promise<void> {\n    if (this.contentStore.size >= this.referenceConfig.maxReferences) {\n      await this.performCleanup();\n    }\n\n    if (\n      this.referenceStats.totalStorageBytes >=\n      this.referenceConfig.maxTotalStorageBytes\n    ) {\n      await this.performCleanup();\n    }\n  }\n\n  private calculateExpirationTime(source: ContentSource): Date | undefined {\n    const policy = this.getCleanupPolicy(source);\n    return new Date(Date.now() + policy.maxAgeMs);\n  }\n\n  private getCleanupPolicy(source: ContentSource): {\n    maxAgeMs: number;\n    priority: number;\n  } {\n    switch (source) {\n      case 'mcp_tool':\n        return this.referenceConfig.cleanupPolicies.recent;\n      case 'user_upload':\n        return this.referenceConfig.cleanupPolicies.userContent;\n      case 'agent_generated':\n        return this.referenceConfig.cleanupPolicies.agentGenerated;\n      default:\n        return this.referenceConfig.cleanupPolicies.default;\n    }\n  }\n\n  private detectContentType(content: Buffer, mimeType?: string): ContentType {\n    if (mimeType) {\n      if (mimeType === 'text/html') return 'html';\n      if (mimeType === 'text/markdown') return 'markdown';\n      if (mimeType === 'application/json') return 'json';\n      if (mimeType.startsWith('text/')) return 'text';\n      return 'binary';\n    }\n\n    const contentStr = content.toString(\n      'utf8',\n      0,\n      Math.min(content.length, 1000)\n    );\n    if (contentStr.startsWith('{') || contentStr.startsWith('[')) return 'json';\n    if (contentStr.includes('<html>') || contentStr.includes('<!DOCTYPE'))\n      return 'html';\n    if (contentStr.includes('#') && contentStr.includes('\\n'))\n      return 'markdown';\n\n    return 'text';\n  }\n\n  private createContentPreview(\n    content: Buffer,\n    contentType: ContentType\n  ): string {\n    const maxLength = 200;\n    let preview = content.toString(\n      'utf8',\n      0,\n      Math.min(content.length, maxLength * 2)\n    );\n\n    if (contentType === 'html') {\n      preview = preview\n        .replace(/<[^>]*>/g, '')\n        .replace(/\\s+/g, ' ')\n        .trim();\n    } else if (contentType === 'json') {\n      try {\n        const parsed = JSON.parse(preview);\n        preview = JSON.stringify(parsed, null, 0);\n      } catch {}\n    }\n\n    preview = preview.trim();\n    if (preview.length > maxLength) {\n      preview = preview.substring(0, maxLength) + '...';\n    }\n\n    return preview || '[Binary content]';\n  }\n\n  private updateStatsAfterStore(sizeBytes: number): void {\n    this.referenceStats.activeReferences++;\n    this.referenceStats.totalStorageBytes += sizeBytes;\n    this.updateReferenceStorageStats();\n  }\n\n  private updateReferenceStorageStats(): void {\n    if (this.referenceStats.activeReferences > 0) {\n      this.referenceStats.averageContentSize =\n        this.referenceStats.totalStorageBytes /\n        this.referenceStats.activeReferences;\n    }\n\n    this.referenceStats.storageUtilization =\n      (this.referenceStats.totalStorageBytes /\n        this.referenceConfig.maxTotalStorageBytes) *\n      100;\n\n    let mostAccessedId: ReferenceId | undefined;\n    let maxAccess = 0;\n\n    for (const [referenceId, storedContent] of this.contentStore.entries()) {\n      if (storedContent.metadata.accessCount > maxAccess) {\n        maxAccess = storedContent.metadata.accessCount;\n        mostAccessedId = referenceId;\n      }\n    }\n\n    if (mostAccessedId !== undefined) {\n      this.referenceStats.mostAccessedReferenceId = mostAccessedId;\n    } else {\n      delete this.referenceStats.mostAccessedReferenceId;\n    }\n  }\n\n  /**\n   * Check if content is an image file based on MIME type or filename\n   */\n  private isImageContent(mimeType?: string, fileName?: string): boolean {\n    if (mimeType && mimeType.startsWith('image/')) {\n      return true;\n    }\n\n    if (fileName) {\n      const lowerFileName = fileName.toLowerCase();\n      const imageExtensions = [\n        '.png',\n        '.jpg',\n        '.jpeg',\n        '.gif',\n        '.bmp',\n        '.webp',\n        '.svg',\n        '.tiff',\n        '.ico',\n      ];\n      return imageExtensions.some((ext) => lowerFileName.endsWith(ext));\n    }\n\n    return false;\n  }\n\n  private recordPerformanceMetric(\n    type: 'creation' | 'resolution' | 'cleanup',\n    timeMs: number\n  ): void {\n    const metrics = this.referenceStats.performanceMetrics;\n    const maxRecords = 100;\n\n    switch (type) {\n      case 'creation':\n        metrics.creationTimes.push(timeMs);\n        if (metrics.creationTimes.length > maxRecords) {\n          metrics.creationTimes.shift();\n        }\n        break;\n      case 'resolution':\n        metrics.resolutionTimes.push(timeMs);\n        if (metrics.resolutionTimes.length > maxRecords) {\n          metrics.resolutionTimes.shift();\n        }\n        break;\n      case 'cleanup':\n        metrics.cleanupTimes.push(timeMs);\n        if (metrics.cleanupTimes.length > maxRecords) {\n          metrics.cleanupTimes.shift();\n        }\n        break;\n    }\n  }\n\n  private calculateAverage(times: number[]): number {\n    if (times.length === 0) return 0;\n    return times.reduce((sum, time) => sum + time, 0) / times.length;\n  }\n\n  private startReferenceCleanupTimer(): void {\n    this.cleanupTimer = setInterval(async () => {\n      try {\n        await this.performCleanup();\n      } catch {}\n    }, this.referenceConfig.cleanupIntervalMs);\n  }\n\n  /**\n   * Clean up resources (enhanced to include reference cleanup)\n   */\n  async dispose(): Promise<void> {\n    if (this.cleanupTimer) {\n      clearInterval(this.cleanupTimer);\n      delete this.cleanupTimer;\n    }\n\n    this.contentStore.clear();\n\n    this.clear();\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index23.js

@@ -1,327 +1,68 @@
-import { ChatOpenAI } from "@langchain/openai";
-import { Logger } from "@hashgraphonline/standards-sdk";
-import { ENTITY_PATTERNS } from "./index43.js";
-import "hedera-agent-kit";
-import "@hashgraphonline/standards-agent-kit";
-import "./index13.js";
-import "./index37.js";
-import "@langchain/core/tools";
-import "zod";
-import "./index6.js";
-import "langchain/agents";
-import "zod-to-json-schema";
-import "./index12.js";
-import "@langchain/core/prompts";
-import "@modelcontextprotocol/sdk/client/index.js";
-import "@modelcontextprotocol/sdk/client/stdio.js";
-import "./index18.js";
-import "@langchain/core/messages";
-import "./index19.js";
-import "./index20.js";
-import "./index21.js";
-import "crypto";
-import { EntityFormat } from "./index26.js";
-import "./index28.js";
-import "./index34.js";
-class EntityResolver {
-  constructor(config) {
-    this.llm = new ChatOpenAI({
-      apiKey: config.apiKey,
-      modelName: config.modelName || "gpt-4o-mini",
-      temperature: 0
-    });
-    this.logger = new Logger({ module: "EntityResolver" });
-  }
+import { createHash } from "crypto";
+class ReferenceIdGenerator {
   /**
-   * Resolve entity references using LLM instead of regex
+   * 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
    */
-  async resolveReferences(message, entities) {
-    if (!entities || entities.length === 0) {
-      return message;
-    }
-    const byType = entities.reduce((acc, e) => {
-      if (!acc[e.entityType]) acc[e.entityType] = [];
-      acc[e.entityType].push(e);
-      return acc;
-    }, {});
-    try {
-      const stats = Object.fromEntries(
-        Object.entries(byType).map(([type, list]) => [
-          type,
-          {
-            count: list.length,
-            mostRecent: list[0]?.entityId
-          }
-        ])
-      );
-      this.logger.info("resolveReferences: input summary", {
-        messagePreview: message.substring(0, 200),
-        entityStats: stats
-      });
-    } catch {
-    }
-    let context = "Available entities in memory:\n";
-    for (const [type, list] of Object.entries(byType)) {
-      const recent = list[0];
-      context += `Most recent ${type}: "${recent.entityName}" = ${recent.entityId}
-`;
-      if (list.length > 1) {
-        context += `  (${list.length - 1} other ${type}s in memory)
-`;
-      }
-    }
-    const prompt = `Task: Replace entity references with their IDs from memory. STRICT TYPE RULES:
-
-- For phrases referring to "${ENTITY_PATTERNS.TOKEN_REFERENCE}" or actions that clearly require a token (create/mint/airdrop/associate/etc.), resolve to the most recent TOKEN entity ID (never a topic or account).
-- For phrases referring to "${ENTITY_PATTERNS.TOPIC_REFERENCE}" or actions that clearly require a topic (inscribe/publish/consensus/etc.), resolve to the most recent TOPIC entity ID (never a token or account).
-- Do not infer or invent entity IDs. Only use those present in the provided context.
-
-${context}
-
-User message: "${message}"
-
-Instructions:
-- If the user says "${ENTITY_PATTERNS.TOPIC_REFERENCE}" or "that topic" → replace with the most recent topic ID
-- If the user says "${ENTITY_PATTERNS.TOKEN_REFERENCE}" or "that token" → replace with the most recent token ID (never a topic)
-- If the user says "it" or "that" after an action verb → replace with the most recent entity ID
-- Examples:
-  * "submit on ${ENTITY_PATTERNS.TOPIC_REFERENCE}" → "submit on 0.0.6543472"
-  * "airdrop ${ENTITY_PATTERNS.TOKEN_REFERENCE}" → "airdrop 0.0.123456"
-  * "send a message to it" → "send a message to 0.0.6543472"
-
-Return ONLY the message with replacements made. Do not add any explanations.
-Resolved message:`;
-    try {
-      const response = await this.llm.invoke(prompt);
-      const resolved = response.content.trim();
-      const changed = resolved !== message;
-      try {
-        this.logger.info("resolveReferences: resolution result", {
-          changed,
-          hasEntityId: /\b0\.0\.\d+\b/.test(resolved),
-          resolvedPreview: resolved.substring(0, 200)
-        });
-      } catch {
-      }
-      if (changed && resolved.includes("0.0.")) {
-        return resolved;
-      }
-      return message;
-    } catch {
-      return message;
-    }
+  static generateId(content) {
+    const hash = createHash("sha256");
+    hash.update(content);
+    return hash.digest("hex");
   }
   /**
-   * Extract entities from agent response using receipt data (preferred) or LLM fallback
+   * Validate that a string is a properly formatted reference ID
+   * 
+   * @param id The ID to validate
+   * @returns true if the ID is valid format
    */
-  async extractEntities(response, userMessage) {
-    const receiptEntities = this.extractFromReceipt(response, userMessage);
-    if (receiptEntities.length > 0) {
-      return receiptEntities;
-    }
-    return this.extractWithLLM(response, userMessage);
-  }
-  /**
-   * Extract entities from transaction receipt data (primary method)
-   */
-  extractFromReceipt(response, userMessage) {
-    const entities = [];
-    let parsedResponse;
-    try {
-      parsedResponse = typeof response === "string" ? JSON.parse(response) : response;
-    } catch {
-      parsedResponse = response;
-    }
-    if (!parsedResponse || parsedResponse.success === false) {
-      return entities;
-    }
-    const receipt = parsedResponse.receipt || parsedResponse.result?.receipt || parsedResponse.data?.receipt;
-    if (!receipt) {
-      return entities;
-    }
-    const entityName = this.extractNameFromMessage(userMessage);
-    const transactionId = parsedResponse.transactionId || parsedResponse.result?.transactionId || void 0;
-    const extractEntityId = (entityId) => {
-      if (typeof entityId === "string") {
-        return entityId;
-      }
-      if (entityId && typeof entityId === "object" && typeof entityId.toString === "function") {
-        if (entityId.toString !== Object.prototype.toString) {
-          return entityId.toString();
-        }
-      }
-      return String(entityId);
-    };
-    if (receipt.tokenId) {
-      const entity = {
-        id: extractEntityId(receipt.tokenId),
-        name: entityName,
-        type: EntityFormat.TOKEN_ID
-      };
-      if (transactionId) {
-        entity.transactionId = transactionId;
-      }
-      entities.push(entity);
-    }
-    if (receipt.topicId) {
-      const entity = {
-        id: extractEntityId(receipt.topicId),
-        name: entityName,
-        type: EntityFormat.TOPIC_ID
-      };
-      if (transactionId) {
-        entity.transactionId = transactionId;
-      }
-      entities.push(entity);
+  static isValidReferenceId(id) {
+    if (!id || typeof id !== "string") {
+      return false;
     }
-    if (receipt.accountId) {
-      const entity = {
-        id: extractEntityId(receipt.accountId),
-        name: entityName,
-        type: EntityFormat.ACCOUNT_ID
-      };
-      if (transactionId) {
-        entity.transactionId = transactionId;
-      }
-      entities.push(entity);
+    if (id.length !== 64) {
+      return false;
     }
-    if (receipt.contractId) {
-      const entity = {
-        id: extractEntityId(receipt.contractId),
-        name: entityName,
-        type: EntityFormat.CONTRACT_ID
-      };
-      if (transactionId) {
-        entity.transactionId = transactionId;
-      }
-      entities.push(entity);
-    }
-    if (receipt.fileId) {
-      const entity = {
-        id: extractEntityId(receipt.fileId),
-        name: entityName,
-        type: EntityFormat.FILE_ID
-      };
-      if (transactionId) {
-        entity.transactionId = transactionId;
-      }
-      entities.push(entity);
-    }
-    if (receipt.scheduleId) {
-      const entity = {
-        id: extractEntityId(receipt.scheduleId),
-        name: entityName,
-        type: EntityFormat.SCHEDULE_ID
-      };
-      if (transactionId) {
-        entity.transactionId = transactionId;
-      }
-      entities.push(entity);
-    }
-    return entities;
-  }
-  /**
-   * Extract entity name from user message
-   */
-  extractNameFromMessage(message) {
-    const quotedMatch = message.match(/"([^"]+)"/);
-    if (quotedMatch) return quotedMatch[1];
-    const calledMatch = message.match(/called\s+([A-Za-z0-9#\s_-]+?)(?:\s|$)/i);
-    if (calledMatch) return calledMatch[1].trim();
-    const forMatch = message.match(/for\s+([A-Za-z0-9#\s_-]+)/i);
-    if (forMatch) return forMatch[1].trim();
-    const namedMatch = message.match(
-      /(?:token|topic|account|contract)\s+([A-Za-z0-9#_-]+)/i
-    );
-    if (namedMatch) return namedMatch[1].trim();
-    if (message.includes("new account")) return "new account";
-    return "unnamed_entity";
+    return /^[a-f0-9]+$/.test(id);
   }
   /**
-   * Extract entities using LLM (fallback method)
+   * 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
    */
-  async extractWithLLM(response, userMessage) {
-    const text = typeof response === "string" ? response : JSON.stringify(response);
-    const prompt = `Analyze this agent response and extract ONLY newly created entities.
-
-User asked: "${userMessage.substring(0, 200)}"
-
-Agent response: ${text.substring(0, 3e3)}
-
-CRITICAL: Only extract Hedera entity IDs in the format 0.0.XXXXX (shard.realm.number).
-DO NOT extract:
-- Token symbols (e.g., "FOREV", "USDC", "HBAR")
-- Token names (e.g., "Forever", "My Token")
-- Transaction IDs (format: 0.0.XXX@timestamp)
-- Account aliases or mnemonics
-
-Look for:
-1. Success messages with entity IDs (e.g., "Successfully created topic 0.0.6543472")
-2. Transaction confirmations that created new entities
-3. Entity IDs that appear after words like "created", "new", "successfully"
-
-DO NOT include:
-- Token symbols or names (these are NOT entity IDs)
-- Account IDs that already existed (like sender/receiver accounts)
-- Entity IDs that were parameters to the operation
-- Failed operations
-- Anything that doesn't match the 0.0.XXXXX format
-
-Return a JSON array of newly created entities:
-[{"id": "0.0.XXX", "name": "descriptive_name", "type": "topic|token|account"}]
-
-If no entities were created, return: []
-
-JSON:`;
-    try {
-      const response2 = await this.llm.invoke(prompt);
-      const content = response2.content;
-      const match = content.match(/\[[\s\S]*?\]/);
-      if (match) {
-        const entities = JSON.parse(match[0]);
-        return entities;
-      }
-    } catch {
+  static extractReferenceId(input) {
+    if (!input || typeof input !== "string") {
+      return null;
     }
-    return [];
-  }
-  /**
-   * Validate that an entity matches the expected type
-   */
-  validateEntityType(entityId, expectedType, entities) {
-    const stored = entities.find((e) => e.entityId === entityId);
-    return !!stored && stored.entityType === expectedType;
-  }
-  /**
-   * Resolve entity references with type validation
-   */
-  async resolveWithTypeValidation(query, entities, expectedType) {
-    await this.resolveReferences(query, entities);
-    if (!expectedType) {
-      return entities;
+    const refFormatMatch = input.match(/^ref:\/\/([a-f0-9]{64})$/);
+    if (refFormatMatch) {
+      return refFormatMatch[1];
     }
-    return entities.filter((entity) => entity.entityType === expectedType);
+    return this.isValidReferenceId(input) ? input : null;
   }
   /**
-   * Get entities filtered by type
+   * Format a reference ID in the standard ref:// format
+   * 
+   * @param referenceId The reference ID to format
+   * @returns Formatted reference string
    */
-  getEntitiesByType(entities, entityType) {
-    return entities.filter((entity) => entity.entityType === entityType);
+  static formatReference(referenceId) {
+    return `ref://${referenceId}`;
   }
   /**
-   * Find the most recent entity of a specific type
+   * 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
    */
-  getMostRecentEntityByType(entities, entityType) {
-    const filtered = entities.filter(
-      (entity) => entity.entityType === entityType
-    );
-    if (filtered.length === 0) return null;
-    return filtered.reduce(
-      (most, current) => current.createdAt > most.createdAt ? current : most
-    );
+  static generateTestId(testSeed) {
+    const content = Buffer.from(`test-${testSeed}-${Date.now()}`);
+    return this.generateId(content);
   }
 }
 export {
-  EntityResolver
+  ReferenceIdGenerator
 };
 //# sourceMappingURL=index23.js.map

package/dist/esm/index23.js.map

@@ -1 +1 @@
-{"version":3,"file":"index23.js","sources":["../../src/services/entity-resolver.ts"],"sourcesContent":["import { ChatOpenAI } from '@langchain/openai';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport type { EntityAssociation } from '../memory/smart-memory-manager';\nimport { ENTITY_PATTERNS } from '../constants';\nimport { EntityFormat } from '..';\n\nexport interface EntityResolverConfig {\n  apiKey: string;\n  modelName?: string;\n}\n\ninterface EntityIdValue {\n  toString(): string;\n}\n\ninterface TransactionReceipt {\n  tokenId?: EntityIdValue | string;\n  topicId?: EntityIdValue | string;\n  accountId?: EntityIdValue | string;\n  contractId?: EntityIdValue | string;\n  fileId?: EntityIdValue | string;\n  scheduleId?: EntityIdValue | string;\n}\n\ninterface TransactionResponse {\n  success?: boolean;\n  receipt?: TransactionReceipt;\n  result?: {\n    receipt?: TransactionReceipt;\n    transactionId?: string;\n  };\n  data?: {\n    receipt?: TransactionReceipt;\n  };\n  transactionId?: string;\n}\n\ninterface ExtractedEntity {\n  id: string;\n  name: string;\n  type: EntityFormat;\n  transactionId?: string;\n}\n\n/**\n * LLM-based entity resolver that replaces brittle regex patterns\n */\nexport class EntityResolver {\n  private llm: ChatOpenAI;\n  private logger: Logger;\n\n  constructor(config: EntityResolverConfig) {\n    this.llm = new ChatOpenAI({\n      apiKey: config.apiKey,\n      modelName: config.modelName || 'gpt-4o-mini',\n      temperature: 0,\n    });\n    this.logger = new Logger({ module: 'EntityResolver' });\n  }\n\n  /**\n   * Resolve entity references using LLM instead of regex\n   */\n  async resolveReferences(\n    message: string,\n    entities: EntityAssociation[]\n  ): Promise<string> {\n    if (!entities || entities.length === 0) {\n      return message;\n    }\n\n    const byType = entities.reduce((acc, e) => {\n      if (!acc[e.entityType]) acc[e.entityType] = [];\n      acc[e.entityType].push(e);\n      return acc;\n    }, {} as Record<string, EntityAssociation[]>);\n\n    try {\n      const stats = Object.fromEntries(\n        Object.entries(byType).map(([type, list]) => [\n          type,\n          {\n            count: list.length,\n            mostRecent: list[0]?.entityId,\n          },\n        ])\n      );\n      this.logger.info('resolveReferences: input summary', {\n        messagePreview: message.substring(0, 200),\n        entityStats: stats,\n      });\n    } catch {}\n\n    let context = 'Available entities in memory:\\n';\n    for (const [type, list] of Object.entries(byType)) {\n      const recent = list[0];\n      context += `Most recent ${type}: \"${recent.entityName}\" = ${recent.entityId}\\n`;\n      if (list.length > 1) {\n        context += `  (${list.length - 1} other ${type}s in memory)\\n`;\n      }\n    }\n\n    const prompt = `Task: Replace entity references with their IDs from memory. STRICT TYPE RULES:\n\n- For phrases referring to \"${ENTITY_PATTERNS.TOKEN_REFERENCE}\" or actions that clearly require a token (create/mint/airdrop/associate/etc.), resolve to the most recent TOKEN entity ID (never a topic or account).\n- For phrases referring to \"${ENTITY_PATTERNS.TOPIC_REFERENCE}\" or actions that clearly require a topic (inscribe/publish/consensus/etc.), resolve to the most recent TOPIC entity ID (never a token or account).\n- Do not infer or invent entity IDs. Only use those present in the provided context.\n\n${context}\n\nUser message: \"${message}\"\n\nInstructions:\n- If the user says \"${ENTITY_PATTERNS.TOPIC_REFERENCE}\" or \"that topic\" → replace with the most recent topic ID\n- If the user says \"${ENTITY_PATTERNS.TOKEN_REFERENCE}\" or \"that token\" → replace with the most recent token ID (never a topic)\n- If the user says \"it\" or \"that\" after an action verb → replace with the most recent entity ID\n- Examples:\n  * \"submit on ${ENTITY_PATTERNS.TOPIC_REFERENCE}\" → \"submit on 0.0.6543472\"\n  * \"airdrop ${ENTITY_PATTERNS.TOKEN_REFERENCE}\" → \"airdrop 0.0.123456\"\n  * \"send a message to it\" → \"send a message to 0.0.6543472\"\n\nReturn ONLY the message with replacements made. Do not add any explanations.\nResolved message:`;\n\n    try {\n      const response = await this.llm.invoke(prompt);\n      const resolved = (response.content as string).trim();\n\n      const changed = resolved !== message;\n      try {\n        this.logger.info('resolveReferences: resolution result', {\n          changed,\n          hasEntityId: /\\b0\\.0\\.\\d+\\b/.test(resolved),\n          resolvedPreview: resolved.substring(0, 200),\n        });\n      } catch {}\n\n      if (changed && resolved.includes('0.0.')) {\n        return resolved;\n      }\n\n      return message;\n    } catch {\n      return message;\n    }\n  }\n\n  /**\n   * Extract entities from agent response using receipt data (preferred) or LLM fallback\n   */\n  async extractEntities(\n    response: unknown,\n    userMessage: string\n  ): Promise<ExtractedEntity[]> {\n    const receiptEntities = this.extractFromReceipt(response, userMessage);\n    if (receiptEntities.length > 0) {\n      return receiptEntities;\n    }\n\n    return this.extractWithLLM(response, userMessage);\n  }\n\n  /**\n   * Extract entities from transaction receipt data (primary method)\n   */\n  private extractFromReceipt(\n    response: unknown,\n    userMessage: string\n  ): ExtractedEntity[] {\n    const entities: ExtractedEntity[] = [];\n\n    let parsedResponse: TransactionResponse;\n    try {\n      parsedResponse =\n        typeof response === 'string'\n          ? JSON.parse(response)\n          : (response as TransactionResponse);\n    } catch {\n      parsedResponse = response as TransactionResponse;\n    }\n\n    if (!parsedResponse || parsedResponse.success === false) {\n      return entities;\n    }\n\n    const receipt =\n      parsedResponse.receipt ||\n      parsedResponse.result?.receipt ||\n      parsedResponse.data?.receipt;\n\n    if (!receipt) {\n      return entities;\n    }\n\n    const entityName = this.extractNameFromMessage(userMessage);\n\n    const transactionId =\n      parsedResponse.transactionId ||\n      parsedResponse.result?.transactionId ||\n      undefined;\n\n    const extractEntityId = (entityId: EntityIdValue | string): string => {\n      if (typeof entityId === 'string') {\n        return entityId;\n      }\n      if (\n        entityId &&\n        typeof entityId === 'object' &&\n        typeof entityId.toString === 'function'\n      ) {\n        if (entityId.toString !== Object.prototype.toString) {\n          return entityId.toString();\n        }\n      }\n      return String(entityId);\n    };\n\n    if (receipt.tokenId) {\n      const entity: ExtractedEntity = {\n        id: extractEntityId(receipt.tokenId),\n        name: entityName,\n        type: EntityFormat.TOKEN_ID,\n      };\n      if (transactionId) {\n        entity.transactionId = transactionId;\n      }\n      entities.push(entity);\n    }\n\n    if (receipt.topicId) {\n      const entity: ExtractedEntity = {\n        id: extractEntityId(receipt.topicId),\n        name: entityName,\n        type: EntityFormat.TOPIC_ID,\n      };\n      if (transactionId) {\n        entity.transactionId = transactionId;\n      }\n      entities.push(entity);\n    }\n\n    if (receipt.accountId) {\n      const entity: ExtractedEntity = {\n        id: extractEntityId(receipt.accountId),\n        name: entityName,\n        type: EntityFormat.ACCOUNT_ID,\n      };\n      if (transactionId) {\n        entity.transactionId = transactionId;\n      }\n      entities.push(entity);\n    }\n\n    if (receipt.contractId) {\n      const entity: ExtractedEntity = {\n        id: extractEntityId(receipt.contractId),\n        name: entityName,\n        type: EntityFormat.CONTRACT_ID,\n      };\n      if (transactionId) {\n        entity.transactionId = transactionId;\n      }\n      entities.push(entity);\n    }\n\n    if (receipt.fileId) {\n      const entity: ExtractedEntity = {\n        id: extractEntityId(receipt.fileId),\n        name: entityName,\n        type: EntityFormat.FILE_ID,\n      };\n      if (transactionId) {\n        entity.transactionId = transactionId;\n      }\n      entities.push(entity);\n    }\n\n    if (receipt.scheduleId) {\n      const entity: ExtractedEntity = {\n        id: extractEntityId(receipt.scheduleId),\n        name: entityName,\n        type: EntityFormat.SCHEDULE_ID,\n      };\n      if (transactionId) {\n        entity.transactionId = transactionId;\n      }\n      entities.push(entity);\n    }\n\n    return entities;\n  }\n\n  /**\n   * Extract entity name from user message\n   */\n  private extractNameFromMessage(message: string): string {\n    const quotedMatch = message.match(/\"([^\"]+)\"/);\n    if (quotedMatch) return quotedMatch[1];\n\n    const calledMatch = message.match(/called\\s+([A-Za-z0-9#\\s_-]+?)(?:\\s|$)/i);\n    if (calledMatch) return calledMatch[1].trim();\n\n    const forMatch = message.match(/for\\s+([A-Za-z0-9#\\s_-]+)/i);\n    if (forMatch) return forMatch[1].trim();\n\n    const namedMatch = message.match(\n      /(?:token|topic|account|contract)\\s+([A-Za-z0-9#_-]+)/i\n    );\n    if (namedMatch) return namedMatch[1].trim();\n\n    if (message.includes('new account')) return 'new account';\n\n    return 'unnamed_entity';\n  }\n\n  /**\n   * Extract entities using LLM (fallback method)\n   */\n  private async extractWithLLM(\n    response: unknown,\n    userMessage: string\n  ): Promise<ExtractedEntity[]> {\n    const text =\n      typeof response === 'string' ? response : JSON.stringify(response);\n\n    const prompt = `Analyze this agent response and extract ONLY newly created entities.\n\nUser asked: \"${userMessage.substring(0, 200)}\"\n\nAgent response: ${text.substring(0, 3000)}\n\nCRITICAL: Only extract Hedera entity IDs in the format 0.0.XXXXX (shard.realm.number).\nDO NOT extract:\n- Token symbols (e.g., \"FOREV\", \"USDC\", \"HBAR\")\n- Token names (e.g., \"Forever\", \"My Token\")\n- Transaction IDs (format: 0.0.XXX@timestamp)\n- Account aliases or mnemonics\n\nLook for:\n1. Success messages with entity IDs (e.g., \"Successfully created topic 0.0.6543472\")\n2. Transaction confirmations that created new entities\n3. Entity IDs that appear after words like \"created\", \"new\", \"successfully\"\n\nDO NOT include:\n- Token symbols or names (these are NOT entity IDs)\n- Account IDs that already existed (like sender/receiver accounts)\n- Entity IDs that were parameters to the operation\n- Failed operations\n- Anything that doesn't match the 0.0.XXXXX format\n\nReturn a JSON array of newly created entities:\n[{\"id\": \"0.0.XXX\", \"name\": \"descriptive_name\", \"type\": \"topic|token|account\"}]\n\nIf no entities were created, return: []\n\nJSON:`;\n\n    try {\n      const response = await this.llm.invoke(prompt);\n      const content = response.content as string;\n      const match = content.match(/\\[[\\s\\S]*?\\]/);\n      if (match) {\n        const entities = JSON.parse(match[0]);\n        return entities;\n      }\n    } catch {}\n    return [];\n  }\n\n  /**\n   * Validate that an entity matches the expected type\n   */\n  validateEntityType(\n    entityId: string,\n    expectedType: string,\n    entities: EntityAssociation[]\n  ): boolean {\n    const stored = entities.find((e) => e.entityId === entityId);\n    return !!stored && stored.entityType === expectedType;\n  }\n\n  /**\n   * Resolve entity references with type validation\n   */\n  async resolveWithTypeValidation(\n    query: string,\n    entities: EntityAssociation[],\n    expectedType?: string\n  ): Promise<EntityAssociation[]> {\n    await this.resolveReferences(query, entities);\n\n    if (!expectedType) {\n      return entities;\n    }\n\n    return entities.filter((entity) => entity.entityType === expectedType);\n  }\n\n  /**\n   * Get entities filtered by type\n   */\n  getEntitiesByType(\n    entities: EntityAssociation[],\n    entityType: string\n  ): EntityAssociation[] {\n    return entities.filter((entity) => entity.entityType === entityType);\n  }\n\n  /**\n   * Find the most recent entity of a specific type\n   */\n  getMostRecentEntityByType(\n    entities: EntityAssociation[],\n    entityType: string\n  ): EntityAssociation | null {\n    const filtered = entities.filter(\n      (entity) => entity.entityType === entityType\n    );\n    if (filtered.length === 0) return null;\n\n    return filtered.reduce((most, current) =>\n      current.createdAt > most.createdAt ? current : most\n    );\n  }\n}\n"],"names":["response"],"mappings":"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"}
+{"version":3,"file":"index23.js","sources":["../../src/memory/reference-id-generator.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('hex');\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    if (id.length !== 64) {\n      return false;\n    }\n    \n    return /^[a-f0-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    const refFormatMatch = input.match(/^ref:\\/\\/([a-f0-9]{64})$/);\n    if (refFormatMatch) {\n      return refFormatMatch[1] as ReferenceId;\n    }\n    \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,KAAK;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,IAA+B;AACvD,QAAI,CAAC,MAAM,OAAO,OAAO,UAAU;AACjC,aAAO;AAAA,IACT;AAEA,QAAI,GAAG,WAAW,IAAI;AACpB,aAAO;AAAA,IACT;AAEA,WAAO,cAAc,KAAK,EAAE;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,mBAAmB,OAAmC;AAC3D,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,aAAO;AAAA,IACT;AAEA,UAAM,iBAAiB,MAAM,MAAM,0BAA0B;AAC7D,QAAI,gBAAgB;AAClB,aAAO,eAAe,CAAC;AAAA,IACzB;AAEA,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;"}