@hashgraphonline/standards-agent-kit 0.0.18 → 0.0.19

package/dist/tools/ConnectionTool.js

@@ -0,0 +1,114 @@
+import { StructuredTool as l } from "../node_modules/@langchain/core/dist/tools.js";
+import { z as h } from "zod";
+import { Logger as m } from "@hashgraphonline/standards-sdk";
+class $ extends l {
+  /**
+   * @param client - Instance of HCS10Client.
+   * @param stateManager - Instance of StateManager for shared state management.
+   */
+  constructor({ client: t, stateManager: o, ...n }) {
+    super(n), this.name = "monitor_connections", this.description = "Starts passively LISTENING on the current agent's own inbound topic for INCOMING HCS-10 connection requests. Handles received requests automatically. Takes NO arguments. DO NOT use this to start a new connection TO someone else.", this.isMonitoring = !1, this.monitoringTopic = null, this.schema = h.object({}), this.client = t, this.stateManager = o, this.logger = m.getInstance({
+      module: "ConnectionTool",
+      level: "info"
+    });
+  }
+  /**
+   * Initiates the connection request monitoring process in the background.
+   * Gets the inbound topic ID from the configured client.
+   */
+  async _call(t) {
+    let o;
+    try {
+      o = await this.client.getInboundTopicId();
+    } catch (n) {
+      const i = `Error getting inbound topic ID for monitoring: ${n instanceof Error ? n.message : String(n)}`;
+      return this.logger.error(i), i;
+    }
+    return o ? this.isMonitoring ? this.monitoringTopic === o ? `Already monitoring topic ${o}.` : `Error: Already monitoring a different topic (${this.monitoringTopic}). Stop the current monitor first.` : (this.isMonitoring = !0, this.monitoringTopic = o, this.logger.info(
+      `Initiating connection request monitoring for topic ${o}...`
+    ), this.monitorIncomingRequests(o).catch((n) => {
+      this.logger.error(
+        `Monitoring loop for ${o} encountered an unrecoverable error:`,
+        n
+      ), this.isMonitoring = !1, this.monitoringTopic = null;
+    }), `Started monitoring inbound topic ${o} for connection requests in the background.`) : "Error: Could not determine the inbound topic ID for the current agent.";
+  }
+  /**
+   * The core monitoring loop.
+   */
+  async monitorIncomingRequests(t) {
+    this.logger.info(`Monitoring inbound topic ${t}...`);
+    let o = 0;
+    const n = /* @__PURE__ */ new Set();
+    for (; this.isMonitoring && this.monitoringTopic === t; ) {
+      try {
+        const a = (await this.client.getMessages(t)).messages.filter(
+          (r) => r.op === "connection_request" && typeof r.sequence_number == "number" && r.sequence_number > o
+        );
+        for (const r of a) {
+          o = Math.max(
+            o,
+            r.sequence_number
+          );
+          const e = r.sequence_number, g = r.operator_id || "", s = g.split("@")[1] || null;
+          if (!s) {
+            this.logger.warn(
+              `Could not determine requesting account ID from operator_id '${g}' for request #${e}. Skipping.`
+            );
+            continue;
+          }
+          if (n.has(e)) {
+            this.logger.info(
+              `Connection request #${e} already processed in this session. Skipping.`
+            );
+            continue;
+          }
+          this.logger.info(
+            `Processing connection request #${e} from account ${s}...`
+          );
+          try {
+            const c = await this.client.handleConnectionRequest(
+              t,
+              s,
+              e
+            );
+            n.add(e), this.logger.info(
+              `Connection confirmed for request #${e}. New connection topic: ${c.connectionTopicId}`
+            );
+            const u = {
+              targetAccountId: s,
+              targetAgentName: `Agent ${s}`,
+              targetInboundTopicId: "N/A",
+              connectionTopicId: c.connectionTopicId
+            };
+            this.stateManager.addActiveConnection(u), this.logger.info(
+              `Added new active connection to ${s} state.`
+            );
+          } catch (c) {
+            this.logger.error(
+              `Error handling connection request #${e} from ${s}:`,
+              c
+            );
+          }
+        }
+      } catch (i) {
+        this.logger.error(
+          `Error fetching or processing messages for topic ${t}:`,
+          i
+        );
+      }
+      await new Promise((i) => setTimeout(i, 5e3));
+    }
+    this.logger.info(`Monitoring loop stopped for topic ${t}.`), this.isMonitoring = !1, this.monitoringTopic = null;
+  }
+  // Optional: Method to explicitly stop monitoring
+  stopMonitoring() {
+    this.isMonitoring ? (this.logger.info(
+      `Stopping monitoring for topic ${this.monitoringTopic}...`
+    ), this.isMonitoring = !1, this.monitoringTopic = null) : this.logger.info("Monitor is not currently running.");
+  }
+}
+export {
+  $ as ConnectionTool
+};
+//# sourceMappingURL=ConnectionTool.js.map

package/dist/tools/ConnectionTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionTool.js","sources":["../../src/tools/ConnectionTool.ts"],"sourcesContent":["import { HCS10Client } from '../hcs10/HCS10Client';\nimport { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\n// Import FeeConfigBuilder if needed for explicit fee handling\n// import { FeeConfigBuilder } from '@hashgraphonline/standards-sdk';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport {\n  IStateManager,\n  ActiveConnection,\n} from '../state/state-types'; // Corrected import path/name\n\nexport interface ConnectionToolParams extends ToolParams {\n  client: HCS10Client;\n  stateManager: IStateManager;\n}\n\n/**\n * ConnectionTool monitors the *current* agent's inbound topic for connection requests\n * and automatically handles them using the HCS-10 standard SDK flow.\n * Use this ONLY to passively LISTEN for other agents trying to connect TO YOU.\n * This tool takes NO arguments and does NOT start outgoing connections.\n */\nexport class ConnectionTool extends StructuredTool {\n  name = 'monitor_connections';\n  description =\n    \"Starts passively LISTENING on the current agent's own inbound topic for INCOMING HCS-10 connection requests. Handles received requests automatically. Takes NO arguments. DO NOT use this to start a new connection TO someone else.\";\n  public client: HCS10Client;\n  public logger: Logger;\n  private stateManager: IStateManager; // Renamed property\n  private isMonitoring: boolean = false; // Flag to prevent multiple monitors\n  private monitoringTopic: string | null = null;\n\n  // Schema now takes NO arguments\n  schema = z.object({});\n\n  /**\n   * @param client - Instance of HCS10Client.\n   * @param stateManager - Instance of StateManager for shared state management.\n   */\n  constructor({ client, stateManager, ...rest }: ConnectionToolParams) {\n    super(rest);\n    this.client = client;\n    this.stateManager = stateManager; // Renamed assignment\n    this.logger = Logger.getInstance({\n      module: 'ConnectionTool',\n      level: 'info',\n    });\n  }\n\n  /**\n   * Initiates the connection request monitoring process in the background.\n   * Gets the inbound topic ID from the configured client.\n   */\n  async _call(_input: z.infer<typeof this.schema>): Promise<string> {\n    // Get inboundTopicId from the client\n    let inboundTopicId: string;\n    try {\n      // Assuming getInboundTopicId() is implemented and available\n      inboundTopicId = await this.client.getInboundTopicId();\n    } catch (error) {\n      const errorMsg = `Error getting inbound topic ID for monitoring: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n      this.logger.error(errorMsg);\n      return errorMsg;\n    }\n\n    if (!inboundTopicId) {\n      return 'Error: Could not determine the inbound topic ID for the current agent.';\n    }\n\n    if (this.isMonitoring) {\n      if (this.monitoringTopic === inboundTopicId) {\n        return `Already monitoring topic ${inboundTopicId}.`;\n      } else {\n        return `Error: Already monitoring a different topic (${this.monitoringTopic}). Stop the current monitor first.`;\n        // TODO: Add a mechanism to stop the monitor if needed.\n      }\n    }\n\n    this.isMonitoring = true;\n    this.monitoringTopic = inboundTopicId;\n    this.logger.info(\n      `Initiating connection request monitoring for topic ${inboundTopicId}...`\n    );\n\n    // Start the monitoring process asynchronously without awaiting it\n    // This allows the tool call to return quickly.\n    this.monitorIncomingRequests(inboundTopicId).catch((error) => {\n      this.logger.error(\n        `Monitoring loop for ${inboundTopicId} encountered an unrecoverable error:`,\n        error\n      );\n      this.isMonitoring = false; // Reset flag on loop failure\n      this.monitoringTopic = null;\n    });\n\n    return `Started monitoring inbound topic ${inboundTopicId} for connection requests in the background.`;\n  }\n\n  /**\n   * The core monitoring loop.\n   */\n  private async monitorIncomingRequests(inboundTopicId: string): Promise<void> {\n    this.logger.info(`Monitoring inbound topic ${inboundTopicId}...`);\n\n    let lastProcessedMessageSequence = 0;\n    const processedRequestIds = new Set<number>(); // Track processed requests within this monitoring session\n\n    // Main monitoring loop\n    while (this.isMonitoring && this.monitoringTopic === inboundTopicId) {\n      try {\n        const messagesResult = await this.client.getMessages(inboundTopicId);\n\n        const connectionRequests = messagesResult.messages.filter(\n          (msg) =>\n            msg.op === 'connection_request' &&\n            typeof msg.sequence_number === 'number' &&\n            msg.sequence_number > lastProcessedMessageSequence\n        );\n\n        for (const message of connectionRequests) {\n          lastProcessedMessageSequence = Math.max(\n            lastProcessedMessageSequence,\n            message.sequence_number\n          );\n          const connectionRequestId = message.sequence_number;\n\n          // Extract requesting account ID from the message's operator_id field (topic@account)\n          const senderOperatorId = message.operator_id || '';\n          const requestingAccountId = senderOperatorId.split('@')[1] || null;\n\n          if (!requestingAccountId) {\n            this.logger.warn(\n              `Could not determine requesting account ID from operator_id '${senderOperatorId}' for request #${connectionRequestId}. Skipping.`\n            );\n            continue;\n          }\n\n          if (processedRequestIds.has(connectionRequestId)) {\n            this.logger.info(\n              `Connection request #${connectionRequestId} already processed in this session. Skipping.`\n            );\n            continue;\n          }\n\n          this.logger.info(\n            `Processing connection request #${connectionRequestId} from account ${requestingAccountId}...`\n          );\n\n          try {\n            // Handle the connection request using the HCS10Client wrapper\n            const confirmation = await this.client.handleConnectionRequest(\n              inboundTopicId,\n              requestingAccountId,\n              connectionRequestId\n            );\n\n            processedRequestIds.add(connectionRequestId);\n            this.logger.info(\n              `Connection confirmed for request #${connectionRequestId}. New connection topic: ${confirmation.connectionTopicId}`\n            );\n\n            // Use stateManager to add connection\n            const newConnection: ActiveConnection = {\n              targetAccountId: requestingAccountId,\n              targetAgentName: `Agent ${requestingAccountId}`,\n              targetInboundTopicId: 'N/A',\n              connectionTopicId: confirmation.connectionTopicId,\n            };\n            this.stateManager.addActiveConnection(newConnection);\n            this.logger.info(\n              `Added new active connection to ${requestingAccountId} state.`\n            );\n          } catch (handleError) {\n            this.logger.error(\n              `Error handling connection request #${connectionRequestId} from ${requestingAccountId}:`,\n              handleError\n            );\n          }\n        }\n      } catch (error) {\n        this.logger.error(\n          `Error fetching or processing messages for topic ${inboundTopicId}:`,\n          error\n        );\n        // Implement backoff or error threshold if needed\n      }\n\n      // Wait before the next poll\n      await new Promise((resolve) => setTimeout(resolve, 5000)); // Poll every 5 seconds (adjust as needed)\n    }\n\n    this.logger.info(`Monitoring loop stopped for topic ${inboundTopicId}.`);\n    this.isMonitoring = false; // Ensure flag is reset when loop exits\n    this.monitoringTopic = null;\n  }\n\n  // Optional: Method to explicitly stop monitoring\n  public stopMonitoring(): void {\n    if (this.isMonitoring) {\n      this.logger.info(\n        `Stopping monitoring for topic ${this.monitoringTopic}...`\n      );\n      this.isMonitoring = false;\n      this.monitoringTopic = null;\n    } else {\n      this.logger.info('Monitor is not currently running.');\n    }\n  }\n}\n"],"names":["ConnectionTool","StructuredTool","client","stateManager","rest","z","Logger","_input","inboundTopicId","error","errorMsg","lastProcessedMessageSequence","processedRequestIds","connectionRequests","msg","message","connectionRequestId","senderOperatorId","requestingAccountId","confirmation","newConnection","handleError","resolve"],"mappings":"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"}

package/dist/tools/FindRegistrationsTool.d.ts

@@ -0,0 +1,27 @@
+import { StructuredTool, ToolParams } from '@langchain/core/tools';
+import { z } from 'zod';
+import { HCS10Client } from '../hcs10/HCS10Client';
+export interface FindRegistrationsToolParams extends ToolParams {
+    hcsClient: HCS10Client;
+}
+/**
+ * A tool to search for registered HCS-10 agents using the configured registry.
+ */
+export declare class FindRegistrationsTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        accountId: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        accountId?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        accountId?: string | undefined;
+        tags?: string[] | undefined;
+    }>;
+    private hcsClient;
+    private logger;
+    constructor({ hcsClient, ...rest }: FindRegistrationsToolParams);
+    protected _call({ accountId, tags, }: z.infer<this['schema']>): Promise<string>;
+}

package/dist/tools/FindRegistrationsTool.js

@@ -0,0 +1,64 @@
+import { StructuredTool as g } from "../node_modules/@langchain/core/dist/tools.js";
+import { z as a } from "zod";
+import { Logger as l } from "@hashgraphonline/standards-sdk";
+class p extends g {
+  constructor({ hcsClient: o, ...e }) {
+    super(e), this.name = "find_registrations", this.description = "Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags. Returns basic registration info.", this.schema = a.object({
+      accountId: a.string().optional().describe(
+        "Optional: Filter registrations by a specific Hedera account ID (e.g., 0.0.12345)."
+      ),
+      tags: a.array(a.string()).optional().describe(
+        "Optional: Filter registrations by a list of tags (API filter only)."
+      )
+    }), this.hcsClient = o, this.logger = l.getInstance({ module: "FindRegistrationsTool" });
+  }
+  async _call({
+    accountId: o,
+    tags: e
+  }) {
+    this.logger.info(
+      "Searching registrations with filters - Account ID",
+      JSON.stringify({
+        accountId: o,
+        tags: e
+      })
+    );
+    const s = {};
+    o && (s.accountId = o), e && e.length > 0 && (s.tags = e), s.network = this.hcsClient.getNetwork();
+    try {
+      if (!this.hcsClient.standardClient)
+        throw new Error(
+          "Standard SDK client instance is not available in HCS10Client wrapper."
+        );
+      const t = await this.hcsClient.standardClient.findRegistrations(
+        s
+      );
+      if (!t.success || t.error)
+        return `Error finding registrations: ${t.error || "Unknown error"}`;
+      if (!t.registrations || t.registrations.length === 0)
+        return "No registrations found matching the criteria.";
+      let i = `Found ${t.registrations.length} registration(s):
+`;
+      return t.registrations.forEach((n, c) => {
+        const r = n.metadata;
+        i += `${c + 1}. Name: ${r.name || "N/A"}
+`, i += `Description: ${r.description || "N/A"}
+`, i += `   Account ID: ${n.account_id}
+`, i += `   Status: ${n.status}
+`, i += `   Model: ${r.model || "N/A"}
+`, r.tags && r.tags.length > 0 && (i += `   Tags: ${r.tags.join(", ")}
+`), r.properties && (i += `   Properties: ${JSON.stringify(r.properties)}
+`), i += `   Inbound Topic: ${n.inbound_topic_id}
+`, i += `   Outbound Topic: ${n.outbound_topic_id}
+`, i += `   Created At: ${n.created_at}
+`;
+      }), i.trim();
+    } catch (t) {
+      return this.logger.error(`Failed to execute findRegistrations: ${t}`), `Error searching registrations: ${t instanceof Error ? t.message : String(t)}`;
+    }
+  }
+}
+export {
+  p as FindRegistrationsTool
+};
+//# sourceMappingURL=FindRegistrationsTool.js.map

package/dist/tools/FindRegistrationsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindRegistrationsTool.js","sources":["../../src/tools/FindRegistrationsTool.ts"],"sourcesContent":["import { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HCS10Client } from '../hcs10/HCS10Client';\nimport {\n  Logger,\n  RegistrationSearchOptions,\n} from '@hashgraphonline/standards-sdk';\n\nexport interface FindRegistrationsToolParams extends ToolParams {\n  hcsClient: HCS10Client;\n}\n\n/**\n * A tool to search for registered HCS-10 agents using the configured registry.\n */\nexport class FindRegistrationsTool extends StructuredTool {\n  name = 'find_registrations';\n  description =\n    'Searches the configured agent registry for HCS-10 agents. You can filter by account ID or tags. Returns basic registration info.';\n  schema = 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      .array(z.string())\n      .optional()\n      .describe(\n        'Optional: Filter registrations by a list of tags (API filter only).'\n      ),\n  });\n\n  private hcsClient: HCS10Client;\n  private logger: Logger;\n\n  constructor({ hcsClient, ...rest }: FindRegistrationsToolParams) {\n    super(rest);\n    this.hcsClient = hcsClient;\n    this.logger = Logger.getInstance({ module: 'FindRegistrationsTool' });\n  }\n\n  protected async _call({\n    accountId,\n    tags,\n  }: z.infer<this['schema']>): Promise<string> {\n    this.logger.info(\n      'Searching registrations with filters - Account ID',\n      JSON.stringify({\n        accountId,\n        tags,\n      })\n    );\n\n    const options: RegistrationSearchOptions = {};\n    if (accountId) {\n      options.accountId = accountId;\n    }\n    if (tags && tags.length > 0) {\n      options.tags = tags;\n    }\n    options.network = this.hcsClient.getNetwork();\n\n    try {\n      if (!this.hcsClient.standardClient) {\n        throw new Error(\n          'Standard SDK client instance is not available in HCS10Client wrapper.'\n        );\n      }\n      const result = await this.hcsClient.standardClient.findRegistrations(\n        options\n      );\n\n      if (!result.success || result.error) {\n        return `Error finding registrations: ${\n          result.error || 'Unknown error'\n        }`;\n      }\n\n      if (!result.registrations || result.registrations.length === 0) {\n        return 'No registrations found matching the criteria.';\n      }\n\n      // Format the results based on available data from RegistrationSearchResult\n      let output = `Found ${result.registrations.length} registration(s):\\n`;\n      result.registrations.forEach((reg, index: number) => {\n        const metadata: any = reg.metadata;\n        output += `${index + 1}. Name: ${metadata.name || 'N/A'}\\n`;\n        output += `Description: ${metadata.description || 'N/A'}\\n`;\n        output += `   Account ID: ${reg.account_id}\\n`;\n        output += `   Status: ${reg.status}\\n`;\n        output += `   Model: ${metadata.model || 'N/A'}\\n`;\n        if (metadata.tags && metadata.tags.length > 0) {\n          output += `   Tags: ${metadata.tags.join(', ')}\\n`;\n        }\n        if (metadata.properties) {\n          output += `   Properties: ${JSON.stringify(metadata.properties)}\\n`;\n        }\n        output += `   Inbound Topic: ${reg.inbound_topic_id}\\n`;\n        output += `   Outbound Topic: ${reg.outbound_topic_id}\\n`;\n        output += `   Created At: ${reg.created_at}\\n`;\n      });\n\n      return output.trim();\n    } catch (error) {\n      this.logger.error(`Failed to execute findRegistrations: ${error}`);\n      return `Error searching registrations: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n}\n"],"names":["FindRegistrationsTool","StructuredTool","hcsClient","rest","z","Logger","accountId","tags","options","result","output","reg","index","metadata","error"],"mappings":";;;AAeO,MAAMA,UAA8BC,EAAe;AAAA,EAsBxD,YAAY,EAAE,WAAAC,GAAW,GAAGC,KAAqC;AAC/D,UAAMA,CAAI,GAtBL,KAAA,OAAA,sBAEL,KAAA,cAAA,oIACF,KAAA,SAASC,EAAE,OAAO;AAAA,MAChB,WAAWA,EACR,SACA,SACA,EAAA;AAAA,QACC;AAAA,MACF;AAAA,MACF,MAAMA,EACH,MAAMA,EAAE,QAAQ,EAChB,WACA;AAAA,QACC;AAAA,MAAA;AAAA,IACF,CACH,GAOC,KAAK,YAAYF,GACjB,KAAK,SAASG,EAAO,YAAY,EAAE,QAAQ,yBAAyB;AAAA,EAAA;AAAA,EAGtE,MAAgB,MAAM;AAAA,IACpB,WAAAC;AAAA,IACA,MAAAC;AAAA,EAAA,GAC2C;AAC3C,SAAK,OAAO;AAAA,MACV;AAAA,MACA,KAAK,UAAU;AAAA,QACb,WAAAD;AAAA,QACA,MAAAC;AAAA,MACD,CAAA;AAAA,IACH;AAEA,UAAMC,IAAqC,CAAC;AAC5C,IAAIF,MACFE,EAAQ,YAAYF,IAElBC,KAAQA,EAAK,SAAS,MACxBC,EAAQ,OAAOD,IAETC,EAAA,UAAU,KAAK,UAAU,WAAW;AAExC,QAAA;AACE,UAAA,CAAC,KAAK,UAAU;AAClB,cAAM,IAAI;AAAA,UACR;AAAA,QACF;AAEF,YAAMC,IAAS,MAAM,KAAK,UAAU,eAAe;AAAA,QACjDD;AAAA,MACF;AAEA,UAAI,CAACC,EAAO,WAAWA,EAAO;AACrB,eAAA,gCACLA,EAAO,SAAS,eAClB;AAGF,UAAI,CAACA,EAAO,iBAAiBA,EAAO,cAAc,WAAW;AACpD,eAAA;AAIT,UAAIC,IAAS,SAASD,EAAO,cAAc,MAAM;AAAA;AACjD,aAAAA,EAAO,cAAc,QAAQ,CAACE,GAAKC,MAAkB;AACnD,cAAMC,IAAgBF,EAAI;AAC1B,QAAAD,KAAU,GAAGE,IAAQ,CAAC,WAAWC,EAAS,QAAQ,KAAK;AAAA,GAC7CH,KAAA,gBAAgBG,EAAS,eAAe,KAAK;AAAA,GAC7CH,KAAA,kBAAkBC,EAAI,UAAU;AAAA,GAChCD,KAAA,cAAcC,EAAI,MAAM;AAAA,GACxBD,KAAA,aAAaG,EAAS,SAAS,KAAK;AAAA,GAC1CA,EAAS,QAAQA,EAAS,KAAK,SAAS,MAC1CH,KAAU,YAAYG,EAAS,KAAK,KAAK,IAAI,CAAC;AAAA,IAE5CA,EAAS,eACXH,KAAU,kBAAkB,KAAK,UAAUG,EAAS,UAAU,CAAC;AAAA,IAEvDH,KAAA,qBAAqBC,EAAI,gBAAgB;AAAA,GACzCD,KAAA,sBAAsBC,EAAI,iBAAiB;AAAA,GAC3CD,KAAA,kBAAkBC,EAAI,UAAU;AAAA;AAAA,MAAA,CAC3C,GAEMD,EAAO,KAAK;AAAA,aACZI,GAAO;AACd,kBAAK,OAAO,MAAM,wCAAwCA,CAAK,EAAE,GAC1D,kCACLA,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK,CACvD;AAAA,IAAA;AAAA,EACF;AAEJ;"}

package/dist/tools/InitiateConnectionTool.d.ts

@@ -0,0 +1,30 @@
+import { StructuredTool, ToolParams } from '@langchain/core/tools';
+import { z } from 'zod';
+import { HCS10Client } from '../hcs10/HCS10Client';
+import { IStateManager } from '../state/state-types';
+export interface InitiateConnectionToolParams extends ToolParams {
+    hcsClient: HCS10Client;
+    stateManager: IStateManager;
+}
+/**
+ * A tool to actively START a NEW HCS-10 connection TO a target agent.
+ * Requires the target agent's account ID.
+ * It retrieves their profile, sends a connection request, waits for confirmation, and stores the connection using the provided stateManager.
+ * Use this tool ONLY to actively INITIATE an OUTGOING connection.
+ */
+export declare class InitiateConnectionTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        targetAccountId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        targetAccountId: string;
+    }, {
+        targetAccountId: string;
+    }>;
+    private hcsClient;
+    private stateManager;
+    private logger;
+    constructor({ hcsClient, stateManager, ...rest }: InitiateConnectionToolParams);
+    protected _call({ targetAccountId }: z.infer<this['schema']>): Promise<string>;
+}

package/dist/tools/InitiateConnectionTool.js

@@ -0,0 +1,79 @@
+import { StructuredTool as $ } from "../node_modules/@langchain/core/dist/tools.js";
+import { z as C } from "zod";
+import { Logger as w } from "@hashgraphonline/standards-sdk";
+class v extends $ {
+  constructor({
+    hcsClient: n,
+    stateManager: t,
+    ...o
+  }) {
+    super(o), this.name = "initiate_connection", this.description = "Actively STARTS a NEW HCS-10 connection TO a specific target agent identified by their account ID. Requires the targetAccountId parameter. Use this ONLY to INITIATE an OUTGOING connection request.", this.schema = C.object({
+      targetAccountId: C.string().describe(
+        "The Hedera account ID (e.g., 0.0.12345) of the agent you want to connect with."
+      )
+    }), this.hcsClient = n, this.stateManager = t, this.logger = w.getInstance({ module: "InitiateConnectionTool" });
+  }
+  async _call({
+    targetAccountId: n
+  }) {
+    var o;
+    const t = this.stateManager.getCurrentAgent();
+    if (!t)
+      return "Error: Cannot initiate connection. No agent is currently active. Please register or select an agent first.";
+    this.logger.info(
+      `Attempting connection from ${t.accountId} to ${n}`
+    );
+    try {
+      this.logger.debug(`Retrieving profile for ${n}...`);
+      const e = await this.hcsClient.getAgentProfile(
+        n
+      );
+      if (!((o = e == null ? void 0 : e.topicInfo) != null && o.inboundTopic))
+        return `Error: Could not retrieve profile or find inbound topic ID for target agent ${n}. They might not be registered or have a public profile.`;
+      const s = e.topicInfo.inboundTopic, g = e.profile.name || `Agent ${n}`, a = await this.hcsClient.submitConnectionRequest(
+        s,
+        t.name
+      );
+      let i = null;
+      const l = a == null ? void 0 : a.topicSequenceNumber;
+      if (l !== null)
+        try {
+          if (i = l.toNumber(), isNaN(i))
+            throw new Error("Converted sequence number is NaN.");
+        } catch (u) {
+          throw new Error(
+            `Failed to convert connection request sequence number: ${u}`
+          );
+        }
+      else
+        throw new Error("Connection request sequence number not found.");
+      const h = 6e4, d = 2e3, T = Math.ceil(h / d), r = await this.hcsClient.waitForConnectionConfirmation(
+        s,
+        i,
+        T,
+        d
+      );
+      if (!(r != null && r.connectionTopicId))
+        return `Error: Connection confirmation not received from ${n} (for request ${i}) within ${h / 1e3} seconds.`;
+      const c = r.connectionTopicId;
+      this.logger.info(`Connection confirmed! Topic ID: ${c}`);
+      const b = {
+        targetAccountId: n,
+        targetAgentName: g,
+        targetInboundTopicId: s,
+        connectionTopicId: c
+      };
+      this.stateManager.addActiveConnection(b);
+      const f = this.stateManager.listConnections(), m = f.find(
+        (u) => u.connectionTopicId === c
+      ), p = m ? f.indexOf(m) + 1 : null;
+      return `Successfully established connection ${p ? `#${p}` : ""} with ${g} (${n}). Connection Topic: ${c}. You can now send messages using this connection.`;
+    } catch (e) {
+      return this.logger.error(`Connection initiation failed: ${e}`), `Error initiating connection with ${n}: ${e instanceof Error ? e.message : String(e)}`;
+    }
+  }
+}
+export {
+  v as InitiateConnectionTool
+};
+//# sourceMappingURL=InitiateConnectionTool.js.map

package/dist/tools/InitiateConnectionTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InitiateConnectionTool.js","sources":["../../src/tools/InitiateConnectionTool.ts"],"sourcesContent":["import { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HCS10Client } from '../hcs10/HCS10Client';\nimport { IStateManager, ActiveConnection } from '../state/state-types';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\nexport interface InitiateConnectionToolParams extends ToolParams {\n  hcsClient: HCS10Client;\n  stateManager: IStateManager;\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, waits for confirmation, and stores the connection using the provided stateManager.\n * Use this tool ONLY to actively INITIATE an OUTGOING connection.\n */\nexport class InitiateConnectionTool extends StructuredTool {\n  name = 'initiate_connection';\n  description =\n    'Actively STARTS a NEW HCS-10 connection TO a specific target agent identified by their account ID. Requires the targetAccountId parameter. Use this ONLY to INITIATE an OUTGOING connection request.';\n  schema = 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  });\n\n  private hcsClient: HCS10Client;\n  private stateManager: IStateManager;\n  private logger: Logger;\n\n  constructor({\n    hcsClient,\n    stateManager,\n    ...rest\n  }: InitiateConnectionToolParams) {\n    super(rest);\n    this.hcsClient = hcsClient;\n    this.stateManager = stateManager;\n    this.logger = Logger.getInstance({ module: 'InitiateConnectionTool' });\n  }\n\n  protected async _call({\n    targetAccountId\n  }: z.infer<this['schema']>): Promise<string> {\n    const currentAgent = this.stateManager.getCurrentAgent();\n    if (!currentAgent) {\n      return 'Error: Cannot initiate connection. No agent is currently active. Please register or select an agent first.';\n    }\n\n    this.logger.info(\n      `Attempting connection from ${currentAgent.accountId} to ${targetAccountId}`\n    );\n\n    try {\n      this.logger.debug(`Retrieving profile for ${targetAccountId}...`);\n      const targetProfile = await this.hcsClient.getAgentProfile(\n        targetAccountId\n      );\n      if (!targetProfile?.topicInfo?.inboundTopic) {\n        return `Error: Could not retrieve profile or find inbound topic ID for target agent ${targetAccountId}. They might not be registered or have a public profile.`;\n      }\n      const targetInboundTopicId = targetProfile.topicInfo.inboundTopic;\n      const targetAgentName =\n        targetProfile.profile.name || `Agent ${targetAccountId}`;\n\n      const requestResult = await this.hcsClient.submitConnectionRequest(\n        targetInboundTopicId,\n        currentAgent.name\n      );\n      let connectionRequestId: number | null = null;\n      const sequenceNumberLong = requestResult?.topicSequenceNumber;\n      if (sequenceNumberLong !== null) {\n        try {\n          connectionRequestId = sequenceNumberLong.toNumber();\n          if (isNaN(connectionRequestId)) {\n            throw new Error('Converted sequence number is NaN.');\n          }\n        } catch (conversionError) {\n          throw new Error(\n            `Failed to convert connection request sequence number: ${conversionError}`\n          );\n        }\n      } else {\n        throw new Error('Connection request sequence number not found.');\n      }\n\n      const confirmationTimeoutMs = 60000;\n      const delayMs = 2000;\n      const maxAttempts = Math.ceil(confirmationTimeoutMs / delayMs);\n\n      const confirmationResult =\n        await this.hcsClient.waitForConnectionConfirmation(\n          targetInboundTopicId,\n          connectionRequestId,\n          maxAttempts,\n          delayMs\n        );\n\n      if (!confirmationResult?.connectionTopicId) {\n        return `Error: Connection confirmation not received from ${targetAccountId} (for request ${connectionRequestId}) within ${\n          confirmationTimeoutMs / 1000\n        } seconds.`;\n      }\n\n      const connectionTopicId = confirmationResult.connectionTopicId;\n      this.logger.info(`Connection confirmed! Topic ID: ${connectionTopicId}`);\n\n      const newConnection: ActiveConnection = {\n        targetAccountId: targetAccountId,\n        targetAgentName: targetAgentName,\n        targetInboundTopicId: targetInboundTopicId,\n        connectionTopicId: connectionTopicId,\n      };\n      this.stateManager.addActiveConnection(newConnection);\n\n      const connections = this.stateManager.listConnections();\n      const addedEntry = connections.find(\n        (c) => c.connectionTopicId === connectionTopicId\n      );\n      const localConnectionId = addedEntry\n        ? connections.indexOf(addedEntry) + 1\n        : null;\n\n      const idString = localConnectionId ? `#${localConnectionId}` : '';\n\n      return `Successfully established connection ${idString} with ${targetAgentName} (${targetAccountId}). Connection Topic: ${connectionTopicId}. You can now send messages using this connection.`;\n    } catch (error) {\n      this.logger.error(`Connection initiation failed: ${error}`);\n      return `Error initiating connection with ${targetAccountId}: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n}\n"],"names":["InitiateConnectionTool","StructuredTool","hcsClient","stateManager","rest","z","Logger","targetAccountId","currentAgent","targetProfile","_a","targetInboundTopicId","targetAgentName","requestResult","connectionRequestId","sequenceNumberLong","conversionError","confirmationTimeoutMs","delayMs","maxAttempts","confirmationResult","connectionTopicId","newConnection","connections","addedEntry","c","localConnectionId","error"],"mappings":";;;AAiBO,MAAMA,UAA+BC,EAAe;AAAA,EAgBzD,YAAY;AAAA,IACV,WAAAC;AAAA,IACA,cAAAC;AAAA,IACA,GAAGC;AAAA,EAAA,GAC4B;AAC/B,UAAMA,CAAI,GApBL,KAAA,OAAA,uBAEL,KAAA,cAAA,wMACF,KAAA,SAASC,EAAE,OAAO;AAAA,MAChB,iBAAiBA,EACd,OAAA,EACA;AAAA,QACC;AAAA,MAAA;AAAA,IACF,CACH,GAYC,KAAK,YAAYH,GACjB,KAAK,eAAeC,GACpB,KAAK,SAASG,EAAO,YAAY,EAAE,QAAQ,0BAA0B;AAAA,EAAA;AAAA,EAGvE,MAAgB,MAAM;AAAA,IACpB,iBAAAC;AAAA,EAAA,GAC2C;;AACrC,UAAAC,IAAe,KAAK,aAAa,gBAAgB;AACvD,QAAI,CAACA;AACI,aAAA;AAGT,SAAK,OAAO;AAAA,MACV,8BAA8BA,EAAa,SAAS,OAAOD,CAAe;AAAA,IAC5E;AAEI,QAAA;AACF,WAAK,OAAO,MAAM,0BAA0BA,CAAe,KAAK;AAC1D,YAAAE,IAAgB,MAAM,KAAK,UAAU;AAAA,QACzCF;AAAA,MACF;AACI,UAAA,GAACG,IAAAD,KAAA,gBAAAA,EAAe,cAAf,QAAAC,EAA0B;AAC7B,eAAO,+EAA+EH,CAAe;AAEjG,YAAAI,IAAuBF,EAAc,UAAU,cAC/CG,IACJH,EAAc,QAAQ,QAAQ,SAASF,CAAe,IAElDM,IAAgB,MAAM,KAAK,UAAU;AAAA,QACzCF;AAAA,QACAH,EAAa;AAAA,MACf;AACA,UAAIM,IAAqC;AACzC,YAAMC,IAAqBF,KAAA,gBAAAA,EAAe;AAC1C,UAAIE,MAAuB;AACrB,YAAA;AAEE,cADJD,IAAsBC,EAAmB,SAAS,GAC9C,MAAMD,CAAmB;AACrB,kBAAA,IAAI,MAAM,mCAAmC;AAAA,iBAE9CE,GAAiB;AACxB,gBAAM,IAAI;AAAA,YACR,yDAAyDA,CAAe;AAAA,UAC1E;AAAA,QAAA;AAAA;AAGI,cAAA,IAAI,MAAM,+CAA+C;AAGjE,YAAMC,IAAwB,KACxBC,IAAU,KACVC,IAAc,KAAK,KAAKF,IAAwBC,CAAO,GAEvDE,IACJ,MAAM,KAAK,UAAU;AAAA,QACnBT;AAAA,QACAG;AAAA,QACAK;AAAA,QACAD;AAAA,MACF;AAEE,UAAA,EAACE,KAAA,QAAAA,EAAoB;AACvB,eAAO,oDAAoDb,CAAe,iBAAiBO,CAAmB,YAC5GG,IAAwB,GAC1B;AAGF,YAAMI,IAAoBD,EAAmB;AAC7C,WAAK,OAAO,KAAK,mCAAmCC,CAAiB,EAAE;AAEvE,YAAMC,IAAkC;AAAA,QACtC,iBAAAf;AAAA,QACA,iBAAAK;AAAA,QACA,sBAAAD;AAAA,QACA,mBAAAU;AAAA,MACF;AACK,WAAA,aAAa,oBAAoBC,CAAa;AAE7C,YAAAC,IAAc,KAAK,aAAa,gBAAgB,GAChDC,IAAaD,EAAY;AAAA,QAC7B,CAACE,MAAMA,EAAE,sBAAsBJ;AAAA,MACjC,GACMK,IAAoBF,IACtBD,EAAY,QAAQC,CAAU,IAAI,IAClC;AAIJ,aAAO,uCAFUE,IAAoB,IAAIA,CAAiB,KAAK,EAET,SAASd,CAAe,KAAKL,CAAe,wBAAwBc,CAAiB;AAAA,aACpIM,GAAO;AACd,kBAAK,OAAO,MAAM,iCAAiCA,CAAK,EAAE,GACnD,oCAAoCpB,CAAe,KACxDoB,aAAiB,QAAQA,EAAM,UAAU,OAAOA,CAAK,CACvD;AAAA,IAAA;AAAA,EACF;AAEJ;"}

package/dist/tools/ListConnectionsTool.d.ts

@@ -0,0 +1,33 @@
+import { StructuredTool, ToolParams } from '@langchain/core/tools';
+import { z } from 'zod';
+import { IStateManager } from '../state/state-types';
+import { HCS10Client } from '../hcs10/HCS10Client';
+export interface ListConnectionsToolParams extends ToolParams {
+    stateManager: IStateManager;
+    hcsClient?: HCS10Client;
+}
+/**
+ * A tool to list currently active HCS-10 connections stored in the state manager.
+ * Enhanced to show more details similar to moonscape's implementation.
+ */
+export declare class ListConnectionsTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        includeDetails: z.ZodOptional<z.ZodBoolean>;
+        showPending: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        includeDetails?: boolean | undefined;
+        showPending?: boolean | undefined;
+    }, {
+        includeDetails?: boolean | undefined;
+        showPending?: boolean | undefined;
+    }>;
+    private stateManager;
+    private hcsClient?;
+    constructor({ stateManager, hcsClient, ...rest }: ListConnectionsToolParams);
+    protected _call(args: z.infer<this['schema']>): Promise<string>;
+    private formatConnection;
+    private enhanceConnectionInfo;
+    private fetchOutboundMessages;
+}