@hashgraphonline/standards-agent-kit 0.0.18 → 0.0.19

package/dist/tools/ManageConnectionRequestsTool.d.ts

@@ -0,0 +1,39 @@
+import { StructuredTool, ToolParams } from '@langchain/core/tools';
+import { z } from 'zod';
+import { HCS10Client } from '../hcs10/HCS10Client';
+import { IStateManager } from '../state/state-types';
+export interface ManageConnectionRequestsToolParams extends ToolParams {
+    hcsClient: HCS10Client;
+    stateManager: IStateManager;
+}
+/**
+ * A tool for managing incoming connection requests in a LangChain-compatible way.
+ * This tool allows an agent to list, view details of, and accept/reject incoming connection requests.
+ */
+export declare class ManageConnectionRequestsTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        action: z.ZodEnum<["list", "view", "reject"]>;
+        requestId: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        action: "list" | "view" | "reject";
+        requestId?: number | undefined;
+    }, {
+        action: "list" | "view" | "reject";
+        requestId?: number | undefined;
+    }>;
+    private hcsClient;
+    private stateManager;
+    private logger;
+    private lastRefreshTime;
+    private refreshIntervalMs;
+    constructor({ hcsClient, stateManager, ...rest }: ManageConnectionRequestsToolParams);
+    protected _call({ action, requestId, }: z.infer<this['schema']>): Promise<string>;
+    private refreshRequestsIfNeeded;
+    refreshRequests(): Promise<void>;
+    private listRequests;
+    private viewRequest;
+    private rejectRequest;
+    private extractAccountId;
+}

package/dist/tools/ManageConnectionRequestsTool.js

@@ -0,0 +1,161 @@
+import { StructuredTool as g } from "../node_modules/@langchain/core/dist/tools.js";
+import { z as l } from "zod";
+import { Logger as h } from "@hashgraphonline/standards-sdk";
+class $ extends g {
+  constructor({
+    hcsClient: t,
+    stateManager: e,
+    ...r
+  }) {
+    super(r), this.name = "manage_connection_requests", this.description = 'Manage incoming connection requests. List pending requests, view details about requesting agents, and reject connection requests. Use the separate "accept_connection_request" tool to accept.', this.schema = l.object({
+      action: l.enum(["list", "view", "reject"]).describe(
+        "The action to perform: list all requests, view details of a specific request, or reject a request"
+      ),
+      requestId: l.number().optional().describe(
+        "The ID of the specific request to view or reject (required for view and reject actions)"
+      )
+    }), this.lastRefreshTime = 0, this.refreshIntervalMs = 3e4, this.hcsClient = t, this.stateManager = e, this.logger = h.getInstance({
+      module: "ManageConnectionRequestsTool",
+      level: "debug"
+    });
+  }
+  async _call({
+    action: t,
+    requestId: e
+  }) {
+    if (!this.stateManager.getCurrentAgent())
+      return "Error: Cannot manage connection requests. No agent is currently active. Please register or select an agent first.";
+    if ((t === "view" || t === "reject") && e === void 0)
+      return `Error: Request ID is required for the "${t}" action. Use the "list" action first to see available requests.`;
+    try {
+      switch (await this.refreshRequestsIfNeeded(), t) {
+        case "list":
+          return this.listRequests();
+        case "view":
+          return this.viewRequest(e);
+        case "reject":
+          return this.rejectRequest(e);
+        default:
+          return `Error: Unsupported action: ${t}`;
+      }
+    } catch (s) {
+      return this.logger.error(`Error in ManageConnectionRequestsTool: ${s}`), `Error managing connection requests: ${s instanceof Error ? s.message : String(s)}`;
+    }
+  }
+  async refreshRequestsIfNeeded() {
+    const t = Date.now();
+    t - this.lastRefreshTime > this.refreshIntervalMs && (await this.refreshRequests(), this.lastRefreshTime = t);
+  }
+  async refreshRequests() {
+    try {
+      const t = await this.hcsClient.getInboundTopicId(), e = await this.hcsClient.getOutboundTopicId();
+      if (!t || !e)
+        throw new Error(
+          "Could not find inbound or outbound topic ID for the current agent"
+        );
+      const s = (await this.hcsClient.getMessages(
+        e
+      )).messages.filter(
+        (n) => n.op === "connection_created" && n.connection_request_id
+      ), i = new Set(
+        s.map((n) => n.connection_request_id)
+      ), f = (await this.hcsClient.getMessages(
+        t
+      )).messages.filter(
+        (n) => n.op === "connection_request" && n.sequence_number
+      );
+      this.stateManager.clearConnectionRequests();
+      const d = f.map(async (n) => {
+        const u = n.sequence_number;
+        if (!u || i.has(u))
+          return;
+        const a = this.extractAccountId(n);
+        if (!a)
+          return;
+        let c;
+        try {
+          const o = await this.hcsClient.getAgentProfile(
+            a
+          );
+          o.success && o.profile && (c = {
+            name: o.profile.display_name || o.profile.alias,
+            bio: o.profile.bio,
+            avatar: o.profile.profileImage,
+            type: o.profile.type
+          });
+        } catch (o) {
+          this.logger.warn(
+            `Could not fetch profile for ${a}: ${o}`
+          );
+        }
+        this.stateManager.addConnectionRequest({
+          id: u,
+          requestorId: a,
+          requestorName: (c == null ? void 0 : c.name) || `Agent ${a}`,
+          timestamp: new Date(n.created || Date.now()),
+          memo: n.m,
+          profile: c
+        });
+      });
+      await Promise.allSettled(d), this.logger.info(
+        `Found ${this.stateManager.listConnectionRequests().length} pending connection requests`
+      );
+    } catch (t) {
+      throw this.logger.error(`Error refreshing connection requests: ${t}`), t;
+    }
+  }
+  listRequests() {
+    const t = this.stateManager.listConnectionRequests();
+    if (t.length === 0)
+      return "No pending connection requests found.";
+    let e = `Found ${t.length} pending connection request(s):
+
+`;
+    return [...t].sort(
+      (s, i) => i.timestamp.getTime() - s.timestamp.getTime()
+    ).forEach((s, i) => {
+      e += `${i + 1}. Request ID: ${s.id}
+`, e += `   From: ${s.requestorName} (${s.requestorId})
+`, e += `   Received: ${s.timestamp.toLocaleString()}
+`, s.memo && (e += `   Memo: ${s.memo}
+`), e += `
+`;
+    }), e += `To view more details about a request, use action="view" with the specific requestId.
+`, e += 'To reject a request, use action="reject" with the specific requestId.', e;
+  }
+  viewRequest(t) {
+    const e = this.stateManager.getConnectionRequestById(t);
+    if (!e)
+      return `Error: Request ID ${t} not found or no longer pending.`;
+    let r = `Details for connection request #${t}:
+
+`;
+    return r += `Requestor ID: ${e.requestorId}
+`, r += `Requestor Name: ${e.requestorName}
+`, r += `Received: ${e.timestamp.toLocaleString()}
+`, e.memo && (r += `Memo: ${e.memo}
+`), e.profile && (r += `
+Agent Profile Information:
+`, e.profile.name && (r += `Name: ${e.profile.name}
+`), e.profile.type && (r += `Type: ${e.profile.type}
+`), e.profile.bio && (r += `Bio: ${e.profile.bio}
+`)), r += `
+Actions:
+`, r += `- To reject this request: action="reject", requestId=${t}
+`, r += 'Use the separate "accept_connection_request" tool to accept requests.', r;
+  }
+  async rejectRequest(t) {
+    const e = this.stateManager.getConnectionRequestById(t);
+    return e ? (this.stateManager.removeConnectionRequest(t), `Connection request #${t} from ${e.requestorName} was rejected locally (removed from pending list).`) : `Error: Request ID ${t} not found or no longer pending.`;
+  }
+  extractAccountId(t) {
+    if (t.operator_id)
+      return this.hcsClient.standardClient.extractAccountFromOperatorId(
+        t.operator_id
+      );
+  }
+}
+export {
+  $ as ManageConnectionRequestsTool
+};
+//# sourceMappingURL=ManageConnectionRequestsTool.js.map

package/dist/tools/ManageConnectionRequestsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManageConnectionRequestsTool.js","sources":["../../src/tools/ManageConnectionRequestsTool.ts"],"sourcesContent":["import { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { HCS10Client } from '../hcs10/HCS10Client';\nimport { IStateManager } from '../state/state-types';\nimport { Logger, HCSMessage } from '@hashgraphonline/standards-sdk';\n\nexport interface ManageConnectionRequestsToolParams extends ToolParams {\n  hcsClient: HCS10Client;\n  stateManager: IStateManager;\n}\n\n/**\n * A tool for managing incoming connection requests in a LangChain-compatible way.\n * This tool allows an agent to list, view details of, and accept/reject incoming connection requests.\n */\nexport class ManageConnectionRequestsTool extends StructuredTool {\n  name = 'manage_connection_requests';\n  description =\n    'Manage incoming connection requests. List pending requests, view details about requesting agents, and reject connection requests. Use the separate \"accept_connection_request\" tool to accept.';\n  schema = z.object({\n    action: z\n      .enum(['list', 'view', 'reject'])\n      .describe(\n        'The action to perform: list all requests, view details of a specific request, or reject a request'\n      ),\n    requestId: z\n      .number()\n      .optional()\n      .describe(\n        'The ID of the specific request to view or reject (required for view and reject actions)'\n      ),\n  });\n\n  private hcsClient: HCS10Client;\n  private stateManager: IStateManager;\n  private logger: Logger;\n  private lastRefreshTime: number = 0;\n  private refreshIntervalMs = 30000;\n\n  constructor({\n    hcsClient,\n    stateManager,\n    ...rest\n  }: ManageConnectionRequestsToolParams) {\n    super(rest);\n    this.hcsClient = hcsClient;\n    this.stateManager = stateManager;\n    this.logger = Logger.getInstance({\n      module: 'ManageConnectionRequestsTool',\n      level: 'debug',\n    });\n  }\n\n  protected async _call({\n    action,\n    requestId,\n  }: z.infer<this['schema']>): Promise<string> {\n    const currentAgent = this.stateManager.getCurrentAgent();\n    if (!currentAgent) {\n      return 'Error: Cannot manage connection requests. No agent is currently active. Please register or select an agent first.';\n    }\n\n    if ((action === 'view' || action === 'reject') && requestId === undefined) {\n      return `Error: Request ID is required for the \"${action}\" action. Use the \"list\" action first to see available requests.`;\n    }\n\n    try {\n      await this.refreshRequestsIfNeeded();\n\n      switch (action) {\n        case 'list':\n          return this.listRequests();\n        case 'view':\n          return this.viewRequest(requestId!);\n        case 'reject':\n          return this.rejectRequest(requestId!);\n        default:\n          return `Error: Unsupported action: ${action}`;\n      }\n    } catch (error) {\n      this.logger.error(`Error in ManageConnectionRequestsTool: ${error}`);\n      return `Error managing connection requests: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n\n  private async refreshRequestsIfNeeded(): Promise<void> {\n    const now = Date.now();\n    if (now - this.lastRefreshTime > this.refreshIntervalMs) {\n      await this.refreshRequests();\n      this.lastRefreshTime = now;\n    }\n  }\n\n  public async refreshRequests(): Promise<void> {\n    try {\n      const inboundTopicId = await this.hcsClient.getInboundTopicId();\n      const outboundTopicId = await this.hcsClient.getOutboundTopicId();\n      if (!inboundTopicId || !outboundTopicId) {\n        throw new Error(\n          'Could not find inbound or outbound topic ID for the current agent'\n        );\n      }\n\n      const outboundMessagesResult = await this.hcsClient.getMessages(\n        outboundTopicId\n      );\n      const outboundConfirmations = outboundMessagesResult.messages.filter(\n        (msg) => msg.op === 'connection_created' && msg.connection_request_id\n      );\n      const confirmedRequestIds = new Set(\n        outboundConfirmations.map((conf) => conf.connection_request_id)\n      );\n\n      const inboundMessagesResult = await this.hcsClient.getMessages(\n        inboundTopicId\n      );\n      const incomingRequests = inboundMessagesResult.messages.filter(\n        (msg) => msg.op === 'connection_request' && msg.sequence_number\n      );\n\n      this.stateManager.clearConnectionRequests();\n\n      const profilePromises = incomingRequests.map(async (request) => {\n        const requestId = request.sequence_number;\n        if (!requestId) {\n          return;\n        }\n\n        if (confirmedRequestIds.has(requestId)) {\n          return;\n        }\n\n        const requestorId = this.extractAccountId(request);\n        if (!requestorId) {\n          return;\n        }\n\n        let profile = undefined;\n        try {\n          const profileResult = await this.hcsClient.getAgentProfile(\n            requestorId\n          );\n          if (profileResult.success && profileResult.profile) {\n            profile = {\n              name:\n                profileResult.profile.display_name ||\n                profileResult.profile.alias,\n              bio: profileResult.profile.bio,\n              avatar: profileResult.profile.profileImage,\n              type: profileResult.profile.type,\n            };\n          }\n        } catch (profileError) {\n          this.logger.warn(\n            `Could not fetch profile for ${requestorId}: ${profileError}`\n          );\n        }\n\n        this.stateManager.addConnectionRequest({\n          id: requestId,\n          requestorId,\n          requestorName: profile?.name || `Agent ${requestorId}`,\n          timestamp: new Date(request.created || Date.now()),\n          memo: request.m,\n          profile,\n        });\n      });\n\n      await Promise.allSettled(profilePromises);\n      this.logger.info(\n        `Found ${\n          this.stateManager.listConnectionRequests().length\n        } pending connection requests`\n      );\n    } catch (error) {\n      this.logger.error(`Error refreshing connection requests: ${error}`);\n      throw error;\n    }\n  }\n\n  private listRequests(): string {\n    const requests = this.stateManager.listConnectionRequests();\n    if (requests.length === 0) {\n      return 'No pending connection requests found.';\n    }\n\n    let output = `Found ${requests.length} pending connection request(s):\\n\\n`;\n    const sortedRequests = [...requests].sort(\n      (a, b) => b.timestamp.getTime() - a.timestamp.getTime()\n    );\n\n    sortedRequests.forEach((request, index) => {\n      output += `${index + 1}. Request ID: ${request.id}\\n`;\n      output += `   From: ${request.requestorName} (${request.requestorId})\\n`;\n      output += `   Received: ${request.timestamp.toLocaleString()}\\n`;\n      if (request.memo) {\n        output += `   Memo: ${request.memo}\\n`;\n      }\n      output += '\\n';\n    });\n\n    output +=\n      'To view more details about a request, use action=\"view\" with the specific requestId.\\n';\n    output +=\n      'To reject a request, use action=\"reject\" with the specific requestId.';\n    return output;\n  }\n\n  private viewRequest(requestId: number): string {\n    const request = this.stateManager.getConnectionRequestById(requestId);\n    if (!request) {\n      return `Error: Request ID ${requestId} not found or no longer pending.`;\n    }\n\n    let output = `Details for connection request #${requestId}:\\n\\n`;\n    output += `Requestor ID: ${request.requestorId}\\n`;\n    output += `Requestor Name: ${request.requestorName}\\n`;\n    output += `Received: ${request.timestamp.toLocaleString()}\\n`;\n\n    if (request.memo) {\n      output += `Memo: ${request.memo}\\n`;\n    }\n\n    if (request.profile) {\n      output += '\\nAgent Profile Information:\\n';\n\n      if (request.profile.name) {\n        output += `Name: ${request.profile.name}\\n`;\n      }\n\n      if (request.profile.type) {\n        output += `Type: ${request.profile.type}\\n`;\n      }\n\n      if (request.profile.bio) {\n        output += `Bio: ${request.profile.bio}\\n`;\n      }\n    }\n\n    output += '\\nActions:\\n';\n    output += `- To reject this request: action=\"reject\", requestId=${requestId}\\n`;\n    output +=\n      'Use the separate \"accept_connection_request\" tool to accept requests.';\n    return output;\n  }\n\n  private async rejectRequest(requestId: number): Promise<string> {\n    const request = this.stateManager.getConnectionRequestById(requestId);\n    if (!request) {\n      return `Error: Request ID ${requestId} not found or no longer pending.`;\n    }\n\n    this.stateManager.removeConnectionRequest(requestId);\n    return `Connection request #${requestId} from ${request.requestorName} was rejected locally (removed from pending list).`;\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"],"names":["ManageConnectionRequestsTool","StructuredTool","hcsClient","stateManager","rest","z","Logger","action","requestId","error","now","inboundTopicId","outboundTopicId","outboundConfirmations","msg","confirmedRequestIds","conf","incomingRequests","profilePromises","request","requestorId","profile","profileResult","profileError","requests","output","a","b","index"],"mappings":"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"}

package/dist/tools/RegisterAgentTool.d.ts

@@ -0,0 +1,188 @@
+import { HCS10Client } from '../hcs10/HCS10Client';
+import { StructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { IStateManager } from '../state/state-types';
+/**
+ * RegisterAgentTool wraps the createAndRegisterAgent() function of HCS10Client.
+ * It creates and registers an agent on Hedera using the HCS-10 standard SDK flow.
+ * On success, returns a JSON string containing the new agent's details (including private key).
+ */
+export declare class RegisterAgentTool extends StructuredTool {
+    name: string;
+    description: string;
+    private client;
+    private stateManager?;
+    schema: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<["autonomous", "manual"]>>;
+        model: z.ZodOptional<z.ZodString>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        profilePicture: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+            url: z.ZodString;
+            filename: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            filename: string;
+        }, {
+            url: string;
+            filename: string;
+        }>, z.ZodObject<{
+            path: z.ZodString;
+            filename: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            filename?: string | undefined;
+        }, {
+            path: string;
+            filename?: string | undefined;
+        }>]>>;
+        feeCollectorAccountId: z.ZodOptional<z.ZodString>;
+        hbarFee: z.ZodOptional<z.ZodNumber>;
+        tokenFee: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            tokenId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            tokenId: string;
+        }, {
+            amount: number;
+            tokenId: string;
+        }>>;
+        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">>;
+        setAsCurrent: z.ZodOptional<z.ZodBoolean>;
+        persistence: z.ZodOptional<z.ZodObject<{
+            prefix: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            prefix?: string | undefined;
+        }, {
+            prefix?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        capabilities?: number[] | undefined;
+        description?: string | undefined;
+        type?: "autonomous" | "manual" | undefined;
+        model?: string | undefined;
+        profilePicture?: string | {
+            url: string;
+            filename: string;
+        } | {
+            path: string;
+            filename?: string | undefined;
+        } | undefined;
+        feeCollectorAccountId?: string | undefined;
+        hbarFee?: number | undefined;
+        tokenFee?: {
+            amount: number;
+            tokenId: string;
+        } | undefined;
+        hbarFees?: {
+            amount: number;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        tokenFees?: {
+            amount: number;
+            tokenId: string;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        exemptAccountIds?: string[] | undefined;
+        setAsCurrent?: boolean | undefined;
+        persistence?: {
+            prefix?: string | undefined;
+        } | undefined;
+    }, {
+        name: string;
+        capabilities?: number[] | undefined;
+        description?: string | undefined;
+        type?: "autonomous" | "manual" | undefined;
+        model?: string | undefined;
+        profilePicture?: string | {
+            url: string;
+            filename: string;
+        } | {
+            path: string;
+            filename?: string | undefined;
+        } | undefined;
+        feeCollectorAccountId?: string | undefined;
+        hbarFee?: number | undefined;
+        tokenFee?: {
+            amount: number;
+            tokenId: string;
+        } | undefined;
+        hbarFees?: {
+            amount: number;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        tokenFees?: {
+            amount: number;
+            tokenId: string;
+            collectorAccount?: string | undefined;
+        }[] | undefined;
+        exemptAccountIds?: string[] | undefined;
+        setAsCurrent?: boolean | undefined;
+        persistence?: {
+            prefix?: string | undefined;
+        } | undefined;
+    }>;
+    /**
+     * Creates a new RegisterAgentTool instance
+     * @param client - Instance of HCS10Client (already configured with operator/network)
+     * @param stateManager - Optional state manager to store agent details
+     */
+    constructor(client: HCS10Client, stateManager?: IStateManager);
+    /**
+     * Loads a profile picture from a local file or URL and returns a buffer
+     * @param profilePicture - Local file path or URL
+     * @returns Object containing buffer and filename
+     */
+    private loadProfilePicture;
+    /**
+     * Calls createAndRegisterAgent() with the provided metadata.
+     * Returns a JSON string with agent details on success, or an error string.
+     */
+    _call(input: z.infer<typeof this.schema>): Promise<string>;
+    /**
+     * Checks if the token fee configuration is valid
+     */
+    private hasValidTokenFee;
+    /**
+     * Processes the registration result and returns formatted output
+     */
+    private processRegistrationResult;
+    /**
+     * Ensures the agent has enough HBAR for operations
+     */
+    private ensureAgentHasFunds;
+    /**
+     * Validates that all required fields are present in the registration result
+     */
+    private validateRegistrationResult;
+    /**
+     * Creates a description of the fees configured for the agent
+     */
+    private createFeeDescription;
+}