@hashgraphonline/standards-agent-kit 0.0.37 → 0.2.0

package/dist/es/standards-agent-kit.es2.js

@@ -1,22 +1,37 @@
-import { HCS10Client as HCS10Client$1, Logger, AgentBuilder, AIAgentCapability, InboundTopicType } from "@hashgraphonline/standards-sdk";
-import { encryptMessage } from "./standards-agent-kit.es25.js";
-class HCS10Client {
-  constructor(operatorId, operatorPrivateKey, network, options) {
+import { BaseServiceBuilder } from "hedera-agent-kit";
+import { Logger, HCS10Client as HCS10Client$1, AgentBuilder, AIAgentCapability, InboundTopicType, FeeConfigBuilder } from "@hashgraphonline/standards-sdk";
+import fs from "fs";
+import path from "path";
+import axios from "axios";
+const NOT_INITIALIZED_ERROR = "ConnectionsManager not initialized";
+class HCS10Builder extends BaseServiceBuilder {
+  constructor(hederaKit, stateManager, options) {
+    super(hederaKit);
+    this.stateManager = stateManager;
+    this.useEncryption = options?.useEncryption || false;
+    this.guardedRegistryBaseUrl = options?.registryUrl || "";
+    const network = this.hederaKit.client.network;
+    this.network = network.toString().includes("mainnet") ? "mainnet" : "testnet";
+    const operatorId = this.hederaKit.signer.getAccountId().toString();
+    const operatorPrivateKey = this.hederaKit.signer?.getOperatorPrivateKey() ? this.hederaKit.signer.getOperatorPrivateKey().toStringRaw() : "";
+    this.sdkLogger = new Logger({
+      module: "HCS10Builder",
+      level: options?.logLevel || "info"
+    });
     this.standardClient = new HCS10Client$1({
-      network,
+      network: this.network,
       operatorId,
       operatorPrivateKey,
-      guardedRegistryBaseUrl: options?.registryUrl,
-      logLevel: options?.logLevel
-    });
-    this.guardedRegistryBaseUrl = options?.registryUrl || "";
-    this.useEncryption = options?.useEncryption || false;
-    const shouldSilence = process.env.DISABLE_LOGGING === "true";
-    this.logger = new Logger({
-      level: options?.logLevel || "info",
-      silent: shouldSilence
+      guardedRegistryBaseUrl: this.guardedRegistryBaseUrl,
+      logLevel: options?.logLevel || "info"
     });
+    if (this.stateManager) {
+      this.stateManager.initializeConnectionsManager(this.standardClient);
+    }
   }
+  /**
+   * Get the operator account ID
+   */
   getOperatorId() {
     const operator = this.standardClient.getClient().operatorAccountId;
     if (!operator) {
@@ -24,36 +39,75 @@ class HCS10Client {
     }
     return operator.toString();
   }
+  /**
+   * Get the network type
+   */
   getNetwork() {
-    return this.standardClient.getNetwork();
+    return this.network;
   }
-  async handleConnectionRequest(inboundTopicId, requestingAccountId, connectionRequestId, feeConfig) {
+  /**
+   * Get account and signer information
+   */
+  getAccountAndSigner() {
+    const result = this.standardClient.getAccountAndSigner();
+    return {
+      accountId: result.accountId,
+      signer: result.signer
+    };
+  }
+  /**
+   * Get the inbound topic ID for the current operator
+   */
+  async getInboundTopicId() {
     try {
-      const result = await this.standardClient.handleConnectionRequest(
-        inboundTopicId,
-        requestingAccountId,
-        connectionRequestId,
-        feeConfig
+      const operatorId = this.getOperatorId();
+      this.logger.info(
+        `[HCS10Builder] Retrieving profile for operator ${operatorId} to find inbound topic...`
       );
-      return result;
+      const profileResponse = await this.getAgentProfile(operatorId);
+      if (profileResponse.success && profileResponse.topicInfo?.inboundTopic) {
+        this.logger.info(
+          `[HCS10Builder] Found inbound topic for operator ${operatorId}: ${profileResponse.topicInfo.inboundTopic}`
+        );
+        return profileResponse.topicInfo.inboundTopic;
+      } else {
+        throw new Error(
+          `Could not retrieve inbound topic from profile for ${operatorId}. Profile success: ${profileResponse.success}, Error: ${profileResponse.error}`
+        );
+      }
     } catch (error) {
       this.logger.error(
-        `Error handling connection request #${connectionRequestId} for topic ${inboundTopicId}:`,
+        `[HCS10Builder] Error fetching operator's inbound topic ID (${this.getOperatorId()}):`,
         error
       );
-      throw new Error(
-        `Failed to handle connection request: ${error instanceof Error ? error.message : String(error)}`
-      );
+      const operatorId = this.getOperatorId();
+      let detailedMessage = `Failed to get inbound topic ID for operator ${operatorId}.`;
+      if (error instanceof Error && error.message.includes("does not have a valid HCS-11 memo")) {
+        detailedMessage += ` The account profile may not exist or is invalid. Please ensure this operator account (${operatorId}) is registered as an HCS-10 agent. You might need to register it first (e.g., using the 'register_agent' tool or SDK function).`;
+      } else if (error instanceof Error) {
+        detailedMessage += ` Reason: ${error.message}`;
+      } else {
+        detailedMessage += ` Unexpected error: ${String(error)}`;
+      }
+      throw new Error(detailedMessage);
     }
   }
   /**
-   * Retrieves the profile for a given account ID using the standard SDK.
+   * Get agent profile
    */
   async getAgentProfile(accountId) {
-    return this.standardClient.retrieveProfile(accountId);
+    try {
+      return await this.standardClient.retrieveProfile(accountId);
+    } catch (error) {
+      this.logger.error(
+        `[HCS10Builder] Error retrieving agent profile for account ${accountId}:`,
+        error
+      );
+      throw error;
+    }
   }
   /**
-   * Exposes the standard SDK's submitConnectionRequest method.
+   * Submit connection request
    */
   async submitConnectionRequest(inboundTopicId, memo) {
     return this.standardClient.submitConnectionRequest(
@@ -62,105 +116,54 @@ class HCS10Client {
     );
   }
   /**
-   * Exposes the standard SDK's waitForConnectionConfirmation method.
+   * Handle connection request
    */
-  async waitForConnectionConfirmation(outboundTopicId, connectionRequestId, maxAttempts = 60, delayMs = 2e3) {
-    return this.standardClient.waitForConnectionConfirmation(
-      outboundTopicId,
-      connectionRequestId,
-      maxAttempts,
-      delayMs
-    );
-  }
-  /**
-   * Creates and registers an agent using the standard SDK's HCS10Client.
-   * This handles account creation, key generation, topic setup, and registration.
-   *
-   * When metadata includes fee configuration:
-   * 1. The properties.feeConfig will be passed to the AgentBuilder
-   * 2. The properties.inboundTopicType will be set to FEE_BASED
-   * 3. The SDK's createAndRegisterAgent will apply the fees to the agent's inbound topic
-   *
-   * @param metadata - The agent's metadata, potentially including pfpBuffer, pfpFileName,
-   *                   and fee configuration in properties.feeConfig
-   * @returns The registration result from the standard SDK, containing accountId, keys, topics etc.
-   */
-  async createAndRegisterAgent(metadata) {
-    const builder = new AgentBuilder().setName(metadata.name).setBio(metadata.description || "").setCapabilities(
-      metadata.capabilities ? metadata.capabilities : [AIAgentCapability.TEXT_GENERATION]
-    ).setType(metadata.type || "autonomous").setModel(metadata.model || "agent-model-2024").setNetwork(this.getNetwork()).setInboundTopicType(InboundTopicType.PUBLIC);
-    if (metadata?.feeConfig) {
-      builder.setInboundTopicType(InboundTopicType.FEE_BASED);
-      builder.setFeeConfig(metadata.feeConfig);
-    }
-    if (metadata.pfpBuffer && metadata.pfpFileName) {
-      if (metadata.pfpBuffer.byteLength === 0) {
-        this.logger.warn(
-          "Provided PFP buffer is empty. Skipping profile picture."
-        );
-      } else {
-        this.logger.info(
-          `Setting profile picture: ${metadata.pfpFileName} (${metadata.pfpBuffer.byteLength} bytes)`
-        );
-        builder.setProfilePicture(metadata.pfpBuffer, metadata.pfpFileName);
-      }
-    } else {
-      this.logger.warn(
-        "Profile picture not provided in metadata. Agent creation might fail if required by the underlying SDK builder."
-      );
-    }
-    if (metadata.social) {
-      Object.entries(metadata.social).forEach(([platform, handle]) => {
-        builder.addSocial(platform, handle);
-      });
-    }
-    if (metadata.properties) {
-      Object.entries(metadata.properties).forEach(([key, value]) => {
-        builder.addProperty(key, value);
-      });
-    }
+  async handleConnectionRequest(inboundTopicId, requestingAccountId, connectionRequestId, feeConfig) {
     try {
-      const hasFees = Boolean(metadata?.feeConfig);
-      const result = await this.standardClient.createAndRegisterAgent(builder, {
-        initialBalance: hasFees ? 50 : void 0
-      });
-      if (result?.metadata?.inboundTopicId && result?.metadata?.outboundTopicId) {
-        this.agentChannels = {
-          inboundTopicId: result.metadata.inboundTopicId,
-          outboundTopicId: result.metadata.outboundTopicId
-        };
+      const result = await this.standardClient.handleConnectionRequest(
+        inboundTopicId,
+        requestingAccountId,
+        connectionRequestId,
+        feeConfig
+      );
+      if (result && result.connectionTopicId && typeof result.connectionTopicId === "object" && "toString" in result.connectionTopicId) {
+        result.connectionTopicId = result.connectionTopicId.toString();
       }
       return result;
     } catch (error) {
-      this.logger.error("Error during agent creation/registration:", error);
+      this.logger.error(
+        `Error handling connection request #${connectionRequestId} for topic ${inboundTopicId}:`,
+        error
+      );
       throw new Error(
-        `Failed to create/register agent: ${error instanceof Error ? error.message : String(error)}`
+        `Failed to handle connection request: ${error instanceof Error ? error.message : String(error)}`
       );
     }
   }
   /**
-   * Sends a structured HCS-10 message to the specified topic using the standard SDK client.
-   * Handles potential inscription for large messages.
-   *
-   * @param topicId - The target topic ID (likely a connection topic).
-   * @param operatorId - The operator ID string (e.g., "inboundTopic@accountId").
-   * @param data - The actual message content/data.
-   * @param memo - Optional memo for the message.
-   * @param submitKey - Optional private key for topics requiring specific submit keys.
-   * @returns A confirmation status string from the transaction receipt.
+   * Send message to a topic
    */
-  async sendMessage(topicId, data, memo, submitKey) {
-    if (this.useEncryption) {
-      data = encryptMessage(data);
+  async sendMessage(topicId, data, memo) {
+    if (topicId && typeof topicId === "object" && "toString" in topicId) {
+      topicId = topicId?.toString();
+    }
+    if (!topicId || typeof topicId !== "string") {
+      throw new Error(
+        `Invalid topic ID provided to sendMessage: ${JSON.stringify(topicId)}`
+      );
     }
     try {
       const messageResponse = await this.standardClient.sendMessage(
         topicId,
         data,
         memo,
-        submitKey
+        void 0
       );
-      return messageResponse.topicSequenceNumber?.toNumber();
+      return {
+        sequenceNumber: messageResponse.topicSequenceNumber?.toNumber(),
+        receipt: messageResponse,
+        transactionId: "transactionId" in messageResponse ? messageResponse.transactionId?.toString() : void 0
+      };
     } catch (error) {
       this.logger.error(`Error sending message to topic ${topicId}:`, error);
       throw new Error(
@@ -169,12 +172,17 @@ class HCS10Client {
     }
   }
   /**
-   * Retrieves messages from a topic using the standard SDK client.
-   *
-   * @param topicId - The topic ID to get messages from.
-   * @returns Messages from the topic, mapped to the expected format.
+   * Get messages from a topic
    */
   async getMessages(topicId) {
+    if (topicId && typeof topicId === "object" && "toString" in topicId) {
+      topicId = topicId?.toString();
+    }
+    if (!topicId || typeof topicId !== "string") {
+      throw new Error(
+        `Invalid topic ID provided to getMessages: ${JSON.stringify(topicId)}`
+      );
+    }
     try {
       const result = await this.standardClient.getMessages(topicId);
       const mappedMessages = result.messages.map((sdkMessage) => {
@@ -182,8 +190,9 @@ class HCS10Client {
         return {
           ...sdkMessage,
           timestamp,
-          data: sdkMessage.data,
-          sequence_number: sdkMessage.sequence_number
+          data: sdkMessage.data || "",
+          sequence_number: sdkMessage.sequence_number,
+          p: "hcs-10"
         };
       });
       mappedMessages.sort(
@@ -195,13 +204,24 @@ class HCS10Client {
       return { messages: [] };
     }
   }
+  /**
+   * Get message stream from a topic
+   */
   async getMessageStream(topicId) {
+    if (topicId && typeof topicId === "object" && "toString" in topicId) {
+      topicId = topicId?.toString();
+    }
+    if (!topicId || typeof topicId !== "string") {
+      throw new Error(
+        `Invalid topic ID provided to getMessageStream: ${JSON.stringify(
+          topicId
+        )}`
+      );
+    }
     return this.standardClient.getMessageStream(topicId);
   }
   /**
-   * Retrieves content from an inscribed message using the standard SDK client.
-   * @param inscriptionIdOrData - The inscription ID (hcs://...) or potentially raw data string.
-   * @returns The resolved message content.
+   * Get message content
    */
   async getMessageContent(inscriptionIdOrData) {
     try {
@@ -220,112 +240,1285 @@ class HCS10Client {
     }
   }
   /**
-   * 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.
+   * Get the standard client instance (for compatibility)
    */
-  async getInboundTopicId() {
+  getStandardClient() {
+    return this.standardClient;
+  }
+  /**
+   * Load profile picture from URL or file path
+   */
+  async loadProfilePicture(profilePicture) {
     try {
-      const operatorId = this.getOperatorId();
-      this.logger.info(
-        `[HCS10Client] Retrieving profile for operator ${operatorId} to find inbound topic...`
-      );
-      const profileResponse = await this.getAgentProfile(operatorId);
-      if (profileResponse.success && profileResponse.topicInfo?.inboundTopic) {
+      if (!profilePicture) {
+        return null;
+      }
+      if (typeof profilePicture === "string") {
+        const isUrl = profilePicture.startsWith("http://") || profilePicture.startsWith("https://");
+        if (isUrl) {
+          this.logger.info(
+            `Loading profile picture from URL: ${profilePicture}`
+          );
+          const response = await axios.get(profilePicture, {
+            responseType: "arraybuffer"
+          });
+          const buffer = Buffer.from(response.data);
+          const urlPathname = new URL(profilePicture).pathname;
+          const filename = path.basename(urlPathname) || "profile.png";
+          return { buffer, filename };
+        } else {
+          if (!fs.existsSync(profilePicture)) {
+            this.logger.warn(
+              `Profile picture file not found: ${profilePicture}`
+            );
+            return null;
+          }
+          this.logger.info(
+            `Loading profile picture from file: ${profilePicture}`
+          );
+          const buffer = fs.readFileSync(profilePicture);
+          const filename = path.basename(profilePicture);
+          return { buffer, filename };
+        }
+      } else if (profilePicture.url) {
         this.logger.info(
-          `[HCS10Client] Found inbound topic for operator ${operatorId}: ${profileResponse.topicInfo.inboundTopic}`
+          `Loading profile picture from URL: ${profilePicture.url}`
+        );
+        const response = await axios.get(profilePicture.url, {
+          responseType: "arraybuffer"
+        });
+        const buffer = Buffer.from(response.data);
+        const filename = profilePicture.filename || "profile.png";
+        return { buffer, filename };
+      } else if (profilePicture.path) {
+        if (!fs.existsSync(profilePicture.path)) {
+          this.logger.warn(
+            `Profile picture file not found: ${profilePicture.path}`
+          );
+          return null;
+        }
+        this.logger.info(
+          `Loading profile picture from file: ${profilePicture.path}`
+        );
+        const buffer = fs.readFileSync(profilePicture.path);
+        const filename = profilePicture.filename || path.basename(profilePicture.path);
+        return { buffer, filename };
+      }
+      return null;
+    } catch (error) {
+      this.logger.error("Failed to load profile picture:", error);
+      return null;
+    }
+  }
+  /**
+   * Create and register an agent
+   */
+  async createAndRegisterAgent(data) {
+    const builder = new AgentBuilder().setName(data.name).setBio(data.bio || "").setCapabilities(
+      data.capabilities || [AIAgentCapability.TEXT_GENERATION]
+    ).setType(data.type || "autonomous").setModel(data.model || "agent-model-2024").setNetwork(this.getNetwork()).setInboundTopicType(InboundTopicType.PUBLIC);
+    if (data.alias) {
+      builder.setAlias(data.alias);
+    }
+    if (data.creator) {
+      builder.setCreator(data.creator);
+    }
+    if (data?.feeConfig) {
+      builder.setInboundTopicType(InboundTopicType.FEE_BASED);
+      builder.setFeeConfig(data.feeConfig);
+    }
+    if (data.existingProfilePictureTopicId) {
+      builder.setExistingProfilePicture(data.existingProfilePictureTopicId);
+    } else if (data.pfpBuffer && data.pfpFileName) {
+      if (data.pfpBuffer.byteLength === 0) {
+        this.logger.warn(
+          "Provided PFP buffer is empty. Skipping profile picture."
         );
-        return profileResponse.topicInfo.inboundTopic;
       } else {
+        this.logger.info(
+          `Setting profile picture: ${data.pfpFileName} (${data.pfpBuffer.byteLength} bytes)`
+        );
+        builder.setProfilePicture(data.pfpBuffer, data.pfpFileName);
+      }
+    } else {
+      this.logger.warn(
+        "Profile picture not provided. Agent creation might fail if required by the underlying SDK builder."
+      );
+    }
+    if (data.socials) {
+      Object.entries(data.socials).forEach(([platform, handle]) => {
+        builder.addSocial(platform, handle);
+      });
+    }
+    if (data.properties) {
+      Object.entries(data.properties).forEach(([key, value]) => {
+        builder.addProperty(key, value);
+      });
+    }
+    try {
+      const hasFees = Boolean(data?.feeConfig);
+      const result = await this.standardClient.createAndRegisterAgent(builder, {
+        initialBalance: hasFees ? 50 : 10
+      });
+      return result;
+    } catch (error) {
+      this.logger.error("Error during agent creation/registration:", error);
+      throw new Error(
+        `Failed to create/register agent: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * Register a new HCS-10 agent
+   * Note: This performs multiple transactions and requires directExecution mode
+   */
+  async registerAgent(params) {
+    this.clearNotes();
+    if (this.hederaKit.operationalMode === "returnBytes") {
+      throw new Error(
+        "Agent registration requires multiple transactions and cannot be performed in returnBytes mode. Please use autonomous mode."
+      );
+    }
+    try {
+      let profilePictureData = null;
+      if (params.profilePicture) {
+        profilePictureData = await this.loadProfilePicture(
+          params.profilePicture
+        );
+      }
+      const registrationData = {
+        name: params.name,
+        ...params.bio !== void 0 && { bio: params.bio },
+        ...params.alias !== void 0 && { alias: params.alias },
+        ...params.type !== void 0 && { type: params.type },
+        ...params.model !== void 0 && { model: params.model },
+        ...params.capabilities !== void 0 && {
+          capabilities: params.capabilities
+        },
+        ...params.creator !== void 0 && { creator: params.creator },
+        ...params.socials !== void 0 && { socials: params.socials },
+        ...params.properties !== void 0 && {
+          properties: params.properties
+        },
+        ...params.existingProfilePictureTopicId !== void 0 && {
+          existingProfilePictureTopicId: params.existingProfilePictureTopicId
+        },
+        ...profilePictureData?.buffer !== void 0 && {
+          pfpBuffer: profilePictureData.buffer
+        },
+        ...profilePictureData?.filename !== void 0 && {
+          pfpFileName: profilePictureData.filename
+        }
+      };
+      if (params.hbarFee && params.hbarFee > 0) {
+        const feeConfigBuilder = new FeeConfigBuilder({
+          network: this.network,
+          logger: this.sdkLogger
+        });
+        const { accountId: collectorAccountId } = this.getAccountAndSigner();
+        if (!collectorAccountId) {
+          throw new Error("Could not determine account ID for fee collection.");
+        }
+        this.addNote(
+          `Setting the operator account (${collectorAccountId}) as the fee collector since no specific collector was provided.`
+        );
+        const effectiveExemptIds = params.exemptAccountIds?.filter(
+          (id) => id !== collectorAccountId && id.startsWith("0.0")
+        ) || [];
+        registrationData.feeConfig = feeConfigBuilder.addHbarFee(
+          params.hbarFee,
+          collectorAccountId,
+          effectiveExemptIds
+        );
+      }
+      const result = await this.createAndRegisterAgent(registrationData);
+      this.executeResult = {
+        success: true,
+        transactionId: result.transactionId,
+        receipt: void 0,
+        scheduleId: void 0,
+        rawResult: {
+          ...result,
+          name: params.name,
+          accountId: result?.metadata?.accountId || result.state?.agentMetadata?.accountId
+        }
+      };
+    } catch (error) {
+      this.logger.error("Failed to register agent:", error);
+      throw error;
+    }
+    return this;
+  }
+  /**
+   * Initiate a connection to another agent
+   */
+  async initiateConnection(params) {
+    this.clearNotes();
+    try {
+      const targetProfile = await this.getAgentProfile(params.targetAccountId);
+      if (!targetProfile.success || !targetProfile.topicInfo?.inboundTopic) {
         throw new Error(
-          `Could not retrieve inbound topic from profile for ${operatorId}. Profile success: ${profileResponse.success}, Error: ${profileResponse.error}`
+          `Could not retrieve inbound topic for target account ${params.targetAccountId}`
         );
       }
+      const targetInboundTopicId = targetProfile.topicInfo.inboundTopic;
+      let memo;
+      if (params.memo !== void 0) {
+        memo = params.memo;
+      } else {
+        memo = params.disableMonitor ? "false" : "true";
+        this.addNote(
+          `No custom memo was provided. Using default memo '${memo}' based on monitoring preference.`
+        );
+      }
+      if (!params.disableMonitor) {
+        this.addNote(
+          `Monitoring will be enabled for this connection request as disableMonitor was not specified.`
+        );
+      }
+      const result = await this.submitConnectionRequest(
+        targetInboundTopicId,
+        memo
+      );
+      this.executeResult = {
+        success: true,
+        transactionId: "transactionId" in result ? result.transactionId?.toString() : void 0,
+        receipt: result,
+        scheduleId: void 0,
+        rawResult: {
+          targetAccountId: params.targetAccountId,
+          targetInboundTopicId,
+          connectionRequestSent: true,
+          monitoringEnabled: !params.disableMonitor,
+          ...result
+        }
+      };
     } catch (error) {
-      this.logger.error(
-        `[HCS10Client] Error fetching operator's inbound topic ID (${this.getOperatorId()}):`,
-        error
+      this.logger.error("Failed to initiate connection:", error);
+      throw error;
+    }
+    return this;
+  }
+  /**
+   * Accept a connection request
+   * Note: This performs multiple transactions and requires directExecution mode
+   */
+  async acceptConnection(params) {
+    this.clearNotes();
+    if (this.hederaKit.operationalMode === "returnBytes") {
+      throw new Error(
+        "Accepting connections requires multiple transactions and cannot be performed in returnBytes mode. Please use autonomous mode."
       );
-      const operatorId = this.getOperatorId();
-      let detailedMessage = `Failed to get inbound topic ID for operator ${operatorId}.`;
-      if (error instanceof Error && error.message.includes("does not have a valid HCS-11 memo")) {
-        detailedMessage += ` The account profile may not exist or is invalid. Please ensure this operator account (${operatorId}) is registered as an HCS-10 agent. You might need to register it first (e.g., using the 'register_agent' tool or SDK function).`;
-      } else if (error instanceof Error) {
-        detailedMessage += ` Reason: ${error.message}`;
+    }
+    try {
+      const currentAgent = this.stateManager?.getCurrentAgent();
+      if (!currentAgent) {
+        throw new Error(
+          "Cannot accept connection request. No agent is currently active. Please register or select an agent first."
+        );
+      }
+      const connectionsManager = this.stateManager?.getConnectionsManager();
+      if (!connectionsManager) {
+        throw new Error(NOT_INITIALIZED_ERROR);
+      }
+      await connectionsManager.fetchConnectionData(currentAgent.accountId);
+      const allRequests = [
+        ...connectionsManager.getPendingRequests(),
+        ...connectionsManager.getConnectionsNeedingConfirmation()
+      ];
+      const request = allRequests.find(
+        (r) => r.uniqueRequestKey === params.requestKey || r.connectionRequestId?.toString() === params.requestKey || r.inboundRequestId?.toString() === params.requestKey
+      );
+      if (!request) {
+        throw new Error(
+          `Request with key ${params.requestKey} not found or no longer pending.`
+        );
+      }
+      if (!request.needsConfirmation || !request.inboundRequestId) {
+        throw new Error(
+          `Request with key ${params.requestKey} is not an inbound request that can be accepted.`
+        );
+      }
+      const targetAccountId = request.targetAccountId;
+      const inboundRequestId = request.inboundRequestId;
+      let feeConfig;
+      if (params.hbarFee && params.hbarFee > 0) {
+        const feeConfigBuilder = new FeeConfigBuilder({
+          network: this.network,
+          logger: this.sdkLogger
+        });
+        const { accountId: collectorAccountId } = this.getAccountAndSigner();
+        if (!collectorAccountId) {
+          throw new Error("Could not determine account ID for fee collection.");
+        }
+        this.addNote(
+          `Setting the operator account (${collectorAccountId}) as the fee collector since no specific collector was provided.`
+        );
+        const effectiveExemptIds = params.exemptAccountIds?.filter(
+          (id) => id !== collectorAccountId && id.startsWith("0.0")
+        ) || [];
+        feeConfig = feeConfigBuilder.addHbarFee(
+          params.hbarFee,
+          collectorAccountId,
+          effectiveExemptIds
+        );
+      }
+      const inboundTopicId = await this.getInboundTopicId();
+      const confirmationResult = await this.handleConnectionRequest(
+        inboundTopicId,
+        targetAccountId,
+        inboundRequestId,
+        feeConfig
+      );
+      let connectionTopicId = confirmationResult?.connectionTopicId;
+      if (connectionTopicId && typeof connectionTopicId === "object" && "toString" in connectionTopicId) {
+        connectionTopicId = connectionTopicId?.toString();
+      }
+      if (!connectionTopicId || typeof connectionTopicId !== "string") {
+        throw new Error(
+          `Failed to create connection topic. Got: ${JSON.stringify(
+            connectionTopicId
+          )}`
+        );
+      }
+      if (this.stateManager) {
+        const targetAgentName = request.targetAgentName || `Agent ${targetAccountId}`;
+        if (!request.targetAgentName) {
+          this.addNote(
+            `No agent name was provided in the connection request, using default name 'Agent ${targetAccountId}'.`
+          );
+        }
+        let targetInboundTopicId = request.targetInboundTopicId || "";
+        if (!targetInboundTopicId) {
+          try {
+            const targetProfile = await this.getAgentProfile(targetAccountId);
+            if (targetProfile.success && targetProfile.topicInfo?.inboundTopic) {
+              targetInboundTopicId = targetProfile.topicInfo.inboundTopic;
+            }
+          } catch (profileError) {
+            this.logger.warn(
+              `Could not fetch profile for ${targetAccountId}:`,
+              profileError
+            );
+          }
+        }
+        const newConnection = {
+          connectionId: `conn-${Date.now()}`,
+          targetAccountId,
+          targetAgentName,
+          targetInboundTopicId,
+          connectionTopicId,
+          status: "established",
+          created: /* @__PURE__ */ new Date()
+        };
+        this.stateManager.addActiveConnection(newConnection);
+        connectionsManager.markConnectionRequestProcessed(
+          request.targetInboundTopicId || "",
+          inboundRequestId
+        );
+      }
+      this.executeResult = {
+        success: true,
+        transactionId: void 0,
+        receipt: void 0,
+        scheduleId: void 0,
+        rawResult: {
+          targetAccountId,
+          connectionTopicId,
+          feeConfigured: !!params.hbarFee,
+          hbarFee: params.hbarFee || 0,
+          confirmationResult
+        }
+      };
+    } catch (error) {
+      this.logger.error("Failed to accept connection:", error);
+      throw error;
+    }
+    return this;
+  }
+  /**
+   * Send a message using HCS (for operations that need direct topic access)
+   */
+  async sendHCS10Message(params) {
+    this.clearNotes();
+    try {
+      const result = await this.sendMessage(params.topicId, params.message);
+      this.executeResult = {
+        success: true,
+        transactionId: result.transactionId,
+        receipt: result.receipt,
+        scheduleId: void 0,
+        rawResult: result
+      };
+      this.addNote(`Message sent to topic ${params.topicId}.`);
+    } catch (error) {
+      this.logger.error("Failed to send message:", error);
+      throw error;
+    }
+    return this;
+  }
+  /**
+   * Send a message to a connected account with optional response monitoring
+   */
+  async sendMessageToConnection(params) {
+    this.clearNotes();
+    if (!this.stateManager) {
+      throw new Error(
+        "StateManager is required to send messages to connections"
+      );
+    }
+    try {
+      const currentAgent = this.stateManager.getCurrentAgent();
+      if (!currentAgent) {
+        throw new Error(
+          "Cannot send message. No agent is currently active. Please register or select an agent first."
+        );
+      }
+      let connection;
+      if (params.targetIdentifier.includes("@")) {
+        const parts = params.targetIdentifier.split("@");
+        if (parts.length === 2) {
+          const accountId = parts[1];
+          connection = this.stateManager.getConnectionByIdentifier(accountId);
+          if (!connection) {
+            this.addNote(
+              `Could not find connection using request key '${params.targetIdentifier}', extracted account ID '${accountId}'.`
+            );
+          }
+        }
+      }
+      if (!connection) {
+        connection = this.stateManager.getConnectionByIdentifier(
+          params.targetIdentifier
+        );
+      }
+      if (!connection) {
+        const connections = this.stateManager.listConnections();
+        const availableIds = connections.map(
+          (c) => `${c.targetAccountId} (${c.connectionTopicId})`
+        );
+        throw new Error(
+          `Connection not found for identifier: ${params.targetIdentifier}. Available connections: ${availableIds.join(", ") || "none"}. Use 'list_connections' to see details.`
+        );
+      }
+      let connectionTopicId = connection.connectionTopicId;
+      if (connectionTopicId && typeof connectionTopicId === "object" && "toString" in connectionTopicId) {
+        connectionTopicId = connectionTopicId?.toString();
+      }
+      if (!connectionTopicId || typeof connectionTopicId !== "string") {
+        throw new Error(
+          `Invalid connection topic ID for ${connection.targetAccountId}: ${JSON.stringify(
+            connectionTopicId
+          )} (type: ${typeof connectionTopicId})`
+        );
+      }
+      const targetAgentName = connection.targetAgentName;
+      const operatorId = `${currentAgent.inboundTopicId}@${currentAgent.accountId}`;
+      const messageResult = await this.sendMessage(
+        connectionTopicId,
+        params.message,
+        `Agent message from ${currentAgent.name}`
+      );
+      if (!messageResult.sequenceNumber) {
+        throw new Error("Failed to send message");
+      }
+      let reply = null;
+      if (!params.disableMonitoring) {
+        reply = await this.monitorResponses(
+          connectionTopicId,
+          operatorId,
+          messageResult.sequenceNumber
+        );
       } else {
-        detailedMessage += ` Unexpected error: ${String(error)}`;
+        this.addNote(
+          `Message sent successfully. Response monitoring was disabled.`
+        );
       }
-      throw new Error(detailedMessage);
+      this.executeResult = {
+        success: true,
+        transactionId: messageResult.transactionId,
+        receipt: messageResult.receipt,
+        scheduleId: void 0,
+        rawResult: {
+          targetAgentName,
+          targetAccountId: connection.targetAccountId,
+          connectionTopicId,
+          sequenceNumber: messageResult.sequenceNumber,
+          reply,
+          monitoringEnabled: !params.disableMonitoring,
+          message: params.message,
+          messageResult
+        }
+      };
+    } catch (error) {
+      this.logger.error("Failed to send message to connection:", error);
+      throw error;
     }
+    return this;
   }
   /**
-   * Retrieves the configured operator account ID and private key.
-   * Required by tools needing to identify the current agent instance.
+   * Monitor responses on a topic after sending a message
    */
-  getAccountAndSigner() {
-    const result = this.standardClient.getAccountAndSigner();
-    return {
-      accountId: result.accountId,
-      signer: result.signer
+  async monitorResponses(topicId, operatorId, sequenceNumber) {
+    const maxAttempts = 30;
+    let attempts = 0;
+    while (attempts < maxAttempts) {
+      try {
+        const messages = await this.getMessageStream(topicId);
+        for (const message of messages.messages) {
+          if (message.sequence_number < sequenceNumber || message.operator_id === operatorId) {
+            continue;
+          }
+          const content = await this.getMessageContent(message.data || "");
+          return content;
+        }
+      } catch (error) {
+        this.logger.error(`Error monitoring responses: ${error}`);
+      }
+      await new Promise((resolve) => setTimeout(resolve, 4e3));
+      attempts++;
+    }
+    return null;
+  }
+  /**
+   * Start passive monitoring for incoming connection requests
+   * This method monitors continuously in the background
+   */
+  async startPassiveConnectionMonitoring() {
+    this.clearNotes();
+    if (!this.stateManager) {
+      throw new Error("StateManager is required for passive monitoring");
+    }
+    const inboundTopicId = await this.getInboundTopicId();
+    this.logger.info(
+      `Starting passive connection monitoring on topic ${inboundTopicId}...`
+    );
+    this.executeResult = {
+      success: true,
+      transactionId: void 0,
+      receipt: void 0,
+      scheduleId: void 0,
+      rawResult: {
+        inboundTopicId,
+        message: `Started monitoring inbound topic ${inboundTopicId} for connection requests in the background.`
+      }
     };
+    return this;
   }
   /**
-   * Retrieves the outbound topic ID for the current operator.
-   * Fetches the operator's profile if necessary.
-   * @returns The outbound topic ID string.
-   * @throws If the outbound topic cannot be determined.
+   * Monitor for incoming connection requests
    */
-  async getOutboundTopicId() {
-    const operatorId = this.getOperatorId();
-    const profile = await this.getAgentProfile(operatorId);
-    if (profile.success && profile.topicInfo?.outboundTopic) {
-      return profile.topicInfo.outboundTopic;
-    } else {
+  async monitorConnections(params) {
+    this.clearNotes();
+    const {
+      acceptAll = false,
+      targetAccountId,
+      monitorDurationSeconds = 120,
+      hbarFees = [],
+      tokenFees = [],
+      exemptAccountIds = [],
+      defaultCollectorAccount
+    } = params;
+    if (!this.stateManager) {
+      throw new Error("StateManager is required for connection monitoring");
+    }
+    const currentAgent = this.stateManager.getCurrentAgent();
+    if (!currentAgent) {
       throw new Error(
-        `Could not retrieve outbound topic from profile for ${operatorId}. Profile success: ${profile.success}, Error: ${profile.error}`
+        "Cannot monitor for connections. No agent is currently active."
       );
     }
+    const inboundTopicId = await this.getInboundTopicId();
+    const endTime = Date.now() + monitorDurationSeconds * 1e3;
+    const pollIntervalMs = 3e3;
+    let connectionRequestsFound = 0;
+    let acceptedConnections = 0;
+    const processedRequestIds = /* @__PURE__ */ new Set();
+    while (Date.now() < endTime) {
+      try {
+        const messagesResult = await this.getMessages(inboundTopicId);
+        const connectionRequests = messagesResult.messages.filter(
+          (msg) => msg.op === "connection_request" && typeof msg.sequence_number === "number"
+        );
+        for (const request of connectionRequests) {
+          const connectionRequestId = request.sequence_number;
+          if (!connectionRequestId || processedRequestIds.has(connectionRequestId)) {
+            continue;
+          }
+          const requestingAccountId = request.operator_id?.split("@")[1];
+          if (!requestingAccountId) {
+            continue;
+          }
+          connectionRequestsFound++;
+          if (targetAccountId && requestingAccountId !== targetAccountId) {
+            this.logger.info(
+              `Skipping request from ${requestingAccountId} (not target account)`
+            );
+            continue;
+          }
+          if (acceptAll || targetAccountId === requestingAccountId) {
+            this.logger.info(
+              `Accepting connection request from ${requestingAccountId}`
+            );
+            let feeConfig;
+            if (hbarFees.length > 0 || tokenFees.length > 0) {
+              const builder = new FeeConfigBuilder({
+                network: this.network,
+                logger: this.sdkLogger
+              });
+              for (const fee of hbarFees) {
+                const collectorAccount = fee.collectorAccount || defaultCollectorAccount || this.getOperatorId();
+                builder.addHbarFee(
+                  fee.amount,
+                  collectorAccount,
+                  exemptAccountIds
+                );
+              }
+              for (const fee of tokenFees) {
+                const collectorAccount = fee.collectorAccount || defaultCollectorAccount || this.getOperatorId();
+                builder.addTokenFee(
+                  fee.amount,
+                  fee.tokenId,
+                  collectorAccount,
+                  void 0,
+                  exemptAccountIds
+                );
+              }
+              feeConfig = builder;
+            }
+            await this.handleConnectionRequest(
+              inboundTopicId,
+              requestingAccountId,
+              connectionRequestId,
+              feeConfig
+            );
+            processedRequestIds.add(connectionRequestId);
+            acceptedConnections++;
+          }
+        }
+      } catch (error) {
+        this.logger.error("Error during connection monitoring:", error);
+      }
+      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+    this.executeResult = {
+      success: true,
+      transactionId: void 0,
+      receipt: void 0,
+      scheduleId: void 0,
+      rawResult: {
+        connectionRequestsFound,
+        acceptedConnections,
+        monitorDurationSeconds,
+        processedRequestIds: Array.from(processedRequestIds)
+      }
+    };
+    this.addNote(
+      `Monitoring completed. Found ${connectionRequestsFound} requests, accepted ${acceptedConnections}.`
+    );
+    return this;
   }
-  setClient(accountId, privateKey) {
-    this.standardClient = new HCS10Client$1({
-      network: this.getNetwork(),
-      operatorId: accountId,
-      operatorPrivateKey: privateKey,
-      guardedRegistryBaseUrl: this.guardedRegistryBaseUrl
-    });
-    return this.standardClient;
+  /**
+   * Manage connection requests (list, view, or reject)
+   */
+  async manageConnectionRequests(params) {
+    this.clearNotes();
+    if (!this.stateManager) {
+      throw new Error(
+        "StateManager is required for managing connection requests"
+      );
+    }
+    const currentAgent = this.stateManager.getCurrentAgent();
+    if (!currentAgent) {
+      throw new Error(
+        "Cannot manage connection requests. No agent is currently active."
+      );
+    }
+    const connectionsManager = this.stateManager.getConnectionsManager();
+    if (!connectionsManager) {
+      throw new Error(NOT_INITIALIZED_ERROR);
+    }
+    try {
+      const { accountId } = this.getAccountAndSigner();
+      await connectionsManager.fetchConnectionData(accountId);
+      const pendingRequests = connectionsManager.getPendingRequests();
+      const needsConfirmation = connectionsManager.getConnectionsNeedingConfirmation();
+      const allRequests = [...pendingRequests, ...needsConfirmation];
+      switch (params.action) {
+        case "list":
+          this.executeResult = {
+            success: true,
+            transactionId: void 0,
+            receipt: void 0,
+            scheduleId: void 0,
+            rawResult: {
+              requests: allRequests.map((request, index) => ({
+                index: index + 1,
+                type: request.needsConfirmation ? "incoming" : "outgoing",
+                requestKey: request.uniqueRequestKey || `${request.connectionRequestId || request.inboundRequestId || "unknown"}`,
+                targetAccountId: request.targetAccountId,
+                targetAgentName: request.targetAgentName || `Agent ${request.targetAccountId}`,
+                created: request.created.toISOString(),
+                memo: request.memo,
+                bio: request.profileInfo?.bio
+              }))
+            }
+          };
+          break;
+        case "view": {
+          if (!params.requestKey) {
+            throw new Error("Request key is required for viewing a request");
+          }
+          const viewRequest = allRequests.find(
+            (r) => r.uniqueRequestKey === params.requestKey || r.connectionRequestId?.toString() === params.requestKey || r.inboundRequestId?.toString() === params.requestKey
+          );
+          if (!viewRequest) {
+            throw new Error(`Request with key ${params.requestKey} not found`);
+          }
+          this.executeResult = {
+            success: true,
+            transactionId: void 0,
+            receipt: void 0,
+            scheduleId: void 0,
+            rawResult: {
+              request: {
+                type: viewRequest.needsConfirmation ? "incoming" : "outgoing",
+                requestKey: viewRequest.uniqueRequestKey || `${viewRequest.connectionRequestId || viewRequest.inboundRequestId || "unknown"}`,
+                targetAccountId: viewRequest.targetAccountId,
+                targetAgentName: viewRequest.targetAgentName || `Agent ${viewRequest.targetAccountId}`,
+                created: viewRequest.created.toISOString(),
+                memo: viewRequest.memo,
+                profileInfo: viewRequest.profileInfo
+              }
+            }
+          };
+          break;
+        }
+        case "reject": {
+          if (!params.requestKey) {
+            throw new Error("Request key is required for rejecting a request");
+          }
+          const rejectRequest = allRequests.find(
+            (r) => r.uniqueRequestKey === params.requestKey || r.connectionRequestId?.toString() === params.requestKey || r.inboundRequestId?.toString() === params.requestKey
+          );
+          if (!rejectRequest) {
+            throw new Error(`Request with key ${params.requestKey} not found`);
+          }
+          if (rejectRequest.inboundRequestId) {
+            connectionsManager.markConnectionRequestProcessed(
+              rejectRequest.targetInboundTopicId || "",
+              rejectRequest.inboundRequestId
+            );
+          } else if (rejectRequest.connectionRequestId) {
+            connectionsManager.markConnectionRequestProcessed(
+              rejectRequest.originTopicId || "",
+              rejectRequest.connectionRequestId
+            );
+          }
+          this.executeResult = {
+            success: true,
+            transactionId: void 0,
+            receipt: void 0,
+            scheduleId: void 0,
+            rawResult: {
+              rejectedRequest: {
+                requestKey: params.requestKey,
+                targetAccountId: rejectRequest.targetAccountId,
+                targetAgentName: rejectRequest.targetAgentName || `Agent ${rejectRequest.targetAccountId}`
+              }
+            }
+          };
+          break;
+        }
+      }
+    } catch (error) {
+      this.logger.error("Failed to manage connection requests:", error);
+      throw error;
+    }
+    return this;
   }
   /**
-   * Validates that the operator account exists and has proper access for agent operations
+   * List unapproved connection requests
    */
-  async validateOperator(options) {
+  async listUnapprovedConnectionRequests() {
+    this.clearNotes();
+    if (!this.stateManager) {
+      throw new Error(
+        "StateManager is required for listing connection requests"
+      );
+    }
+    const currentAgent = this.stateManager.getCurrentAgent();
+    if (!currentAgent) {
+      throw new Error(
+        "Cannot list connection requests. No agent is currently active."
+      );
+    }
     try {
-      this.setClient(options.accountId, options.privateKey);
-      const operatorId = this.getOperatorId();
-      return {
-        isValid: true,
-        operator: { accountId: operatorId }
+      const inboundTopicId = await this.getInboundTopicId();
+      const messages = await this.getMessages(inboundTopicId);
+      const unapprovedRequests = messages.messages.filter((msg) => msg.op === "connection_request").map((msg) => ({
+        requestId: msg.sequence_number,
+        fromAccountId: msg.operator_id?.split("@")[1] || "unknown",
+        timestamp: msg.timestamp || new Date(msg?.created || "").getTime(),
+        memo: msg.m || "",
+        data: msg.data
+      })).filter((req) => req.fromAccountId !== "unknown");
+      this.executeResult = {
+        success: true,
+        transactionId: void 0,
+        receipt: void 0,
+        scheduleId: void 0,
+        rawResult: {
+          requests: unapprovedRequests,
+          count: unapprovedRequests.length
+        }
       };
+      if (unapprovedRequests.length === 0) {
+        this.addNote("No unapproved connection requests found.");
+      } else {
+        this.addNote(
+          `Found ${unapprovedRequests.length} unapproved connection request(s).`
+        );
+      }
     } catch (error) {
-      this.logger.error(`Validation error: ${error}`);
-      return {
-        isValid: false,
-        error: error instanceof Error ? error.message : String(error)
+      this.logger.error(
+        "Failed to list unapproved connection requests:",
+        error
+      );
+      throw error;
+    }
+    return this;
+  }
+  /**
+   * List connections with enhanced details
+   */
+  async listConnections(params = {}) {
+    this.clearNotes();
+    if (!this.stateManager) {
+      throw new Error("StateManager is required to list connections");
+    }
+    const includeDetails = params.includeDetails ?? true;
+    const showPending = params.showPending ?? true;
+    try {
+      const connections = await this.getEnhancedConnections();
+      if (connections.length === 0) {
+        this.executeResult = {
+          success: true,
+          rawResult: {
+            connections: [],
+            message: "There are currently no active connections."
+          }
+        };
+        return this;
+      }
+      const activeConnections = connections.filter(
+        (c) => c.status === "established"
+      );
+      const pendingConnections = connections.filter(
+        (c) => c.isPending
+      );
+      const needsConfirmation = connections.filter(
+        (c) => c.needsConfirmation
+      );
+      let output = "";
+      if (activeConnections.length > 0) {
+        output += `🟢 Active Connections (${activeConnections.length}):
+`;
+        activeConnections.forEach((conn, index) => {
+          output += this.formatConnection(conn, index, includeDetails);
+        });
+        output += "\n";
+      }
+      if (showPending && needsConfirmation.length > 0) {
+        output += `🟠 Connections Needing Confirmation (${needsConfirmation.length}):
+`;
+        needsConfirmation.forEach((conn, index) => {
+          output += this.formatConnection(conn, index, includeDetails);
+        });
+        output += "\n";
+      }
+      if (showPending && pendingConnections.length > 0) {
+        output += `⚪ Pending Connection Requests (${pendingConnections.length}):
+`;
+        pendingConnections.forEach((conn, index) => {
+          output += this.formatConnection(conn, index, includeDetails);
+        });
+      }
+      this.executeResult = {
+        success: true,
+        rawResult: {
+          connections,
+          formattedOutput: output.trim(),
+          activeCount: activeConnections.length,
+          pendingCount: pendingConnections.length,
+          needsConfirmationCount: needsConfirmation.length
+        }
+      };
+    } catch (error) {
+      this.logger.error("Failed to list connections:", error);
+      this.executeResult = {
+        success: false,
+        error: `Failed to list connections: ${error instanceof Error ? error.message : String(error)}`
+      };
+    }
+    return this;
+  }
+  formatConnection(conn, index, includeDetails) {
+    const connection = conn;
+    let output = `${index + 1}. ${connection.profileInfo?.display_name || connection.targetAgentName || "Unknown Agent"} (${connection.targetAccountId})
+`;
+    const displayTopicId = connection.isPending ? "(Pending Request)" : connection.connectionTopicId;
+    output += `   Topic: ${displayTopicId}
+`;
+    const statusText = connection.status || "unknown";
+    output += `   Status: ${statusText}
+`;
+    if (includeDetails) {
+      if (connection.profileInfo?.bio) {
+        output += `   Bio: ${connection.profileInfo.bio.substring(0, 100)}${connection.profileInfo.bio.length > 100 ? "..." : ""}
+`;
+      }
+      if (connection.created) {
+        const createdLabel = connection.isPending ? "Request sent" : "Connection established";
+        output += `   ${createdLabel}: ${connection.created.toLocaleString()}
+`;
+      }
+      if (connection.lastActivity) {
+        output += `   Last activity: ${connection.lastActivity.toLocaleString()}
+`;
+      }
+    }
+    return output;
+  }
+  async getEnhancedConnections() {
+    try {
+      const { accountId } = this.getAccountAndSigner();
+      if (!accountId) {
+        return this.stateManager.listConnections();
+      }
+      const connectionManager = this.stateManager.getConnectionsManager();
+      if (!connectionManager) {
+        this.logger.error(NOT_INITIALIZED_ERROR);
+        return this.stateManager.listConnections();
+      }
+      const connections = await connectionManager.fetchConnectionData(
+        accountId
+      );
+      for (const connection of connections) {
+        this.stateManager.addActiveConnection(
+          connection
+        );
+      }
+      return connections;
+    } catch (error) {
+      this.logger.error("Failed to get enhanced connections:", error);
+      return this.stateManager.listConnections();
+    }
+  }
+  /**
+   * Check messages on a connection
+   */
+  async checkMessages(params) {
+    this.clearNotes();
+    if (!this.stateManager) {
+      throw new Error("StateManager is required to check messages");
+    }
+    const connection = this.stateManager.getConnectionByIdentifier(
+      params.targetIdentifier
+    );
+    if (!connection) {
+      this.executeResult = {
+        success: false,
+        error: `Could not find an active connection matching identifier "${params.targetIdentifier}". Use 'list_connections' to see active connections.`
+      };
+      return this;
+    }
+    const connectionTopicId = connection.connectionTopicId || "";
+    if (!connectionTopicId || !connectionTopicId.match(/^\d+\.\d+\.\d+$/)) {
+      this.logger.error(
+        `Invalid connection topic ID format: ${connectionTopicId}`
+      );
+      this.executeResult = {
+        success: false,
+        error: `Invalid connection topic ID format: ${connectionTopicId}. Expected format: 0.0.XXXXX`
+      };
+      return this;
+    }
+    const targetAgentName = connection.targetAgentName;
+    const lastProcessedTimestamp = this.stateManager.getLastTimestamp(connectionTopicId);
+    this.logger.info(
+      `Checking messages for connection with ${targetAgentName} (${connection.targetAccountId}) on topic ${connectionTopicId} (fetchLatest: ${params.fetchLatest}, lastCount: ${params.lastMessagesCount}, since: ${lastProcessedTimestamp})`
+    );
+    try {
+      const result = await this.getMessages(connectionTopicId);
+      const allMessages = result.messages;
+      if (!allMessages || allMessages.length === 0) {
+        this.executeResult = {
+          success: true,
+          rawResult: {
+            messages: [],
+            message: `No messages found on connection topic ${connectionTopicId}.`
+          }
+        };
+        return this;
+      }
+      let messagesToProcess = [];
+      let latestTimestampNanos = lastProcessedTimestamp;
+      const isFetchingLatest = params.fetchLatest === true;
+      if (isFetchingLatest) {
+        this.logger.info("Fetching latest messages regardless of timestamp.");
+        const count = params.lastMessagesCount ?? 1;
+        messagesToProcess = allMessages.slice(-count);
+      } else {
+        this.logger.info(
+          `Filtering for messages newer than ${lastProcessedTimestamp}`
+        );
+        messagesToProcess = allMessages.filter(
+          (msg) => {
+            const msgTimestampNanos = msg.timestamp * 1e6;
+            return msgTimestampNanos > lastProcessedTimestamp;
+          }
+        );
+        if (messagesToProcess.length > 0) {
+          latestTimestampNanos = messagesToProcess.reduce(
+            (maxTs, msg) => Math.max(maxTs, msg.timestamp * 1e6),
+            lastProcessedTimestamp
+          );
+        }
+      }
+      if (messagesToProcess.length === 0) {
+        const message = isFetchingLatest ? `Could not retrieve the latest message(s). No messages found on topic ${connectionTopicId}.` : `No new messages found for connection with ${targetAgentName} since last check.`;
+        this.executeResult = {
+          success: true,
+          rawResult: {
+            messages: [],
+            message
+          }
+        };
+        return this;
+      }
+      this.logger.info(`Processing ${messagesToProcess.length} message(s).`);
+      let outputString = isFetchingLatest ? `Latest message(s) from ${targetAgentName}:
+` : `New messages from ${targetAgentName}:
+`;
+      const processedMessages = [];
+      for (const msg of messagesToProcess) {
+        let content = msg.data;
+        try {
+          if (typeof content === "string" && content.startsWith("hcs://")) {
+            this.logger.debug(`Resolving inscribed message: ${content}`);
+            content = await this.getMessageContent(content);
+            this.logger.debug(`Resolved content length: ${content?.length}`);
+          }
+          let displayContent = content;
+          try {
+            const parsed = JSON.parse(content || "{}");
+            if (parsed.p === "hcs-10" && parsed.op === "message" && parsed.data) {
+              const senderOpId = parsed.operator_id || "unknown_sender";
+              displayContent = `[${senderOpId}]: ${parsed.data}`;
+            } else {
+              displayContent = content;
+            }
+          } catch {
+            displayContent = content;
+          }
+          const messageDate = new Date(msg.timestamp);
+          outputString += `
+[${messageDate.toLocaleString()}] (Seq: ${msg.sequence_number})
+${displayContent}
+`;
+          processedMessages.push({
+            timestamp: msg.timestamp,
+            sequenceNumber: msg.sequence_number,
+            content: displayContent,
+            raw: msg
+          });
+        } catch (error) {
+          const errorMsg = `Error processing message (Seq: ${msg.sequence_number}): ${error instanceof Error ? error.message : String(error)}`;
+          this.logger.error(errorMsg);
+          outputString += `
+[Error processing message Seq: ${msg.sequence_number}]
+`;
+        }
+      }
+      if (!isFetchingLatest && latestTimestampNanos > lastProcessedTimestamp) {
+        this.logger.debug(
+          `Updating timestamp for topic ${connectionTopicId} to ${latestTimestampNanos}`
+        );
+        this.stateManager.updateTimestamp(
+          connectionTopicId,
+          latestTimestampNanos
+        );
+      }
+      this.executeResult = {
+        success: true,
+        rawResult: {
+          messages: processedMessages,
+          formattedOutput: outputString.trim(),
+          targetAgentName,
+          connectionTopicId
+        }
+      };
+    } catch (error) {
+      this.logger.error(
+        `Failed to check messages for topic ${connectionTopicId}: ${error}`
+      );
+      this.executeResult = {
+        success: false,
+        error: `Error checking messages for ${targetAgentName}: ${error instanceof Error ? error.message : String(error)}`
       };
     }
+    return this;
   }
-  async initializeWithValidation(options) {
-    const validationResult = await this.validateOperator(options);
-    if (validationResult.isValid) {
-      if (options.stateManager) {
-        options.stateManager.initializeConnectionsManager(this.standardClient);
+  /**
+   * Find registrations using the configured registry
+   */
+  async findRegistrations(params) {
+    this.clearNotes();
+    try {
+      const options = {
+        network: this.network
+      };
+      if (params.accountId) {
+        options.accountId = params.accountId;
+      }
+      if (params.tags && params.tags.length > 0) {
+        options.tags = params.tags;
+      }
+      const result = await this.standardClient.findRegistrations(options);
+      if (!result.success || result.error) {
+        this.executeResult = {
+          success: false,
+          error: `Error finding registrations: ${result.error || "Unknown error"}`
+        };
+        return this;
       }
+      if (!result.registrations || result.registrations.length === 0) {
+        this.executeResult = {
+          success: true,
+          rawResult: {
+            registrations: [],
+            message: "No registrations found matching the criteria."
+          }
+        };
+        return this;
+      }
+      const formattedRegistrations = result.registrations.map((reg) => {
+        const registration = reg;
+        const agentName = registration.agent?.name || "Unknown Agent";
+        const accountId = registration.accountId || "Unknown Account";
+        const capabilities = registration.agent?.capabilities?.join(", ") || "None";
+        return `Agent: ${agentName} (${accountId}), Capabilities: ${capabilities}`;
+      }).join("\\n");
+      this.executeResult = {
+        success: true,
+        rawResult: {
+          registrations: result.registrations,
+          formattedOutput: `Found ${result.registrations.length} registration(s):\\n${formattedRegistrations}`
+        }
+      };
+    } catch (error) {
+      this.logger.error("Error during FindRegistrations execution:", error);
+      this.executeResult = {
+        success: false,
+        error: `Failed to search registrations: ${error instanceof Error ? error.message : String(error)}`
+      };
     }
-    return validationResult;
+    return this;
+  }
+  /**
+   * Retrieve detailed profile information for an agent
+   */
+  async retrieveProfile(params) {
+    this.clearNotes();
+    try {
+      const profileResponse = await this.standardClient.retrieveProfile(
+        params.accountId,
+        params.disableCache || false
+      );
+      if (!profileResponse.success) {
+        this.executeResult = {
+          success: false,
+          error: `Failed to retrieve profile: ${profileResponse.error || "Unknown error"}`
+        };
+        return this;
+      }
+      const profile = profileResponse.profile;
+      const topicInfo = profileResponse.topicInfo;
+      let profileDetails = `Profile for ${params.accountId}:
+`;
+      profileDetails += `Name: ${profile.name || "Unknown"}
+`;
+      profileDetails += `Bio: ${profile.bio || "No bio provided"}
+`;
+      profileDetails += `Type: ${profile.type || "Unknown"}
+`;
+      profileDetails += `Model: ${profile.model || "Unknown"}
+`;
+      if (profile.capabilities && profile.capabilities.length > 0) {
+        profileDetails += `Capabilities: ${profile.capabilities.join(", ")}
+`;
+      } else {
+        profileDetails += `Capabilities: None listed
+`;
+      }
+      if (topicInfo) {
+        profileDetails += `Inbound Topic: ${topicInfo.inboundTopic || "Unknown"}
+`;
+        profileDetails += `Outbound Topic: ${topicInfo.outboundTopic || "Unknown"}
+`;
+        profileDetails += `Profile Topic: ${topicInfo.profileTopicId || "Unknown"}
+`;
+      }
+      if (profile.social && Object.keys(profile.social).length > 0) {
+        profileDetails += `Social: ${Object.entries(profile.social).map(([platform, handle]) => `${platform}: ${handle}`).join(", ")}
+`;
+      }
+      if (profile.properties && Object.keys(profile.properties).length > 0) {
+        profileDetails += `Properties: ${JSON.stringify(profile.properties)}
+`;
+      }
+      this.executeResult = {
+        success: true,
+        rawResult: {
+          profileDetails,
+          rawProfile: profileResponse
+        }
+      };
+    } catch (error) {
+      this.logger.error(
+        `Unexpected error retrieving profile for ${params.accountId}:`,
+        error
+      );
+      this.executeResult = {
+        success: false,
+        error: `Unexpected error retrieving profile for ${params.accountId}: ${error instanceof Error ? error.message : String(error)}`
+      };
+    }
+    return this;
+  }
+  /**
+   * Override execute to return stored HCS10 operation results
+   */
+  async execute() {
+    if (this.executeResult) {
+      return {
+        success: this.executeResult.success,
+        transactionId: this.executeResult.transactionId,
+        receipt: this.executeResult.receipt,
+        scheduleId: this.executeResult.scheduleId,
+        error: this.executeResult.error,
+        rawResult: this.executeResult.rawResult,
+        notes: this.notes
+      };
+    }
+    return {
+      success: false,
+      error: "No operation result available. Call a builder method first."
+    };
   }
 }
 export {
-  HCS10Client
+  HCS10Builder
 };
 //# sourceMappingURL=standards-agent-kit.es2.js.map