@hashgraphonline/standards-agent-kit 0.0.12 → 0.0.15

package/dist/src/tools/RegisterAgentTool.d.ts

@@ -1,6 +1,7 @@
 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.
@@ -10,12 +11,32 @@ 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<{
@@ -28,41 +49,140 @@ export declare class RegisterAgentTool extends StructuredTool {
             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;
-        capabilities?: number[] | 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;
-        capabilities?: number[] | 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;
     }>;
     /**
-     * @param client - Instance of HCS10Client (already configured with operator/network).
+     * 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);
+    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;
 }

package/dist/src/tools/RetrieveProfileTool.d.ts

@@ -0,0 +1,34 @@
+import { StructuredTool } from '@langchain/core/tools';
+import { z } from 'zod';
+import { HCS10Client } from '../hcs10/HCS10Client';
+/**
+ * Tool for retrieving the HCS-11 profile associated with a Hedera account ID.
+ * Utilizes the HCS10Client's retrieveProfile method, which handles fetching.
+ */
+export declare class RetrieveProfileTool extends StructuredTool {
+    name: string;
+    description: string;
+    private client;
+    private logger;
+    schema: z.ZodObject<{
+        accountId: z.ZodOptional<z.ZodString>;
+        disableCache: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        accountId?: string | undefined;
+        disableCache?: boolean | undefined;
+    }, {
+        accountId?: string | undefined;
+        disableCache?: boolean | undefined;
+    }>;
+    /**
+     * Creates a new RetrieveProfileTool instance.
+     * @param client - An instance of HCS10Client.
+     */
+    constructor(client: HCS10Client);
+    /**
+     * Executes the profile retrieval.
+     * @param input - The input object containing accountId and optional disableCache flag.
+     * @returns A JSON string of the profile on success, or an error message string.
+     */
+    _call(input: z.infer<typeof this.schema>): Promise<string>;
+}

package/dist/src/tools/SendMessageToConnectionTool.d.ts

@@ -1,7 +1,7 @@
 import { StructuredTool, ToolParams } from '@langchain/core/tools';
 import { z } from 'zod';
 import { HCS10Client } from '../hcs10/HCS10Client';
-import { IStateManager } from '../state/open-convai-state';
+import { IStateManager } from '../state/state-types';
 export interface SendMessageToConnectionToolParams extends ToolParams {
     hcsClient: HCS10Client;
     stateManager: IStateManager;

package/dist/src/utils/connectionUtils.d.ts

@@ -0,0 +1,15 @@
+import { HCS10Client } from '../hcs10/HCS10Client';
+import { HCSMessage, HCS11Profile } from '@hashgraphonline/standards-sdk';
+export interface ConnectionMap {
+    inboundRequests: Map<number, HCSMessage>;
+    outboundConfirmations: Map<number, HCSMessage>;
+    outboundRequests: Map<number, HCSMessage>;
+    inboundConfirmations: Map<number, HCSMessage>;
+    profileMap: Map<string, HCS11Profile>;
+    confirmedRequestIds: Set<number>;
+}
+/**
+ * Fetches and processes inbound/outbound messages and profiles
+ * to provide a map of connection states.
+ */
+export declare function fetchConnectionMap(hcsClient: HCS10Client): Promise<ConnectionMap>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.0.12",
+  "version": "0.0.15",
   "description": "A modular SDK for building on-chain autonomous agents using Hashgraph Online Standards, including HCS-10 for agent discovery and communication.",
   "type": "module",
   "main": "./dist/index.es.js",
@@ -68,7 +68,7 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.62.0",
-    "@hashgraphonline/standards-sdk": "0.0.70",
+    "@hashgraphonline/standards-sdk": "0.0.73",
     "@langchain/community": "^0.3.37",
     "@langchain/openai": "^0.5.1",
     "dotenv": "^16.4.1",