@hashgraphonline/conversational-agent 0.1.218 → 0.1.220

package/dist/esm/index33.js

@@ -1,49 +1,117 @@
-import { z } from "zod";
-import { AccountBuilder } from "./index42.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";
+class ResponseFormatter {
+  /**
+   * Checks if a parsed response contains HashLink block data for interactive rendering
+   */
+  static isHashLinkResponse(parsed) {
+    if (!parsed || typeof parsed !== "object") {
+      return false;
+    }
+    const responseObj = parsed;
+    return !!(responseObj.success === true && responseObj.type === "inscription" && responseObj.hashLinkBlock && typeof responseObj.hashLinkBlock === "object");
+  }
+  /**
+   * Formats HashLink block response with simple text confirmation
+   * HTML template rendering is handled by HashLinkBlockRenderer component via metadata
+   */
+  static formatHashLinkResponse(parsed) {
+    const hashLinkBlock = parsed.hashLinkBlock;
+    const metadata = parsed.metadata || {};
+    const inscription = parsed.inscription || {};
+    let message = "✅ Interactive content created successfully!\n\n";
+    if (metadata.name) {
+      message += `**${metadata.name}**
+`;
+    }
+    if (metadata.description) {
+      message += `${metadata.description}
+
+`;
+    }
+    if (inscription.topicId || hashLinkBlock.attributes.topicId) {
+      message += `📍 **Topic ID:** ${inscription.topicId || hashLinkBlock.attributes.topicId}
+`;
+    }
+    if (inscription.hrl || hashLinkBlock.attributes.hrl) {
+      message += `🔗 **HRL:** ${inscription.hrl || hashLinkBlock.attributes.hrl}
+`;
+    }
+    if (inscription.cdnUrl) {
+      message += `🌐 **CDN URL:** ${inscription.cdnUrl}
+`;
+    }
+    if (metadata.creator) {
+      message += `👤 **Creator:** ${metadata.creator}
+`;
+    }
+    message += "\n⚡ Interactive content will load below";
+    return message.trim();
+  }
+  /**
+   * Checks if a parsed response is an inscription response that needs formatting
+   */
+  static isInscriptionResponse(parsed) {
+    if (!parsed || typeof parsed !== "object") {
+      return false;
+    }
+    const responseObj = parsed;
+    return !!(responseObj.success === true && responseObj.type === "inscription" && responseObj.inscription && typeof responseObj.inscription === "object");
   }
   /**
-   * Creates and returns the service builder for account operations.
-   * 
-   * @returns BaseServiceBuilder instance configured for account operations
+   * Formats inscription response into user-friendly message
    */
-  getServiceBuilder() {
-    return new AccountBuilder(this.hederaKit);
+  static formatInscriptionResponse(parsed) {
+    const inscription = parsed.inscription;
+    const metadata = parsed.metadata || {};
+    const title = parsed.title || "Inscription Complete";
+    let message = `✅ ${title}
+
+`;
+    if (metadata.name) {
+      message += `**${metadata.name}**
+`;
+    }
+    if (metadata.description) {
+      message += `${metadata.description}
+
+`;
+    }
+    if (inscription.topicId) {
+      message += `📍 **Topic ID:** ${inscription.topicId}
+`;
+    }
+    if (inscription.hrl) {
+      message += `🔗 **HRL:** ${inscription.hrl}
+`;
+    }
+    if (inscription.cdnUrl) {
+      message += `🌐 **CDN URL:** ${inscription.cdnUrl}
+`;
+    }
+    if (metadata.creator) {
+      message += `👤 **Creator:** ${metadata.creator}
+`;
+    }
+    return message.trim();
   }
   /**
-   * 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
+   * Main formatting method that determines the best response format
    */
-  async callBuilderMethod(builder, specificArgs) {
-    await builder.transferHbar(
-      specificArgs
-    );
+  static formatResponse(toolOutput) {
+    try {
+      const parsed = JSON.parse(toolOutput);
+      if (ResponseFormatter.isHashLinkResponse(parsed)) {
+        return ResponseFormatter.formatHashLinkResponse(parsed);
+      }
+      if (ResponseFormatter.isInscriptionResponse(parsed)) {
+        return ResponseFormatter.formatInscriptionResponse(parsed);
+      }
+      return toolOutput;
+    } catch {
+      return toolOutput;
+    }
   }
 }
 export {
-  TransferHbarTool
+  ResponseFormatter
 };
 //# sourceMappingURL=index33.js.map

package/dist/esm/index33.js.map

@@ -1 +1 @@
-{"version":3,"file":"index33.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;"}
+{"version":3,"file":"index33.js","sources":["../../src/utils/response-formatter.ts"],"sourcesContent":["/**\n * HCS-12 HashLink block structure for interactive content rendering\n */\ninterface HCS12BlockResult {\n  blockId: string;\n  hashLink: string;\n  template: string;\n  attributes: Record<string, unknown>;\n}\n\n/**\n * Utility class for formatting tool responses into user-friendly messages\n */\nexport class ResponseFormatter {\n  /**\n   * Checks if a parsed response contains HashLink block data for interactive rendering\n   */\n  static isHashLinkResponse(parsed: unknown): boolean {\n    if (!parsed || typeof parsed !== 'object') {\n      return false;\n    }\n\n    const responseObj = parsed as Record<string, unknown>;\n    return !!(\n      responseObj.success === true &&\n      responseObj.type === 'inscription' &&\n      responseObj.hashLinkBlock &&\n      typeof responseObj.hashLinkBlock === 'object'\n    );\n  }\n\n  /**\n   * Formats HashLink block response with simple text confirmation\n   * HTML template rendering is handled by HashLinkBlockRenderer component via metadata\n   */\n  static formatHashLinkResponse(parsed: Record<string, unknown>): string {\n    const hashLinkBlock = parsed.hashLinkBlock as HCS12BlockResult;\n    const metadata = parsed.metadata as Record<string, unknown> || {};\n    const inscription = parsed.inscription as Record<string, unknown> || {};\n\n    let message = '✅ Interactive content created successfully!\\n\\n';\n\n    if (metadata.name) {\n      message += `**${metadata.name}**\\n`;\n    }\n\n    if (metadata.description) {\n      message += `${metadata.description}\\n\\n`;\n    }\n\n    if (inscription.topicId || hashLinkBlock.attributes.topicId) {\n      message += `📍 **Topic ID:** ${inscription.topicId || hashLinkBlock.attributes.topicId}\\n`;\n    }\n\n    if (inscription.hrl || hashLinkBlock.attributes.hrl) {\n      message += `🔗 **HRL:** ${inscription.hrl || hashLinkBlock.attributes.hrl}\\n`;\n    }\n\n    if (inscription.cdnUrl) {\n      message += `🌐 **CDN URL:** ${inscription.cdnUrl}\\n`;\n    }\n\n    if (metadata.creator) {\n      message += `👤 **Creator:** ${metadata.creator}\\n`;\n    }\n\n    message += '\\n⚡ Interactive content will load below';\n\n    return message.trim();\n  }\n\n  /**\n   * Checks if a parsed response is an inscription response that needs formatting\n   */\n  static isInscriptionResponse(parsed: unknown): boolean {\n    if (!parsed || typeof parsed !== 'object') {\n      return false;\n    }\n\n    const responseObj = parsed as Record<string, unknown>;\n    return !!(\n      responseObj.success === true &&\n      responseObj.type === 'inscription' &&\n      responseObj.inscription &&\n      typeof responseObj.inscription === 'object'\n    );\n  }\n\n  /**\n   * Formats inscription response into user-friendly message\n   */\n  static formatInscriptionResponse(parsed: Record<string, unknown>): string {\n    const inscription = parsed.inscription as Record<string, unknown>;\n    const metadata = parsed.metadata as Record<string, unknown> || {};\n    const title = parsed.title as string || 'Inscription Complete';\n\n    let message = `✅ ${title}\\n\\n`;\n\n    if (metadata.name) {\n      message += `**${metadata.name}**\\n`;\n    }\n\n    if (metadata.description) {\n      message += `${metadata.description}\\n\\n`;\n    }\n\n    if (inscription.topicId) {\n      message += `📍 **Topic ID:** ${inscription.topicId}\\n`;\n    }\n\n    if (inscription.hrl) {\n      message += `🔗 **HRL:** ${inscription.hrl}\\n`;\n    }\n\n    if (inscription.cdnUrl) {\n      message += `🌐 **CDN URL:** ${inscription.cdnUrl}\\n`;\n    }\n\n    if (metadata.creator) {\n      message += `👤 **Creator:** ${metadata.creator}\\n`;\n    }\n\n    return message.trim();\n  }\n\n  /**\n   * Main formatting method that determines the best response format\n   */\n  static formatResponse(toolOutput: string): string {\n    try {\n      const parsed = JSON.parse(toolOutput);\n      \n      if (ResponseFormatter.isHashLinkResponse(parsed)) {\n        return ResponseFormatter.formatHashLinkResponse(parsed);\n      }\n      \n      if (ResponseFormatter.isInscriptionResponse(parsed)) {\n        return ResponseFormatter.formatInscriptionResponse(parsed);\n      }\n      \n      return toolOutput;\n    } catch {\n      return toolOutput;\n    }\n  }\n}"],"names":[],"mappings":"AAaO,MAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA,EAI7B,OAAO,mBAAmB,QAA0B;AAClD,QAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,aAAO;AAAA,IACT;AAEA,UAAM,cAAc;AACpB,WAAO,CAAC,EACN,YAAY,YAAY,QACxB,YAAY,SAAS,iBACrB,YAAY,iBACZ,OAAO,YAAY,kBAAkB;AAAA,EAEzC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,uBAAuB,QAAyC;AACrE,UAAM,gBAAgB,OAAO;AAC7B,UAAM,WAAW,OAAO,YAAuC,CAAA;AAC/D,UAAM,cAAc,OAAO,eAA0C,CAAA;AAErE,QAAI,UAAU;AAEd,QAAI,SAAS,MAAM;AACjB,iBAAW,KAAK,SAAS,IAAI;AAAA;AAAA,IAC/B;AAEA,QAAI,SAAS,aAAa;AACxB,iBAAW,GAAG,SAAS,WAAW;AAAA;AAAA;AAAA,IACpC;AAEA,QAAI,YAAY,WAAW,cAAc,WAAW,SAAS;AAC3D,iBAAW,oBAAoB,YAAY,WAAW,cAAc,WAAW,OAAO;AAAA;AAAA,IACxF;AAEA,QAAI,YAAY,OAAO,cAAc,WAAW,KAAK;AACnD,iBAAW,eAAe,YAAY,OAAO,cAAc,WAAW,GAAG;AAAA;AAAA,IAC3E;AAEA,QAAI,YAAY,QAAQ;AACtB,iBAAW,mBAAmB,YAAY,MAAM;AAAA;AAAA,IAClD;AAEA,QAAI,SAAS,SAAS;AACpB,iBAAW,mBAAmB,SAAS,OAAO;AAAA;AAAA,IAChD;AAEA,eAAW;AAEX,WAAO,QAAQ,KAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,sBAAsB,QAA0B;AACrD,QAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,aAAO;AAAA,IACT;AAEA,UAAM,cAAc;AACpB,WAAO,CAAC,EACN,YAAY,YAAY,QACxB,YAAY,SAAS,iBACrB,YAAY,eACZ,OAAO,YAAY,gBAAgB;AAAA,EAEvC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,0BAA0B,QAAyC;AACxE,UAAM,cAAc,OAAO;AAC3B,UAAM,WAAW,OAAO,YAAuC,CAAA;AAC/D,UAAM,QAAQ,OAAO,SAAmB;AAExC,QAAI,UAAU,KAAK,KAAK;AAAA;AAAA;AAExB,QAAI,SAAS,MAAM;AACjB,iBAAW,KAAK,SAAS,IAAI;AAAA;AAAA,IAC/B;AAEA,QAAI,SAAS,aAAa;AACxB,iBAAW,GAAG,SAAS,WAAW;AAAA;AAAA;AAAA,IACpC;AAEA,QAAI,YAAY,SAAS;AACvB,iBAAW,oBAAoB,YAAY,OAAO;AAAA;AAAA,IACpD;AAEA,QAAI,YAAY,KAAK;AACnB,iBAAW,eAAe,YAAY,GAAG;AAAA;AAAA,IAC3C;AAEA,QAAI,YAAY,QAAQ;AACtB,iBAAW,mBAAmB,YAAY,MAAM;AAAA;AAAA,IAClD;AAEA,QAAI,SAAS,SAAS;AACpB,iBAAW,mBAAmB,SAAS,OAAO;AAAA;AAAA,IAChD;AAEA,WAAO,QAAQ,KAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,eAAe,YAA4B;AAChD,QAAI;AACF,YAAM,SAAS,KAAK,MAAM,UAAU;AAEpC,UAAI,kBAAkB,mBAAmB,MAAM,GAAG;AAChD,eAAO,kBAAkB,uBAAuB,MAAM;AAAA,MACxD;AAEA,UAAI,kBAAkB,sBAAsB,MAAM,GAAG;AACnD,eAAO,kBAAkB,0BAA0B,MAAM;AAAA,MAC3D;AAEA,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;"}

package/dist/esm/index34.js

@@ -1,106 +1,49 @@
-import { StructuredTool } from "@langchain/core/tools";
 import { z } from "zod";
-import { Logger } from "@hashgraphonline/standards-sdk";
-class AirdropToolWrapper extends StructuredTool {
-  constructor(originalTool, agentKit) {
-    super();
-    this.name = "hedera-hts-airdrop-token";
-    this.description = "Airdrops fungible tokens to multiple recipients. Automatically converts human-readable amounts to smallest units based on token decimals.";
-    this.schema = z.object({
-      tokenId: z.string().describe('The ID of the fungible token to airdrop (e.g., "0.0.yyyy").'),
-      recipients: z.array(
-        z.object({
-          accountId: z.string().describe('Recipient account ID (e.g., "0.0.xxxx").'),
-          amount: z.union([z.number(), z.string()]).describe(
-            'Amount in human-readable format (e.g., "10" for 10 tokens).'
-          )
-        })
-      ).min(1).describe("Array of recipient objects, each with accountId and amount."),
-      memo: z.string().optional().describe("Optional. Memo for the transaction.")
-    });
-    this.originalTool = originalTool;
-    this.agentKit = agentKit;
-    this.logger = new Logger({ module: "AirdropToolWrapper" });
+import { AccountBuilder } from "./index43.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";
   }
-  async _call(input) {
-    try {
-      this.logger.info(
-        `Processing airdrop request for token ${input.tokenId} with ${input.recipients.length} recipients`
-      );
-      const tokenInfo = await this.getTokenInfo(input.tokenId);
-      const decimals = tokenInfo.decimals || 0;
-      this.logger.info(`Token ${input.tokenId} has ${decimals} decimal places`);
-      const convertedRecipients = input.recipients.map((recipient) => {
-        const humanAmount = typeof recipient.amount === "string" ? parseFloat(recipient.amount) : recipient.amount;
-        const smallestUnitAmount = this.convertToSmallestUnits(
-          humanAmount,
-          decimals
-        );
-        this.logger.info(
-          `Converting amount for ${recipient.accountId}: ${humanAmount} tokens → ${smallestUnitAmount} smallest units`
-        );
-        return {
-          ...recipient,
-          amount: smallestUnitAmount.toString()
-        };
-      });
-      const convertedInput = {
-        ...input,
-        recipients: convertedRecipients
-      };
-      this.logger.info(`Calling original airdrop tool with converted amounts`);
-      return await this.originalTool._call(convertedInput);
-    } catch (error) {
-      this.logger.error("Error in airdrop tool wrapper:", error);
-      throw error;
-    }
+  /**
+   * Creates and returns the service builder for account operations.
+   * 
+   * @returns BaseServiceBuilder instance configured for account operations
+   */
+  getServiceBuilder() {
+    return new AccountBuilder(this.hederaKit);
   }
-  convertToSmallestUnits(amount, decimals) {
-    return Math.floor(amount * Math.pow(10, decimals));
-  }
-  async getTokenInfo(tokenId) {
-    return await this.queryTokenInfo(tokenId);
-  }
-  async queryTokenInfo(tokenId) {
-    try {
-      this.logger.info("Querying token info using mirror node");
-      const mirrorNode = this.agentKit.mirrorNode;
-      if (!mirrorNode) {
-        this.logger.info(
-          "MirrorNode not found in agentKit, attempting to access via fetch"
-        );
-        const network = this.agentKit.network || "testnet";
-        const mirrorNodeUrl = network === "mainnet" ? "https://mainnet.mirrornode.hedera.com" : "https://testnet.mirrornode.hedera.com";
-        const response = await fetch(
-          `${mirrorNodeUrl}/api/v1/tokens/${tokenId}`
-        );
-        if (response.ok) {
-          const tokenData = await response.json();
-          const decimals = parseInt(String(tokenData.decimals || "0"));
-          this.logger.info(
-            `Token ${tokenId} found with ${decimals} decimals via API`
-          );
-          return { ...tokenData, decimals };
-        }
-      } else {
-        const tokenData = await mirrorNode.getTokenInfo(tokenId);
-        if (tokenData && typeof tokenData.decimals !== "undefined") {
-          const decimals = parseInt(tokenData.decimals.toString()) || 0;
-          this.logger.info(`Token ${tokenId} found with ${decimals} decimals`);
-          return { ...tokenData, decimals };
-        }
-      }
-      throw new Error(`Token data not found or missing decimals field`);
-    } catch (error) {
-      this.logger.warn(`Failed to query token info for ${tokenId}:`, error);
-      this.logger.info(
-        "Falling back to assumed 0 decimal places (smallest units)"
-      );
-      return { decimals: 0 };
-    }
+  /**
+   * 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 {
-  AirdropToolWrapper
+  TransferHbarTool
 };
 //# sourceMappingURL=index34.js.map

package/dist/esm/index34.js.map

@@ -1 +1 @@
-{"version":3,"file":"index34.js","sources":["../../src/plugins/hbar/AirdropToolWrapper.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HederaAgentKit } from 'hedera-agent-kit';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\ninterface TokenInfo {\n  decimals: number;\n  [key: string]: unknown;\n}\n\ninterface ToolWithCall {\n  _call(input: unknown): Promise<string>;\n}\n\ninterface AgentKitWithMirrorNode {\n  mirrorNode?: {\n    getTokenInfo(tokenId: string): Promise<TokenInfo>;\n  };\n  network: string;\n}\n\nexport class AirdropToolWrapper extends StructuredTool {\n  name = 'hedera-hts-airdrop-token';\n  description =\n    'Airdrops fungible tokens to multiple recipients. Automatically converts human-readable amounts to smallest units based on token decimals.';\n\n  schema = z.object({\n    tokenId: z\n      .string()\n      .describe('The ID of the fungible token to airdrop (e.g., \"0.0.yyyy\").'),\n    recipients: z\n      .array(\n        z.object({\n          accountId: z\n            .string()\n            .describe('Recipient account ID (e.g., \"0.0.xxxx\").'),\n          amount: z\n            .union([z.number(), z.string()])\n            .describe(\n              'Amount in human-readable format (e.g., \"10\" for 10 tokens).'\n            ),\n        })\n      )\n      .min(1)\n      .describe('Array of recipient objects, each with accountId and amount.'),\n    memo: z.string().optional().describe('Optional. Memo for the transaction.'),\n  });\n\n  private originalTool: StructuredTool & ToolWithCall;\n  private agentKit: HederaAgentKit & AgentKitWithMirrorNode;\n  private logger: Logger;\n\n  constructor(originalTool: StructuredTool, agentKit: unknown) {\n    super();\n    this.originalTool = originalTool as StructuredTool & ToolWithCall;\n    this.agentKit = agentKit as HederaAgentKit & AgentKitWithMirrorNode;\n    this.logger = new Logger({ module: 'AirdropToolWrapper' });\n  }\n\n  async _call(input: z.infer<typeof this.schema>): Promise<string> {\n    try {\n      this.logger.info(\n        `Processing airdrop request for token ${input.tokenId} with ${input.recipients.length} recipients`\n      );\n\n      const tokenInfo = await this.getTokenInfo(input.tokenId);\n      const decimals = tokenInfo.decimals || 0;\n\n      this.logger.info(`Token ${input.tokenId} has ${decimals} decimal places`);\n\n      const convertedRecipients = input.recipients.map((recipient) => {\n        const humanAmount =\n          typeof recipient.amount === 'string'\n            ? parseFloat(recipient.amount)\n            : recipient.amount;\n        const smallestUnitAmount = this.convertToSmallestUnits(\n          humanAmount,\n          decimals\n        );\n\n        this.logger.info(\n          `Converting amount for ${recipient.accountId}: ${humanAmount} tokens → ${smallestUnitAmount} smallest units`\n        );\n\n        return {\n          ...recipient,\n          amount: smallestUnitAmount.toString(),\n        };\n      });\n\n      const convertedInput = {\n        ...input,\n        recipients: convertedRecipients,\n      };\n\n      this.logger.info(`Calling original airdrop tool with converted amounts`);\n      return await this.originalTool._call(convertedInput);\n    } catch (error) {\n      this.logger.error('Error in airdrop tool wrapper:', error);\n      throw error;\n    }\n  }\n\n  private convertToSmallestUnits(amount: number, decimals: number): number {\n    return Math.floor(amount * Math.pow(10, decimals));\n  }\n\n  private async getTokenInfo(tokenId: string): Promise<TokenInfo> {\n    return await this.queryTokenInfo(tokenId);\n  }\n\n  private async queryTokenInfo(tokenId: string): Promise<TokenInfo> {\n    try {\n      this.logger.info('Querying token info using mirror node');\n      const mirrorNode = this.agentKit.mirrorNode;\n      if (!mirrorNode) {\n        this.logger.info(\n          'MirrorNode not found in agentKit, attempting to access via fetch'\n        );\n        const network = this.agentKit.network || 'testnet';\n        const mirrorNodeUrl =\n          network === 'mainnet'\n            ? 'https://mainnet.mirrornode.hedera.com'\n            : 'https://testnet.mirrornode.hedera.com';\n\n        const response = await fetch(\n          `${mirrorNodeUrl}/api/v1/tokens/${tokenId}`\n        );\n        if (response.ok) {\n          const tokenData = (await response.json()) as Record<string, unknown>;\n          const decimals = parseInt(String(tokenData.decimals || '0'));\n          this.logger.info(\n            `Token ${tokenId} found with ${decimals} decimals via API`\n          );\n          return { ...tokenData, decimals };\n        }\n      } else {\n        const tokenData = await mirrorNode.getTokenInfo(tokenId);\n\n        if (tokenData && typeof tokenData.decimals !== 'undefined') {\n          const decimals = parseInt(tokenData.decimals.toString()) || 0;\n          this.logger.info(`Token ${tokenId} found with ${decimals} decimals`);\n          return { ...tokenData, decimals };\n        }\n      }\n\n      throw new Error(`Token data not found or missing decimals field`);\n    } catch (error) {\n      this.logger.warn(`Failed to query token info for ${tokenId}:`, error);\n\n      this.logger.info(\n        'Falling back to assumed 0 decimal places (smallest units)'\n      );\n      return { decimals: 0 };\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index34.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;"}

package/dist/esm/index35.js

@@ -1,24 +1,106 @@
-const getSystemMessage = (accountId) => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.
-
-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
-- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations
-
-
-*** IMPORTANT CONTEXT ***
-You are currently operating as agent: ${accountId} on the Hedera Hashgraph
-When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId}
-
-*** CRITICAL ENTITY HANDLING RULES ***
-- When users refer to entities (tokens, topics, accounts) with pronouns like "it", "that", "the token/topic", etc., ALWAYS use the most recently created entity of that type
-- Entity IDs look like "0.0.XXXXXX" and are stored in memory after creation
-- NEVER use example or placeholder IDs like "0.0.123456" - always use actual created entity IDs
-- Account ID ${accountId} is NOT a token - tokens and accounts are different entities
-
- Remember the connection numbers when listing connections, as users might refer to them.`;
+import { StructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+import { Logger } from "@hashgraphonline/standards-sdk";
+class AirdropToolWrapper extends StructuredTool {
+  constructor(originalTool, agentKit) {
+    super();
+    this.name = "hedera-hts-airdrop-token";
+    this.description = "Airdrops fungible tokens to multiple recipients. Automatically converts human-readable amounts to smallest units based on token decimals.";
+    this.schema = z.object({
+      tokenId: z.string().describe('The ID of the fungible token to airdrop (e.g., "0.0.yyyy").'),
+      recipients: z.array(
+        z.object({
+          accountId: z.string().describe('Recipient account ID (e.g., "0.0.xxxx").'),
+          amount: z.union([z.number(), z.string()]).describe(
+            'Amount in human-readable format (e.g., "10" for 10 tokens).'
+          )
+        })
+      ).min(1).describe("Array of recipient objects, each with accountId and amount."),
+      memo: z.string().optional().describe("Optional. Memo for the transaction.")
+    });
+    this.originalTool = originalTool;
+    this.agentKit = agentKit;
+    this.logger = new Logger({ module: "AirdropToolWrapper" });
+  }
+  async _call(input) {
+    try {
+      this.logger.info(
+        `Processing airdrop request for token ${input.tokenId} with ${input.recipients.length} recipients`
+      );
+      const tokenInfo = await this.getTokenInfo(input.tokenId);
+      const decimals = tokenInfo.decimals || 0;
+      this.logger.info(`Token ${input.tokenId} has ${decimals} decimal places`);
+      const convertedRecipients = input.recipients.map((recipient) => {
+        const humanAmount = typeof recipient.amount === "string" ? parseFloat(recipient.amount) : recipient.amount;
+        const smallestUnitAmount = this.convertToSmallestUnits(
+          humanAmount,
+          decimals
+        );
+        this.logger.info(
+          `Converting amount for ${recipient.accountId}: ${humanAmount} tokens → ${smallestUnitAmount} smallest units`
+        );
+        return {
+          ...recipient,
+          amount: smallestUnitAmount.toString()
+        };
+      });
+      const convertedInput = {
+        ...input,
+        recipients: convertedRecipients
+      };
+      this.logger.info(`Calling original airdrop tool with converted amounts`);
+      return await this.originalTool._call(convertedInput);
+    } catch (error) {
+      this.logger.error("Error in airdrop tool wrapper:", error);
+      throw error;
+    }
+  }
+  convertToSmallestUnits(amount, decimals) {
+    return Math.floor(amount * Math.pow(10, decimals));
+  }
+  async getTokenInfo(tokenId) {
+    return await this.queryTokenInfo(tokenId);
+  }
+  async queryTokenInfo(tokenId) {
+    try {
+      this.logger.info("Querying token info using mirror node");
+      const mirrorNode = this.agentKit.mirrorNode;
+      if (!mirrorNode) {
+        this.logger.info(
+          "MirrorNode not found in agentKit, attempting to access via fetch"
+        );
+        const network = this.agentKit.network || "testnet";
+        const mirrorNodeUrl = network === "mainnet" ? "https://mainnet.mirrornode.hedera.com" : "https://testnet.mirrornode.hedera.com";
+        const response = await fetch(
+          `${mirrorNodeUrl}/api/v1/tokens/${tokenId}`
+        );
+        if (response.ok) {
+          const tokenData = await response.json();
+          const decimals = parseInt(String(tokenData.decimals || "0"));
+          this.logger.info(
+            `Token ${tokenId} found with ${decimals} decimals via API`
+          );
+          return { ...tokenData, decimals };
+        }
+      } else {
+        const tokenData = await mirrorNode.getTokenInfo(tokenId);
+        if (tokenData && typeof tokenData.decimals !== "undefined") {
+          const decimals = parseInt(tokenData.decimals.toString()) || 0;
+          this.logger.info(`Token ${tokenId} found with ${decimals} decimals`);
+          return { ...tokenData, decimals };
+        }
+      }
+      throw new Error(`Token data not found or missing decimals field`);
+    } catch (error) {
+      this.logger.warn(`Failed to query token info for ${tokenId}:`, error);
+      this.logger.info(
+        "Falling back to assumed 0 decimal places (smallest units)"
+      );
+      return { decimals: 0 };
+    }
+  }
+}
 export {
-  getSystemMessage
+  AirdropToolWrapper
 };
 //# sourceMappingURL=index35.js.map

package/dist/esm/index35.js.map

@@ -1 +1 @@
-{"version":3,"file":"index35.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (\n  accountId: string\n): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.\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- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations\n\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId} on the Hedera Hashgraph\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId}\n\n*** CRITICAL ENTITY HANDLING RULES ***\n- When users refer to entities (tokens, topics, accounts) with pronouns like \"it\", \"that\", \"the token/topic\", etc., ALWAYS use the most recently created entity of that type\n- Entity IDs look like \"0.0.XXXXXX\" and are stored in memory after creation\n- NEVER use example or placeholder IDs like \"0.0.123456\" - always use actual created entity IDs\n- Account ID ${accountId} is NOT a token - tokens and accounts are different entities\n\n Remember the connection numbers when listing connections, as users might refer to them.`;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAC9B,cACW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAU2B,SAAS;AAAA,gGAC+C,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAM1F,SAAS;AAAA;AAAA;"}
+{"version":3,"file":"index35.js","sources":["../../src/plugins/hbar/AirdropToolWrapper.ts"],"sourcesContent":["import { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HederaAgentKit } from 'hedera-agent-kit';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\ninterface TokenInfo {\n  decimals: number;\n  [key: string]: unknown;\n}\n\ninterface ToolWithCall {\n  _call(input: unknown): Promise<string>;\n}\n\ninterface AgentKitWithMirrorNode {\n  mirrorNode?: {\n    getTokenInfo(tokenId: string): Promise<TokenInfo>;\n  };\n  network: string;\n}\n\nexport class AirdropToolWrapper extends StructuredTool {\n  name = 'hedera-hts-airdrop-token';\n  description =\n    'Airdrops fungible tokens to multiple recipients. Automatically converts human-readable amounts to smallest units based on token decimals.';\n\n  schema = z.object({\n    tokenId: z\n      .string()\n      .describe('The ID of the fungible token to airdrop (e.g., \"0.0.yyyy\").'),\n    recipients: z\n      .array(\n        z.object({\n          accountId: z\n            .string()\n            .describe('Recipient account ID (e.g., \"0.0.xxxx\").'),\n          amount: z\n            .union([z.number(), z.string()])\n            .describe(\n              'Amount in human-readable format (e.g., \"10\" for 10 tokens).'\n            ),\n        })\n      )\n      .min(1)\n      .describe('Array of recipient objects, each with accountId and amount.'),\n    memo: z.string().optional().describe('Optional. Memo for the transaction.'),\n  });\n\n  private originalTool: StructuredTool & ToolWithCall;\n  private agentKit: HederaAgentKit & AgentKitWithMirrorNode;\n  private logger: Logger;\n\n  constructor(originalTool: StructuredTool, agentKit: unknown) {\n    super();\n    this.originalTool = originalTool as StructuredTool & ToolWithCall;\n    this.agentKit = agentKit as HederaAgentKit & AgentKitWithMirrorNode;\n    this.logger = new Logger({ module: 'AirdropToolWrapper' });\n  }\n\n  async _call(input: z.infer<typeof this.schema>): Promise<string> {\n    try {\n      this.logger.info(\n        `Processing airdrop request for token ${input.tokenId} with ${input.recipients.length} recipients`\n      );\n\n      const tokenInfo = await this.getTokenInfo(input.tokenId);\n      const decimals = tokenInfo.decimals || 0;\n\n      this.logger.info(`Token ${input.tokenId} has ${decimals} decimal places`);\n\n      const convertedRecipients = input.recipients.map((recipient) => {\n        const humanAmount =\n          typeof recipient.amount === 'string'\n            ? parseFloat(recipient.amount)\n            : recipient.amount;\n        const smallestUnitAmount = this.convertToSmallestUnits(\n          humanAmount,\n          decimals\n        );\n\n        this.logger.info(\n          `Converting amount for ${recipient.accountId}: ${humanAmount} tokens → ${smallestUnitAmount} smallest units`\n        );\n\n        return {\n          ...recipient,\n          amount: smallestUnitAmount.toString(),\n        };\n      });\n\n      const convertedInput = {\n        ...input,\n        recipients: convertedRecipients,\n      };\n\n      this.logger.info(`Calling original airdrop tool with converted amounts`);\n      return await this.originalTool._call(convertedInput);\n    } catch (error) {\n      this.logger.error('Error in airdrop tool wrapper:', error);\n      throw error;\n    }\n  }\n\n  private convertToSmallestUnits(amount: number, decimals: number): number {\n    return Math.floor(amount * Math.pow(10, decimals));\n  }\n\n  private async getTokenInfo(tokenId: string): Promise<TokenInfo> {\n    return await this.queryTokenInfo(tokenId);\n  }\n\n  private async queryTokenInfo(tokenId: string): Promise<TokenInfo> {\n    try {\n      this.logger.info('Querying token info using mirror node');\n      const mirrorNode = this.agentKit.mirrorNode;\n      if (!mirrorNode) {\n        this.logger.info(\n          'MirrorNode not found in agentKit, attempting to access via fetch'\n        );\n        const network = this.agentKit.network || 'testnet';\n        const mirrorNodeUrl =\n          network === 'mainnet'\n            ? 'https://mainnet.mirrornode.hedera.com'\n            : 'https://testnet.mirrornode.hedera.com';\n\n        const response = await fetch(\n          `${mirrorNodeUrl}/api/v1/tokens/${tokenId}`\n        );\n        if (response.ok) {\n          const tokenData = (await response.json()) as Record<string, unknown>;\n          const decimals = parseInt(String(tokenData.decimals || '0'));\n          this.logger.info(\n            `Token ${tokenId} found with ${decimals} decimals via API`\n          );\n          return { ...tokenData, decimals };\n        }\n      } else {\n        const tokenData = await mirrorNode.getTokenInfo(tokenId);\n\n        if (tokenData && typeof tokenData.decimals !== 'undefined') {\n          const decimals = parseInt(tokenData.decimals.toString()) || 0;\n          this.logger.info(`Token ${tokenId} found with ${decimals} decimals`);\n          return { ...tokenData, decimals };\n        }\n      }\n\n      throw new Error(`Token data not found or missing decimals field`);\n    } catch (error) {\n      this.logger.warn(`Failed to query token info for ${tokenId}:`, error);\n\n      this.logger.info(\n        'Falling back to assumed 0 decimal places (smallest units)'\n      );\n      return { decimals: 0 };\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAqBO,MAAM,2BAA2B,eAAe;AAAA,EA+BrD,YAAY,cAA8B,UAAmB;AAC3D,UAAA;AA/BF,SAAA,OAAO;AACP,SAAA,cACE;AAEF,SAAA,SAAS,EAAE,OAAO;AAAA,MAChB,SAAS,EACN,SACA,SAAS,6DAA6D;AAAA,MACzE,YAAY,EACT;AAAA,QACC,EAAE,OAAO;AAAA,UACP,WAAW,EACR,SACA,SAAS,0CAA0C;AAAA,UACtD,QAAQ,EACL,MAAM,CAAC,EAAE,OAAA,GAAU,EAAE,QAAQ,CAAC,EAC9B;AAAA,YACC;AAAA,UAAA;AAAA,QACF,CACH;AAAA,MAAA,EAEF,IAAI,CAAC,EACL,SAAS,6DAA6D;AAAA,MACzE,MAAM,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,qCAAqC;AAAA,IAAA,CAC3E;AAQC,SAAK,eAAe;AACpB,SAAK,WAAW;AAChB,SAAK,SAAS,IAAI,OAAO,EAAE,QAAQ,sBAAsB;AAAA,EAC3D;AAAA,EAEA,MAAM,MAAM,OAAqD;AAC/D,QAAI;AACF,WAAK,OAAO;AAAA,QACV,wCAAwC,MAAM,OAAO,SAAS,MAAM,WAAW,MAAM;AAAA,MAAA;AAGvF,YAAM,YAAY,MAAM,KAAK,aAAa,MAAM,OAAO;AACvD,YAAM,WAAW,UAAU,YAAY;AAEvC,WAAK,OAAO,KAAK,SAAS,MAAM,OAAO,QAAQ,QAAQ,iBAAiB;AAExE,YAAM,sBAAsB,MAAM,WAAW,IAAI,CAAC,cAAc;AAC9D,cAAM,cACJ,OAAO,UAAU,WAAW,WACxB,WAAW,UAAU,MAAM,IAC3B,UAAU;AAChB,cAAM,qBAAqB,KAAK;AAAA,UAC9B;AAAA,UACA;AAAA,QAAA;AAGF,aAAK,OAAO;AAAA,UACV,yBAAyB,UAAU,SAAS,KAAK,WAAW,aAAa,kBAAkB;AAAA,QAAA;AAG7F,eAAO;AAAA,UACL,GAAG;AAAA,UACH,QAAQ,mBAAmB,SAAA;AAAA,QAAS;AAAA,MAExC,CAAC;AAED,YAAM,iBAAiB;AAAA,QACrB,GAAG;AAAA,QACH,YAAY;AAAA,MAAA;AAGd,WAAK,OAAO,KAAK,sDAAsD;AACvE,aAAO,MAAM,KAAK,aAAa,MAAM,cAAc;AAAA,IACrD,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,kCAAkC,KAAK;AACzD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,uBAAuB,QAAgB,UAA0B;AACvE,WAAO,KAAK,MAAM,SAAS,KAAK,IAAI,IAAI,QAAQ,CAAC;AAAA,EACnD;AAAA,EAEA,MAAc,aAAa,SAAqC;AAC9D,WAAO,MAAM,KAAK,eAAe,OAAO;AAAA,EAC1C;AAAA,EAEA,MAAc,eAAe,SAAqC;AAChE,QAAI;AACF,WAAK,OAAO,KAAK,uCAAuC;AACxD,YAAM,aAAa,KAAK,SAAS;AACjC,UAAI,CAAC,YAAY;AACf,aAAK,OAAO;AAAA,UACV;AAAA,QAAA;AAEF,cAAM,UAAU,KAAK,SAAS,WAAW;AACzC,cAAM,gBACJ,YAAY,YACR,0CACA;AAEN,cAAM,WAAW,MAAM;AAAA,UACrB,GAAG,aAAa,kBAAkB,OAAO;AAAA,QAAA;AAE3C,YAAI,SAAS,IAAI;AACf,gBAAM,YAAa,MAAM,SAAS,KAAA;AAClC,gBAAM,WAAW,SAAS,OAAO,UAAU,YAAY,GAAG,CAAC;AAC3D,eAAK,OAAO;AAAA,YACV,SAAS,OAAO,eAAe,QAAQ;AAAA,UAAA;AAEzC,iBAAO,EAAE,GAAG,WAAW,SAAA;AAAA,QACzB;AAAA,MACF,OAAO;AACL,cAAM,YAAY,MAAM,WAAW,aAAa,OAAO;AAEvD,YAAI,aAAa,OAAO,UAAU,aAAa,aAAa;AAC1D,gBAAM,WAAW,SAAS,UAAU,SAAS,SAAA,CAAU,KAAK;AAC5D,eAAK,OAAO,KAAK,SAAS,OAAO,eAAe,QAAQ,WAAW;AACnE,iBAAO,EAAE,GAAG,WAAW,SAAA;AAAA,QACzB;AAAA,MACF;AAEA,YAAM,IAAI,MAAM,gDAAgD;AAAA,IAClE,SAAS,OAAO;AACd,WAAK,OAAO,KAAK,kCAAkC,OAAO,KAAK,KAAK;AAEpE,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAEF,aAAO,EAAE,UAAU,EAAA;AAAA,IACrB;AAAA,EACF;AACF;"}

package/dist/esm/index36.js

@@ -1,15 +1,24 @@
-import { EntityFormat } from "./index26.js";
-const ENTITY_PATTERNS = {
-  TOPIC_REFERENCE: "the topic",
-  TOKEN_REFERENCE: "the token"
-};
-({
-  TOPIC: EntityFormat.TOPIC_ID,
-  TOKEN: EntityFormat.TOKEN_ID,
-  ACCOUNT: EntityFormat.ACCOUNT_ID,
-  CONTRACT: EntityFormat.CONTRACT_ID
-});
+const getSystemMessage = (accountId) => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.
+
+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
+- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations
+
+
+*** IMPORTANT CONTEXT ***
+You are currently operating as agent: ${accountId} on the Hedera Hashgraph
+When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId}
+
+*** CRITICAL ENTITY HANDLING RULES ***
+- When users refer to entities (tokens, topics, accounts) with pronouns like "it", "that", "the token/topic", etc., ALWAYS use the most recently created entity of that type
+- Entity IDs look like "0.0.XXXXXX" and are stored in memory after creation
+- NEVER use example or placeholder IDs like "0.0.123456" - always use actual created entity IDs
+- Account ID ${accountId} is NOT a token - tokens and accounts are different entities
+
+ Remember the connection numbers when listing connections, as users might refer to them.`;
 export {
-  ENTITY_PATTERNS
+  getSystemMessage
 };
 //# sourceMappingURL=index36.js.map

package/dist/esm/index36.js.map

@@ -1 +1 @@
-{"version":3,"file":"index36.js","sources":["../../src/constants/entity-references.ts"],"sourcesContent":["/**\n * Common entity reference patterns used across the application\n */\nexport const ENTITY_PATTERNS = {\n  TOPIC_REFERENCE: 'the topic',\n  TOKEN_REFERENCE: 'the token',\n  ACCOUNT_REFERENCE: 'the account',\n  TRANSACTION_REFERENCE: 'the transaction',\n  CONTRACT_REFERENCE: 'the contract',\n} as const;\n\n/**\n * Entity type identifiers\n */\nimport { EntityFormat } from '../services/formatters/types';\n\nexport const ENTITY_TYPES = {\n  TOPIC: EntityFormat.TOPIC_ID,\n  TOKEN: EntityFormat.TOKEN_ID,\n  ACCOUNT: EntityFormat.ACCOUNT_ID,\n  TRANSACTION: 'transaction',\n  CONTRACT: EntityFormat.CONTRACT_ID,\n} as const;\n"],"names":[],"mappings":";AAGO,MAAM,kBAAkB;AAAA,EAC7B,iBAAiB;AAAA,EACjB,iBAAiB;AAInB;AAAA,CAO4B;AAAA,EAC1B,OAAO,aAAa;AAAA,EACpB,OAAO,aAAa;AAAA,EACpB,SAAS,aAAa;AAAA,EAEtB,UAAU,aAAa;AACzB;"}
+{"version":3,"file":"index36.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (\n  accountId: string\n): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, content inscription, and Hedera Hashgraph operations.\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- Hedera Token Service (HTS): creating tokens, transferring tokens, airdropping tokens, and managing token operations\n\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId} on the Hedera Hashgraph\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId}\n\n*** CRITICAL ENTITY HANDLING RULES ***\n- When users refer to entities (tokens, topics, accounts) with pronouns like \"it\", \"that\", \"the token/topic\", etc., ALWAYS use the most recently created entity of that type\n- Entity IDs look like \"0.0.XXXXXX\" and are stored in memory after creation\n- NEVER use example or placeholder IDs like \"0.0.123456\" - always use actual created entity IDs\n- Account ID ${accountId} is NOT a token - tokens and accounts are different entities\n\n Remember the connection numbers when listing connections, as users might refer to them.`;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAC9B,cACW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAU2B,SAAS;AAAA,gGAC+C,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,eAM1F,SAAS;AAAA;AAAA;"}