@hashgraphonline/standards-agent-kit 0.0.18 → 0.0.19

package/dist/hcs10/HCS10Client.js

@@ -0,0 +1,251 @@
+import { HCS10Client as s, Logger as g, AgentBuilder as a, AIAgentCapability as l, InboundTopicType as c } from "@hashgraphonline/standards-sdk";
+import { encryptMessage as u } from "../utils/Encryption.js";
+class h {
+  constructor(e, r, n, t) {
+    this.standardClient = new s({
+      network: n,
+      operatorId: e,
+      operatorPrivateKey: r,
+      guardedRegistryBaseUrl: t == null ? void 0 : t.registryUrl,
+      logLevel: t == null ? void 0 : t.logLevel
+    }), this.guardedRegistryBaseUrl = (t == null ? void 0 : t.registryUrl) || "", this.useEncryption = (t == null ? void 0 : t.useEncryption) || !1, this.logger = new g({
+      level: (t == null ? void 0 : t.logLevel) || "info"
+    });
+  }
+  getOperatorId() {
+    const e = this.standardClient.getClient().operatorAccountId;
+    if (!e)
+      throw new Error("Operator Account ID not configured in standard client.");
+    return e.toString();
+  }
+  getNetwork() {
+    return this.standardClient.getNetwork();
+  }
+  async handleConnectionRequest(e, r, n, t) {
+    try {
+      return await this.standardClient.handleConnectionRequest(
+        e,
+        r,
+        n,
+        t
+      );
+    } catch (o) {
+      throw this.logger.error(
+        `Error handling connection request #${n} for topic ${e}:`,
+        o
+      ), new Error(
+        `Failed to handle connection request: ${o instanceof Error ? o.message : String(o)}`
+      );
+    }
+  }
+  /**
+   * Retrieves the profile for a given account ID using the standard SDK.
+   */
+  async getAgentProfile(e) {
+    return this.standardClient.retrieveProfile(e);
+  }
+  /**
+   * Exposes the standard SDK's submitConnectionRequest method.
+   */
+  async submitConnectionRequest(e, r) {
+    return this.standardClient.submitConnectionRequest(
+      e,
+      r
+    );
+  }
+  /**
+   * Exposes the standard SDK's waitForConnectionConfirmation method.
+   */
+  async waitForConnectionConfirmation(e, r, n = 60, t = 2e3) {
+    return this.standardClient.waitForConnectionConfirmation(
+      e,
+      r,
+      n,
+      t
+    );
+  }
+  /**
+   * 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(e) {
+    var n, t;
+    const r = new a().setName(e.name).setBio(e.description || "").setCapabilities(
+      e.capabilities ? e.capabilities : [l.TEXT_GENERATION]
+    ).setType(e.type || "autonomous").setModel(e.model || "agent-model-2024").setNetwork(this.getNetwork()).setInboundTopicType(c.PUBLIC);
+    e != null && e.feeConfig && (r.setInboundTopicType(c.FEE_BASED), r.setFeeConfig(e.feeConfig)), e.pfpBuffer && e.pfpFileName ? e.pfpBuffer.byteLength === 0 ? this.logger.warn("Provided PFP buffer is empty. Skipping profile picture.") : (this.logger.info(
+      `Setting profile picture: ${e.pfpFileName} (${e.pfpBuffer.byteLength} bytes)`
+    ), r.setProfilePicture(e.pfpBuffer, e.pfpFileName)) : this.logger.warn(
+      "Profile picture not provided in metadata. Agent creation might fail if required by the underlying SDK builder."
+    ), e.social && Object.entries(e.social).forEach(([o, i]) => {
+      r.addSocial(o, i);
+    }), e.properties && Object.entries(e.properties).forEach(([o, i]) => {
+      r.addProperty(o, i);
+    });
+    try {
+      const o = !!(e != null && e.feeConfig), i = await this.standardClient.createAndRegisterAgent(r, {
+        initialBalance: o ? 50 : void 0
+      });
+      return (n = i == null ? void 0 : i.metadata) != null && n.inboundTopicId && ((t = i == null ? void 0 : i.metadata) != null && t.outboundTopicId) && (this.agentChannels = {
+        inboundTopicId: i.metadata.inboundTopicId,
+        outboundTopicId: i.metadata.outboundTopicId
+      }), i;
+    } catch (o) {
+      throw this.logger.error("Error during agent creation/registration:", o), new Error(
+        `Failed to create/register agent: ${o instanceof Error ? o.message : String(o)}`
+      );
+    }
+  }
+  /**
+   * 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(e, r, n, t) {
+    var o;
+    this.useEncryption && (r = u(r));
+    try {
+      return (o = (await this.standardClient.sendMessage(
+        e,
+        r,
+        n,
+        t
+      )).topicSequenceNumber) == null ? void 0 : o.toNumber();
+    } catch (i) {
+      throw this.logger.error(`Error sending message to topic ${e}:`, i), new Error(
+        `Failed to send message: ${i instanceof Error ? i.message : String(i)}`
+      );
+    }
+  }
+  /**
+   * 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(e) {
+    try {
+      const n = (await this.standardClient.getMessages(e)).messages.map((t) => {
+        var i;
+        const o = ((i = t == null ? void 0 : t.created) == null ? void 0 : i.getTime()) || 0;
+        return {
+          ...t,
+          timestamp: o,
+          data: t.data,
+          sequence_number: t.sequence_number
+        };
+      });
+      return n.sort(
+        (t, o) => t.timestamp - o.timestamp
+      ), { messages: n };
+    } catch (r) {
+      return this.logger.error(`Error getting messages from topic ${e}:`, r), { messages: [] };
+    }
+  }
+  async getMessageStream(e) {
+    return this.standardClient.getMessageStream(e);
+  }
+  /**
+   * 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(e) {
+    try {
+      return await this.standardClient.getMessageContent(
+        e
+      );
+    } catch (r) {
+      throw this.logger.error(
+        `Error retrieving message content for: ${e}`,
+        r
+      ), new Error(
+        `Failed to retrieve message content: ${r instanceof Error ? r.message : String(r)}`
+      );
+    }
+  }
+  /**
+   * 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() {
+    var e;
+    try {
+      const r = this.getOperatorId();
+      this.logger.info(
+        `[HCS10Client] Retrieving profile for operator ${r} to find inbound topic...`
+      );
+      const n = await this.getAgentProfile(r);
+      if (n.success && ((e = n.topicInfo) != null && e.inboundTopic))
+        return this.logger.info(
+          `[HCS10Client] Found inbound topic for operator ${r}: ${n.topicInfo.inboundTopic}`
+        ), n.topicInfo.inboundTopic;
+      throw new Error(
+        `Could not retrieve inbound topic from profile for ${r}. Profile success: ${n.success}, Error: ${n.error}`
+      );
+    } catch (r) {
+      this.logger.error(
+        `[HCS10Client] Error fetching operator's inbound topic ID (${this.getOperatorId()}):`,
+        r
+      );
+      const n = this.getOperatorId();
+      let t = `Failed to get inbound topic ID for operator ${n}.`;
+      throw r instanceof Error && r.message.includes("does not have a valid HCS-11 memo") ? t += ` The account profile may not exist or is invalid. Please ensure this operator account (${n}) is registered as an HCS-10 agent. You might need to register it first (e.g., using the 'register_agent' tool or SDK function).` : r instanceof Error ? t += ` Reason: ${r.message}` : t += ` Unexpected error: ${String(r)}`, new Error(t);
+    }
+  }
+  /**
+   * Retrieves the configured operator account ID and private key.
+   * Required by tools needing to identify the current agent instance.
+   */
+  getAccountAndSigner() {
+    const e = this.standardClient.getAccountAndSigner();
+    return {
+      accountId: e.accountId,
+      signer: e.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() {
+    var n;
+    const e = this.getOperatorId(), r = await this.getAgentProfile(e);
+    if (r.success && ((n = r.topicInfo) != null && n.outboundTopic))
+      return r.topicInfo.outboundTopic;
+    throw new Error(
+      `Could not retrieve outbound topic from profile for ${e}. Profile success: ${r.success}, Error: ${r.error}`
+    );
+  }
+  setClient(e, r) {
+    return this.standardClient = new s({
+      network: this.getNetwork(),
+      operatorId: e,
+      operatorPrivateKey: r,
+      guardedRegistryBaseUrl: this.guardedRegistryBaseUrl
+    }), this.standardClient;
+  }
+}
+export {
+  h as HCS10Client
+};
+//# sourceMappingURL=HCS10Client.js.map

package/dist/hcs10/HCS10Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HCS10Client.js","sources":["../../src/hcs10/HCS10Client.ts"],"sourcesContent":["import {\n  TransactionReceipt,\n  PrivateKey,\n  TopicMessageQuery,\n} 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';\n\n// Keep type alias as they were removed accidentally\ntype StandardHandleConnectionRequest =\n  InstanceType<typeof StandardSDKClient>['handleConnectionRequest'];\ntype HandleConnectionRequestResponse = Awaited<\n  ReturnType<StandardHandleConnectionRequest>\n>;\nexport type StandardNetworkType = 'mainnet' | 'testnet';\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    this.logger = new Logger({\n      level: options?.logLevel || 'info',\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('Provided PFP buffer is empty. Skipping profile picture.');\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?: any\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 };\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    return this.standardClient.getMessageStream(topicId);\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;\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"],"names":["HCS10Client","operatorId","operatorPrivateKey","network","options","StandardSDKClient","Logger","operator","inboundTopicId","requestingAccountId","connectionRequestId","feeConfig","error","accountId","memo","outboundTopicId","maxAttempts","delayMs","metadata","builder","AgentBuilder","StandardAIAgentCapability","StandardInboundTopicType","platform","handle","key","value","hasFees","result","_a","_b","topicId","data","submitKey","encryptMessage","mappedMessages","sdkMessage","timestamp","a","b","inscriptionIdOrData","profileResponse","detailedMessage","profile","privateKey"],"mappings":"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"}

package/dist/hcs10/index.d.ts

@@ -0,0 +1 @@
+export * from './HCS10Client';

package/dist/hcs10/types.d.ts

@@ -0,0 +1,35 @@
+import { FeeConfigBuilderInterface } from '@hashgraphonline/standards-sdk';
+/**
+ * Agent metadata interface used during registration.
+ */
+export interface AgentMetadata {
+    name: string;
+    description?: string;
+    contact?: string;
+    type?: 'autonomous' | 'manual';
+    model?: string;
+    capabilities?: number[];
+    social?: Record<string, string>;
+    properties?: Record<string, unknown>;
+    socials?: Record<string, string>;
+    creator?: string;
+    feeConfig?: FeeConfigBuilderInterface;
+}
+/**
+ * AgentChannels represents the communication topics for an agent.
+ */
+export interface AgentChannels {
+    inboundTopicId: string;
+    outboundTopicId: string;
+}
+/**
+ * Represents a message in the HCS-10 protocol
+ */
+export interface HCS10Message {
+    sender: string;
+    recipient: string;
+    content: string;
+    timestamp: number;
+    messageId: string;
+    metadata?: Record<string, unknown>;
+}

package/dist/index.d.ts

@@ -1,2 +1,5 @@
-export * from './src/index'
-export {}
+export * from './hcs10';
+export * from './tools';
+export * from './state';
+export * from './init';
+export * from './plugins';