@hashgraphonline/conversational-agent 0.2.215 → 0.2.217

package/dist/esm/index36.js.map

@@ -1 +1 @@
-{"version":3,"file":"index36.js","sources":["../../src/runtime/wallet-bridge.ts"],"sourcesContent":["export type WalletNetwork = 'mainnet' | 'testnet';\n\nexport interface WalletStatus {\n  connected: boolean;\n  accountId?: string;\n  network?: WalletNetwork;\n}\n\nexport interface WalletExecutorResult {\n  transactionId: string;\n}\n\nexport interface StartInscriptionResult {\n  transactionBytes: string;\n  tx_id?: string;\n  topic_id?: string;\n  status?: string;\n  completed?: boolean;\n}\n\nexport interface WalletBridgeProvider {\n  status: () => Promise<WalletStatus> | WalletStatus;\n  executeBytes: (\n    base64: string,\n    network: WalletNetwork\n  ) => Promise<WalletExecutorResult>;\n  startInscription?: (\n    request: Record<string, unknown>,\n    network: WalletNetwork\n  ) => Promise<StartInscriptionResult>;\n  startHCS?: (\n    op: string,\n    request: Record<string, unknown>,\n    network: WalletNetwork\n  ) => Promise<{ transactionBytes: string }>;\n}\n\nlet providerRef: WalletBridgeProvider | null = null;\n\nexport function setWalletBridgeProvider(provider: WalletBridgeProvider): void {\n  providerRef = provider;\n}\n\nexport function getWalletBridgeProvider(): WalletBridgeProvider | null {\n  return providerRef;\n}\n"],"names":[],"mappings":"AAqCA,IAAI,cAA2C;AAExC,SAAS,wBAAwB,UAAsC;AAC5E,gBAAc;AAChB;AAEO,SAAS,0BAAuD;AACrE,SAAO;AACT;"}
+{"version":3,"file":"index36.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/index37.js

@@ -1,49 +1,12 @@
-import { z } from "zod";
-import { AccountBuilder } from "./index48.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
-    );
-  }
+let providerRef = null;
+function setWalletBridgeProvider(provider) {
+  providerRef = provider;
+}
+function getWalletBridgeProvider() {
+  return providerRef;
 }
 export {
-  TransferHbarTool
+  getWalletBridgeProvider,
+  setWalletBridgeProvider
 };
 //# sourceMappingURL=index37.js.map

package/dist/esm/index37.js.map

@@ -1 +1 @@
-{"version":3,"file":"index37.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":"index37.js","sources":["../../src/runtime/wallet-bridge.ts"],"sourcesContent":["export type WalletNetwork = 'mainnet' | 'testnet';\n\nexport interface WalletStatus {\n  connected: boolean;\n  accountId?: string;\n  network?: WalletNetwork;\n}\n\nexport interface WalletExecutorResult {\n  transactionId: string;\n}\n\nexport interface StartInscriptionResult {\n  transactionBytes: string;\n  tx_id?: string;\n  topic_id?: string;\n  status?: string;\n  completed?: boolean;\n}\n\nexport interface WalletBridgeProvider {\n  status: () => Promise<WalletStatus> | WalletStatus;\n  executeBytes: (\n    base64: string,\n    network: WalletNetwork\n  ) => Promise<WalletExecutorResult>;\n  startInscription?: (\n    request: Record<string, unknown>,\n    network: WalletNetwork\n  ) => Promise<StartInscriptionResult>;\n  startHCS?: (\n    op: string,\n    request: Record<string, unknown>,\n    network: WalletNetwork\n  ) => Promise<{ transactionBytes: string }>;\n}\n\nlet providerRef: WalletBridgeProvider | null = null;\n\nexport function setWalletBridgeProvider(provider: WalletBridgeProvider): void {\n  providerRef = provider;\n}\n\nexport function getWalletBridgeProvider(): WalletBridgeProvider | null {\n  return providerRef;\n}\n"],"names":[],"mappings":"AAqCA,IAAI,cAA2C;AAExC,SAAS,wBAAwB,UAAsC;AAC5E,gBAAc;AAChB;AAEO,SAAS,0BAAuD;AACrE,SAAO;AACT;"}

package/dist/esm/index38.js

@@ -1,110 +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 "./index61.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) {
-    try {
-      return await this.queryTokenInfo(tokenId);
-    } catch (error) {
-      throw error;
-    }
-  }
-  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=index38.js.map

package/dist/esm/index38.js.map

@@ -1 +1 @@
-{"version":3,"file":"index38.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    try {\n      return await this.queryTokenInfo(tokenId);\n    } catch (error) {\n      throw error;\n    }\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":"index38.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/index39.js

@@ -1,69 +1,110 @@
-import { AccountId, Client, PrivateKey, TransactionReceipt, PublicKey } from "@hashgraph/sdk";
-import { AbstractSigner } from "hedera-agent-kit";
-import { HederaMirrorNode, Logger } from "@hashgraphonline/standards-sdk";
-class BrowserSigner extends AbstractSigner {
-  getAccountId() {
-    return this.account;
-  }
-  getNetwork() {
-    return this.network;
-  }
-  constructor(accountId, network, executor) {
+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.account = AccountId.fromString(accountId);
-    this.network = network;
-    this.client = network === "mainnet" ? Client.forMainnet() : Client.forTestnet();
-    this.exec = executor ?? null;
-    this.ephemeralKey = PrivateKey.generateED25519();
+    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" });
   }
-  /**
-   * Returns an auto-generated ED25519 key for client wiring only.
-   * Do not use for signing; wallet performs signing in renderer.
-   */
-  getOperatorPrivateKey() {
-    return this.ephemeralKey;
+  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;
+    }
   }
-  getClient() {
-    return this.client;
+  convertToSmallestUnits(amount, decimals) {
+    return Math.floor(amount * Math.pow(10, decimals));
   }
-  async signAndExecuteTransaction(tx) {
-    if (!this.exec) {
-      throw new Error("BrowserSigner executor not available");
-    }
-    if (!tx.isFrozen()) {
-      await tx.freezeWith(this.client);
+  async getTokenInfo(tokenId) {
+    try {
+      return await this.queryTokenInfo(tokenId);
+    } catch (error) {
+      throw error;
     }
-    const base64 = Buffer.from(tx.toBytes()).toString("base64");
-    const { transactionId } = await this.exec(base64, this.network);
-    const mirror = new HederaMirrorNode(this.network);
-    const deadline = Date.now() + 6e4;
-    while (Date.now() < deadline) {
-      try {
-        const details = await mirror.getTransaction(transactionId);
-        if (details && details.result) {
-          return TransactionReceipt.fromBytes(
-            Buffer.from(details.result, "base64")
+  }
+  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 };
         }
-      } catch {
       }
-      await new Promise((r) => setTimeout(r, 1200));
+      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 };
     }
-    return TransactionReceipt.fromBytes(Buffer.from(""));
-  }
-  async getPublicKey() {
-    const network = this.network === "mainnet" ? "mainnet" : "testnet";
-    const mirror = new HederaMirrorNode(
-      network,
-      new Logger({ module: "BrowserSigner" })
-    );
-    const anyKey = await mirror.getPublicKey(this.account.toString());
-    const keyStr = typeof anyKey?.toString === "function" ? anyKey.toString() : String(anyKey);
-    return PublicKey.fromString(keyStr);
   }
 }
 export {
-  BrowserSigner,
-  BrowserSigner as default
+  AirdropToolWrapper
 };
 //# sourceMappingURL=index39.js.map

package/dist/esm/index39.js.map

@@ -1 +1 @@
-{"version":3,"file":"index39.js","sources":["../../src/signers/browser-signer.ts"],"sourcesContent":["import {\n  AccountId,\n  Client,\n  PrivateKey,\n  PublicKey,\n  Transaction,\n  TransactionReceipt,\n} from '@hashgraph/sdk';\nimport { AbstractSigner } from 'hedera-agent-kit';\nimport {\n  HederaMirrorNode,\n  Logger,\n  type NetworkType,\n} from '@hashgraphonline/standards-sdk';\n\n/**\n * BrowserSigner (bytes-only)\n *\n * Minimal signer compatible with HederaAgentKit in bytes/Provide Bytes mode.\n * - Does NOT hold a private key\n * - Cannot execute transactions; only provides identity and network context\n * - getOperatorPrivateKey() throws to signal absence of a local key\n */\nexport class BrowserSigner extends AbstractSigner {\n  private readonly account: AccountId;\n  private readonly network: 'mainnet' | 'testnet';\n  private readonly client: Client;\n  private readonly exec: ((\n    base64: string,\n    network: 'mainnet' | 'testnet'\n  ) => Promise<{ transactionId: string }>) | null;\n  private readonly ephemeralKey: PrivateKey;\n\n  getAccountId(): AccountId {\n    return this.account;\n  }\n\n  getNetwork(): 'mainnet' | 'testnet' {\n    return this.network;\n  }\n\n  constructor(\n    accountId: string,\n    network: 'mainnet' | 'testnet',\n    executor?: (\n      base64: string,\n      network: 'mainnet' | 'testnet'\n    ) => Promise<{ transactionId: string }>\n  ) {\n    super();\n    this.account = AccountId.fromString(accountId);\n    this.network = network;\n    this.client =\n      network === 'mainnet' ? Client.forMainnet() : Client.forTestnet();\n    this.exec = executor ?? null;\n    this.ephemeralKey = PrivateKey.generateED25519();\n  }\n\n  /**\n   * Returns an auto-generated ED25519 key for client wiring only.\n   * Do not use for signing; wallet performs signing in renderer.\n   */\n  getOperatorPrivateKey(): PrivateKey {\n    return this.ephemeralKey;\n  }\n\n  getClient(): Client {\n    return this.client;\n  }\n\n  async signAndExecuteTransaction(\n    tx: Transaction\n  ): Promise<TransactionReceipt> {\n    if (!this.exec) {\n      throw new Error('BrowserSigner executor not available');\n    }\n    if (!tx.isFrozen()) {\n      await tx.freezeWith(this.client);\n    }\n    const base64 = Buffer.from(tx.toBytes()).toString('base64');\n    const { transactionId } = await this.exec(base64, this.network);\n    const mirror = new HederaMirrorNode(this.network);\n    const deadline = Date.now() + 60000;\n    while (Date.now() < deadline) {\n      try {\n        const details = await mirror.getTransaction(transactionId);\n        if (details && details.result) {\n          return TransactionReceipt.fromBytes(\n            Buffer.from(details.result, 'base64')\n          );\n        }\n      } catch {}\n      await new Promise((r) => setTimeout(r, 1200));\n    }\n    return TransactionReceipt.fromBytes(Buffer.from(''));\n  }\n\n  override async getPublicKey(): Promise<PublicKey> {\n    const network: NetworkType =\n      this.network === 'mainnet' ? 'mainnet' : 'testnet';\n    const mirror = new HederaMirrorNode(\n      network,\n      new Logger({ module: 'BrowserSigner' })\n    );\n    const anyKey: any = await mirror.getPublicKey(this.account.toString());\n    const keyStr = typeof anyKey?.toString === 'function' ? anyKey.toString() : String(anyKey);\n    return PublicKey.fromString(keyStr);\n  }\n}\n\nexport default BrowserSigner;\n"],"names":[],"mappings":";;;AAuBO,MAAM,sBAAsB,eAAe;AAAA,EAUhD,eAA0B;AACxB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,aAAoC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YACE,WACA,SACA,UAIA;AACA,UAAA;AACA,SAAK,UAAU,UAAU,WAAW,SAAS;AAC7C,SAAK,UAAU;AACf,SAAK,SACH,YAAY,YAAY,OAAO,WAAA,IAAe,OAAO,WAAA;AACvD,SAAK,OAAO,YAAY;AACxB,SAAK,eAAe,WAAW,gBAAA;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,wBAAoC;AAClC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,0BACJ,IAC6B;AAC7B,QAAI,CAAC,KAAK,MAAM;AACd,YAAM,IAAI,MAAM,sCAAsC;AAAA,IACxD;AACA,QAAI,CAAC,GAAG,YAAY;AAClB,YAAM,GAAG,WAAW,KAAK,MAAM;AAAA,IACjC;AACA,UAAM,SAAS,OAAO,KAAK,GAAG,SAAS,EAAE,SAAS,QAAQ;AAC1D,UAAM,EAAE,kBAAkB,MAAM,KAAK,KAAK,QAAQ,KAAK,OAAO;AAC9D,UAAM,SAAS,IAAI,iBAAiB,KAAK,OAAO;AAChD,UAAM,WAAW,KAAK,IAAA,IAAQ;AAC9B,WAAO,KAAK,IAAA,IAAQ,UAAU;AAC5B,UAAI;AACF,cAAM,UAAU,MAAM,OAAO,eAAe,aAAa;AACzD,YAAI,WAAW,QAAQ,QAAQ;AAC7B,iBAAO,mBAAmB;AAAA,YACxB,OAAO,KAAK,QAAQ,QAAQ,QAAQ;AAAA,UAAA;AAAA,QAExC;AAAA,MACF,QAAQ;AAAA,MAAC;AACT,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAAA,IAC9C;AACA,WAAO,mBAAmB,UAAU,OAAO,KAAK,EAAE,CAAC;AAAA,EACrD;AAAA,EAEA,MAAe,eAAmC;AAChD,UAAM,UACJ,KAAK,YAAY,YAAY,YAAY;AAC3C,UAAM,SAAS,IAAI;AAAA,MACjB;AAAA,MACA,IAAI,OAAO,EAAE,QAAQ,iBAAiB;AAAA,IAAA;AAExC,UAAM,SAAc,MAAM,OAAO,aAAa,KAAK,QAAQ,UAAU;AACrE,UAAM,SAAS,OAAO,QAAQ,aAAa,aAAa,OAAO,SAAA,IAAa,OAAO,MAAM;AACzF,WAAO,UAAU,WAAW,MAAM;AAAA,EACpC;AACF;"}
+{"version":3,"file":"index39.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    try {\n      return await this.queryTokenInfo(tokenId);\n    } catch (error) {\n      throw error;\n    }\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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"}

package/dist/esm/index4.js

@@ -1,6 +1,6 @@
 import { BasePlugin } from "hedera-agent-kit";
 import { InscriberBuilder, InscribeFromUrlTool, InscribeFromFileTool, InscribeFromBufferTool, InscribeHashinalTool, RetrieveInscriptionTool } from "@hashgraphonline/standards-agent-kit";
-import { fieldGuidanceRegistry } from "./index13.js";
+import { fieldGuidanceRegistry } from "./index14.js";
 class InscribePlugin extends BasePlugin {
   constructor() {
     super(...arguments);