@hashgraphonline/conversational-agent 0.2.201 → 0.2.203

package/dist/esm/index6.js.map

@@ -1 +1 @@
-{"version":3,"file":"index6.js","sources":["../../src/conversational-agent.ts"],"sourcesContent":["import {\n  ServerSigner,\n  getAllHederaCorePlugins,\n  BasePlugin,\n  AbstractSigner,\n} from 'hedera-agent-kit';\nimport { Logger, type NetworkType } from '@hashgraphonline/standards-sdk';\nimport { createAgent } from './agent-factory';\nimport BrowserSigner from './signers/browser-signer';\nimport { LangChainProvider } from './providers';\nimport type { ChatResponse, ConversationContext } from './base-agent';\nimport { ChatOpenAI } from '@langchain/openai';\nimport { ChatAnthropic } from '@langchain/anthropic';\nimport {\n  HumanMessage,\n  AIMessage,\n  SystemMessage,\n} from '@langchain/core/messages';\nimport type { AgentOperationalMode, MirrorNodeConfig } from 'hedera-agent-kit';\nimport { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';\nimport { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';\nimport { InscribePlugin } from './plugins/inscribe/InscribePlugin';\nimport { getWalletBridgeProvider } from './runtime/wallet-bridge';\nimport {\n  InscriberBuilder,\n  SignerProviderRegistry,\n} from '@hashgraphonline/standards-agent-kit';\nimport { HbarPlugin } from './plugins/hbar/HbarPlugin';\nimport { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';\nimport type { IStateManager } from '@hashgraphonline/standards-agent-kit';\nimport { getSystemMessage } from './config/system-message';\nimport type { MCPServerConfig, MCPConnectionStatus } from './mcp/types';\nimport { ContentStoreManager } from './services/content-store-manager';\nimport { SmartMemoryManager, type SmartMemoryConfig } from './memory';\nimport {\n  createEntityTools,\n  ResolveEntitiesTool,\n  ExtractEntitiesTool,\n} from './tools/entity-resolver-tool';\nimport type { FormSubmission } from './forms/types';\nimport { ParameterService } from './services/parameter-service';\nimport { FormatConverterRegistry } from './services/formatters/format-converter-registry';\nimport { TopicIdToHrlConverter } from './services/formatters/converters/topic-id-to-hrl-converter';\nimport { StringNormalizationConverter } from './services/formatters/converters/string-normalization-converter';\n\nexport type ToolDescriptor = {\n  name: string;\n  namespace?: string;\n};\n\nexport type ChatHistoryItem = {\n  type: 'human' | 'ai' | 'system';\n  content: string;\n};\n\nexport type AgentInstance = ReturnType<typeof createAgent>;\n\nexport type MirrorNetwork = 'testnet' | 'mainnet' | 'previewnet';\n\nconst DEFAULT_MODEL_NAME = 'gpt-4o';\nconst DEFAULT_OPENAI_MODEL = 'gpt-4o-mini';\nconst DEFAULT_OPENROUTER_MODEL = 'openai/gpt-4o-mini';\nconst DEFAULT_CLAUDE_MODEL = 'claude-3-7-sonnet-latest';\nconst DEFAULT_TEMPERATURE = 0.1;\nconst DEFAULT_NETWORK = 'testnet';\nconst DEFAULT_OPERATIONAL_MODE: AgentOperationalMode = 'autonomous';\n\nexport interface ConversationalAgentOptions {\n  accountId: string;\n  privateKey: string;\n  network?: NetworkType;\n  openAIApiKey: string;\n  openAIModelName?: string;\n  llmProvider?: 'openai' | 'anthropic' | 'openrouter';\n  verbose?: boolean;\n  operationalMode?: AgentOperationalMode;\n  userAccountId?: string;\n  customSystemMessagePreamble?: string;\n  customSystemMessagePostamble?: string;\n  additionalPlugins?: BasePlugin[];\n  stateManager?: IStateManager;\n  scheduleUserTransactionsInBytesMode?: boolean;\n  mirrorNodeConfig?: MirrorNodeConfig;\n  disableLogging?: boolean;\n  enabledPlugins?: string[];\n  toolFilter?: (tool: { name: string; namespace?: string }) => boolean;\n  mcpServers?: MCPServerConfig[];\n  walletExecutor?: (\n    base64: string,\n    network: 'mainnet' | 'testnet'\n  ) => Promise<{ transactionId: string }>;\n  /** Optional: provide a signer factory to override default signer selection */\n  customSignerFactory?: (args: {\n    operationalMode: AgentOperationalMode;\n    accountId: string;\n    network: NetworkType;\n  }) => AbstractSigner;\n\n  /** Enable automatic entity memory functionality (default: true) */\n  entityMemoryEnabled?: boolean;\n\n  /** Configuration for entity memory system */\n  entityMemoryConfig?: SmartMemoryConfig;\n\n  /**\n   * Provider used for entity extraction/resolution tools (defaults to llmProvider or 'openai')\n   */\n  entityMemoryProvider?: 'openai' | 'anthropic' | 'openrouter';\n\n  /**\n   * Model name for entity extraction/resolution tools (defaults per provider)\n   */\n  entityMemoryModelName?: string;\n\n  openRouterApiKey?: string;\n  openRouterBaseURL?: string;\n}\n\n/**\n * The ConversationalAgent class is an optional wrapper around the HederaConversationalAgent class,\n * which includes the OpenConvAIPlugin and the OpenConvaiState by default.\n * If you want to use a different plugin or state manager, you can pass them in the options.\n * This class is not required and the plugin can be used directly with the HederaConversationalAgent class.\n *\n * @param options - The options for the ConversationalAgent.\n * @returns A new instance of the ConversationalAgent class.\n */\nexport class ConversationalAgent {\n  private static readonly NOT_INITIALIZED_ERROR =\n    'Agent not initialized. Call initialize() first.';\n  protected agent?: AgentInstance;\n  public hcs10Plugin: HCS10Plugin;\n  public hcs2Plugin: HCS2Plugin;\n  public inscribePlugin: InscribePlugin;\n  public hbarPlugin: HbarPlugin;\n  public stateManager: IStateManager;\n  private options: ConversationalAgentOptions;\n  public logger: Logger;\n  public contentStoreManager?: ContentStoreManager;\n  public memoryManager?: SmartMemoryManager | undefined;\n  private entityTools?: {\n    resolveEntities: ResolveEntitiesTool;\n    extractEntities: ExtractEntitiesTool;\n  };\n\n  constructor(options: ConversationalAgentOptions) {\n    this.options = options;\n    this.stateManager = options.stateManager || new OpenConvaiState();\n    this.hcs10Plugin = new HCS10Plugin();\n    this.hcs2Plugin = new HCS2Plugin();\n    this.inscribePlugin = new InscribePlugin();\n    this.hbarPlugin = new HbarPlugin();\n    this.logger = new Logger({\n      module: 'ConversationalAgent',\n      silent: options.disableLogging || false,\n    });\n\n    if (this.options.entityMemoryEnabled !== false) {\n      if (!options.openAIApiKey) {\n        throw new Error(\n          'OpenAI/Anthropic API key is required when entity memory is enabled'\n        );\n      }\n\n      this.memoryManager = new SmartMemoryManager(\n        this.options.entityMemoryConfig\n      );\n      this.logger.info('Entity memory initialized');\n\n      const provider =\n        options.entityMemoryProvider || options.llmProvider || 'openai';\n      let modelName = options.entityMemoryModelName;\n      if (!modelName) {\n        if (provider === 'anthropic') {\n          modelName = DEFAULT_CLAUDE_MODEL;\n        } else if (provider === 'openrouter') {\n          modelName = DEFAULT_OPENROUTER_MODEL;\n        } else {\n          modelName = DEFAULT_OPENAI_MODEL;\n        }\n      }\n\n      let resolverLLM: ChatOpenAI | ChatAnthropic;\n      if (provider === 'anthropic') {\n        resolverLLM = new ChatAnthropic({\n          apiKey: options.openAIApiKey,\n          model: modelName,\n          temperature: 0,\n        });\n      } else if (provider === 'openrouter') {\n        const baseURL =\n          options.openRouterBaseURL || 'https://openrouter.ai/api/v1';\n        const apiKey = options.openRouterApiKey || options.openAIApiKey;\n        resolverLLM = new ChatOpenAI({\n          apiKey,\n          model: modelName,\n          temperature: 0,\n          configuration: {\n            baseURL,\n            defaultHeaders: {\n              'HTTP-Referer':\n                process.env.OPENROUTER_REFERRER ||\n                'https://hashgraphonline.com',\n              'X-Title':\n                process.env.OPENROUTER_TITLE ||\n                'Hashgraph Online Conversational Agent',\n            },\n          },\n        });\n      } else {\n        resolverLLM = new ChatOpenAI({\n          apiKey: options.openAIApiKey,\n          model: modelName,\n          temperature: 0,\n        });\n      }\n\n      this.entityTools = createEntityTools(resolverLLM);\n      this.logger.info('LLM-based entity resolver tools initialized');\n    }\n  }\n\n  /**\n   * Initialize the conversational agent with Hedera Hashgraph connection and AI configuration\n   * @throws {Error} If account ID or private key is missing\n   * @throws {Error} If initialization fails\n   */\n  async initialize(): Promise<void> {\n    const {\n      accountId,\n      privateKey,\n      network = DEFAULT_NETWORK,\n      openAIApiKey,\n      openAIModelName = DEFAULT_MODEL_NAME,\n      llmProvider = 'openai',\n    } = this.options;\n\n    this.validateOptions(accountId, privateKey);\n\n    try {\n      const opMode = (this.options.operationalMode ||\n        DEFAULT_OPERATIONAL_MODE) as string;\n      const bytesMode = opMode !== 'autonomous';\n      let signer: AbstractSigner;\n\n      try {\n        type InscriberBuilderWithWalletMethods = typeof InscriberBuilder & {\n          setPreferWalletOnly?: (prefer: boolean) => void;\n          setWalletInfoResolver?: (\n            fn: () => Promise<{ accountId: string; network: string } | null>\n          ) => void;\n          setWalletExecutor?: (\n            fn: (\n              base64: string,\n              network: 'mainnet' | 'testnet'\n            ) => Promise<{ transactionId: string }>\n          ) => void;\n          setStartInscriptionDelegate?: (\n            fn: (\n              request: Record<string, unknown>,\n              network: 'mainnet' | 'testnet'\n            ) => Promise<unknown>\n          ) => void;\n        };\n        const IB = InscriberBuilder as InscriberBuilderWithWalletMethods;\n        if (typeof IB.setPreferWalletOnly === 'function') {\n          IB.setPreferWalletOnly(false);\n        }\n      } catch (e) {\n        this.logger.warn('Failed to set wallet-only preference', e as Error);\n      }\n      if (!bytesMode) {\n        signer = new ServerSigner(\n          accountId!,\n          privateKey!,\n          network as MirrorNetwork\n        );\n      } else {\n        const chain: 'mainnet' | 'testnet' =\n          String(network || 'testnet') === 'mainnet' ? 'mainnet' : 'testnet';\n        const effectiveAccount = (this.options.userAccountId || accountId)!;\n        signer = new BrowserSigner(\n          effectiveAccount,\n          chain,\n          this.options.walletExecutor\n        );\n      }\n\n      this.logger.info('Signer configured', {\n        operationalMode: opMode,\n        bytesMode,\n        signerClass:\n          Object.getPrototypeOf(signer)?.constructor?.name || 'unknown',\n      });\n\n      try {\n        const bridge = getWalletBridgeProvider();\n        if (bridge) {\n          type InscriberBuilderWithWalletMethods = typeof InscriberBuilder & {\n            setWalletInfoResolver?: (\n              fn: () => Promise<{ accountId: string; network: string } | null>\n            ) => void;\n            setWalletExecutor?: (\n              fn: (\n                base64: string,\n                network: 'mainnet' | 'testnet'\n              ) => Promise<{ transactionId: string }>\n            ) => void;\n            setStartInscriptionDelegate?: (\n              fn: (\n                request: Record<string, unknown>,\n                network: 'mainnet' | 'testnet'\n              ) => Promise<unknown>\n            ) => void;\n          };\n          const IB = InscriberBuilder as InscriberBuilderWithWalletMethods;\n          if (typeof IB.setWalletInfoResolver === 'function') {\n            IB.setWalletInfoResolver(async () => {\n              const status = await bridge.status();\n              if (status.connected && status.accountId && status.network) {\n                return { accountId: status.accountId, network: status.network };\n              }\n              return null;\n            });\n          }\n          if (typeof IB.setWalletExecutor === 'function') {\n            IB.setWalletExecutor(\n              async (base64: string, network: 'mainnet' | 'testnet') => {\n                return await bridge.executeBytes(base64, network);\n              }\n            );\n          }\n          if (\n            typeof IB.setStartInscriptionDelegate === 'function' &&\n            bridge.startInscription\n          ) {\n            IB.setStartInscriptionDelegate(\n              async (\n                request: Record<string, unknown>,\n                network: 'mainnet' | 'testnet'\n              ) => {\n                return await bridge.startInscription!(request, network);\n              }\n            );\n          }\n\n          try {\n            type HCSOp =\n              | 'submitConnectionRequest'\n              | 'handleConnectionRequest'\n              | 'sendMessage'\n              | 'hcs2.createRegistry'\n              | 'hcs2.migrateRegistry'\n              | 'hcs2.registerEntry'\n              | 'hcs2.updateEntry'\n              | 'hcs2.deleteEntry'\n              | 'hcs2.submitMessage'\n              | 'hcs6.createRegistry'\n              | 'hcs6.registerEntry'\n              | 'hcs6.submitMessage';\n            type WalletBridgeProviderExt = ReturnType<\n              typeof getWalletBridgeProvider\n            > & {\n              startHCS?: (\n                op: HCSOp,\n                request: Record<string, unknown>,\n                network: 'mainnet' | 'testnet'\n              ) => Promise<{ transactionBytes: string }>;\n            };\n\n            const status = await bridge.status();\n            const enforceWallet = !!(bytesMode && status.connected);\n\n            SignerProviderRegistry.setWalletInfoResolver(async () => {\n              const s = await bridge.status();\n              if (s.connected && s.accountId && s.network) {\n                return {\n                  accountId: s.accountId,\n                  network: s.network as 'mainnet' | 'testnet',\n                };\n              }\n              return null;\n            });\n\n            SignerProviderRegistry.setWalletExecutor(\n              async (base64: string, network: 'mainnet' | 'testnet') => {\n                return await bridge.executeBytes(base64, network);\n              }\n            );\n\n            const extended = bridge as WalletBridgeProviderExt;\n            if (typeof extended?.startHCS === 'function') {\n              SignerProviderRegistry.setStartHCSDelegate(\n                async (op, request, network) => {\n                  return await extended.startHCS!(\n                    op as HCSOp,\n                    request,\n                    network\n                  );\n                }\n              );\n            } else {\n              SignerProviderRegistry.setStartHCSDelegate(null);\n            }\n\n            SignerProviderRegistry.setPreferWalletOnly(enforceWallet);\n\n            type InscriberBuilderWithWalletMethods = typeof InscriberBuilder & {\n              setPreferWalletOnly?: (prefer: boolean) => void;\n            };\n            const IB2 = InscriberBuilder as InscriberBuilderWithWalletMethods;\n            if (typeof IB2.setPreferWalletOnly === 'function') {\n              IB2.setPreferWalletOnly(enforceWallet);\n            }\n          } catch (sakWireErr) {\n            this.logger.warn(\n              'Failed to wire SAK SignerProviderRegistry wallet delegates',\n              sakWireErr as Error\n            );\n          }\n        }\n      } catch (e) {\n        this.logger.warn(\n          'Failed to register wallet bridge providers',\n          e as Error\n        );\n      }\n\n      let llm: ChatOpenAI | ChatAnthropic;\n      let providerInfo: Record<string, unknown> = { provider: llmProvider };\n      if (llmProvider === 'anthropic') {\n        llm = new ChatAnthropic({\n          apiKey: openAIApiKey,\n          model: openAIModelName || DEFAULT_CLAUDE_MODEL,\n          temperature: DEFAULT_TEMPERATURE,\n        });\n        providerInfo = {\n          ...providerInfo,\n          model: openAIModelName || DEFAULT_CLAUDE_MODEL,\n          keyPresent: !!openAIApiKey,\n        };\n      } else if (llmProvider === 'openrouter') {\n        const baseURL =\n          this.options.openRouterBaseURL || 'https://openrouter.ai/api/v1';\n        const apiKey = this.options.openRouterApiKey || openAIApiKey;\n        const modelName =\n          openAIModelName || 'anthropic/claude-3-haiku-20240307';\n        llm = new ChatOpenAI({\n          apiKey,\n          model: modelName,\n          temperature: DEFAULT_TEMPERATURE,\n          configuration: {\n            baseURL,\n            defaultHeaders: {\n              'HTTP-Referer':\n                process.env.OPENROUTER_REFERRER ||\n                'https://hashgraphonline.com',\n              'X-Title':\n                process.env.OPENROUTER_TITLE ||\n                'Hashgraph Online Conversational Agent',\n            },\n          },\n        });\n        providerInfo = {\n          ...providerInfo,\n          model: modelName,\n          baseURL,\n          keyPresent: !!apiKey,\n        };\n      } else {\n        const modelName2 = openAIModelName || DEFAULT_OPENAI_MODEL;\n        const isGPT5Model =\n          modelName2.toLowerCase().includes('gpt-5') ||\n          modelName2.toLowerCase().includes('gpt5');\n        llm = new ChatOpenAI({\n          apiKey: openAIApiKey,\n          model: modelName2,\n          ...(isGPT5Model\n            ? { temperature: 1 }\n            : { temperature: DEFAULT_TEMPERATURE }),\n        });\n        providerInfo = {\n          ...providerInfo,\n          model: modelName2,\n          keyPresent: !!openAIApiKey,\n        };\n      }\n\n      this.logger.info('AI provider configured', providerInfo);\n\n      this.logger.info('Preparing plugins...');\n      const allPlugins = this.preparePlugins();\n      this.logger.info('Creating agent config...');\n      const agentConfig = this.createAgentConfig(\n        signer as ServerSigner,\n        llm,\n        allPlugins\n      );\n\n      this.logger.info('Creating agent...');\n      this.agent = createAgent(agentConfig);\n      this.logger.info('Agent created');\n\n      this.logger.info('Configuring HCS10 plugin...');\n      this.configureHCS10Plugin(allPlugins);\n      this.logger.info('HCS10 plugin configured');\n\n      this.contentStoreManager = new ContentStoreManager();\n      await this.contentStoreManager.initialize();\n      this.logger.info(\n        'ContentStoreManager initialized for content reference support'\n      );\n\n      this.logger.info('About to call agent.boot()');\n      this.logger.info('🔥 About to call agent.boot()');\n      await this.agent.boot();\n      this.logger.info('agent.boot() completed');\n      this.logger.info('🔥 agent.boot() completed');\n\n      if (this.agent) {\n        try {\n          const registry = new FormatConverterRegistry();\n          registry.register(new TopicIdToHrlConverter());\n          registry.register(new StringNormalizationConverter());\n          const paramService = new ParameterService(\n            registry,\n            (this.options.network as unknown as NetworkType) || 'testnet'\n          );\n          paramService.attachToAgent(this.agent, {\n            getEntities: async () =>\n              this.memoryManager?.getEntityAssociations() || [],\n          });\n          this.logger.info(\n            'Parameter preprocessing callback attached (internal)'\n          );\n        } catch (e) {\n          this.logger.warn(\n            'Failed to attach internal parameter preprocessing callback',\n            e\n          );\n        }\n\n        const cfg = agentConfig;\n        cfg.filtering = cfg.filtering || {};\n        const originalPredicate = cfg.filtering.toolPredicate as\n          | ((t: ToolDescriptor) => boolean)\n          | undefined;\n        const userPredicate = this.options.toolFilter;\n        cfg.filtering.toolPredicate = (tool: ToolDescriptor): boolean => {\n          if (tool && tool.name === 'hedera-account-transfer-hbar') {\n            return false;\n          }\n          if (tool && tool.name === 'hedera-hts-airdrop-token') {\n            return false;\n          }\n          if (originalPredicate && !originalPredicate(tool)) {\n            return false;\n          }\n          if (userPredicate && !userPredicate(tool)) {\n            return false;\n          }\n          return true;\n        };\n      }\n\n      if (this.options.mcpServers && this.options.mcpServers.length > 0) {\n        this.connectMCP();\n      }\n    } catch (error) {\n      this.logger.error('Failed to initialize ConversationalAgent:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the HCS-10 plugin instance\n   * @returns {HCS10Plugin} The HCS-10 plugin instance\n   */\n  getPlugin(): HCS10Plugin {\n    return this.hcs10Plugin;\n  }\n\n  /**\n   * Get the state manager instance\n   * @returns {IStateManager} The state manager instance\n   */\n  getStateManager(): IStateManager {\n    return this.stateManager;\n  }\n\n  /**\n   * Get the underlying agent instance\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getAgent(): ReturnType<typeof createAgent> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n    return this.agent;\n  }\n\n  /**\n   * Get the conversational agent instance (alias for getAgent)\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getConversationalAgent(): ReturnType<typeof createAgent> {\n    return this.getAgent();\n  }\n\n  /**\n   * Process a message through the conversational agent\n   * @param {string} message - The message to process\n   * @param {Array<{type: 'human' | 'ai'; content: string}>} chatHistory - Previous chat history\n   * @returns {Promise<ChatResponse>} The agent's response\n   * @throws {Error} If agent is not initialized\n   */\n  async processMessage(\n    message: string,\n    chatHistory: ChatHistoryItem[] = []\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error('Agent not initialized. Call initialize() first.');\n    }\n\n    try {\n      const resolvedMessage = message;\n\n      const messages = chatHistory.map((msg) => {\n        const content = msg.content;\n        if (msg.type === 'system') {\n          return new SystemMessage(content);\n        }\n        return msg.type === 'human'\n          ? new HumanMessage(content)\n          : new AIMessage(content);\n      });\n\n      const context: ConversationContext = { messages };\n      const response = await this.agent.chat(resolvedMessage, context);\n\n      if (\n        this.memoryManager &&\n        this.options.operationalMode !== 'returnBytes'\n      ) {\n        await this.extractAndStoreEntities(response, message);\n      }\n\n      this.logger.info('Message processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing message:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Process form submission through the conversational agent\n   * @param {FormSubmission} submission - The form submission data\n   * @returns {Promise<ChatResponse>} The agent's response after processing the form\n   * @throws {Error} If agent is not initialized or doesn't support form processing\n   */\n  async processFormSubmission(\n    submission: FormSubmission\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n\n    try {\n      this.logger.info('Processing form submission:', {\n        formId: submission.formId,\n        toolName: submission.toolName,\n        parameterKeys: Object.keys(submission.parameters || {}),\n        hasContext: !!submission.context,\n      });\n      const response = await this.agent.processFormSubmission(submission);\n      this.logger.info('Form submission processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing form submission:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Validates initialization options and throws if required fields are missing.\n   *\n   * @param accountId - The Hedera account ID\n   * @param privateKey - The private key for the account\n   * @throws {Error} If required fields are missing\n   */\n  private validateOptions(accountId?: string, privateKey?: string): void {\n    const opMode = (this.options.operationalMode ||\n      DEFAULT_OPERATIONAL_MODE) as string;\n    const bytesMode = opMode !== 'autonomous';\n    if (!accountId) {\n      throw new Error('Account ID is required');\n    }\n    if (!privateKey && !bytesMode) {\n      throw new Error('Private key is required in autonomous mode');\n    }\n\n    if (typeof accountId !== 'string') {\n      throw new Error(\n        `Account ID must be a string, received ${typeof accountId}`\n      );\n    }\n\n    if (!bytesMode && typeof privateKey !== 'string') {\n      throw new Error(\n        `Private key must be a string, received ${typeof privateKey}: ${JSON.stringify(\n          privateKey\n        )}`\n      );\n    }\n    if (\n      !bytesMode &&\n      typeof privateKey === 'string' &&\n      privateKey.length < 10\n    ) {\n      throw new Error('Private key appears to be invalid (too short)');\n    }\n  }\n\n  /**\n   * Prepares the list of plugins to use based on configuration.\n   *\n   * @returns Array of plugins to initialize with the agent\n   */\n  private preparePlugins(): BasePlugin[] {\n    const { additionalPlugins = [], enabledPlugins } = this.options;\n\n    const standardPlugins = [\n      this.hcs10Plugin,\n      this.hcs2Plugin,\n      this.inscribePlugin,\n      this.hbarPlugin,\n    ];\n\n    const corePlugins = getAllHederaCorePlugins();\n\n    if (enabledPlugins) {\n      const enabledSet = new Set(enabledPlugins);\n      const filteredPlugins = [...standardPlugins, ...corePlugins].filter(\n        (plugin) => enabledSet.has(plugin.id)\n      );\n      return [...filteredPlugins, ...additionalPlugins];\n    }\n\n    return [...standardPlugins, ...corePlugins, ...additionalPlugins];\n  }\n\n  /**\n   * Creates the agent configuration object.\n   *\n   * @param signer - The signer instance\n   * @param llm - The language model instance\n   * @param allPlugins - Array of plugins to use\n   * @returns Configuration object for creating the agent\n   */\n  private createAgentConfig(\n    signer: ServerSigner,\n    llm: ChatOpenAI | ChatAnthropic,\n    allPlugins: BasePlugin[]\n  ): Parameters<typeof createAgent>[0] {\n    const {\n      operationalMode = DEFAULT_OPERATIONAL_MODE,\n      userAccountId,\n      scheduleUserTransactionsInBytesMode,\n      customSystemMessagePreamble,\n      customSystemMessagePostamble,\n      verbose = false,\n      mirrorNodeConfig,\n      disableLogging,\n      accountId = '',\n    } = this.options;\n\n    return {\n      framework: 'langchain',\n      signer,\n      execution: {\n        mode: operationalMode === 'autonomous' ? 'direct' : 'bytes',\n        operationalMode: operationalMode,\n        ...(userAccountId && { userAccountId }),\n        ...(scheduleUserTransactionsInBytesMode !== undefined && {\n          scheduleUserTransactionsInBytesMode:\n            scheduleUserTransactionsInBytesMode,\n          scheduleUserTransactions: scheduleUserTransactionsInBytesMode,\n        }),\n      },\n      ai: {\n        provider: new LangChainProvider(llm),\n        temperature: DEFAULT_TEMPERATURE,\n      },\n      filtering: {\n        toolPredicate: (tool: ToolDescriptor): boolean => {\n          if (tool.name === 'hedera-account-transfer-hbar') return false;\n          if (this.options.toolFilter && !this.options.toolFilter(tool)) {\n            return false;\n          }\n          return true;\n        },\n      },\n      messaging: {\n        systemPreamble:\n          customSystemMessagePreamble || getSystemMessage(accountId),\n        ...(customSystemMessagePostamble && {\n          systemPostamble: customSystemMessagePostamble,\n        }),\n        conciseMode: true,\n      },\n      extensions: {\n        plugins: allPlugins,\n        ...(mirrorNodeConfig && {\n          mirrorConfig: mirrorNodeConfig as Record<string, unknown>,\n        }),\n      },\n      ...(this.options.mcpServers && {\n        mcp: {\n          servers: this.options.mcpServers,\n          autoConnect: false,\n        },\n      }),\n      debug: {\n        verbose,\n        silent: disableLogging ?? false,\n      },\n    };\n  }\n\n  /**\n   * Configures the HCS-10 plugin with the state manager.\n   *\n   * @param allPlugins - Array of all plugins\n   */\n  private configureHCS10Plugin(allPlugins: BasePlugin[]): void {\n    const hcs10 = allPlugins.find((p) => p.id === 'hcs-10');\n    if (hcs10) {\n      (\n        hcs10 as BasePlugin & { appConfig?: Record<string, unknown> }\n      ).appConfig = {\n        stateManager: this.stateManager,\n      };\n    }\n  }\n\n  /**\n   * Create a ConversationalAgent with specific plugins enabled\n   */\n  private static withPlugins(\n    options: ConversationalAgentOptions,\n    plugins: string[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: plugins,\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled\n   */\n  static withHTS(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hts-token']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-2 tools enabled\n   */\n  static withHCS2(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-2']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-10 tools enabled\n   */\n  static withHCS10(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only inscription tools enabled\n   */\n  static withInscribe(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only account management tools enabled\n   */\n  static withAccount(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['account']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only file service tools enabled\n   */\n  static withFileService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['file-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only consensus service tools enabled\n   */\n  static withConsensusService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['consensus-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only smart contract tools enabled\n   */\n  static withSmartContract(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['smart-contract']);\n  }\n\n  /**\n   * Create a ConversationalAgent with all HCS standards plugins\n   */\n  static withAllStandards(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10', 'hcs-2', 'inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)\n   */\n  static minimal(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, []);\n  }\n\n  /**\n   * Create a ConversationalAgent with MCP servers configured\n   */\n  static withMCP(\n    options: ConversationalAgentOptions,\n    mcpServers: MCPServerConfig[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      mcpServers,\n    });\n  }\n\n  /**\n   * Extract and store entities from agent responses\n   * @param response - Agent response containing potential entity information\n   * @param originalMessage - Original user message for context\n   */\n  private async extractAndStoreEntities(\n    response: unknown,\n    originalMessage: string\n  ): Promise<void> {\n    if (!this.memoryManager || !this.entityTools) {\n      return;\n    }\n\n    try {\n      this.logger.info('Starting LLM-based entity extraction');\n\n      const responseText = this.extractResponseText(response);\n\n      const entitiesJson = await this.entityTools.extractEntities.call({\n        response: responseText,\n        userMessage: originalMessage,\n      });\n\n      try {\n        const entities = JSON.parse(entitiesJson);\n\n        for (const entity of entities) {\n          if (\n            entity &&\n            typeof entity === 'object' &&\n            'name' in entity &&\n            'type' in entity &&\n            'id' in entity\n          ) {\n            this.logger.info(\n              `Storing entity: ${entity.name} (${entity.type}) -> ${entity.id}`\n            );\n\n            const transactionId = this.extractTransactionId(response);\n            const idStr = String(entity.id);\n            const isHederaId = /^0\\.0\\.[0-9]+$/.test(idStr);\n            if (!isHederaId) {\n              this.logger.warn('Skipping non-ID entity from extraction', {\n                id: idStr,\n                name: String(entity.name),\n                type: String(entity.type),\n              });\n            } else {\n              this.memoryManager.storeEntityAssociation(\n                idStr,\n                String(entity.name),\n                String(entity.type),\n                transactionId\n              );\n            }\n          }\n        }\n\n        if (entities.length > 0) {\n          this.logger.info(\n            `Stored ${entities.length} entities via LLM extraction`\n          );\n        } else {\n          this.logger.info('No entities found in response via LLM extraction');\n        }\n      } catch (parseError) {\n        this.logger.error(\n          'Failed to parse extracted entities JSON:',\n          parseError\n        );\n        throw parseError;\n      }\n    } catch (error) {\n      this.logger.error('Entity extraction failed:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Extract transaction ID from response if available\n   * @param response - Transaction response\n   * @returns Transaction ID or undefined\n   */\n  private extractTransactionId(response: unknown): string | undefined {\n    try {\n      if (\n        typeof response === 'object' &&\n        response &&\n        'transactionId' in response\n      ) {\n        const responseWithTxId = response as { transactionId?: unknown };\n        return typeof responseWithTxId.transactionId === 'string'\n          ? responseWithTxId.transactionId\n          : undefined;\n      }\n      if (typeof response === 'string') {\n        const match = response.match(\n          /transaction[\\s\\w]*ID[\\s:\"]*([0-9a-fA-F@._-]+)/i\n        );\n        return match ? match[1] : undefined;\n      }\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Connect to MCP servers asynchronously\n   * @private\n   */\n  private connectMCP(): void {\n    if (!this.agent || !this.options.mcpServers) {\n      return;\n    }\n\n    this.agent\n      .connectMCPServers()\n      .catch((e) => {\n        this.logger.error('Failed to connect MCP servers:', e);\n      })\n      .then(() => {\n        this.logger.info('MCP servers connected successfully');\n      });\n  }\n\n  /**\n   * Get MCP connection status for all servers\n   * @returns {Map<string, MCPConnectionStatus>} Connection status map\n   */\n  getMCPConnectionStatus(): Map<string, MCPConnectionStatus> {\n    if (this.agent) {\n      return this.agent.getMCPConnectionStatus();\n    }\n    return new Map();\n  }\n\n  /**\n   * Check if a specific MCP server is connected\n   * @param {string} serverName - Name of the server to check\n   * @returns {boolean} True if connected, false otherwise\n   */\n  isMCPServerConnected(serverName: string): boolean {\n    if (this.agent) {\n      const statusMap = this.agent.getMCPConnectionStatus();\n      const status = statusMap.get(serverName);\n      return status?.connected ?? false;\n    }\n    return false;\n  }\n\n  /**\n   * Clean up resources\n   */\n  async cleanup(): Promise<void> {\n    try {\n      this.logger.info('Cleaning up ConversationalAgent...');\n\n      if (this.memoryManager) {\n        try {\n          this.memoryManager.dispose();\n          this.logger.info('Memory manager cleaned up successfully');\n        } catch (error) {\n          this.logger.warn('Error cleaning up memory manager:', error);\n        }\n        this.memoryManager = undefined;\n      }\n\n      if (this.contentStoreManager) {\n        await this.contentStoreManager.dispose();\n        this.logger.info('ContentStoreManager cleaned up');\n      }\n\n      this.logger.info('ConversationalAgent cleanup completed');\n    } catch (error) {\n      this.logger.error('Error during cleanup:', error);\n    }\n  }\n\n  /**\n   * Switch operational mode\n   */\n  switchMode(mode?: AgentOperationalMode): void {\n    if (this.agent?.switchMode) {\n      this.agent.switchMode(mode || 'autonomous');\n    }\n  }\n\n  /**\n   * Get usage statistics\n   */\n  getUsageStats(): unknown {\n    return this.agent?.getUsageStats?.() ?? {};\n  }\n\n  /**\n   * Clear usage statistics\n   */\n  clearUsageStats(): void {\n    if (this.agent?.clearUsageStats) {\n      this.agent.clearUsageStats();\n    }\n  }\n\n  /**\n   * Shutdown the agent\n   */\n  shutdown(): Promise<void> {\n    return this.agent?.shutdown?.() ?? Promise.resolve();\n  }\n\n  private extractResponseText(response: unknown): string {\n    if (typeof response === 'string') {\n      return response;\n    }\n\n    if (response && typeof response === 'object' && 'output' in response) {\n      const responseWithOutput = response as { output: unknown };\n      return String(responseWithOutput.output);\n    }\n\n    return JSON.stringify(response);\n  }\n}\n"],"names":["network"],"mappings":"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"}
+{"version":3,"file":"index6.js","sources":["../../src/conversational-agent.ts"],"sourcesContent":["import {\n  ServerSigner,\n  getAllHederaCorePlugins,\n  BasePlugin,\n  AbstractSigner,\n} from 'hedera-agent-kit';\nimport { Logger, type NetworkType } from '@hashgraphonline/standards-sdk';\nimport { createAgent } from './agent-factory';\nimport BrowserSigner from './signers/browser-signer';\nimport { LangChainProvider } from './providers';\nimport type { ChatResponse, ConversationContext } from './base-agent';\nimport { ChatOpenAI } from '@langchain/openai';\nimport { ChatAnthropic } from '@langchain/anthropic';\nimport {\n  HumanMessage,\n  AIMessage,\n  SystemMessage,\n} from '@langchain/core/messages';\nimport type { AgentOperationalMode, MirrorNodeConfig } from 'hedera-agent-kit';\nimport { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';\nimport { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';\nimport { InscribePlugin } from './plugins/inscribe/InscribePlugin';\nimport { getWalletBridgeProvider } from './runtime/wallet-bridge';\nimport {\n  InscriberBuilder,\n  SignerProviderRegistry,\n} from '@hashgraphonline/standards-agent-kit';\nimport { HbarPlugin } from './plugins/hbar/HbarPlugin';\nimport { WebBrowserPlugin } from './plugins/web-browser/WebBrowserPlugin';\nimport { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';\nimport type { IStateManager } from '@hashgraphonline/standards-agent-kit';\nimport { getSystemMessage } from './config/system-message';\nimport type { MCPServerConfig, MCPConnectionStatus } from './mcp/types';\nimport { ContentStoreManager } from './services/content-store-manager';\nimport { SmartMemoryManager, type SmartMemoryConfig } from './memory';\nimport {\n  createEntityTools,\n  ResolveEntitiesTool,\n  ExtractEntitiesTool,\n} from './tools/entity-resolver-tool';\nimport type { FormSubmission } from './forms/types';\nimport { ParameterService } from './services/parameter-service';\nimport { FormatConverterRegistry } from './services/formatters/format-converter-registry';\nimport { TopicIdToHrlConverter } from './services/formatters/converters/topic-id-to-hrl-converter';\nimport { StringNormalizationConverter } from './services/formatters/converters/string-normalization-converter';\n\nexport type ToolDescriptor = {\n  name: string;\n  namespace?: string;\n};\n\nexport type ChatHistoryItem = {\n  type: 'human' | 'ai' | 'system';\n  content: string;\n};\n\nexport type AgentInstance = ReturnType<typeof createAgent>;\n\nexport type MirrorNetwork = 'testnet' | 'mainnet' | 'previewnet';\n\nconst DEFAULT_MODEL_NAME = 'gpt-4o';\nconst DEFAULT_OPENAI_MODEL = 'gpt-4o-mini';\nconst DEFAULT_OPENROUTER_MODEL = 'openai/gpt-4o-mini';\nconst DEFAULT_CLAUDE_MODEL = 'claude-3-7-sonnet-latest';\nconst DEFAULT_TEMPERATURE = 0.1;\nconst DEFAULT_NETWORK = 'testnet';\nconst DEFAULT_OPERATIONAL_MODE: AgentOperationalMode = 'autonomous';\n\nexport interface ConversationalAgentOptions {\n  accountId: string;\n  privateKey: string;\n  network?: NetworkType;\n  openAIApiKey: string;\n  openAIModelName?: string;\n  llmProvider?: 'openai' | 'anthropic' | 'openrouter';\n  verbose?: boolean;\n  operationalMode?: AgentOperationalMode;\n  userAccountId?: string;\n  customSystemMessagePreamble?: string;\n  customSystemMessagePostamble?: string;\n  additionalPlugins?: BasePlugin[];\n  stateManager?: IStateManager;\n  scheduleUserTransactionsInBytesMode?: boolean;\n  mirrorNodeConfig?: MirrorNodeConfig;\n  disableLogging?: boolean;\n  enabledPlugins?: string[];\n  disabledPlugins?: string[];\n  toolFilter?: (tool: { name: string; namespace?: string }) => boolean;\n  mcpServers?: MCPServerConfig[];\n  walletExecutor?: (\n    base64: string,\n    network: 'mainnet' | 'testnet'\n  ) => Promise<{ transactionId: string }>;\n  /** Optional: provide a signer factory to override default signer selection */\n  customSignerFactory?: (args: {\n    operationalMode: AgentOperationalMode;\n    accountId: string;\n    network: NetworkType;\n  }) => AbstractSigner;\n\n  /** Enable automatic entity memory functionality (default: true) */\n  entityMemoryEnabled?: boolean;\n\n  /** Configuration for entity memory system */\n  entityMemoryConfig?: SmartMemoryConfig;\n\n  /**\n   * Provider used for entity extraction/resolution tools (defaults to llmProvider or 'openai')\n   */\n  entityMemoryProvider?: 'openai' | 'anthropic' | 'openrouter';\n\n  /**\n   * Model name for entity extraction/resolution tools (defaults per provider)\n   */\n  entityMemoryModelName?: string;\n\n  openRouterApiKey?: string;\n  openRouterBaseURL?: string;\n}\n\n/**\n * The ConversationalAgent class is an optional wrapper around the HederaConversationalAgent class,\n * which includes the OpenConvAIPlugin and the OpenConvaiState by default.\n * If you want to use a different plugin or state manager, you can pass them in the options.\n * This class is not required and the plugin can be used directly with the HederaConversationalAgent class.\n *\n * @param options - The options for the ConversationalAgent.\n * @returns A new instance of the ConversationalAgent class.\n */\nexport class ConversationalAgent {\n  private static readonly NOT_INITIALIZED_ERROR =\n    'Agent not initialized. Call initialize() first.';\n  protected agent?: AgentInstance;\n  public hcs10Plugin: HCS10Plugin;\n  public hcs2Plugin: HCS2Plugin;\n  public inscribePlugin: InscribePlugin;\n  public hbarPlugin: HbarPlugin;\n  public webBrowserPlugin: WebBrowserPlugin;\n  public stateManager: IStateManager;\n  private options: ConversationalAgentOptions;\n  public logger: Logger;\n  public contentStoreManager?: ContentStoreManager;\n  public memoryManager?: SmartMemoryManager | undefined;\n  private entityTools?: {\n    resolveEntities: ResolveEntitiesTool;\n    extractEntities: ExtractEntitiesTool;\n  };\n\n  constructor(options: ConversationalAgentOptions) {\n    this.options = options;\n    this.stateManager = options.stateManager || new OpenConvaiState();\n    this.hcs10Plugin = new HCS10Plugin();\n    this.hcs2Plugin = new HCS2Plugin();\n    this.inscribePlugin = new InscribePlugin();\n    this.hbarPlugin = new HbarPlugin();\n    this.webBrowserPlugin = new WebBrowserPlugin();\n    this.logger = new Logger({\n      module: 'ConversationalAgent',\n      silent: options.disableLogging || false,\n    });\n\n    if (this.options.entityMemoryEnabled !== false) {\n      if (!options.openAIApiKey) {\n        throw new Error(\n          'OpenAI/Anthropic API key is required when entity memory is enabled'\n        );\n      }\n\n      this.memoryManager = new SmartMemoryManager(\n        this.options.entityMemoryConfig\n      );\n      this.logger.info('Entity memory initialized');\n\n      const provider =\n        options.entityMemoryProvider || options.llmProvider || 'openai';\n      let modelName = options.entityMemoryModelName;\n      if (!modelName) {\n        if (provider === 'anthropic') {\n          modelName = DEFAULT_CLAUDE_MODEL;\n        } else if (provider === 'openrouter') {\n          modelName = DEFAULT_OPENROUTER_MODEL;\n        } else {\n          modelName = DEFAULT_OPENAI_MODEL;\n        }\n      }\n\n      let resolverLLM: ChatOpenAI | ChatAnthropic;\n      if (provider === 'anthropic') {\n        resolverLLM = new ChatAnthropic({\n          apiKey: options.openAIApiKey,\n          model: modelName,\n          temperature: 0,\n        });\n      } else if (provider === 'openrouter') {\n        const baseURL =\n          options.openRouterBaseURL || 'https://openrouter.ai/api/v1';\n        const apiKey = options.openRouterApiKey || options.openAIApiKey;\n        resolverLLM = new ChatOpenAI({\n          apiKey,\n          model: modelName,\n          temperature: 0,\n          configuration: {\n            baseURL,\n            defaultHeaders: {\n              'HTTP-Referer':\n                process.env.OPENROUTER_REFERRER ||\n                'https://hashgraphonline.com',\n              'X-Title':\n                process.env.OPENROUTER_TITLE ||\n                'Hashgraph Online Conversational Agent',\n            },\n          },\n        });\n      } else {\n        resolverLLM = new ChatOpenAI({\n          apiKey: options.openAIApiKey,\n          model: modelName,\n          temperature: 0,\n        });\n      }\n\n      this.entityTools = createEntityTools(resolverLLM);\n      this.logger.info('LLM-based entity resolver tools initialized');\n    }\n  }\n\n  /**\n   * Initialize the conversational agent with Hedera Hashgraph connection and AI configuration\n   * @throws {Error} If account ID or private key is missing\n   * @throws {Error} If initialization fails\n   */\n  async initialize(): Promise<void> {\n    const {\n      accountId,\n      privateKey,\n      network = DEFAULT_NETWORK,\n      openAIApiKey,\n      openAIModelName = DEFAULT_MODEL_NAME,\n      llmProvider = 'openai',\n    } = this.options;\n\n    this.validateOptions(accountId, privateKey);\n\n    try {\n      const opMode = (this.options.operationalMode ||\n        DEFAULT_OPERATIONAL_MODE) as string;\n      const bytesMode = opMode !== 'autonomous';\n      let signer: AbstractSigner;\n\n      try {\n        type InscriberBuilderWithWalletMethods = typeof InscriberBuilder & {\n          setPreferWalletOnly?: (prefer: boolean) => void;\n          setWalletInfoResolver?: (\n            fn: () => Promise<{ accountId: string; network: string } | null>\n          ) => void;\n          setWalletExecutor?: (\n            fn: (\n              base64: string,\n              network: 'mainnet' | 'testnet'\n            ) => Promise<{ transactionId: string }>\n          ) => void;\n          setStartInscriptionDelegate?: (\n            fn: (\n              request: Record<string, unknown>,\n              network: 'mainnet' | 'testnet'\n            ) => Promise<unknown>\n          ) => void;\n        };\n        const IB = InscriberBuilder as InscriberBuilderWithWalletMethods;\n        if (typeof IB.setPreferWalletOnly === 'function') {\n          IB.setPreferWalletOnly(false);\n        }\n      } catch (e) {\n        this.logger.warn('Failed to set wallet-only preference', e as Error);\n      }\n      if (!bytesMode) {\n        signer = new ServerSigner(\n          accountId!,\n          privateKey!,\n          network as MirrorNetwork\n        );\n      } else {\n        const chain: 'mainnet' | 'testnet' =\n          String(network || 'testnet') === 'mainnet' ? 'mainnet' : 'testnet';\n        const effectiveAccount = (this.options.userAccountId || accountId)!;\n        signer = new BrowserSigner(\n          effectiveAccount,\n          chain,\n          this.options.walletExecutor\n        );\n      }\n\n      this.logger.info('Signer configured', {\n        operationalMode: opMode,\n        bytesMode,\n        signerClass:\n          Object.getPrototypeOf(signer)?.constructor?.name || 'unknown',\n      });\n\n      try {\n        const bridge = getWalletBridgeProvider();\n        if (bridge) {\n          type InscriberBuilderWithWalletMethods = typeof InscriberBuilder & {\n            setWalletInfoResolver?: (\n              fn: () => Promise<{ accountId: string; network: string } | null>\n            ) => void;\n            setWalletExecutor?: (\n              fn: (\n                base64: string,\n                network: 'mainnet' | 'testnet'\n              ) => Promise<{ transactionId: string }>\n            ) => void;\n            setStartInscriptionDelegate?: (\n              fn: (\n                request: Record<string, unknown>,\n                network: 'mainnet' | 'testnet'\n              ) => Promise<unknown>\n            ) => void;\n          };\n          const IB = InscriberBuilder as InscriberBuilderWithWalletMethods;\n          if (typeof IB.setWalletInfoResolver === 'function') {\n            IB.setWalletInfoResolver(async () => {\n              const status = await bridge.status();\n              if (status.connected && status.accountId && status.network) {\n                return { accountId: status.accountId, network: status.network };\n              }\n              return null;\n            });\n          }\n          if (typeof IB.setWalletExecutor === 'function') {\n            IB.setWalletExecutor(\n              async (base64: string, network: 'mainnet' | 'testnet') => {\n                return await bridge.executeBytes(base64, network);\n              }\n            );\n          }\n          if (\n            typeof IB.setStartInscriptionDelegate === 'function' &&\n            bridge.startInscription\n          ) {\n            IB.setStartInscriptionDelegate(\n              async (\n                request: Record<string, unknown>,\n                network: 'mainnet' | 'testnet'\n              ) => {\n                return await bridge.startInscription!(request, network);\n              }\n            );\n          }\n\n          try {\n            type HCSOp =\n              | 'submitConnectionRequest'\n              | 'handleConnectionRequest'\n              | 'sendMessage'\n              | 'hcs2.createRegistry'\n              | 'hcs2.migrateRegistry'\n              | 'hcs2.registerEntry'\n              | 'hcs2.updateEntry'\n              | 'hcs2.deleteEntry'\n              | 'hcs2.submitMessage'\n              | 'hcs6.createRegistry'\n              | 'hcs6.registerEntry'\n              | 'hcs6.submitMessage';\n            type WalletBridgeProviderExt = ReturnType<\n              typeof getWalletBridgeProvider\n            > & {\n              startHCS?: (\n                op: HCSOp,\n                request: Record<string, unknown>,\n                network: 'mainnet' | 'testnet'\n              ) => Promise<{ transactionBytes: string }>;\n            };\n\n            const status = await bridge.status();\n            const enforceWallet = !!(bytesMode && status.connected);\n\n            SignerProviderRegistry.setWalletInfoResolver(async () => {\n              const s = await bridge.status();\n              if (s.connected && s.accountId && s.network) {\n                return {\n                  accountId: s.accountId,\n                  network: s.network as 'mainnet' | 'testnet',\n                };\n              }\n              return null;\n            });\n\n            SignerProviderRegistry.setWalletExecutor(\n              async (base64: string, network: 'mainnet' | 'testnet') => {\n                return await bridge.executeBytes(base64, network);\n              }\n            );\n\n            const extended = bridge as WalletBridgeProviderExt;\n            if (typeof extended?.startHCS === 'function') {\n              SignerProviderRegistry.setStartHCSDelegate(\n                async (op, request, network) => {\n                  return await extended.startHCS!(\n                    op as HCSOp,\n                    request,\n                    network\n                  );\n                }\n              );\n            } else {\n              SignerProviderRegistry.setStartHCSDelegate(null);\n            }\n\n            SignerProviderRegistry.setPreferWalletOnly(enforceWallet);\n\n            type InscriberBuilderWithWalletMethods = typeof InscriberBuilder & {\n              setPreferWalletOnly?: (prefer: boolean) => void;\n            };\n            const IB2 = InscriberBuilder as InscriberBuilderWithWalletMethods;\n            if (typeof IB2.setPreferWalletOnly === 'function') {\n              IB2.setPreferWalletOnly(enforceWallet);\n            }\n          } catch (sakWireErr) {\n            this.logger.warn(\n              'Failed to wire SAK SignerProviderRegistry wallet delegates',\n              sakWireErr as Error\n            );\n          }\n        }\n      } catch (e) {\n        this.logger.warn(\n          'Failed to register wallet bridge providers',\n          e as Error\n        );\n      }\n\n      let llm: ChatOpenAI | ChatAnthropic;\n      let providerInfo: Record<string, unknown> = { provider: llmProvider };\n      if (llmProvider === 'anthropic') {\n        llm = new ChatAnthropic({\n          apiKey: openAIApiKey,\n          model: openAIModelName || DEFAULT_CLAUDE_MODEL,\n          temperature: DEFAULT_TEMPERATURE,\n        });\n        providerInfo = {\n          ...providerInfo,\n          model: openAIModelName || DEFAULT_CLAUDE_MODEL,\n          keyPresent: !!openAIApiKey,\n        };\n      } else if (llmProvider === 'openrouter') {\n        const baseURL =\n          this.options.openRouterBaseURL || 'https://openrouter.ai/api/v1';\n        const apiKey = this.options.openRouterApiKey || openAIApiKey;\n        const modelName =\n          openAIModelName || 'anthropic/claude-3-haiku-20240307';\n        llm = new ChatOpenAI({\n          apiKey,\n          model: modelName,\n          temperature: DEFAULT_TEMPERATURE,\n          configuration: {\n            baseURL,\n            defaultHeaders: {\n              'HTTP-Referer':\n                process.env.OPENROUTER_REFERRER ||\n                'https://hashgraphonline.com',\n              'X-Title':\n                process.env.OPENROUTER_TITLE ||\n                'Hashgraph Online Conversational Agent',\n            },\n          },\n        });\n        providerInfo = {\n          ...providerInfo,\n          model: modelName,\n          baseURL,\n          keyPresent: !!apiKey,\n        };\n      } else {\n        const modelName2 = openAIModelName || DEFAULT_OPENAI_MODEL;\n        const isGPT5Model =\n          modelName2.toLowerCase().includes('gpt-5') ||\n          modelName2.toLowerCase().includes('gpt5');\n        llm = new ChatOpenAI({\n          apiKey: openAIApiKey,\n          model: modelName2,\n          ...(isGPT5Model\n            ? { temperature: 1 }\n            : { temperature: DEFAULT_TEMPERATURE }),\n        });\n        providerInfo = {\n          ...providerInfo,\n          model: modelName2,\n          keyPresent: !!openAIApiKey,\n        };\n      }\n\n      this.logger.info('AI provider configured', providerInfo);\n\n      this.logger.info('Preparing plugins...');\n      const allPlugins = this.preparePlugins();\n      this.logger.info('Creating agent config...');\n      const agentConfig = this.createAgentConfig(\n        signer as ServerSigner,\n        llm,\n        allPlugins\n      );\n\n      this.logger.info('Creating agent...');\n      this.agent = createAgent(agentConfig);\n      this.logger.info('Agent created');\n\n      this.logger.info('Configuring HCS10 plugin...');\n      this.configureHCS10Plugin(allPlugins);\n      this.logger.info('HCS10 plugin configured');\n\n      this.contentStoreManager = new ContentStoreManager();\n      await this.contentStoreManager.initialize();\n      this.logger.info(\n        'ContentStoreManager initialized for content reference support'\n      );\n\n      this.logger.info('About to call agent.boot()');\n      this.logger.info('🔥 About to call agent.boot()');\n      await this.agent.boot();\n      this.logger.info('agent.boot() completed');\n      this.logger.info('🔥 agent.boot() completed');\n\n      if (this.agent) {\n        try {\n          const registry = new FormatConverterRegistry();\n          registry.register(new TopicIdToHrlConverter());\n          registry.register(new StringNormalizationConverter());\n          const paramService = new ParameterService(\n            registry,\n            (this.options.network as unknown as NetworkType) || 'testnet'\n          );\n          paramService.attachToAgent(this.agent, {\n            getEntities: async () =>\n              this.memoryManager?.getEntityAssociations() || [],\n          });\n          this.logger.info(\n            'Parameter preprocessing callback attached (internal)'\n          );\n        } catch (e) {\n          this.logger.warn(\n            'Failed to attach internal parameter preprocessing callback',\n            e\n          );\n        }\n\n        const cfg = agentConfig;\n        cfg.filtering = cfg.filtering || {};\n        const originalPredicate = cfg.filtering.toolPredicate as\n          | ((t: ToolDescriptor) => boolean)\n          | undefined;\n        const userPredicate = this.options.toolFilter;\n        cfg.filtering.toolPredicate = (tool: ToolDescriptor): boolean => {\n          if (tool && tool.name === 'hedera-account-transfer-hbar') {\n            return false;\n          }\n          if (tool && tool.name === 'hedera-hts-airdrop-token') {\n            return false;\n          }\n          if (originalPredicate && !originalPredicate(tool)) {\n            return false;\n          }\n          if (userPredicate && !userPredicate(tool)) {\n            return false;\n          }\n          return true;\n        };\n      }\n\n      if (this.options.mcpServers && this.options.mcpServers.length > 0) {\n        this.connectMCP();\n      }\n    } catch (error) {\n      this.logger.error('Failed to initialize ConversationalAgent:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get the HCS-10 plugin instance\n   * @returns {HCS10Plugin} The HCS-10 plugin instance\n   */\n  getPlugin(): HCS10Plugin {\n    return this.hcs10Plugin;\n  }\n\n  /**\n   * Get the state manager instance\n   * @returns {IStateManager} The state manager instance\n   */\n  getStateManager(): IStateManager {\n    return this.stateManager;\n  }\n\n  /**\n   * Get the underlying agent instance\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getAgent(): ReturnType<typeof createAgent> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n    return this.agent;\n  }\n\n  /**\n   * Get the conversational agent instance (alias for getAgent)\n   * @returns {ReturnType<typeof createAgent>} The agent instance\n   * @throws {Error} If agent is not initialized\n   */\n  getConversationalAgent(): ReturnType<typeof createAgent> {\n    return this.getAgent();\n  }\n\n  /**\n   * Process a message through the conversational agent\n   * @param {string} message - The message to process\n   * @param {Array<{type: 'human' | 'ai'; content: string}>} chatHistory - Previous chat history\n   * @returns {Promise<ChatResponse>} The agent's response\n   * @throws {Error} If agent is not initialized\n   */\n  async processMessage(\n    message: string,\n    chatHistory: ChatHistoryItem[] = []\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error('Agent not initialized. Call initialize() first.');\n    }\n\n    try {\n      const resolvedMessage = message;\n\n      const messages = chatHistory.map((msg) => {\n        const content = msg.content;\n        if (msg.type === 'system') {\n          return new SystemMessage(content);\n        }\n        return msg.type === 'human'\n          ? new HumanMessage(content)\n          : new AIMessage(content);\n      });\n\n      const context: ConversationContext = { messages };\n      const response = await this.agent.chat(resolvedMessage, context);\n\n      if (\n        this.memoryManager &&\n        this.options.operationalMode !== 'returnBytes'\n      ) {\n        await this.extractAndStoreEntities(response, message);\n      }\n\n      this.logger.info('Message processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing message:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Process form submission through the conversational agent\n   * @param {FormSubmission} submission - The form submission data\n   * @returns {Promise<ChatResponse>} The agent's response after processing the form\n   * @throws {Error} If agent is not initialized or doesn't support form processing\n   */\n  async processFormSubmission(\n    submission: FormSubmission\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error(ConversationalAgent.NOT_INITIALIZED_ERROR);\n    }\n\n    try {\n      this.logger.info('Processing form submission:', {\n        formId: submission.formId,\n        toolName: submission.toolName,\n        parameterKeys: Object.keys(submission.parameters || {}),\n        hasContext: !!submission.context,\n      });\n      const response = await this.agent.processFormSubmission(submission);\n      this.logger.info('Form submission processed successfully');\n      return response;\n    } catch (error) {\n      this.logger.error('Error processing form submission:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Validates initialization options and throws if required fields are missing.\n   *\n   * @param accountId - The Hedera account ID\n   * @param privateKey - The private key for the account\n   * @throws {Error} If required fields are missing\n   */\n  private validateOptions(accountId?: string, privateKey?: string): void {\n    const opMode = (this.options.operationalMode ||\n      DEFAULT_OPERATIONAL_MODE) as string;\n    const bytesMode = opMode !== 'autonomous';\n    if (!accountId) {\n      throw new Error('Account ID is required');\n    }\n    if (!privateKey && !bytesMode) {\n      throw new Error('Private key is required in autonomous mode');\n    }\n\n    if (typeof accountId !== 'string') {\n      throw new Error(\n        `Account ID must be a string, received ${typeof accountId}`\n      );\n    }\n\n    if (!bytesMode && typeof privateKey !== 'string') {\n      throw new Error(\n        `Private key must be a string, received ${typeof privateKey}: ${JSON.stringify(\n          privateKey\n        )}`\n      );\n    }\n    if (\n      !bytesMode &&\n      typeof privateKey === 'string' &&\n      privateKey.length < 10\n    ) {\n      throw new Error('Private key appears to be invalid (too short)');\n    }\n  }\n\n  /**\n   * Prepares the list of plugins to use based on configuration.\n   *\n   * @returns Array of plugins to initialize with the agent\n   */\n  private preparePlugins(): BasePlugin[] {\n    const { additionalPlugins = [], enabledPlugins, disabledPlugins } = this.options;\n\n    const standardPlugins: BasePlugin[] = [\n      this.hcs10Plugin,\n      this.hcs2Plugin,\n      this.inscribePlugin,\n      this.hbarPlugin,\n    ];\n    standardPlugins.push(this.webBrowserPlugin);\n\n    const corePlugins = getAllHederaCorePlugins();\n    let pluginPool = [...standardPlugins, ...corePlugins];\n\n    if (enabledPlugins) {\n      const enabledSet = new Set(enabledPlugins);\n      pluginPool = pluginPool.filter((plugin) => enabledSet.has(plugin.id));\n    }\n\n    if (disabledPlugins && disabledPlugins.length > 0) {\n      const disabledSet = new Set(disabledPlugins);\n      pluginPool = pluginPool.filter((plugin) => !disabledSet.has(plugin.id));\n    }\n\n    const additional = disabledPlugins && disabledPlugins.length > 0\n      ? additionalPlugins.filter((plugin) => !disabledPlugins.includes(plugin.id))\n      : additionalPlugins;\n\n    return [...pluginPool, ...additional];\n  }\n\n  /**\n   * Creates the agent configuration object.\n   *\n   * @param signer - The signer instance\n   * @param llm - The language model instance\n   * @param allPlugins - Array of plugins to use\n   * @returns Configuration object for creating the agent\n   */\n  private createAgentConfig(\n    signer: ServerSigner,\n    llm: ChatOpenAI | ChatAnthropic,\n    allPlugins: BasePlugin[]\n  ): Parameters<typeof createAgent>[0] {\n    const {\n      operationalMode = DEFAULT_OPERATIONAL_MODE,\n      userAccountId,\n      scheduleUserTransactionsInBytesMode,\n      customSystemMessagePreamble,\n      customSystemMessagePostamble,\n      verbose = false,\n      mirrorNodeConfig,\n      disableLogging,\n      accountId = '',\n    } = this.options;\n\n    return {\n      framework: 'langchain',\n      signer,\n      execution: {\n        mode: operationalMode === 'autonomous' ? 'direct' : 'bytes',\n        operationalMode: operationalMode,\n        ...(userAccountId && { userAccountId }),\n        ...(scheduleUserTransactionsInBytesMode !== undefined && {\n          scheduleUserTransactionsInBytesMode:\n            scheduleUserTransactionsInBytesMode,\n          scheduleUserTransactions: scheduleUserTransactionsInBytesMode,\n        }),\n      },\n      ai: {\n        provider: new LangChainProvider(llm),\n        temperature: DEFAULT_TEMPERATURE,\n      },\n      filtering: {\n        toolPredicate: (tool: ToolDescriptor): boolean => {\n          if (tool.name === 'hedera-account-transfer-hbar') return false;\n          if (this.options.toolFilter && !this.options.toolFilter(tool)) {\n            return false;\n          }\n          return true;\n        },\n      },\n      messaging: {\n        systemPreamble:\n          customSystemMessagePreamble || getSystemMessage(accountId),\n        ...(customSystemMessagePostamble && {\n          systemPostamble: customSystemMessagePostamble,\n        }),\n        conciseMode: true,\n      },\n      extensions: {\n        plugins: allPlugins,\n        ...(mirrorNodeConfig && {\n          mirrorConfig: mirrorNodeConfig as Record<string, unknown>,\n        }),\n      },\n      ...(this.options.mcpServers && {\n        mcp: {\n          servers: this.options.mcpServers,\n          autoConnect: false,\n        },\n      }),\n      debug: {\n        verbose,\n        silent: disableLogging ?? false,\n      },\n    };\n  }\n\n  /**\n   * Configures the HCS-10 plugin with the state manager.\n   *\n   * @param allPlugins - Array of all plugins\n   */\n  private configureHCS10Plugin(allPlugins: BasePlugin[]): void {\n    const hcs10 = allPlugins.find((p) => p.id === 'hcs-10');\n    if (hcs10) {\n      (\n        hcs10 as BasePlugin & { appConfig?: Record<string, unknown> }\n      ).appConfig = {\n        stateManager: this.stateManager,\n      };\n    }\n  }\n\n  /**\n   * Create a ConversationalAgent with specific plugins enabled\n   */\n  private static withPlugins(\n    options: ConversationalAgentOptions,\n    plugins: string[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      enabledPlugins: plugins,\n    });\n  }\n\n  /**\n   * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled\n   */\n  static withHTS(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hts-token']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-2 tools enabled\n   */\n  static withHCS2(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-2']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only HCS-10 tools enabled\n   */\n  static withHCS10(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only inscription tools enabled\n   */\n  static withInscribe(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only account management tools enabled\n   */\n  static withAccount(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, ['account']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only file service tools enabled\n   */\n  static withFileService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['file-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only consensus service tools enabled\n   */\n  static withConsensusService(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['consensus-service']);\n  }\n\n  /**\n   * Create a ConversationalAgent with only smart contract tools enabled\n   */\n  static withSmartContract(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['smart-contract']);\n  }\n\n  /**\n   * Create a ConversationalAgent with all HCS standards plugins\n   */\n  static withAllStandards(\n    options: ConversationalAgentOptions\n  ): ConversationalAgent {\n    return this.withPlugins(options, ['hcs-10', 'hcs-2', 'inscribe']);\n  }\n\n  /**\n   * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)\n   */\n  static minimal(options: ConversationalAgentOptions): ConversationalAgent {\n    return this.withPlugins(options, []);\n  }\n\n  /**\n   * Create a ConversationalAgent with MCP servers configured\n   */\n  static withMCP(\n    options: ConversationalAgentOptions,\n    mcpServers: MCPServerConfig[]\n  ): ConversationalAgent {\n    return new ConversationalAgent({\n      ...options,\n      mcpServers,\n    });\n  }\n\n  /**\n   * Extract and store entities from agent responses\n   * @param response - Agent response containing potential entity information\n   * @param originalMessage - Original user message for context\n   */\n  private async extractAndStoreEntities(\n    response: unknown,\n    originalMessage: string\n  ): Promise<void> {\n    if (!this.memoryManager || !this.entityTools) {\n      return;\n    }\n\n    try {\n      this.logger.info('Starting LLM-based entity extraction');\n\n      const responseText = this.extractResponseText(response);\n\n      const entitiesJson = await this.entityTools.extractEntities.call({\n        response: responseText,\n        userMessage: originalMessage,\n      });\n\n      try {\n        const entities = JSON.parse(entitiesJson);\n\n        for (const entity of entities) {\n          if (\n            entity &&\n            typeof entity === 'object' &&\n            'name' in entity &&\n            'type' in entity &&\n            'id' in entity\n          ) {\n            this.logger.info(\n              `Storing entity: ${entity.name} (${entity.type}) -> ${entity.id}`\n            );\n\n            const transactionId = this.extractTransactionId(response);\n            const idStr = String(entity.id);\n            const isHederaId = /^0\\.0\\.[0-9]+$/.test(idStr);\n            if (!isHederaId) {\n              this.logger.warn('Skipping non-ID entity from extraction', {\n                id: idStr,\n                name: String(entity.name),\n                type: String(entity.type),\n              });\n            } else {\n              this.memoryManager.storeEntityAssociation(\n                idStr,\n                String(entity.name),\n                String(entity.type),\n                transactionId\n              );\n            }\n          }\n        }\n\n        if (entities.length > 0) {\n          this.logger.info(\n            `Stored ${entities.length} entities via LLM extraction`\n          );\n        } else {\n          this.logger.info('No entities found in response via LLM extraction');\n        }\n      } catch (parseError) {\n        this.logger.error(\n          'Failed to parse extracted entities JSON:',\n          parseError\n        );\n        throw parseError;\n      }\n    } catch (error) {\n      this.logger.error('Entity extraction failed:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Extract transaction ID from response if available\n   * @param response - Transaction response\n   * @returns Transaction ID or undefined\n   */\n  private extractTransactionId(response: unknown): string | undefined {\n    try {\n      if (\n        typeof response === 'object' &&\n        response &&\n        'transactionId' in response\n      ) {\n        const responseWithTxId = response as { transactionId?: unknown };\n        return typeof responseWithTxId.transactionId === 'string'\n          ? responseWithTxId.transactionId\n          : undefined;\n      }\n      if (typeof response === 'string') {\n        const match = response.match(\n          /transaction[\\s\\w]*ID[\\s:\"]*([0-9a-fA-F@._-]+)/i\n        );\n        return match ? match[1] : undefined;\n      }\n      return undefined;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Connect to MCP servers asynchronously\n   * @private\n   */\n  private connectMCP(): void {\n    if (!this.agent || !this.options.mcpServers) {\n      return;\n    }\n\n    this.agent\n      .connectMCPServers()\n      .catch((e) => {\n        this.logger.error('Failed to connect MCP servers:', e);\n      })\n      .then(() => {\n        this.logger.info('MCP servers connected successfully');\n      });\n  }\n\n  /**\n   * Get MCP connection status for all servers\n   * @returns {Map<string, MCPConnectionStatus>} Connection status map\n   */\n  getMCPConnectionStatus(): Map<string, MCPConnectionStatus> {\n    if (this.agent) {\n      return this.agent.getMCPConnectionStatus();\n    }\n    return new Map();\n  }\n\n  /**\n   * Check if a specific MCP server is connected\n   * @param {string} serverName - Name of the server to check\n   * @returns {boolean} True if connected, false otherwise\n   */\n  isMCPServerConnected(serverName: string): boolean {\n    if (this.agent) {\n      const statusMap = this.agent.getMCPConnectionStatus();\n      const status = statusMap.get(serverName);\n      return status?.connected ?? false;\n    }\n    return false;\n  }\n\n  /**\n   * Clean up resources\n   */\n  async cleanup(): Promise<void> {\n    try {\n      this.logger.info('Cleaning up ConversationalAgent...');\n\n      if (this.memoryManager) {\n        try {\n          this.memoryManager.dispose();\n          this.logger.info('Memory manager cleaned up successfully');\n        } catch (error) {\n          this.logger.warn('Error cleaning up memory manager:', error);\n        }\n        this.memoryManager = undefined;\n      }\n\n      if (this.contentStoreManager) {\n        await this.contentStoreManager.dispose();\n        this.logger.info('ContentStoreManager cleaned up');\n      }\n\n      this.logger.info('ConversationalAgent cleanup completed');\n    } catch (error) {\n      this.logger.error('Error during cleanup:', error);\n    }\n  }\n\n  /**\n   * Switch operational mode\n   */\n  switchMode(mode?: AgentOperationalMode): void {\n    if (this.agent?.switchMode) {\n      this.agent.switchMode(mode || 'autonomous');\n    }\n  }\n\n  /**\n   * Get usage statistics\n   */\n  getUsageStats(): unknown {\n    return this.agent?.getUsageStats?.() ?? {};\n  }\n\n  /**\n   * Clear usage statistics\n   */\n  clearUsageStats(): void {\n    if (this.agent?.clearUsageStats) {\n      this.agent.clearUsageStats();\n    }\n  }\n\n  /**\n   * Shutdown the agent\n   */\n  shutdown(): Promise<void> {\n    return this.agent?.shutdown?.() ?? Promise.resolve();\n  }\n\n  private extractResponseText(response: unknown): string {\n    if (typeof response === 'string') {\n      return response;\n    }\n\n    if (response && typeof response === 'object' && 'output' in response) {\n      const responseWithOutput = response as { output: unknown };\n      return String(responseWithOutput.output);\n    }\n\n    return JSON.stringify(response);\n  }\n}\n"],"names":["network"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,MAAM,qBAAqB;AAC3B,MAAM,uBAAuB;AAC7B,MAAM,2BAA2B;AACjC,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;AAC5B,MAAM,kBAAkB;AACxB,MAAM,2BAAiD;AA+DhD,MAAM,uBAAN,MAAM,qBAAoB;AAAA,EAmB/B,YAAY,SAAqC;AAC/C,SAAK,UAAU;AACf,SAAK,eAAe,QAAQ,gBAAgB,IAAI,gBAAA;AAChD,SAAK,cAAc,IAAI,YAAA;AACvB,SAAK,aAAa,IAAI,WAAA;AACtB,SAAK,iBAAiB,IAAI,eAAA;AAC1B,SAAK,aAAa,IAAI,WAAA;AACtB,SAAK,mBAAmB,IAAI,iBAAA;AAC5B,SAAK,SAAS,IAAI,OAAO;AAAA,MACvB,QAAQ;AAAA,MACR,QAAQ,QAAQ,kBAAkB;AAAA,IAAA,CACnC;AAED,QAAI,KAAK,QAAQ,wBAAwB,OAAO;AAC9C,UAAI,CAAC,QAAQ,cAAc;AACzB,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AAEA,WAAK,gBAAgB,IAAI;AAAA,QACvB,KAAK,QAAQ;AAAA,MAAA;AAEf,WAAK,OAAO,KAAK,2BAA2B;AAE5C,YAAM,WACJ,QAAQ,wBAAwB,QAAQ,eAAe;AACzD,UAAI,YAAY,QAAQ;AACxB,UAAI,CAAC,WAAW;AACd,YAAI,aAAa,aAAa;AAC5B,sBAAY;AAAA,QACd,WAAW,aAAa,cAAc;AACpC,sBAAY;AAAA,QACd,OAAO;AACL,sBAAY;AAAA,QACd;AAAA,MACF;AAEA,UAAI;AACJ,UAAI,aAAa,aAAa;AAC5B,sBAAc,IAAI,cAAc;AAAA,UAC9B,QAAQ,QAAQ;AAAA,UAChB,OAAO;AAAA,UACP,aAAa;AAAA,QAAA,CACd;AAAA,MACH,WAAW,aAAa,cAAc;AACpC,cAAM,UACJ,QAAQ,qBAAqB;AAC/B,cAAM,SAAS,QAAQ,oBAAoB,QAAQ;AACnD,sBAAc,IAAI,WAAW;AAAA,UAC3B;AAAA,UACA,OAAO;AAAA,UACP,aAAa;AAAA,UACb,eAAe;AAAA,YACb;AAAA,YACA,gBAAgB;AAAA,cACd,gBACE,QAAQ,IAAI,uBACZ;AAAA,cACF,WACE,QAAQ,IAAI,oBACZ;AAAA,YAAA;AAAA,UACJ;AAAA,QACF,CACD;AAAA,MACH,OAAO;AACL,sBAAc,IAAI,WAAW;AAAA,UAC3B,QAAQ,QAAQ;AAAA,UAChB,OAAO;AAAA,UACP,aAAa;AAAA,QAAA,CACd;AAAA,MACH;AAEA,WAAK,cAAc,kBAAkB,WAAW;AAChD,WAAK,OAAO,KAAK,6CAA6C;AAAA,IAChE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,aAA4B;AAChC,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA,UAAU;AAAA,MACV;AAAA,MACA,kBAAkB;AAAA,MAClB,cAAc;AAAA,IAAA,IACZ,KAAK;AAET,SAAK,gBAAgB,WAAW,UAAU;AAE1C,QAAI;AACF,YAAM,SAAU,KAAK,QAAQ,mBAC3B;AACF,YAAM,YAAY,WAAW;AAC7B,UAAI;AAEJ,UAAI;AAmBF,cAAM,KAAK;AACX,YAAI,OAAO,GAAG,wBAAwB,YAAY;AAChD,aAAG,oBAAoB,KAAK;AAAA,QAC9B;AAAA,MACF,SAAS,GAAG;AACV,aAAK,OAAO,KAAK,wCAAwC,CAAU;AAAA,MACrE;AACA,UAAI,CAAC,WAAW;AACd,iBAAS,IAAI;AAAA,UACX;AAAA,UACA;AAAA,UACA;AAAA,QAAA;AAAA,MAEJ,OAAO;AACL,cAAM,QACJ,OAAO,WAAW,SAAS,MAAM,YAAY,YAAY;AAC3D,cAAM,mBAAoB,KAAK,QAAQ,iBAAiB;AACxD,iBAAS,IAAI;AAAA,UACX;AAAA,UACA;AAAA,UACA,KAAK,QAAQ;AAAA,QAAA;AAAA,MAEjB;AAEA,WAAK,OAAO,KAAK,qBAAqB;AAAA,QACpC,iBAAiB;AAAA,QACjB;AAAA,QACA,aACE,OAAO,eAAe,MAAM,GAAG,aAAa,QAAQ;AAAA,MAAA,CACvD;AAED,UAAI;AACF,cAAM,SAAS,wBAAA;AACf,YAAI,QAAQ;AAkBV,gBAAM,KAAK;AACX,cAAI,OAAO,GAAG,0BAA0B,YAAY;AAClD,eAAG,sBAAsB,YAAY;AACnC,oBAAM,SAAS,MAAM,OAAO,OAAA;AAC5B,kBAAI,OAAO,aAAa,OAAO,aAAa,OAAO,SAAS;AAC1D,uBAAO,EAAE,WAAW,OAAO,WAAW,SAAS,OAAO,QAAA;AAAA,cACxD;AACA,qBAAO;AAAA,YACT,CAAC;AAAA,UACH;AACA,cAAI,OAAO,GAAG,sBAAsB,YAAY;AAC9C,eAAG;AAAA,cACD,OAAO,QAAgBA,aAAmC;AACxD,uBAAO,MAAM,OAAO,aAAa,QAAQA,QAAO;AAAA,cAClD;AAAA,YAAA;AAAA,UAEJ;AACA,cACE,OAAO,GAAG,gCAAgC,cAC1C,OAAO,kBACP;AACA,eAAG;AAAA,cACD,OACE,SACAA,aACG;AACH,uBAAO,MAAM,OAAO,iBAAkB,SAASA,QAAO;AAAA,cACxD;AAAA,YAAA;AAAA,UAEJ;AAEA,cAAI;AAwBF,kBAAM,SAAS,MAAM,OAAO,OAAA;AAC5B,kBAAM,gBAAgB,CAAC,EAAE,aAAa,OAAO;AAE7C,mCAAuB,sBAAsB,YAAY;AACvD,oBAAM,IAAI,MAAM,OAAO,OAAA;AACvB,kBAAI,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS;AAC3C,uBAAO;AAAA,kBACL,WAAW,EAAE;AAAA,kBACb,SAAS,EAAE;AAAA,gBAAA;AAAA,cAEf;AACA,qBAAO;AAAA,YACT,CAAC;AAED,mCAAuB;AAAA,cACrB,OAAO,QAAgBA,aAAmC;AACxD,uBAAO,MAAM,OAAO,aAAa,QAAQA,QAAO;AAAA,cAClD;AAAA,YAAA;AAGF,kBAAM,WAAW;AACjB,gBAAI,OAAO,UAAU,aAAa,YAAY;AAC5C,qCAAuB;AAAA,gBACrB,OAAO,IAAI,SAASA,aAAY;AAC9B,yBAAO,MAAM,SAAS;AAAA,oBACpB;AAAA,oBACA;AAAA,oBACAA;AAAAA,kBAAA;AAAA,gBAEJ;AAAA,cAAA;AAAA,YAEJ,OAAO;AACL,qCAAuB,oBAAoB,IAAI;AAAA,YACjD;AAEA,mCAAuB,oBAAoB,aAAa;AAKxD,kBAAM,MAAM;AACZ,gBAAI,OAAO,IAAI,wBAAwB,YAAY;AACjD,kBAAI,oBAAoB,aAAa;AAAA,YACvC;AAAA,UACF,SAAS,YAAY;AACnB,iBAAK,OAAO;AAAA,cACV;AAAA,cACA;AAAA,YAAA;AAAA,UAEJ;AAAA,QACF;AAAA,MACF,SAAS,GAAG;AACV,aAAK,OAAO;AAAA,UACV;AAAA,UACA;AAAA,QAAA;AAAA,MAEJ;AAEA,UAAI;AACJ,UAAI,eAAwC,EAAE,UAAU,YAAA;AACxD,UAAI,gBAAgB,aAAa;AAC/B,cAAM,IAAI,cAAc;AAAA,UACtB,QAAQ;AAAA,UACR,OAAO,mBAAmB;AAAA,UAC1B,aAAa;AAAA,QAAA,CACd;AACD,uBAAe;AAAA,UACb,GAAG;AAAA,UACH,OAAO,mBAAmB;AAAA,UAC1B,YAAY,CAAC,CAAC;AAAA,QAAA;AAAA,MAElB,WAAW,gBAAgB,cAAc;AACvC,cAAM,UACJ,KAAK,QAAQ,qBAAqB;AACpC,cAAM,SAAS,KAAK,QAAQ,oBAAoB;AAChD,cAAM,YACJ,mBAAmB;AACrB,cAAM,IAAI,WAAW;AAAA,UACnB;AAAA,UACA,OAAO;AAAA,UACP,aAAa;AAAA,UACb,eAAe;AAAA,YACb;AAAA,YACA,gBAAgB;AAAA,cACd,gBACE,QAAQ,IAAI,uBACZ;AAAA,cACF,WACE,QAAQ,IAAI,oBACZ;AAAA,YAAA;AAAA,UACJ;AAAA,QACF,CACD;AACD,uBAAe;AAAA,UACb,GAAG;AAAA,UACH,OAAO;AAAA,UACP;AAAA,UACA,YAAY,CAAC,CAAC;AAAA,QAAA;AAAA,MAElB,OAAO;AACL,cAAM,aAAa,mBAAmB;AACtC,cAAM,cACJ,WAAW,YAAA,EAAc,SAAS,OAAO,KACzC,WAAW,cAAc,SAAS,MAAM;AAC1C,cAAM,IAAI,WAAW;AAAA,UACnB,QAAQ;AAAA,UACR,OAAO;AAAA,UACP,GAAI,cACA,EAAE,aAAa,MACf,EAAE,aAAa,oBAAA;AAAA,QAAoB,CACxC;AACD,uBAAe;AAAA,UACb,GAAG;AAAA,UACH,OAAO;AAAA,UACP,YAAY,CAAC,CAAC;AAAA,QAAA;AAAA,MAElB;AAEA,WAAK,OAAO,KAAK,0BAA0B,YAAY;AAEvD,WAAK,OAAO,KAAK,sBAAsB;AACvC,YAAM,aAAa,KAAK,eAAA;AACxB,WAAK,OAAO,KAAK,0BAA0B;AAC3C,YAAM,cAAc,KAAK;AAAA,QACvB;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAGF,WAAK,OAAO,KAAK,mBAAmB;AACpC,WAAK,QAAQ,YAAY,WAAW;AACpC,WAAK,OAAO,KAAK,eAAe;AAEhC,WAAK,OAAO,KAAK,6BAA6B;AAC9C,WAAK,qBAAqB,UAAU;AACpC,WAAK,OAAO,KAAK,yBAAyB;AAE1C,WAAK,sBAAsB,IAAI,oBAAA;AAC/B,YAAM,KAAK,oBAAoB,WAAA;AAC/B,WAAK,OAAO;AAAA,QACV;AAAA,MAAA;AAGF,WAAK,OAAO,KAAK,4BAA4B;AAC7C,WAAK,OAAO,KAAK,+BAA+B;AAChD,YAAM,KAAK,MAAM,KAAA;AACjB,WAAK,OAAO,KAAK,wBAAwB;AACzC,WAAK,OAAO,KAAK,2BAA2B;AAE5C,UAAI,KAAK,OAAO;AACd,YAAI;AACF,gBAAM,WAAW,IAAI,wBAAA;AACrB,mBAAS,SAAS,IAAI,uBAAuB;AAC7C,mBAAS,SAAS,IAAI,8BAA8B;AACpD,gBAAM,eAAe,IAAI;AAAA,YACvB;AAAA,YACC,KAAK,QAAQ,WAAsC;AAAA,UAAA;AAEtD,uBAAa,cAAc,KAAK,OAAO;AAAA,YACrC,aAAa,YACX,KAAK,eAAe,sBAAA,KAA2B,CAAA;AAAA,UAAC,CACnD;AACD,eAAK,OAAO;AAAA,YACV;AAAA,UAAA;AAAA,QAEJ,SAAS,GAAG;AACV,eAAK,OAAO;AAAA,YACV;AAAA,YACA;AAAA,UAAA;AAAA,QAEJ;AAEA,cAAM,MAAM;AACZ,YAAI,YAAY,IAAI,aAAa,CAAA;AACjC,cAAM,oBAAoB,IAAI,UAAU;AAGxC,cAAM,gBAAgB,KAAK,QAAQ;AACnC,YAAI,UAAU,gBAAgB,CAAC,SAAkC;AAC/D,cAAI,QAAQ,KAAK,SAAS,gCAAgC;AACxD,mBAAO;AAAA,UACT;AACA,cAAI,QAAQ,KAAK,SAAS,4BAA4B;AACpD,mBAAO;AAAA,UACT;AACA,cAAI,qBAAqB,CAAC,kBAAkB,IAAI,GAAG;AACjD,mBAAO;AAAA,UACT;AACA,cAAI,iBAAiB,CAAC,cAAc,IAAI,GAAG;AACzC,mBAAO;AAAA,UACT;AACA,iBAAO;AAAA,QACT;AAAA,MACF;AAEA,UAAI,KAAK,QAAQ,cAAc,KAAK,QAAQ,WAAW,SAAS,GAAG;AACjE,aAAK,WAAA;AAAA,MACP;AAAA,IACF,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,6CAA6C,KAAK;AACpE,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAyB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,kBAAiC;AAC/B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,WAA2C;AACzC,QAAI,CAAC,KAAK,OAAO;AACf,YAAM,IAAI,MAAM,qBAAoB,qBAAqB;AAAA,IAC3D;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,yBAAyD;AACvD,WAAO,KAAK,SAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,eACJ,SACA,cAAiC,IACV;AACvB,QAAI,CAAC,KAAK,OAAO;AACf,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AAEA,QAAI;AACF,YAAM,kBAAkB;AAExB,YAAM,WAAW,YAAY,IAAI,CAAC,QAAQ;AACxC,cAAM,UAAU,IAAI;AACpB,YAAI,IAAI,SAAS,UAAU;AACzB,iBAAO,IAAI,cAAc,OAAO;AAAA,QAClC;AACA,eAAO,IAAI,SAAS,UAChB,IAAI,aAAa,OAAO,IACxB,IAAI,UAAU,OAAO;AAAA,MAC3B,CAAC;AAED,YAAM,UAA+B,EAAE,SAAA;AACvC,YAAM,WAAW,MAAM,KAAK,MAAM,KAAK,iBAAiB,OAAO;AAE/D,UACE,KAAK,iBACL,KAAK,QAAQ,oBAAoB,eACjC;AACA,cAAM,KAAK,wBAAwB,UAAU,OAAO;AAAA,MACtD;AAEA,WAAK,OAAO,KAAK,gCAAgC;AACjD,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,6BAA6B,KAAK;AACpD,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,sBACJ,YACuB;AACvB,QAAI,CAAC,KAAK,OAAO;AACf,YAAM,IAAI,MAAM,qBAAoB,qBAAqB;AAAA,IAC3D;AAEA,QAAI;AACF,WAAK,OAAO,KAAK,+BAA+B;AAAA,QAC9C,QAAQ,WAAW;AAAA,QACnB,UAAU,WAAW;AAAA,QACrB,eAAe,OAAO,KAAK,WAAW,cAAc,CAAA,CAAE;AAAA,QACtD,YAAY,CAAC,CAAC,WAAW;AAAA,MAAA,CAC1B;AACD,YAAM,WAAW,MAAM,KAAK,MAAM,sBAAsB,UAAU;AAClE,WAAK,OAAO,KAAK,wCAAwC;AACzD,aAAO;AAAA,IACT,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,qCAAqC,KAAK;AAC5D,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,gBAAgB,WAAoB,YAA2B;AACrE,UAAM,SAAU,KAAK,QAAQ,mBAC3B;AACF,UAAM,YAAY,WAAW;AAC7B,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,QAAI,CAAC,cAAc,CAAC,WAAW;AAC7B,YAAM,IAAI,MAAM,4CAA4C;AAAA,IAC9D;AAEA,QAAI,OAAO,cAAc,UAAU;AACjC,YAAM,IAAI;AAAA,QACR,yCAAyC,OAAO,SAAS;AAAA,MAAA;AAAA,IAE7D;AAEA,QAAI,CAAC,aAAa,OAAO,eAAe,UAAU;AAChD,YAAM,IAAI;AAAA,QACR,0CAA0C,OAAO,UAAU,KAAK,KAAK;AAAA,UACnE;AAAA,QAAA,CACD;AAAA,MAAA;AAAA,IAEL;AACA,QACE,CAAC,aACD,OAAO,eAAe,YACtB,WAAW,SAAS,IACpB;AACA,YAAM,IAAI,MAAM,+CAA+C;AAAA,IACjE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,iBAA+B;AACrC,UAAM,EAAE,oBAAoB,CAAA,GAAI,gBAAgB,gBAAA,IAAoB,KAAK;AAEzE,UAAM,kBAAgC;AAAA,MACpC,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IAAA;AAEP,oBAAgB,KAAK,KAAK,gBAAgB;AAE1C,UAAM,cAAc,wBAAA;AACpB,QAAI,aAAa,CAAC,GAAG,iBAAiB,GAAG,WAAW;AAEpD,QAAI,gBAAgB;AAClB,YAAM,aAAa,IAAI,IAAI,cAAc;AACzC,mBAAa,WAAW,OAAO,CAAC,WAAW,WAAW,IAAI,OAAO,EAAE,CAAC;AAAA,IACtE;AAEA,QAAI,mBAAmB,gBAAgB,SAAS,GAAG;AACjD,YAAM,cAAc,IAAI,IAAI,eAAe;AAC3C,mBAAa,WAAW,OAAO,CAAC,WAAW,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC;AAAA,IACxE;AAEA,UAAM,aAAa,mBAAmB,gBAAgB,SAAS,IAC3D,kBAAkB,OAAO,CAAC,WAAW,CAAC,gBAAgB,SAAS,OAAO,EAAE,CAAC,IACzE;AAEJ,WAAO,CAAC,GAAG,YAAY,GAAG,UAAU;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,kBACN,QACA,KACA,YACmC;AACnC,UAAM;AAAA,MACJ,kBAAkB;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU;AAAA,MACV;AAAA,MACA;AAAA,MACA,YAAY;AAAA,IAAA,IACV,KAAK;AAET,WAAO;AAAA,MACL,WAAW;AAAA,MACX;AAAA,MACA,WAAW;AAAA,QACT,MAAM,oBAAoB,eAAe,WAAW;AAAA,QACpD;AAAA,QACA,GAAI,iBAAiB,EAAE,cAAA;AAAA,QACvB,GAAI,wCAAwC,UAAa;AAAA,UACvD;AAAA,UAEA,0BAA0B;AAAA,QAAA;AAAA,MAC5B;AAAA,MAEF,IAAI;AAAA,QACF,UAAU,IAAI,kBAAkB,GAAG;AAAA,QACnC,aAAa;AAAA,MAAA;AAAA,MAEf,WAAW;AAAA,QACT,eAAe,CAAC,SAAkC;AAChD,cAAI,KAAK,SAAS,+BAAgC,QAAO;AACzD,cAAI,KAAK,QAAQ,cAAc,CAAC,KAAK,QAAQ,WAAW,IAAI,GAAG;AAC7D,mBAAO;AAAA,UACT;AACA,iBAAO;AAAA,QACT;AAAA,MAAA;AAAA,MAEF,WAAW;AAAA,QACT,gBACE,+BAA+B,iBAAiB,SAAS;AAAA,QAC3D,GAAI,gCAAgC;AAAA,UAClC,iBAAiB;AAAA,QAAA;AAAA,QAEnB,aAAa;AAAA,MAAA;AAAA,MAEf,YAAY;AAAA,QACV,SAAS;AAAA,QACT,GAAI,oBAAoB;AAAA,UACtB,cAAc;AAAA,QAAA;AAAA,MAChB;AAAA,MAEF,GAAI,KAAK,QAAQ,cAAc;AAAA,QAC7B,KAAK;AAAA,UACH,SAAS,KAAK,QAAQ;AAAA,UACtB,aAAa;AAAA,QAAA;AAAA,MACf;AAAA,MAEF,OAAO;AAAA,QACL;AAAA,QACA,QAAQ,kBAAkB;AAAA,MAAA;AAAA,IAC5B;AAAA,EAEJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,qBAAqB,YAAgC;AAC3D,UAAM,QAAQ,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,QAAQ;AACtD,QAAI,OAAO;AAEP,YACA,YAAY;AAAA,QACZ,cAAc,KAAK;AAAA,MAAA;AAAA,IAEvB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAe,YACb,SACA,SACqB;AACrB,WAAO,IAAI,qBAAoB;AAAA,MAC7B,GAAG;AAAA,MACH,gBAAgB;AAAA,IAAA,CACjB;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAQ,SAA0D;AACvE,WAAO,KAAK,YAAY,SAAS,CAAC,WAAW,CAAC;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAS,SAA0D;AACxE,WAAO,KAAK,YAAY,SAAS,CAAC,OAAO,CAAC;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,UAAU,SAA0D;AACzE,WAAO,KAAK,YAAY,SAAS,CAAC,QAAQ,CAAC;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,aACL,SACqB;AACrB,WAAO,KAAK,YAAY,SAAS,CAAC,UAAU,CAAC;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,YAAY,SAA0D;AAC3E,WAAO,KAAK,YAAY,SAAS,CAAC,SAAS,CAAC;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,gBACL,SACqB;AACrB,WAAO,KAAK,YAAY,SAAS,CAAC,cAAc,CAAC;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,qBACL,SACqB;AACrB,WAAO,KAAK,YAAY,SAAS,CAAC,mBAAmB,CAAC;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,kBACL,SACqB;AACrB,WAAO,KAAK,YAAY,SAAS,CAAC,gBAAgB,CAAC;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,iBACL,SACqB;AACrB,WAAO,KAAK,YAAY,SAAS,CAAC,UAAU,SAAS,UAAU,CAAC;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QAAQ,SAA0D;AACvE,WAAO,KAAK,YAAY,SAAS,EAAE;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,QACL,SACA,YACqB;AACrB,WAAO,IAAI,qBAAoB;AAAA,MAC7B,GAAG;AAAA,MACH;AAAA,IAAA,CACD;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAc,wBACZ,UACA,iBACe;AACf,QAAI,CAAC,KAAK,iBAAiB,CAAC,KAAK,aAAa;AAC5C;AAAA,IACF;AAEA,QAAI;AACF,WAAK,OAAO,KAAK,sCAAsC;AAEvD,YAAM,eAAe,KAAK,oBAAoB,QAAQ;AAEtD,YAAM,eAAe,MAAM,KAAK,YAAY,gBAAgB,KAAK;AAAA,QAC/D,UAAU;AAAA,QACV,aAAa;AAAA,MAAA,CACd;AAED,UAAI;AACF,cAAM,WAAW,KAAK,MAAM,YAAY;AAExC,mBAAW,UAAU,UAAU;AAC7B,cACE,UACA,OAAO,WAAW,YAClB,UAAU,UACV,UAAU,UACV,QAAQ,QACR;AACA,iBAAK,OAAO;AAAA,cACV,mBAAmB,OAAO,IAAI,KAAK,OAAO,IAAI,QAAQ,OAAO,EAAE;AAAA,YAAA;AAGjE,kBAAM,gBAAgB,KAAK,qBAAqB,QAAQ;AACxD,kBAAM,QAAQ,OAAO,OAAO,EAAE;AAC9B,kBAAM,aAAa,iBAAiB,KAAK,KAAK;AAC9C,gBAAI,CAAC,YAAY;AACf,mBAAK,OAAO,KAAK,0CAA0C;AAAA,gBACzD,IAAI;AAAA,gBACJ,MAAM,OAAO,OAAO,IAAI;AAAA,gBACxB,MAAM,OAAO,OAAO,IAAI;AAAA,cAAA,CACzB;AAAA,YACH,OAAO;AACL,mBAAK,cAAc;AAAA,gBACjB;AAAA,gBACA,OAAO,OAAO,IAAI;AAAA,gBAClB,OAAO,OAAO,IAAI;AAAA,gBAClB;AAAA,cAAA;AAAA,YAEJ;AAAA,UACF;AAAA,QACF;AAEA,YAAI,SAAS,SAAS,GAAG;AACvB,eAAK,OAAO;AAAA,YACV,UAAU,SAAS,MAAM;AAAA,UAAA;AAAA,QAE7B,OAAO;AACL,eAAK,OAAO,KAAK,kDAAkD;AAAA,QACrE;AAAA,MACF,SAAS,YAAY;AACnB,aAAK,OAAO;AAAA,UACV;AAAA,UACA;AAAA,QAAA;AAEF,cAAM;AAAA,MACR;AAAA,IACF,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,6BAA6B,KAAK;AACpD,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,qBAAqB,UAAuC;AAClE,QAAI;AACF,UACE,OAAO,aAAa,YACpB,YACA,mBAAmB,UACnB;AACA,cAAM,mBAAmB;AACzB,eAAO,OAAO,iBAAiB,kBAAkB,WAC7C,iBAAiB,gBACjB;AAAA,MACN;AACA,UAAI,OAAO,aAAa,UAAU;AAChC,cAAM,QAAQ,SAAS;AAAA,UACrB;AAAA,QAAA;AAEF,eAAO,QAAQ,MAAM,CAAC,IAAI;AAAA,MAC5B;AACA,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,aAAmB;AACzB,QAAI,CAAC,KAAK,SAAS,CAAC,KAAK,QAAQ,YAAY;AAC3C;AAAA,IACF;AAEA,SAAK,MACF,kBAAA,EACA,MAAM,CAAC,MAAM;AACZ,WAAK,OAAO,MAAM,kCAAkC,CAAC;AAAA,IACvD,CAAC,EACA,KAAK,MAAM;AACV,WAAK,OAAO,KAAK,oCAAoC;AAAA,IACvD,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,yBAA2D;AACzD,QAAI,KAAK,OAAO;AACd,aAAO,KAAK,MAAM,uBAAA;AAAA,IACpB;AACA,+BAAW,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAAqB,YAA6B;AAChD,QAAI,KAAK,OAAO;AACd,YAAM,YAAY,KAAK,MAAM,uBAAA;AAC7B,YAAM,SAAS,UAAU,IAAI,UAAU;AACvC,aAAO,QAAQ,aAAa;AAAA,IAC9B;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAyB;AAC7B,QAAI;AACF,WAAK,OAAO,KAAK,oCAAoC;AAErD,UAAI,KAAK,eAAe;AACtB,YAAI;AACF,eAAK,cAAc,QAAA;AACnB,eAAK,OAAO,KAAK,wCAAwC;AAAA,QAC3D,SAAS,OAAO;AACd,eAAK,OAAO,KAAK,qCAAqC,KAAK;AAAA,QAC7D;AACA,aAAK,gBAAgB;AAAA,MACvB;AAEA,UAAI,KAAK,qBAAqB;AAC5B,cAAM,KAAK,oBAAoB,QAAA;AAC/B,aAAK,OAAO,KAAK,gCAAgC;AAAA,MACnD;AAEA,WAAK,OAAO,KAAK,uCAAuC;AAAA,IAC1D,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,yBAAyB,KAAK;AAAA,IAClD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,MAAmC;AAC5C,QAAI,KAAK,OAAO,YAAY;AAC1B,WAAK,MAAM,WAAW,QAAQ,YAAY;AAAA,IAC5C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAyB;AACvB,WAAO,KAAK,OAAO,gBAAA,KAAqB,CAAA;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA,EAKA,kBAAwB;AACtB,QAAI,KAAK,OAAO,iBAAiB;AAC/B,WAAK,MAAM,gBAAA;AAAA,IACb;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,WAA0B;AACxB,WAAO,KAAK,OAAO,WAAA,KAAgB,QAAQ,QAAA;AAAA,EAC7C;AAAA,EAEQ,oBAAoB,UAA2B;AACrD,QAAI,OAAO,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAEA,QAAI,YAAY,OAAO,aAAa,YAAY,YAAY,UAAU;AACpE,YAAM,qBAAqB;AAC3B,aAAO,OAAO,mBAAmB,MAAM;AAAA,IACzC;AAEA,WAAO,KAAK,UAAU,QAAQ;AAAA,EAChC;AACF;AAniCE,qBAAwB,wBACtB;AAFG,IAAM,sBAAN;"}

package/dist/types/conversational-agent.d.ts

@@ -6,6 +6,7 @@ import { HCS10Plugin } from './plugins/hcs-10/HCS10Plugin';
 import { HCS2Plugin } from './plugins/hcs-2/HCS2Plugin';
 import { InscribePlugin } from './plugins/inscribe/InscribePlugin';
 import { HbarPlugin } from './plugins/hbar/HbarPlugin';
+import { WebBrowserPlugin } from './plugins/web-browser/WebBrowserPlugin';
 import { IStateManager } from '@hashgraphonline/standards-agent-kit';
 import { MCPServerConfig, MCPConnectionStatus } from './mcp/types';
 import { ContentStoreManager } from './services/content-store-manager';
@@ -40,6 +41,7 @@ export interface ConversationalAgentOptions {
     mirrorNodeConfig?: MirrorNodeConfig;
     disableLogging?: boolean;
     enabledPlugins?: string[];
+    disabledPlugins?: string[];
     toolFilter?: (tool: {
         name: string;
         namespace?: string;
@@ -85,6 +87,7 @@ export declare class ConversationalAgent {
     hcs2Plugin: HCS2Plugin;
     inscribePlugin: InscribePlugin;
     hbarPlugin: HbarPlugin;
+    webBrowserPlugin: WebBrowserPlugin;
     stateManager: IStateManager;
     private options;
     logger: Logger;

package/dist/types/plugins/index.d.ts

@@ -3,3 +3,4 @@ export { HCS2Plugin } from './hcs-2';
 export { InscribePlugin } from './inscribe';
 export { HbarPlugin } from './hbar/HbarPlugin';
 export * from './hbar';
+export { WebBrowserPlugin } from './web-browser/WebBrowserPlugin';

package/dist/types/plugins/web-browser/WebBrowserPlugin.d.ts

@@ -0,0 +1,14 @@
+import { BasePlugin, GenericPluginContext, HederaTool } from 'hedera-agent-kit';
+
+export declare class WebBrowserPlugin extends BasePlugin<GenericPluginContext> {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    author: string;
+    namespace: string;
+    private tools;
+    initialize(context: GenericPluginContext): Promise<void>;
+    getTools(): HederaTool[];
+    cleanup(): Promise<void>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hashgraphonline/conversational-agent",
-  "version": "0.2.201",
+  "version": "0.2.203",
   "type": "module",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",
@@ -99,9 +99,9 @@
   },
   "dependencies": {
     "@hashgraph/sdk": "^2.72.0",
-    "@hashgraphonline/hashinal-wc": "^1.0.106",
-    "@hashgraphonline/standards-agent-kit": "^0.2.143",
-    "@hashgraphonline/standards-sdk": "0.1.106",
+    "@hashgraphonline/hashinal-wc": "^1.0.107",
+    "@hashgraphonline/standards-agent-kit": "^0.2.145",
+    "@hashgraphonline/standards-sdk": "0.1.108",
     "@langchain/anthropic": "^0.3.28",
     "@langchain/core": "^0.3.77",
     "@langchain/openai": "^0.6.13",

package/src/conversational-agent.ts

@@ -26,6 +26,7 @@ import {
   SignerProviderRegistry,
 } from '@hashgraphonline/standards-agent-kit';
 import { HbarPlugin } from './plugins/hbar/HbarPlugin';
+import { WebBrowserPlugin } from './plugins/web-browser/WebBrowserPlugin';
 import { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';
 import type { IStateManager } from '@hashgraphonline/standards-agent-kit';
 import { getSystemMessage } from './config/system-message';
@@ -83,6 +84,7 @@ export interface ConversationalAgentOptions {
   mirrorNodeConfig?: MirrorNodeConfig;
   disableLogging?: boolean;
   enabledPlugins?: string[];
+  disabledPlugins?: string[];
   toolFilter?: (tool: { name: string; namespace?: string }) => boolean;
   mcpServers?: MCPServerConfig[];
   walletExecutor?: (
@@ -133,6 +135,7 @@ export class ConversationalAgent {
   public hcs2Plugin: HCS2Plugin;
   public inscribePlugin: InscribePlugin;
   public hbarPlugin: HbarPlugin;
+  public webBrowserPlugin: WebBrowserPlugin;
   public stateManager: IStateManager;
   private options: ConversationalAgentOptions;
   public logger: Logger;
@@ -150,6 +153,7 @@ export class ConversationalAgent {
     this.hcs2Plugin = new HCS2Plugin();
     this.inscribePlugin = new InscribePlugin();
     this.hbarPlugin = new HbarPlugin();
+    this.webBrowserPlugin = new WebBrowserPlugin();
     this.logger = new Logger({
       module: 'ConversationalAgent',
       silent: options.disableLogging || false,
@@ -730,26 +734,34 @@ export class ConversationalAgent {
    * @returns Array of plugins to initialize with the agent
    */
   private preparePlugins(): BasePlugin[] {
-    const { additionalPlugins = [], enabledPlugins } = this.options;
+    const { additionalPlugins = [], enabledPlugins, disabledPlugins } = this.options;
 
-    const standardPlugins = [
+    const standardPlugins: BasePlugin[] = [
       this.hcs10Plugin,
       this.hcs2Plugin,
       this.inscribePlugin,
       this.hbarPlugin,
     ];
+    standardPlugins.push(this.webBrowserPlugin);
 
     const corePlugins = getAllHederaCorePlugins();
+    let pluginPool = [...standardPlugins, ...corePlugins];
 
     if (enabledPlugins) {
       const enabledSet = new Set(enabledPlugins);
-      const filteredPlugins = [...standardPlugins, ...corePlugins].filter(
-        (plugin) => enabledSet.has(plugin.id)
-      );
-      return [...filteredPlugins, ...additionalPlugins];
+      pluginPool = pluginPool.filter((plugin) => enabledSet.has(plugin.id));
+    }
+
+    if (disabledPlugins && disabledPlugins.length > 0) {
+      const disabledSet = new Set(disabledPlugins);
+      pluginPool = pluginPool.filter((plugin) => !disabledSet.has(plugin.id));
     }
 
-    return [...standardPlugins, ...corePlugins, ...additionalPlugins];
+    const additional = disabledPlugins && disabledPlugins.length > 0
+      ? additionalPlugins.filter((plugin) => !disabledPlugins.includes(plugin.id))
+      : additionalPlugins;
+
+    return [...pluginPool, ...additional];
   }
 
   /**

package/src/plugins/index.ts

@@ -2,4 +2,5 @@ export { HCS10Plugin } from './hcs-10';
 export { HCS2Plugin } from './hcs-2';
 export { InscribePlugin } from './inscribe';
 export { HbarPlugin } from './hbar/HbarPlugin';
-export * from './hbar';
+export * from './hbar';
+export { WebBrowserPlugin } from './web-browser/WebBrowserPlugin';

package/src/plugins/web-browser/WebBrowserPlugin.ts

@@ -0,0 +1,128 @@
+import {
+  BasePlugin,
+  type GenericPluginContext,
+  BaseHederaQueryTool,
+  type HederaAgentKit,
+  type HederaTool,
+} from 'hedera-agent-kit';
+import { z } from 'zod';
+
+const PageSnapshotSchema = z.object({
+  url: z.string().url(),
+  maxCharacters: z
+    .number()
+    .int()
+    .min(256, 'Minimum length is 256 characters')
+    .max(8000, 'Maximum length is 8000 characters')
+    .optional()
+    .default(3000),
+});
+
+class WebPageSnapshotTool extends BaseHederaQueryTool<typeof PageSnapshotSchema> {
+  name = 'web_page_snapshot';
+  description = 'Fetches the visible text content of a web page for analysis.';
+  namespace = 'browser';
+  specificInputSchema = PageSnapshotSchema;
+
+  constructor(params: {
+    hederaKit: HederaAgentKit;
+    logger?: GenericPluginContext['logger'];
+    fetchImpl?: typeof fetch;
+  }) {
+    const { fetchImpl, ...rest } = params;
+    super(rest);
+    this.fetchImpl = fetchImpl ?? fetch;
+  }
+
+  private readonly fetchImpl: typeof fetch;
+
+  protected async executeQuery(
+    input: z.infer<typeof PageSnapshotSchema>
+  ): Promise<string> {
+    const maxChars = input.maxCharacters ?? 3000;
+
+    try {
+      const response = await this.fetchImpl(input.url, {
+        redirect: 'follow',
+      });
+
+      if (!response.ok) {
+        return `Failed to load ${input.url}: HTTP ${response.status}`;
+      }
+
+      const html = await response.text();
+      const text = this.normalizeHtml(html);
+
+      if (!text) {
+        return 'The fetched page did not contain readable text.';
+      }
+
+      return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+    } catch (error) {
+      this.logger.error('WebPageSnapshotTool failed', error);
+      return `Failed to fetch content for ${input.url}: ${
+        error instanceof Error ? error.message : String(error)
+      }`;
+    }
+  }
+
+  private normalizeHtml(html: string): string {
+    const withoutScripts = html
+      .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+      .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+      .replace(/<!--([\s\S]*?)-->/g, ' ');
+
+    const stripped = withoutScripts.replace(/<[^>]+>/g, ' ');
+    const decoded = stripped
+      .replace(/&nbsp;/gi, ' ')
+      .replace(/&amp;/gi, '&')
+      .replace(/&lt;/gi, '<')
+      .replace(/&gt;/gi, '>')
+      .replace(/&quot;/gi, '"')
+      .replace(/&#39;/gi, "'");
+
+    return decoded.replace(/\s+/g, ' ').trim();
+  }
+}
+
+export class WebBrowserPlugin extends BasePlugin<GenericPluginContext> {
+  id = 'web-browser';
+  name = 'Web Browser Plugin';
+  description =
+    'Provides tools for fetching live web page content to enrich assistant understanding.';
+  version = '0.1.0';
+  author = 'Hashgraph Online';
+  namespace = 'browser';
+
+  private tools: HederaTool[] = [];
+
+  override async initialize(context: GenericPluginContext): Promise<void> {
+    await super.initialize(context);
+
+    const hederaKit = context.config.hederaKit as HederaAgentKit | undefined;
+
+    if (!hederaKit) {
+      this.context.logger.warn(
+        'WebBrowserPlugin skipped because HederaAgentKit was not present in plugin context.'
+      );
+      this.tools = [];
+      return;
+    }
+
+    const tool = new WebPageSnapshotTool({
+      hederaKit,
+      logger: this.context.logger,
+    });
+
+    this.tools = [tool];
+    this.context.logger.info('Web Browser Plugin initialized with snapshot tool');
+  }
+
+  override getTools(): HederaTool[] {
+    return this.tools;
+  }
+
+  override async cleanup(): Promise<void> {
+    this.tools = [];
+  }
+}