@hashgraphonline/standards-agent-kit 0.0.37 → 0.2.0

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es3.js","sources":["../../src/tools/RegisterAgentTool.ts"],"sourcesContent":["import {\n  AIAgentCapability,\n  Logger,\n  FeeConfigBuilder,\n} from '@hashgraphonline/standards-sdk';\nimport { ensureAgentHasEnoughHbar } from '../utils/ensure-agent-has-hbar';\nimport { HCS10Client, ExtendedAgentMetadata } from '../hcs10/HCS10Client';\nimport { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { IStateManager } from '../state/state-types';\nimport { AgentPersistenceOptions } from '../state/state-types';\nimport fs from 'fs';\nimport path from 'path';\nimport axios from 'axios';\n\n/**\n * Interface for HCS10 registration result\n */\ninterface HCS10RegistrationResult {\n  metadata?: {\n    accountId?: string;\n    inboundTopicId?: string;\n    outboundTopicId?: string;\n    profileTopicId?: string;\n    privateKey?: string;\n    capabilities?: number[];\n    [key: string]: string | number | boolean | number[] | object | undefined;\n  };\n}\n\n/**\n * Agent registration details returned when successful\n */\ninterface AgentRegistrationDetails {\n  success: boolean;\n  message: string;\n  name: string;\n  accountId: string;\n  privateKey: string;\n  inboundTopicId: string;\n  outboundTopicId: string;\n  profileTopicId: string;\n  capabilities: number[];\n  hasFees: boolean;\n  hbarFee: number;\n  tokenFee: { amount: number; tokenId: string } | null;\n  profilePicture?: {\n    source: string;\n    topicId?: string;\n  };\n}\n\n/**\n * Profile picture input types supported by the tool\n */\ntype ProfilePictureInput =\n  | string\n  | {\n      url: string;\n      filename: string;\n    }\n  | {\n      path: string;\n      filename?: string;\n    };\n\n/**\n * RegisterAgentTool wraps the createAndRegisterAgent() function of HCS10Client.\n * It creates and registers an agent on Hedera using the HCS-10 standard SDK flow.\n * On success, returns a JSON string containing the new agent's details (including private key).\n */\nexport class RegisterAgentTool extends StructuredTool {\n  name = 'register_agent';\n  description =\n    \"Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Optionally supports fee configuration for the agent's inbound topic using HBAR or specific tokens.\";\n  private client: HCS10Client;\n  private stateManager?: IStateManager;\n\n  schema = z.object({\n    name: z.string().describe('The name of the agent to register'),\n    description: z\n      .string()\n      .optional()\n      .describe('Optional description of the agent'),\n    type: z\n      .enum(['autonomous', 'manual'])\n      .optional()\n      .describe('Optional agent type (default: autonomous)'),\n    model: z\n      .string()\n      .optional()\n      .describe('Optional model identifier for the agent'),\n    capabilities: z\n      .array(z.number())\n      .optional()\n      .describe(\n        'Optional array of AIAgentCapability enum values (0-18). If not provided, defaults to just TEXT_GENERATION (0)'\n      ),\n    profilePicture: z\n      .union([\n        z.string().describe('Path to a local image file or URL to an image'),\n        z.object({\n          url: z.string().describe('URL to an image file'),\n          filename: z.string().describe('Filename to use for the image'),\n        }),\n        z.object({\n          path: z.string().describe('Path to a local image file'),\n          filename: z.string().optional().describe('Optional custom filename'),\n        }),\n      ])\n      .optional()\n      .describe(\n        'Optional profile picture for the agent (local file path or URL)'\n      ),\n    feeCollectorAccountId: z\n      .string()\n      .optional()\n      .describe(\n        \"The account ID to collect fees. If not specified, the new agent's account ID will be used. Required if any fee is specified.\"\n      ),\n    hbarFee: z\n      .number()\n      .optional()\n      .describe(\n        'Optional: The fee amount in HBAR to charge per message on the inbound topic (e.g., 0.5). If specified, inboundTopicType will be set to FEE_BASED.'\n      ),\n    tokenFee: z\n      .object({\n        amount: z.number(),\n        tokenId: z.string(),\n      })\n      .optional()\n      .describe(\n        'Optional: The fee amount and token ID to charge per message on the inbound topic (e.g., { amount: 10, tokenId: \"0.0.12345\" }). If specified, inboundTopicType will be set to FEE_BASED.'\n      ),\n    hbarFees: z\n      .array(\n        z.object({\n          amount: z.number(),\n          collectorAccount: z.string().optional(),\n        })\n      )\n      .optional()\n      .describe(\n        'Optional: Array of HBAR fees with different collectors. If specified, inboundTopicType will be set to FEE_BASED.'\n      ),\n    tokenFees: z\n      .array(\n        z.object({\n          amount: z.number(),\n          tokenId: z.string(),\n          collectorAccount: z.string().optional(),\n        })\n      )\n      .optional()\n      .describe(\n        'Optional: Array of token fees with different collectors. If specified, inboundTopicType will be set to FEE_BASED.'\n      ),\n    exemptAccountIds: z\n      .array(z.string())\n      .optional()\n      .describe(\n        'Optional: Array of account IDs to exempt from ALL fees set for this agent.'\n      ),\n    setAsCurrent: z\n      .boolean()\n      .optional()\n      .describe(\n        'Optional: Whether to set the newly registered agent as the current active agent in the state manager. Default: true'\n      ),\n    persistence: z\n      .object({\n        prefix: z.string().optional(),\n      })\n      .optional()\n      .describe(\n        'Optional: Configuration for persisting agent data to environment variables. The prefix will determine the environment variable names (e.g., PREFIX_ACCOUNT_ID). Defaults to TODD if not specified.'\n      ),\n  });\n\n  /**\n   * Creates a new RegisterAgentTool instance\n   * @param client - Instance of HCS10Client (already configured with operator/network)\n   * @param stateManager - Optional state manager to store agent details\n   */\n  constructor(client: HCS10Client, stateManager?: IStateManager) {\n    super();\n    this.client = client;\n    this.stateManager = stateManager;\n  }\n\n  /**\n   * Loads a profile picture from a local file or URL and returns a buffer\n   * @param profilePicture - Local file path or URL\n   * @returns Object containing buffer and filename\n   */\n  private async loadProfilePicture(\n    profilePicture: ProfilePictureInput\n  ): Promise<{ buffer: Buffer; filename: string } | null> {\n    const logger = Logger.getInstance({\n      level: 'debug',\n    });\n\n    try {\n      if (!profilePicture) {\n        return null;\n      }\n\n      if (typeof profilePicture === 'string') {\n        const isUrl =\n          profilePicture.startsWith('http://') ||\n          profilePicture.startsWith('https://');\n\n        if (isUrl) {\n          logger.info(`Loading profile picture from URL: ${profilePicture}`);\n          const response = await axios.get(profilePicture, {\n            responseType: 'arraybuffer',\n          });\n          const buffer = Buffer.from(response.data);\n\n          const urlPathname = new URL(profilePicture).pathname;\n          const filename = path.basename(urlPathname) || 'profile.png';\n\n          return { buffer, filename };\n        } else {\n          if (!fs.existsSync(profilePicture)) {\n            logger.warn(`Profile picture file not found: ${profilePicture}`);\n            return null;\n          }\n\n          logger.info(`Loading profile picture from file: ${profilePicture}`);\n          const buffer = fs.readFileSync(profilePicture);\n          const filename = path.basename(profilePicture);\n\n          return { buffer, filename };\n        }\n      }\n\n      if ('url' in profilePicture) {\n        logger.info(`Loading profile picture from URL: ${profilePicture.url}`);\n        const response = await axios.get(profilePicture.url, {\n          responseType: 'arraybuffer',\n        });\n        const buffer = Buffer.from(response.data);\n        const filename = profilePicture.filename || 'profile.png';\n\n        return { buffer, filename };\n      }\n\n      if ('path' in profilePicture) {\n        if (!fs.existsSync(profilePicture.path)) {\n          logger.warn(`Profile picture file not found: ${profilePicture.path}`);\n          return null;\n        }\n\n        logger.info(\n          `Loading profile picture from file: ${profilePicture.path}`\n        );\n        const buffer = fs.readFileSync(profilePicture.path);\n        const filename =\n          profilePicture.filename || path.basename(profilePicture.path);\n\n        return { buffer, filename };\n      }\n\n      return null;\n    } catch (error) {\n      logger.error('Failed to load profile picture:', error);\n      return null;\n    }\n  }\n\n  /**\n   * Calls createAndRegisterAgent() with the provided metadata.\n   * Returns a JSON string with agent details on success, or an error string.\n   */\n  async _call(input: z.infer<typeof this.schema>): Promise<string> {\n    const logger = Logger.getInstance({\n      level: 'debug',\n    });\n\n    const metadata: ExtendedAgentMetadata = {\n      name: input.name,\n      description: input.description,\n      type: input.type,\n      model: input.model,\n      capabilities: input.capabilities || [AIAgentCapability.TEXT_GENERATION],\n      properties: {},\n    };\n\n    let profilePictureSource = '';\n    if (input.profilePicture) {\n      const profilePictureData = await this.loadProfilePicture(\n        input.profilePicture\n      );\n      if (profilePictureData) {\n        const { buffer, filename } = profilePictureData;\n        metadata.pfpBuffer = buffer;\n        metadata.pfpFileName = filename;\n\n        if (typeof input.profilePicture === 'string') {\n          profilePictureSource = input.profilePicture;\n        } else if ('url' in input.profilePicture) {\n          profilePictureSource = input.profilePicture.url;\n        } else if ('path' in input.profilePicture) {\n          profilePictureSource = input.profilePicture.path;\n        }\n      }\n    }\n\n    const hasHbarFee = input.hbarFee !== undefined && input.hbarFee > 0;\n    const hasTokenFee = this.hasValidTokenFee(input.tokenFee);\n    const hasHbarFees = input.hbarFees && input.hbarFees.length > 0;\n    const hasTokenFees = input.tokenFees && input.tokenFees.length > 0;\n\n    if (hasHbarFee || hasTokenFee || hasHbarFees || hasTokenFees) {\n      const { accountId: operatorAccountId } =\n        this.client.getAccountAndSigner();\n      const collectorId = input.feeCollectorAccountId || operatorAccountId;\n\n      if (!collectorId) {\n        return 'Error: Fee collector account ID is required when specifying fees and could not be determined.';\n      }\n\n      const feeConfigBuilder = new FeeConfigBuilder({\n        network: this.client.getNetwork(),\n        logger,\n      });\n\n      try {\n        const exemptAccountIds =\n          input.exemptAccountIds?.filter(\n            (id) => id !== collectorId && id.startsWith('0.0')\n          ) || [];\n\n        let updatedFeeConfig = feeConfigBuilder;\n\n        if (hasHbarFee) {\n          logger.info(\n            `Adding HBAR fee: ${input.hbarFee} HBAR to be collected by ${collectorId}`\n          );\n          updatedFeeConfig = updatedFeeConfig.addHbarFee(\n            input.hbarFee!,\n            collectorId,\n            exemptAccountIds\n          );\n        }\n\n        if (hasHbarFees) {\n          for (const fee of input.hbarFees!) {\n            const feeCollector = fee.collectorAccount || collectorId;\n            logger.info(\n              `Adding HBAR fee: ${fee.amount} HBAR to be collected by ${feeCollector}`\n            );\n            updatedFeeConfig = updatedFeeConfig.addHbarFee(\n              fee.amount,\n              feeCollector,\n              exemptAccountIds\n            );\n          }\n        }\n\n        if (hasTokenFee) {\n          logger.info(\n            `Adding token fee: ${input.tokenFee!.amount} of token ${\n              input.tokenFee!.tokenId\n            } to be collected by ${collectorId}`\n          );\n          updatedFeeConfig = await updatedFeeConfig.addTokenFee(\n            input.tokenFee!.amount,\n            input.tokenFee!.tokenId,\n            collectorId,\n            undefined,\n            exemptAccountIds\n          );\n        }\n\n        if (hasTokenFees) {\n          for (const fee of input.tokenFees!) {\n            const feeCollector = fee.collectorAccount || collectorId;\n            logger.info(\n              `Adding token fee: ${fee.amount} of token ${fee.tokenId} to be collected by ${feeCollector}`\n            );\n            updatedFeeConfig = await updatedFeeConfig.addTokenFee(\n              fee.amount,\n              fee.tokenId,\n              feeCollector,\n              undefined,\n              exemptAccountIds\n            );\n          }\n        }\n\n        metadata.feeConfig = updatedFeeConfig;\n        logger.info('FeeConfigBuilder created successfully');\n      } catch (error) {\n        return `Error: Failed to configure fees. Reason: ${\n          error instanceof Error ? error.message : String(error)\n        }`;\n      }\n    }\n\n    try {\n      logger.info('Registering agent with metadata');\n\n      const result = (await this.client.createAndRegisterAgent(\n        metadata\n      )) as unknown as HCS10RegistrationResult;\n\n      return this.processRegistrationResult(\n        result,\n        input,\n        profilePictureSource\n      );\n    } catch (error) {\n      return `Error: Failed to create/register agent \"${input.name}\". Reason: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n    }\n  }\n\n  /**\n   * Checks if the token fee configuration is valid\n   */\n  private hasValidTokenFee(tokenFee?: {\n    amount: number;\n    tokenId: string;\n  }): boolean {\n    return !!(\n      tokenFee &&\n      tokenFee.amount > 0 &&\n      tokenFee.tokenId &&\n      tokenFee.tokenId.trim() !== ''\n    );\n  }\n\n  /**\n   * Processes the registration result and returns formatted output\n   */\n  private async processRegistrationResult(\n    result: HCS10RegistrationResult,\n    input: z.infer<typeof this.schema>,\n    profilePictureSource: string = ''\n  ): Promise<string> {\n    const newAgentAccountId = result?.metadata?.accountId || '';\n    const inboundTopicId = result?.metadata?.inboundTopicId || '';\n    const outboundTopicId = result?.metadata?.outboundTopicId || '';\n    const profileTopicId = result?.metadata?.profileTopicId || '';\n    const privateKey = result?.metadata?.privateKey || '';\n    const pfpTopicId = result?.metadata?.pfpTopicId;\n\n    this.validateRegistrationResult(\n      newAgentAccountId,\n      inboundTopicId,\n      outboundTopicId,\n      privateKey\n    );\n\n    if (\n      this.stateManager &&\n      privateKey &&\n      newAgentAccountId &&\n      inboundTopicId &&\n      outboundTopicId &&\n      (input.setAsCurrent === undefined || input.setAsCurrent)\n    ) {\n      const agent = {\n        name: input.name,\n        accountId: newAgentAccountId,\n        inboundTopicId,\n        outboundTopicId,\n        profileTopicId,\n        privateKey,\n        pfpTopicId: pfpTopicId as string,\n      };\n\n      this.stateManager.setCurrentAgent(agent);\n\n      if (this.stateManager.persistAgentData && input.persistence) {\n        try {\n          const persistenceOptions: AgentPersistenceOptions = {\n            type: 'env-file',\n            prefix: input.persistence.prefix,\n          };\n\n          await this.stateManager.persistAgentData(agent, persistenceOptions);\n        } catch (error) {\n          Logger.getInstance().warn('Failed to persist agent data', error);\n        }\n      }\n    }\n\n    await this.ensureAgentHasFunds(newAgentAccountId, input.name);\n\n    const feeDescription = this.createFeeDescription(input);\n    const feeMessage = feeDescription\n      ? ` with ${feeDescription} fee on inbound topic`\n      : '';\n\n    const registrationDetails: AgentRegistrationDetails = {\n      success: true,\n      message: `Successfully registered agent '${input.name}'${feeMessage}.`,\n      name: input.name,\n      accountId: newAgentAccountId,\n      privateKey: privateKey,\n      inboundTopicId: inboundTopicId,\n      outboundTopicId: outboundTopicId,\n      profileTopicId: profileTopicId || 'N/A',\n      capabilities: input.capabilities || [AIAgentCapability.TEXT_GENERATION],\n      hasFees: !!(input.hbarFee || this.hasValidTokenFee(input.tokenFee)),\n      hbarFee: input.hbarFee || 0,\n      tokenFee: input.tokenFee || null,\n    };\n\n    if (pfpTopicId || profilePictureSource) {\n      registrationDetails.profilePicture = {\n        source: profilePictureSource,\n        topicId: pfpTopicId as string,\n      };\n    }\n\n    return JSON.stringify(registrationDetails);\n  }\n\n  /**\n   * Ensures the agent has enough HBAR for operations\n   */\n  private async ensureAgentHasFunds(\n    accountId: string,\n    agentName: string\n  ): Promise<void> {\n    try {\n      await ensureAgentHasEnoughHbar(\n        Logger.getInstance({\n          module: 'RegisterAgentTool',\n        }),\n        this.client.standardClient,\n        accountId,\n        agentName\n      );\n    } catch (error) {\n      Logger.getInstance().error('Failed to auto fund agent', error);\n    }\n  }\n\n  /**\n   * Validates that all required fields are present in the registration result\n   */\n  private validateRegistrationResult(\n    accountId?: string,\n    inboundTopicId?: string,\n    outboundTopicId?: string,\n    privateKey?: string\n  ): void {\n    if (!accountId || !inboundTopicId || !outboundTopicId || !privateKey) {\n      const missingFields = [\n        !accountId && 'accountId',\n        !inboundTopicId && 'inboundTopicId',\n        !outboundTopicId && 'outboundTopicId',\n        !privateKey && 'privateKey',\n      ]\n        .filter(Boolean)\n        .join(', ');\n      throw new Error(\n        `Registration failed. The HCS client returned incomplete details (Missing: ${missingFields}).`\n      );\n    }\n  }\n\n  /**\n   * Creates a description of the fees configured for the agent\n   */\n  private createFeeDescription(input: z.infer<typeof this.schema>): string {\n    const hasHbarFee = input.hbarFee && input.hbarFee > 0;\n    const hasTokenFee = this.hasValidTokenFee(input.tokenFee);\n    if (!hasHbarFee && !hasTokenFee) {\n      return '';\n    }\n\n    let description = '';\n    if (hasHbarFee) {\n      description += `${input.hbarFee} HBAR`;\n    }\n    if (hasTokenFee && input.tokenFee) {\n      const tokenFeeText = `${input.tokenFee.amount} of token ${input.tokenFee.tokenId}`;\n      description += description ? ` and ${tokenFeeText}` : tokenFeeText;\n    }\n    return description;\n  }\n}\n"],"names":["path","fs"],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es3.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.es4.js

@@ -1,84 +1,32 @@
-import { StructuredTool } from "@langchain/core/tools";
-import { z } from "zod";
-import { Logger } from "@hashgraphonline/standards-sdk";
-class SendMessageTool extends StructuredTool {
+import { BaseHederaTransactionTool, BaseHederaQueryTool } from "hedera-agent-kit";
+class BaseHCS10TransactionTool extends BaseHederaTransactionTool {
+  constructor(params) {
+    super(params);
+    this.namespace = "hcs10";
+    this.hcs10Builder = params.hcs10Builder;
+  }
   /**
-   * @param client - Instance of HCS10Client.
+   * Override to return the HCS10Builder
    */
-  constructor(client) {
-    super();
-    this.name = "send_message";
-    this.description = "Sends a message to a specified Hedera topic using HCS-10 and monitors for responses.";
-    this.lastProcessedTimestamp = 0;
-    this.schema = z.object({
-      topicId: z.string().describe("The Hedera topic ID to send the message to"),
-      message: z.string().describe("The message content to send"),
-      disableMonitoring: z.boolean().optional().describe("Whether to disable monitoring for responses")
-    });
-    this.client = client;
-    this.logger = Logger.getInstance({ module: "SendMessageTool" });
+  getServiceBuilder() {
+    return this.hcs10Builder;
+  }
+}
+class BaseHCS10QueryTool extends BaseHederaQueryTool {
+  constructor(params) {
+    super(params);
+    this.namespace = "hcs10";
+    this.hcs10Builder = params.hcs10Builder;
   }
   /**
-   * Calls sendMessage() with the provided parameters.
+   * Override to return the HCS10Builder
    */
-  async _call(input) {
-    try {
-      const result = await this.client.sendMessage(
-        input.topicId,
-        input.message
-      );
-      if (!result) {
-        throw new Error("Failed to send message");
-      }
-      this.logger.info(`Message sent with sequence number ${result}`);
-      if (!input.disableMonitoring) {
-        const response = await this.monitorResponses(input.topicId, result);
-        return `Successfully sent message to topic ${input.topicId}${response ? `
-Response: ${response}` : ""}`;
-      } else {
-        return `Successfully sent message to topic ${input.topicId}`;
-      }
-    } catch (error) {
-      throw new Error(
-        `Failed to send message: ${error instanceof Error ? error.message : String(error)}`
-      );
-    }
-  }
-  async monitorResponses(topicId, sequenceNumber) {
-    const maxAttempts = 10;
-    let attempts = 0;
-    while (attempts < maxAttempts) {
-      try {
-        const messages = await this.client.getMessageStream(topicId);
-        for (const message of messages.messages) {
-          if (message.created && message.created.getTime() > this.lastProcessedTimestamp) {
-            this.lastProcessedTimestamp = message.created.getTime();
-            const content = await this.client.getMessageContent(message.data || "");
-            let parsedContent;
-            try {
-              parsedContent = JSON.parse(content);
-            } catch (error) {
-              this.logger.error(`Error parsing message content: ${error}`);
-              continue;
-            }
-            if (message.sequence_number > sequenceNumber) {
-              if (parsedContent && typeof parsedContent.data === "string") {
-                return parsedContent.data;
-              }
-              return JSON.stringify(parsedContent);
-            }
-          }
-        }
-      } catch (error) {
-        this.logger.error(`Error monitoring responses: ${error}`);
-      }
-      attempts++;
-      await new Promise((resolve) => setTimeout(resolve, 1e3));
-    }
-    return null;
+  getServiceBuilder() {
+    return this.hcs10Builder;
   }
 }
 export {
-  SendMessageTool
+  BaseHCS10QueryTool,
+  BaseHCS10TransactionTool
 };
 //# sourceMappingURL=standards-agent-kit.es4.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es4.js","sources":["../../src/tools/SendMessageTool.ts"],"sourcesContent":["import { HCS10Client } from '../hcs10/HCS10Client';\nimport { StructuredTool } from '@langchain/core/tools';\nimport { z } from 'zod';\nimport { Logger } from '@hashgraphonline/standards-sdk';\n\n/**\n * SendMessageTool wraps the sendMessage() function of HCS10Client.\n * It sends a message to a specified Hedera topic and monitors for responses.\n */\nexport class SendMessageTool extends StructuredTool {\n  name = 'send_message';\n  description =\n    'Sends a message to a specified Hedera topic using HCS-10 and monitors for responses.';\n  private client: HCS10Client;\n  private lastProcessedTimestamp: number = 0;\n  private logger: Logger;\n\n  schema = z.object({\n    topicId: z.string().describe('The Hedera topic ID to send the message to'),\n    message: z.string().describe('The message content to send'),\n    disableMonitoring: z\n      .boolean()\n      .optional()\n      .describe('Whether to disable monitoring for responses'),\n  });\n\n  /**\n   * @param client - Instance of HCS10Client.\n   */\n  constructor(client: HCS10Client) {\n    super();\n    this.client = client;\n    this.logger = Logger.getInstance({ module: 'SendMessageTool' });\n  }\n\n  /**\n   * Calls sendMessage() with the provided parameters.\n   */\n  async _call(input: {\n    topicId: string;\n    message: string;\n    disableMonitoring: boolean;\n  }): Promise<string> {\n    try {\n      const result = await this.client.sendMessage(\n        input.topicId,\n        input.message\n      );\n      if (!result) {\n        throw new Error('Failed to send message');\n      }\n      this.logger.info(`Message sent with sequence number ${result}`);\n      if (!input.disableMonitoring) {\n        const response = await this.monitorResponses(input.topicId, result);\n        return `Successfully sent message to topic ${input.topicId}${\n          response ? `\\nResponse: ${response}` : ''\n        }`;\n      } else {\n        return `Successfully sent message to topic ${input.topicId}`;\n      }\n    } catch (error) {\n      throw new Error(\n        `Failed to send message: ${\n          error instanceof Error ? error.message : String(error)\n        }`\n      );\n    }\n  }\n\n  private async monitorResponses(\n    topicId: string,\n    sequenceNumber: number\n  ): Promise<string | null> {\n    const maxAttempts = 10;\n    let attempts = 0;\n\n    while (attempts < maxAttempts) {\n      try {\n        const messages = await this.client.getMessageStream(topicId);\n\n        for (const message of messages.messages) {\n          if (\n            message.created &&\n            message.created.getTime() > this.lastProcessedTimestamp\n          ) {\n            this.lastProcessedTimestamp = message.created.getTime();\n\n            const content = await this.client.getMessageContent(message.data || '');\n\n            let parsedContent;\n            try {\n              parsedContent = JSON.parse(content);\n            } catch (error) {\n              this.logger.error(`Error parsing message content: ${error}`);\n              continue;\n            }\n            if (message.sequence_number > sequenceNumber) {\n              // Unwrap nested data field if present\n              if (parsedContent && typeof parsedContent.data === 'string') {\n                return parsedContent.data;\n              }\n              return JSON.stringify(parsedContent);\n            }\n          }\n        }\n      } catch (error) {\n        this.logger.error(`Error monitoring responses: ${error}`);\n      }\n\n      attempts++;\n      await new Promise((resolve) => setTimeout(resolve, 1000));\n    }\n\n    return null;\n  }\n}\n"],"names":[],"mappings":";;;AASO,MAAM,wBAAwB,eAAe;AAAA;AAAA;AAAA;AAAA,EAoBlD,YAAY,QAAqB;AACzB,UAAA;AApBD,SAAA,OAAA;AAEL,SAAA,cAAA;AAEF,SAAQ,yBAAiC;AAGzC,SAAA,SAAS,EAAE,OAAO;AAAA,MAChB,SAAS,EAAE,SAAS,SAAS,4CAA4C;AAAA,MACzE,SAAS,EAAE,SAAS,SAAS,6BAA6B;AAAA,MAC1D,mBAAmB,EAChB,QAAA,EACA,SAAS,EACT,SAAS,6CAA6C;AAAA,IAAA,CAC1D;AAOC,SAAK,SAAS;AACd,SAAK,SAAS,OAAO,YAAY,EAAE,QAAQ,mBAAmB;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA,EAMhE,MAAM,MAAM,OAIQ;AACd,QAAA;AACI,YAAA,SAAS,MAAM,KAAK,OAAO;AAAA,QAC/B,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AACA,UAAI,CAAC,QAAQ;AACL,cAAA,IAAI,MAAM,wBAAwB;AAAA,MAAA;AAE1C,WAAK,OAAO,KAAK,qCAAqC,MAAM,EAAE;AAC1D,UAAA,CAAC,MAAM,mBAAmB;AAC5B,cAAM,WAAW,MAAM,KAAK,iBAAiB,MAAM,SAAS,MAAM;AAClE,eAAO,sCAAsC,MAAM,OAAO,GACxD,WAAW;AAAA,YAAe,QAAQ,KAAK,EACzC;AAAA,MAAA,OACK;AACE,eAAA,sCAAsC,MAAM,OAAO;AAAA,MAAA;AAAA,aAErD,OAAO;AACd,YAAM,IAAI;AAAA,QACR,2BACE,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CACvD;AAAA,MACF;AAAA,IAAA;AAAA,EACF;AAAA,EAGF,MAAc,iBACZ,SACA,gBACwB;AACxB,UAAM,cAAc;AACpB,QAAI,WAAW;AAEf,WAAO,WAAW,aAAa;AACzB,UAAA;AACF,cAAM,WAAW,MAAM,KAAK,OAAO,iBAAiB,OAAO;AAEhD,mBAAA,WAAW,SAAS,UAAU;AACvC,cACE,QAAQ,WACR,QAAQ,QAAQ,QAAQ,IAAI,KAAK,wBACjC;AACK,iBAAA,yBAAyB,QAAQ,QAAQ,QAAQ;AAEtD,kBAAM,UAAU,MAAM,KAAK,OAAO,kBAAkB,QAAQ,QAAQ,EAAE;AAElE,gBAAA;AACA,gBAAA;AACc,8BAAA,KAAK,MAAM,OAAO;AAAA,qBAC3B,OAAO;AACd,mBAAK,OAAO,MAAM,kCAAkC,KAAK,EAAE;AAC3D;AAAA,YAAA;AAEE,gBAAA,QAAQ,kBAAkB,gBAAgB;AAE5C,kBAAI,iBAAiB,OAAO,cAAc,SAAS,UAAU;AAC3D,uBAAO,cAAc;AAAA,cAAA;AAEhB,qBAAA,KAAK,UAAU,aAAa;AAAA,YAAA;AAAA,UACrC;AAAA,QACF;AAAA,eAEK,OAAO;AACd,aAAK,OAAO,MAAM,+BAA+B,KAAK,EAAE;AAAA,MAAA;AAG1D;AACA,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,GAAI,CAAC;AAAA,IAAA;AAGnD,WAAA;AAAA,EAAA;AAEX;"}
+{"version":3,"file":"standards-agent-kit.es4.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    Record<string, unknown>,\n    Record<string, unknown>\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,2BAQZ,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;"}

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

@@ -1,168 +1,141 @@
-import { StructuredTool } from "@langchain/core/tools";
+import { AIAgentCapability } from "@hashgraphonline/standards-sdk";
 import { z } from "zod";
-import { Logger } from "@hashgraphonline/standards-sdk";
-class ConnectionTool extends StructuredTool {
-  /**
-   * @param client - Instance of HCS10Client.
-   * @param stateManager - Instance of StateManager for shared state management.
-   */
-  constructor({ client, stateManager, ...rest }) {
-    super(rest);
-    this.name = "monitor_connections";
-    this.description = "Starts passively LISTENING on the current agent's own inbound topic for INCOMING HCS-10 connection requests. Handles received requests automatically. Takes NO arguments. DO NOT use this to start a new connection TO someone else.";
-    this.isMonitoring = false;
-    this.monitoringTopic = null;
-    this.schema = z.object({});
-    this.client = client;
-    this.stateManager = stateManager;
-    this.logger = Logger.getInstance({
-      module: "ConnectionTool",
-      level: "info"
-    });
+import { BaseHCS10TransactionTool } from "./standards-agent-kit.es4.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().describe("Optional custom username/alias for the agent"),
+  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.array(z.nativeEnum(AIAgentCapability)).optional().describe("Array of agent capabilities (default: [TEXT_GENERATION])"),
+  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 {
+  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. Note: This tool requires multiple transactions and cannot be used in returnBytes mode.";
+    this.specificInputSchema = RegisterAgentZodSchema;
+    this.neverScheduleThisTool = true;
+    this.requiresMultipleTransactions = true;
   }
-  /**
-   * Initiates the connection request monitoring process in the background.
-   * Gets the inbound topic ID from the configured client.
-   */
-  async _call() {
-    let inboundTopicId;
-    try {
-      inboundTopicId = await this.client.getInboundTopicId();
-    } catch (error) {
-      const errorMsg = `Error getting inbound topic ID for monitoring: ${error instanceof Error ? error.message : String(error)}`;
-      this.logger.error(errorMsg);
-      return errorMsg;
+  async callBuilderMethod(builder, specificArgs) {
+    const hcs10Builder = builder;
+    const params = {
+      name: specificArgs.name
+    };
+    if (specificArgs.description !== void 0) {
+      params.bio = specificArgs.description;
     }
-    if (!inboundTopicId) {
-      return "Error: Could not determine the inbound topic ID for the current agent.";
+    if (specificArgs.alias !== void 0) {
+      params.alias = specificArgs.alias;
     }
-    if (this.isMonitoring) {
-      if (this.monitoringTopic === inboundTopicId) {
-        return `Already monitoring topic ${inboundTopicId}.`;
-      } else {
-        return `Error: Already monitoring a different topic (${this.monitoringTopic}). Stop the current monitor first.`;
-      }
+    if (specificArgs.type !== void 0) {
+      params.type = specificArgs.type;
     }
-    this.isMonitoring = true;
-    this.monitoringTopic = inboundTopicId;
-    this.logger.info(
-      `Initiating connection request monitoring for topic ${inboundTopicId}...`
-    );
-    this.monitorIncomingRequests(inboundTopicId).catch((error) => {
-      this.logger.error(
-        `Monitoring loop for ${inboundTopicId} encountered an unrecoverable error:`,
-        error
-      );
-      this.isMonitoring = false;
-      this.monitoringTopic = null;
-    });
-    return `Started monitoring inbound topic ${inboundTopicId} for connection requests in the background.`;
-  }
-  /**
-   * The core monitoring loop.
-   */
-  async monitorIncomingRequests(inboundTopicId) {
-    this.logger.info(`Monitoring inbound topic ${inboundTopicId}...`);
-    let lastProcessedMessageSequence = 0;
-    const processedRequestIds = /* @__PURE__ */ new Set();
-    while (this.isMonitoring && this.monitoringTopic === inboundTopicId) {
-      try {
-        const messagesResult = await this.client.getMessages(inboundTopicId);
-        const allMessages = messagesResult.messages;
-        const connectionRequests = allMessages.filter(
-          (msg) => msg.op === "connection_request" && typeof msg.sequence_number === "number"
-          // Keep filtering by sequence number if needed, or remove if checking existing confirmations is sufficient
-          // msg.sequence_number > lastProcessedMessageSequence // Temporarily remove or adjust this if checking confirmations is the primary method
-        );
-        for (const message of connectionRequests) {
-          lastProcessedMessageSequence = Math.max(
-            lastProcessedMessageSequence,
-            message.sequence_number || 0
-            // Use 0 if sequence_number is undefined (though filter should prevent this)
-          );
-          const connectionRequestId = message.sequence_number;
-          if (!connectionRequestId) {
-            continue;
-          }
-          const alreadyHandled = allMessages.some(
-            (m) => m.op === "connection_created" && m.connection_id === connectionRequestId
-          );
-          if (alreadyHandled) {
-            this.logger.debug(
-              `Connection request #${connectionRequestId} already handled (found connection_created). Skipping.`
-            );
-            continue;
-          }
-          const senderOperatorId = message.operator_id || "";
-          const requestingAccountId = senderOperatorId.split("@")[1] || null;
-          if (!requestingAccountId) {
-            this.logger.warn(
-              `Could not determine requesting account ID from operator_id '${senderOperatorId}' for request #${connectionRequestId}. Skipping.`
-            );
-            continue;
-          }
-          if (processedRequestIds.has(connectionRequestId)) {
-            this.logger.info(
-              `Connection request #${connectionRequestId} already processed in this session. Skipping.`
-            );
-            continue;
-          }
-          this.logger.info(
-            `Processing connection request #${connectionRequestId} from account ${requestingAccountId}...`
-          );
-          try {
-            const confirmation = await this.client.handleConnectionRequest(
-              inboundTopicId,
-              requestingAccountId,
-              connectionRequestId
-            );
-            processedRequestIds.add(connectionRequestId);
-            this.logger.info(
-              `Connection confirmed for request #${connectionRequestId}. New connection topic: ${confirmation.connectionTopicId}`
-            );
-            const newConnection = {
-              targetAccountId: requestingAccountId,
-              targetAgentName: `Agent ${requestingAccountId}`,
-              targetInboundTopicId: "N/A",
-              connectionTopicId: confirmation.connectionTopicId
-            };
-            this.stateManager.addActiveConnection(newConnection);
-            this.logger.info(
-              `Added new active connection to ${requestingAccountId} state.`
-            );
-          } catch (handleError) {
-            this.logger.error(
-              `Error handling connection request #${connectionRequestId} from ${requestingAccountId}:`,
-              handleError
-            );
-          }
+    if (specificArgs.model !== void 0) {
+      params.model = specificArgs.model;
+    }
+    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;
         }
-      } catch (error) {
-        this.logger.error(
-          `Error fetching or processing messages for topic ${inboundTopicId}:`,
-          error
-        );
+        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;
       }
-      await new Promise((resolve) => setTimeout(resolve, 5e3));
     }
-    this.logger.info(`Monitoring loop stopped for topic ${inboundTopicId}.`);
-    this.isMonitoring = false;
-    this.monitoringTopic = null;
-  }
-  // Optional: Method to explicitly stop monitoring
-  stopMonitoring() {
-    if (this.isMonitoring) {
-      this.logger.info(
-        `Stopping monitoring for topic ${this.monitoringTopic}...`
-      );
-      this.isMonitoring = false;
-      this.monitoringTopic = null;
-    } else {
-      this.logger.info("Monitor is not currently running.");
+    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);
   }
 }
 export {
-  ConnectionTool
+  RegisterAgentTool
 };
 //# sourceMappingURL=standards-agent-kit.es5.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-agent-kit.es5.js","sources":["../../src/tools/ConnectionTool.ts"],"sourcesContent":["import { HCS10Client } from '../hcs10/HCS10Client';\nimport { StructuredTool, ToolParams } from '@langchain/core/tools';\nimport { z } from 'zod';\n// Import FeeConfigBuilder if needed for explicit fee handling\n// import { FeeConfigBuilder } from '@hashgraphonline/standards-sdk';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport {\n  IStateManager,\n  ActiveConnection,\n} from '../state/state-types'; // Corrected import path/name\n\nexport interface ConnectionToolParams extends ToolParams {\n  client: HCS10Client;\n  stateManager: IStateManager;\n}\n\n/**\n * ConnectionTool monitors the *current* agent's inbound topic for connection requests\n * and automatically handles them using the HCS-10 standard SDK flow.\n * Use this ONLY to passively LISTEN for other agents trying to connect TO YOU.\n * This tool takes NO arguments and does NOT start outgoing connections.\n */\nexport class ConnectionTool extends StructuredTool {\n  name = 'monitor_connections';\n  description =\n    \"Starts passively LISTENING on the current agent's own inbound topic for INCOMING HCS-10 connection requests. Handles received requests automatically. Takes NO arguments. DO NOT use this to start a new connection TO someone else.\";\n  public client: HCS10Client;\n  public logger: Logger;\n  private stateManager: IStateManager; // Renamed property\n  private isMonitoring: boolean = false; // Flag to prevent multiple monitors\n  private monitoringTopic: string | null = null;\n\n  // Schema now takes NO arguments\n  schema = z.object({});\n\n  /**\n   * @param client - Instance of HCS10Client.\n   * @param stateManager - Instance of StateManager for shared state management.\n   */\n  constructor({ client, stateManager, ...rest }: ConnectionToolParams) {\n    super(rest);\n    this.client = client;\n    this.stateManager = stateManager; // Renamed assignment\n    this.logger = Logger.getInstance({\n      module: 'ConnectionTool',\n      level: 'info',\n    });\n  }\n\n  /**\n   * Initiates the connection request monitoring process in the background.\n   * Gets the inbound topic ID from the configured client.\n   */\n  async _call(/* _input: z.infer<typeof this.schema> */): Promise<string> {\n    // Get inboundTopicId from the client\n    let inboundTopicId: string;\n    try {\n      // Assuming getInboundTopicId() is implemented and available\n      inboundTopicId = await this.client.getInboundTopicId();\n    } catch (error) {\n      const errorMsg = `Error getting inbound topic ID for monitoring: ${\n        error instanceof Error ? error.message : String(error)\n      }`;\n      this.logger.error(errorMsg);\n      return errorMsg;\n    }\n\n    if (!inboundTopicId) {\n      return 'Error: Could not determine the inbound topic ID for the current agent.';\n    }\n\n    if (this.isMonitoring) {\n      if (this.monitoringTopic === inboundTopicId) {\n        return `Already monitoring topic ${inboundTopicId}.`;\n      } else {\n        return `Error: Already monitoring a different topic (${this.monitoringTopic}). Stop the current monitor first.`;\n        // TODO: Add a mechanism to stop the monitor if needed.\n      }\n    }\n\n    this.isMonitoring = true;\n    this.monitoringTopic = inboundTopicId;\n    this.logger.info(\n      `Initiating connection request monitoring for topic ${inboundTopicId}...`\n    );\n\n    // Start the monitoring process asynchronously without awaiting it\n    // This allows the tool call to return quickly.\n    this.monitorIncomingRequests(inboundTopicId).catch((error) => {\n      this.logger.error(\n        `Monitoring loop for ${inboundTopicId} encountered an unrecoverable error:`,\n        error\n      );\n      this.isMonitoring = false; // Reset flag on loop failure\n      this.monitoringTopic = null;\n    });\n\n    return `Started monitoring inbound topic ${inboundTopicId} for connection requests in the background.`;\n  }\n\n  /**\n   * The core monitoring loop.\n   */\n  private async monitorIncomingRequests(inboundTopicId: string): Promise<void> {\n    this.logger.info(`Monitoring inbound topic ${inboundTopicId}...`);\n\n    let lastProcessedMessageSequence = 0;\n    const processedRequestIds = new Set<number>(); // Track processed requests within this monitoring session\n\n    // Main monitoring loop\n    while (this.isMonitoring && this.monitoringTopic === inboundTopicId) {\n      try {\n        const messagesResult = await this.client.getMessages(inboundTopicId);\n\n        const allMessages = messagesResult.messages;\n\n        const connectionRequests = allMessages.filter(\n          (msg) =>\n            msg.op === 'connection_request' &&\n            typeof msg.sequence_number === 'number' // Keep filtering by sequence number if needed, or remove if checking existing confirmations is sufficient\n            // msg.sequence_number > lastProcessedMessageSequence // Temporarily remove or adjust this if checking confirmations is the primary method\n        );\n\n        for (const message of connectionRequests) {\n          // Update lastProcessedMessageSequence regardless of handling outcome to avoid re-checking handled/skipped messages in future loops\n          lastProcessedMessageSequence = Math.max(\n            lastProcessedMessageSequence,\n            message.sequence_number || 0 // Use 0 if sequence_number is undefined (though filter should prevent this)\n          );\n\n          const connectionRequestId = message.sequence_number;\n          if (!connectionRequestId) {\n             continue; // Skip if sequence number is missing\n          }\n\n          // --- Check if already handled ---\n          const alreadyHandled = allMessages.some(\n            (m) => m.op === 'connection_created' && m.connection_id === connectionRequestId\n          );\n\n          if (alreadyHandled) {\n            this.logger.debug(\n              `Connection request #${connectionRequestId} already handled (found connection_created). Skipping.`\n            );\n            continue; // Skip to the next request\n          }\n          // --- End Check ---\n\n          // Extract requesting account ID from the message's operator_id field (topic@account)\n          const senderOperatorId = message.operator_id || '';\n          const requestingAccountId = senderOperatorId.split('@')[1] || null;\n\n          if (!requestingAccountId) {\n            this.logger.warn(\n              `Could not determine requesting account ID from operator_id '${senderOperatorId}' for request #${connectionRequestId}. Skipping.`\n            );\n            continue;\n          }\n\n          if (processedRequestIds.has(connectionRequestId)) {\n            this.logger.info(\n              `Connection request #${connectionRequestId} already processed in this session. Skipping.`\n            );\n            continue;\n          }\n\n          this.logger.info(\n            `Processing connection request #${connectionRequestId} from account ${requestingAccountId}...`\n          );\n\n          try {\n            // Handle the connection request using the HCS10Client wrapper\n            const confirmation = await this.client.handleConnectionRequest(\n              inboundTopicId,\n              requestingAccountId,\n              connectionRequestId\n            );\n\n            processedRequestIds.add(connectionRequestId);\n            this.logger.info(\n              `Connection confirmed for request #${connectionRequestId}. New connection topic: ${confirmation.connectionTopicId}`\n            );\n\n            // Use stateManager to add connection\n            const newConnection: ActiveConnection = {\n              targetAccountId: requestingAccountId,\n              targetAgentName: `Agent ${requestingAccountId}`,\n              targetInboundTopicId: 'N/A',\n              connectionTopicId: confirmation.connectionTopicId,\n            };\n            this.stateManager.addActiveConnection(newConnection);\n            this.logger.info(\n              `Added new active connection to ${requestingAccountId} state.`\n            );\n          } catch (handleError) {\n            this.logger.error(\n              `Error handling connection request #${connectionRequestId} from ${requestingAccountId}:`,\n              handleError\n            );\n          }\n        }\n      } catch (error) {\n        this.logger.error(\n          `Error fetching or processing messages for topic ${inboundTopicId}:`,\n          error\n        );\n        // Implement backoff or error threshold if needed\n      }\n\n      // Wait before the next poll\n      await new Promise((resolve) => setTimeout(resolve, 5000)); // Poll every 5 seconds (adjust as needed)\n    }\n\n    this.logger.info(`Monitoring loop stopped for topic ${inboundTopicId}.`);\n    this.isMonitoring = false; // Ensure flag is reset when loop exits\n    this.monitoringTopic = null;\n  }\n\n  // Optional: Method to explicitly stop monitoring\n  public stopMonitoring(): void {\n    if (this.isMonitoring) {\n      this.logger.info(\n        `Stopping monitoring for topic ${this.monitoringTopic}...`\n      );\n      this.isMonitoring = false;\n      this.monitoringTopic = null;\n    } else {\n      this.logger.info('Monitor is not currently running.');\n    }\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-agent-kit.es5.js","sources":["../../src/tools/hcs10/RegisterAgentTool.ts"],"sourcesContent":["import { AIAgentCapability } from '@hashgraphonline/standards-sdk';\nimport { z } from 'zod';\nimport { BaseServiceBuilder } from 'hedera-agent-kit';\nimport { HCS10Builder, RegisterAgentParams } from '../../builders/hcs10/hcs10-builder';\nimport { BaseHCS10TransactionTool } from './base-hcs10-tools';\nimport { HCS10TransactionToolParams } from './hcs10-tool-params';\n\nconst RegisterAgentZodSchema = z.object({\n  name: z\n    .string()\n    .min(1)\n    .max(50)\n    .describe('A unique name for the agent (1-50 characters)'),\n  description: z\n    .string()\n    .max(500)\n    .optional()\n    .describe('Optional bio description for the agent (max 500 characters)'),\n  alias: z\n    .string()\n    .optional()\n    .describe('Optional custom username/alias for the agent'),\n  type: z\n    .enum(['autonomous', 'manual'])\n    .optional()\n    .describe('Agent type (default: autonomous)'),\n  model: z\n    .string()\n    .optional()\n    .describe('AI model identifier (default: agent-model-2024)'),\n  capabilities: z\n    .array(z.nativeEnum(AIAgentCapability))\n    .optional()\n    .describe('Array of agent capabilities (default: [TEXT_GENERATION])'),\n  creator: z.string().optional().describe('Creator attribution for the agent'),\n  socials: z\n    .record(\n      z.enum([\n        'twitter',\n        'github',\n        'discord',\n        'telegram',\n        'linkedin',\n        'youtube',\n        'website',\n        'x',\n      ] as const),\n      z.string()\n    )\n    .optional()\n    .describe(\n      'Social media links (e.g., {\"twitter\": \"@handle\", \"discord\": \"username\"})'\n    ),\n  properties: z\n    .record(z.unknown())\n    .optional()\n    .describe('Custom metadata properties for the agent'),\n  profilePicture: z\n    .union([\n      z.string().describe('URL or local file path to profile picture'),\n      z.object({\n        url: z.string().optional(),\n        path: z.string().optional(),\n        filename: z.string().optional(),\n      }),\n    ])\n    .optional()\n    .describe(\n      'Optional profile picture as URL, file path, or object with url/path/filename'\n    ),\n  existingProfilePictureTopicId: z\n    .string()\n    .optional()\n    .describe(\n      'Topic ID of an existing profile picture to reuse (e.g., 0.0.12345)'\n    ),\n  initialBalance: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional initial HBAR balance for the new agent account (will create new account if provided)'\n    ),\n  userAccountId: z\n    .string()\n    .optional()\n    .describe(\n      'Optional account ID (e.g., 0.0.12345) to use as the agent account instead of creating a new one'\n    ),\n  hbarFee: z\n    .number()\n    .positive()\n    .optional()\n    .describe(\n      'Optional HBAR fee amount to charge per message on the inbound topic'\n    ),\n  tokenFees: z\n    .array(\n      z.object({\n        amount: z.number().positive(),\n        tokenId: z.string(),\n      })\n    )\n    .optional()\n    .describe('Optional token fees to charge per message'),\n  exemptAccountIds: z\n    .array(z.string())\n    .optional()\n    .describe('Optional account IDs to exempt from fees'),\n  setAsCurrent: z\n    .boolean()\n    .optional()\n    .describe('Whether to set as current agent (default: true)'),\n  persistence: z\n    .object({\n      prefix: z.string().optional(),\n    })\n    .optional()\n    .describe('Optional persistence configuration'),\n});\n\nexport class RegisterAgentTool extends BaseHCS10TransactionTool<\n  typeof RegisterAgentZodSchema\n> {\n  name = 'register_agent';\n  description =\n    'Creates and registers the AI agent on the Hedera network. Returns JSON string with agent details (accountId, privateKey, topics) on success. Note: This tool requires multiple transactions and cannot be used in returnBytes mode.';\n  specificInputSchema = RegisterAgentZodSchema;\n\n  constructor(params: HCS10TransactionToolParams) {\n    super(params);\n    this.neverScheduleThisTool = true;\n    this.requiresMultipleTransactions = true;\n  }\n\n  protected async callBuilderMethod(\n    builder: BaseServiceBuilder,\n    specificArgs: z.infer<typeof RegisterAgentZodSchema>\n  ): Promise<void> {\n    const hcs10Builder = builder as HCS10Builder;\n\n    const params: RegisterAgentParams = {\n      name: specificArgs.name,\n    };\n\n    if (specificArgs.description !== undefined) {\n      params.bio = specificArgs.description;\n    }\n    if (specificArgs.alias !== undefined) {\n      params.alias = specificArgs.alias;\n    }\n    if (specificArgs.type !== undefined) {\n      params.type = specificArgs.type;\n    }\n    if (specificArgs.model !== undefined) {\n      params.model = specificArgs.model;\n    }\n    if (specificArgs.capabilities !== undefined) {\n      params.capabilities = specificArgs.capabilities;\n    }\n    if (specificArgs.creator !== undefined) {\n      params.creator = specificArgs.creator;\n    }\n    if (specificArgs.socials !== undefined) {\n      params.socials = specificArgs.socials;\n    }\n    if (specificArgs.properties !== undefined) {\n      params.properties = specificArgs.properties;\n    }\n    if (specificArgs.profilePicture !== undefined) {\n      if (typeof specificArgs.profilePicture === 'string') {\n        params.profilePicture = specificArgs.profilePicture;\n      } else {\n        const profilePicObj: {\n          url?: string;\n          path?: string;\n          filename?: string;\n        } = {};\n        if (specificArgs.profilePicture.url !== undefined) {\n          profilePicObj.url = specificArgs.profilePicture.url;\n        }\n        if (specificArgs.profilePicture.path !== undefined) {\n          profilePicObj.path = specificArgs.profilePicture.path;\n        }\n        if (specificArgs.profilePicture.filename !== undefined) {\n          profilePicObj.filename = specificArgs.profilePicture.filename;\n        }\n        params.profilePicture = profilePicObj;\n      }\n    }\n    if (specificArgs.existingProfilePictureTopicId !== undefined) {\n      params.existingProfilePictureTopicId =\n        specificArgs.existingProfilePictureTopicId;\n    }\n    if (specificArgs.userAccountId !== undefined) {\n      params.userAccountId = specificArgs.userAccountId;\n    }\n    if (specificArgs.hbarFee !== undefined) {\n      params.hbarFee = specificArgs.hbarFee;\n    }\n    if (specificArgs.tokenFees !== undefined) {\n      params.tokenFees = specificArgs.tokenFees;\n    }\n    if (specificArgs.exemptAccountIds !== undefined) {\n      params.exemptAccountIds = specificArgs.exemptAccountIds;\n    }\n    if (specificArgs.initialBalance !== undefined) {\n      params.initialBalance = specificArgs.initialBalance;\n    }\n\n    await hcs10Builder.registerAgent(params);\n  }\n}"],"names":[],"mappings":"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"}