@hashgraphonline/conversational-agent 0.1.208 → 0.1.210

package/dist/esm/index18.js.map

@@ -1 +1 @@
-{"version":3,"file":"index18.js","sources":["../../src/memory/SmartMemoryManager.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport { MemoryWindow } from './MemoryWindow';\nimport { ContentStorage } from './ContentStorage';\nimport { TokenCounter } from './TokenCounter';\n\n/**\n * Configuration for SmartMemoryManager\n */\nexport interface SmartMemoryConfig {\n  /** Maximum tokens for active memory window */\n  maxTokens?: number;\n  /** Reserve tokens for response generation */\n  reserveTokens?: number;\n  /** Model name for token counting */\n  modelName?: string;\n  /** Maximum messages to store in content storage */\n  storageLimit?: number;\n}\n\n/**\n * Search options for history search\n */\nexport interface 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 * Memory statistics for active memory window\n */\nexport interface MemoryStats {\n  /** Total active messages in memory window */\n  totalActiveMessages: number;\n  /** Current token count including system prompt */\n  currentTokenCount: number;\n  /** Maximum token capacity */\n  maxTokens: number;\n  /** Remaining token capacity */\n  remainingCapacity: number;\n  /** System prompt token count */\n  systemPromptTokens: number;\n  /** Memory usage percentage */\n  usagePercentage: number;\n}\n\n/**\n * Smart memory manager that combines active memory window with long-term storage\n * Provides context-aware memory management with automatic pruning and searchable history\n */\nexport class SmartMemoryManager {\n  private memoryWindow: MemoryWindow;\n  private contentStorage: ContentStorage;\n  private tokenCounter: TokenCounter;\n  private config: Required<SmartMemoryConfig>;\n\n  // Default configuration values\n  private static readonly DEFAULT_CONFIG: Required<SmartMemoryConfig> = {\n    maxTokens: 8000,\n    reserveTokens: 1000,\n    modelName: 'gpt-4o',\n    storageLimit: 1000\n  };\n\n  constructor(config: SmartMemoryConfig = {}) {\n    this.config = { ...SmartMemoryManager.DEFAULT_CONFIG, ...config };\n    \n    // Initialize components\n    this.tokenCounter = new TokenCounter(this.config.modelName as any);\n    this.contentStorage = new ContentStorage(this.config.storageLimit);\n    this.memoryWindow = new MemoryWindow(\n      this.config.maxTokens,\n      this.config.reserveTokens,\n      this.tokenCounter\n    );\n  }\n\n  /**\n   * Add a message to the active memory window\n   * Automatically handles pruning and storage of displaced messages\n   * @param message - Message to add\n   */\n  addMessage(message: BaseMessage): void {\n    const result = this.memoryWindow.addMessage(message);\n    \n    // Store any pruned messages in content storage\n    if (result.prunedMessages.length > 0) {\n      this.contentStorage.storeMessages(result.prunedMessages);\n    }\n  }\n\n  /**\n   * Get all active messages from the memory window\n   * @returns Array of active messages in chronological order\n   */\n  getMessages(): BaseMessage[] {\n    return this.memoryWindow.getMessages();\n  }\n\n  /**\n   * Clear active memory window\n   * @param clearStorage - Whether to also clear the content storage (default: false)\n   */\n  clear(clearStorage: boolean = false): void {\n    this.memoryWindow.clear();\n    \n    if (clearStorage) {\n      this.contentStorage.clear();\n    }\n  }\n\n  /**\n   * Set the system prompt for the memory window\n   * @param systemPrompt - System prompt text\n   */\n  setSystemPrompt(systemPrompt: string): void {\n    this.memoryWindow.setSystemPrompt(systemPrompt);\n  }\n\n  /**\n   * Get the current system prompt\n   * @returns Current system prompt text\n   */\n  getSystemPrompt(): string {\n    return this.memoryWindow.getSystemPrompt();\n  }\n\n  /**\n   * Search through stored message history\n   * @param query - Search term or pattern\n   * @param options - Search configuration\n   * @returns Array of matching messages from history\n   */\n  searchHistory(query: string, options: SearchOptions = {}): BaseMessage[] {\n    return this.contentStorage.searchMessages(query, options);\n  }\n\n  /**\n   * Get recent messages from storage history\n   * @param count - Number of recent messages to retrieve\n   * @returns Array of recent messages from storage\n   */\n  getRecentHistory(count: number): BaseMessage[] {\n    return this.contentStorage.getRecentMessages(count);\n  }\n\n  /**\n   * Check if a message can be added without exceeding limits\n   * @param message - Message to test\n   * @returns True if message can be added\n   */\n  canAddMessage(message: BaseMessage): boolean {\n    return this.memoryWindow.canAddMessage(message);\n  }\n\n  /**\n   * Get statistics about the active memory window\n   * @returns Memory usage statistics\n   */\n  getMemoryStats(): MemoryStats {\n    const windowStats = this.memoryWindow.getStats();\n    \n    return {\n      totalActiveMessages: windowStats.totalMessages,\n      currentTokenCount: windowStats.currentTokens,\n      maxTokens: windowStats.maxTokens,\n      remainingCapacity: windowStats.remainingCapacity,\n      systemPromptTokens: windowStats.systemPromptTokens,\n      usagePercentage: windowStats.usagePercentage\n    };\n  }\n\n  /**\n   * Get statistics about the content storage\n   * @returns Storage usage statistics\n   */\n  getStorageStats() {\n    return this.contentStorage.getStorageStats();\n  }\n\n  /**\n   * Get combined statistics for both active memory and storage\n   * @returns Combined memory and storage statistics\n   */\n  getOverallStats() {\n    const memoryStats = this.getMemoryStats();\n    const storageStats = this.getStorageStats();\n    \n    return {\n      activeMemory: memoryStats,\n      storage: storageStats,\n      totalMessagesManaged: memoryStats.totalActiveMessages + storageStats.totalMessages,\n      activeMemoryUtilization: memoryStats.usagePercentage,\n      storageUtilization: storageStats.usagePercentage\n    };\n  }\n\n  /**\n   * Update the configuration and apply changes\n   * @param newConfig - New configuration options\n   */\n  updateConfig(newConfig: Partial<SmartMemoryConfig>): void {\n    this.config = { ...this.config, ...newConfig };\n    \n    // Update components with new configuration\n    if (newConfig.maxTokens !== undefined || newConfig.reserveTokens !== undefined) {\n      this.memoryWindow.updateLimits(\n        this.config.maxTokens,\n        this.config.reserveTokens\n      );\n    }\n    \n    if (newConfig.storageLimit !== undefined) {\n      this.contentStorage.updateStorageLimit(this.config.storageLimit);\n    }\n    \n    // Note: Model name changes would require recreating the token counter\n    // This is not implemented to avoid disrupting ongoing operations\n  }\n\n  /**\n   * Get current configuration\n   * @returns Current configuration settings\n   */\n  getConfig(): Required<SmartMemoryConfig> {\n    return { ...this.config };\n  }\n\n  /**\n   * Get messages from storage within a time range\n   * @param startTime - Start of time range\n   * @param endTime - End of time range\n   * @returns Messages within the specified time range\n   */\n  getHistoryFromTimeRange(startTime: Date, endTime: Date): BaseMessage[] {\n    return this.contentStorage.getMessagesFromTimeRange(startTime, endTime);\n  }\n\n  /**\n   * Get messages from storage 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 Messages of the specified type\n   */\n  getHistoryByType(messageType: string, limit?: number): BaseMessage[] {\n    return this.contentStorage.getMessagesByType(messageType, limit);\n  }\n\n  /**\n   * Get recent messages from storage within the last N minutes\n   * @param minutes - Number of minutes to look back\n   * @returns Messages from the last N minutes\n   */\n  getRecentHistoryByTime(minutes: number): BaseMessage[] {\n    return this.contentStorage.getRecentMessagesByTime(minutes);\n  }\n\n  /**\n   * Export the current state for persistence or analysis\n   * @returns Serializable representation of memory state\n   */\n  exportState() {\n    return {\n      config: this.config,\n      activeMessages: this.memoryWindow.getMessages().map(msg => ({\n        content: msg.content,\n        type: msg._getType()\n      })),\n      systemPrompt: this.memoryWindow.getSystemPrompt(),\n      memoryStats: this.getMemoryStats(),\n      storageStats: this.getStorageStats(),\n      storedMessages: this.contentStorage.exportMessages()\n    };\n  }\n\n  /**\n   * Get a summary of conversation context for external use\n   * Useful for providing context to other systems or for logging\n   * @param includeStoredContext - Whether to include recent stored messages\n   * @returns Context summary object\n   */\n  getContextSummary(includeStoredContext: boolean = false) {\n    const activeMessages = this.getMessages();\n    const summary = {\n      activeMessageCount: activeMessages.length,\n      systemPrompt: this.getSystemPrompt(),\n      recentMessages: activeMessages.slice(-5), // Last 5 active messages\n      memoryUtilization: this.getMemoryStats().usagePercentage,\n      hasStoredHistory: this.getStorageStats().totalMessages > 0\n    };\n\n    if (includeStoredContext) {\n      return {\n        ...summary,\n        recentStoredMessages: this.getRecentHistory(10), // Last 10 stored messages\n        storageStats: this.getStorageStats()\n      };\n    }\n\n    return summary;\n  }\n\n  /**\n   * Perform maintenance operations\n   * Optimizes storage and cleans up resources\n   */\n  performMaintenance(): void {\n    // No specific maintenance needed currently\n    // This method is reserved for future optimizations\n  }\n\n  /**\n   * Clean up resources and dispose of components\n   */\n  dispose(): void {\n    this.memoryWindow.dispose();\n    this.contentStorage.dispose();\n    this.tokenCounter.dispose();\n  }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"index18.js","sources":["../../src/plugins/hbar/TransferHbarTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { HbarTransferParams } from './types';\nimport { AccountBuilder } from './AccountBuilder';\nimport { BaseHederaTransactionTool, BaseServiceBuilder } from 'hedera-agent-kit';\n\nconst HbarTransferInputSchema = z.object({\n  accountId: z\n    .string()\n    .describe('Account ID for the transfer (e.g., \"0.0.xxxx\").'),\n  amount: z\n    .union([z.number(), z.string()])\n    .describe(\n      'HBAR amount in decimal format (e.g., 1 for 1 HBAR, 0.5 for 0.5 HBAR). Positive for credit, negative for debit. DO NOT multiply by 10^8 for tinybars - just use the HBAR amount directly.'\n    ),\n});\n\nconst TransferHbarZodSchemaCore = z.object({\n  transfers: z\n    .array(HbarTransferInputSchema)\n    .min(1)\n    .describe(\n      'Array of transfers. For simple transfers from your operator account, just include the recipient with positive amount: [{accountId: \"0.0.800\", amount: 1}]. For complex multi-party transfers, include all parties with negative amounts for senders and positive for receivers.'\n    ),\n  memo: z.string().optional().describe('Optional. Memo for the transaction.'),\n});\n\n/**\n * A Hedera transaction tool for transferring HBAR between accounts.\n * Supports single and multi-party transfers with automatic balance validation.\n * Extends BaseHederaTransactionTool to handle HBAR transfer transactions on the Hedera Hashgraph.\n */\nexport class TransferHbarTool extends BaseHederaTransactionTool<\n  typeof TransferHbarZodSchemaCore\n> {\n  name = 'hedera-account-transfer-hbar-v2';\n  description =\n    'PRIMARY TOOL FOR HBAR TRANSFERS: Transfers HBAR between accounts. For simple transfers from the operator account, just specify the recipient with a positive amount (e.g., [{accountId: \"0.0.800\", amount: 1}] to send 1 HBAR to 0.0.800). The sender will be automatically added. For multi-party transfers (e.g., \"A sends 5 HBAR to C and B sends 3 HBAR to C\"), include ALL transfers with their amounts (negative for senders, positive for receivers).';\n  specificInputSchema = TransferHbarZodSchemaCore;\n  namespace = 'account';\n\n\n  /**\n   * Creates and returns the service builder for account operations.\n   * \n   * @returns BaseServiceBuilder instance configured for account operations\n   */\n  protected getServiceBuilder(): BaseServiceBuilder {\n    return new AccountBuilder(this.hederaKit) as BaseServiceBuilder;\n  }\n\n  /**\n   * Executes the HBAR transfer using the provided builder and arguments.\n   * Validates that all transfers sum to zero before execution.\n   * \n   * @param builder - The service builder instance for executing transactions\n   * @param specificArgs - The validated transfer parameters including transfers array and optional memo\n   * @returns Promise that resolves when the transfer is complete\n   */\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof TransferHbarZodSchemaCore>\n  ): Promise<void> {\n    await (builder as AccountBuilder).transferHbar(\n      specificArgs as unknown as HbarTransferParams\n    );\n  }\n}"],"names":[],"mappings":";;;AAKA,MAAM,0BAA0B,EAAE,OAAO;AAAA,EACvC,WAAW,EACR,SACA,SAAS,iDAAiD;AAAA,EAC7D,QAAQ,EACL,MAAM,CAAC,EAAE,OAAA,GAAU,EAAE,QAAQ,CAAC,EAC9B;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAED,MAAM,4BAA4B,EAAE,OAAO;AAAA,EACzC,WAAW,EACR,MAAM,uBAAuB,EAC7B,IAAI,CAAC,EACL;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,MAAM,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,qCAAqC;AAC5E,CAAC;AAOM,MAAM,yBAAyB,0BAEpC;AAAA,EAFK,cAAA;AAAA,UAAA,GAAA,SAAA;AAGL,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AACtB,SAAA,YAAY;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQF,oBAAwC;AAChD,WAAO,IAAI,eAAe,KAAK,SAAS;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAgB,kBACd,SACA,cACe;AACf,UAAO,QAA2B;AAAA,MAChC;AAAA,IAAA;AAAA,EAEJ;AACF;"}