@hashgraphonline/standards-sdk 0.0.44 → 0.0.46

package/README.md

@@ -58,12 +58,19 @@ The SDK includes demo implementations that showcase various features. Follow the
 
    ```bash
    # Run the inscribe demo
-   npm run demo
+   npm run demo:inscribe
+   ```
 
+   ```bash
    # Run the HCS-10 AI agent communication demo
    npm run demo:hcs-10
    ```
 
+   ```bash
+   # Run the HCS-10 polling demo
+   npm run demo:polling-agent
+   ```
+
 ### Demo Descriptions
 
 #### Inscribe Demo

package/dist/es/hcs-10/base-client.d.ts

@@ -9,7 +9,7 @@ export interface HCS10Config {
 }
 export interface HCSMessage {
     p: 'hcs-10';
-    op: 'connection_request' | 'connection_created' | 'message';
+    op: 'connection_request' | 'connection_created' | 'message' | 'close_connection';
     data: string;
     created?: Date;
     consensus_timestamp?: string;
@@ -24,6 +24,8 @@ export interface HCSMessage {
     connection_id?: number;
     sequence_number: number;
     operator_id?: string;
+    reason?: string;
+    close_method?: string;
 }
 export interface ProfileResponse {
     profile: any;
@@ -40,6 +42,25 @@ export declare abstract class HCS10BaseClient extends Registration {
         accountId: string;
         signer: any;
     };
+    /**
+     * Get a stream of messages from a connection topic
+     * @param topicId The connection topic ID to get messages from
+     * @returns A stream of filtered messages valid for connection topics
+     */
+    getMessageStream(topicId: string): Promise<{
+        messages: HCSMessage[];
+    }>;
+    /**
+     * Validates if an operator_id follows the correct format (agentTopicId@accountId)
+     * @param operatorId The operator ID to validate
+     * @returns True if the format is valid, false otherwise
+     */
+    protected isValidOperatorId(operatorId: string): boolean;
+    /**
+     * Get all messages from a topic
+     * @param topicId The topic ID to get messages from
+     * @returns All messages from the topic
+     */
     getMessages(topicId: string): Promise<{
         messages: HCSMessage[];
     }>;

package/dist/es/standards-sdk.es.js

@@ -23824,11 +23824,106 @@ class HCS10BaseClient extends Registration {
       this.logger
     );
   }
+  /**
+   * Get a stream of messages from a connection topic
+   * @param topicId The connection topic ID to get messages from
+   * @returns A stream of filtered messages valid for connection topics
+   */
+  async getMessageStream(topicId) {
+    try {
+      const messages = await this.mirrorNode.getTopicMessages(topicId);
+      const validOps = ["message", "close_connection"];
+      const filteredMessages = messages.filter((msg) => {
+        if (msg.p !== "hcs-10" || !validOps.includes(msg.op)) {
+          return false;
+        }
+        if (msg.op === "message") {
+          if (!msg.data) {
+            return false;
+          }
+          if (!msg.operator_id) {
+            return false;
+          }
+          if (!this.isValidOperatorId(msg.operator_id)) {
+            return false;
+          }
+        }
+        if (msg.op === "close_connection") {
+          if (!msg.operator_id) {
+            return false;
+          }
+          if (!this.isValidOperatorId(msg.operator_id)) {
+            return false;
+          }
+        }
+        return true;
+      });
+      return {
+        messages: filteredMessages
+      };
+    } catch (error) {
+      if (this.logger) {
+        this.logger.error(`Error fetching messages: ${error.message}`);
+      }
+      return { messages: [] };
+    }
+  }
+  /**
+   * Validates if an operator_id follows the correct format (agentTopicId@accountId)
+   * @param operatorId The operator ID to validate
+   * @returns True if the format is valid, false otherwise
+   */
+  isValidOperatorId(operatorId) {
+    if (!operatorId) {
+      return false;
+    }
+    const parts = operatorId.split("@");
+    if (parts.length !== 2) {
+      return false;
+    }
+    const agentTopicId = parts[0];
+    const accountId = parts[1];
+    if (!agentTopicId) {
+      return false;
+    }
+    if (!accountId) {
+      return false;
+    }
+    const hederaIdPattern = /^[0-9]+\.[0-9]+\.[0-9]+$/;
+    if (!hederaIdPattern.test(accountId)) {
+      return false;
+    }
+    if (!hederaIdPattern.test(agentTopicId)) {
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Get all messages from a topic
+   * @param topicId The topic ID to get messages from
+   * @returns All messages from the topic
+   */
   async getMessages(topicId) {
     try {
       const messages = await this.mirrorNode.getTopicMessages(topicId);
+      const validatedMessages = messages.filter((msg) => {
+        if (msg.p !== "hcs-10") {
+          return false;
+        }
+        if (msg.op === "message") {
+          if (!msg.data) {
+            return false;
+          }
+          if (msg.operator_id) {
+            if (!this.isValidOperatorId(msg.operator_id)) {
+              return false;
+            }
+          }
+        }
+        return true;
+      });
       return {
-        messages
+        messages: validatedMessages
       };
     } catch (error) {
       if (this.logger) {