@hashgraphonline/standards-agent-kit 0.0.4 → 0.0.6

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;
@@ -23,6 +28,7 @@ export declare class HCS10Client {
     constructor(operatorId: string, operatorPrivateKey: string, network: StandardNetworkType, options?: {
         useEncryption?: boolean;
         registryUrl?: string;
+        logLevel?: LogLevel;
     });
     getOperatorId(): string;
     getNetwork(): StandardNetworkType;
@@ -58,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.
      *
@@ -66,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[];

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,10 +1,11 @@
 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 the *current* agent's inbound topic for connection requests
@@ -15,22 +16,22 @@ export interface ConnectionToolParams extends ToolParams {
 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<{}, "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,15 @@
 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 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.
+ * 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 {
@@ -23,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/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.4",
+  "version": "0.0.6",
   "description": "An Agents implementation of Hashgraph Online's Standards SDK",
   "type": "module",
   "main": "./dist/index.es.js",
@@ -18,7 +18,7 @@
     "release": "npm publish --access public",
     "cli-demo": "tsx examples/cli-demo.ts",
     "interactive-demo": "tsx examples/interactive-demo.ts",
-    "langchain-demo": "tsx examples/langchain-demo.js"
+    "langchain-demo": "tsx examples/langchain-demo.ts"
   },
   "keywords": [
     "hedera",
@@ -30,8 +30,8 @@
   "author": "Hashgraph Online",
   "license": "Apache-2.0",
   "dependencies": {
-    "@hashgraph/sdk": "^2.39.0",
-    "@hashgraphonline/standards-sdk": "0.0.61",
+    "@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 {};

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

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

package/dist/examples/utils.d.ts

@@ -1,26 +0,0 @@
-import { HCS10Client, AgentBuilder, Logger } from '@hashgraphonline/standards-sdk';
-export declare const MIN_REQUIRED_USD = 2;
-export declare const MIN_REQUIRED_HBAR_USD = 10;
-export declare const ENV_FILE_PATH: string;
-export interface AgentData {
-    accountId: string;
-    operatorId: string;
-    inboundTopicId: string;
-    outboundTopicId: string;
-    client: HCS10Client;
-}
-export interface RegistrationProgressData {
-    registered: boolean;
-    accountId?: string;
-    privateKey?: string;
-    publicKey?: string;
-    inboundTopicId?: string;
-    outboundTopicId?: string;
-}
-export declare function ensureAgentHasEnoughHbar(logger: Logger, baseClient: HCS10Client, accountId: string, agentName: string): Promise<void>;
-export declare function getAgentFromEnv(logger: Logger, baseClient: HCS10Client, agentName: string, envPrefix: string): Promise<AgentData | null>;
-export declare function createAgent(logger: Logger, baseClient: HCS10Client, agentName: string, agentBuilder: AgentBuilder, envPrefix: string): Promise<AgentData | null>;
-export declare function updateEnvFile(envFilePath: string, variables: Record<string, string>): Promise<void>;
-export declare function createBobBuilder(pfpBuffer?: Buffer): any;
-export declare function getOrCreateBob(logger: Logger, baseClient: HCS10Client): Promise<AgentData | null>;
-export declare function getOrCreateAlice(logger: Logger, baseClient: HCS10Client): Promise<AgentData | null>;