@hashgraphonline/conversational-agent 0.2.104 → 0.2.106

package/dist/esm/index37.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 "./index47.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=index37.js.map

package/dist/esm/index37.js.map

@@ -1 +1 @@
-{"version":3,"file":"index37.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":"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;"}

package/dist/esm/index38.js

@@ -1,24 +1,110 @@
-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) {
+    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 };
+    }
+  }
+}
 export {
-  getSystemMessage
+  AirdropToolWrapper
 };
 //# sourceMappingURL=index38.js.map

package/dist/esm/index38.js.map

@@ -1 +1 @@
-{"version":3,"file":"index38.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":"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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"}

package/dist/esm/index39.js

@@ -1,30 +1,69 @@
-const DEFAULT_CONTENT_REFERENCE_CONFIG = {
-  sizeThresholdBytes: 10 * 1024,
-  maxAgeMs: 60 * 60 * 1e3,
-  maxReferences: 100,
-  maxTotalStorageBytes: 100 * 1024 * 1024,
-  enableAutoCleanup: true,
-  cleanupIntervalMs: 5 * 60 * 1e3,
-  enablePersistence: false,
-  storageBackend: "memory",
-  cleanupPolicies: {
-    recent: { maxAgeMs: 30 * 60 * 1e3, priority: 1 },
-    userContent: { maxAgeMs: 2 * 60 * 60 * 1e3, priority: 2 },
-    agentGenerated: { maxAgeMs: 60 * 60 * 1e3, priority: 3 },
-    default: { maxAgeMs: 60 * 60 * 1e3, priority: 4 }
+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;
   }
-};
-class ContentReferenceError extends Error {
-  constructor(message, type, referenceId, suggestedActions) {
-    super(message);
-    this.type = type;
-    this.referenceId = referenceId;
-    this.suggestedActions = suggestedActions;
-    this.name = "ContentReferenceError";
+  getNetwork() {
+    return this.network;
+  }
+  constructor(accountId, network, executor) {
+    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();
+  }
+  /**
+   * Returns an auto-generated ED25519 key for client wiring only.
+   * Do not use for signing; wallet performs signing in renderer.
+   */
+  getOperatorPrivateKey() {
+    return this.ephemeralKey;
+  }
+  getClient() {
+    return this.client;
+  }
+  async signAndExecuteTransaction(tx) {
+    if (!this.exec) {
+      throw new Error("BrowserSigner executor not available");
+    }
+    if (!tx.isFrozen()) {
+      await tx.freezeWith(this.client);
+    }
+    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")
+          );
+        }
+      } catch {
+      }
+      await new Promise((r) => setTimeout(r, 1200));
+    }
+    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 {
-  ContentReferenceError,
-  DEFAULT_CONTENT_REFERENCE_CONFIG
+  BrowserSigner,
+  BrowserSigner as default
 };
 //# sourceMappingURL=index39.js.map

package/dist/esm/index39.js.map

@@ -1 +1 @@
-{"version":3,"file":"index39.js","sources":["../../src/types/content-reference.ts"],"sourcesContent":["/**\n * Content Reference System Types\n *\n * Shared interfaces for the Reference-Based Content System that handles\n * large content storage with unique reference IDs to optimize context window usage.\n */\n\n/**\n * Unique identifier for stored content references\n * Format: Cryptographically secure 32-byte identifier with base64url encoding\n */\nexport type ReferenceId = string;\n\n/**\n * Lifecycle state of a content reference\n */\nexport type ReferenceLifecycleState =\n  | 'active'\n  | 'expired'\n  | 'cleanup_pending'\n  | 'invalid';\n\n/**\n * Content types supported by the reference system\n */\nexport type ContentType =\n  | 'text'\n  | 'json'\n  | 'html'\n  | 'markdown'\n  | 'binary'\n  | 'unknown';\n\n/**\n * Sources that created the content reference\n */\nexport type ContentSource =\n  | 'mcp_tool'\n  | 'user_upload'\n  | 'agent_generated'\n  | 'system';\n\n/**\n * Metadata associated with stored content\n */\nexport interface ContentMetadata {\n  /** Content type classification */\n  contentType: ContentType;\n\n  /** MIME type of the original content */\n  mimeType?: string;\n\n  /** Size in bytes of the stored content */\n  sizeBytes: number;\n\n  /** When the content was originally stored */\n  createdAt: Date;\n\n  /** Last time the content was accessed via reference resolution */\n  lastAccessedAt: Date;\n\n  /** Source that created this content reference */\n  source: ContentSource;\n\n  /** Name of the MCP tool that generated the content (if applicable) */\n  mcpToolName?: string;\n\n  /** Original filename or suggested name for the content */\n  fileName?: string;\n\n  /** Number of times this reference has been resolved */\n  accessCount: number;\n\n  /** Tags for categorization and cleanup policies */\n  tags?: string[];\n\n  /** Custom metadata from the source */\n  customMetadata?: Record<string, unknown>;\n}\n\n/**\n * Core content reference object passed through agent context\n * Designed to be lightweight (<100 tokens) while providing enough\n * information for agent decision-making\n */\nexport interface ContentReference {\n  /** Unique identifier for resolving the content */\n  referenceId: ReferenceId;\n\n  /** Current lifecycle state */\n  state: ReferenceLifecycleState;\n\n  /** Brief description or preview of the content (max 200 chars) */\n  preview: string;\n\n  /** Essential metadata for agent decision-making */\n  metadata: Pick<\n    ContentMetadata,\n    'contentType' | 'sizeBytes' | 'source' | 'fileName' | 'mimeType'\n  >;\n\n  /** When this reference was created */\n  createdAt: Date;\n\n  /** Special format indicator for reference IDs in content */\n  readonly format: 'ref://{id}';\n}\n\n/**\n * Result of attempting to resolve a content reference\n */\nexport interface ReferenceResolutionResult {\n  /** Whether the resolution was successful */\n  success: boolean;\n\n  /** The resolved content if successful */\n  content?: Buffer;\n\n  /** Complete metadata if successful */\n  metadata?: ContentMetadata;\n\n  /** Error message if resolution failed */\n  error?: string;\n\n  /** Specific error type for targeted error handling */\n  errorType?:\n    | 'not_found'\n    | 'expired'\n    | 'corrupted'\n    | 'access_denied'\n    | 'system_error';\n\n  /** Suggested actions for recovery */\n  suggestedActions?: string[];\n}\n\n/**\n * Configuration for content reference storage and lifecycle\n */\nexport interface ContentReferenceConfig {\n  /** Size threshold above which content should be stored as references (default: 10KB) */\n  sizeThresholdBytes: number;\n\n  /** Maximum age for unused references before cleanup (default: 1 hour) */\n  maxAgeMs: number;\n\n  /** Maximum number of references to store simultaneously */\n  maxReferences: number;\n\n  /** Maximum total storage size for all references */\n  maxTotalStorageBytes: number;\n\n  /** Whether to enable automatic cleanup */\n  enableAutoCleanup: boolean;\n\n  /** Interval for cleanup checks in milliseconds */\n  cleanupIntervalMs: number;\n\n  /** Whether to persist references across restarts */\n  enablePersistence: boolean;\n\n  /** Storage backend configuration */\n  storageBackend: 'memory' | 'filesystem' | 'hybrid';\n\n  /** Cleanup policies for different content types */\n  cleanupPolicies: {\n    /** Policy for content marked as \"recent\" from MCP tools */\n    recent: { maxAgeMs: number; priority: number };\n\n    /** Policy for user-uploaded content */\n    userContent: { maxAgeMs: number; priority: number };\n\n    /** Policy for agent-generated content */\n    agentGenerated: { maxAgeMs: number; priority: number };\n\n    /** Default policy for other content */\n    default: { maxAgeMs: number; priority: number };\n  };\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONTENT_REFERENCE_CONFIG: ContentReferenceConfig = {\n  sizeThresholdBytes: 10 * 1024,\n  maxAgeMs: 60 * 60 * 1000,\n  maxReferences: 100,\n  maxTotalStorageBytes: 100 * 1024 * 1024,\n  enableAutoCleanup: true,\n  cleanupIntervalMs: 5 * 60 * 1000,\n  enablePersistence: false,\n  storageBackend: 'memory',\n  cleanupPolicies: {\n    recent: { maxAgeMs: 30 * 60 * 1000, priority: 1 },\n    userContent: { maxAgeMs: 2 * 60 * 60 * 1000, priority: 2 },\n    agentGenerated: { maxAgeMs: 60 * 60 * 1000, priority: 3 },\n    default: { maxAgeMs: 60 * 60 * 1000, priority: 4 },\n  },\n};\n\n/**\n * Statistics about content reference usage and storage\n */\nexport interface ContentReferenceStats {\n  /** Total number of active references */\n  activeReferences: number;\n\n  /** Total storage used by all references in bytes */\n  totalStorageBytes: number;\n\n  /** Number of references cleaned up in last cleanup cycle */\n  recentlyCleanedUp: number;\n\n  /** Number of successful reference resolutions since startup */\n  totalResolutions: number;\n\n  /** Number of failed resolution attempts */\n  failedResolutions: number;\n\n  /** Average content size in bytes */\n  averageContentSize: number;\n\n  /** Most frequently accessed reference ID */\n  mostAccessedReferenceId?: ReferenceId;\n\n  /** Storage utilization percentage */\n  storageUtilization: number;\n\n  /** Performance metrics */\n  performanceMetrics: {\n    /** Average time to create a reference in milliseconds */\n    averageCreationTimeMs: number;\n\n    /** Average time to resolve a reference in milliseconds */\n    averageResolutionTimeMs: number;\n\n    /** Average cleanup time in milliseconds */\n    averageCleanupTimeMs: number;\n  };\n}\n\n/**\n * Error types for content reference operations\n */\nexport class ContentReferenceError extends Error {\n  constructor(\n    message: string,\n    public readonly type: ReferenceResolutionResult['errorType'],\n    public readonly referenceId?: ReferenceId,\n    public readonly suggestedActions?: string[]\n  ) {\n    super(message);\n    this.name = 'ContentReferenceError';\n  }\n}\n\n/**\n * Interface for content reference storage implementations\n */\nexport interface ContentReferenceStore {\n  /**\n   * Store content and return a reference\n   */\n  storeContent(\n    content: Buffer,\n    metadata: Omit<\n      ContentMetadata,\n      'createdAt' | 'lastAccessedAt' | 'accessCount'\n    >\n  ): Promise<ContentReference>;\n\n  /**\n   * Resolve a reference to its content\n   */\n  resolveReference(\n    referenceId: ReferenceId\n  ): Promise<ReferenceResolutionResult>;\n\n  /**\n   * Check if a reference exists and is valid\n   */\n  hasReference(referenceId: ReferenceId): Promise<boolean>;\n\n  /**\n   * Mark a reference for cleanup\n   */\n  cleanupReference(referenceId: ReferenceId): Promise<boolean>;\n\n  /**\n   * Get current storage statistics\n   */\n  getStats(): Promise<ContentReferenceStats>;\n\n  /**\n   * Update configuration\n   */\n  updateConfig(config: Partial<ContentReferenceConfig>): Promise<void>;\n\n  /**\n   * Perform cleanup based on current policies\n   */\n  performCleanup(): Promise<{ cleanedUp: number; errors: string[] }>;\n\n  /**\n   * Dispose of resources\n   */\n  dispose(): Promise<void>;\n}\n"],"names":[],"mappings":"AAuLO,MAAM,mCAA2D;AAAA,EACtE,oBAAoB,KAAK;AAAA,EACzB,UAAU,KAAK,KAAK;AAAA,EACpB,eAAe;AAAA,EACf,sBAAsB,MAAM,OAAO;AAAA,EACnC,mBAAmB;AAAA,EACnB,mBAAmB,IAAI,KAAK;AAAA,EAC5B,mBAAmB;AAAA,EACnB,gBAAgB;AAAA,EAChB,iBAAiB;AAAA,IACf,QAAQ,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IAC9C,aAAa,EAAE,UAAU,IAAI,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACvD,gBAAgB,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,IACtD,SAAS,EAAE,UAAU,KAAK,KAAK,KAAM,UAAU,EAAA;AAAA,EAAE;AAErD;AA8CO,MAAM,8BAA8B,MAAM;AAAA,EAC/C,YACE,SACgB,MACA,aACA,kBAChB;AACA,UAAM,OAAO;AAJG,SAAA,OAAA;AACA,SAAA,cAAA;AACA,SAAA,mBAAA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;"}
+{"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    // Avoid cross-package PublicKey type incompatibility by reconstructing from string\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;AAGxC,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;"}

package/dist/esm/index4.js

@@ -1,5 +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";
 class InscribePlugin extends BasePlugin {
   constructor() {
     super(...arguments);
@@ -10,6 +11,7 @@ class InscribePlugin extends BasePlugin {
     this.author = "Hashgraph Online";
     this.namespace = "inscribe";
     this.tools = [];
+    this.providerId = null;
   }
   async initialize(context) {
     await super.initialize(context);
@@ -22,6 +24,40 @@ class InscribePlugin extends BasePlugin {
     }
     try {
       this.initializeTools();
+      try {
+        const provider = {
+          getFieldGuidance: (fieldName) => {
+            if (fieldName === "name") {
+              return {
+                suggestions: [
+                  "Sunset Landscape #42",
+                  "Digital Abstract Art"
+                ],
+                contextualHelpText: "Create a distinctive name that collectors will find appealing"
+              };
+            }
+            if (fieldName === "description") {
+              return {
+                fieldTypeOverride: "textarea",
+                suggestions: ["A beautiful piece representing..."]
+              };
+            }
+            return null;
+          },
+          getGlobalGuidance: () => ({
+            qualityStandards: [
+              "Use meaningful names that describe the artwork or content"
+            ]
+          })
+        };
+        this.providerId = fieldGuidanceRegistry.registerToolProvider(
+          /inscribe.*hashinal/i,
+          provider,
+          { id: "inscribe:hashinal:provider", priority: 1 }
+        );
+      } catch (e) {
+        this.context.logger.warn("Could not register Inscribe field guidance provider");
+      }
       this.context.logger.info(
         "Inscribe Plugin initialized successfully"
       );
@@ -71,6 +107,13 @@ class InscribePlugin extends BasePlugin {
   }
   async cleanup() {
     this.tools = [];
+    if (this.providerId) {
+      try {
+        fieldGuidanceRegistry.unregisterProvider(this.providerId);
+      } catch {
+      }
+      this.providerId = null;
+    }
     if (this.context?.logger) {
       this.context.logger.info("Inscribe Plugin cleaned up");
     }

package/dist/esm/index4.js.map

@@ -1 +1 @@
-{"version":3,"file":"index4.js","sources":["../../src/plugins/inscribe/InscribePlugin.ts"],"sourcesContent":["import {\n  GenericPluginContext,\n  HederaTool,\n  BasePlugin,\n  HederaAgentKit,\n} from 'hedera-agent-kit';\nimport {\n  InscriberBuilder,\n  InscribeFromUrlTool,\n  InscribeFromFileTool,\n  InscribeFromBufferTool,\n  InscribeHashinalTool,\n  RetrieveInscriptionTool,\n} from '@hashgraphonline/standards-agent-kit';\n\n/**\n * Plugin providing content inscription tools for Hedera\n */\nexport class InscribePlugin extends BasePlugin {\n  id = 'inscribe';\n  name = 'Inscribe Plugin';\n  description =\n    'Content inscription tools for storing data on Hedera Consensus Service';\n  version = '1.0.0';\n  author = 'Hashgraph Online';\n  namespace = 'inscribe';\n\n  private tools: HederaTool[] = [];\n\n  override async initialize(context: GenericPluginContext): Promise<void> {\n    await super.initialize(context);\n\n    const hederaKit = context.config.hederaKit as HederaAgentKit;\n    if (!hederaKit) {\n      this.context.logger.warn(\n        'HederaKit not found in context. Inscription tools will not be available.'\n      );\n      return;\n    }\n\n    try {\n      this.initializeTools();\n\n      this.context.logger.info(\n        'Inscribe Plugin initialized successfully'\n      );\n    } catch (error) {\n      this.context.logger.error(\n        'Failed to initialize Inscribe plugin:',\n        error\n      );\n    }\n  }\n\n  private initializeTools(): void {\n    const hederaKit = this.context.config.hederaKit as HederaAgentKit;\n    if (!hederaKit) {\n      throw new Error('HederaKit not found in context config');\n    }\n\n    const inscriberBuilder = new InscriberBuilder(hederaKit);\n\n    this.tools = [\n      new InscribeFromUrlTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new InscribeFromFileTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new InscribeFromBufferTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new InscribeHashinalTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new RetrieveInscriptionTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n    ];\n  }\n\n  getTools(): HederaTool[] {\n    return this.tools;\n  }\n\n  override async cleanup(): Promise<void> {\n    this.tools = [];\n    if (this.context?.logger) {\n      this.context.logger.info('Inscribe Plugin cleaned up');\n    }\n  }\n}"],"names":[],"mappings":";;AAkBO,MAAM,uBAAuB,WAAW;AAAA,EAAxC,cAAA;AAAA,UAAA,GAAA,SAAA;AACL,SAAA,KAAK;AACL,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,UAAU;AACV,SAAA,SAAS;AACT,SAAA,YAAY;AAEZ,SAAQ,QAAsB,CAAA;AAAA,EAAC;AAAA,EAE/B,MAAe,WAAW,SAA8C;AACtE,UAAM,MAAM,WAAW,OAAO;AAE9B,UAAM,YAAY,QAAQ,OAAO;AACjC,QAAI,CAAC,WAAW;AACd,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,MAAA;AAEF;AAAA,IACF;AAEA,QAAI;AACF,WAAK,gBAAA;AAEL,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,MAAA;AAAA,IAEJ,SAAS,OAAO;AACd,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AAAA,EAEQ,kBAAwB;AAC9B,UAAM,YAAY,KAAK,QAAQ,OAAO;AACtC,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AAEA,UAAM,mBAAmB,IAAI,iBAAiB,SAAS;AAEvD,SAAK,QAAQ;AAAA,MACX,IAAI,oBAAoB;AAAA,QACtB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,qBAAqB;AAAA,QACvB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,uBAAuB;AAAA,QACzB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,qBAAqB;AAAA,QACvB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,wBAAwB;AAAA,QAC1B;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,IAAA;AAAA,EAEL;AAAA,EAEA,WAAyB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAe,UAAyB;AACtC,SAAK,QAAQ,CAAA;AACb,QAAI,KAAK,SAAS,QAAQ;AACxB,WAAK,QAAQ,OAAO,KAAK,4BAA4B;AAAA,IACvD;AAAA,EACF;AACF;"}
+{"version":3,"file":"index4.js","sources":["../../src/plugins/inscribe/InscribePlugin.ts"],"sourcesContent":["import {\n  GenericPluginContext,\n  HederaTool,\n  BasePlugin,\n  HederaAgentKit,\n} from 'hedera-agent-kit';\nimport {\n  InscriberBuilder,\n  InscribeFromUrlTool,\n  InscribeFromFileTool,\n  InscribeFromBufferTool,\n  InscribeHashinalTool,\n  RetrieveInscriptionTool,\n} from '@hashgraphonline/standards-agent-kit';\nimport { fieldGuidanceRegistry, type FieldGuidance } from '../../forms/field-guidance-registry';\n\n/**\n * Plugin providing content inscription tools for Hedera\n */\nexport class InscribePlugin extends BasePlugin {\n  id = 'inscribe';\n  name = 'Inscribe Plugin';\n  description =\n    'Content inscription tools for storing data on Hedera Consensus Service';\n  version = '1.0.0';\n  author = 'Hashgraph Online';\n  namespace = 'inscribe';\n\n  private tools: any[] = [];\n  private providerId: string | null = null;\n\n  override async initialize(context: GenericPluginContext): Promise<void> {\n    await super.initialize(context);\n\n    const hederaKit = context.config.hederaKit as HederaAgentKit;\n    if (!hederaKit) {\n      this.context.logger.warn(\n        'HederaKit not found in context. Inscription tools will not be available.'\n      );\n      return;\n    }\n\n    try {\n      this.initializeTools();\n\n      // Register field guidance provider for inscribe hashinal tools\n      try {\n        const provider = {\n          getFieldGuidance: (fieldName: string): FieldGuidance | null => {\n            if (fieldName === 'name') {\n              return {\n                suggestions: [\n                  'Sunset Landscape #42',\n                  'Digital Abstract Art',\n                ],\n                contextualHelpText:\n                  'Create a distinctive name that collectors will find appealing',\n              };\n            }\n            if (fieldName === 'description') {\n              return {\n                fieldTypeOverride: 'textarea',\n                suggestions: ['A beautiful piece representing...'],\n              };\n            }\n            return null;\n          },\n          getGlobalGuidance: () => ({\n            qualityStandards: [\n              'Use meaningful names that describe the artwork or content',\n            ],\n          }),\n        };\n        this.providerId = fieldGuidanceRegistry.registerToolProvider(\n          /inscribe.*hashinal/i,\n          provider,\n          { id: 'inscribe:hashinal:provider', priority: 1 }\n        );\n      } catch (e) {\n        this.context.logger.warn('Could not register Inscribe field guidance provider');\n      }\n\n      this.context.logger.info(\n        'Inscribe Plugin initialized successfully'\n      );\n    } catch (error) {\n      this.context.logger.error(\n        'Failed to initialize Inscribe plugin:',\n        error\n      );\n    }\n  }\n\n  private initializeTools(): void {\n    const hederaKit = this.context.config.hederaKit as HederaAgentKit;\n    if (!hederaKit) {\n      throw new Error('HederaKit not found in context config');\n    }\n\n    const inscriberBuilder = new InscriberBuilder(hederaKit);\n\n    this.tools = [\n      new InscribeFromUrlTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new InscribeFromFileTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new InscribeFromBufferTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new InscribeHashinalTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n      new RetrieveInscriptionTool({\n        hederaKit: hederaKit,\n        inscriberBuilder: inscriberBuilder,\n        logger: this.context.logger,\n      }),\n    ];\n  }\n\n  getTools(): HederaTool[] {\n    return this.tools;\n  }\n\n  override async cleanup(): Promise<void> {\n    this.tools = [];\n    if (this.providerId) {\n      try {\n        fieldGuidanceRegistry.unregisterProvider(this.providerId);\n      } catch {}\n      this.providerId = null;\n    }\n    if (this.context?.logger) {\n      this.context.logger.info('Inscribe Plugin cleaned up');\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAmBO,MAAM,uBAAuB,WAAW;AAAA,EAAxC,cAAA;AAAA,UAAA,GAAA,SAAA;AACL,SAAA,KAAK;AACL,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,UAAU;AACV,SAAA,SAAS;AACT,SAAA,YAAY;AAEZ,SAAQ,QAAe,CAAA;AACvB,SAAQ,aAA4B;AAAA,EAAA;AAAA,EAEpC,MAAe,WAAW,SAA8C;AACtE,UAAM,MAAM,WAAW,OAAO;AAE9B,UAAM,YAAY,QAAQ,OAAO;AACjC,QAAI,CAAC,WAAW;AACd,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,MAAA;AAEF;AAAA,IACF;AAEA,QAAI;AACF,WAAK,gBAAA;AAGL,UAAI;AACF,cAAM,WAAW;AAAA,UACf,kBAAkB,CAAC,cAA4C;AAC7D,gBAAI,cAAc,QAAQ;AACxB,qBAAO;AAAA,gBACL,aAAa;AAAA,kBACX;AAAA,kBACA;AAAA,gBAAA;AAAA,gBAEF,oBACE;AAAA,cAAA;AAAA,YAEN;AACA,gBAAI,cAAc,eAAe;AAC/B,qBAAO;AAAA,gBACL,mBAAmB;AAAA,gBACnB,aAAa,CAAC,mCAAmC;AAAA,cAAA;AAAA,YAErD;AACA,mBAAO;AAAA,UACT;AAAA,UACA,mBAAmB,OAAO;AAAA,YACxB,kBAAkB;AAAA,cAChB;AAAA,YAAA;AAAA,UACF;AAAA,QACF;AAEF,aAAK,aAAa,sBAAsB;AAAA,UACtC;AAAA,UACA;AAAA,UACA,EAAE,IAAI,8BAA8B,UAAU,EAAA;AAAA,QAAE;AAAA,MAEpD,SAAS,GAAG;AACV,aAAK,QAAQ,OAAO,KAAK,qDAAqD;AAAA,MAChF;AAEA,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,MAAA;AAAA,IAEJ,SAAS,OAAO;AACd,WAAK,QAAQ,OAAO;AAAA,QAClB;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,EACF;AAAA,EAEQ,kBAAwB;AAC9B,UAAM,YAAY,KAAK,QAAQ,OAAO;AACtC,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,uCAAuC;AAAA,IACzD;AAEA,UAAM,mBAAmB,IAAI,iBAAiB,SAAS;AAEvD,SAAK,QAAQ;AAAA,MACX,IAAI,oBAAoB;AAAA,QACtB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,qBAAqB;AAAA,QACvB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,uBAAuB;AAAA,QACzB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,qBAAqB;AAAA,QACvB;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,MACD,IAAI,wBAAwB;AAAA,QAC1B;AAAA,QACA;AAAA,QACA,QAAQ,KAAK,QAAQ;AAAA,MAAA,CACtB;AAAA,IAAA;AAAA,EAEL;AAAA,EAEA,WAAyB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAe,UAAyB;AACtC,SAAK,QAAQ,CAAA;AACb,QAAI,KAAK,YAAY;AACnB,UAAI;AACF,8BAAsB,mBAAmB,KAAK,UAAU;AAAA,MAC1D,QAAQ;AAAA,MAAC;AACT,WAAK,aAAa;AAAA,IACpB;AACA,QAAI,KAAK,SAAS,QAAQ;AACxB,WAAK,QAAQ,OAAO,KAAK,4BAA4B;AAAA,IACvD;AAAA,EACF;AACF;"}