@hashgraphonline/standards-agent-kit 0.0.3 → 0.0.5

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

@@ -1,6 +1,11 @@
 import { TransactionReceipt, PrivateKey } from '@hashgraph/sdk';
-import { HCS10Client as StandardSDKClient, AgentRegistrationResult, WaitForConnectionConfirmationResponse, ProfileResponse, HCSMessage } from '@hashgraphonline/standards-sdk';
+import { HCS10Client as StandardSDKClient, AgentRegistrationResult, WaitForConnectionConfirmationResponse, ProfileResponse, HCSMessage, LogLevel } from '@hashgraphonline/standards-sdk';
 import { AgentMetadata, AgentChannels } from './types';
+export interface HCSMessageWithTimestamp extends HCSMessage {
+    timestamp: number;
+    data: string;
+    sequence_number: number;
+}
 export interface ExtendedAgentMetadata extends AgentMetadata {
     pfpBuffer?: Buffer;
     pfpFileName?: string;
@@ -16,12 +21,14 @@ export type StandardNetworkType = 'mainnet' | 'testnet';
  * - Sends messages on Hedera topics (currently manual, potential for standard SDK integration).
  */
 export declare class HCS10Client {
-    private standardClient;
+    standardClient: StandardSDKClient;
     private useEncryption;
     agentChannels?: AgentChannels;
+    guardedRegistryBaseUrl: string;
     constructor(operatorId: string, operatorPrivateKey: string, network: StandardNetworkType, options?: {
         useEncryption?: boolean;
         registryUrl?: string;
+        logLevel?: LogLevel;
     });
     getOperatorId(): string;
     getNetwork(): StandardNetworkType;
@@ -57,7 +64,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<string>;
+    sendMessage(topicId: string, data: string, memo?: string, submitKey?: PrivateKey): Promise<number | undefined>;
     /**
      * Retrieves messages from a topic using the standard SDK client.
      *
@@ -65,11 +72,7 @@ export declare class HCS10Client {
      * @returns Messages from the topic, mapped to the expected format.
      */
     getMessages(topicId: string): Promise<{
-        messages: Array<{
-            timestamp: number;
-            data: string;
-            sequence_number: number;
-        }>;
+        messages: HCSMessageWithTimestamp[];
     }>;
     getMessageStream(topicId: string): Promise<{
         messages: HCSMessage[];
@@ -80,5 +83,13 @@ export declare class HCS10Client {
      * @returns The resolved message content.
      */
     getMessageContent(inscriptionIdOrData: string): Promise<string>;
+    /**
+     * Retrieves the inbound topic ID associated with the current operator.
+     * This typically involves fetching the operator's own HCS-10 profile.
+     * @returns A promise that resolves to the operator's inbound topic ID.
+     * @throws {Error} If the operator ID cannot be determined or the profile/topic cannot be retrieved.
+     */
+    getInboundTopicId(): Promise<string>;
+    setClient(accountId: string, privateKey: string): StandardSDKClient;
 }
 export {};

package/dist/src/index.d.ts

@@ -2,11 +2,11 @@ import { HCS10Client } from './hcs10/HCS10Client';
 import { RegisterAgentTool } from './tools/RegisterAgentTool';
 import { SendMessageTool } from './tools/SendMessageTool';
 import { ConnectionTool } from './tools/ConnectionTool';
-import { DemoState } from './demo-state';
+import { OpenConvaiState as StateManagerInterface } from './open-convai-state';
 export interface HCS10InitializationOptions {
     useEncryption?: boolean;
     registryUrl?: string;
-    demoState?: DemoState;
+    demoState?: StateManagerInterface;
 }
 /**
  * Initializes the HCS10 client and returns pre-registered LangChain tools.

package/dist/src/{demo-state.d.ts → open-convai-state.d.ts}

@@ -12,10 +12,11 @@ export interface ActiveConnection {
     connectionTopicId: string;
 }
 /**
- * Holds the shared state for the interactive demo.
- * Tools will need access to this instance to read/update state.
+ * Holds shared state, primarily for demonstration purposes.
+ * Tools can use an instance of this (or a similar custom class)
+ * via their `stateManager` constructor parameter to track connections.
  */
-export declare class DemoState {
+export declare class OpenConvaiState {
     currentAgent: RegisteredAgent | null;
     activeConnections: ActiveConnection[];
     connectionMessageTimestamps: {

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

@@ -1,10 +1,10 @@
 import { StructuredTool, ToolParams } from '@langchain/core/tools';
 import { z } from 'zod';
 import { HCS10Client } from '../hcs10/HCS10Client';
-import { DemoState } from '../demo-state';
+import { OpenConvaiState as StateManagerInterface } from '../open-convai-state';
 export interface CheckMessagesToolParams extends ToolParams {
     hcsClient: HCS10Client;
-    demoState: DemoState;
+    stateManager: StateManagerInterface;
 }
 /**
  * A tool to check for new messages on an active HCS-10 connection topic.
@@ -19,9 +19,9 @@ export declare class CheckMessagesTool extends StructuredTool {
     }, {
         targetIdentifier: string;
     }>;
-    private hcsClient;
-    private demoState;
+    hcsClient: HCS10Client;
+    private stateManager;
     private logger;
-    constructor({ hcsClient, demoState, ...rest }: CheckMessagesToolParams);
-    protected _call({ targetIdentifier }: z.infer<this['schema']>): Promise<string>;
+    constructor({ hcsClient, stateManager, ...rest }: CheckMessagesToolParams);
+    protected _call({ targetIdentifier, }: z.infer<this['schema']>): Promise<string>;
 }

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

@@ -1,39 +1,37 @@
 import { HCS10Client } from '../hcs10/HCS10Client';
 import { StructuredTool, ToolParams } from '@langchain/core/tools';
 import { z } from 'zod';
-import { DemoState } from '../demo-state';
+import { Logger } from '@hashgraphonline/standards-sdk';
+import { OpenConvaiState as StateManagerInterface } from '../open-convai-state';
 export interface ConnectionToolParams extends ToolParams {
     client: HCS10Client;
-    demoState: DemoState;
+    stateManager: StateManagerInterface;
 }
 /**
- * ConnectionTool monitors an agent's inbound topic for connection requests
+ * 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;
-    private client;
-    private logger;
-    private demoState;
+    client: HCS10Client;
+    logger: Logger;
+    private stateManager;
     private isMonitoring;
     private monitoringTopic;
-    schema: z.ZodObject<{
-        inboundTopicId: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        inboundTopicId: string;
-    }, {
-        inboundTopicId: string;
-    }>;
+    schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
     /**
      * @param client - Instance of HCS10Client.
-     * @param demoState - Instance of DemoState for shared state management.
+     * @param stateManager - Instance of StateManager for shared state management.
      */
-    constructor({ client, demoState, ...rest }: ConnectionToolParams);
+    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>;
+    _call(_input: z.infer<typeof this.schema>): Promise<string>;
     /**
      * The core monitoring loop.
      */

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

@@ -1,15 +1,16 @@
 import { StructuredTool, ToolParams } from '@langchain/core/tools';
 import { z } from 'zod';
 import { HCS10Client } from '../hcs10/HCS10Client';
-import { DemoState } from '../demo-state';
+import { OpenConvaiState as StateManagerInterface } from '../open-convai-state';
 export interface InitiateConnectionToolParams extends ToolParams {
     hcsClient: HCS10Client;
-    demoState: DemoState;
+    stateManager: StateManagerInterface;
 }
 /**
- * A tool to orchestrate the HCS-10 connection initiation process.
- * Takes a target agent's account ID, retrieves their profile, submits a connection request,
- * waits for confirmation, and updates the demo state.
+ * A tool to actively START a NEW HCS-10 connection TO a target agent.
+ * Requires the target agent's account ID.
+ * It retrieves their profile, sends a connection request, waits for confirmation, and stores the connection using the provided stateManager.
+ * Use this tool ONLY to actively INITIATE an OUTGOING connection.
  */
 export declare class InitiateConnectionTool extends StructuredTool {
     name: string;
@@ -22,8 +23,8 @@ export declare class InitiateConnectionTool extends StructuredTool {
         targetAccountId: string;
     }>;
     private hcsClient;
-    private demoState;
+    private stateManager;
     private logger;
-    constructor({ hcsClient, demoState, ...rest }: InitiateConnectionToolParams);
+    constructor({ hcsClient, stateManager, ...rest }: InitiateConnectionToolParams);
     protected _call({ targetAccountId, }: z.infer<this['schema']>): Promise<string>;
 }

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

@@ -1,17 +1,17 @@
 import { StructuredTool, ToolParams } from '@langchain/core/tools';
 import { z } from 'zod';
-import { DemoState } from '../demo-state';
+import { OpenConvaiState as StateManagerInterface } from '../open-convai-state';
 export interface ListConnectionsToolParams extends ToolParams {
-    demoState: DemoState;
+    stateManager: StateManagerInterface;
 }
 /**
- * A tool to list currently active HCS-10 connections stored in the DemoState.
+ * A tool to list currently active HCS-10 connections stored in the state manager.
  */
 export declare class ListConnectionsTool extends StructuredTool {
     name: string;
     description: string;
     schema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
-    private demoState;
-    constructor({ demoState, ...rest }: ListConnectionsToolParams);
+    private stateManager;
+    constructor({ stateManager, ...rest }: ListConnectionsToolParams);
     protected _call(_: z.infer<this['schema']>): Promise<string>;
 }

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

@@ -1,10 +1,10 @@
 import { HCS10Client } from '../hcs10/HCS10Client';
 import { StructuredTool } from '@langchain/core/tools';
 import { z } from 'zod';
-import { RegisteredAgent } from '../demo-state';
 /**
  * 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;
@@ -32,7 +32,7 @@ export declare class RegisterAgentTool extends StructuredTool {
     constructor(client: HCS10Client);
     /**
      * Calls createAndRegisterAgent() with the provided metadata.
-     * Returns the details of the registered agent.
+     * Returns a JSON string with agent details on success, or an error string.
      */
-    _call(input: z.infer<typeof this.schema>): Promise<RegisteredAgent | string>;
+    _call(input: z.infer<typeof this.schema>): Promise<string>;
 }

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

@@ -1,10 +1,10 @@
 import { StructuredTool, ToolParams } from '@langchain/core/tools';
 import { z } from 'zod';
 import { HCS10Client } from '../hcs10/HCS10Client';
-import { DemoState } from '../demo-state';
+import { OpenConvaiState as StateManagerInterface } from '../open-convai-state';
 export interface SendMessageToConnectionToolParams extends ToolParams {
     hcsClient: HCS10Client;
-    demoState: DemoState;
+    stateManager: StateManagerInterface;
 }
 /**
  * A tool to send a message to an agent over an established HCS-10 connection.
@@ -23,8 +23,9 @@ export declare class SendMessageToConnectionTool extends StructuredTool {
         targetIdentifier: string;
     }>;
     private hcsClient;
-    private demoState;
+    private stateManager;
     private logger;
-    constructor({ hcsClient, demoState, ...rest }: SendMessageToConnectionToolParams);
+    constructor({ hcsClient, stateManager, ...rest }: SendMessageToConnectionToolParams);
     protected _call({ targetIdentifier, message, }: z.infer<this['schema']>): Promise<string>;
+    private monitorResponses;
 }

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

@@ -10,6 +10,7 @@ export declare class SendMessageTool extends StructuredTool {
     description: string;
     private client;
     private lastProcessedTimestamp;
+    private logger;
     schema: z.ZodObject<{
         topicId: z.ZodString;
         message: z.ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "An Agents implementation of Hashgraph Online's Standards SDK",
   "type": "module",
   "main": "./dist/index.es.js",
@@ -30,8 +30,8 @@
   "author": "Hashgraph Online",
   "license": "Apache-2.0",
   "dependencies": {
-    "@hashgraph/sdk": "^2.39.0",
-    "@hashgraphonline/standards-sdk": "0.0.59",
+    "@hashgraph/sdk": "^2.62.0",
+    "@hashgraphonline/standards-sdk": "0.0.62",
     "@langchain/community": "^0.3.37",
     "@langchain/openai": "^0.5.1",
     "dotenv": "^16.4.1",
@@ -49,10 +49,12 @@
     "jest": "^29.7.0",
     "@swc/core": "^1.11.16",
     "@swc/jest": "^0.2.36",
-    "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
     "tsx": "^4.19.3",
     "vite": "^6.2.3",
     "vite-plugin-dts": "^4.5.3"
+  },
+  "resolutions": {
+    "@hashgraph/sdk": "^2.62.0"
   }
 }

package/dist/examples/cli-demo.d.ts

@@ -1 +0,0 @@
-export {};