@hashgraphonline/standards-agent-kit 0.2.112 → 0.2.113

package/dist/es/standards-agent-kit.es7.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es7.js","sources":["../../src/tools/hcs10/RegisterAgentTool.ts"],"sourcesContent":["import { AIAgentCapability } from '@hashgraphonline/standards-sdk';\nimport { z } from 'zod';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\nimport {\n  HCS10Builder,\n  RegisterAgentParams,\n} from '../../builders/hcs10/hcs10-builder';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { RegisteredAgent } from '../../state/state-types';\nimport { NaturalLanguageMapper } from './natural-language-mapper';\n\nconst RegisterAgentZodSchema = z.object({\n  name: z\n    .string()\n    .min(1)\n    .max(50)\n    .describe('A unique name for the agent (1-50 characters)'),\n  description: z\n    .string()\n    .max(500)\n    .optional()\n    .describe('Optional bio description for the agent (max 500 characters)'),\n  alias: z\n    .string()\n    .optional()\n    .transform((val) => {\n      if (!val || val.toLowerCase().includes('random')) {\n        const timestamp = Date.now().toString(36);\n        const randomChars = Math.random().toString(36);\n        return `bot${timestamp}${randomChars}`;\n      }\n      return val;\n    })\n    .describe(\n      'Optional custom username/alias for the agent. Use \"random\" to generate a unique alias'\n    ),\n  type: z\n    .enum(['autonomous', 'manual'])\n    .optional()\n    .describe('Agent type (default: autonomous)'),\n  model: z\n    .string()\n    .optional()\n    .describe('AI model identifier (default: agent-model-2024)'),\n  capabilities: z\n    .union([\n      z.array(z.nativeEnum(AIAgentCapability)),\n      z.array(z.string()),\n      z.string(),\n    ])\n    .optional()\n    .transform((val) => {\n      if (!val) return undefined;\n      if (typeof val === 'string') {\n        return NaturalLanguageMapper.parseCapabilities(val);\n      }\n      if (Array.isArray(val) && val.length > 0 && typeof val[0] === 'string') {\n        return NaturalLanguageMapper.parseTagsOrCapabilities(val);\n      }\n      return val as AIAgentCapability[];\n    })\n    .describe('Agent capabilities - can be capability names (e.g. \"ai\", \"data processing\"), capability enum values, or array of either. Common values: \"ai\"/\"text\" (TEXT_GENERATION), \"data\" (DATA_INTEGRATION), \"analytics\" (TRANSACTION_ANALYTICS)'),\n  tags: z\n    .union([\n      z.array(z.string()),\n      z.string(),\n    ])\n    .optional()\n    .transform((val) => {\n      if (!val) return undefined;\n      if (typeof val === 'string') {\n        return NaturalLanguageMapper.parseCapabilities(val);\n      }\n      return NaturalLanguageMapper.parseTagsOrCapabilities(val);\n    })\n    .describe('Tags for the agent (alternative to capabilities) - e.g. \"ai\", \"data\", \"analytics\". Will be converted to appropriate capabilities.'),\n  creator: z.string().optional().describe('Creator attribution for the agent'),\n  socials: z\n    .record(\n      z.enum([\n        'twitter',\n        'github',\n        'discord',\n        'telegram',\n        'linkedin',\n        'youtube',\n        'website',\n        'x',\n      ] as const),\n      z.string()\n    )\n    .optional()\n    .describe(\n      'Social media links (e.g., {\"twitter\": \"@handle\", \"discord\": \"username\"})'\n    ),\n  properties: z\n    .record(z.unknown())\n    .optional()\n    .describe('Custom metadata properties for the agent'),\n  profilePicture: z\n    .union([\n      z.string().describe('URL or local file path to profile picture'),\n      z.object({\n        url: z.string().optional(),\n        path: z.string().optional(),\n        filename: z.string().optional(),\n      }),\n    ])\n    .optional()\n    .describe(\n      'Optional profile picture as URL, file path, or object with url/path/filename'\n    ),\n  existingProfilePictureTopicId: z\n    .string()\n    .optional()\n    .describe(\n      'Topic ID of an existing profile picture to reuse (e.g., 0.0.12345)'\n    ),\n  initialBalance: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional initial HBAR balance for the new agent account (will create new account if provided)'\n    ),\n  userAccountId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional account ID (e.g., 0.0.12345) to use as the agent account instead of creating a new one'\n    ),\n  hbarFee: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional HBAR fee amount to charge per message on the inbound topic'\n    ),\n  tokenFees: z\n    .array(\n      z.object({\n        amount: z.number().positive(),\n        tokenId: z.string(),\n      })\n    )\n    .optional()\n    .describe('Optional token fees to charge per message'),\n  exemptAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe('Optional account IDs to exempt from fees'),\n  setAsCurrent: z\n    .boolean()\n    .optional()\n    .describe('Whether to set as current agent (default: true)'),\n  persistence: z\n    .object({\n      prefix: z.string().optional(),\n    })\n    .optional()\n    .describe('Optional persistence configuration'),\n});\n\nexport class RegisterAgentTool extends BaseHCS10TransactionTool<\n  typeof RegisterAgentZodSchema\n> {\n  name = 'register_agent';\n  description =\n    'Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Supports natural language for capabilities/tags like \"ai\", \"data processing\", \"analytics\". Note: This tool requires multiple transactions and cannot be used in returnBytes mode. If alias is set to \"random\" or contains \"random\", a unique alias will be generated.';\n  specificInputSchema = RegisterAgentZodSchema;\n  private specificArgs: z.infer<typeof RegisterAgentZodSchema> | undefined;\n\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.neverScheduleThisTool = true;\n    this.requiresMultipleTransactions = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof RegisterAgentZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n    this.specificArgs = specificArgs;\n    const params: RegisterAgentParams = {\n      name: specificArgs.name,\n    };\n\n    if (specificArgs.description !== undefined) {\n      params.bio = specificArgs.description;\n    }\n    if (specificArgs.alias !== undefined) {\n      params.alias = specificArgs.alias;\n    } else {\n      const randomSuffix = Date.now().toString(36);\n      params.alias = `${specificArgs.name}${randomSuffix}`;\n    }\n    if (specificArgs.type !== undefined) {\n      params.type = specificArgs.type;\n    }\n    if (specificArgs.model !== undefined) {\n      params.model = specificArgs.model;\n    }\n    // Handle both capabilities and tags (tags takes precedence if both provided)\n    if (specificArgs.tags !== undefined) {\n      params.capabilities = specificArgs.tags as AIAgentCapability[];\n    } else if (specificArgs.capabilities !== undefined) {\n      params.capabilities = specificArgs.capabilities as AIAgentCapability[];\n    }\n    if (specificArgs.creator !== undefined) {\n      params.creator = specificArgs.creator;\n    }\n    if (specificArgs.socials !== undefined) {\n      params.socials = specificArgs.socials;\n    }\n    if (specificArgs.properties !== undefined) {\n      params.properties = specificArgs.properties;\n    }\n    if (specificArgs.profilePicture !== undefined) {\n      if (typeof specificArgs.profilePicture === 'string') {\n        params.profilePicture = specificArgs.profilePicture;\n      } else {\n        const profilePicObj: {\n          url?: string;\n          path?: string;\n          filename?: string;\n        } = {};\n        if (specificArgs.profilePicture.url !== undefined) {\n          profilePicObj.url = specificArgs.profilePicture.url;\n        }\n        if (specificArgs.profilePicture.path !== undefined) {\n          profilePicObj.path = specificArgs.profilePicture.path;\n        }\n        if (specificArgs.profilePicture.filename !== undefined) {\n          profilePicObj.filename = specificArgs.profilePicture.filename;\n        }\n        params.profilePicture = profilePicObj;\n      }\n    }\n    if (specificArgs.existingProfilePictureTopicId !== undefined) {\n      params.existingProfilePictureTopicId =\n        specificArgs.existingProfilePictureTopicId;\n    }\n    if (specificArgs.userAccountId !== undefined) {\n      params.userAccountId = specificArgs.userAccountId;\n    }\n    if (specificArgs.hbarFee !== undefined) {\n      params.hbarFee = specificArgs.hbarFee;\n    }\n    if (specificArgs.tokenFees !== undefined) {\n      params.tokenFees = specificArgs.tokenFees;\n    }\n    if (specificArgs.exemptAccountIds !== undefined) {\n      params.exemptAccountIds = specificArgs.exemptAccountIds;\n    }\n    if (specificArgs.initialBalance !== undefined) {\n      params.initialBalance = specificArgs.initialBalance;\n    }\n\n    await hcs10Builder.registerAgent(params);\n  }\n\n  /**\n   * Override _call to intercept the result and save agent to state if needed\n   */\n  protected override async _call(\n    args: z.infer<ReturnType<this['schema']>>,\n    runManager?: CallbackManagerForToolRun\n  ): Promise<string> {\n    const result = await super._call(args, runManager);\n\n    const shouldSetAsCurrent = this.specificArgs?.setAsCurrent !== false;\n\n    if (this.specificArgs && shouldSetAsCurrent) {\n      try {\n        const parsed = JSON.parse(result);\n        if (parsed.rawResult) {\n          this._handleRegistrationResult(parsed.rawResult);\n        } else if (parsed.state || parsed.accountId || parsed.metadata) {\n          this._handleRegistrationResult(parsed);\n        }\n      } catch (e) {}\n    }\n\n    return result;\n  }\n\n  /**\n   * Extract agent data from registration result and save to state\n   */\n  private _handleRegistrationResult(rawResult: any): void {\n    let accountId = rawResult.accountId || rawResult.metadata?.accountId;\n\n    if (!accountId && rawResult.state?.createdResources) {\n      const accountResource = rawResult.state.createdResources.find(\n        (r: string) => r.startsWith('account:')\n      );\n      if (accountResource) {\n        accountId = accountResource.split(':')[1];\n      }\n    }\n\n    const inboundTopicId =\n      rawResult.inboundTopicId ||\n      rawResult.metadata?.inboundTopicId ||\n      rawResult.state?.inboundTopicId;\n\n    const outboundTopicId =\n      rawResult.outboundTopicId ||\n      rawResult.metadata?.outboundTopicId ||\n      rawResult.state?.outboundTopicId;\n\n    const profileTopicId =\n      rawResult.profileTopicId ||\n      rawResult.metadata?.profileTopicId ||\n      rawResult.state?.profileTopicId;\n\n    const privateKey = rawResult.privateKey || rawResult.metadata?.privateKey;\n\n    if (accountId && inboundTopicId && outboundTopicId && this.specificArgs) {\n      const registeredAgent: RegisteredAgent = {\n        name: this.specificArgs.name,\n        accountId,\n        inboundTopicId,\n        outboundTopicId,\n        profileTopicId,\n        privateKey,\n      };\n\n      const hcs10Builder = this.getServiceBuilder() as HCS10Builder;\n      const stateManager = hcs10Builder.getStateManager();\n      if (stateManager) {\n        stateManager.setCurrentAgent(registeredAgent);\n\n        if (stateManager.persistAgentData) {\n          const prefix =\n            this.specificArgs.persistence?.prefix ||\n            this.specificArgs.name.toUpperCase().replace(/[^A-Z0-9]/g, '_');\n          stateManager\n            .persistAgentData(registeredAgent, {\n              type: 'env-file',\n              prefix: prefix,\n            })\n            .catch(() => {});\n        }\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es7.js","sources":["../../src/tools/hcs10/base-hcs10-tools.ts"],"sourcesContent":["import {\n  BaseHederaTransactionTool,\n  BaseHederaQueryTool,\n  BaseServiceBuilder,\n} from 'hedera-agent-kit';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport {\n  HCS10TransactionToolParams,\n  HCS10QueryToolParams,\n} from './hcs10-tool-params';\nimport { z } from 'zod';\n\n/**\n * Base class for HCS10 transaction tools\n */\nexport abstract class BaseHCS10TransactionTool<\n  T extends z.ZodObject<\n    z.ZodRawShape,\n    z.UnknownKeysParam,\n    z.ZodTypeAny\n  > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaTransactionTool<T> {\n  protected hcs10Builder: HCS10Builder;\n  namespace = 'hcs10' as const;\n\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.hcs10Builder = params.hcs10Builder;\n  }\n\n  /**\n   * Override to return the HCS10Builder\n   */\n  protected getServiceBuilder(): BaseServiceBuilder {\n    return this.hcs10Builder;\n  }\n}\n\n/**\n * Base class for HCS10 query tools\n */\nexport abstract class BaseHCS10QueryTool<\n  T extends z.ZodObject<\n    z.ZodRawShape,\n    z.UnknownKeysParam,\n    z.ZodTypeAny\n  > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaQueryTool<T> {\n  protected hcs10Builder: HCS10Builder;\n  namespace = 'hcs10' as const;\n\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n    this.hcs10Builder = params.hcs10Builder;\n  }\n\n  /**\n   * Override to return the HCS10Builder\n   */\n  protected getServiceBuilder(): BaseServiceBuilder {\n    return this.hcs10Builder;\n  }\n}\n"],"names":[],"mappings":";AAeO,MAAe,iCAMZ,0BAA6B;AAAA,EAIrC,YAAY,QAAoC;AAC9C,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,eAAe,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AACF;AAKO,MAAe,2BAMZ,oBAAuB;AAAA,EAI/B,YAAY,QAA8B;AACxC,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,eAAe,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AACF;"}

package/dist/es/standards-agent-kit.es8.js

@@ -1,89 +1,240 @@
+import { AIAgentCapability } from "@hashgraphonline/standards-sdk";
 import { z } from "zod";
-import { BaseHCS10TransactionTool } from "./standards-agent-kit.es6.js";
-const SendMessageToConnectionZodSchema = z.object({
-  targetIdentifier: z.string().optional().describe(
-    "The request key (e.g., 'req-1:0.0.6155171@0.0.6154875'), account ID (e.g., 0.0.12345) of the target agent, OR the connection number (e.g., '1', '2') from the 'list_connections' tool. Request key is most deterministic."
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es7.js";
+import { NaturalLanguageMapper } from "./standards-agent-kit.es19.js";
+const RegisterAgentZodSchema = z.object({
+  name: z.string().min(1).max(50).describe("A unique name for the agent (1-50 characters)"),
+  description: z.string().max(500).optional().describe("Optional bio description for the agent (max 500 characters)"),
+  alias: z.string().optional().transform((val) => {
+    if (!val || val.toLowerCase().includes("random")) {
+      const timestamp = Date.now().toString(36);
+      const randomChars = Math.random().toString(36);
+      return `bot${timestamp}${randomChars}`;
+    }
+    return val;
+  }).describe(
+    'Optional custom username/alias for the agent. Use "random" to generate a unique alias'
+  ),
+  type: z.enum(["autonomous", "manual"]).optional().describe("Agent type (default: autonomous)"),
+  model: z.string().optional().describe("AI model identifier (default: agent-model-2024)"),
+  capabilities: z.union([
+    z.array(z.nativeEnum(AIAgentCapability)),
+    z.array(z.string()),
+    z.string()
+  ]).optional().transform((val) => {
+    if (!val) return void 0;
+    if (typeof val === "string") {
+      return NaturalLanguageMapper.parseCapabilities(val);
+    }
+    if (Array.isArray(val) && val.length > 0 && typeof val[0] === "string") {
+      return NaturalLanguageMapper.parseTagsOrCapabilities(val);
+    }
+    return val;
+  }).describe('Agent capabilities - can be capability names (e.g. "ai", "data processing"), capability enum values, or array of either. Common values: "ai"/"text" (TEXT_GENERATION), "data" (DATA_INTEGRATION), "analytics" (TRANSACTION_ANALYTICS)'),
+  tags: z.union([
+    z.array(z.string()),
+    z.string()
+  ]).optional().transform((val) => {
+    if (!val) return void 0;
+    if (typeof val === "string") {
+      return NaturalLanguageMapper.parseCapabilities(val);
+    }
+    return NaturalLanguageMapper.parseTagsOrCapabilities(val);
+  }).describe('Tags for the agent (alternative to capabilities) - e.g. "ai", "data", "analytics". Will be converted to appropriate capabilities.'),
+  creator: z.string().optional().describe("Creator attribution for the agent"),
+  socials: z.record(
+    z.enum([
+      "twitter",
+      "github",
+      "discord",
+      "telegram",
+      "linkedin",
+      "youtube",
+      "website",
+      "x"
+    ]),
+    z.string()
+  ).optional().describe(
+    'Social media links (e.g., {"twitter": "@handle", "discord": "username"})'
+  ),
+  properties: z.record(z.unknown()).optional().describe("Custom metadata properties for the agent"),
+  profilePicture: z.union([
+    z.string().describe("URL or local file path to profile picture"),
+    z.object({
+      url: z.string().optional(),
+      path: z.string().optional(),
+      filename: z.string().optional()
+    })
+  ]).optional().describe(
+    "Optional profile picture as URL, file path, or object with url/path/filename"
+  ),
+  existingProfilePictureTopicId: z.string().optional().describe(
+    "Topic ID of an existing profile picture to reuse (e.g., 0.0.12345)"
+  ),
+  initialBalance: z.number().positive().optional().describe(
+    "Optional initial HBAR balance for the new agent account (will create new account if provided)"
+  ),
+  userAccountId: z.string().optional().describe(
+    "Optional account ID (e.g., 0.0.12345) to use as the agent account instead of creating a new one"
   ),
-  connectionId: z.string().optional().describe(
-    "The connection number (e.g., '1', '2') from the 'list_connections' tool."
+  hbarFee: z.number().positive().optional().describe(
+    "Optional HBAR fee amount to charge per message on the inbound topic"
   ),
-  agentId: z.string().optional().describe("The account ID (e.g., 0.0.12345) of the target agent."),
-  message: z.string().describe("The text message content to send."),
-  disableMonitoring: z.boolean().optional().default(false)
+  tokenFees: z.array(
+    z.object({
+      amount: z.number().positive(),
+      tokenId: z.string()
+    })
+  ).optional().describe("Optional token fees to charge per message"),
+  exemptAccountIds: z.array(z.string()).optional().describe("Optional account IDs to exempt from fees"),
+  setAsCurrent: z.boolean().optional().describe("Whether to set as current agent (default: true)"),
+  persistence: z.object({
+    prefix: z.string().optional()
+  }).optional().describe("Optional persistence configuration")
 });
-class SendMessageToConnectionTool extends BaseHCS10TransactionTool {
+class RegisterAgentTool extends BaseHCS10TransactionTool {
   constructor(params) {
     super(params);
-    this.name = "send_message_to_connection";
-    this.description = "Use this to send a message to an agent you already have an active connection with. Provide the target agent's account ID (e.g., 0.0.12345) and your message. If no active connection exists, this will fail - use initiate_connection instead to create a new connection first.";
-    this.specificInputSchema = SendMessageToConnectionZodSchema;
-    this.requiresMultipleTransactions = true;
+    this.name = "register_agent";
+    this.description = 'Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Supports natural language for capabilities/tags like "ai", "data processing", "analytics". Note: This tool requires multiple transactions and cannot be used in returnBytes mode. If alias is set to "random" or contains "random", a unique alias will be generated.';
+    this.specificInputSchema = RegisterAgentZodSchema;
     this.neverScheduleThisTool = true;
+    this.requiresMultipleTransactions = true;
   }
   async callBuilderMethod(builder, specificArgs) {
     const hcs10Builder = builder;
-    const targetIdentifier = specificArgs.targetIdentifier || specificArgs.agentId || specificArgs.connectionId;
-    if (!targetIdentifier) {
-      throw new Error(
-        "Either targetIdentifier, connectionId, or agentId must be provided"
-      );
+    this.specificArgs = specificArgs;
+    const params = {
+      name: specificArgs.name
+    };
+    if (specificArgs.description !== void 0) {
+      params.bio = specificArgs.description;
+    }
+    if (specificArgs.alias !== void 0) {
+      params.alias = specificArgs.alias;
+    } else {
+      const randomSuffix = Date.now().toString(36);
+      params.alias = `${specificArgs.name}${randomSuffix}`;
+    }
+    if (specificArgs.type !== void 0) {
+      params.type = specificArgs.type;
+    }
+    if (specificArgs.model !== void 0) {
+      params.model = specificArgs.model;
+    }
+    if (specificArgs.tags !== void 0) {
+      params.capabilities = specificArgs.tags;
+    } else if (specificArgs.capabilities !== void 0) {
+      params.capabilities = specificArgs.capabilities;
+    }
+    if (specificArgs.creator !== void 0) {
+      params.creator = specificArgs.creator;
     }
-    const stateManager = hcs10Builder.getStateManager();
-    if (stateManager) {
-      const connectionsManager = stateManager.getConnectionsManager();
-      if (connectionsManager) {
-        try {
-          const currentAgent = stateManager.getCurrentAgent();
-          if (currentAgent && currentAgent.accountId) {
-            await connectionsManager.fetchConnectionData(
-              currentAgent.accountId
-            );
-          }
-        } catch (error) {
-          console.debug("Could not refresh connections:", error);
+    if (specificArgs.socials !== void 0) {
+      params.socials = specificArgs.socials;
+    }
+    if (specificArgs.properties !== void 0) {
+      params.properties = specificArgs.properties;
+    }
+    if (specificArgs.profilePicture !== void 0) {
+      if (typeof specificArgs.profilePicture === "string") {
+        params.profilePicture = specificArgs.profilePicture;
+      } else {
+        const profilePicObj = {};
+        if (specificArgs.profilePicture.url !== void 0) {
+          profilePicObj.url = specificArgs.profilePicture.url;
+        }
+        if (specificArgs.profilePicture.path !== void 0) {
+          profilePicObj.path = specificArgs.profilePicture.path;
         }
+        if (specificArgs.profilePicture.filename !== void 0) {
+          profilePicObj.filename = specificArgs.profilePicture.filename;
+        }
+        params.profilePicture = profilePicObj;
       }
-      if (targetIdentifier.match(/^\d+$/)) {
-        const connections = stateManager.listConnections();
-        const connectionIndex = parseInt(targetIdentifier) - 1;
-        const establishedConnections = connections.filter(
-          (conn) => conn.status === "established" && !conn.isPending && !conn.needsConfirmation
-        );
-        if (connectionIndex >= 0 && connectionIndex < establishedConnections.length) {
-          const selectedConnection = establishedConnections[connectionIndex];
-          if (selectedConnection && selectedConnection.connectionTopicId) {
-            await hcs10Builder.sendMessageToConnection({
-              targetIdentifier: selectedConnection.connectionTopicId,
-              message: specificArgs.message,
-              disableMonitoring: specificArgs.disableMonitoring
-            });
-            return;
-          }
+    }
+    if (specificArgs.existingProfilePictureTopicId !== void 0) {
+      params.existingProfilePictureTopicId = specificArgs.existingProfilePictureTopicId;
+    }
+    if (specificArgs.userAccountId !== void 0) {
+      params.userAccountId = specificArgs.userAccountId;
+    }
+    if (specificArgs.hbarFee !== void 0) {
+      params.hbarFee = specificArgs.hbarFee;
+    }
+    if (specificArgs.tokenFees !== void 0) {
+      params.tokenFees = specificArgs.tokenFees;
+    }
+    if (specificArgs.exemptAccountIds !== void 0) {
+      params.exemptAccountIds = specificArgs.exemptAccountIds;
+    }
+    if (specificArgs.initialBalance !== void 0) {
+      params.initialBalance = specificArgs.initialBalance;
+    }
+    await hcs10Builder.registerAgent(params);
+  }
+  /**
+   * Override _call to intercept the result and save agent to state if needed
+   */
+  async _call(args, runManager) {
+    const result = await super._call(args, runManager);
+    const shouldSetAsCurrent = this.specificArgs?.setAsCurrent !== false;
+    if (this.specificArgs && shouldSetAsCurrent) {
+      try {
+        const parsed = JSON.parse(result);
+        if (parsed.rawResult) {
+          this._handleRegistrationResult(parsed.rawResult);
+        } else if (parsed.state || parsed.accountId || parsed.metadata) {
+          this._handleRegistrationResult(parsed);
         }
+      } catch (e) {
+      }
+    }
+    return result;
+  }
+  /**
+   * Extract agent data from registration result and save to state
+   */
+  _handleRegistrationResult(rawResult) {
+    let accountId = rawResult.accountId || rawResult.metadata?.accountId;
+    if (!accountId && rawResult.state?.createdResources) {
+      const accountResource = rawResult.state.createdResources.find(
+        (r) => r.startsWith("account:")
+      );
+      if (accountResource) {
+        accountId = accountResource.split(":")[1];
       }
-      if (targetIdentifier.match(/^\d+\.\d+\.\d+$/)) {
-        const connections = stateManager.listConnections();
-        const establishedConnection = connections.find(
-          (conn) => (conn.targetAccountId === targetIdentifier || conn.targetAccountId === `0.0.${targetIdentifier}`) && conn.status === "established" && !conn.isPending && !conn.needsConfirmation
-        );
-        if (establishedConnection && establishedConnection.connectionTopicId) {
-          await hcs10Builder.sendMessageToConnection({
-            targetIdentifier: establishedConnection.connectionTopicId,
-            message: specificArgs.message,
-            disableMonitoring: specificArgs.disableMonitoring
+    }
+    const inboundTopicId = rawResult.inboundTopicId || rawResult.metadata?.inboundTopicId || rawResult.state?.inboundTopicId;
+    const outboundTopicId = rawResult.outboundTopicId || rawResult.metadata?.outboundTopicId || rawResult.state?.outboundTopicId;
+    const profileTopicId = rawResult.profileTopicId || rawResult.metadata?.profileTopicId || rawResult.state?.profileTopicId;
+    const privateKey = rawResult.privateKey || rawResult.metadata?.privateKey;
+    if (accountId && inboundTopicId && outboundTopicId && this.specificArgs) {
+      const registeredAgent = {
+        name: this.specificArgs.name,
+        accountId,
+        inboundTopicId,
+        outboundTopicId,
+        profileTopicId,
+        privateKey
+      };
+      const hcs10Builder = this.getServiceBuilder();
+      const stateManager = hcs10Builder.getStateManager();
+      if (stateManager) {
+        stateManager.setCurrentAgent(registeredAgent);
+        if (stateManager.persistAgentData) {
+          const prefix = this.specificArgs.persistence?.prefix || this.specificArgs.name.toUpperCase().replace(/[^A-Z0-9]/g, "_");
+          stateManager.persistAgentData(registeredAgent, {
+            type: "env-file",
+            prefix
+          }).catch(() => {
           });
-          return;
         }
       }
     }
-    await hcs10Builder.sendMessageToConnection({
-      targetIdentifier,
-      message: specificArgs.message,
-      disableMonitoring: specificArgs.disableMonitoring
-    });
   }
 }
 export {
-  SendMessageToConnectionTool
+  RegisterAgentTool
 };
 //# sourceMappingURL=standards-agent-kit.es8.js.map

package/dist/es/standards-agent-kit.es8.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es8.js","sources":["../../src/tools/hcs10/SendMessageToConnectionTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\n\nconst SendMessageToConnectionZodSchema = z.object({\n  targetIdentifier: z\n    .string()\n    .optional()\n    .describe(\n      \"The request key (e.g., 'req-1:0.0.6155171@0.0.6154875'), account ID (e.g., 0.0.12345) of the target agent, OR the connection number (e.g., '1', '2') from the 'list_connections' tool. Request key is most deterministic.\"\n    ),\n  connectionId: z\n    .string()\n    .optional()\n    .describe(\n      \"The connection number (e.g., '1', '2') from the 'list_connections' tool.\"\n    ),\n  agentId: z\n    .string()\n    .optional()\n    .describe('The account ID (e.g., 0.0.12345) of the target agent.'),\n  message: z.string().describe('The text message content to send.'),\n  disableMonitoring: z.boolean().optional().default(false),\n});\n\n/**\n * A tool to send a message to an agent over an established HCS-10 connection.\n */\nexport class SendMessageToConnectionTool extends BaseHCS10TransactionTool<\n  typeof SendMessageToConnectionZodSchema\n> {\n  name = 'send_message_to_connection';\n  description =\n    \"Use this to send a message to an agent you already have an active connection with. Provide the target agent's account ID (e.g., 0.0.12345) and your message. If no active connection exists, this will fail - use initiate_connection instead to create a new connection first.\";\n  specificInputSchema = SendMessageToConnectionZodSchema;\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.requiresMultipleTransactions = true;\n    this.neverScheduleThisTool = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof SendMessageToConnectionZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n\n    const targetIdentifier =\n      specificArgs.targetIdentifier ||\n      specificArgs.agentId ||\n      specificArgs.connectionId;\n\n    if (!targetIdentifier) {\n      throw new Error(\n        'Either targetIdentifier, connectionId, or agentId must be provided'\n      );\n    }\n\n    const stateManager = hcs10Builder.getStateManager();\n    if (stateManager) {\n      const connectionsManager = stateManager.getConnectionsManager();\n      if (connectionsManager) {\n        try {\n          const currentAgent = stateManager.getCurrentAgent();\n          if (currentAgent && currentAgent.accountId) {\n            await connectionsManager.fetchConnectionData(\n              currentAgent.accountId\n            );\n          }\n        } catch (error) {\n          console.debug('Could not refresh connections:', error);\n        }\n      }\n\n      if (targetIdentifier.match(/^\\d+$/)) {\n        const connections = stateManager.listConnections();\n        const connectionIndex = parseInt(targetIdentifier) - 1; // Connection numbers are 1-based\n\n        const establishedConnections = connections.filter(\n          (conn) =>\n            conn.status === 'established' &&\n            !conn.isPending &&\n            !conn.needsConfirmation\n        );\n\n        if (\n          connectionIndex >= 0 &&\n          connectionIndex < establishedConnections.length\n        ) {\n          const selectedConnection = establishedConnections[connectionIndex];\n          if (selectedConnection && selectedConnection.connectionTopicId) {\n            await hcs10Builder.sendMessageToConnection({\n              targetIdentifier: selectedConnection.connectionTopicId,\n              message: specificArgs.message,\n              disableMonitoring: specificArgs.disableMonitoring,\n            });\n            return;\n          }\n        }\n      }\n\n      if (targetIdentifier.match(/^\\d+\\.\\d+\\.\\d+$/)) {\n        const connections = stateManager.listConnections();\n        const establishedConnection = connections.find(\n          (conn) =>\n            (conn.targetAccountId === targetIdentifier ||\n              conn.targetAccountId === `0.0.${targetIdentifier}`) &&\n            conn.status === 'established' &&\n            !conn.isPending &&\n            !conn.needsConfirmation\n        );\n\n        if (establishedConnection && establishedConnection.connectionTopicId) {\n          await hcs10Builder.sendMessageToConnection({\n            targetIdentifier: establishedConnection.connectionTopicId,\n            message: specificArgs.message,\n            disableMonitoring: specificArgs.disableMonitoring,\n          });\n          return;\n        }\n      }\n    }\n\n    await hcs10Builder.sendMessageToConnection({\n      targetIdentifier: targetIdentifier,\n      message: specificArgs.message,\n      disableMonitoring: specificArgs.disableMonitoring,\n    });\n  }\n}\n"],"names":[],"mappings":";;AAMA,MAAM,mCAAmC,EAAE,OAAO;AAAA,EAChD,kBAAkB,EACf,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,cAAc,EACX,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,SAAS,EACN,OAAA,EACA,SAAA,EACA,SAAS,uDAAuD;AAAA,EACnE,SAAS,EAAE,SAAS,SAAS,mCAAmC;AAAA,EAChE,mBAAmB,EAAE,QAAA,EAAU,SAAA,EAAW,QAAQ,KAAK;AACzD,CAAC;AAKM,MAAM,oCAAoC,yBAE/C;AAAA,EAKA,YAAY,QAAoC;AAC9C,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAGpB,SAAK,+BAA+B;AACpC,SAAK,wBAAwB;AAAA,EAC/B;AAAA,EAEA,MAAgB,kBACd,SACA,cACe;AACf,UAAM,eAAe;AAErB,UAAM,mBACJ,aAAa,oBACb,aAAa,WACb,aAAa;AAEf,QAAI,CAAC,kBAAkB;AACrB,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,UAAM,eAAe,aAAa,gBAAA;AAClC,QAAI,cAAc;AAChB,YAAM,qBAAqB,aAAa,sBAAA;AACxC,UAAI,oBAAoB;AACtB,YAAI;AACF,gBAAM,eAAe,aAAa,gBAAA;AAClC,cAAI,gBAAgB,aAAa,WAAW;AAC1C,kBAAM,mBAAmB;AAAA,cACvB,aAAa;AAAA,YAAA;AAAA,UAEjB;AAAA,QACF,SAAS,OAAO;AACd,kBAAQ,MAAM,kCAAkC,KAAK;AAAA,QACvD;AAAA,MACF;AAEA,UAAI,iBAAiB,MAAM,OAAO,GAAG;AACnC,cAAM,cAAc,aAAa,gBAAA;AACjC,cAAM,kBAAkB,SAAS,gBAAgB,IAAI;AAErD,cAAM,yBAAyB,YAAY;AAAA,UACzC,CAAC,SACC,KAAK,WAAW,iBAChB,CAAC,KAAK,aACN,CAAC,KAAK;AAAA,QAAA;AAGV,YACE,mBAAmB,KACnB,kBAAkB,uBAAuB,QACzC;AACA,gBAAM,qBAAqB,uBAAuB,eAAe;AACjE,cAAI,sBAAsB,mBAAmB,mBAAmB;AAC9D,kBAAM,aAAa,wBAAwB;AAAA,cACzC,kBAAkB,mBAAmB;AAAA,cACrC,SAAS,aAAa;AAAA,cACtB,mBAAmB,aAAa;AAAA,YAAA,CACjC;AACD;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,UAAI,iBAAiB,MAAM,iBAAiB,GAAG;AAC7C,cAAM,cAAc,aAAa,gBAAA;AACjC,cAAM,wBAAwB,YAAY;AAAA,UACxC,CAAC,UACE,KAAK,oBAAoB,oBACxB,KAAK,oBAAoB,OAAO,gBAAgB,OAClD,KAAK,WAAW,iBAChB,CAAC,KAAK,aACN,CAAC,KAAK;AAAA,QAAA;AAGV,YAAI,yBAAyB,sBAAsB,mBAAmB;AACpE,gBAAM,aAAa,wBAAwB;AAAA,YACzC,kBAAkB,sBAAsB;AAAA,YACxC,SAAS,aAAa;AAAA,YACtB,mBAAmB,aAAa;AAAA,UAAA,CACjC;AACD;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,aAAa,wBAAwB;AAAA,MACzC;AAAA,MACA,SAAS,aAAa;AAAA,MACtB,mBAAmB,aAAa;AAAA,IAAA,CACjC;AAAA,EACH;AACF;"}
+{"version":3,"file":"standards-agent-kit.es8.js","sources":["../../src/tools/hcs10/RegisterAgentTool.ts"],"sourcesContent":["import { AIAgentCapability } from '@hashgraphonline/standards-sdk';\nimport { z } from 'zod';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\nimport { CallbackManagerForToolRun } from '@langchain/core/callbacks/manager';\nimport {\n  HCS10Builder,\n  RegisterAgentParams,\n} from '../../builders/hcs10/hcs10-builder';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { RegisteredAgent } from '../../state/state-types';\nimport { NaturalLanguageMapper } from './natural-language-mapper';\n\nconst RegisterAgentZodSchema = z.object({\n  name: z\n    .string()\n    .min(1)\n    .max(50)\n    .describe('A unique name for the agent (1-50 characters)'),\n  description: z\n    .string()\n    .max(500)\n    .optional()\n    .describe('Optional bio description for the agent (max 500 characters)'),\n  alias: z\n    .string()\n    .optional()\n    .transform((val) => {\n      if (!val || val.toLowerCase().includes('random')) {\n        const timestamp = Date.now().toString(36);\n        const randomChars = Math.random().toString(36);\n        return `bot${timestamp}${randomChars}`;\n      }\n      return val;\n    })\n    .describe(\n      'Optional custom username/alias for the agent. Use \"random\" to generate a unique alias'\n    ),\n  type: z\n    .enum(['autonomous', 'manual'])\n    .optional()\n    .describe('Agent type (default: autonomous)'),\n  model: z\n    .string()\n    .optional()\n    .describe('AI model identifier (default: agent-model-2024)'),\n  capabilities: z\n    .union([\n      z.array(z.nativeEnum(AIAgentCapability)),\n      z.array(z.string()),\n      z.string(),\n    ])\n    .optional()\n    .transform((val) => {\n      if (!val) return undefined;\n      if (typeof val === 'string') {\n        return NaturalLanguageMapper.parseCapabilities(val);\n      }\n      if (Array.isArray(val) && val.length > 0 && typeof val[0] === 'string') {\n        return NaturalLanguageMapper.parseTagsOrCapabilities(val);\n      }\n      return val as AIAgentCapability[];\n    })\n    .describe('Agent capabilities - can be capability names (e.g. \"ai\", \"data processing\"), capability enum values, or array of either. Common values: \"ai\"/\"text\" (TEXT_GENERATION), \"data\" (DATA_INTEGRATION), \"analytics\" (TRANSACTION_ANALYTICS)'),\n  tags: z\n    .union([\n      z.array(z.string()),\n      z.string(),\n    ])\n    .optional()\n    .transform((val) => {\n      if (!val) return undefined;\n      if (typeof val === 'string') {\n        return NaturalLanguageMapper.parseCapabilities(val);\n      }\n      return NaturalLanguageMapper.parseTagsOrCapabilities(val);\n    })\n    .describe('Tags for the agent (alternative to capabilities) - e.g. \"ai\", \"data\", \"analytics\". Will be converted to appropriate capabilities.'),\n  creator: z.string().optional().describe('Creator attribution for the agent'),\n  socials: z\n    .record(\n      z.enum([\n        'twitter',\n        'github',\n        'discord',\n        'telegram',\n        'linkedin',\n        'youtube',\n        'website',\n        'x',\n      ] as const),\n      z.string()\n    )\n    .optional()\n    .describe(\n      'Social media links (e.g., {\"twitter\": \"@handle\", \"discord\": \"username\"})'\n    ),\n  properties: z\n    .record(z.unknown())\n    .optional()\n    .describe('Custom metadata properties for the agent'),\n  profilePicture: z\n    .union([\n      z.string().describe('URL or local file path to profile picture'),\n      z.object({\n        url: z.string().optional(),\n        path: z.string().optional(),\n        filename: z.string().optional(),\n      }),\n    ])\n    .optional()\n    .describe(\n      'Optional profile picture as URL, file path, or object with url/path/filename'\n    ),\n  existingProfilePictureTopicId: z\n    .string()\n    .optional()\n    .describe(\n      'Topic ID of an existing profile picture to reuse (e.g., 0.0.12345)'\n    ),\n  initialBalance: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional initial HBAR balance for the new agent account (will create new account if provided)'\n    ),\n  userAccountId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional account ID (e.g., 0.0.12345) to use as the agent account instead of creating a new one'\n    ),\n  hbarFee: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional HBAR fee amount to charge per message on the inbound topic'\n    ),\n  tokenFees: z\n    .array(\n      z.object({\n        amount: z.number().positive(),\n        tokenId: z.string(),\n      })\n    )\n    .optional()\n    .describe('Optional token fees to charge per message'),\n  exemptAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe('Optional account IDs to exempt from fees'),\n  setAsCurrent: z\n    .boolean()\n    .optional()\n    .describe('Whether to set as current agent (default: true)'),\n  persistence: z\n    .object({\n      prefix: z.string().optional(),\n    })\n    .optional()\n    .describe('Optional persistence configuration'),\n});\n\nexport class RegisterAgentTool extends BaseHCS10TransactionTool<\n  typeof RegisterAgentZodSchema\n> {\n  name = 'register_agent';\n  description =\n    'Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Supports natural language for capabilities/tags like \"ai\", \"data processing\", \"analytics\". Note: This tool requires multiple transactions and cannot be used in returnBytes mode. If alias is set to \"random\" or contains \"random\", a unique alias will be generated.';\n  specificInputSchema = RegisterAgentZodSchema;\n  private specificArgs: z.infer<typeof RegisterAgentZodSchema> | undefined;\n\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.neverScheduleThisTool = true;\n    this.requiresMultipleTransactions = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof RegisterAgentZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n    this.specificArgs = specificArgs;\n    const params: RegisterAgentParams = {\n      name: specificArgs.name,\n    };\n\n    if (specificArgs.description !== undefined) {\n      params.bio = specificArgs.description;\n    }\n    if (specificArgs.alias !== undefined) {\n      params.alias = specificArgs.alias;\n    } else {\n      const randomSuffix = Date.now().toString(36);\n      params.alias = `${specificArgs.name}${randomSuffix}`;\n    }\n    if (specificArgs.type !== undefined) {\n      params.type = specificArgs.type;\n    }\n    if (specificArgs.model !== undefined) {\n      params.model = specificArgs.model;\n    }\n    // Handle both capabilities and tags (tags takes precedence if both provided)\n    if (specificArgs.tags !== undefined) {\n      params.capabilities = specificArgs.tags as AIAgentCapability[];\n    } else if (specificArgs.capabilities !== undefined) {\n      params.capabilities = specificArgs.capabilities as AIAgentCapability[];\n    }\n    if (specificArgs.creator !== undefined) {\n      params.creator = specificArgs.creator;\n    }\n    if (specificArgs.socials !== undefined) {\n      params.socials = specificArgs.socials;\n    }\n    if (specificArgs.properties !== undefined) {\n      params.properties = specificArgs.properties;\n    }\n    if (specificArgs.profilePicture !== undefined) {\n      if (typeof specificArgs.profilePicture === 'string') {\n        params.profilePicture = specificArgs.profilePicture;\n      } else {\n        const profilePicObj: {\n          url?: string;\n          path?: string;\n          filename?: string;\n        } = {};\n        if (specificArgs.profilePicture.url !== undefined) {\n          profilePicObj.url = specificArgs.profilePicture.url;\n        }\n        if (specificArgs.profilePicture.path !== undefined) {\n          profilePicObj.path = specificArgs.profilePicture.path;\n        }\n        if (specificArgs.profilePicture.filename !== undefined) {\n          profilePicObj.filename = specificArgs.profilePicture.filename;\n        }\n        params.profilePicture = profilePicObj;\n      }\n    }\n    if (specificArgs.existingProfilePictureTopicId !== undefined) {\n      params.existingProfilePictureTopicId =\n        specificArgs.existingProfilePictureTopicId;\n    }\n    if (specificArgs.userAccountId !== undefined) {\n      params.userAccountId = specificArgs.userAccountId;\n    }\n    if (specificArgs.hbarFee !== undefined) {\n      params.hbarFee = specificArgs.hbarFee;\n    }\n    if (specificArgs.tokenFees !== undefined) {\n      params.tokenFees = specificArgs.tokenFees;\n    }\n    if (specificArgs.exemptAccountIds !== undefined) {\n      params.exemptAccountIds = specificArgs.exemptAccountIds;\n    }\n    if (specificArgs.initialBalance !== undefined) {\n      params.initialBalance = specificArgs.initialBalance;\n    }\n\n    await hcs10Builder.registerAgent(params);\n  }\n\n  /**\n   * Override _call to intercept the result and save agent to state if needed\n   */\n  protected override async _call(\n    args: z.infer<ReturnType<this['schema']>>,\n    runManager?: CallbackManagerForToolRun\n  ): Promise<string> {\n    const result = await super._call(args, runManager);\n\n    const shouldSetAsCurrent = this.specificArgs?.setAsCurrent !== false;\n\n    if (this.specificArgs && shouldSetAsCurrent) {\n      try {\n        const parsed = JSON.parse(result);\n        if (parsed.rawResult) {\n          this._handleRegistrationResult(parsed.rawResult);\n        } else if (parsed.state || parsed.accountId || parsed.metadata) {\n          this._handleRegistrationResult(parsed);\n        }\n      } catch (e) {}\n    }\n\n    return result;\n  }\n\n  /**\n   * Extract agent data from registration result and save to state\n   */\n  private _handleRegistrationResult(rawResult: any): void {\n    let accountId = rawResult.accountId || rawResult.metadata?.accountId;\n\n    if (!accountId && rawResult.state?.createdResources) {\n      const accountResource = rawResult.state.createdResources.find(\n        (r: string) => r.startsWith('account:')\n      );\n      if (accountResource) {\n        accountId = accountResource.split(':')[1];\n      }\n    }\n\n    const inboundTopicId =\n      rawResult.inboundTopicId ||\n      rawResult.metadata?.inboundTopicId ||\n      rawResult.state?.inboundTopicId;\n\n    const outboundTopicId =\n      rawResult.outboundTopicId ||\n      rawResult.metadata?.outboundTopicId ||\n      rawResult.state?.outboundTopicId;\n\n    const profileTopicId =\n      rawResult.profileTopicId ||\n      rawResult.metadata?.profileTopicId ||\n      rawResult.state?.profileTopicId;\n\n    const privateKey = rawResult.privateKey || rawResult.metadata?.privateKey;\n\n    if (accountId && inboundTopicId && outboundTopicId && this.specificArgs) {\n      const registeredAgent: RegisteredAgent = {\n        name: this.specificArgs.name,\n        accountId,\n        inboundTopicId,\n        outboundTopicId,\n        profileTopicId,\n        privateKey,\n      };\n\n      const hcs10Builder = this.getServiceBuilder() as HCS10Builder;\n      const stateManager = hcs10Builder.getStateManager();\n      if (stateManager) {\n        stateManager.setCurrentAgent(registeredAgent);\n\n        if (stateManager.persistAgentData) {\n          const prefix =\n            this.specificArgs.persistence?.prefix ||\n            this.specificArgs.name.toUpperCase().replace(/[^A-Z0-9]/g, '_');\n          stateManager\n            .persistAgentData(registeredAgent, {\n              type: 'env-file',\n              prefix: prefix,\n            })\n            .catch(() => {});\n        }\n      }\n    }\n  }\n}\n"],"names":[],"mappings":";;;;AAaA,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,MAAM,EACH,OAAA,EACA,IAAI,CAAC,EACL,IAAI,EAAE,EACN,SAAS,+CAA+C;AAAA,EAC3D,aAAa,EACV,OAAA,EACA,IAAI,GAAG,EACP,SAAA,EACA,SAAS,6DAA6D;AAAA,EACzE,OAAO,EACJ,OAAA,EACA,WACA,UAAU,CAAC,QAAQ;AAClB,QAAI,CAAC,OAAO,IAAI,cAAc,SAAS,QAAQ,GAAG;AAChD,YAAM,YAAY,KAAK,IAAA,EAAM,SAAS,EAAE;AACxC,YAAM,cAAc,KAAK,OAAA,EAAS,SAAS,EAAE;AAC7C,aAAO,MAAM,SAAS,GAAG,WAAW;AAAA,IACtC;AACA,WAAO;AAAA,EACT,CAAC,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,MAAM,EACH,KAAK,CAAC,cAAc,QAAQ,CAAC,EAC7B,SAAA,EACA,SAAS,kCAAkC;AAAA,EAC9C,OAAO,EACJ,OAAA,EACA,SAAA,EACA,SAAS,iDAAiD;AAAA,EAC7D,cAAc,EACX,MAAM;AAAA,IACL,EAAE,MAAM,EAAE,WAAW,iBAAiB,CAAC;AAAA,IACvC,EAAE,MAAM,EAAE,QAAQ;AAAA,IAClB,EAAE,OAAA;AAAA,EAAO,CACV,EACA,SAAA,EACA,UAAU,CAAC,QAAQ;AAClB,QAAI,CAAC,IAAK,QAAO;AACjB,QAAI,OAAO,QAAQ,UAAU;AAC3B,aAAO,sBAAsB,kBAAkB,GAAG;AAAA,IACpD;AACA,QAAI,MAAM,QAAQ,GAAG,KAAK,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,MAAM,UAAU;AACtE,aAAO,sBAAsB,wBAAwB,GAAG;AAAA,IAC1D;AACA,WAAO;AAAA,EACT,CAAC,EACA,SAAS,uOAAuO;AAAA,EACnP,MAAM,EACH,MAAM;AAAA,IACL,EAAE,MAAM,EAAE,QAAQ;AAAA,IAClB,EAAE,OAAA;AAAA,EAAO,CACV,EACA,SAAA,EACA,UAAU,CAAC,QAAQ;AAClB,QAAI,CAAC,IAAK,QAAO;AACjB,QAAI,OAAO,QAAQ,UAAU;AAC3B,aAAO,sBAAsB,kBAAkB,GAAG;AAAA,IACpD;AACA,WAAO,sBAAsB,wBAAwB,GAAG;AAAA,EAC1D,CAAC,EACA,SAAS,mIAAmI;AAAA,EAC/I,SAAS,EAAE,OAAA,EAAS,SAAA,EAAW,SAAS,mCAAmC;AAAA,EAC3E,SAAS,EACN;AAAA,IACC,EAAE,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACQ;AAAA,IACV,EAAE,OAAA;AAAA,EAAO,EAEV,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,YAAY,EACT,OAAO,EAAE,QAAA,CAAS,EAClB,SAAA,EACA,SAAS,0CAA0C;AAAA,EACtD,gBAAgB,EACb,MAAM;AAAA,IACL,EAAE,OAAA,EAAS,SAAS,2CAA2C;AAAA,IAC/D,EAAE,OAAO;AAAA,MACP,KAAK,EAAE,OAAA,EAAS,SAAA;AAAA,MAChB,MAAM,EAAE,OAAA,EAAS,SAAA;AAAA,MACjB,UAAU,EAAE,OAAA,EAAS,SAAA;AAAA,IAAS,CAC/B;AAAA,EAAA,CACF,EACA,SAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,+BAA+B,EAC5B,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,gBAAgB,EACb,OAAA,EACA,SAAA,EACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,eAAe,EACZ,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,SAAS,EACN,OAAA,EACA,SAAA,EACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,WAAW,EACR;AAAA,IACC,EAAE,OAAO;AAAA,MACP,QAAQ,EAAE,OAAA,EAAS,SAAA;AAAA,MACnB,SAAS,EAAE,OAAA;AAAA,IAAO,CACnB;AAAA,EAAA,EAEF,SAAA,EACA,SAAS,2CAA2C;AAAA,EACvD,kBAAkB,EACf,MAAM,EAAE,OAAA,CAAQ,EAChB,SAAA,EACA,SAAS,0CAA0C;AAAA,EACtD,cAAc,EACX,QAAA,EACA,SAAA,EACA,SAAS,iDAAiD;AAAA,EAC7D,aAAa,EACV,OAAO;AAAA,IACN,QAAQ,EAAE,OAAA,EAAS,SAAA;AAAA,EAAS,CAC7B,EACA,WACA,SAAS,oCAAoC;AAClD,CAAC;AAEM,MAAM,0BAA0B,yBAErC;AAAA,EAOA,YAAY,QAAoC;AAC9C,UAAM,MAAM;AAPd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAKpB,SAAK,wBAAwB;AAC7B,SAAK,+BAA+B;AAAA,EACtC;AAAA,EAEA,MAAgB,kBACd,SACA,cACe;AACf,UAAM,eAAe;AACrB,SAAK,eAAe;AACpB,UAAM,SAA8B;AAAA,MAClC,MAAM,aAAa;AAAA,IAAA;AAGrB,QAAI,aAAa,gBAAgB,QAAW;AAC1C,aAAO,MAAM,aAAa;AAAA,IAC5B;AACA,QAAI,aAAa,UAAU,QAAW;AACpC,aAAO,QAAQ,aAAa;AAAA,IAC9B,OAAO;AACL,YAAM,eAAe,KAAK,IAAA,EAAM,SAAS,EAAE;AAC3C,aAAO,QAAQ,GAAG,aAAa,IAAI,GAAG,YAAY;AAAA,IACpD;AACA,QAAI,aAAa,SAAS,QAAW;AACnC,aAAO,OAAO,aAAa;AAAA,IAC7B;AACA,QAAI,aAAa,UAAU,QAAW;AACpC,aAAO,QAAQ,aAAa;AAAA,IAC9B;AAEA,QAAI,aAAa,SAAS,QAAW;AACnC,aAAO,eAAe,aAAa;AAAA,IACrC,WAAW,aAAa,iBAAiB,QAAW;AAClD,aAAO,eAAe,aAAa;AAAA,IACrC;AACA,QAAI,aAAa,YAAY,QAAW;AACtC,aAAO,UAAU,aAAa;AAAA,IAChC;AACA,QAAI,aAAa,YAAY,QAAW;AACtC,aAAO,UAAU,aAAa;AAAA,IAChC;AACA,QAAI,aAAa,eAAe,QAAW;AACzC,aAAO,aAAa,aAAa;AAAA,IACnC;AACA,QAAI,aAAa,mBAAmB,QAAW;AAC7C,UAAI,OAAO,aAAa,mBAAmB,UAAU;AACnD,eAAO,iBAAiB,aAAa;AAAA,MACvC,OAAO;AACL,cAAM,gBAIF,CAAA;AACJ,YAAI,aAAa,eAAe,QAAQ,QAAW;AACjD,wBAAc,MAAM,aAAa,eAAe;AAAA,QAClD;AACA,YAAI,aAAa,eAAe,SAAS,QAAW;AAClD,wBAAc,OAAO,aAAa,eAAe;AAAA,QACnD;AACA,YAAI,aAAa,eAAe,aAAa,QAAW;AACtD,wBAAc,WAAW,aAAa,eAAe;AAAA,QACvD;AACA,eAAO,iBAAiB;AAAA,MAC1B;AAAA,IACF;AACA,QAAI,aAAa,kCAAkC,QAAW;AAC5D,aAAO,gCACL,aAAa;AAAA,IACjB;AACA,QAAI,aAAa,kBAAkB,QAAW;AAC5C,aAAO,gBAAgB,aAAa;AAAA,IACtC;AACA,QAAI,aAAa,YAAY,QAAW;AACtC,aAAO,UAAU,aAAa;AAAA,IAChC;AACA,QAAI,aAAa,cAAc,QAAW;AACxC,aAAO,YAAY,aAAa;AAAA,IAClC;AACA,QAAI,aAAa,qBAAqB,QAAW;AAC/C,aAAO,mBAAmB,aAAa;AAAA,IACzC;AACA,QAAI,aAAa,mBAAmB,QAAW;AAC7C,aAAO,iBAAiB,aAAa;AAAA,IACvC;AAEA,UAAM,aAAa,cAAc,MAAM;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAyB,MACvB,MACA,YACiB;AACjB,UAAM,SAAS,MAAM,MAAM,MAAM,MAAM,UAAU;AAEjD,UAAM,qBAAqB,KAAK,cAAc,iBAAiB;AAE/D,QAAI,KAAK,gBAAgB,oBAAoB;AAC3C,UAAI;AACF,cAAM,SAAS,KAAK,MAAM,MAAM;AAChC,YAAI,OAAO,WAAW;AACpB,eAAK,0BAA0B,OAAO,SAAS;AAAA,QACjD,WAAW,OAAO,SAAS,OAAO,aAAa,OAAO,UAAU;AAC9D,eAAK,0BAA0B,MAAM;AAAA,QACvC;AAAA,MACF,SAAS,GAAG;AAAA,MAAC;AAAA,IACf;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,0BAA0B,WAAsB;AACtD,QAAI,YAAY,UAAU,aAAa,UAAU,UAAU;AAE3D,QAAI,CAAC,aAAa,UAAU,OAAO,kBAAkB;AACnD,YAAM,kBAAkB,UAAU,MAAM,iBAAiB;AAAA,QACvD,CAAC,MAAc,EAAE,WAAW,UAAU;AAAA,MAAA;AAExC,UAAI,iBAAiB;AACnB,oBAAY,gBAAgB,MAAM,GAAG,EAAE,CAAC;AAAA,MAC1C;AAAA,IACF;AAEA,UAAM,iBACJ,UAAU,kBACV,UAAU,UAAU,kBACpB,UAAU,OAAO;AAEnB,UAAM,kBACJ,UAAU,mBACV,UAAU,UAAU,mBACpB,UAAU,OAAO;AAEnB,UAAM,iBACJ,UAAU,kBACV,UAAU,UAAU,kBACpB,UAAU,OAAO;AAEnB,UAAM,aAAa,UAAU,cAAc,UAAU,UAAU;AAE/D,QAAI,aAAa,kBAAkB,mBAAmB,KAAK,cAAc;AACvE,YAAM,kBAAmC;AAAA,QACvC,MAAM,KAAK,aAAa;AAAA,QACxB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,eAAe,KAAK,kBAAA;AAC1B,YAAM,eAAe,aAAa,gBAAA;AAClC,UAAI,cAAc;AAChB,qBAAa,gBAAgB,eAAe;AAE5C,YAAI,aAAa,kBAAkB;AACjC,gBAAM,SACJ,KAAK,aAAa,aAAa,UAC/B,KAAK,aAAa,KAAK,YAAA,EAAc,QAAQ,cAAc,GAAG;AAChE,uBACG,iBAAiB,iBAAiB;AAAA,YACjC,MAAM;AAAA,YACN;AAAA,UAAA,CACD,EACA,MAAM,MAAM;AAAA,UAAC,CAAC;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;"}

package/dist/es/standards-agent-kit.es9.js

@@ -1,40 +1,89 @@
 import { z } from "zod";
-import { BaseHCS10TransactionTool } from "./standards-agent-kit.es6.js";
-const InitiateConnectionZodSchema = z.object({
-  targetAccountId: z.string().describe(
-    "The Hedera account ID (e.g., 0.0.12345) of the agent you want to connect with."
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es7.js";
+const SendMessageToConnectionZodSchema = z.object({
+  targetIdentifier: z.string().optional().describe(
+    "The request key (e.g., 'req-1:0.0.6155171@0.0.6154875'), account ID (e.g., 0.0.12345) of the target agent, OR the connection number (e.g., '1', '2') from the 'list_connections' tool. Request key is most deterministic."
   ),
-  disableMonitor: z.boolean().optional().describe(
-    "If true, does not wait for connection confirmation. Returns immediately after sending the request."
+  connectionId: z.string().optional().describe(
+    "The connection number (e.g., '1', '2') from the 'list_connections' tool."
   ),
-  memo: z.string().optional().describe(
-    'Optional memo to include with the connection request (e.g., "Hello from Alice"). If not provided, defaults to "true" or "false" based on monitoring preference.'
-  )
+  agentId: z.string().optional().describe("The account ID (e.g., 0.0.12345) of the target agent."),
+  message: z.string().describe("The text message content to send."),
+  disableMonitoring: z.boolean().optional().default(false)
 });
-class InitiateConnectionTool extends BaseHCS10TransactionTool {
+class SendMessageToConnectionTool extends BaseHCS10TransactionTool {
   constructor(params) {
     super(params);
-    this.name = "initiate_connection";
-    this.description = "ONLY use this to START a BRAND NEW connection to an agent you have NEVER connected to before. If you already have an active connection to this agent, use send_message_to_connection instead. This creates a new connection request and waits for acceptance.";
-    this.specificInputSchema = InitiateConnectionZodSchema;
-    this.neverScheduleThisTool = true;
+    this.name = "send_message_to_connection";
+    this.description = "Use this to send a message to an agent you already have an active connection with. Provide the target agent's account ID (e.g., 0.0.12345) and your message. If no active connection exists, this will fail - use initiate_connection instead to create a new connection first.";
+    this.specificInputSchema = SendMessageToConnectionZodSchema;
     this.requiresMultipleTransactions = true;
+    this.neverScheduleThisTool = true;
   }
   async callBuilderMethod(builder, specificArgs) {
     const hcs10Builder = builder;
-    const params = {
-      targetAccountId: specificArgs.targetAccountId
-    };
-    if (specificArgs.disableMonitor !== void 0) {
-      params.disableMonitor = specificArgs.disableMonitor;
+    const targetIdentifier = specificArgs.targetIdentifier || specificArgs.agentId || specificArgs.connectionId;
+    if (!targetIdentifier) {
+      throw new Error(
+        "Either targetIdentifier, connectionId, or agentId must be provided"
+      );
     }
-    if (specificArgs.memo !== void 0) {
-      params.memo = specificArgs.memo;
+    const stateManager = hcs10Builder.getStateManager();
+    if (stateManager) {
+      const connectionsManager = stateManager.getConnectionsManager();
+      if (connectionsManager) {
+        try {
+          const currentAgent = stateManager.getCurrentAgent();
+          if (currentAgent && currentAgent.accountId) {
+            await connectionsManager.fetchConnectionData(
+              currentAgent.accountId
+            );
+          }
+        } catch (error) {
+          console.debug("Could not refresh connections:", error);
+        }
+      }
+      if (targetIdentifier.match(/^\d+$/)) {
+        const connections = stateManager.listConnections();
+        const connectionIndex = parseInt(targetIdentifier) - 1;
+        const establishedConnections = connections.filter(
+          (conn) => conn.status === "established" && !conn.isPending && !conn.needsConfirmation
+        );
+        if (connectionIndex >= 0 && connectionIndex < establishedConnections.length) {
+          const selectedConnection = establishedConnections[connectionIndex];
+          if (selectedConnection && selectedConnection.connectionTopicId) {
+            await hcs10Builder.sendMessageToConnection({
+              targetIdentifier: selectedConnection.connectionTopicId,
+              message: specificArgs.message,
+              disableMonitoring: specificArgs.disableMonitoring
+            });
+            return;
+          }
+        }
+      }
+      if (targetIdentifier.match(/^\d+\.\d+\.\d+$/)) {
+        const connections = stateManager.listConnections();
+        const establishedConnection = connections.find(
+          (conn) => (conn.targetAccountId === targetIdentifier || conn.targetAccountId === `0.0.${targetIdentifier}`) && conn.status === "established" && !conn.isPending && !conn.needsConfirmation
+        );
+        if (establishedConnection && establishedConnection.connectionTopicId) {
+          await hcs10Builder.sendMessageToConnection({
+            targetIdentifier: establishedConnection.connectionTopicId,
+            message: specificArgs.message,
+            disableMonitoring: specificArgs.disableMonitoring
+          });
+          return;
+        }
+      }
     }
-    await hcs10Builder.initiateConnection(params);
+    await hcs10Builder.sendMessageToConnection({
+      targetIdentifier,
+      message: specificArgs.message,
+      disableMonitoring: specificArgs.disableMonitoring
+    });
   }
 }
 export {
-  InitiateConnectionTool
+  SendMessageToConnectionTool
 };
 //# sourceMappingURL=standards-agent-kit.es9.js.map

package/dist/es/standards-agent-kit.es9.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es9.js","sources":["../../src/tools/hcs10/InitiateConnectionTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\n\nconst InitiateConnectionZodSchema = z.object({\n  targetAccountId: z\n    .string()\n    .describe(\n      'The Hedera account ID (e.g., 0.0.12345) of the agent you want to connect with.'\n    ),\n  disableMonitor: z\n    .boolean()\n    .optional()\n    .describe(\n      'If true, does not wait for connection confirmation. Returns immediately after sending the request.'\n    ),\n  memo: z\n    .string()\n    .optional()\n    .describe(\n      'Optional memo to include with the connection request (e.g., \"Hello from Alice\"). If not provided, defaults to \"true\" or \"false\" based on monitoring preference.'\n    ),\n});\n\n/**\n * A tool to actively START a NEW HCS-10 connection TO a target agent.\n * Requires the target agent's account ID.\n * It retrieves their profile, sends a connection request, and optionally waits for confirmation.\n * Use this tool ONLY to actively INITIATE an OUTGOING connection.\n */\nexport class InitiateConnectionTool extends BaseHCS10TransactionTool<\n  typeof InitiateConnectionZodSchema\n> {\n  name = 'initiate_connection';\n  description =\n    'ONLY use this to START a BRAND NEW connection to an agent you have NEVER connected to before. If you already have an active connection to this agent, use send_message_to_connection instead. This creates a new connection request and waits for acceptance.';\n  specificInputSchema = InitiateConnectionZodSchema;\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.neverScheduleThisTool = true;\n    this.requiresMultipleTransactions = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof InitiateConnectionZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n    const params: {\n      targetAccountId: string;\n      disableMonitor?: boolean;\n      memo?: string;\n    } = {\n      targetAccountId: specificArgs.targetAccountId,\n    };\n    if (specificArgs.disableMonitor !== undefined) {\n      params.disableMonitor = specificArgs.disableMonitor;\n    }\n    if (specificArgs.memo !== undefined) {\n      params.memo = specificArgs.memo;\n    }\n    await hcs10Builder.initiateConnection(params);\n  }\n}"],"names":[],"mappings":";;AAMA,MAAM,8BAA8B,EAAE,OAAO;AAAA,EAC3C,iBAAiB,EACd,OAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,gBAAgB,EACb,UACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,MAAM,EACH,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAQM,MAAM,+BAA+B,yBAE1C;AAAA,EAKA,YAAY,QAAoC;AAC9C,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAGpB,SAAK,wBAAwB;AAC7B,SAAK,+BAA+B;AAAA,EACtC;AAAA,EAEA,MAAgB,kBACd,SACA,cACe;AACf,UAAM,eAAe;AACrB,UAAM,SAIF;AAAA,MACF,iBAAiB,aAAa;AAAA,IAAA;AAEhC,QAAI,aAAa,mBAAmB,QAAW;AAC7C,aAAO,iBAAiB,aAAa;AAAA,IACvC;AACA,QAAI,aAAa,SAAS,QAAW;AACnC,aAAO,OAAO,aAAa;AAAA,IAC7B;AACA,UAAM,aAAa,mBAAmB,MAAM;AAAA,EAC9C;AACF;"}
+{"version":3,"file":"standards-agent-kit.es9.js","sources":["../../src/tools/hcs10/SendMessageToConnectionTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\n\nconst SendMessageToConnectionZodSchema = z.object({\n  targetIdentifier: z\n    .string()\n    .optional()\n    .describe(\n      \"The request key (e.g., 'req-1:0.0.6155171@0.0.6154875'), account ID (e.g., 0.0.12345) of the target agent, OR the connection number (e.g., '1', '2') from the 'list_connections' tool. Request key is most deterministic.\"\n    ),\n  connectionId: z\n    .string()\n    .optional()\n    .describe(\n      \"The connection number (e.g., '1', '2') from the 'list_connections' tool.\"\n    ),\n  agentId: z\n    .string()\n    .optional()\n    .describe('The account ID (e.g., 0.0.12345) of the target agent.'),\n  message: z.string().describe('The text message content to send.'),\n  disableMonitoring: z.boolean().optional().default(false),\n});\n\n/**\n * A tool to send a message to an agent over an established HCS-10 connection.\n */\nexport class SendMessageToConnectionTool extends BaseHCS10TransactionTool<\n  typeof SendMessageToConnectionZodSchema\n> {\n  name = 'send_message_to_connection';\n  description =\n    \"Use this to send a message to an agent you already have an active connection with. Provide the target agent's account ID (e.g., 0.0.12345) and your message. If no active connection exists, this will fail - use initiate_connection instead to create a new connection first.\";\n  specificInputSchema = SendMessageToConnectionZodSchema;\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.requiresMultipleTransactions = true;\n    this.neverScheduleThisTool = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof SendMessageToConnectionZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n\n    const targetIdentifier =\n      specificArgs.targetIdentifier ||\n      specificArgs.agentId ||\n      specificArgs.connectionId;\n\n    if (!targetIdentifier) {\n      throw new Error(\n        'Either targetIdentifier, connectionId, or agentId must be provided'\n      );\n    }\n\n    const stateManager = hcs10Builder.getStateManager();\n    if (stateManager) {\n      const connectionsManager = stateManager.getConnectionsManager();\n      if (connectionsManager) {\n        try {\n          const currentAgent = stateManager.getCurrentAgent();\n          if (currentAgent && currentAgent.accountId) {\n            await connectionsManager.fetchConnectionData(\n              currentAgent.accountId\n            );\n          }\n        } catch (error) {\n          console.debug('Could not refresh connections:', error);\n        }\n      }\n\n      if (targetIdentifier.match(/^\\d+$/)) {\n        const connections = stateManager.listConnections();\n        const connectionIndex = parseInt(targetIdentifier) - 1; // Connection numbers are 1-based\n\n        const establishedConnections = connections.filter(\n          (conn) =>\n            conn.status === 'established' &&\n            !conn.isPending &&\n            !conn.needsConfirmation\n        );\n\n        if (\n          connectionIndex >= 0 &&\n          connectionIndex < establishedConnections.length\n        ) {\n          const selectedConnection = establishedConnections[connectionIndex];\n          if (selectedConnection && selectedConnection.connectionTopicId) {\n            await hcs10Builder.sendMessageToConnection({\n              targetIdentifier: selectedConnection.connectionTopicId,\n              message: specificArgs.message,\n              disableMonitoring: specificArgs.disableMonitoring,\n            });\n            return;\n          }\n        }\n      }\n\n      if (targetIdentifier.match(/^\\d+\\.\\d+\\.\\d+$/)) {\n        const connections = stateManager.listConnections();\n        const establishedConnection = connections.find(\n          (conn) =>\n            (conn.targetAccountId === targetIdentifier ||\n              conn.targetAccountId === `0.0.${targetIdentifier}`) &&\n            conn.status === 'established' &&\n            !conn.isPending &&\n            !conn.needsConfirmation\n        );\n\n        if (establishedConnection && establishedConnection.connectionTopicId) {\n          await hcs10Builder.sendMessageToConnection({\n            targetIdentifier: establishedConnection.connectionTopicId,\n            message: specificArgs.message,\n            disableMonitoring: specificArgs.disableMonitoring,\n          });\n          return;\n        }\n      }\n    }\n\n    await hcs10Builder.sendMessageToConnection({\n      targetIdentifier: targetIdentifier,\n      message: specificArgs.message,\n      disableMonitoring: specificArgs.disableMonitoring,\n    });\n  }\n}\n"],"names":[],"mappings":";;AAMA,MAAM,mCAAmC,EAAE,OAAO;AAAA,EAChD,kBAAkB,EACf,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,cAAc,EACX,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,SAAS,EACN,OAAA,EACA,SAAA,EACA,SAAS,uDAAuD;AAAA,EACnE,SAAS,EAAE,SAAS,SAAS,mCAAmC;AAAA,EAChE,mBAAmB,EAAE,QAAA,EAAU,SAAA,EAAW,QAAQ,KAAK;AACzD,CAAC;AAKM,MAAM,oCAAoC,yBAE/C;AAAA,EAKA,YAAY,QAAoC;AAC9C,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAGpB,SAAK,+BAA+B;AACpC,SAAK,wBAAwB;AAAA,EAC/B;AAAA,EAEA,MAAgB,kBACd,SACA,cACe;AACf,UAAM,eAAe;AAErB,UAAM,mBACJ,aAAa,oBACb,aAAa,WACb,aAAa;AAEf,QAAI,CAAC,kBAAkB;AACrB,YAAM,IAAI;AAAA,QACR;AAAA,MAAA;AAAA,IAEJ;AAEA,UAAM,eAAe,aAAa,gBAAA;AAClC,QAAI,cAAc;AAChB,YAAM,qBAAqB,aAAa,sBAAA;AACxC,UAAI,oBAAoB;AACtB,YAAI;AACF,gBAAM,eAAe,aAAa,gBAAA;AAClC,cAAI,gBAAgB,aAAa,WAAW;AAC1C,kBAAM,mBAAmB;AAAA,cACvB,aAAa;AAAA,YAAA;AAAA,UAEjB;AAAA,QACF,SAAS,OAAO;AACd,kBAAQ,MAAM,kCAAkC,KAAK;AAAA,QACvD;AAAA,MACF;AAEA,UAAI,iBAAiB,MAAM,OAAO,GAAG;AACnC,cAAM,cAAc,aAAa,gBAAA;AACjC,cAAM,kBAAkB,SAAS,gBAAgB,IAAI;AAErD,cAAM,yBAAyB,YAAY;AAAA,UACzC,CAAC,SACC,KAAK,WAAW,iBAChB,CAAC,KAAK,aACN,CAAC,KAAK;AAAA,QAAA;AAGV,YACE,mBAAmB,KACnB,kBAAkB,uBAAuB,QACzC;AACA,gBAAM,qBAAqB,uBAAuB,eAAe;AACjE,cAAI,sBAAsB,mBAAmB,mBAAmB;AAC9D,kBAAM,aAAa,wBAAwB;AAAA,cACzC,kBAAkB,mBAAmB;AAAA,cACrC,SAAS,aAAa;AAAA,cACtB,mBAAmB,aAAa;AAAA,YAAA,CACjC;AACD;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,UAAI,iBAAiB,MAAM,iBAAiB,GAAG;AAC7C,cAAM,cAAc,aAAa,gBAAA;AACjC,cAAM,wBAAwB,YAAY;AAAA,UACxC,CAAC,UACE,KAAK,oBAAoB,oBACxB,KAAK,oBAAoB,OAAO,gBAAgB,OAClD,KAAK,WAAW,iBAChB,CAAC,KAAK,aACN,CAAC,KAAK;AAAA,QAAA;AAGV,YAAI,yBAAyB,sBAAsB,mBAAmB;AACpE,gBAAM,aAAa,wBAAwB;AAAA,YACzC,kBAAkB,sBAAsB;AAAA,YACxC,SAAS,aAAa;AAAA,YACtB,mBAAmB,aAAa;AAAA,UAAA,CACjC;AACD;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,UAAM,aAAa,wBAAwB;AAAA,MACzC;AAAA,MACA,SAAS,aAAa;AAAA,MACtB,mBAAmB,aAAa;AAAA,IAAA,CACjC;AAAA,EACH;AACF;"}

package/dist/es/tools/hcs6/CreateDynamicRegistryTool.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { BaseHCS6TransactionTool } from './base-hcs6-tools';
+import { HCS6TransactionToolParams } from './hcs6-tool-params';
+import { TransactionResponse } from 'hedera-agent-kit';
+/**
+ * Schema for creating a dynamic hashinal registry
+ */
+declare const CreateDynamicRegistrySchema: z.ZodObject<{
+    ttl: z.ZodDefault<z.ZodNumber>;
+    adminKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
+    submitKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
+}, "strip", z.ZodTypeAny, {
+    ttl: number;
+    adminKey?: string | boolean | undefined;
+    submitKey?: string | boolean | undefined;
+}, {
+    ttl?: number | undefined;
+    adminKey?: string | boolean | undefined;
+    submitKey?: string | boolean | undefined;
+}>;
+export type CreateDynamicRegistryInput = z.infer<typeof CreateDynamicRegistrySchema>;
+/**
+ * Tool for creating HCS-6 dynamic registries
+ */
+export declare class CreateDynamicRegistryTool extends BaseHCS6TransactionTool<typeof CreateDynamicRegistrySchema> {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        ttl: z.ZodDefault<z.ZodNumber>;
+        adminKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
+        submitKey: z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodString]>>;
+    }, "strip", z.ZodTypeAny, {
+        ttl: number;
+        adminKey?: string | boolean | undefined;
+        submitKey?: string | boolean | undefined;
+    }, {
+        ttl?: number | undefined;
+        adminKey?: string | boolean | undefined;
+        submitKey?: string | boolean | undefined;
+    }>;
+    constructor(params: HCS6TransactionToolParams);
+    protected _call(params: CreateDynamicRegistryInput): Promise<TransactionResponse>;
+}
+export {};