@hashgraphonline/standards-agent-kit 0.0.3 → 0.0.4

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

@@ -16,9 +16,10 @@ 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;
@@ -80,5 +81,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/tools/ConnectionTool.d.ts

@@ -7,8 +7,10 @@ export interface ConnectionToolParams extends ToolParams {
     demoState: DemoState;
 }
 /**
- * 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;
@@ -18,13 +20,7 @@ export declare class ConnectionTool extends StructuredTool {
     private demoState;
     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.
@@ -32,6 +28,7 @@ export declare class ConnectionTool extends StructuredTool {
     constructor({ client, demoState, ...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>;
     /**

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

@@ -7,9 +7,10 @@ export interface InitiateConnectionToolParams extends ToolParams {
     demoState: DemoState;
 }
 /**
- * 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.
+ * Use this tool ONLY to actively INITIATE an OUTGOING connection.
  */
 export declare class InitiateConnectionTool extends StructuredTool {
     name: 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/standards-agent-kit",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "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.ts"
+    "langchain-demo": "tsx examples/langchain-demo.js"
   },
   "keywords": [
     "hedera",
@@ -31,7 +31,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@hashgraph/sdk": "^2.39.0",
-    "@hashgraphonline/standards-sdk": "0.0.59",
+    "@hashgraphonline/standards-sdk": "0.0.61",
     "@langchain/community": "^0.3.37",
     "@langchain/openai": "^0.5.1",
     "dotenv": "^16.4.1",