@hashgraphonline/standards-sdk 0.0.23 → 0.0.24

package/dist/es/hcs-10/browser.d.ts

@@ -3,7 +3,7 @@ import { HashinalsWalletConnectSDK } from '@hashgraphonline/hashinal-wc';
 import { Logger, LogLevel } from '../utils/logger';
 import { RetrievedInscriptionResult } from '@kiloscribe/inscription-sdk';
 import { HCS10BaseClient } from './base-client';
-import { AgentConfig, NetworkType } from './types.d';
+import { AgentConfig, NetworkType, RegistrationProgressCallback } from './types.d';
 export type BrowserHCSClientConfig = {
     network: 'mainnet' | 'testnet';
     hwc: HashinalsWalletConnectSDK;
@@ -67,7 +67,7 @@ export declare class BrowserHCSClient extends HCS10BaseClient {
         success: boolean;
     }>;
     createAndRegisterAgent(name: string, description: string, capabilities: number[], metadata: AgentMetadata, pfpBuffer: Buffer, pfpFileName: string, network: NetworkType, existingPfpTopicId?: string): Promise<BrowserAgentConfig>;
-    registerAgentWithGuardedRegistry(accountId: string, inboundTopicId: string, network?: string, maxAttempts?: number, delayMs?: number): Promise<{
+    registerAgentWithGuardedRegistry(accountId: string, inboundTopicId: string, network?: string, progressCallbackOrMaxAttempts?: RegistrationProgressCallback | number, maxAttemptsOrDelayMs?: number, delayMsParam?: number): Promise<{
         error?: string;
         success: boolean;
         transaction?: any;

package/dist/es/hcs-10/sdk.d.ts

@@ -22,6 +22,19 @@ export interface AgentMetadata {
     creator?: string;
     properties?: Record<string, any>;
 }
+/**
+ * Progress report data for registration operations
+ */
+export interface RegistrationProgressData {
+    stage: 'preparing' | 'submitting' | 'confirming' | 'verifying' | 'completed';
+    message: string;
+    progressPercent?: number;
+    details?: Record<string, any>;
+}
+/**
+ * Progress callback function type for registration operations
+ */
+export type RegistrationProgressCallback = (data: RegistrationProgressData) => void;
 export declare class HCS10Client extends HCS10BaseClient {
     private client;
     private operatorPrivateKey;
@@ -135,11 +148,12 @@ export declare class HCS10Client extends HCS10BaseClient {
      * @param accountId Account ID to register
      * @param inboundTopicId Inbound topic ID for the agent
      * @param network Network type ('mainnet' or 'testnet')
-     * @param maxAttempts Maximum number of attempts for confirmation
-     * @param delayMs Delay between confirmation attempts
+     * @param progressCallbackOrMaxAttempts Optional callback to report registration progress for UI or maxAttempts
+     * @param maxAttemptsOrDelayMs Optional maximum attempts for confirmation or delay between attempts
+     * @param delayMsParam Optional delay between confirmation attempts
      * @returns Registration result
      */
-    registerAgentWithGuardedRegistry(accountId: string, inboundTopicId: string, network?: string, maxAttempts?: number, delayMs?: number): Promise<AgentRegistrationResult>;
+    registerAgentWithGuardedRegistry(accountId: string, inboundTopicId: string, network?: string, progressCallbackOrMaxAttempts?: RegistrationProgressCallback | number, maxAttemptsOrDelayMs?: number, delayMsParam?: number): Promise<AgentRegistrationResult>;
     /**
      * Registers an agent with the guarded registry. Should be called by a registry.
      * @param registryTopicId - The topic ID of the guarded registry.

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

@@ -32770,13 +32770,38 @@ class HCS10Client extends HCS10BaseClient {
    * @param accountId Account ID to register
    * @param inboundTopicId Inbound topic ID for the agent
    * @param network Network type ('mainnet' or 'testnet')
-   * @param maxAttempts Maximum number of attempts for confirmation
-   * @param delayMs Delay between confirmation attempts
+   * @param progressCallbackOrMaxAttempts Optional callback to report registration progress for UI or maxAttempts
+   * @param maxAttemptsOrDelayMs Optional maximum attempts for confirmation or delay between attempts
+   * @param delayMsParam Optional delay between confirmation attempts
    * @returns Registration result
    */
-  async registerAgentWithGuardedRegistry(accountId, inboundTopicId, network = this.network, maxAttempts = 60, delayMs = 2e3) {
+  async registerAgentWithGuardedRegistry(accountId, inboundTopicId, network = this.network, progressCallbackOrMaxAttempts, maxAttemptsOrDelayMs, delayMsParam) {
     try {
       this.logger.info("Registering agent with guarded registry");
+      let progressCallback;
+      let maxAttempts = 60;
+      let delayMs = 2e3;
+      if (typeof progressCallbackOrMaxAttempts === "function") {
+        progressCallback = progressCallbackOrMaxAttempts;
+        if (typeof maxAttemptsOrDelayMs === "number") {
+          maxAttempts = maxAttemptsOrDelayMs;
+        }
+        if (typeof delayMsParam === "number") {
+          delayMs = delayMsParam;
+        }
+      } else if (typeof progressCallbackOrMaxAttempts === "number") {
+        maxAttempts = progressCallbackOrMaxAttempts;
+        if (typeof maxAttemptsOrDelayMs === "number") {
+          delayMs = maxAttemptsOrDelayMs;
+        }
+      }
+      if (progressCallback) {
+        progressCallback({
+          stage: "preparing",
+          message: "Preparing agent registration",
+          progressPercent: 10
+        });
+      }
       const registrationResult = await this.executeRegistration(
         accountId,
         inboundTopicId,
@@ -32787,6 +32812,16 @@ class HCS10Client extends HCS10BaseClient {
       if (!registrationResult.success) {
         return registrationResult;
       }
+      if (progressCallback) {
+        progressCallback({
+          stage: "submitting",
+          message: "Submitting registration to registry",
+          progressPercent: 30,
+          details: {
+            transactionId: registrationResult.transactionId
+          }
+        });
+      }
       if (registrationResult.transaction) {
         const transaction = Transaction.fromBytes(
           Buffer2.from(registrationResult.transaction, "base64")
@@ -32795,6 +32830,18 @@ class HCS10Client extends HCS10BaseClient {
         await transaction.execute(this.client);
         this.logger.info(`Successfully processed registration transaction`);
       }
+      if (progressCallback) {
+        progressCallback({
+          stage: "confirming",
+          message: "Confirming registration transaction",
+          progressPercent: 60,
+          details: {
+            accountId,
+            inboundTopicId,
+            transactionId: registrationResult.transactionId
+          }
+        });
+      }
       const confirmed = await this.waitForRegistrationConfirmation(
         registrationResult.transactionId,
         network,
@@ -32803,6 +32850,17 @@ class HCS10Client extends HCS10BaseClient {
         delayMs,
         this.logger
       );
+      if (progressCallback) {
+        progressCallback({
+          stage: "completed",
+          message: "Agent registration complete",
+          progressPercent: 100,
+          details: {
+            confirmed,
+            transactionId: registrationResult.transactionId
+          }
+        });
+      }
       return {
         ...registrationResult,
         confirmed
@@ -33285,9 +33343,33 @@ class BrowserHCSClient extends HCS10BaseClient {
       throw new Error(`Failed to create and register agent: ${error.message}`);
     }
   }
-  async registerAgentWithGuardedRegistry(accountId, inboundTopicId, network = this.network, maxAttempts = 60, delayMs = 2e3) {
+  async registerAgentWithGuardedRegistry(accountId, inboundTopicId, network = this.network, progressCallbackOrMaxAttempts, maxAttemptsOrDelayMs, delayMsParam) {
     try {
       this.logger.info("Registering agent with guarded registry");
+      let progressCallback;
+      let maxAttempts = 60;
+      let delayMs = 2e3;
+      if (typeof progressCallbackOrMaxAttempts === "function") {
+        progressCallback = progressCallbackOrMaxAttempts;
+        if (typeof maxAttemptsOrDelayMs === "number") {
+          maxAttempts = maxAttemptsOrDelayMs;
+        }
+        if (typeof delayMsParam === "number") {
+          delayMs = delayMsParam;
+        }
+      } else if (typeof progressCallbackOrMaxAttempts === "number") {
+        maxAttempts = progressCallbackOrMaxAttempts;
+        if (typeof maxAttemptsOrDelayMs === "number") {
+          delayMs = maxAttemptsOrDelayMs;
+        }
+      }
+      if (progressCallback) {
+        progressCallback({
+          stage: "preparing",
+          message: "Preparing agent registration",
+          progressPercent: 10
+        });
+      }
       const registrationResult = await this.executeRegistration(
         accountId,
         inboundTopicId,
@@ -33298,6 +33380,16 @@ class BrowserHCSClient extends HCS10BaseClient {
       if (!registrationResult.success) {
         return registrationResult;
       }
+      if (progressCallback) {
+        progressCallback({
+          stage: "submitting",
+          message: "Submitting registration to registry",
+          progressPercent: 30,
+          details: {
+            transactionId: registrationResult.transactionId
+          }
+        });
+      }
       if (registrationResult.transaction) {
         const transaction = Transaction.fromBytes(
           Buffer2.from(registrationResult.transaction, "base64")
@@ -33316,6 +33408,18 @@ class BrowserHCSClient extends HCS10BaseClient {
         }
         this.logger.info(`Successfully processed registration transaction`);
       }
+      if (progressCallback) {
+        progressCallback({
+          stage: "confirming",
+          message: "Confirming registration transaction",
+          progressPercent: 60,
+          details: {
+            accountId,
+            inboundTopicId,
+            transactionId: registrationResult.transactionId
+          }
+        });
+      }
       const confirmed = await this.waitForRegistrationConfirmation(
         registrationResult.transactionId,
         network,
@@ -33323,6 +33427,17 @@ class BrowserHCSClient extends HCS10BaseClient {
         maxAttempts,
         delayMs
       );
+      if (progressCallback) {
+        progressCallback({
+          stage: "completed",
+          message: "Agent registration complete",
+          progressPercent: 100,
+          details: {
+            confirmed,
+            transactionId: registrationResult.transactionId
+          }
+        });
+      }
       return {
         ...registrationResult,
         confirmed