@hashgraphonline/standards-agent-kit 0.2.112 → 0.2.113

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

@@ -1,32 +1,332 @@
-import { BaseHederaTransactionTool, BaseHederaQueryTool } from "hedera-agent-kit";
-class BaseHCS10TransactionTool extends BaseHederaTransactionTool {
-  constructor(params) {
-    super(params);
-    this.namespace = "hcs10";
-    this.hcs10Builder = params.hcs10Builder;
+import { HCS10Client as HCS10Client$1, Logger, AgentBuilder, AIAgentCapability, InboundTopicType } from "@hashgraphonline/standards-sdk";
+import { encryptMessage } from "./standards-agent-kit.es42.js";
+class HCS10Client {
+  constructor(operatorId, operatorPrivateKey, network, options) {
+    this.standardClient = new HCS10Client$1({
+      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
+    });
+  }
+  getOperatorId() {
+    const operator = this.standardClient.getClient().operatorAccountId;
+    if (!operator) {
+      throw new Error("Operator Account ID not configured in standard client.");
+    }
+    return operator.toString();
+  }
+  getNetwork() {
+    return this.standardClient.getNetwork();
+  }
+  async handleConnectionRequest(inboundTopicId, requestingAccountId, connectionRequestId, feeConfig) {
+    try {
+      const result = await this.standardClient.handleConnectionRequest(
+        inboundTopicId,
+        requestingAccountId,
+        connectionRequestId,
+        feeConfig
+      );
+      return result;
+    } catch (error) {
+      this.logger.error(
+        `Error handling connection request #${connectionRequestId} for topic ${inboundTopicId}:`,
+        error
+      );
+      throw new Error(
+        `Failed to handle connection request: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
   }
   /**
-   * Override to return the HCS10Builder
+   * Retrieves the profile for a given account ID using the standard SDK.
    */
-  getServiceBuilder() {
-    return this.hcs10Builder;
+  async getAgentProfile(accountId) {
+    return this.standardClient.retrieveProfile(accountId);
   }
-}
-class BaseHCS10QueryTool extends BaseHederaQueryTool {
-  constructor(params) {
-    super(params);
-    this.namespace = "hcs10";
-    this.hcs10Builder = params.hcs10Builder;
+  /**
+   * Exposes the standard SDK's submitConnectionRequest method.
+   */
+  async submitConnectionRequest(inboundTopicId, memo) {
+    return this.standardClient.submitConnectionRequest(
+      inboundTopicId,
+      memo
+    );
+  }
+  /**
+   * Exposes the standard SDK's waitForConnectionConfirmation method.
+   */
+  async waitForConnectionConfirmation(outboundTopicId, connectionRequestId, maxAttempts = 60, delayMs = 2e3) {
+    return this.standardClient.waitForConnectionConfirmation(
+      outboundTopicId,
+      connectionRequestId,
+      maxAttempts,
+      delayMs
+    );
   }
   /**
-   * Override to return the HCS10Builder
+   * 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.
    */
-  getServiceBuilder() {
-    return this.hcs10Builder;
+  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);
+      });
+    }
+    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
+        };
+      }
+      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)}`
+      );
+    }
+  }
+  /**
+   * 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.
+   */
+  async sendMessage(topicId, data, memo, submitKey) {
+    if (this.useEncryption) {
+      data = encryptMessage(data);
+    }
+    try {
+      const messageResponse = await this.standardClient.sendMessage(
+        topicId,
+        data,
+        memo,
+        submitKey
+      );
+      return messageResponse.topicSequenceNumber?.toNumber();
+    } catch (error) {
+      this.logger.error(`Error sending message to topic ${topicId}:`, error);
+      throw new Error(
+        `Failed to send message: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * 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.
+   */
+  async getMessages(topicId) {
+    try {
+      const result = await this.standardClient.getMessages(topicId);
+      const mappedMessages = result.messages.map((sdkMessage) => {
+        const timestamp = sdkMessage?.created?.getTime() || 0;
+        return {
+          ...sdkMessage,
+          timestamp,
+          data: sdkMessage.data,
+          sequence_number: sdkMessage.sequence_number
+        };
+      });
+      mappedMessages.sort(
+        (a, b) => a.timestamp - b.timestamp
+      );
+      return { messages: mappedMessages };
+    } catch (error) {
+      this.logger.error(`Error getting messages from topic ${topicId}:`, error);
+      return { messages: [] };
+    }
+  }
+  async getMessageStream(topicId) {
+    const result = this.standardClient.getMessageStream(topicId);
+    return result;
+  }
+  /**
+   * 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.
+   */
+  async getMessageContent(inscriptionIdOrData) {
+    try {
+      const content = await this.standardClient.getMessageContent(
+        inscriptionIdOrData
+      );
+      return content;
+    } catch (error) {
+      this.logger.error(
+        `Error retrieving message content for: ${inscriptionIdOrData}`,
+        error
+      );
+      throw new Error(
+        `Failed to retrieve message content: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+  /**
+   * 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.
+   */
+  async getInboundTopicId() {
+    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) {
+        this.logger.info(
+          `[HCS10Client] 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(
+        `[HCS10Client] Error fetching operator's inbound topic ID (${this.getOperatorId()}):`,
+        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 configured operator account ID and private key.
+   * Required by tools needing to identify the current agent instance.
+   */
+  getAccountAndSigner() {
+    const result = this.standardClient.getAccountAndSigner();
+    return {
+      accountId: result.accountId,
+      signer: result.signer
+    };
+  }
+  /**
+   * 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.
+   */
+  async getOutboundTopicId() {
+    const operatorId = this.getOperatorId();
+    const profile = await this.getAgentProfile(operatorId);
+    if (profile.success && profile.topicInfo?.outboundTopic) {
+      return profile.topicInfo.outboundTopic;
+    } else {
+      throw new Error(
+        `Could not retrieve outbound topic from profile for ${operatorId}. Profile success: ${profile.success}, Error: ${profile.error}`
+      );
+    }
+  }
+  setClient(accountId, privateKey) {
+    this.standardClient = new HCS10Client$1({
+      network: this.getNetwork(),
+      operatorId: accountId,
+      operatorPrivateKey: privateKey,
+      guardedRegistryBaseUrl: this.guardedRegistryBaseUrl
+    });
+    return this.standardClient;
+  }
+  /**
+   * Validates that the operator account exists and has proper access for agent operations
+   */
+  async validateOperator(options) {
+    try {
+      this.setClient(options.accountId, options.privateKey);
+      const operatorId = this.getOperatorId();
+      return {
+        isValid: true,
+        operator: { accountId: operatorId }
+      };
+    } catch (error) {
+      this.logger.error(`Validation error: ${error}`);
+      return {
+        isValid: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  async initializeWithValidation(options) {
+    const validationResult = await this.validateOperator(options);
+    if (validationResult.isValid) {
+      if (options.stateManager) {
+        options.stateManager.initializeConnectionsManager(this.standardClient);
+      }
+    }
+    return validationResult;
   }
 }
 export {
-  BaseHCS10QueryTool,
-  BaseHCS10TransactionTool
+  HCS10Client
 };
 //# sourceMappingURL=standards-agent-kit.es6.js.map

package/dist/es/standards-agent-kit.es6.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es6.js","sources":["../../src/tools/hcs10/base-hcs10-tools.ts"],"sourcesContent":["import {\n  BaseHederaTransactionTool,\n  BaseHederaQueryTool,\n  BaseServiceBuilder,\n} from 'hedera-agent-kit';\nimport { HCS10Builder } from '../../builders/hcs10/hcs10-builder';\nimport {\n  HCS10TransactionToolParams,\n  HCS10QueryToolParams,\n} from './hcs10-tool-params';\nimport { z } from 'zod';\n\n/**\n * Base class for HCS10 transaction tools\n */\nexport abstract class BaseHCS10TransactionTool<\n  T extends z.ZodObject<\n    z.ZodRawShape,\n    z.UnknownKeysParam,\n    z.ZodTypeAny\n  > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaTransactionTool<T> {\n  protected hcs10Builder: HCS10Builder;\n  namespace = 'hcs10' as const;\n\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.hcs10Builder = params.hcs10Builder;\n  }\n\n  /**\n   * Override to return the HCS10Builder\n   */\n  protected getServiceBuilder(): BaseServiceBuilder {\n    return this.hcs10Builder;\n  }\n}\n\n/**\n * Base class for HCS10 query tools\n */\nexport abstract class BaseHCS10QueryTool<\n  T extends z.ZodObject<\n    z.ZodRawShape,\n    z.UnknownKeysParam,\n    z.ZodTypeAny\n  > = z.ZodObject<z.ZodRawShape>\n> extends BaseHederaQueryTool<T> {\n  protected hcs10Builder: HCS10Builder;\n  namespace = 'hcs10' as const;\n\n  constructor(params: HCS10QueryToolParams) {\n    super(params);\n    this.hcs10Builder = params.hcs10Builder;\n  }\n\n  /**\n   * Override to return the HCS10Builder\n   */\n  protected getServiceBuilder(): BaseServiceBuilder {\n    return this.hcs10Builder;\n  }\n}\n"],"names":[],"mappings":";AAeO,MAAe,iCAMZ,0BAA6B;AAAA,EAIrC,YAAY,QAAoC;AAC9C,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,eAAe,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AACF;AAKO,MAAe,2BAMZ,oBAAuB;AAAA,EAI/B,YAAY,QAA8B;AACxC,UAAM,MAAM;AAHd,SAAA,YAAY;AAIV,SAAK,eAAe,OAAO;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKU,oBAAwC;AAChD,WAAO,KAAK;AAAA,EACd;AACF;"}
+{"version":3,"file":"standards-agent-kit.es6.js","sources":["../../src/hcs10/HCS10Client.ts"],"sourcesContent":["import { TransactionReceipt, PrivateKey } from '@hashgraph/sdk';\nimport {\n  HCS10Client as StandardSDKClient,\n  AgentBuilder,\n  InboundTopicType as StandardInboundTopicType,\n  AIAgentCapability as StandardAIAgentCapability,\n  AgentRegistrationResult,\n  WaitForConnectionConfirmationResponse,\n  ProfileResponse as SDKProfileResponse,\n  HCSMessage,\n  LogLevel,\n  Logger,\n  FeeConfigBuilderInterface,\n  SocialPlatform,\n} from '@hashgraphonline/standards-sdk';\nimport { AgentMetadata, AgentChannels } from './types';\nimport { encryptMessage } from '../utils/Encryption';\nimport { IStateManager } from '../state/state-types';\n\n// Keep type alias as they were removed accidentally\ntype StandardHandleConnectionRequest = InstanceType<\n  typeof StandardSDKClient\n>['handleConnectionRequest'];\ntype HandleConnectionRequestResponse = Awaited<\n  ReturnType<StandardHandleConnectionRequest>\n>;\nexport type StandardNetworkType = 'mainnet' | 'testnet';\n\nexport interface ClientValidationOptions {\n  accountId: string;\n  privateKey: string;\n  network?: StandardNetworkType;\n  stateManager?: IStateManager;\n}\n\nexport interface HCSMessageWithTimestamp extends HCSMessage {\n  timestamp: number;\n  data?: string;\n  sequence_number: number;\n}\n\nexport interface ExtendedAgentMetadata extends AgentMetadata {\n  pfpBuffer?: Buffer;\n  pfpFileName?: string;\n  feeConfig?: FeeConfigBuilderInterface;\n}\n\n/**\n * HCS10Client wraps the HCS-10 functionalities using the @hashgraphonline/standards-sdk.\n * - Creates and registers agents using the standard SDK flow.\n * - Manages agent communication channels (handled by standard SDK).\n * - Sends messages on Hedera topics (currently manual, potential for standard SDK integration).\n */\nexport class HCS10Client {\n  public standardClient: StandardSDKClient;\n  private useEncryption: boolean;\n  public agentChannels?: AgentChannels;\n  public guardedRegistryBaseUrl: string;\n  public logger: Logger;\n\n  constructor(\n    operatorId: string,\n    operatorPrivateKey: string,\n    network: StandardNetworkType,\n    options?: {\n      useEncryption?: boolean;\n      registryUrl?: string;\n      logLevel?: LogLevel;\n    }\n  ) {\n    this.standardClient = new StandardSDKClient({\n      network: network,\n      operatorId: operatorId,\n      operatorPrivateKey: operatorPrivateKey,\n      guardedRegistryBaseUrl: options?.registryUrl,\n      logLevel: options?.logLevel,\n    });\n    this.guardedRegistryBaseUrl = options?.registryUrl || '';\n    this.useEncryption = options?.useEncryption || false;\n    const shouldSilence = process.env.DISABLE_LOGGING === 'true';\n    this.logger = new Logger({\n      level: options?.logLevel || 'info',\n      silent: shouldSilence,\n    });\n  }\n\n  public getOperatorId(): string {\n    const operator = this.standardClient.getClient().operatorAccountId;\n    if (!operator) {\n      throw new Error('Operator Account ID not configured in standard client.');\n    }\n    return operator.toString();\n  }\n\n  public getNetwork(): StandardNetworkType {\n    return this.standardClient.getNetwork() as StandardNetworkType;\n  }\n\n  public async handleConnectionRequest(\n    inboundTopicId: string,\n    requestingAccountId: string,\n    connectionRequestId: number,\n    feeConfig?: FeeConfigBuilderInterface\n  ): Promise<HandleConnectionRequestResponse> {\n    try {\n      const result = await this.standardClient.handleConnectionRequest(\n        inboundTopicId,\n        requestingAccountId,\n        connectionRequestId,\n        feeConfig\n      );\n      return result;\n    } catch (error) {\n      this.logger.error(\n        `Error handling connection request #${connectionRequestId} for topic ${inboundTopicId}:`,\n        error\n      );\n      throw new Error(\n        `Failed to handle connection request: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n\n  /**\n   * Retrieves the profile for a given account ID using the standard SDK.\n   */\n  public async getAgentProfile(accountId: string): Promise<SDKProfileResponse> {\n    return this.standardClient.retrieveProfile(accountId);\n  }\n\n  /**\n   * Exposes the standard SDK's submitConnectionRequest method.\n   */\n  public async submitConnectionRequest(\n    inboundTopicId: string,\n    memo: string\n  ): Promise<TransactionReceipt> {\n    return this.standardClient.submitConnectionRequest(\n      inboundTopicId,\n      memo\n    ) as Promise<TransactionReceipt>;\n  }\n\n  /**\n   * Exposes the standard SDK's waitForConnectionConfirmation method.\n   */\n  public async waitForConnectionConfirmation(\n    outboundTopicId: string,\n    connectionRequestId: number,\n    maxAttempts = 60,\n    delayMs = 2000\n  ): Promise<WaitForConnectionConfirmationResponse> {\n    return this.standardClient.waitForConnectionConfirmation(\n      outboundTopicId,\n      connectionRequestId,\n      maxAttempts,\n      delayMs\n    );\n  }\n\n  /**\n   * Creates and registers an agent using the standard SDK's HCS10Client.\n   * This handles account creation, key generation, topic setup, and registration.\n   *\n   * When metadata includes fee configuration:\n   * 1. The properties.feeConfig will be passed to the AgentBuilder\n   * 2. The properties.inboundTopicType will be set to FEE_BASED\n   * 3. The SDK's createAndRegisterAgent will apply the fees to the agent's inbound topic\n   *\n   * @param metadata - The agent's metadata, potentially including pfpBuffer, pfpFileName,\n   *                   and fee configuration in properties.feeConfig\n   * @returns The registration result from the standard SDK, containing accountId, keys, topics etc.\n   */\n  public async createAndRegisterAgent(\n    metadata: ExtendedAgentMetadata\n  ): Promise<AgentRegistrationResult> {\n    const builder = new AgentBuilder()\n      .setName(metadata.name)\n      .setBio(metadata.description || '')\n      .setCapabilities(\n        metadata.capabilities\n          ? metadata.capabilities\n          : [StandardAIAgentCapability.TEXT_GENERATION]\n      )\n      .setType((metadata.type || 'autonomous') as 'autonomous' | 'manual')\n      .setModel(metadata.model || 'agent-model-2024')\n      .setNetwork(this.getNetwork())\n      .setInboundTopicType(StandardInboundTopicType.PUBLIC);\n\n    if (metadata?.feeConfig) {\n      builder.setInboundTopicType(StandardInboundTopicType.FEE_BASED);\n      builder.setFeeConfig(metadata.feeConfig);\n    }\n\n    if (metadata.pfpBuffer && metadata.pfpFileName) {\n      if (metadata.pfpBuffer.byteLength === 0) {\n        this.logger.warn(\n          'Provided PFP buffer is empty. Skipping profile picture.'\n        );\n      } else {\n        this.logger.info(\n          `Setting profile picture: ${metadata.pfpFileName} (${metadata.pfpBuffer.byteLength} bytes)`\n        );\n        builder.setProfilePicture(metadata.pfpBuffer, metadata.pfpFileName);\n      }\n    } else {\n      this.logger.warn(\n        'Profile picture not provided in metadata. Agent creation might fail if required by the underlying SDK builder.'\n      );\n    }\n\n    if (metadata.social) {\n      Object.entries(metadata.social).forEach(([platform, handle]) => {\n        builder.addSocial(platform as SocialPlatform, handle);\n      });\n    }\n\n    if (metadata.properties) {\n      Object.entries(metadata.properties).forEach(([key, value]) => {\n        builder.addProperty(key, value);\n      });\n    }\n\n    try {\n      const hasFees = Boolean(metadata?.feeConfig);\n      const result = await this.standardClient.createAndRegisterAgent(builder, {\n        initialBalance: hasFees ? 50 : undefined,\n      });\n      if (\n        result?.metadata?.inboundTopicId &&\n        result?.metadata?.outboundTopicId\n      ) {\n        this.agentChannels = {\n          inboundTopicId: result.metadata.inboundTopicId,\n          outboundTopicId: result.metadata.outboundTopicId,\n        };\n      }\n      return result;\n    } catch (error) {\n      this.logger.error('Error during agent creation/registration:', error);\n      throw new Error(\n        `Failed to create/register agent: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n\n  /**\n   * Sends a structured HCS-10 message to the specified topic using the standard SDK client.\n   * Handles potential inscription for large messages.\n   *\n   * @param topicId - The target topic ID (likely a connection topic).\n   * @param operatorId - The operator ID string (e.g., \"inboundTopic@accountId\").\n   * @param data - The actual message content/data.\n   * @param memo - Optional memo for the message.\n   * @param submitKey - Optional private key for topics requiring specific submit keys.\n   * @returns A confirmation status string from the transaction receipt.\n   */\n  public async sendMessage(\n    topicId: string,\n    data: string,\n    memo?: string,\n    submitKey?: PrivateKey\n  ): Promise<number | undefined> {\n    if (this.useEncryption) {\n      data = encryptMessage(data);\n    }\n\n    try {\n      const messageResponse = await this.standardClient.sendMessage(\n        topicId,\n        data,\n        memo,\n        submitKey\n      );\n      return messageResponse.topicSequenceNumber?.toNumber();\n    } catch (error) {\n      this.logger.error(`Error sending message to topic ${topicId}:`, error);\n      throw new Error(\n        `Failed to send message: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n\n  /**\n   * Retrieves messages from a topic using the standard SDK client.\n   *\n   * @param topicId - The topic ID to get messages from.\n   * @returns Messages from the topic, mapped to the expected format.\n   */\n  public async getMessages(topicId: string): Promise<{\n    messages: HCSMessageWithTimestamp[];\n  }> {\n    try {\n      const result = await this.standardClient.getMessages(topicId);\n\n      const mappedMessages = result.messages.map((sdkMessage) => {\n        const timestamp = sdkMessage?.created?.getTime() || 0;\n\n        return {\n          ...sdkMessage,\n          timestamp: timestamp,\n          data: sdkMessage.data,\n          sequence_number: sdkMessage.sequence_number,\n        };\n      });\n      mappedMessages.sort(\n        (a: { timestamp: number }, b: { timestamp: number }) =>\n          a.timestamp - b.timestamp\n      );\n      return { messages: mappedMessages as HCSMessageWithTimestamp[] };\n    } catch (error) {\n      this.logger.error(`Error getting messages from topic ${topicId}:`, error);\n      return { messages: [] };\n    }\n  }\n\n  public async getMessageStream(topicId: string): Promise<{\n    messages: HCSMessage[];\n  }> {\n    const result = this.standardClient.getMessageStream(topicId);\n    return result as Promise<{ messages: HCSMessage[] }>;\n  }\n\n  /**\n   * Retrieves content from an inscribed message using the standard SDK client.\n   * @param inscriptionIdOrData - The inscription ID (hcs://...) or potentially raw data string.\n   * @returns The resolved message content.\n   */\n  public async getMessageContent(inscriptionIdOrData: string): Promise<string> {\n    try {\n      const content = await this.standardClient.getMessageContent(\n        inscriptionIdOrData\n      );\n      return content as string;\n    } catch (error) {\n      this.logger.error(\n        `Error retrieving message content for: ${inscriptionIdOrData}`,\n        error\n      );\n      throw new Error(\n        `Failed to retrieve message content: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n\n  /**\n   * Retrieves the inbound topic ID associated with the current operator.\n   * This typically involves fetching the operator's own HCS-10 profile.\n   * @returns A promise that resolves to the operator's inbound topic ID.\n   * @throws {Error} If the operator ID cannot be determined or the profile/topic cannot be retrieved.\n   */\n  public async getInboundTopicId(): Promise<string> {\n    try {\n      const operatorId = this.getOperatorId();\n      this.logger.info(\n        `[HCS10Client] Retrieving profile for operator ${operatorId} to find inbound topic...`\n      );\n      const profileResponse = await this.getAgentProfile(operatorId);\n      if (profileResponse.success && profileResponse.topicInfo?.inboundTopic) {\n        this.logger.info(\n          `[HCS10Client] Found inbound topic for operator ${operatorId}: ${profileResponse.topicInfo.inboundTopic}`\n        );\n        return profileResponse.topicInfo.inboundTopic;\n      } else {\n        throw new Error(\n          `Could not retrieve inbound topic from profile for ${operatorId}. Profile success: ${profileResponse.success}, Error: ${profileResponse.error}`\n        );\n      }\n    } catch (error) {\n      this.logger.error(\n        `[HCS10Client] Error fetching operator's inbound topic ID (${this.getOperatorId()}):`,\n        error\n      );\n      const operatorId = this.getOperatorId();\n      let detailedMessage = `Failed to get inbound topic ID for operator ${operatorId}.`;\n      if (\n        error instanceof Error &&\n        error.message.includes('does not have a valid HCS-11 memo')\n      ) {\n        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).`;\n      } else if (error instanceof Error) {\n        detailedMessage += ` Reason: ${error.message}`;\n      } else {\n        detailedMessage += ` Unexpected error: ${String(error)}`;\n      }\n      throw new Error(detailedMessage);\n    }\n  }\n\n  /**\n   * Retrieves the configured operator account ID and private key.\n   * Required by tools needing to identify the current agent instance.\n   */\n  public getAccountAndSigner(): { accountId: string; signer: PrivateKey } {\n    const result = this.standardClient.getAccountAndSigner();\n    return {\n      accountId: result.accountId,\n      signer: result.signer as unknown as PrivateKey,\n    };\n  }\n\n  /**\n   * Retrieves the outbound topic ID for the current operator.\n   * Fetches the operator's profile if necessary.\n   * @returns The outbound topic ID string.\n   * @throws If the outbound topic cannot be determined.\n   */\n  public async getOutboundTopicId(): Promise<string> {\n    const operatorId = this.getOperatorId();\n    const profile = await this.getAgentProfile(operatorId);\n    if (profile.success && profile.topicInfo?.outboundTopic) {\n      return profile.topicInfo.outboundTopic;\n    } else {\n      throw new Error(\n        `Could not retrieve outbound topic from profile for ${operatorId}. Profile success: ${profile.success}, Error: ${profile.error}`\n      );\n    }\n  }\n\n  public setClient(accountId: string, privateKey: string): StandardSDKClient {\n    this.standardClient = new StandardSDKClient({\n      network: this.getNetwork(),\n      operatorId: accountId,\n      operatorPrivateKey: privateKey,\n      guardedRegistryBaseUrl: this.guardedRegistryBaseUrl,\n    });\n    return this.standardClient;\n  }\n\n  /**\n   * Validates that the operator account exists and has proper access for agent operations\n   */\n  private async validateOperator(options: ClientValidationOptions): Promise<{\n    isValid: boolean;\n    operator?: { accountId: string };\n    error?: string;\n  }> {\n    try {\n      // Set up client with provided operator details\n      this.setClient(options.accountId, options.privateKey);\n\n      // Check if we can retrieve the operator ID\n      const operatorId = this.getOperatorId();\n\n      // If we got this far, basic validation passed\n      return {\n        isValid: true,\n        operator: { accountId: operatorId },\n      };\n    } catch (error) {\n      this.logger.error(`Validation error: ${error}`);\n      return {\n        isValid: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n\n  async initializeWithValidation(options: ClientValidationOptions): Promise<{\n    isValid: boolean;\n    operator?: { accountId: string };\n    error?: string;\n  }> {\n    const validationResult = await this.validateOperator(options);\n\n    if (validationResult.isValid) {\n      // If we have access to the state manager, initialize its connections manager\n      if (options.stateManager) {\n        options.stateManager.initializeConnectionsManager(this.standardClient);\n      }\n    }\n\n    return validationResult;\n  }\n}\n"],"names":["StandardSDKClient","StandardAIAgentCapability","StandardInboundTopicType"],"mappings":"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"}

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

@@ -1,240 +1,32 @@
-import { AIAgentCapability } from "@hashgraphonline/standards-sdk";
-import { z } from "zod";
-import { BaseHCS10TransactionTool } from "./standards-agent-kit.es6.js";
-import { NaturalLanguageMapper } from "./standards-agent-kit.es18.js";
-const RegisterAgentZodSchema = z.object({
-  name: z.string().min(1).max(50).describe("A unique name for the agent (1-50 characters)"),
-  description: z.string().max(500).optional().describe("Optional bio description for the agent (max 500 characters)"),
-  alias: z.string().optional().transform((val) => {
-    if (!val || val.toLowerCase().includes("random")) {
-      const timestamp = Date.now().toString(36);
-      const randomChars = Math.random().toString(36);
-      return `bot${timestamp}${randomChars}`;
-    }
-    return val;
-  }).describe(
-    'Optional custom username/alias for the agent. Use "random" to generate a unique alias'
-  ),
-  type: z.enum(["autonomous", "manual"]).optional().describe("Agent type (default: autonomous)"),
-  model: z.string().optional().describe("AI model identifier (default: agent-model-2024)"),
-  capabilities: z.union([
-    z.array(z.nativeEnum(AIAgentCapability)),
-    z.array(z.string()),
-    z.string()
-  ]).optional().transform((val) => {
-    if (!val) return void 0;
-    if (typeof val === "string") {
-      return NaturalLanguageMapper.parseCapabilities(val);
-    }
-    if (Array.isArray(val) && val.length > 0 && typeof val[0] === "string") {
-      return NaturalLanguageMapper.parseTagsOrCapabilities(val);
-    }
-    return val;
-  }).describe('Agent capabilities - can be capability names (e.g. "ai", "data processing"), capability enum values, or array of either. Common values: "ai"/"text" (TEXT_GENERATION), "data" (DATA_INTEGRATION), "analytics" (TRANSACTION_ANALYTICS)'),
-  tags: z.union([
-    z.array(z.string()),
-    z.string()
-  ]).optional().transform((val) => {
-    if (!val) return void 0;
-    if (typeof val === "string") {
-      return NaturalLanguageMapper.parseCapabilities(val);
-    }
-    return NaturalLanguageMapper.parseTagsOrCapabilities(val);
-  }).describe('Tags for the agent (alternative to capabilities) - e.g. "ai", "data", "analytics". Will be converted to appropriate capabilities.'),
-  creator: z.string().optional().describe("Creator attribution for the agent"),
-  socials: z.record(
-    z.enum([
-      "twitter",
-      "github",
-      "discord",
-      "telegram",
-      "linkedin",
-      "youtube",
-      "website",
-      "x"
-    ]),
-    z.string()
-  ).optional().describe(
-    'Social media links (e.g., {"twitter": "@handle", "discord": "username"})'
-  ),
-  properties: z.record(z.unknown()).optional().describe("Custom metadata properties for the agent"),
-  profilePicture: z.union([
-    z.string().describe("URL or local file path to profile picture"),
-    z.object({
-      url: z.string().optional(),
-      path: z.string().optional(),
-      filename: z.string().optional()
-    })
-  ]).optional().describe(
-    "Optional profile picture as URL, file path, or object with url/path/filename"
-  ),
-  existingProfilePictureTopicId: z.string().optional().describe(
-    "Topic ID of an existing profile picture to reuse (e.g., 0.0.12345)"
-  ),
-  initialBalance: z.number().positive().optional().describe(
-    "Optional initial HBAR balance for the new agent account (will create new account if provided)"
-  ),
-  userAccountId: z.string().optional().describe(
-    "Optional account ID (e.g., 0.0.12345) to use as the agent account instead of creating a new one"
-  ),
-  hbarFee: z.number().positive().optional().describe(
-    "Optional HBAR fee amount to charge per message on the inbound topic"
-  ),
-  tokenFees: z.array(
-    z.object({
-      amount: z.number().positive(),
-      tokenId: z.string()
-    })
-  ).optional().describe("Optional token fees to charge per message"),
-  exemptAccountIds: z.array(z.string()).optional().describe("Optional account IDs to exempt from fees"),
-  setAsCurrent: z.boolean().optional().describe("Whether to set as current agent (default: true)"),
-  persistence: z.object({
-    prefix: z.string().optional()
-  }).optional().describe("Optional persistence configuration")
-});
-class RegisterAgentTool extends BaseHCS10TransactionTool {
+import { BaseHederaTransactionTool, BaseHederaQueryTool } from "hedera-agent-kit";
+class BaseHCS10TransactionTool extends BaseHederaTransactionTool {
   constructor(params) {
     super(params);
-    this.name = "register_agent";
-    this.description = 'Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Supports natural language for capabilities/tags like "ai", "data processing", "analytics". Note: This tool requires multiple transactions and cannot be used in returnBytes mode. If alias is set to "random" or contains "random", a unique alias will be generated.';
-    this.specificInputSchema = RegisterAgentZodSchema;
-    this.neverScheduleThisTool = true;
-    this.requiresMultipleTransactions = true;
-  }
-  async callBuilderMethod(builder, specificArgs) {
-    const hcs10Builder = builder;
-    this.specificArgs = specificArgs;
-    const params = {
-      name: specificArgs.name
-    };
-    if (specificArgs.description !== void 0) {
-      params.bio = specificArgs.description;
-    }
-    if (specificArgs.alias !== void 0) {
-      params.alias = specificArgs.alias;
-    } else {
-      const randomSuffix = Date.now().toString(36);
-      params.alias = `${specificArgs.name}${randomSuffix}`;
-    }
-    if (specificArgs.type !== void 0) {
-      params.type = specificArgs.type;
-    }
-    if (specificArgs.model !== void 0) {
-      params.model = specificArgs.model;
-    }
-    if (specificArgs.tags !== void 0) {
-      params.capabilities = specificArgs.tags;
-    } else if (specificArgs.capabilities !== void 0) {
-      params.capabilities = specificArgs.capabilities;
-    }
-    if (specificArgs.creator !== void 0) {
-      params.creator = specificArgs.creator;
-    }
-    if (specificArgs.socials !== void 0) {
-      params.socials = specificArgs.socials;
-    }
-    if (specificArgs.properties !== void 0) {
-      params.properties = specificArgs.properties;
-    }
-    if (specificArgs.profilePicture !== void 0) {
-      if (typeof specificArgs.profilePicture === "string") {
-        params.profilePicture = specificArgs.profilePicture;
-      } else {
-        const profilePicObj = {};
-        if (specificArgs.profilePicture.url !== void 0) {
-          profilePicObj.url = specificArgs.profilePicture.url;
-        }
-        if (specificArgs.profilePicture.path !== void 0) {
-          profilePicObj.path = specificArgs.profilePicture.path;
-        }
-        if (specificArgs.profilePicture.filename !== void 0) {
-          profilePicObj.filename = specificArgs.profilePicture.filename;
-        }
-        params.profilePicture = profilePicObj;
-      }
-    }
-    if (specificArgs.existingProfilePictureTopicId !== void 0) {
-      params.existingProfilePictureTopicId = specificArgs.existingProfilePictureTopicId;
-    }
-    if (specificArgs.userAccountId !== void 0) {
-      params.userAccountId = specificArgs.userAccountId;
-    }
-    if (specificArgs.hbarFee !== void 0) {
-      params.hbarFee = specificArgs.hbarFee;
-    }
-    if (specificArgs.tokenFees !== void 0) {
-      params.tokenFees = specificArgs.tokenFees;
-    }
-    if (specificArgs.exemptAccountIds !== void 0) {
-      params.exemptAccountIds = specificArgs.exemptAccountIds;
-    }
-    if (specificArgs.initialBalance !== void 0) {
-      params.initialBalance = specificArgs.initialBalance;
-    }
-    await hcs10Builder.registerAgent(params);
+    this.namespace = "hcs10";
+    this.hcs10Builder = params.hcs10Builder;
   }
   /**
-   * Override _call to intercept the result and save agent to state if needed
+   * Override to return the HCS10Builder
    */
-  async _call(args, runManager) {
-    const result = await super._call(args, runManager);
-    const shouldSetAsCurrent = this.specificArgs?.setAsCurrent !== false;
-    if (this.specificArgs && shouldSetAsCurrent) {
-      try {
-        const parsed = JSON.parse(result);
-        if (parsed.rawResult) {
-          this._handleRegistrationResult(parsed.rawResult);
-        } else if (parsed.state || parsed.accountId || parsed.metadata) {
-          this._handleRegistrationResult(parsed);
-        }
-      } catch (e) {
-      }
-    }
-    return result;
+  getServiceBuilder() {
+    return this.hcs10Builder;
+  }
+}
+class BaseHCS10QueryTool extends BaseHederaQueryTool {
+  constructor(params) {
+    super(params);
+    this.namespace = "hcs10";
+    this.hcs10Builder = params.hcs10Builder;
   }
   /**
-   * Extract agent data from registration result and save to state
+   * Override to return the HCS10Builder
    */
-  _handleRegistrationResult(rawResult) {
-    let accountId = rawResult.accountId || rawResult.metadata?.accountId;
-    if (!accountId && rawResult.state?.createdResources) {
-      const accountResource = rawResult.state.createdResources.find(
-        (r) => r.startsWith("account:")
-      );
-      if (accountResource) {
-        accountId = accountResource.split(":")[1];
-      }
-    }
-    const inboundTopicId = rawResult.inboundTopicId || rawResult.metadata?.inboundTopicId || rawResult.state?.inboundTopicId;
-    const outboundTopicId = rawResult.outboundTopicId || rawResult.metadata?.outboundTopicId || rawResult.state?.outboundTopicId;
-    const profileTopicId = rawResult.profileTopicId || rawResult.metadata?.profileTopicId || rawResult.state?.profileTopicId;
-    const privateKey = rawResult.privateKey || rawResult.metadata?.privateKey;
-    if (accountId && inboundTopicId && outboundTopicId && this.specificArgs) {
-      const registeredAgent = {
-        name: this.specificArgs.name,
-        accountId,
-        inboundTopicId,
-        outboundTopicId,
-        profileTopicId,
-        privateKey
-      };
-      const hcs10Builder = this.getServiceBuilder();
-      const stateManager = hcs10Builder.getStateManager();
-      if (stateManager) {
-        stateManager.setCurrentAgent(registeredAgent);
-        if (stateManager.persistAgentData) {
-          const prefix = this.specificArgs.persistence?.prefix || this.specificArgs.name.toUpperCase().replace(/[^A-Z0-9]/g, "_");
-          stateManager.persistAgentData(registeredAgent, {
-            type: "env-file",
-            prefix
-          }).catch(() => {
-          });
-        }
-      }
-    }
+  getServiceBuilder() {
+    return this.hcs10Builder;
   }
 }
 export {
-  RegisterAgentTool
+  BaseHCS10QueryTool,
+  BaseHCS10TransactionTool
 };
 //# sourceMappingURL=standards-agent-kit.es7.js.map