@hashgraphonline/standards-agent-kit 0.0.17 → 0.0.19

package/dist/tools/CheckMessagesTool.js

@@ -0,0 +1,96 @@
+import { StructuredTool as w } from "../node_modules/@langchain/core/dist/tools.js";
+import { z as p } from "zod";
+import { Logger as y } from "@hashgraphonline/standards-sdk";
+class I extends w {
+  constructor({ hcsClient: g, stateManager: m, ...h }) {
+    super(h), 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.schema = p.object({
+      targetIdentifier: p.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."
+      ),
+      fetchLatest: p.boolean().optional().default(!1).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)."
+      ),
+      lastMessagesCount: p.number().int().positive().optional().describe(
+        "When fetchLatest is true, specifies how many of the most recent messages to retrieve. Defaults to 1."
+      )
+    }), this.hcsClient = g, this.stateManager = m, this.logger = y.getInstance({ module: "CheckMessagesTool" });
+  }
+  async _call({
+    targetIdentifier: g,
+    fetchLatest: m,
+    lastMessagesCount: h
+  }) {
+    const l = this.stateManager.getConnectionByIdentifier(g);
+    if (!l)
+      return `Error: Could not find an active connection matching identifier "${g}". Use 'list_connections' to see active connections.`;
+    const s = l.connectionTopicId, i = l.targetAgentName, r = this.stateManager.getLastTimestamp(s);
+    this.logger.info(
+      `Checking messages for connection with ${i} (${l.targetAccountId}) on topic ${s} (fetchLatest: ${m}, lastCount: ${h}, since: ${r})`
+    );
+    try {
+      const f = (await this.hcsClient.getMessages(s)).messages;
+      if (!f || f.length === 0)
+        return `No messages found on connection topic ${s}.`;
+      let o = [], u = r;
+      const d = m === !0;
+      if (d) {
+        this.logger.info("Fetching latest messages regardless of timestamp.");
+        const t = h ?? 1;
+        o = f.slice(-t);
+      } else
+        this.logger.info(
+          `Filtering for messages newer than ${r}`
+        ), o = f.filter((t) => t.timestamp * 1e6 > r), o.length > 0 && (u = o.reduce(
+          (t, e) => Math.max(t, e.timestamp * 1e6),
+          r
+        ));
+      if (o.length === 0)
+        return d ? `Could not retrieve the latest message(s). No messages found on topic ${s}.` : `No new messages found for connection with ${i} since last check.`;
+      this.logger.info(`Processing ${o.length} message(s).`);
+      let $ = d ? `Latest message(s) from ${i}:
+` : `New messages from ${i}:
+`;
+      for (const t of o) {
+        let e = t.data;
+        try {
+          typeof e == "string" && e.startsWith("hcs://") && (this.logger.debug(`Resolving inscribed message: ${e}`), e = await this.hcsClient.getMessageContent(e), this.logger.debug(`Resolved content length: ${e == null ? void 0 : e.length}`));
+          let n = e;
+          try {
+            const a = JSON.parse(e);
+            a.p === "hcs-10" && a.op === "message" && a.data ? n = `[${a.operator_id || "unknown_sender"}]: ${a.data}` : n = e;
+          } catch {
+            n = e;
+          }
+          const b = new Date(t.timestamp);
+          $ += `
+[${b.toLocaleString()}] (Seq: ${t.sequence_number})
+${n}
+`;
+        } catch (n) {
+          const b = `Error processing message (Seq: ${t.sequence_number}): ${n instanceof Error ? n.message : String(n)}`;
+          this.logger.error(b), $ += `
+[Error processing message Seq: ${t.sequence_number}]
+`;
+        }
+      }
+      return !d && u > r && (this.logger.debug(
+        `Updating timestamp for topic ${s} to ${u}`
+      ), this.stateManager.updateTimestamp(
+        s,
+        u
+      )), $.trim();
+    } catch (c) {
+      return this.logger.error(
+        `Failed to check messages for topic ${s}: ${c}`
+      ), `Error checking messages for ${i}: ${c instanceof Error ? c.message : String(c)}`;
+    }
+  }
+}
+export {
+  I as CheckMessagesTool
+};
+//# sourceMappingURL=CheckMessagesTool.js.map

package/dist/tools/CheckMessagesTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CheckMessagesTool.js","sources":["../../src/tools/CheckMessagesTool.ts"],"sourcesContent":["import { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HCS10Client, HCSMessageWithTimestamp } from '../hcs10/HCS10Client';\nimport { IStateManager } from '../state/state-types';\nimport { Logger } from '@hashgraphonline/standards-sdk'; // Assuming logger utility\n\nexport interface CheckMessagesToolParams extends ToolParams {\n  hcsClient: HCS10Client;\n  stateManager: IStateManager;\n}\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 */\nexport class CheckMessagesTool extends StructuredTool {\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  schema = 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\n  public hcsClient: HCS10Client;\n  private stateManager: IStateManager;\n  private logger: Logger;\n\n  constructor({ hcsClient, stateManager, ...rest }: CheckMessagesToolParams) {\n    super(rest);\n    this.hcsClient = hcsClient;\n    this.stateManager = stateManager;\n    this.logger = Logger.getInstance({ module: 'CheckMessagesTool' });\n  }\n\n  protected async _call({\n    targetIdentifier,\n    fetchLatest,\n    lastMessagesCount,\n  }: z.infer<this['schema']>): Promise<string> {\n    const connection =\n      this.stateManager.getConnectionByIdentifier(targetIdentifier);\n\n    if (!connection) {\n      return `Error: Could not find an active connection matching identifier \"${targetIdentifier}\". Use 'list_connections' to see active connections.`;\n    }\n\n    const connectionTopicId = connection.connectionTopicId;\n    const targetAgentName = connection.targetAgentName;\n    const lastProcessedTimestamp =\n      this.stateManager.getLastTimestamp(connectionTopicId);\n\n    this.logger.info(\n      `Checking messages for connection with ${targetAgentName} (${connection.targetAccountId}) on topic ${connectionTopicId} (fetchLatest: ${fetchLatest}, lastCount: ${lastMessagesCount}, since: ${lastProcessedTimestamp})`\n    );\n\n    try {\n      // 1. Get messages from the topic\n      const result = await this.hcsClient.getMessages(connectionTopicId);\n      const allMessages = result.messages;\n\n      if (!allMessages || allMessages.length === 0) {\n        return `No messages found on connection topic ${connectionTopicId}.`;\n      }\n\n      let messagesToProcess: HCSMessageWithTimestamp[] = [];\n      let latestTimestampNanos = lastProcessedTimestamp;\n      const isFetchingLatest = fetchLatest === true;\n\n      if (isFetchingLatest) {\n        this.logger.info('Fetching latest messages regardless of timestamp.');\n        const count = lastMessagesCount ?? 1;\n        messagesToProcess = allMessages.slice(-count);\n      } else {\n        this.logger.info(\n          `Filtering for messages newer than ${lastProcessedTimestamp}`\n        );\n        messagesToProcess = allMessages.filter((msg) => {\n          const msgTimestampNanos = msg.timestamp * 1_000_000;\n          return msgTimestampNanos > lastProcessedTimestamp;\n        });\n        \n        if (messagesToProcess.length > 0) {\n          latestTimestampNanos = messagesToProcess.reduce((maxTs, msg) => \n             Math.max(maxTs, msg.timestamp * 1_000_000), \n             lastProcessedTimestamp\n          );\n        }\n      }\n\n      if (messagesToProcess.length === 0) {\n        return isFetchingLatest\n          ? `Could not retrieve the latest message(s). No messages found on topic ${connectionTopicId}.`\n          : `No new messages found for connection with ${targetAgentName} since last check.`;\n      }\n\n      this.logger.info(`Processing ${messagesToProcess.length} message(s).`);\n\n      // 3. Process messages (resolve inscriptions, format)\n      let outputString = isFetchingLatest\n        ? `Latest message(s) from ${targetAgentName}:\n`\n        : `New messages from ${targetAgentName}:\n`;\n\n      for (const msg of messagesToProcess) {\n        let content = msg.data;\n        try {\n          // Check for inscription HRL\n          if (typeof content === 'string' && content.startsWith('hcs://')) {\n            this.logger.debug(`Resolving inscribed message: ${content}`);\n            content = await this.hcsClient.getMessageContent(content);\n            this.logger.debug(`Resolved content length: ${content?.length}`);\n          }\n\n          // Attempt to parse the content as the HCS-10 structure\n          let displayContent = content; // Default to raw content\n          try {\n            const parsed = JSON.parse(content);\n            if (\n              parsed.p === 'hcs-10' &&\n              parsed.op === 'message' &&\n              parsed.data\n            ) {\n              // Extract sender and actual data from standard message format\n              const senderOpId = parsed.operator_id || 'unknown_sender';\n              displayContent = `[${senderOpId}]: ${parsed.data}`;\n            } else {\n              // If not standard format, maybe just show raw stringified version\n              displayContent = content; // Keep raw if parsing worked but not expected format\n            }\n          } catch (parseError) {\n            // Content wasn't JSON, keep raw content\n            displayContent = content;\n          }\n\n          const messageDate = new Date(msg.timestamp);\n          outputString += `\\n[${messageDate.toLocaleString()}] (Seq: ${\n            msg.sequence_number\n          })\n${displayContent}\n`;\n        } catch (error) {\n          const errorMsg = `Error processing message (Seq: ${\n            msg.sequence_number\n          }): ${error instanceof Error ? error.message : String(error)}`;\n          this.logger.error(errorMsg);\n          outputString += `\\n[Error processing message Seq: ${msg.sequence_number}]\\n`;\n        }\n      }\n\n      // 4. Update the timestamp in demo state ONLY if fetching NEW messages\n      if (!isFetchingLatest && latestTimestampNanos > lastProcessedTimestamp) {\n        this.logger.debug(\n          `Updating timestamp for topic ${connectionTopicId} to ${latestTimestampNanos}`\n        );\n        this.stateManager.updateTimestamp(\n          connectionTopicId,\n          latestTimestampNanos\n        );\n      }\n\n      return outputString.trim();\n    } catch (error) {\n      this.logger.error(\n        `Failed to check messages for topic ${connectionTopicId}: ${error}`\n      );\n      return `Error checking messages for ${targetAgentName}: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n}\n"],"names":["CheckMessagesTool","StructuredTool","hcsClient","stateManager","rest","z","Logger","targetIdentifier","fetchLatest","lastMessagesCount","connection","connectionTopicId","targetAgentName","lastProcessedTimestamp","allMessages","messagesToProcess","latestTimestampNanos","isFetchingLatest","count","msg","maxTs","outputString","content","displayContent","parsed","messageDate","error","errorMsg"],"mappings":"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"}

package/dist/tools/ConnectionMonitorTool.d.ts

@@ -0,0 +1,96 @@
+import { StructuredTool, ToolParams } from '@langchain/core/tools';
+import { z } from 'zod';
+import { HCS10Client } from '../hcs10/HCS10Client';
+import { IStateManager } from '../state/state-types';
+export interface FeeDefinition {
+    amount: number;
+    collectorAccount?: string;
+}
+export interface TokenFeeDefinition extends FeeDefinition {
+    tokenId: string;
+}
+export interface ConnectionMonitorToolParams extends ToolParams {
+    hcsClient: HCS10Client;
+    stateManager: IStateManager;
+}
+/**
+ * A tool for monitoring incoming connection requests and accepting them with optional fee settings.
+ */
+export declare class ConnectionMonitorTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        acceptAll: z.ZodOptional<z.ZodBoolean>;
+        targetAccountId: z.ZodOptional<z.ZodString>;
+        hbarFees: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            amount: z.ZodNumber;
+            collectorAccount: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            collectorAccount?: string | undefined;
+        }, {
+            amount: number;
+            collectorAccount?: string | undefined;
+        }>, "many">>;
+        tokenFees: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            amount: z.ZodNumber;
+            tokenId: z.ZodString;
+            collectorAccount: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            tokenId: string;
+            collectorAccount?: string | undefined;
+        }, {
+            amount: number;
+            tokenId: string;
+            collectorAccount?: string | undefined;
+        }>, "many">>;
+        exemptAccountIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        monitorDurationSeconds: z.ZodOptional<z.ZodNumber>;
+        defaultCollectorAccount: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        hbarFees?: {
+            amount: number;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        tokenFees?: {
+            amount: number;
+            tokenId: string;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        exemptAccountIds?: string[] | undefined;
+        targetAccountId?: string | undefined;
+        acceptAll?: boolean | undefined;
+        monitorDurationSeconds?: number | undefined;
+        defaultCollectorAccount?: string | undefined;
+    }, {
+        hbarFees?: {
+            amount: number;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        tokenFees?: {
+            amount: number;
+            tokenId: string;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        exemptAccountIds?: string[] | undefined;
+        targetAccountId?: string | undefined;
+        acceptAll?: boolean | undefined;
+        monitorDurationSeconds?: number | undefined;
+        defaultCollectorAccount?: string | undefined;
+    }>;
+    private hcsClient;
+    private stateManager;
+    private logger;
+    private isMonitoring;
+    private listConnectionsTool;
+    private static processedRequests;
+    constructor({ hcsClient, stateManager, ...rest }: ConnectionMonitorToolParams);
+    updateClient(newClient: HCS10Client): void;
+    call(args: z.infer<this['schema']>): Promise<string>;
+    protected _call({ acceptAll, targetAccountId, hbarFees, tokenFees, exemptAccountIds, monitorDurationSeconds, defaultCollectorAccount, }: z.infer<this['schema']>): Promise<string>;
+    private createFeeConfig;
+    private extractAccountId;
+    private acceptConnectionRequest;
+    private formatFeeString;
+}

package/dist/tools/ConnectionMonitorTool.js

@@ -0,0 +1,289 @@
+import { StructuredTool as v } from "../node_modules/@langchain/core/dist/tools.js";
+import { z as s } from "zod";
+import { Logger as S, FeeConfigBuilder as x } from "@hashgraphonline/standards-sdk";
+import { ListConnectionsTool as y } from "./ListConnectionsTool.js";
+const m = class m extends v {
+  constructor({
+    hcsClient: e,
+    stateManager: t,
+    ...c
+  }) {
+    super(c), 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.", this.schema = s.object({
+      acceptAll: s.boolean().optional().describe(
+        "Whether to automatically accept all incoming connection requests. Default is false."
+      ),
+      targetAccountId: s.string().optional().describe(
+        "If provided, only accept connection requests from this specific account ID."
+      ),
+      hbarFees: s.array(
+        s.object({
+          amount: s.number(),
+          collectorAccount: s.string().optional()
+        })
+      ).optional().describe(
+        "Array of HBAR fee amounts to charge per message (with optional collector accounts)."
+      ),
+      tokenFees: s.array(
+        s.object({
+          amount: s.number(),
+          tokenId: s.string(),
+          collectorAccount: s.string().optional()
+        })
+      ).optional().describe(
+        "Array of token fee amounts and IDs to charge per message (with optional collector accounts)."
+      ),
+      exemptAccountIds: s.array(s.string()).optional().describe(
+        "Array of account IDs to exempt from ALL fees set in this request."
+      ),
+      monitorDurationSeconds: s.number().optional().describe(
+        "How long to monitor for incoming requests in seconds. Default is 60."
+      ),
+      defaultCollectorAccount: s.string().optional().describe(
+        "Default account to collect fees if not specified at the fee level. Defaults to the agent account."
+      )
+    }), this.isMonitoring = !1, this.hcsClient = e, this.stateManager = t, this.logger = S.getInstance({
+      module: "ConnectionMonitorTool",
+      level: "error"
+    }), this.listConnectionsTool = new y({
+      stateManager: t,
+      hcsClient: e,
+      ...c
+    });
+  }
+  updateClient(e) {
+    this.hcsClient = e, this.logger.info("Updated HCS10Client instance for ConnectionMonitorTool"), this.listConnectionsTool = new y({
+      stateManager: this.stateManager,
+      hcsClient: e
+    });
+  }
+  async call(e) {
+    return this._call(e);
+  }
+  async _call({
+    acceptAll: e = !1,
+    targetAccountId: t,
+    hbarFees: c = [],
+    tokenFees: a = [],
+    exemptAccountIds: o,
+    monitorDurationSeconds: n = 60,
+    defaultCollectorAccount: f
+  }) {
+    if (!this.stateManager.getCurrentAgent())
+      return "Error: Cannot monitor for connections. No agent is currently active. Please register or select an agent first.";
+    if (this.isMonitoring)
+      return "Already monitoring for connection requests. Please wait for the current monitoring session to complete.";
+    try {
+      this.isMonitoring = !0;
+      const i = await this.hcsClient.getInboundTopicId();
+      if (!i)
+        return this.isMonitoring = !1, "Error: Could not find inbound topic ID for the current agent.";
+      this.logger.info(
+        `Starting to monitor inbound topic ${i} for connection requests...`
+      );
+      const r = this.createFeeConfig(
+        c,
+        a,
+        o,
+        t,
+        f
+      ), g = Date.now() + n * 1e3, u = 3e3;
+      let w = 0, C = 0, q = 0, A = 0;
+      const k = this.hcsClient.getAccountAndSigner().accountId, M = ($) => `${k}:${$}`;
+      for (; Date.now() < g; )
+        try {
+          await this.listConnectionsTool.invoke({
+            includeDetails: !1,
+            showPending: !1
+          });
+          const $ = this.stateManager.listConnections(), I = new Set(
+            $.filter(
+              (l) => l.status === "established" && !l.isPending
+            ).map((l) => l.targetAccountId)
+          ), R = (await this.hcsClient.getMessages(
+            i
+          )).messages.filter((l) => !l.sequence_number || l.sequence_number <= w ? !1 : (w = Math.max(
+            w,
+            l.sequence_number
+          ), l.op === "connection_request"));
+          for (const l of R) {
+            const h = l.sequence_number;
+            if (!h)
+              continue;
+            C++;
+            const b = M(h);
+            if (m.processedRequests.has(b)) {
+              this.logger.info(
+                `Request #${h} already processed, skipping`
+              ), A++;
+              continue;
+            }
+            const p = this.extractAccountId(l);
+            if (!p) {
+              m.processedRequests.add(b);
+              continue;
+            }
+            if (t && p !== t) {
+              this.logger.info(
+                `Request #${h} doesn't match target ${t}`
+              );
+              continue;
+            }
+            if (I.has(p)) {
+              this.logger.info(
+                `Already connected to ${p}, skipping request #${h}`
+              ), m.processedRequests.add(b), A++;
+              continue;
+            }
+            if (e) {
+              const D = await this.acceptConnectionRequest(
+                h,
+                p,
+                r
+              );
+              m.processedRequests.add(b), D.success && (q++, this.logger.info(
+                `Successfully accepted connection with ${p}`
+              ));
+            } else
+              this.logger.info(
+                `Found request #${h} from ${p} (not auto-accepting)`
+              );
+          }
+          await new Promise((l) => setTimeout(l, u));
+        } catch ($) {
+          this.logger.error(`Error polling for messages: ${$}`), await new Promise((I) => setTimeout(I, u));
+        }
+      return this.isMonitoring = !1, C === 0 ? `No connection requests received during the ${n} second monitoring period.` : e ? `Monitored for ${n} seconds. Found ${C} connection requests, accepted ${q} connections, skipped ${A} existing connections${this.formatFeeString(
+        c,
+        a
+      )}.` : `Monitored for ${n} seconds. Found ${C} connection requests. To accept them, call this tool again with acceptAll=true.`;
+    } catch (i) {
+      return this.isMonitoring = !1, this.logger.error(`Connection monitoring failed: ${i}`), `Error monitoring for connections: ${i instanceof Error ? i.message : String(i)}`;
+    }
+  }
+  createFeeConfig(e = [], t = [], c, a, o) {
+    if (!(e.length === 0 && t.length === 0))
+      try {
+        const n = this.hcsClient.getAccountAndSigner().accountId, f = o || n, d = new x({
+          network: this.hcsClient.getNetwork(),
+          logger: this.logger,
+          defaultCollectorAccountId: f
+        }), i = [...c || []];
+        a && !i.includes(a) && i.push(a);
+        for (const r of e)
+          if (r.amount > 0) {
+            const g = r.collectorAccount || f;
+            d.addHbarFee(r.amount, g, i), this.logger.info(
+              `Added HBAR fee: ${r.amount} HBAR to be collected by ${g}`
+            );
+          }
+        for (const r of t)
+          if (r.amount > 0 && r.tokenId) {
+            const g = r.collectorAccount || f;
+            d.addTokenFee(
+              r.amount,
+              r.tokenId,
+              g,
+              void 0,
+              i
+            ), this.logger.info(
+              `Added token fee: ${r.amount} of token ${r.tokenId} to be collected by ${g}`
+            );
+          }
+        return d;
+      } catch (n) {
+        this.logger.error(`Error creating fee configuration: ${n}`);
+        return;
+      }
+  }
+  extractAccountId(e) {
+    if (e.operator_id)
+      return this.hcsClient.standardClient.extractAccountFromOperatorId(
+        e.operator_id
+      );
+  }
+  async acceptConnectionRequest(e, t, c) {
+    var a, o;
+    try {
+      const n = await this.hcsClient.getInboundTopicId();
+      this.logger.info(
+        `Accepting connection request #${e} from ${t}`
+      );
+      const f = await this.hcsClient.handleConnectionRequest(
+        n,
+        t,
+        e,
+        c
+      );
+      if (!(f != null && f.connectionTopicId))
+        return {
+          success: !1,
+          error: "Connection acceptance returned no connection topic ID"
+        };
+      const d = f.connectionTopicId;
+      this.logger.info(
+        `Connection established! Topic ID: ${d}`
+      );
+      let i;
+      try {
+        const u = await this.hcsClient.getAgentProfile(
+          t
+        );
+        u.success && u.profile && (i = {
+          name: u.profile.display_name || u.profile.alias,
+          bio: u.profile.bio,
+          avatar: u.profile.profileImage,
+          type: u.profile.type
+        });
+      } catch (u) {
+        this.logger.warn(
+          `Could not fetch profile for ${t}: ${u}`
+        );
+      }
+      const r = ((o = (a = await this.hcsClient.getAgentProfile(t)) == null ? void 0 : a.topicInfo) == null ? void 0 : o.inboundTopic) || "", g = {
+        targetAccountId: t,
+        targetAgentName: (i == null ? void 0 : i.name) || `Agent ${t}`,
+        targetInboundTopicId: r,
+        connectionTopicId: d,
+        profileInfo: i,
+        created: /* @__PURE__ */ new Date(),
+        status: "established"
+      };
+      return this.stateManager.addActiveConnection(g), {
+        success: !0,
+        connectionTopicId: d
+      };
+    } catch (n) {
+      return this.logger.error(`Error accepting connection request: ${n}`), {
+        success: !1,
+        error: n instanceof Error ? n.message : String(n)
+      };
+    }
+  }
+  formatFeeString(e = [], t = []) {
+    if (e.length === 0 && t.length === 0)
+      return "";
+    let c = " with fees: ";
+    if (e.length > 0) {
+      const a = e.filter((o) => o.amount > 0).map((o) => {
+        const n = o.collectorAccount ? ` to ${o.collectorAccount}` : "";
+        return `${o.amount} HBAR${n}`;
+      }).join(", ");
+      a && (c += a);
+    }
+    if (t.length > 0) {
+      e.length > 0 && (c += " and ");
+      const a = t.filter((o) => o.amount > 0 && o.tokenId).map((o) => {
+        const n = o.collectorAccount ? ` to ${o.collectorAccount}` : "";
+        return `${o.amount} of token ${o.tokenId}${n}`;
+      }).join(", ");
+      a && (c += a);
+    }
+    return c === " with fees: " ? "" : c;
+  }
+};
+m.processedRequests = /* @__PURE__ */ new Set();
+let T = m;
+export {
+  T as ConnectionMonitorTool
+};
+//# sourceMappingURL=ConnectionMonitorTool.js.map

package/dist/tools/ConnectionMonitorTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionMonitorTool.js","sources":["../../src/tools/ConnectionMonitorTool.ts"],"sourcesContent":["import { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HCS10Client } from '../hcs10/HCS10Client';\nimport {\n  IStateManager,\n  ActiveConnection,\n  AgentProfileInfo,\n} from '../state/state-types';\nimport {\n  Logger,\n  FeeConfigBuilder,\n  HCSMessage,\n  FeeConfigBuilderInterface,\n} from '@hashgraphonline/standards-sdk';\nimport { ListConnectionsTool } from './ListConnectionsTool';\n\nexport interface FeeDefinition {\n  amount: number;\n  collectorAccount?: string;\n}\n\nexport interface TokenFeeDefinition extends FeeDefinition {\n  tokenId: string;\n}\n\nexport interface ConnectionMonitorToolParams extends ToolParams {\n  hcsClient: HCS10Client;\n  stateManager: IStateManager;\n}\n\n/**\n * A tool for monitoring incoming connection requests and accepting them with optional fee settings.\n */\nexport class ConnectionMonitorTool extends StructuredTool {\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.';\n  schema = 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 60.'\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  private hcsClient: HCS10Client;\n  private stateManager: IStateManager;\n  private logger: Logger;\n  private isMonitoring: boolean = false;\n  private listConnectionsTool: ListConnectionsTool;\n  private static processedRequests = new Set<string>();\n\n  constructor({\n    hcsClient,\n    stateManager,\n    ...rest\n  }: ConnectionMonitorToolParams) {\n    super(rest);\n    this.hcsClient = hcsClient;\n    this.stateManager = stateManager;\n    this.logger = Logger.getInstance({\n      module: 'ConnectionMonitorTool',\n      level: 'error',\n    });\n    this.listConnectionsTool = new ListConnectionsTool({\n      stateManager,\n      hcsClient,\n      ...rest,\n    });\n  }\n\n  updateClient(newClient: HCS10Client): void {\n    this.hcsClient = newClient;\n    this.logger.info('Updated HCS10Client instance for ConnectionMonitorTool');\n    this.listConnectionsTool = new ListConnectionsTool({\n      stateManager: this.stateManager,\n      hcsClient: newClient,\n    });\n  }\n\n  async call(args: z.infer<this['schema']>): Promise<string> {\n    return this._call(args);\n  }\n\n  protected async _call({\n    acceptAll = false,\n    targetAccountId,\n    hbarFees = [],\n    tokenFees = [],\n    exemptAccountIds,\n    monitorDurationSeconds = 60,\n    defaultCollectorAccount,\n  }: z.infer<this['schema']>): Promise<string> {\n    const currentAgent = this.stateManager.getCurrentAgent();\n    if (!currentAgent) {\n      return 'Error: Cannot monitor for connections. No agent is currently active. Please register or select an agent first.';\n    }\n\n    if (this.isMonitoring) {\n      return 'Already monitoring for connection requests. Please wait for the current monitoring session to complete.';\n    }\n\n    try {\n      this.isMonitoring = true;\n      const inboundTopicId = await this.hcsClient.getInboundTopicId();\n\n      if (!inboundTopicId) {\n        this.isMonitoring = false;\n        return 'Error: Could not find inbound topic ID for the current agent.';\n      }\n\n      this.logger.info(\n        `Starting to monitor inbound topic ${inboundTopicId} for connection requests...`\n      );\n\n      const feeConfig = this.createFeeConfig(\n        hbarFees,\n        tokenFees,\n        exemptAccountIds,\n        targetAccountId,\n        defaultCollectorAccount\n      );\n\n      const endTime = Date.now() + monitorDurationSeconds * 1000;\n      const pollIntervalMs = 3000;\n      let lastSequenceNumber = 0;\n      let connectionRequestsFound = 0;\n      let acceptedConnections = 0;\n      let skippedRequests = 0;\n      const agentId = this.hcsClient.getAccountAndSigner().accountId;\n      const requestIdKey = (reqId: number) => `${agentId}:${reqId}`;\n\n      while (Date.now() < endTime) {\n        try {\n          await this.listConnectionsTool.invoke({\n            includeDetails: false,\n            showPending: false,\n          });\n          const currentConnections = this.stateManager.listConnections();\n          const connectedAccountIds = new Set(\n            currentConnections\n              .filter(\n                (conn) => conn.status === 'established' && !conn.isPending\n              )\n              .map((conn) => conn.targetAccountId)\n          );\n\n          const messagesResult = await this.hcsClient.getMessages(\n            inboundTopicId\n          );\n          const newMessages = messagesResult.messages.filter((msg) => {\n            if (\n              !msg.sequence_number ||\n              msg.sequence_number <= lastSequenceNumber\n            ) {\n              return false;\n            }\n            lastSequenceNumber = Math.max(\n              lastSequenceNumber,\n              msg.sequence_number\n            );\n            return msg.op === 'connection_request';\n          });\n\n          for (const request of newMessages) {\n            const requestId = request.sequence_number;\n            if (!requestId) {\n              continue;\n            }\n\n            connectionRequestsFound++;\n\n            const reqKey = requestIdKey(requestId);\n            if (ConnectionMonitorTool.processedRequests.has(reqKey)) {\n              this.logger.info(\n                `Request #${requestId} already processed, skipping`\n              );\n              skippedRequests++;\n              continue;\n            }\n\n            const requestorAccountId = this.extractAccountId(request);\n            if (!requestorAccountId) {\n              ConnectionMonitorTool.processedRequests.add(reqKey);\n              continue;\n            }\n\n            if (targetAccountId && requestorAccountId !== targetAccountId) {\n              this.logger.info(\n                `Request #${requestId} doesn't match target ${targetAccountId}`\n              );\n              continue;\n            }\n\n            if (connectedAccountIds.has(requestorAccountId)) {\n              this.logger.info(\n                `Already connected to ${requestorAccountId}, skipping request #${requestId}`\n              );\n              ConnectionMonitorTool.processedRequests.add(reqKey);\n              skippedRequests++;\n              continue;\n            }\n\n            if (acceptAll) {\n              const result = await this.acceptConnectionRequest(\n                requestId,\n                requestorAccountId,\n                feeConfig\n              );\n              ConnectionMonitorTool.processedRequests.add(reqKey);\n\n              if (result.success) {\n                acceptedConnections++;\n                this.logger.info(\n                  `Successfully accepted connection with ${requestorAccountId}`\n                );\n              }\n            } else {\n              this.logger.info(\n                `Found request #${requestId} from ${requestorAccountId} (not auto-accepting)`\n              );\n            }\n          }\n\n          await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n        } catch (error) {\n          this.logger.error(`Error polling for messages: ${error}`);\n          await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));\n        }\n      }\n\n      this.isMonitoring = false;\n\n      if (connectionRequestsFound === 0) {\n        return `No connection requests received during the ${monitorDurationSeconds} second monitoring period.`;\n      } else if (acceptAll) {\n        return `Monitored for ${monitorDurationSeconds} seconds. Found ${connectionRequestsFound} connection requests, accepted ${acceptedConnections} connections, skipped ${skippedRequests} existing connections${this.formatFeeString(\n          hbarFees,\n          tokenFees\n        )}.`;\n      } else {\n        return `Monitored for ${monitorDurationSeconds} seconds. Found ${connectionRequestsFound} connection requests. To accept them, call this tool again with acceptAll=true.`;\n      }\n    } catch (error) {\n      this.isMonitoring = false;\n      this.logger.error(`Connection monitoring failed: ${error}`);\n      return `Error monitoring for connections: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n\n  private createFeeConfig(\n    hbarFees: FeeDefinition[] = [],\n    tokenFees: TokenFeeDefinition[] = [],\n    exemptAccountIds?: string[],\n    targetAccountId?: string,\n    defaultCollectorAccount?: string\n  ): FeeConfigBuilderInterface | undefined {\n    if (hbarFees.length === 0 && tokenFees.length === 0) {\n      return undefined;\n    }\n\n    try {\n      const agentAccountId = this.hcsClient.getAccountAndSigner().accountId;\n      const defaultCollector = defaultCollectorAccount || agentAccountId;\n\n      const builder = new FeeConfigBuilder({\n        network: this.hcsClient.getNetwork(),\n        logger: this.logger,\n        defaultCollectorAccountId: defaultCollector,\n      });\n\n      const exemptIds = [...(exemptAccountIds || [])];\n      if (targetAccountId && !exemptIds.includes(targetAccountId)) {\n        exemptIds.push(targetAccountId);\n      }\n\n      for (const hbarFee of hbarFees) {\n        if (hbarFee.amount > 0) {\n          const collector = hbarFee.collectorAccount || defaultCollector;\n          builder.addHbarFee(hbarFee.amount, collector, exemptIds);\n          this.logger.info(\n            `Added HBAR fee: ${hbarFee.amount} HBAR to be collected by ${collector}`\n          );\n        }\n      }\n\n      for (const tokenFee of tokenFees) {\n        if (tokenFee.amount > 0 && tokenFee.tokenId) {\n          const collector = tokenFee.collectorAccount || defaultCollector;\n          builder.addTokenFee(\n            tokenFee.amount,\n            tokenFee.tokenId,\n            collector,\n            undefined,\n            exemptIds\n          );\n          this.logger.info(\n            `Added token fee: ${tokenFee.amount} of token ${tokenFee.tokenId} to be collected by ${collector}`\n          );\n        }\n      }\n\n      return builder;\n    } catch (error) {\n      this.logger.error(`Error creating fee configuration: ${error}`);\n      return undefined;\n    }\n  }\n\n  private extractAccountId(request: HCSMessage): string | undefined {\n    if (request.operator_id) {\n      return this.hcsClient.standardClient.extractAccountFromOperatorId(\n        request.operator_id\n      );\n    }\n    return undefined;\n  }\n\n  private async acceptConnectionRequest(\n    connectionRequestId: number,\n    requestingAccountId: string,\n    feeConfig?: FeeConfigBuilderInterface\n  ): Promise<{ success: boolean; connectionTopicId?: string; error?: string }> {\n    try {\n      const inboundTopicId = await this.hcsClient.getInboundTopicId();\n      this.logger.info(\n        `Accepting connection request #${connectionRequestId} from ${requestingAccountId}`\n      );\n\n      const result = await this.hcsClient.handleConnectionRequest(\n        inboundTopicId,\n        requestingAccountId,\n        connectionRequestId,\n        feeConfig\n      );\n\n      if (!result?.connectionTopicId) {\n        return {\n          success: false,\n          error: 'Connection acceptance returned no connection topic ID',\n        };\n      }\n\n      const connectionTopicId = result.connectionTopicId;\n      this.logger.info(\n        `Connection established! Topic ID: ${connectionTopicId}`\n      );\n\n      let profileInfo: AgentProfileInfo | undefined;\n      try {\n        const profile = await this.hcsClient.getAgentProfile(\n          requestingAccountId\n        );\n        if (profile.success && profile.profile) {\n          profileInfo = {\n            name: profile.profile.display_name || profile.profile.alias,\n            bio: profile.profile.bio,\n            avatar: profile.profile.profileImage,\n            type: profile.profile.type,\n          };\n        }\n      } catch (profileError) {\n        this.logger.warn(\n          `Could not fetch profile for ${requestingAccountId}: ${profileError}`\n        );\n      }\n\n      const targetInboundTopicId =\n        (await this.hcsClient.getAgentProfile(requestingAccountId))?.topicInfo\n          ?.inboundTopic || '';\n\n      const newConnection: ActiveConnection = {\n        targetAccountId: requestingAccountId,\n        targetAgentName: profileInfo?.name || `Agent ${requestingAccountId}`,\n        targetInboundTopicId,\n        connectionTopicId,\n        profileInfo,\n        created: new Date(),\n        status: 'established',\n      };\n\n      this.stateManager.addActiveConnection(newConnection);\n\n      return {\n        success: true,\n        connectionTopicId,\n      };\n    } catch (error) {\n      this.logger.error(`Error accepting connection request: ${error}`);\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  private formatFeeString(\n    hbarFees: FeeDefinition[] = [],\n    tokenFees: TokenFeeDefinition[] = []\n  ): string {\n    if (hbarFees.length === 0 && tokenFees.length === 0) {\n      return '';\n    }\n\n    let feeString = ' with fees: ';\n\n    if (hbarFees.length > 0) {\n      const hbarFeeDetails = hbarFees\n        .filter((fee) => fee.amount > 0)\n        .map((fee) => {\n          const collector = fee.collectorAccount\n            ? ` to ${fee.collectorAccount}`\n            : '';\n          return `${fee.amount} HBAR${collector}`;\n        })\n        .join(', ');\n\n      if (hbarFeeDetails) {\n        feeString += hbarFeeDetails;\n      }\n    }\n\n    if (tokenFees.length > 0) {\n      if (hbarFees.length > 0) {\n        feeString += ' and ';\n      }\n\n      const tokenFeeDetails = tokenFees\n        .filter((fee) => fee.amount > 0 && fee.tokenId)\n        .map((fee) => {\n          const collector = fee.collectorAccount\n            ? ` to ${fee.collectorAccount}`\n            : '';\n          return `${fee.amount} of token ${fee.tokenId}${collector}`;\n        })\n        .join(', ');\n\n      if (tokenFeeDetails) {\n        feeString += tokenFeeDetails;\n      }\n    }\n\n    return feeString === ' with fees: ' ? '' : feeString;\n  }\n}\n"],"names":["_ConnectionMonitorTool","StructuredTool","hcsClient","stateManager","rest","z","Logger","ListConnectionsTool","newClient","args","acceptAll","targetAccountId","hbarFees","tokenFees","exemptAccountIds","monitorDurationSeconds","defaultCollectorAccount","inboundTopicId","feeConfig","endTime","pollIntervalMs","lastSequenceNumber","connectionRequestsFound","acceptedConnections","skippedRequests","agentId","requestIdKey","reqId","currentConnections","connectedAccountIds","conn","newMessages","msg","request","requestId","reqKey","requestorAccountId","result","resolve","error","agentAccountId","defaultCollector","builder","FeeConfigBuilder","exemptIds","hbarFee","collector","tokenFee","connectionRequestId","requestingAccountId","connectionTopicId","profileInfo","profile","profileError","targetInboundTopicId","_b","_a","newConnection","feeString","hbarFeeDetails","fee","tokenFeeDetails","ConnectionMonitorTool"],"mappings":"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"}

package/dist/tools/ConnectionTool.d.ts

@@ -0,0 +1,40 @@
+import { HCS10Client } from '../hcs10/HCS10Client';
+import { StructuredTool, ToolParams } from '@langchain/core/tools';
+import { z } from 'zod';
+import { Logger } from '@hashgraphonline/standards-sdk';
+import { IStateManager } from '../state/state-types';
+export interface ConnectionToolParams extends ToolParams {
+    client: HCS10Client;
+    stateManager: IStateManager;
+}
+/**
+ * ConnectionTool monitors the *current* agent's inbound topic for connection requests
+ * and automatically handles them using the HCS-10 standard SDK flow.
+ * Use this ONLY to passively LISTEN for other agents trying to connect TO YOU.
+ * This tool takes NO arguments and does NOT start outgoing connections.
+ */
+export declare class ConnectionTool extends StructuredTool {
+    name: string;
+    description: string;
+    client: HCS10Client;
+    logger: Logger;
+    private stateManager;
+    private isMonitoring;
+    private monitoringTopic;
+    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    /**
+     * @param client - Instance of HCS10Client.
+     * @param stateManager - Instance of StateManager for shared state management.
+     */
+    constructor({ client, stateManager, ...rest }: ConnectionToolParams);
+    /**
+     * Initiates the connection request monitoring process in the background.
+     * Gets the inbound topic ID from the configured client.
+     */
+    _call(_input: z.infer<typeof this.schema>): Promise<string>;
+    /**
+     * The core monitoring loop.
+     */
+    private monitorIncomingRequests;
+    stopMonitoring(): void;
+}