@hashgraphonline/conversational-agent 0.1.209 → 0.1.210

package/dist/esm/index16.js

@@ -1,49 +1,136 @@
+import { StructuredTool } from "@langchain/core/tools";
 import { z } from "zod";
-import { AccountBuilder } from "./index24.js";
-import { BaseHederaTransactionTool } from "hedera-agent-kit";
-const HbarTransferInputSchema = z.object({
-  accountId: z.string().describe('Account ID for the transfer (e.g., "0.0.xxxx").'),
-  amount: z.union([z.number(), z.string()]).describe(
-    "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."
-  )
+import { ChatOpenAI } from "@langchain/openai";
+const ResolveEntitiesSchema = z.object({
+  message: z.string().describe("The message containing entity references to resolve"),
+  entities: z.array(z.object({
+    entityId: z.string(),
+    entityName: z.string(),
+    entityType: z.string()
+  })).describe("Available entities in memory")
 });
-const TransferHbarZodSchemaCore = z.object({
-  transfers: z.array(HbarTransferInputSchema).min(1).describe(
-    'Array of ALL transfers for this transaction. For multi-party transfers (e.g., "A sends 5 to C and B sends 3 to C"), include all transfers here: [{accountId: "A", amount: -5}, {accountId: "B", amount: -3}, {accountId: "C", amount: 8}]. Amounts must sum to zero.'
-  ),
-  memo: z.string().optional().describe("Optional. Memo for the transaction.")
+const ExtractEntitiesSchema = z.object({
+  response: z.string().describe("Agent response text to extract entities from"),
+  userMessage: z.string().describe("Original user message for context")
 });
-class TransferHbarTool extends BaseHederaTransactionTool {
-  constructor() {
-    super(...arguments);
-    this.name = "hedera-account-transfer-hbar-v2";
-    this.description = 'PRIMARY TOOL FOR HBAR TRANSFERS: Transfers HBAR between accounts. Supports multiple transfers in a single transaction - when multiple accounts need to send/receive HBAR (e.g., "A sends 5 HBAR to C and B sends 3 HBAR to C"), include ALL transfers in one transfers array. The sum of all transfers must equal zero. Use this for scheduled transactions and multi-signature scenarios.';
-    this.specificInputSchema = TransferHbarZodSchemaCore;
-    this.namespace = "account";
+class ResolveEntitiesTool extends StructuredTool {
+  constructor(apiKey, modelName = "gpt-4o-mini") {
+    super();
+    this.name = "resolve_entities";
+    this.description = 'Resolves entity references like "the topic", "it", "that" to actual entity IDs';
+    this.schema = ResolveEntitiesSchema;
+    this.llm = new ChatOpenAI({
+      apiKey,
+      modelName,
+      temperature: 0
+    });
   }
-  /**
-   * Creates and returns the service builder for account operations.
-   * 
-   * @returns BaseServiceBuilder instance configured for account operations
-   */
-  getServiceBuilder() {
-    return new AccountBuilder(this.hederaKit);
+  async _call(input) {
+    const { message, entities } = input;
+    if (!entities || entities.length === 0) {
+      return message;
+    }
+    const byType = this.groupEntitiesByType(entities);
+    const context = this.buildEntityContext(byType);
+    const prompt = `Task: Replace entity references with IDs.
+
+${context}
+
+Message: "${message}"
+
+Rules:
+- "the topic" or "that topic" → replace with most recent topic ID
+- "the token" or "that token" → replace with most recent token ID
+- "it" or "that" after action verb → replace with most recent entity ID
+- "airdrop X" without token ID → add most recent token ID as first parameter
+- Token operations without explicit token → use most recent token ID
+
+Examples:
+- "submit on the topic" → "submit on 0.0.6543472"
+- "airdrop the token" → "airdrop 0.0.123456"
+- "airdrop 10 to 0.0.5842697" → "airdrop 0.0.123456 10 to 0.0.5842697"
+- "mint 100" → "mint 0.0.123456 100"
+
+Return ONLY the resolved message:`;
+    try {
+      const response = await this.llm.invoke(prompt);
+      return response.content.trim();
+    } catch (error) {
+      console.error("[ResolveEntitiesTool] Failed:", error);
+      return message;
+    }
   }
-  /**
-   * Executes the HBAR transfer using the provided builder and arguments.
-   * Validates that all transfers sum to zero before execution.
-   * 
-   * @param builder - The service builder instance for executing transactions
-   * @param specificArgs - The validated transfer parameters including transfers array and optional memo
-   * @returns Promise that resolves when the transfer is complete
-   */
-  async callBuilderMethod(builder, specificArgs) {
-    await builder.transferHbar(
-      specificArgs
-    );
+  groupEntitiesByType(entities) {
+    return entities.reduce((acc, entity) => {
+      if (!acc[entity.entityType]) {
+        acc[entity.entityType] = [];
+      }
+      acc[entity.entityType].push(entity);
+      return acc;
+    }, {});
   }
+  buildEntityContext(groupedEntities) {
+    let context = "Available entities:\n";
+    for (const [type, list] of Object.entries(groupedEntities)) {
+      const recent = list[0];
+      context += `- Most recent ${type}: "${recent.entityName}" = ${recent.entityId}
+`;
+    }
+    return context;
+  }
+}
+class ExtractEntitiesTool extends StructuredTool {
+  constructor(apiKey, modelName = "gpt-4o-mini") {
+    super();
+    this.name = "extract_entities";
+    this.description = "Extracts newly created entities from agent responses";
+    this.schema = ExtractEntitiesSchema;
+    this.llm = new ChatOpenAI({
+      apiKey,
+      modelName,
+      temperature: 0
+    });
+  }
+  async _call(input) {
+    const { response, userMessage } = input;
+    const prompt = `Extract ONLY newly created entities from this response.
+
+User asked: "${userMessage.substring(0, 200)}"
+Response: ${response.substring(0, 3e3)}
+
+Look for:
+- Success messages with new entity IDs
+- Words like "created", "new", "successfully" followed by entity IDs
+
+Return JSON array of created entities:
+[{"id": "0.0.XXX", "name": "name", "type": "topic|token|account"}]
+
+If none created, return: []
+
+JSON:`;
+    try {
+      const llmResponse = await this.llm.invoke(prompt);
+      const content = llmResponse.content;
+      const match = content.match(/\[[\s\S]*?\]/);
+      if (match) {
+        return match[0];
+      }
+      return "[]";
+    } catch (error) {
+      console.error("[ExtractEntitiesTool] Failed:", error);
+      return "[]";
+    }
+  }
+}
+function createEntityTools(apiKey, modelName = "gpt-4o-mini") {
+  return {
+    resolveEntities: new ResolveEntitiesTool(apiKey, modelName),
+    extractEntities: new ExtractEntitiesTool(apiKey, modelName)
+  };
 }
 export {
-  TransferHbarTool
+  ExtractEntitiesTool,
+  ResolveEntitiesTool,
+  createEntityTools
 };
 //# sourceMappingURL=index16.js.map

package/dist/esm/index16.js.map

@@ -1 +1 @@
-{"version":3,"file":"index16.js","sources":["../../src/plugins/hbar-transfer/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 ALL transfers for this transaction. For multi-party transfers (e.g., \"A sends 5 to C and B sends 3 to C\"), include all transfers here: [{accountId: \"A\", amount: -5}, {accountId: \"B\", amount: -3}, {accountId: \"C\", amount: 8}]. Amounts must sum to zero.'\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 network.\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. Supports multiple transfers in a single transaction - when multiple accounts need to send/receive HBAR (e.g., \"A sends 5 HBAR to C and B sends 3 HBAR to C\"), include ALL transfers in one transfers array. The sum of all transfers must equal zero. Use this for scheduled transactions and multi-signature scenarios.';\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;"}
+{"version":3,"file":"index16.js","sources":["../../src/tools/EntityResolverTool.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { ChatOpenAI } from '@langchain/openai';\nimport type { EntityAssociation } from '../memory/SmartMemoryManager';\n\nconst ResolveEntitiesSchema = z.object({\n  message: z.string().describe('The message containing entity references to resolve'),\n  entities: z.array(z.object({\n    entityId: z.string(),\n    entityName: z.string(),\n    entityType: z.string(),\n  })).describe('Available entities in memory'),\n});\n\nconst ExtractEntitiesSchema = z.object({\n  response: z.string().describe('Agent response text to extract entities from'),\n  userMessage: z.string().describe('Original user message for context'),\n});\n\nexport class ResolveEntitiesTool extends StructuredTool {\n  name = 'resolve_entities';\n  description = 'Resolves entity references like \"the topic\", \"it\", \"that\" to actual entity IDs';\n  schema = ResolveEntitiesSchema;\n  \n  private llm: ChatOpenAI;\n  \n  constructor(apiKey: string, modelName = 'gpt-4o-mini') {\n    super();\n    this.llm = new ChatOpenAI({\n      apiKey,\n      modelName,\n      temperature: 0,\n    });\n  }\n  \n  async _call(input: z.infer<typeof ResolveEntitiesSchema>): Promise<string> {\n    const { message, entities } = input;\n    \n    if (!entities || entities.length === 0) {\n      return message;\n    }\n    \n    const byType = this.groupEntitiesByType(entities);\n    const context = this.buildEntityContext(byType);\n    \n    const prompt = `Task: Replace entity references with IDs.\n\n${context}\n\nMessage: \"${message}\"\n\nRules:\n- \"the topic\" or \"that topic\" → replace with most recent topic ID\n- \"the token\" or \"that token\" → replace with most recent token ID\n- \"it\" or \"that\" after action verb → replace with most recent entity ID\n- \"airdrop X\" without token ID → add most recent token ID as first parameter\n- Token operations without explicit token → use most recent token ID\n\nExamples:\n- \"submit on the topic\" → \"submit on 0.0.6543472\"\n- \"airdrop the token\" → \"airdrop 0.0.123456\"\n- \"airdrop 10 to 0.0.5842697\" → \"airdrop 0.0.123456 10 to 0.0.5842697\"\n- \"mint 100\" → \"mint 0.0.123456 100\"\n\nReturn ONLY the resolved message:`;\n    \n    try {\n      const response = await this.llm.invoke(prompt);\n      return (response.content as string).trim();\n    } catch (error) {\n      console.error('[ResolveEntitiesTool] Failed:', error);\n      return message;\n    }\n  }\n  \n  private groupEntitiesByType(entities: EntityGroup): GroupedEntities {\n    return entities.reduce((acc, entity) => {\n      if (!acc[entity.entityType]) {\n        acc[entity.entityType] = [];\n      }\n      acc[entity.entityType].push(entity);\n      return acc;\n    }, {} as GroupedEntities);\n  }\n  \n  private buildEntityContext(groupedEntities: GroupedEntities): string {\n    let context = 'Available entities:\\n';\n    for (const [type, list] of Object.entries(groupedEntities)) {\n      const recent = list[0];\n      context += `- Most recent ${type}: \"${recent.entityName}\" = ${recent.entityId}\\n`;\n    }\n    return context;\n  }\n}\n\nexport class ExtractEntitiesTool extends StructuredTool {\n  name = 'extract_entities';\n  description = 'Extracts newly created entities from agent responses';\n  schema = ExtractEntitiesSchema;\n  \n  private llm: ChatOpenAI;\n  \n  constructor(apiKey: string, modelName = 'gpt-4o-mini') {\n    super();\n    this.llm = new ChatOpenAI({\n      apiKey,\n      modelName,\n      temperature: 0,\n    });\n  }\n  \n  async _call(input: z.infer<typeof ExtractEntitiesSchema>): Promise<string> {\n    const { response, userMessage } = input;\n    \n    const prompt = `Extract ONLY newly created entities from this response.\n\nUser asked: \"${userMessage.substring(0, 200)}\"\nResponse: ${response.substring(0, 3000)}\n\nLook for:\n- Success messages with new entity IDs\n- Words like \"created\", \"new\", \"successfully\" followed by entity IDs\n\nReturn JSON array of created entities:\n[{\"id\": \"0.0.XXX\", \"name\": \"name\", \"type\": \"topic|token|account\"}]\n\nIf none created, return: []\n\nJSON:`;\n    \n    try {\n      const llmResponse = await this.llm.invoke(prompt);\n      const content = llmResponse.content as string;\n      const match = content.match(/\\[[\\s\\S]*?\\]/);\n      if (match) {\n        return match[0];\n      }\n      return '[]';\n    } catch (error) {\n      console.error('[ExtractEntitiesTool] Failed:', error);\n      return '[]';\n    }\n  }\n}\n\nexport function createEntityTools(apiKey: string, modelName = 'gpt-4o-mini'): {\n  resolveEntities: ResolveEntitiesTool;\n  extractEntities: ExtractEntitiesTool;\n} {\n  return {\n    resolveEntities: new ResolveEntitiesTool(apiKey, modelName),\n    extractEntities: new ExtractEntitiesTool(apiKey, modelName),\n  };\n}\n\ninterface EntityReference {\n  entityId: string;\n  entityName: string;\n  entityType: string;\n}\n\ntype EntityGroup = EntityReference[];\n\ntype GroupedEntities = Record<string, EntityGroup>;\n\ninterface ExtractedEntity {\n  id: string;\n  name: string;\n  type: string;\n}"],"names":[],"mappings":"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"}

package/dist/esm/index17.js

@@ -1,16 +1,151 @@
-const getSystemMessage = (accountId) => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, and content inscription.
-
-You have access to tools for:
-- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages
-- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents
-- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions
-
-*** IMPORTANT CONTEXT ***
-You are currently operating as agent: ${accountId} on the Hashgraph Online network
-When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId}
-
-Remember the connection numbers when listing connections, as users might refer to them.`;
+import { ContentStorage } from "./index14.js";
+import { ContentStoreService, ContentResolverRegistry, shouldUseReference, extractReferenceId } from "@hashgraphonline/standards-sdk";
+class ContentStorageAdapter {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  async storeContent(content, metadata) {
+    const contentRef = await this.storage.storeContent(content, metadata);
+    return contentRef.referenceId;
+  }
+  async resolveReference(referenceId) {
+    const result = await this.storage.resolveReference(referenceId);
+    if (result.success && result.content) {
+      const response = {
+        content: result.content
+      };
+      if (result.metadata) {
+        response.metadata = {
+          ...result.metadata.mimeType !== void 0 && { mimeType: result.metadata.mimeType },
+          ...result.metadata.fileName !== void 0 && { fileName: result.metadata.fileName },
+          originalSize: result.metadata.sizeBytes
+        };
+      }
+      return response;
+    } else {
+      throw new Error(result.error || "Reference not found");
+    }
+  }
+  async hasReference(referenceId) {
+    return await this.storage.hasReference(referenceId);
+  }
+  async cleanupReference(referenceId) {
+    await this.storage.cleanupReference(referenceId);
+  }
+  async getStats() {
+    return await this.storage.getStats();
+  }
+  async updateConfig(config) {
+    return await this.storage.updateConfig(config);
+  }
+  async performCleanup() {
+    await this.storage.performCleanup();
+  }
+  async dispose() {
+    return Promise.resolve(this.storage.dispose());
+  }
+}
+class ContentResolver {
+  constructor(adapter) {
+    this.adapter = adapter;
+  }
+  async resolveReference(referenceId) {
+    return await this.adapter.resolveReference(referenceId);
+  }
+  shouldUseReference(content) {
+    return shouldUseReference(content);
+  }
+  extractReferenceId(input) {
+    return extractReferenceId(input);
+  }
+}
+class ContentStoreManager {
+  constructor(maxMessageStorage = 1e3, referenceConfig, logger) {
+    this.isRegistered = false;
+    this.logger = logger || {
+      info: console.log,
+      debug: console.log,
+      warn: console.warn,
+      error: console.error
+    };
+    this.contentStorage = new ContentStorage(maxMessageStorage, referenceConfig);
+    this.adapter = new ContentStorageAdapter(this.contentStorage);
+    this.resolver = new ContentResolver(this.adapter);
+  }
+  /**
+   * Initialize and register content storage for cross-package access
+   */
+  async initialize() {
+    if (this.isRegistered) {
+      this.logger.warn("ContentStoreManager is already initialized");
+      return;
+    }
+    try {
+      await ContentStoreService.setInstance(this.adapter);
+      ContentResolverRegistry.register(this.resolver);
+      this.isRegistered = true;
+      this.logger.info("ContentStoreManager initialized and registered for cross-package access");
+    } catch (error) {
+      this.logger.error("Failed to initialize ContentStoreManager:", error);
+      throw error;
+    }
+  }
+  /**
+   * Get the underlying ContentStorage instance
+   */
+  getContentStorage() {
+    return this.contentStorage;
+  }
+  /**
+   * Get storage statistics
+   */
+  async getStats() {
+    return await this.contentStorage.getStats();
+  }
+  /**
+   * Update configuration
+   */
+  async updateConfig(config) {
+    return await this.contentStorage.updateConfig(config);
+  }
+  /**
+   * Perform manual cleanup
+   */
+  async performCleanup() {
+    return await this.contentStorage.performCleanup();
+  }
+  /**
+   * Check if content should be stored as reference
+   */
+  shouldUseReference(content) {
+    return this.contentStorage.shouldUseReference(content);
+  }
+  /**
+   * Store content if it's large enough
+   */
+  async storeContentIfLarge(content, metadata) {
+    return await this.contentStorage.storeContentIfLarge(content, metadata);
+  }
+  /**
+   * Cleanup and unregister
+   */
+  async dispose() {
+    if (this.isRegistered) {
+      this.contentStorage.dispose();
+      ContentStoreService.dispose();
+      ContentResolverRegistry.unregister();
+      this.isRegistered = false;
+      this.logger.info("ContentStoreManager disposed and unregistered");
+    }
+  }
+  /**
+   * Check if the manager is initialized
+   */
+  isInitialized() {
+    return this.isRegistered;
+  }
+}
 export {
-  getSystemMessage
+  ContentStoreManager
 };
 //# sourceMappingURL=index17.js.map

package/dist/esm/index17.js.map

@@ -1 +1 @@
-{"version":3,"file":"index17.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (accountId: string): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, and content inscription.\n\nYou have access to tools for:\n- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages\n- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents\n- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId} on the Hashgraph Online network\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId}\n\nRemember the connection numbers when listing connections, as users might refer to them.`"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAAC,cAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAQvB,SAAS;AAAA,gGAC+C,SAAS;AAAA;AAAA;"}
+{"version":3,"file":"index17.js","sources":["../../src/services/ContentStoreManager.ts"],"sourcesContent":["import { ContentStorage } from '../memory/ContentStorage';\nimport { \n  ContentStoreService, \n  extractReferenceId, \n  shouldUseReference,\n  ContentResolverRegistry,\n  type ContentStoreInterface, \n  type ContentResolverInterface, \n  type ReferenceResolutionResult \n} from '@hashgraphonline/standards-sdk';\nimport type { ContentReferenceConfig } from '../types/content-reference';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * Adapter to make ContentStorage compatible with ContentStoreInterface\n */\nclass ContentStorageAdapter implements ContentStoreInterface {\n  constructor(private storage: ContentStorage) {}\n\n  async storeContent(content: Buffer, metadata: any) {\n    const contentRef = await this.storage.storeContent(content, metadata);\n    return contentRef.referenceId;\n  }\n\n  async resolveReference(referenceId: string): Promise<ReferenceResolutionResult> {\n    const result = await this.storage.resolveReference(referenceId);\n    if (result.success && result.content) {\n      const response: ReferenceResolutionResult = {\n        content: result.content\n      };\n      if (result.metadata) {\n        response.metadata = {\n          ...(result.metadata.mimeType !== undefined && { mimeType: result.metadata.mimeType }),\n          ...(result.metadata.fileName !== undefined && { fileName: result.metadata.fileName }),\n          originalSize: result.metadata.sizeBytes\n        };\n      }\n      return response;\n    } else {\n      throw new Error(result.error || 'Reference not found');\n    }\n  }\n\n  async hasReference(referenceId: string) {\n    return await this.storage.hasReference(referenceId);\n  }\n\n  async cleanupReference(referenceId: string) {\n    await this.storage.cleanupReference(referenceId);\n  }\n\n  async getStats() {\n    return await this.storage.getStats();\n  }\n\n  async updateConfig(config: any) {\n    return await this.storage.updateConfig(config);\n  }\n\n  async performCleanup() {\n    await this.storage.performCleanup();\n  }\n\n  async dispose() {\n    return Promise.resolve(this.storage.dispose());\n  }\n}\n\n/**\n * Content resolver implementation for dependency injection\n */\nclass ContentResolver implements ContentResolverInterface {\n  constructor(private adapter: ContentStorageAdapter) {}\n\n  async resolveReference(referenceId: string): Promise<ReferenceResolutionResult> {\n    return await this.adapter.resolveReference(referenceId);\n  }\n\n  shouldUseReference(content: string | Buffer): boolean {\n    return shouldUseReference(content);\n  }\n\n  extractReferenceId(input: string): string | null {\n    return extractReferenceId(input);\n  }\n}\n\n/**\n * Manages content store lifecycle and cross-package registration\n */\nexport class ContentStoreManager {\n  private contentStorage: ContentStorage;\n  private adapter: ContentStorageAdapter;\n  private resolver: ContentResolver;\n  private logger: Logger;\n  private isRegistered = false;\n\n  constructor(\n    maxMessageStorage: number = 1000,\n    referenceConfig?: Partial<ContentReferenceConfig>,\n    logger?: Logger\n  ) {\n    this.logger = logger || {\n      info: console.log,\n      debug: console.log,\n      warn: console.warn,\n      error: console.error\n    } as Logger;\n\n    this.contentStorage = new ContentStorage(maxMessageStorage, referenceConfig);\n    this.adapter = new ContentStorageAdapter(this.contentStorage);\n    this.resolver = new ContentResolver(this.adapter);\n  }\n\n  /**\n   * Initialize and register content storage for cross-package access\n   */\n  async initialize(): Promise<void> {\n    if (this.isRegistered) {\n      this.logger.warn('ContentStoreManager is already initialized');\n      return;\n    }\n\n    try {\n      await ContentStoreService.setInstance(this.adapter);\n      ContentResolverRegistry.register(this.resolver);\n      this.isRegistered = true;\n      this.logger.info('ContentStoreManager initialized and registered for cross-package access');\n    } catch (error) {\n      this.logger.error('Failed to initialize ContentStoreManager:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the underlying ContentStorage instance\n   */\n  getContentStorage(): ContentStorage {\n    return this.contentStorage;\n  }\n\n  /**\n   * Get storage statistics\n   */\n  async getStats() {\n    return await this.contentStorage.getStats();\n  }\n\n  /**\n   * Update configuration\n   */\n  async updateConfig(config: Partial<ContentReferenceConfig>) {\n    return await this.contentStorage.updateConfig(config);\n  }\n\n  /**\n   * Perform manual cleanup\n   */\n  async performCleanup() {\n    return await this.contentStorage.performCleanup();\n  }\n\n  /**\n   * Check if content should be stored as reference\n   */\n  shouldUseReference(content: Buffer | string): boolean {\n    return this.contentStorage.shouldUseReference(content);\n  }\n\n  /**\n   * Store content if it's large enough\n   */\n  async storeContentIfLarge(content: Buffer | string, metadata: any) {\n    return await this.contentStorage.storeContentIfLarge(content, metadata);\n  }\n\n  /**\n   * Cleanup and unregister\n   */\n  async dispose(): Promise<void> {\n    if (this.isRegistered) {\n      this.contentStorage.dispose();\n      ContentStoreService.dispose();\n      ContentResolverRegistry.unregister();\n      this.isRegistered = false;\n      this.logger.info('ContentStoreManager disposed and unregistered');\n    }\n  }\n\n  /**\n   * Check if the manager is initialized\n   */\n  isInitialized(): boolean {\n    return this.isRegistered;\n  }\n}"],"names":[],"mappings":"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"}

package/dist/esm/index18.js

@@ -1,151 +1,49 @@
-import { ContentStorage } from "./index14.js";
-import { ContentStoreService, ContentResolverRegistry, shouldUseReference, extractReferenceId } from "@hashgraphonline/standards-sdk";
-class ContentStorageAdapter {
-  constructor(storage) {
-    this.storage = storage;
-  }
-  async storeContent(content, metadata) {
-    const contentRef = await this.storage.storeContent(content, metadata);
-    return contentRef.referenceId;
-  }
-  async resolveReference(referenceId) {
-    const result = await this.storage.resolveReference(referenceId);
-    if (result.success && result.content) {
-      const response = {
-        content: result.content
-      };
-      if (result.metadata) {
-        response.metadata = {
-          ...result.metadata.mimeType !== void 0 && { mimeType: result.metadata.mimeType },
-          ...result.metadata.fileName !== void 0 && { fileName: result.metadata.fileName },
-          originalSize: result.metadata.sizeBytes
-        };
-      }
-      return response;
-    } else {
-      throw new Error(result.error || "Reference not found");
-    }
-  }
-  async hasReference(referenceId) {
-    return await this.storage.hasReference(referenceId);
-  }
-  async cleanupReference(referenceId) {
-    await this.storage.cleanupReference(referenceId);
-  }
-  async getStats() {
-    return await this.storage.getStats();
-  }
-  async updateConfig(config) {
-    return await this.storage.updateConfig(config);
-  }
-  async performCleanup() {
-    await this.storage.performCleanup();
-  }
-  async dispose() {
-    return Promise.resolve(this.storage.dispose());
-  }
-}
-class ContentResolver {
-  constructor(adapter) {
-    this.adapter = adapter;
-  }
-  async resolveReference(referenceId) {
-    return await this.adapter.resolveReference(referenceId);
-  }
-  shouldUseReference(content) {
-    return shouldUseReference(content);
-  }
-  extractReferenceId(input) {
-    return extractReferenceId(input);
-  }
-}
-class ContentStoreManager {
-  constructor(maxMessageStorage = 1e3, referenceConfig, logger) {
-    this.isRegistered = false;
-    this.logger = logger || {
-      info: console.log,
-      debug: console.log,
-      warn: console.warn,
-      error: console.error
-    };
-    this.contentStorage = new ContentStorage(maxMessageStorage, referenceConfig);
-    this.adapter = new ContentStorageAdapter(this.contentStorage);
-    this.resolver = new ContentResolver(this.adapter);
-  }
-  /**
-   * Initialize and register content storage for cross-package access
-   */
-  async initialize() {
-    if (this.isRegistered) {
-      this.logger.warn("ContentStoreManager is already initialized");
-      return;
-    }
-    try {
-      await ContentStoreService.setInstance(this.adapter);
-      ContentResolverRegistry.register(this.resolver);
-      this.isRegistered = true;
-      this.logger.info("ContentStoreManager initialized and registered for cross-package access");
-    } catch (error) {
-      this.logger.error("Failed to initialize ContentStoreManager:", error);
-      throw error;
-    }
-  }
-  /**
-   * Get the underlying ContentStorage instance
-   */
-  getContentStorage() {
-    return this.contentStorage;
-  }
-  /**
-   * Get storage statistics
-   */
-  async getStats() {
-    return await this.contentStorage.getStats();
-  }
-  /**
-   * Update configuration
-   */
-  async updateConfig(config) {
-    return await this.contentStorage.updateConfig(config);
-  }
-  /**
-   * Perform manual cleanup
-   */
-  async performCleanup() {
-    return await this.contentStorage.performCleanup();
-  }
-  /**
-   * Check if content should be stored as reference
-   */
-  shouldUseReference(content) {
-    return this.contentStorage.shouldUseReference(content);
-  }
-  /**
-   * Store content if it's large enough
-   */
-  async storeContentIfLarge(content, metadata) {
-    return await this.contentStorage.storeContentIfLarge(content, metadata);
-  }
-  /**
-   * Cleanup and unregister
-   */
-  async dispose() {
-    if (this.isRegistered) {
-      this.contentStorage.dispose();
-      ContentStoreService.dispose();
-      ContentResolverRegistry.unregister();
-      this.isRegistered = false;
-      this.logger.info("ContentStoreManager disposed and unregistered");
-    }
-  }
-  /**
-   * Check if the manager is initialized
-   */
-  isInitialized() {
-    return this.isRegistered;
+import { z } from "zod";
+import { AccountBuilder } from "./index26.js";
+import { BaseHederaTransactionTool } from "hedera-agent-kit";
+const HbarTransferInputSchema = z.object({
+  accountId: z.string().describe('Account ID for the transfer (e.g., "0.0.xxxx").'),
+  amount: z.union([z.number(), z.string()]).describe(
+    "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."
+  )
+});
+const TransferHbarZodSchemaCore = z.object({
+  transfers: z.array(HbarTransferInputSchema).min(1).describe(
+    '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.'
+  ),
+  memo: z.string().optional().describe("Optional. Memo for the transaction.")
+});
+class TransferHbarTool extends BaseHederaTransactionTool {
+  constructor() {
+    super(...arguments);
+    this.name = "hedera-account-transfer-hbar-v2";
+    this.description = '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).';
+    this.specificInputSchema = TransferHbarZodSchemaCore;
+    this.namespace = "account";
+  }
+  /**
+   * Creates and returns the service builder for account operations.
+   * 
+   * @returns BaseServiceBuilder instance configured for account operations
+   */
+  getServiceBuilder() {
+    return new AccountBuilder(this.hederaKit);
+  }
+  /**
+   * Executes the HBAR transfer using the provided builder and arguments.
+   * Validates that all transfers sum to zero before execution.
+   * 
+   * @param builder - The service builder instance for executing transactions
+   * @param specificArgs - The validated transfer parameters including transfers array and optional memo
+   * @returns Promise that resolves when the transfer is complete
+   */
+  async callBuilderMethod(builder, specificArgs) {
+    await builder.transferHbar(
+      specificArgs
+    );
   }
 }
 export {
-  ContentStoreManager
+  TransferHbarTool
 };
 //# sourceMappingURL=index18.js.map