@hashgraphonline/standards-agent-kit 0.2.105 → 0.2.107

package/dist/cjs/tools/hcs10/SendMessageToConnectionTool.d.ts

@@ -3,16 +3,22 @@ import { BaseHCS10TransactionTool } from './base-hcs10-tools';
 import { HCS10TransactionToolParams } from './hcs10-tool-params';
 import { BaseServiceBuilder } from 'hedera-agent-kit';
 declare const SendMessageToConnectionZodSchema: z.ZodObject<{
-    targetIdentifier: z.ZodString;
+    targetIdentifier: z.ZodOptional<z.ZodString>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
     message: z.ZodString;
     disableMonitoring: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     message: string;
-    targetIdentifier: string;
     disableMonitoring: boolean;
+    targetIdentifier?: string | undefined;
+    connectionId?: string | undefined;
+    agentId?: string | undefined;
 }, {
     message: string;
-    targetIdentifier: string;
+    targetIdentifier?: string | undefined;
+    connectionId?: string | undefined;
+    agentId?: string | undefined;
     disableMonitoring?: boolean | undefined;
 }>;
 /**
@@ -22,16 +28,22 @@ export declare class SendMessageToConnectionTool extends BaseHCS10TransactionToo
     name: string;
     description: string;
     specificInputSchema: z.ZodObject<{
-        targetIdentifier: z.ZodString;
+        targetIdentifier: z.ZodOptional<z.ZodString>;
+        connectionId: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
         message: z.ZodString;
         disableMonitoring: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         message: string;
-        targetIdentifier: string;
         disableMonitoring: boolean;
+        targetIdentifier?: string | undefined;
+        connectionId?: string | undefined;
+        agentId?: string | undefined;
     }, {
         message: string;
-        targetIdentifier: string;
+        targetIdentifier?: string | undefined;
+        connectionId?: string | undefined;
+        agentId?: string | undefined;
         disableMonitoring?: boolean | undefined;
     }>;
     constructor(params: HCS10TransactionToolParams);

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

@@ -10,7 +10,7 @@ class ListConnectionsTool extends BaseHCS10QueryTool {
   constructor(params) {
     super(params);
     this.name = "list_connections";
-    this.description = "Lists the currently active HCS-10 connections with detailed information. Shows connection status, agent details, and recent activity. Use this to get a comprehensive view of all active 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(args) {

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es10.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 the currently active HCS-10 connections with detailed information. Shows connection status, agent details, and recent activity. Use this to get a comprehensive view of all active connections.';\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.es10.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.es2.js

@@ -683,31 +683,64 @@ class HCS10Builder extends BaseServiceBuilder {
         );
       }
       let connection;
-      if (params.targetIdentifier.includes("@")) {
-        const parts = params.targetIdentifier.split("@");
+      const identifier = params.targetIdentifier;
+      if (identifier.includes("@")) {
+        const parts = identifier.split("@");
         if (parts.length === 2) {
           const accountId = parts[1];
           connection = this.stateManager.getConnectionByIdentifier(accountId);
           if (!connection) {
             this.addNote(
-              `Could not find connection using request key '${params.targetIdentifier}', extracted account ID '${accountId}'.`
+              `Could not find connection using request key '${identifier}', extracted account ID '${accountId}'.`
             );
           }
         }
       }
       if (!connection) {
-        connection = this.stateManager.getConnectionByIdentifier(
-          params.targetIdentifier
-        );
+        connection = this.stateManager.getConnectionByIdentifier(identifier);
+      }
+      if (!connection && !identifier.startsWith("0.0.") && /^\d+$/.test(identifier)) {
+        const accountIdWithPrefix = `0.0.${identifier}`;
+        connection = this.stateManager.getConnectionByIdentifier(accountIdWithPrefix);
+        if (connection) {
+          this.addNote(
+            `Found connection using account ID with prefix: ${accountIdWithPrefix}`
+          );
+        }
+      }
+      if (!connection && /^[1-9]\d*$/.test(identifier)) {
+        const connections = this.stateManager.listConnections();
+        const index = parseInt(identifier) - 1;
+        if (index >= 0 && index < connections.length) {
+          connection = connections[index];
+          if (connection) {
+            this.addNote(
+              `Found connection by index ${identifier}: ${connection.targetAccountId}`
+            );
+          }
+        }
       }
       if (!connection) {
         const connections = this.stateManager.listConnections();
         const availableIds = connections.map(
-          (c) => `${c.targetAccountId} (${c.connectionTopicId})`
-        );
-        throw new Error(
-          `Connection not found for identifier: ${params.targetIdentifier}. Available connections: ${availableIds.join(", ") || "none"}. Use 'list_connections' to see details.`
+          (c, i) => `${i + 1}. ${c.targetAccountId} (Topic: ${c.connectionTopicId})`
         );
+        let errorMsg = `Connection not found for identifier: "${identifier}"
+`;
+        errorMsg += `Available connections:
+${availableIds.join("\n") || "No active connections"}`;
+        errorMsg += `
+
+You can use:
+`;
+        errorMsg += `- Connection number (e.g., "1", "2")
+`;
+        errorMsg += `- Account ID (e.g., "0.0.6412936")
+`;
+        errorMsg += `- Connection topic ID
+`;
+        errorMsg += `Use 'list_connections' to see all active connections.`;
+        throw new Error(errorMsg);
       }
       let connectionTopicId = connection.connectionTopicId;
       if (connectionTopicId && typeof connectionTopicId === "object" && "toString" in connectionTopicId) {