@hashgraphonline/standards-agent-kit 0.0.12 → 0.0.13

package/dist/src/hcs10/HCS10Client.d.ts

@@ -1,6 +1,9 @@
 import { TransactionReceipt, PrivateKey } from '@hashgraph/sdk';
-import { HCS10Client as StandardSDKClient, AgentRegistrationResult, WaitForConnectionConfirmationResponse, ProfileResponse as SDKProfileResponse, HCSMessage, LogLevel } from '@hashgraphonline/standards-sdk';
+import { HCS10Client as StandardSDKClient, AgentRegistrationResult, WaitForConnectionConfirmationResponse, ProfileResponse as SDKProfileResponse, HCSMessage, LogLevel, Logger, FeeConfigBuilderInterface } from '@hashgraphonline/standards-sdk';
 import { AgentMetadata, AgentChannels } from './types';
+type StandardHandleConnectionRequest = InstanceType<typeof StandardSDKClient>['handleConnectionRequest'];
+type HandleConnectionRequestResponse = Awaited<ReturnType<StandardHandleConnectionRequest>>;
+export type StandardNetworkType = 'mainnet' | 'testnet';
 export interface HCSMessageWithTimestamp extends HCSMessage {
     timestamp: number;
     data: string;
@@ -9,11 +12,8 @@ export interface HCSMessageWithTimestamp extends HCSMessage {
 export interface ExtendedAgentMetadata extends AgentMetadata {
     pfpBuffer?: Buffer;
     pfpFileName?: string;
+    feeConfig?: FeeConfigBuilderInterface;
 }
-type StandardHandleConnectionRequest = InstanceType<typeof StandardSDKClient>['handleConnectionRequest'];
-type FeeConfigBuilderInterface = Parameters<StandardHandleConnectionRequest>[3];
-type HandleConnectionRequestResponse = Awaited<ReturnType<StandardHandleConnectionRequest>>;
-export type StandardNetworkType = 'mainnet' | 'testnet';
 /**
  * HCS10Client wraps the HCS-10 functionalities using the @hashgraphonline/standards-sdk.
  * - Creates and registers agents using the standard SDK flow.
@@ -25,6 +25,7 @@ export declare class HCS10Client {
     private useEncryption;
     agentChannels?: AgentChannels;
     guardedRegistryBaseUrl: string;
+    logger: Logger;
     constructor(operatorId: string, operatorPrivateKey: string, network: StandardNetworkType, options?: {
         useEncryption?: boolean;
         registryUrl?: string;
@@ -48,7 +49,14 @@ export declare class HCS10Client {
     /**
      * Creates and registers an agent using the standard SDK's HCS10Client.
      * This handles account creation, key generation, topic setup, and registration.
-     * @param metadata - The agent's metadata, potentially including pfpBuffer and pfpFileName.
+     *
+     * When metadata includes fee configuration:
+     * 1. The properties.feeConfig will be passed to the AgentBuilder
+     * 2. The properties.inboundTopicType will be set to FEE_BASED
+     * 3. The SDK's createAndRegisterAgent will apply the fees to the agent's inbound topic
+     *
+     * @param metadata - The agent's metadata, potentially including pfpBuffer, pfpFileName,
+     *                   and fee configuration in properties.feeConfig
      * @returns The registration result from the standard SDK, containing accountId, keys, topics etc.
      */
     createAndRegisterAgent(metadata: ExtendedAgentMetadata): Promise<AgentRegistrationResult>;
@@ -63,7 +71,7 @@ export declare class HCS10Client {
      * @param submitKey - Optional private key for topics requiring specific submit keys.
      * @returns A confirmation status string from the transaction receipt.
      */
-    sendMessage(topicId: string, data: string, memo?: string, submitKey?: PrivateKey): Promise<number | undefined>;
+    sendMessage(topicId: string, data: string, memo?: string, submitKey?: any): Promise<number | undefined>;
     /**
      * Retrieves messages from a topic using the standard SDK client.
      *

package/dist/src/hcs10/types.d.ts

@@ -1,3 +1,4 @@
+import { FeeConfigBuilderInterface } from '@hashgraphonline/standards-sdk';
 /**
  * Agent metadata interface used during registration.
  */
@@ -10,6 +11,9 @@ export interface AgentMetadata {
     capabilities?: number[];
     social?: Record<string, string>;
     properties?: Record<string, unknown>;
+    socials?: Record<string, string>;
+    creator?: string;
+    feeConfig?: FeeConfigBuilderInterface;
 }
 /**
  * AgentChannels represents the communication topics for an agent.

package/dist/src/index.d.ts

@@ -2,3 +2,14 @@ export * from './hcs10';
 export * from './tools';
 export * from './state';
 export * from './init';
+export { ConnectionTool } from './tools/ConnectionTool';
+export { ConnectionMonitorTool } from './tools/ConnectionMonitorTool';
+export { ManageConnectionRequestsTool } from './tools/ManageConnectionRequestsTool';
+export { AcceptConnectionRequestTool } from './tools/AcceptConnectionRequestTool';
+export { InitiateConnectionTool } from './tools/InitiateConnectionTool';
+export { ListConnectionsTool } from './tools/ListConnectionsTool';
+export { CheckMessagesTool } from './tools/CheckMessagesTool';
+export { FindRegistrationsTool } from './tools/FindRegistrationsTool';
+export { SendMessageTool } from './tools/SendMessageTool';
+export { SendMessageToConnectionTool } from './tools/SendMessageToConnectionTool';
+export { ListUnapprovedConnectionRequestsTool } from './tools/ListUnapprovedConnectionRequestsTool';

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

@@ -49,9 +49,6 @@ export declare class ConnectionMonitorTool extends StructuredTool {
         monitorDurationSeconds: z.ZodOptional<z.ZodNumber>;
         defaultCollectorAccount: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        exemptAccountIds?: string[] | undefined;
-        targetAccountId?: string | undefined;
-        acceptAll?: boolean | undefined;
         hbarFees?: {
             amount: number;
             collectorAccount?: string | undefined;
@@ -61,12 +58,12 @@ export declare class ConnectionMonitorTool extends StructuredTool {
             tokenId: string;
             collectorAccount?: string | undefined;
         }[] | undefined;
-        monitorDurationSeconds?: number | undefined;
-        defaultCollectorAccount?: string | undefined;
-    }, {
         exemptAccountIds?: string[] | undefined;
         targetAccountId?: string | undefined;
         acceptAll?: boolean | undefined;
+        monitorDurationSeconds?: number | undefined;
+        defaultCollectorAccount?: string | undefined;
+    }, {
         hbarFees?: {
             amount: number;
             collectorAccount?: string | undefined;
@@ -76,6 +73,9 @@ export declare class ConnectionMonitorTool extends StructuredTool {
             tokenId: string;
             collectorAccount?: string | undefined;
         }[] | undefined;
+        exemptAccountIds?: string[] | undefined;
+        targetAccountId?: string | undefined;
+        acceptAll?: boolean | undefined;
         monitorDurationSeconds?: number | undefined;
         defaultCollectorAccount?: string | undefined;
     }>;

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

@@ -0,0 +1,53 @@
+import { StructuredTool, ToolParams } from '@langchain/core/tools';
+import { z } from 'zod';
+import { IStateManager } from '../state/open-convai-state';
+import { HCS10Client } from '../hcs10/HCS10Client';
+type ListPendingRequestsToolParams = ToolParams & {
+    hcsClient: HCS10Client;
+    stateManager: IStateManager;
+};
+export declare class ListUnapprovedConnectionRequestsTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        sortBy: z.ZodOptional<z.ZodEnum<["time_asc", "time_desc", "name_asc", "name_desc"]>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        sortBy?: "time_asc" | "time_desc" | "name_asc" | "name_desc" | undefined;
+        limit?: number | undefined;
+    }, {
+        sortBy?: "time_asc" | "time_desc" | "name_asc" | "name_desc" | undefined;
+        limit?: number | undefined;
+    }>;
+    private hcsClient;
+    private stateManager;
+    private logger;
+    constructor({ hcsClient, stateManager, ...rest }: ListPendingRequestsToolParams);
+    protected _call({ sortBy, limit, }: z.infer<this['schema']>): Promise<string>;
+    /**
+     * Processes the connection connectionMap to find all requests
+     * that are not fully established (incoming unapproved and outgoing pending).
+     */
+    private findAllPendingRequests;
+    /**
+     * Helper to attempt extracting target account ID from outbound request message.
+     */
+    private extractTargetAccountIdFromOutbound;
+    /**
+     * Maps HCS11Profile to the AgentProfileInfo used in state/display.
+     */
+    private mapSDKProfileToInfo;
+    /**
+     * Extracts the account ID from relevant fields in an HCSMessage.
+     */
+    private extractAccountIdFromMessage;
+    /**
+     * Formats the list of pending requests for display.
+     */
+    private formatRequestsList;
+    /**
+     * Sorts connection requests based on the specified criteria.
+     */
+    private sortRequests;
+}
+export {};

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

@@ -29,7 +29,7 @@ export declare class ManageConnectionRequestsTool extends StructuredTool {
     private lastRefreshTime;
     private refreshIntervalMs;
     constructor({ hcsClient, stateManager, ...rest }: ManageConnectionRequestsToolParams);
-    protected _call({ action, requestId }: z.infer<this['schema']>): Promise<string>;
+    protected _call({ action, requestId, }: z.infer<this['schema']>): Promise<string>;
     private refreshRequestsIfNeeded;
     private refreshRequests;
     private listRequests;

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

@@ -28,36 +28,78 @@ 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">>;
     }, "strip", z.ZodTypeAny, {
         name: string;
+        capabilities?: number[] | undefined;
         description?: string | undefined;
         type?: "autonomous" | "manual" | undefined;
         model?: string | undefined;
-        capabilities?: number[] | 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;
     }, {
         name: string;
+        capabilities?: number[] | undefined;
         description?: string | undefined;
         type?: "autonomous" | "manual" | undefined;
         model?: string | undefined;
-        capabilities?: number[] | 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;
     }>;
     /**
-     * @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)
      */
     constructor(client: HCS10Client);
     /**
@@ -65,4 +107,28 @@ export declare class RegisterAgentTool extends StructuredTool {
      * 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;
+    /**
+     * Updates the environment file with the new agent details
+     */
+    private updateEnvironmentFile;
+    /**
+     * 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/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.13",
   "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.72",
     "@langchain/community": "^0.3.37",
     "@langchain/openai": "^0.5.1",
     "dotenv": "^16.4.1",