@hashgraphonline/standards-agent-kit 0.2.136 → 0.2.138

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

@@ -1,40 +1,91 @@
 import { z } from "zod";
-import { BaseHCS10QueryTool } from "./standards-agent-kit.es8.js";
-const ListConnectionsZodSchema = z.object({
-  includeDetails: z.boolean().optional().describe(
-    "Whether to include detailed information about each connection"
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es10.js";
+import { Logger } from "@hashgraphonline/standards-sdk";
+const logger = new Logger({ module: "SendMessageToConnectionTool" });
+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."
   ),
-  showPending: z.boolean().optional().describe("Whether to include pending connection requests")
+  connectionId: z.string().optional().describe(
+    "The connection number (e.g., '1', '2') from the 'list_connections' tool."
+  ),
+  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 ListConnectionsTool extends BaseHCS10QueryTool {
+class SendMessageToConnectionTool extends BaseHCS10TransactionTool {
   constructor(params) {
     super(params);
-    this.name = "list_connections";
-    this.description = "Lists all active HCS-10 connections. Use this FIRST before sending messages to check if you already have an active connection to a target agent. Shows connection details and agent information for each active connection.";
-    this.specificInputSchema = ListConnectionsZodSchema;
+    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 executeQuery(args) {
-    const hcs10Builder = this.hcs10Builder;
-    const params = {};
-    if (args.includeDetails !== void 0) {
-      params.includeDetails = args.includeDetails;
-    }
-    if (args.showPending !== void 0) {
-      params.showPending = args.showPending;
+  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"
+      );
     }
-    await hcs10Builder.listConnections(params);
-    const result = await hcs10Builder.execute();
-    if (result.success && "rawResult" in result && result.rawResult) {
-      const raw = result.rawResult;
-      return {
-        success: true,
-        data: raw.formattedOutput || raw.message || "Connections listed"
-      };
+    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) {
+          logger.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;
+        }
+      }
     }
-    return result;
+    await hcs10Builder.sendMessageToConnection({
+      targetIdentifier,
+      message: specificArgs.message,
+      disableMonitoring: specificArgs.disableMonitoring
+    });
   }
 }
 export {
-  ListConnectionsTool
+  SendMessageToConnectionTool
 };
 //# sourceMappingURL=standards-agent-kit.es12.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es12.js","sources":["../../src/tools/hcs10/ListConnectionsTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\n\n/**\n * A tool to list currently active HCS-10 connections stored in the state manager.\n * Enhanced to show more details similar to moonscape's implementation.\n */\nconst ListConnectionsZodSchema = z.object({\n  includeDetails: z\n    .boolean()\n    .optional()\n    .describe(\n      'Whether to include detailed information about each connection'\n    ),\n  showPending: z\n    .boolean()\n    .optional()\n    .describe('Whether to include pending connection requests'),\n});\n\nexport class ListConnectionsTool extends BaseHCS10QueryTool<\n  typeof ListConnectionsZodSchema\n> {\n  name = 'list_connections';\n  description =\n    'Lists all active HCS-10 connections. Use this FIRST before sending messages to check if you already have an active connection to a target agent. Shows connection details and agent information for each active connection.';\n  specificInputSchema = ListConnectionsZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery(\n    args: z.infer<typeof ListConnectionsZodSchema>\n  ): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    const params: { includeDetails?: boolean; showPending?: boolean } = {};\n    if (args.includeDetails !== undefined) {\n      params.includeDetails = args.includeDetails;\n    }\n    if (args.showPending !== undefined) {\n      params.showPending = args.showPending;\n    }\n    await hcs10Builder.listConnections(params);\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as { formattedOutput?: string; message?: string };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Connections listed'\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,gBAAgB,EACb,UACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,aAAa,EACV,QAAA,EACA,SAAA,EACA,SAAS,gDAAgD;AAC9D,CAAC;AAEM,MAAM,4BAA4B,mBAEvC;AAAA,EAKA,YAAY,QAA8B;AACxC,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aACd,MACkB;AAClB,UAAM,eAAe,KAAK;AAC1B,UAAM,SAA8D,CAAA;AACpE,QAAI,KAAK,mBAAmB,QAAW;AACrC,aAAO,iBAAiB,KAAK;AAAA,IAC/B;AACA,QAAI,KAAK,gBAAgB,QAAW;AAClC,aAAO,cAAc,KAAK;AAAA,IAC5B;AACA,UAAM,aAAa,gBAAgB,MAAM;AAEzC,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AACnB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"standards-agent-kit.es12.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';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\nconst logger = new Logger({ module: 'SendMessageToConnectionTool' });\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          logger.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":";;;AAOA,MAAM,SAAS,IAAI,OAAO,EAAE,QAAQ,+BAA+B;AAEnE,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,iBAAO,MAAM,kCAAkC,KAAK;AAAA,QACtD;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/standards-agent-kit.es13.js

@@ -1,50 +1,40 @@
 import { z } from "zod";
-import { BaseHCS10QueryTool } from "./standards-agent-kit.es8.js";
-const CheckMessagesZodSchema = z.object({
-  targetIdentifier: z.string().describe(
-    "The account ID (e.g., 0.0.12345) of the target agent OR the connection number (e.g., '1', '2') from the 'list_connections' tool to check messages for."
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es10.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."
   ),
-  fetchLatest: z.boolean().optional().default(false).describe(
-    "Set to true to fetch the latest messages even if they have been seen before, ignoring the last checked timestamp. Defaults to false (fetching only new messages)."
+  disableMonitor: z.boolean().optional().describe(
+    "If true, does not wait for connection confirmation. Returns immediately after sending the request."
   ),
-  lastMessagesCount: z.number().int().positive().optional().describe(
-    "When fetchLatest is true, specifies how many of the most recent messages to retrieve. Defaults to 1."
+  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.'
   )
 });
-class CheckMessagesTool extends BaseHCS10QueryTool {
+class InitiateConnectionTool extends BaseHCS10TransactionTool {
   constructor(params) {
     super(params);
-    this.name = "check_messages";
-    this.description = `Checks for and retrieves messages from an active connection.
-Identify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'.
-By default, it only retrieves messages newer than the last check.
-Use 'fetchLatest: true' to get the most recent messages regardless of when they arrived.
-Use 'lastMessagesCount' to specify how many latest messages to retrieve (default 1 when fetchLatest is true).`;
-    this.specificInputSchema = CheckMessagesZodSchema;
+    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.requiresMultipleTransactions = true;
   }
-  async executeQuery({
-    targetIdentifier,
-    fetchLatest,
-    lastMessagesCount
-  }) {
-    const hcs10Builder = this.hcs10Builder;
-    await hcs10Builder.checkMessages({
-      targetIdentifier,
-      fetchLatest,
-      lastMessagesCount: lastMessagesCount || 1
-    });
-    const result = await hcs10Builder.execute();
-    if (result.success && "rawResult" in result && result.rawResult) {
-      const raw = result.rawResult;
-      return {
-        success: true,
-        data: raw.formattedOutput || raw.message || "Messages checked"
-      };
+  async callBuilderMethod(builder, specificArgs) {
+    const hcs10Builder = builder;
+    const params = {
+      targetAccountId: specificArgs.targetAccountId
+    };
+    if (specificArgs.disableMonitor !== void 0) {
+      params.disableMonitor = specificArgs.disableMonitor;
     }
-    return result;
+    if (specificArgs.memo !== void 0) {
+      params.memo = specificArgs.memo;
+    }
+    await hcs10Builder.initiateConnection(params);
   }
 }
 export {
-  CheckMessagesTool
+  InitiateConnectionTool
 };
 //# sourceMappingURL=standards-agent-kit.es13.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es13.js","sources":["../../src/tools/hcs10/CheckMessagesTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\n\n/**\n * A tool to check for new messages on an active HCS-10 connection topic,\n * or optionally fetch the latest messages regardless of timestamp.\n */\nconst CheckMessagesZodSchema = z.object({\n  targetIdentifier: z\n    .string()\n    .describe(\n      \"The account ID (e.g., 0.0.12345) of the target agent OR the connection number (e.g., '1', '2') from the 'list_connections' tool to check messages for.\"\n    ),\n  fetchLatest: z\n    .boolean()\n    .optional()\n    .default(false)\n    .describe(\n      'Set to true to fetch the latest messages even if they have been seen before, ignoring the last checked timestamp. Defaults to false (fetching only new messages).'\n    ),\n  lastMessagesCount: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'When fetchLatest is true, specifies how many of the most recent messages to retrieve. Defaults to 1.'\n    ),\n});\n\nexport class CheckMessagesTool extends BaseHCS10QueryTool<\n  typeof CheckMessagesZodSchema\n> {\n  name = 'check_messages';\n  description = `Checks for and retrieves messages from an active connection.\nIdentify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'.\nBy default, it only retrieves messages newer than the last check.\nUse 'fetchLatest: true' to get the most recent messages regardless of when they arrived.\nUse 'lastMessagesCount' to specify how many latest messages to retrieve (default 1 when fetchLatest is true).`;\n  specificInputSchema = CheckMessagesZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery({\n    targetIdentifier,\n    fetchLatest,\n    lastMessagesCount,\n  }: z.infer<typeof CheckMessagesZodSchema>): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    await hcs10Builder.checkMessages({\n      targetIdentifier,\n      fetchLatest,\n      lastMessagesCount: lastMessagesCount || 1,\n    });\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as {\n        formattedOutput?: string;\n        message?: string;\n      };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Messages checked',\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,kBAAkB,EACf,OAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,aAAa,EACV,QAAA,EACA,WACA,QAAQ,KAAK,EACb;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,mBAAmB,EAChB,SACA,MACA,SAAA,EACA,SAAA,EACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAEM,MAAM,0BAA0B,mBAErC;AAAA,EAQA,YAAY,QAA8B;AACxC,UAAM,MAAM;AARd,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAAA;AAKd,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aAAa;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,EAAA,GAC2D;AAC3D,UAAM,eAAe,KAAK;AAC1B,UAAM,aAAa,cAAc;AAAA,MAC/B;AAAA,MACA;AAAA,MACA,mBAAmB,qBAAqB;AAAA,IAAA,CACzC;AAED,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AAInB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"standards-agent-kit.es13.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;"}

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

@@ -1,62 +1,40 @@
 import { z } from "zod";
-import { AIAgentCapability } from "@hashgraphonline/standards-sdk";
-import { BaseHCS10QueryTool } from "./standards-agent-kit.es8.js";
-import { NaturalLanguageMapper } from "./standards-agent-kit.es20.js";
-const FindRegistrationsZodSchema = z.object({
-  accountId: z.string().optional().describe(
-    "Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345)."
+import { BaseHCS10QueryTool } from "./standards-agent-kit.es10.js";
+const ListConnectionsZodSchema = z.object({
+  includeDetails: z.boolean().optional().describe(
+    "Whether to include detailed information about each connection"
   ),
-  tags: 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(
-    'Optional: Filter by capabilities/tags like "ai", "data", "analytics". Can be natural language terms or capability numbers.'
-  )
+  showPending: z.boolean().optional().describe("Whether to include pending connection requests")
 });
-class FindRegistrationsTool extends BaseHCS10QueryTool {
+class ListConnectionsTool extends BaseHCS10QueryTool {
   constructor(params) {
     super(params);
-    this.name = "find_registrations";
-    this.description = 'Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags/capabilities using natural language like "ai", "data processing", "analytics". Returns basic registration info.';
-    this.specificInputSchema = FindRegistrationsZodSchema;
+    this.name = "list_connections";
+    this.description = "Lists all active HCS-10 connections. Use this FIRST before sending messages to check if you already have an active connection to a target agent. Shows connection details and agent information for each active connection.";
+    this.specificInputSchema = ListConnectionsZodSchema;
   }
-  async executeQuery({
-    accountId,
-    tags
-  }) {
+  async executeQuery(args) {
     const hcs10Builder = this.hcs10Builder;
     const params = {};
-    if (accountId) {
-      params.accountId = accountId;
+    if (args.includeDetails !== void 0) {
+      params.includeDetails = args.includeDetails;
     }
-    if (tags) {
-      params.tags = tags;
+    if (args.showPending !== void 0) {
+      params.showPending = args.showPending;
     }
-    await hcs10Builder.findRegistrations(params);
+    await hcs10Builder.listConnections(params);
     const result = await hcs10Builder.execute();
     if (result.success && "rawResult" in result && result.rawResult) {
       const raw = result.rawResult;
       return {
         success: true,
-        data: raw.formattedOutput || raw.message || "Registrations searched"
+        data: raw.formattedOutput || raw.message || "Connections listed"
       };
     }
     return result;
   }
 }
 export {
-  FindRegistrationsTool
+  ListConnectionsTool
 };
 //# sourceMappingURL=standards-agent-kit.es14.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es14.js","sources":["../../src/tools/hcs10/FindRegistrationsTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { AIAgentCapability } from '@hashgraphonline/standards-sdk';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\nimport { NaturalLanguageMapper } from './natural-language-mapper';\n\n/**\n * A tool to search for registered HCS-10 agents using the configured registry.\n */\nconst FindRegistrationsZodSchema = z.object({\n  accountId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345).'\n    ),\n  tags: 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(\n      'Optional: Filter by capabilities/tags like \"ai\", \"data\", \"analytics\". Can be natural language terms or capability numbers.'\n    ),\n});\n\nexport class FindRegistrationsTool extends BaseHCS10QueryTool<\n  typeof FindRegistrationsZodSchema\n> {\n  name = 'find_registrations';\n  description =\n    'Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags/capabilities using natural language like \"ai\", \"data processing\", \"analytics\". Returns basic registration info.';\n  specificInputSchema = FindRegistrationsZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery({\n    accountId,\n    tags,\n  }: z.infer<typeof FindRegistrationsZodSchema>): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    const params: { accountId?: string; tags?: number[] } = {};\n    if (accountId) {\n      params.accountId = accountId;\n    }\n    if (tags) {\n      params.tags = tags as number[];\n    }\n    await hcs10Builder.findRegistrations(params);\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as {\n        formattedOutput?: string;\n        message?: string;\n      };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Registrations searched',\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;;;AASA,MAAM,6BAA6B,EAAE,OAAO;AAAA,EAC1C,WAAW,EACR,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,MAAM,EACH,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,KAAK;AAAC,aAAO;AAAA,IAAU;AAC5B,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;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAEM,MAAM,8BAA8B,mBAEzC;AAAA,EAKA,YAAY,QAA8B;AACxC,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aAAa;AAAA,IAC3B;AAAA,IACA;AAAA,EAAA,GAC+D;AAC/D,UAAM,eAAe,KAAK;AAC1B,UAAM,SAAkD,CAAA;AACxD,QAAI,WAAW;AACb,aAAO,YAAY;AAAA,IACrB;AACA,QAAI,MAAM;AACR,aAAO,OAAO;AAAA,IAChB;AACA,UAAM,aAAa,kBAAkB,MAAM;AAE3C,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AAInB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"standards-agent-kit.es14.js","sources":["../../src/tools/hcs10/ListConnectionsTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\n\n/**\n * A tool to list currently active HCS-10 connections stored in the state manager.\n * Enhanced to show more details similar to moonscape's implementation.\n */\nconst ListConnectionsZodSchema = z.object({\n  includeDetails: z\n    .boolean()\n    .optional()\n    .describe(\n      'Whether to include detailed information about each connection'\n    ),\n  showPending: z\n    .boolean()\n    .optional()\n    .describe('Whether to include pending connection requests'),\n});\n\nexport class ListConnectionsTool extends BaseHCS10QueryTool<\n  typeof ListConnectionsZodSchema\n> {\n  name = 'list_connections';\n  description =\n    'Lists all active HCS-10 connections. Use this FIRST before sending messages to check if you already have an active connection to a target agent. Shows connection details and agent information for each active connection.';\n  specificInputSchema = ListConnectionsZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery(\n    args: z.infer<typeof ListConnectionsZodSchema>\n  ): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    const params: { includeDetails?: boolean; showPending?: boolean } = {};\n    if (args.includeDetails !== undefined) {\n      params.includeDetails = args.includeDetails;\n    }\n    if (args.showPending !== undefined) {\n      params.showPending = args.showPending;\n    }\n    await hcs10Builder.listConnections(params);\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as { formattedOutput?: string; message?: string };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Connections listed'\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,2BAA2B,EAAE,OAAO;AAAA,EACxC,gBAAgB,EACb,UACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,aAAa,EACV,QAAA,EACA,SAAA,EACA,SAAS,gDAAgD;AAC9D,CAAC;AAEM,MAAM,4BAA4B,mBAEvC;AAAA,EAKA,YAAY,QAA8B;AACxC,UAAM,MAAM;AALd,SAAA,OAAO;AACP,SAAA,cACE;AACF,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aACd,MACkB;AAClB,UAAM,eAAe,KAAK;AAC1B,UAAM,SAA8D,CAAA;AACpE,QAAI,KAAK,mBAAmB,QAAW;AACrC,aAAO,iBAAiB,KAAK;AAAA,IAC/B;AACA,QAAI,KAAK,gBAAgB,QAAW;AAClC,aAAO,cAAc,KAAK;AAAA,IAC5B;AACA,UAAM,aAAa,gBAAgB,MAAM;AAEzC,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AACnB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}

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

@@ -1,72 +1,50 @@
 import { z } from "zod";
-import { BaseHCS10TransactionTool } from "./standards-agent-kit.es8.js";
-const ConnectionMonitorZodSchema = z.object({
-  acceptAll: z.boolean().optional().describe(
-    "Whether to automatically accept all incoming connection requests. Default is false."
+import { BaseHCS10QueryTool } from "./standards-agent-kit.es10.js";
+const CheckMessagesZodSchema = z.object({
+  targetIdentifier: z.string().describe(
+    "The account ID (e.g., 0.0.12345) of the target agent OR the connection number (e.g., '1', '2') from the 'list_connections' tool to check messages for."
   ),
-  targetAccountId: z.string().optional().describe(
-    "If provided, only accept connection requests from this specific account ID."
+  fetchLatest: z.boolean().optional().default(false).describe(
+    "Set to true to fetch the latest messages even if they have been seen before, ignoring the last checked timestamp. Defaults to false (fetching only new messages)."
   ),
-  hbarFees: z.array(
-    z.object({
-      amount: z.number(),
-      collectorAccount: z.string().optional()
-    })
-  ).optional().describe(
-    "Array of HBAR fee amounts to charge per message (with optional collector accounts)."
-  ),
-  tokenFees: z.array(
-    z.object({
-      amount: z.number(),
-      tokenId: z.string(),
-      collectorAccount: z.string().optional()
-    })
-  ).optional().describe(
-    "Array of token fee amounts and IDs to charge per message (with optional collector accounts)."
-  ),
-  exemptAccountIds: z.array(z.string()).optional().describe(
-    "Array of account IDs to exempt from ALL fees set in this request."
-  ),
-  monitorDurationSeconds: z.number().optional().describe(
-    "How long to monitor for incoming requests in seconds. Default is 120."
-  ),
-  defaultCollectorAccount: z.string().optional().describe(
-    "Default account to collect fees if not specified at the fee level. Defaults to the agent account."
+  lastMessagesCount: z.number().int().positive().optional().describe(
+    "When fetchLatest is true, specifies how many of the most recent messages to retrieve. Defaults to 1."
   )
 });
-class ConnectionMonitorTool extends BaseHCS10TransactionTool {
+class CheckMessagesTool extends BaseHCS10QueryTool {
   constructor(params) {
     super(params);
-    this.name = "monitor_connections";
-    this.description = "Monitors for incoming connection requests and accepts them with optional fee settings. Use this to watch for connection requests and accept them, optionally setting HBAR or token fees on the connection. Note: When acceptAll=true, this tool requires multiple transactions and cannot be used in returnBytes mode.";
-    this.specificInputSchema = ConnectionMonitorZodSchema;
-    this.neverScheduleThisTool = true;
-    this.requiresMultipleTransactions = true;
+    this.name = "check_messages";
+    this.description = `Checks for and retrieves messages from an active connection.
+Identify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'.
+By default, it only retrieves messages newer than the last check.
+Use 'fetchLatest: true' to get the most recent messages regardless of when they arrived.
+Use 'lastMessagesCount' to specify how many latest messages to retrieve (default 1 when fetchLatest is true).`;
+    this.specificInputSchema = CheckMessagesZodSchema;
   }
-  async callBuilderMethod(builder, specificArgs) {
-    const hcs10Builder = builder;
-    await hcs10Builder.monitorConnections({
-      ...specificArgs.acceptAll !== void 0 && {
-        acceptAll: specificArgs.acceptAll
-      },
-      ...specificArgs.targetAccountId !== void 0 && {
-        targetAccountId: specificArgs.targetAccountId
-      },
-      ...specificArgs.monitorDurationSeconds !== void 0 && {
-        monitorDurationSeconds: specificArgs.monitorDurationSeconds
-      },
-      hbarFees: specificArgs.hbarFees || [],
-      tokenFees: specificArgs.tokenFees || [],
-      ...specificArgs.exemptAccountIds !== void 0 && {
-        exemptAccountIds: specificArgs.exemptAccountIds
-      },
-      ...specificArgs.defaultCollectorAccount !== void 0 && {
-        defaultCollectorAccount: specificArgs.defaultCollectorAccount
-      }
+  async executeQuery({
+    targetIdentifier,
+    fetchLatest,
+    lastMessagesCount
+  }) {
+    const hcs10Builder = this.hcs10Builder;
+    await hcs10Builder.checkMessages({
+      targetIdentifier,
+      fetchLatest,
+      lastMessagesCount: lastMessagesCount || 1
     });
+    const result = await hcs10Builder.execute();
+    if (result.success && "rawResult" in result && result.rawResult) {
+      const raw = result.rawResult;
+      return {
+        success: true,
+        data: raw.formattedOutput || raw.message || "Messages checked"
+      };
+    }
+    return result;
   }
 }
 export {
-  ConnectionMonitorTool
+  CheckMessagesTool
 };
 //# sourceMappingURL=standards-agent-kit.es15.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es15.js","sources":["../../src/tools/hcs10/ConnectionMonitorTool.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 ConnectionMonitorZodSchema = z.object({\n  acceptAll: z\n    .boolean()\n    .optional()\n    .describe(\n      'Whether to automatically accept all incoming connection requests. Default is false.'\n    ),\n  targetAccountId: z\n    .string()\n    .optional()\n    .describe(\n      'If provided, only accept connection requests from this specific account ID.'\n    ),\n  hbarFees: z\n    .array(\n      z.object({\n        amount: z.number(),\n        collectorAccount: z.string().optional(),\n      })\n    )\n    .optional()\n    .describe(\n      'Array of HBAR fee amounts to charge per message (with optional collector accounts).'\n    ),\n  tokenFees: z\n    .array(\n      z.object({\n        amount: z.number(),\n        tokenId: z.string(),\n        collectorAccount: z.string().optional(),\n      })\n    )\n    .optional()\n    .describe(\n      'Array of token fee amounts and IDs to charge per message (with optional collector accounts).'\n    ),\n  exemptAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe(\n      'Array of account IDs to exempt from ALL fees set in this request.'\n    ),\n  monitorDurationSeconds: z\n    .number()\n    .optional()\n    .describe(\n      'How long to monitor for incoming requests in seconds. Default is 120.'\n    ),\n  defaultCollectorAccount: z\n    .string()\n    .optional()\n    .describe(\n      'Default account to collect fees if not specified at the fee level. Defaults to the agent account.'\n    ),\n});\n\n/**\n * A tool for monitoring incoming connection requests and accepting them with optional fee settings.\n */\nexport class ConnectionMonitorTool extends BaseHCS10TransactionTool<\n  typeof ConnectionMonitorZodSchema\n> {\n  name = 'monitor_connections';\n  description =\n    'Monitors for incoming connection requests and accepts them with optional fee settings. Use this to watch for connection requests and accept them, optionally setting HBAR or token fees on the connection. Note: When acceptAll=true, this tool requires multiple transactions and cannot be used in returnBytes mode.';\n  specificInputSchema = ConnectionMonitorZodSchema;\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 ConnectionMonitorZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n    await hcs10Builder.monitorConnections({\n      ...(specificArgs.acceptAll !== undefined && {\n        acceptAll: specificArgs.acceptAll,\n      }),\n      ...(specificArgs.targetAccountId !== undefined && {\n        targetAccountId: specificArgs.targetAccountId,\n      }),\n      ...(specificArgs.monitorDurationSeconds !== undefined && {\n        monitorDurationSeconds: specificArgs.monitorDurationSeconds,\n      }),\n      hbarFees: (specificArgs.hbarFees || []) as Array<{\n        amount: number;\n        collectorAccount?: string;\n      }>,\n      tokenFees: (specificArgs.tokenFees || []) as Array<{\n        amount: number;\n        tokenId: string;\n        collectorAccount?: string;\n      }>,\n      ...(specificArgs.exemptAccountIds !== undefined && {\n        exemptAccountIds: specificArgs.exemptAccountIds,\n      }),\n      ...(specificArgs.defaultCollectorAccount !== undefined && {\n        defaultCollectorAccount: specificArgs.defaultCollectorAccount,\n      }),\n    });\n  }\n}\n"],"names":[],"mappings":";;AAMA,MAAM,6BAA6B,EAAE,OAAO;AAAA,EAC1C,WAAW,EACR,UACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,iBAAiB,EACd,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,UAAU,EACP;AAAA,IACC,EAAE,OAAO;AAAA,MACP,QAAQ,EAAE,OAAA;AAAA,MACV,kBAAkB,EAAE,OAAA,EAAS,SAAA;AAAA,IAAS,CACvC;AAAA,EAAA,EAEF,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,WAAW,EACR;AAAA,IACC,EAAE,OAAO;AAAA,MACP,QAAQ,EAAE,OAAA;AAAA,MACV,SAAS,EAAE,OAAA;AAAA,MACX,kBAAkB,EAAE,OAAA,EAAS,SAAA;AAAA,IAAS,CACvC;AAAA,EAAA,EAEF,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,kBAAkB,EACf,MAAM,EAAE,QAAQ,EAChB,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,wBAAwB,EACrB,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,yBAAyB,EACtB,SACA,WACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAKM,MAAM,8BAA8B,yBAEzC;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,aAAa,mBAAmB;AAAA,MACpC,GAAI,aAAa,cAAc,UAAa;AAAA,QAC1C,WAAW,aAAa;AAAA,MAAA;AAAA,MAE1B,GAAI,aAAa,oBAAoB,UAAa;AAAA,QAChD,iBAAiB,aAAa;AAAA,MAAA;AAAA,MAEhC,GAAI,aAAa,2BAA2B,UAAa;AAAA,QACvD,wBAAwB,aAAa;AAAA,MAAA;AAAA,MAEvC,UAAW,aAAa,YAAY,CAAA;AAAA,MAIpC,WAAY,aAAa,aAAa,CAAA;AAAA,MAKtC,GAAI,aAAa,qBAAqB,UAAa;AAAA,QACjD,kBAAkB,aAAa;AAAA,MAAA;AAAA,MAEjC,GAAI,aAAa,4BAA4B,UAAa;AAAA,QACxD,yBAAyB,aAAa;AAAA,MAAA;AAAA,IACxC,CACD;AAAA,EACH;AACF;"}
+{"version":3,"file":"standards-agent-kit.es15.js","sources":["../../src/tools/hcs10/CheckMessagesTool.ts"],"sourcesContent":["import { z } from 'zod';\nimport { BaseHCS10QueryTool } from './base-hcs10-tools';\nimport { HCS10QueryToolParams } from './hcs10-tool-params';\n\n/**\n * A tool to check for new messages on an active HCS-10 connection topic,\n * or optionally fetch the latest messages regardless of timestamp.\n */\nconst CheckMessagesZodSchema = z.object({\n  targetIdentifier: z\n    .string()\n    .describe(\n      \"The account ID (e.g., 0.0.12345) of the target agent OR the connection number (e.g., '1', '2') from the 'list_connections' tool to check messages for.\"\n    ),\n  fetchLatest: z\n    .boolean()\n    .optional()\n    .default(false)\n    .describe(\n      'Set to true to fetch the latest messages even if they have been seen before, ignoring the last checked timestamp. Defaults to false (fetching only new messages).'\n    ),\n  lastMessagesCount: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(\n      'When fetchLatest is true, specifies how many of the most recent messages to retrieve. Defaults to 1.'\n    ),\n});\n\nexport class CheckMessagesTool extends BaseHCS10QueryTool<\n  typeof CheckMessagesZodSchema\n> {\n  name = 'check_messages';\n  description = `Checks for and retrieves messages from an active connection.\nIdentify the target agent using their account ID (e.g., 0.0.12345) or the connection number shown in 'list_connections'.\nBy default, it only retrieves messages newer than the last check.\nUse 'fetchLatest: true' to get the most recent messages regardless of when they arrived.\nUse 'lastMessagesCount' to specify how many latest messages to retrieve (default 1 when fetchLatest is true).`;\n  specificInputSchema = CheckMessagesZodSchema;\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n  }\n\n  protected async executeQuery({\n    targetIdentifier,\n    fetchLatest,\n    lastMessagesCount,\n  }: z.infer<typeof CheckMessagesZodSchema>): Promise<unknown> {\n    const hcs10Builder = this.hcs10Builder;\n    await hcs10Builder.checkMessages({\n      targetIdentifier,\n      fetchLatest,\n      lastMessagesCount: lastMessagesCount || 1,\n    });\n\n    const result = await hcs10Builder.execute();\n\n    if (result.success && 'rawResult' in result && result.rawResult) {\n      const raw = result.rawResult as {\n        formattedOutput?: string;\n        message?: string;\n      };\n      return {\n        success: true,\n        data: raw.formattedOutput || raw.message || 'Messages checked',\n      };\n    }\n\n    return result;\n  }\n}"],"names":[],"mappings":";;AAQA,MAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,kBAAkB,EACf,OAAA,EACA;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,aAAa,EACV,QAAA,EACA,WACA,QAAQ,KAAK,EACb;AAAA,IACC;AAAA,EAAA;AAAA,EAEJ,mBAAmB,EAChB,SACA,MACA,SAAA,EACA,SAAA,EACA;AAAA,IACC;AAAA,EAAA;AAEN,CAAC;AAEM,MAAM,0BAA0B,mBAErC;AAAA,EAQA,YAAY,QAA8B;AACxC,UAAM,MAAM;AARd,SAAA,OAAO;AACP,SAAA,cAAc;AAAA;AAAA;AAAA;AAAA;AAKd,SAAA,sBAAsB;AAAA,EAGtB;AAAA,EAEA,MAAgB,aAAa;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,EAAA,GAC2D;AAC3D,UAAM,eAAe,KAAK;AAC1B,UAAM,aAAa,cAAc;AAAA,MAC/B;AAAA,MACA;AAAA,MACA,mBAAmB,qBAAqB;AAAA,IAAA,CACzC;AAED,UAAM,SAAS,MAAM,aAAa,QAAA;AAElC,QAAI,OAAO,WAAW,eAAe,UAAU,OAAO,WAAW;AAC/D,YAAM,MAAM,OAAO;AAInB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,MAAM,IAAI,mBAAmB,IAAI,WAAW;AAAA,MAAA;AAAA,IAEhD;AAEA,WAAO;AAAA,EACT;AACF;"}

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

@@ -1,35 +1,62 @@
 import { z } from "zod";
-import { BaseHCS10QueryTool } from "./standards-agent-kit.es8.js";
-const ManageConnectionRequestsZodSchema = z.object({
-  action: z.enum(["list", "view", "reject"]).describe(
-    "The action to perform: list all requests, view details of a specific request, or reject a request"
+import { AIAgentCapability } from "@hashgraphonline/standards-sdk";
+import { BaseHCS10QueryTool } from "./standards-agent-kit.es10.js";
+import { NaturalLanguageMapper } from "./standards-agent-kit.es22.js";
+const FindRegistrationsZodSchema = z.object({
+  accountId: z.string().optional().describe(
+    "Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345)."
   ),
-  requestKey: z.string().optional().describe(
-    "The unique request key to view or reject (required for view and reject actions)"
+  tags: 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(
+    'Optional: Filter by capabilities/tags like "ai", "data", "analytics". Can be natural language terms or capability numbers.'
   )
 });
-class ManageConnectionRequestsTool extends BaseHCS10QueryTool {
+class FindRegistrationsTool extends BaseHCS10QueryTool {
   constructor(params) {
     super(params);
-    this.name = "manage_connection_requests";
-    this.description = 'Manage incoming connection requests. List pending requests, view details about requesting agents, and reject connection requests. Use the separate "accept_connection_request" tool to accept.';
-    this.specificInputSchema = ManageConnectionRequestsZodSchema;
+    this.name = "find_registrations";
+    this.description = 'Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags/capabilities using natural language like "ai", "data processing", "analytics". Returns basic registration info.';
+    this.specificInputSchema = FindRegistrationsZodSchema;
   }
   async executeQuery({
-    action,
-    requestKey
+    accountId,
+    tags
   }) {
     const hcs10Builder = this.hcs10Builder;
-    const params = { action };
-    if (requestKey !== void 0) {
-      params.requestKey = requestKey;
+    const params = {};
+    if (accountId) {
+      params.accountId = accountId;
     }
-    await hcs10Builder.manageConnectionRequests(params);
+    if (tags) {
+      params.tags = tags;
+    }
+    await hcs10Builder.findRegistrations(params);
     const result = await hcs10Builder.execute();
-    return "rawResult" in result ? result.rawResult : result;
+    if (result.success && "rawResult" in result && result.rawResult) {
+      const raw = result.rawResult;
+      return {
+        success: true,
+        data: raw.formattedOutput || raw.message || "Registrations searched"
+      };
+    }
+    return result;
   }
 }
 export {
-  ManageConnectionRequestsTool
+  FindRegistrationsTool
 };
 //# sourceMappingURL=standards-agent-kit.es16.js.map