@hashgraphonline/conversational-agent 0.1.207 → 0.1.209

package/dist/esm/index22.js

@@ -1,182 +1,68 @@
-import { TokenCounter } from "./index23.js";
-const _MemoryWindow = class _MemoryWindow {
-  // Remove messages in pairs to maintain conversation flow
-  constructor(maxTokens = _MemoryWindow.DEFAULT_MAX_TOKENS, reserveTokens = _MemoryWindow.DEFAULT_RESERVE_TOKENS, tokenCounter) {
-    this.messages = [];
-    this.systemPrompt = "";
-    this.systemPromptTokens = 0;
-    if (reserveTokens >= maxTokens) {
-      throw new Error("Reserve tokens must be less than max tokens");
-    }
-    this.maxTokens = maxTokens;
-    this.reserveTokens = reserveTokens;
-    this.tokenCounter = tokenCounter || new TokenCounter();
-  }
+import { createHash } from "crypto";
+class ReferenceIdGenerator {
   /**
-   * Add a message to the memory window, pruning old messages if necessary
-   * @param message - The message to add
-   * @returns Result of the add operation including any pruned messages
+   * 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
    */
-  addMessage(message) {
-    this.tokenCounter.countMessageTokens(message);
-    this.messages.push(message);
-    const currentTokens = this.getCurrentTokenCount();
-    const availableTokens = this.maxTokens - this.reserveTokens;
-    let prunedMessages = [];
-    if (currentTokens > availableTokens) {
-      this.messages.pop();
-      prunedMessages = this.pruneToFit();
-      this.messages.push(message);
-    }
-    return {
-      added: true,
-      prunedMessages,
-      currentTokenCount: this.getCurrentTokenCount(),
-      remainingCapacity: this.getRemainingTokenCapacity()
-    };
+  static generateId(content) {
+    const hash = createHash("sha256");
+    hash.update(content);
+    return hash.digest("base64url");
   }
   /**
-   * Prune old messages to fit within token limits
-   * Removes messages in pairs to maintain conversational flow
-   * @returns Array of pruned messages
+   * Validate that a string is a properly formatted reference ID
+   * 
+   * @param id The ID to validate
+   * @returns true if the ID is valid format
    */
-  pruneToFit() {
-    const prunedMessages = [];
-    const targetTokens = this.maxTokens - this.reserveTokens;
-    while (this.getCurrentTokenCount() > targetTokens && this.messages.length > 0) {
-      const batchSize = Math.min(_MemoryWindow.PRUNING_BATCH_SIZE, this.messages.length);
-      for (let i = 0; i < batchSize; i++) {
-        const prunedMessage = this.messages.shift();
-        if (prunedMessage) {
-          prunedMessages.push(prunedMessage);
-        }
-      }
-      if (prunedMessages.length > 1e3) {
-        console.warn("MemoryWindow: Excessive pruning detected, stopping to prevent infinite loop");
-        break;
-      }
+  static isValidReferenceId(id) {
+    if (!id || typeof id !== "string") {
+      return false;
     }
-    return prunedMessages;
-  }
-  /**
-   * Get current token count including system prompt and messages
-   * @returns Current token count
-   */
-  getCurrentTokenCount() {
-    const messageTokens = this.tokenCounter.countMessagesTokens(this.messages);
-    return this.systemPromptTokens + messageTokens;
-  }
-  /**
-   * Get remaining token capacity before hitting the reserve limit
-   * @returns Remaining tokens that can be used
-   */
-  getRemainingTokenCapacity() {
-    return Math.max(0, this.maxTokens - this.getCurrentTokenCount());
-  }
-  /**
-   * Check if a message can be added without exceeding limits
-   * @param message - The message to check
-   * @returns True if message can be added within reserve limits
-   */
-  canAddMessage(message) {
-    const messageTokens = this.tokenCounter.countMessageTokens(message);
-    const currentTokens = this.getCurrentTokenCount();
-    const wouldExceedReserve = currentTokens + messageTokens > this.maxTokens - this.reserveTokens;
-    if (messageTokens > this.maxTokens) {
+    if (id.length !== 43) {
       return false;
     }
-    return !wouldExceedReserve || this.messages.length > 0;
-  }
-  /**
-   * Get all messages in the memory window
-   * @returns Copy of current messages array
-   */
-  getMessages() {
-    return [...this.messages];
-  }
-  /**
-   * Clear all messages from the memory window
-   */
-  clear() {
-    this.messages = [];
+    return /^[A-Za-z0-9_-]+$/.test(id);
   }
   /**
-   * Set the system prompt and update token calculations
-   * @param systemPrompt - The system prompt text
+   * 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
    */
-  setSystemPrompt(systemPrompt) {
-    this.systemPrompt = systemPrompt;
-    this.systemPromptTokens = this.tokenCounter.estimateSystemPromptTokens(systemPrompt);
-  }
-  /**
-   * Get the current system prompt
-   * @returns Current system prompt
-   */
-  getSystemPrompt() {
-    return this.systemPrompt;
-  }
-  /**
-   * Get current configuration
-   * @returns Memory window configuration
-   */
-  getConfig() {
-    return {
-      maxTokens: this.maxTokens,
-      reserveTokens: this.reserveTokens,
-      currentTokens: this.getCurrentTokenCount(),
-      messageCount: this.messages.length,
-      systemPromptTokens: this.systemPromptTokens
-    };
-  }
-  /**
-   * Update token limits
-   * @param maxTokens - New maximum token limit
-   * @param reserveTokens - New reserve token amount
-   */
-  updateLimits(maxTokens, reserveTokens) {
-    if (reserveTokens !== void 0 && reserveTokens >= maxTokens) {
-      throw new Error("Reserve tokens must be less than max tokens");
-    }
-    this.maxTokens = maxTokens;
-    if (reserveTokens !== void 0) {
-      this.reserveTokens = reserveTokens;
+  static extractReferenceId(input) {
+    if (!input || typeof input !== "string") {
+      return null;
     }
-    if (this.getCurrentTokenCount() > this.maxTokens - this.reserveTokens) {
-      this.pruneToFit();
+    const refFormatMatch = input.match(/^ref:\/\/([A-Za-z0-9_-]{43})$/);
+    if (refFormatMatch) {
+      return refFormatMatch[1];
     }
+    return this.isValidReferenceId(input) ? input : null;
   }
   /**
-   * Get statistics about the memory window
-   * @returns Memory usage statistics
+   * Format a reference ID in the standard ref:// format
+   * 
+   * @param referenceId The reference ID to format
+   * @returns Formatted reference string
    */
-  getStats() {
-    const currentTokens = this.getCurrentTokenCount();
-    const capacity = this.maxTokens;
-    const usagePercentage = currentTokens / capacity * 100;
-    return {
-      totalMessages: this.messages.length,
-      currentTokens,
-      maxTokens: capacity,
-      reserveTokens: this.reserveTokens,
-      systemPromptTokens: this.systemPromptTokens,
-      usagePercentage: Math.round(usagePercentage * 100) / 100,
-      remainingCapacity: this.getRemainingTokenCapacity(),
-      canAcceptMore: this.getRemainingTokenCapacity() > this.reserveTokens
-    };
+  static formatReference(referenceId) {
+    return `ref://${referenceId}`;
   }
   /**
-   * Clean up resources
+   * 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
    */
-  dispose() {
-    this.clear();
-    this.tokenCounter.dispose();
+  static generateTestId(testSeed) {
+    const content = Buffer.from(`test-${testSeed}-${Date.now()}`);
+    return this.generateId(content);
   }
-};
-_MemoryWindow.DEFAULT_MAX_TOKENS = 8e3;
-_MemoryWindow.DEFAULT_RESERVE_TOKENS = 1e3;
-_MemoryWindow.PRUNING_BATCH_SIZE = 2;
-let MemoryWindow = _MemoryWindow;
+}
 export {
-  MemoryWindow
+  ReferenceIdGenerator
 };
 //# sourceMappingURL=index22.js.map

package/dist/esm/index22.js.map

@@ -1 +1 @@
-{"version":3,"file":"index22.js","sources":["../../src/memory/MemoryWindow.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport { TokenCounter } from './TokenCounter';\n\n/**\n * Result of adding a message to the memory window\n */\nexport interface AddMessageResult {\n  /** Whether the message was successfully added */\n  added: boolean;\n  /** Messages that were pruned to make room */\n  prunedMessages: BaseMessage[];\n  /** Current token count after operation */\n  currentTokenCount: number;\n  /** Remaining token capacity */\n  remainingCapacity: number;\n}\n\n/**\n * Memory window that manages conversation history with token-based size limits\n * Automatically prunes old messages to stay within token limits while preserving conversational context\n */\nexport class MemoryWindow {\n  private messages: BaseMessage[] = [];\n  private maxTokens: number;\n  private reserveTokens: number;\n  private tokenCounter: TokenCounter;\n  private systemPrompt: string = '';\n  private systemPromptTokens: number = 0;\n\n  // Default token limits for different model contexts\n  public static readonly DEFAULT_MAX_TOKENS = 8000; // Conservative limit for most models\n  public static readonly DEFAULT_RESERVE_TOKENS = 1000; // Reserve for response generation\n  public static readonly PRUNING_BATCH_SIZE = 2; // Remove messages in pairs to maintain conversation flow\n\n  constructor(\n    maxTokens: number = MemoryWindow.DEFAULT_MAX_TOKENS,\n    reserveTokens: number = MemoryWindow.DEFAULT_RESERVE_TOKENS,\n    tokenCounter?: TokenCounter\n  ) {\n    if (reserveTokens >= maxTokens) {\n      throw new Error('Reserve tokens must be less than max tokens');\n    }\n\n    this.maxTokens = maxTokens;\n    this.reserveTokens = reserveTokens;\n    this.tokenCounter = tokenCounter || new TokenCounter();\n  }\n\n  /**\n   * Add a message to the memory window, pruning old messages if necessary\n   * @param message - The message to add\n   * @returns Result of the add operation including any pruned messages\n   */\n  addMessage(message: BaseMessage): AddMessageResult {\n    // Calculate tokens for the new message\n    const messageTokens = this.tokenCounter.countMessageTokens(message);\n    \n    // Add the message first\n    this.messages.push(message);\n    \n    // Check if we need to prune\n    const currentTokens = this.getCurrentTokenCount();\n    const availableTokens = this.maxTokens - this.reserveTokens;\n    \n    let prunedMessages: BaseMessage[] = [];\n    \n    if (currentTokens > availableTokens) {\n      // Need to prune - remove the new message temporarily\n      this.messages.pop();\n      \n      // Prune old messages to make room\n      prunedMessages = this.pruneToFit();\n      \n      // Add the new message back\n      this.messages.push(message);\n    }\n\n    return {\n      added: true,\n      prunedMessages,\n      currentTokenCount: this.getCurrentTokenCount(),\n      remainingCapacity: this.getRemainingTokenCapacity()\n    };\n  }\n\n  /**\n   * Prune old messages to fit within token limits\n   * Removes messages in pairs to maintain conversational flow\n   * @returns Array of pruned messages\n   */\n  pruneToFit(): BaseMessage[] {\n    const prunedMessages: BaseMessage[] = [];\n    const targetTokens = this.maxTokens - this.reserveTokens;\n    \n    while (this.getCurrentTokenCount() > targetTokens && this.messages.length > 0) {\n      // Remove messages in batches to maintain conversation flow\n      const batchSize = Math.min(MemoryWindow.PRUNING_BATCH_SIZE, this.messages.length);\n      \n      for (let i = 0; i < batchSize; i++) {\n        const prunedMessage = this.messages.shift();\n        if (prunedMessage) {\n          prunedMessages.push(prunedMessage);\n        }\n      }\n      \n      // Safety check to prevent infinite loop\n      if (prunedMessages.length > 1000) {\n        console.warn('MemoryWindow: Excessive pruning detected, stopping to prevent infinite loop');\n        break;\n      }\n    }\n\n    return prunedMessages;\n  }\n\n  /**\n   * Get current token count including system prompt and messages\n   * @returns Current token count\n   */\n  getCurrentTokenCount(): number {\n    const messageTokens = this.tokenCounter.countMessagesTokens(this.messages);\n    return this.systemPromptTokens + messageTokens;\n  }\n\n  /**\n   * Get remaining token capacity before hitting the reserve limit\n   * @returns Remaining tokens that can be used\n   */\n  getRemainingTokenCapacity(): number {\n    return Math.max(0, this.maxTokens - this.getCurrentTokenCount());\n  }\n\n  /**\n   * Check if a message can be added without exceeding limits\n   * @param message - The message to check\n   * @returns True if message can be added within reserve limits\n   */\n  canAddMessage(message: BaseMessage): boolean {\n    const messageTokens = this.tokenCounter.countMessageTokens(message);\n    const currentTokens = this.getCurrentTokenCount();\n    const wouldExceedReserve = (currentTokens + messageTokens) > (this.maxTokens - this.reserveTokens);\n    \n    // Always allow adding if we can prune to make room\n    // Only return false if the message itself is larger than our total capacity\n    if (messageTokens > this.maxTokens) {\n      return false;\n    }\n    \n    return !wouldExceedReserve || this.messages.length > 0;\n  }\n\n  /**\n   * Get all messages in the memory window\n   * @returns Copy of current messages array\n   */\n  getMessages(): BaseMessage[] {\n    return [...this.messages];\n  }\n\n  /**\n   * Clear all messages from the memory window\n   */\n  clear(): void {\n    this.messages = [];\n  }\n\n  /**\n   * Set the system prompt and update token calculations\n   * @param systemPrompt - The system prompt text\n   */\n  setSystemPrompt(systemPrompt: string): void {\n    this.systemPrompt = systemPrompt;\n    this.systemPromptTokens = this.tokenCounter.estimateSystemPromptTokens(systemPrompt);\n  }\n\n  /**\n   * Get the current system prompt\n   * @returns Current system prompt\n   */\n  getSystemPrompt(): string {\n    return this.systemPrompt;\n  }\n\n  /**\n   * Get current configuration\n   * @returns Memory window configuration\n   */\n  getConfig() {\n    return {\n      maxTokens: this.maxTokens,\n      reserveTokens: this.reserveTokens,\n      currentTokens: this.getCurrentTokenCount(),\n      messageCount: this.messages.length,\n      systemPromptTokens: this.systemPromptTokens\n    };\n  }\n\n  /**\n   * Update token limits\n   * @param maxTokens - New maximum token limit\n   * @param reserveTokens - New reserve token amount\n   */\n  updateLimits(maxTokens: number, reserveTokens?: number): void {\n    if (reserveTokens !== undefined && reserveTokens >= maxTokens) {\n      throw new Error('Reserve tokens must be less than max tokens');\n    }\n\n    this.maxTokens = maxTokens;\n    if (reserveTokens !== undefined) {\n      this.reserveTokens = reserveTokens;\n    }\n\n    // Prune if necessary after updating limits\n    if (this.getCurrentTokenCount() > (this.maxTokens - this.reserveTokens)) {\n      this.pruneToFit();\n    }\n  }\n\n  /**\n   * Get statistics about the memory window\n   * @returns Memory usage statistics\n   */\n  getStats() {\n    const currentTokens = this.getCurrentTokenCount();\n    const capacity = this.maxTokens;\n    const usagePercentage = (currentTokens / capacity) * 100;\n    \n    return {\n      totalMessages: this.messages.length,\n      currentTokens,\n      maxTokens: capacity,\n      reserveTokens: this.reserveTokens,\n      systemPromptTokens: this.systemPromptTokens,\n      usagePercentage: Math.round(usagePercentage * 100) / 100,\n      remainingCapacity: this.getRemainingTokenCapacity(),\n      canAcceptMore: this.getRemainingTokenCapacity() > this.reserveTokens\n    };\n  }\n\n  /**\n   * Clean up resources\n   */\n  dispose(): void {\n    this.clear();\n    this.tokenCounter.dispose();\n  }\n}"],"names":[],"mappings":"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"}
+{"version":3,"file":"index22.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    if (id.length !== 43) {\n      return false;\n    }\n    \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    const refFormatMatch = input.match(/^ref:\\/\\/([A-Za-z0-9_-]{43})$/);\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,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;AAEA,QAAI,GAAG,WAAW,IAAI;AACpB,aAAO;AAAA,IACT;AAEA,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;AAEA,UAAM,iBAAiB,MAAM,MAAM,+BAA+B;AAClE,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;"}

package/dist/esm/index23.js

@@ -1,126 +1,30 @@
-import { encoding_for_model } from "tiktoken";
-const _TokenCounter = class _TokenCounter {
-  // Additional token for role specification
-  constructor(modelName = "gpt-4o") {
-    this.modelName = modelName;
-    try {
-      this.encoding = encoding_for_model(modelName);
-    } catch (error) {
-      console.warn(`Model ${modelName} not found, falling back to gpt-4o encoding`);
-      this.encoding = encoding_for_model("gpt-4o");
-      this.modelName = "gpt-4o";
-    }
-  }
-  /**
-   * Count tokens in raw text content
-   * @param text - The text to count tokens for
-   * @returns Number of tokens
-   */
-  countTokens(text) {
-    if (!text || text.trim() === "") {
-      return 0;
-    }
-    try {
-      const tokens = this.encoding.encode(text);
-      return tokens.length;
-    } catch (error) {
-      console.warn("Error counting tokens, falling back to word-based estimation:", error);
-      return Math.ceil(text.split(/\s+/).length * 1.3);
-    }
-  }
-  /**
-   * Count tokens for a single chat message including role overhead
-   * @param message - The message to count tokens for
-   * @returns Number of tokens including message formatting overhead
-   */
-  countMessageTokens(message) {
-    const contentTokens = this.countTokens(message.content);
-    const roleTokens = this.countTokens(this.getMessageRole(message));
-    return contentTokens + roleTokens + _TokenCounter.MESSAGE_OVERHEAD + _TokenCounter.ROLE_OVERHEAD;
-  }
-  /**
-   * Count tokens for multiple messages
-   * @param messages - Array of messages to count
-   * @returns Total token count for all messages
-   */
-  countMessagesTokens(messages) {
-    if (!messages || messages.length === 0) {
-      return 0;
-    }
-    return messages.reduce((total, message) => {
-      return total + this.countMessageTokens(message);
-    }, 0);
-  }
-  /**
-   * Estimate tokens for system prompt
-   * System prompts have slightly different overhead in chat completions
-   * @param systemPrompt - The system prompt text
-   * @returns Estimated token count
-   */
-  estimateSystemPromptTokens(systemPrompt) {
-    if (!systemPrompt || systemPrompt.trim() === "") {
-      return 0;
-    }
-    const contentTokens = this.countTokens(systemPrompt);
-    const roleTokens = this.countTokens("system");
-    return contentTokens + roleTokens + _TokenCounter.MESSAGE_OVERHEAD + _TokenCounter.ROLE_OVERHEAD;
-  }
-  /**
-   * Get total context size estimate including system prompt and messages
-   * @param systemPrompt - System prompt text
-   * @param messages - Conversation messages
-   * @returns Total estimated token count
-   */
-  estimateContextSize(systemPrompt, messages) {
-    const systemTokens = this.estimateSystemPromptTokens(systemPrompt);
-    const messageTokens = this.countMessagesTokens(messages);
-    const completionOverhead = 10;
-    return systemTokens + messageTokens + completionOverhead;
-  }
-  /**
-   * Get the role string for a message
-   * @param message - The message to get the role for
-   * @returns Role string ('user', 'assistant', 'system', etc.)
-   */
-  getMessageRole(message) {
-    const messageType = message._getType();
-    switch (messageType) {
-      case "human":
-        return "user";
-      case "ai":
-        return "assistant";
-      case "system":
-        return "system";
-      case "function":
-        return "function";
-      case "tool":
-        return "tool";
-      default:
-        return "user";
-    }
-  }
-  /**
-   * Get the model name being used for token counting
-   * @returns The tiktoken model name
-   */
-  getModelName() {
-    return this.modelName;
-  }
-  /**
-   * Clean up encoding resources
-   */
-  dispose() {
-    try {
-      this.encoding.free();
-    } catch (error) {
-      console.warn("Error disposing encoding:", error);
-    }
+const DEFAULT_CONTENT_REFERENCE_CONFIG = {
+  sizeThresholdBytes: 10 * 1024,
+  maxAgeMs: 60 * 60 * 1e3,
+  maxReferences: 100,
+  maxTotalStorageBytes: 100 * 1024 * 1024,
+  enableAutoCleanup: true,
+  cleanupIntervalMs: 5 * 60 * 1e3,
+  enablePersistence: false,
+  storageBackend: "memory",
+  cleanupPolicies: {
+    recent: { maxAgeMs: 30 * 60 * 1e3, priority: 1 },
+    userContent: { maxAgeMs: 2 * 60 * 60 * 1e3, priority: 2 },
+    agentGenerated: { maxAgeMs: 60 * 60 * 1e3, priority: 3 },
+    default: { maxAgeMs: 60 * 60 * 1e3, priority: 4 }
   }
 };
-_TokenCounter.MESSAGE_OVERHEAD = 3;
-_TokenCounter.ROLE_OVERHEAD = 1;
-let TokenCounter = _TokenCounter;
+class ContentReferenceError extends Error {
+  constructor(message, type, referenceId, suggestedActions) {
+    super(message);
+    this.type = type;
+    this.referenceId = referenceId;
+    this.suggestedActions = suggestedActions;
+    this.name = "ContentReferenceError";
+  }
+}
 export {
-  TokenCounter
+  ContentReferenceError,
+  DEFAULT_CONTENT_REFERENCE_CONFIG
 };
 //# sourceMappingURL=index23.js.map

package/dist/esm/index23.js.map

@@ -1 +1 @@
-{"version":3,"file":"index23.js","sources":["../../src/memory/TokenCounter.ts"],"sourcesContent":["import { encoding_for_model } from 'tiktoken';\nimport type { TiktokenModel } from 'tiktoken';\nimport type { BaseMessage } from '@langchain/core/messages';\n\n/**\n * Token counter utility for OpenAI models using tiktoken encoding\n * Provides accurate token counting for text content and chat messages\n */\nexport class TokenCounter {\n  private encoding: ReturnType<typeof encoding_for_model>;\n  private modelName: TiktokenModel;\n\n  // Token overhead per message for chat completion format\n  private static readonly MESSAGE_OVERHEAD = 3; // <|start|>role<|end|>content<|end|>\n  private static readonly ROLE_OVERHEAD = 1; // Additional token for role specification\n\n  constructor(modelName: TiktokenModel = 'gpt-4o') {\n    this.modelName = modelName;\n    try {\n      this.encoding = encoding_for_model(modelName);\n    } catch (error) {\n      // Fallback to gpt-4o if specific model encoding is not available\n      console.warn(`Model ${modelName} not found, falling back to gpt-4o encoding`);\n      this.encoding = encoding_for_model('gpt-4o');\n      this.modelName = 'gpt-4o';\n    }\n  }\n\n  /**\n   * Count tokens in raw text content\n   * @param text - The text to count tokens for\n   * @returns Number of tokens\n   */\n  countTokens(text: string): number {\n    if (!text || text.trim() === '') {\n      return 0;\n    }\n\n    try {\n      const tokens = this.encoding.encode(text);\n      return tokens.length;\n    } catch (error) {\n      console.warn('Error counting tokens, falling back to word-based estimation:', error);\n      // Fallback: rough estimation based on words (typically 1.3 tokens per word)\n      return Math.ceil(text.split(/\\s+/).length * 1.3);\n    }\n  }\n\n  /**\n   * Count tokens for a single chat message including role overhead\n   * @param message - The message to count tokens for\n   * @returns Number of tokens including message formatting overhead\n   */\n  countMessageTokens(message: BaseMessage): number {\n    const contentTokens = this.countTokens(message.content as string);\n    const roleTokens = this.countTokens(this.getMessageRole(message));\n    \n    // Add overhead for message structure and role\n    return contentTokens + roleTokens + TokenCounter.MESSAGE_OVERHEAD + TokenCounter.ROLE_OVERHEAD;\n  }\n\n  /**\n   * Count tokens for multiple messages\n   * @param messages - Array of messages to count\n   * @returns Total token count for all messages\n   */\n  countMessagesTokens(messages: BaseMessage[]): number {\n    if (!messages || messages.length === 0) {\n      return 0;\n    }\n\n    return messages.reduce((total, message) => {\n      return total + this.countMessageTokens(message);\n    }, 0);\n  }\n\n  /**\n   * Estimate tokens for system prompt\n   * System prompts have slightly different overhead in chat completions\n   * @param systemPrompt - The system prompt text\n   * @returns Estimated token count\n   */\n  estimateSystemPromptTokens(systemPrompt: string): number {\n    if (!systemPrompt || systemPrompt.trim() === '') {\n      return 0;\n    }\n\n    const contentTokens = this.countTokens(systemPrompt);\n    const roleTokens = this.countTokens('system');\n    \n    // System messages have similar overhead to regular messages\n    return contentTokens + roleTokens + TokenCounter.MESSAGE_OVERHEAD + TokenCounter.ROLE_OVERHEAD;\n  }\n\n  /**\n   * Get total context size estimate including system prompt and messages\n   * @param systemPrompt - System prompt text\n   * @param messages - Conversation messages\n   * @returns Total estimated token count\n   */\n  estimateContextSize(systemPrompt: string, messages: BaseMessage[]): number {\n    const systemTokens = this.estimateSystemPromptTokens(systemPrompt);\n    const messageTokens = this.countMessagesTokens(messages);\n    \n    // Add a small buffer for chat completion overhead\n    const completionOverhead = 10;\n    \n    return systemTokens + messageTokens + completionOverhead;\n  }\n\n  /**\n   * Get the role string for a message\n   * @param message - The message to get the role for\n   * @returns Role string ('user', 'assistant', 'system', etc.)\n   */\n  private getMessageRole(message: BaseMessage): string {\n    const messageType = message._getType();\n    switch (messageType) {\n      case 'human':\n        return 'user';\n      case 'ai':\n        return 'assistant';\n      case 'system':\n        return 'system';\n      case 'function':\n        return 'function';\n      case 'tool':\n        return 'tool';\n      default:\n        return 'user'; // Default fallback\n    }\n  }\n\n  /**\n   * Get the model name being used for token counting\n   * @returns The tiktoken model name\n   */\n  getModelName(): string {\n    return this.modelName;\n  }\n\n  /**\n   * Clean up encoding resources\n   */\n  dispose(): void {\n    try {\n      this.encoding.free();\n    } catch (error) {\n      console.warn('Error disposing encoding:', error);\n    }\n  }\n}"],"names":[],"mappings":";AAQO,MAAM,gBAAN,MAAM,cAAa;AAAA;AAAA,EAQxB,YAAY,YAA2B,UAAU;AAC/C,SAAK,YAAY;AACjB,QAAI;AACF,WAAK,WAAW,mBAAmB,SAAS;AAAA,IAC9C,SAAS,OAAO;AAEd,cAAQ,KAAK,SAAS,SAAS,6CAA6C;AAC5E,WAAK,WAAW,mBAAmB,QAAQ;AAC3C,WAAK,YAAY;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAY,MAAsB;AAChC,QAAI,CAAC,QAAQ,KAAK,KAAA,MAAW,IAAI;AAC/B,aAAO;AAAA,IACT;AAEA,QAAI;AACF,YAAM,SAAS,KAAK,SAAS,OAAO,IAAI;AACxC,aAAO,OAAO;AAAA,IAChB,SAAS,OAAO;AACd,cAAQ,KAAK,iEAAiE,KAAK;AAEnF,aAAO,KAAK,KAAK,KAAK,MAAM,KAAK,EAAE,SAAS,GAAG;AAAA,IACjD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB,SAA8B;AAC/C,UAAM,gBAAgB,KAAK,YAAY,QAAQ,OAAiB;AAChE,UAAM,aAAa,KAAK,YAAY,KAAK,eAAe,OAAO,CAAC;AAGhE,WAAO,gBAAgB,aAAa,cAAa,mBAAmB,cAAa;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,oBAAoB,UAAiC;AACnD,QAAI,CAAC,YAAY,SAAS,WAAW,GAAG;AACtC,aAAO;AAAA,IACT;AAEA,WAAO,SAAS,OAAO,CAAC,OAAO,YAAY;AACzC,aAAO,QAAQ,KAAK,mBAAmB,OAAO;AAAA,IAChD,GAAG,CAAC;AAAA,EACN;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,2BAA2B,cAA8B;AACvD,QAAI,CAAC,gBAAgB,aAAa,KAAA,MAAW,IAAI;AAC/C,aAAO;AAAA,IACT;AAEA,UAAM,gBAAgB,KAAK,YAAY,YAAY;AACnD,UAAM,aAAa,KAAK,YAAY,QAAQ;AAG5C,WAAO,gBAAgB,aAAa,cAAa,mBAAmB,cAAa;AAAA,EACnF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,oBAAoB,cAAsB,UAAiC;AACzE,UAAM,eAAe,KAAK,2BAA2B,YAAY;AACjE,UAAM,gBAAgB,KAAK,oBAAoB,QAAQ;AAGvD,UAAM,qBAAqB;AAE3B,WAAO,eAAe,gBAAgB;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,eAAe,SAA8B;AACnD,UAAM,cAAc,QAAQ,SAAA;AAC5B,YAAQ,aAAA;AAAA,MACN,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT,KAAK;AACH,eAAO;AAAA,MACT;AACE,eAAO;AAAA,IAAA;AAAA,EAEb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,eAAuB;AACrB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,UAAgB;AACd,QAAI;AACF,WAAK,SAAS,KAAA;AAAA,IAChB,SAAS,OAAO;AACd,cAAQ,KAAK,6BAA6B,KAAK;AAAA,IACjD;AAAA,EACF;AACF;AA1IE,cAAwB,mBAAmB;AAC3C,cAAwB,gBAAgB;AANnC,IAAM,eAAN;"}
+{"version":3,"file":"index23.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,\n  maxAgeMs: 60 * 60 * 1000,\n  maxReferences: 100,\n  maxTotalStorageBytes: 100 * 1024 * 1024,\n  enableAutoCleanup: true,\n  cleanupIntervalMs: 5 * 60 * 1000,\n  enablePersistence: false,\n  storageBackend: 'memory',\n  cleanupPolicies: {\n    recent: { maxAgeMs: 30 * 60 * 1000, priority: 1 },\n    userContent: { maxAgeMs: 2 * 60 * 60 * 1000, priority: 2 },\n    agentGenerated: { maxAgeMs: 60 * 60 * 1000, priority: 3 },\n    default: { maxAgeMs: 60 * 60 * 1000, priority: 4 }\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,EACzB,UAAU,KAAK,KAAK;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB,MAAM,OAAO;AAAA,EACnC,mBAAmB;AAAA,EACnB,mBAAmB,IAAI,KAAK;AAAA,EAC5B,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,IACf,QAAQ,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IAC9C,aAAa,EAAE,UAAU,IAAI,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACvD,gBAAgB,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACtD,SAAS,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;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/index24.js

@@ -1,68 +1,95 @@
-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");
+import { TransferTransaction, AccountId, Hbar } from "@hashgraph/sdk";
+import BigNumber from "bignumber.js";
+import { BaseServiceBuilder } from "hedera-agent-kit";
+class AccountBuilder extends BaseServiceBuilder {
+  constructor(hederaKit) {
+    super(hederaKit);
   }
   /**
-   * Validate that a string is a properly formatted reference ID
-   * 
-   * @param id The ID to validate
-   * @returns true if the ID is valid format
+   * Transfers HBAR between accounts with proper decimal handling
    */
-  static isValidReferenceId(id) {
-    if (!id || typeof id !== "string") {
-      return false;
+  transferHbar(params, isUserInitiated = true) {
+    this.clearNotes();
+    const transaction = new TransferTransaction();
+    if (!params.transfers || params.transfers.length === 0) {
+      throw new Error("HbarTransferParams must include at least one transfer.");
     }
-    if (id.length !== 43) {
-      return false;
+    let netZeroInTinybars = new BigNumber(0);
+    let userTransferProcessedForScheduling = false;
+    if (isUserInitiated && this.kit.userAccountId && this.kit.operationalMode === "provideBytes" && params.transfers.length === 1) {
+      const receiverTransfer = params.transfers[0];
+      const amountValue = typeof receiverTransfer.amount === "string" || typeof receiverTransfer.amount === "number" ? receiverTransfer.amount : receiverTransfer.amount.toString();
+      const amountBigNum = new BigNumber(amountValue);
+      if (amountBigNum.isPositive()) {
+        const recipientAccountId = typeof receiverTransfer.accountId === "string" ? AccountId.fromString(receiverTransfer.accountId) : receiverTransfer.accountId;
+        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
+        const sdkHbarAmount = Hbar.fromString(roundedAmount);
+        this.logger.info(
+          `[AccountBuilder.transferHbar] Configuring user-initiated scheduled transfer: ${sdkHbarAmount.toString()} from ${this.kit.userAccountId} to ${recipientAccountId.toString()}`
+        );
+        this.addNote(
+          `Configured HBAR transfer from your account (${this.kit.userAccountId}) to ${recipientAccountId.toString()} for ${sdkHbarAmount.toString()}.`
+        );
+        transaction.addHbarTransfer(recipientAccountId, sdkHbarAmount);
+        transaction.addHbarTransfer(
+          AccountId.fromString(this.kit.userAccountId),
+          sdkHbarAmount.negated()
+        );
+        userTransferProcessedForScheduling = true;
+      }
     }
-    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;
+    if (!userTransferProcessedForScheduling) {
+      const processedTransfers = [];
+      for (const transferInput of params.transfers) {
+        const accountId = typeof transferInput.accountId === "string" ? AccountId.fromString(transferInput.accountId) : transferInput.accountId;
+        const amountValue = typeof transferInput.amount === "string" || typeof transferInput.amount === "number" ? transferInput.amount : transferInput.amount.toString();
+        const amountBigNum = new BigNumber(amountValue);
+        const roundedAmount = amountBigNum.toFixed(8, BigNumber.ROUND_DOWN);
+        this.logger.info(
+          `Processing transfer: ${amountValue} HBAR (rounded to ${roundedAmount}) for account ${accountId.toString()}`
+        );
+        const sdkHbarAmount = Hbar.fromString(roundedAmount);
+        processedTransfers.push({
+          accountId,
+          amount: amountBigNum,
+          hbar: sdkHbarAmount
+        });
+        const tinybarsContribution = sdkHbarAmount.toTinybars();
+        netZeroInTinybars = netZeroInTinybars.plus(
+          tinybarsContribution.toString()
+        );
+      }
+      if (!netZeroInTinybars.isZero()) {
+        this.logger.warn(
+          `Transfer sum not zero: ${netZeroInTinybars.toString()} tinybars off. Adjusting last transfer.`
+        );
+        if (processedTransfers.length > 0) {
+          const lastTransfer = processedTransfers[processedTransfers.length - 1];
+          const adjustment = netZeroInTinybars.dividedBy(-1e8);
+          const adjustedAmount = lastTransfer.amount.plus(adjustment);
+          const adjustedRounded = adjustedAmount.toFixed(8, BigNumber.ROUND_DOWN);
+          lastTransfer.hbar = Hbar.fromString(adjustedRounded);
+          this.logger.info(
+            `Adjusted last transfer for ${lastTransfer.accountId.toString()} to ${adjustedRounded} HBAR`
+          );
+        }
+      }
+      for (const transfer of processedTransfers) {
+        transaction.addHbarTransfer(transfer.accountId, transfer.hbar);
+      }
     }
-    const refFormatMatch = input.match(/^ref:\/\/([A-Za-z0-9_-]{43})$/);
-    if (refFormatMatch) {
-      return refFormatMatch[1];
+    if (typeof params.memo !== "undefined") {
+      if (params.memo === null) {
+        this.logger.warn("Received null for memo in transferHbar.");
+      } else {
+        transaction.setTransactionMemo(params.memo);
+      }
     }
-    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);
+    this.setCurrentTransaction(transaction);
+    return this;
   }
 }
 export {
-  ReferenceIdGenerator
+  AccountBuilder
 };
 //# sourceMappingURL=index24.js.map