@hashgraphonline/conversational-agent 0.2.103 → 0.2.105

package/dist/esm/index6.js

@@ -1,17 +1,19 @@
 import { ServerSigner, getAllHederaCorePlugins } from "hedera-agent-kit";
 import { Logger } from "@hashgraphonline/standards-sdk";
 import { createAgent } from "./index8.js";
+import { BrowserSigner } from "./index39.js";
 import { LangChainProvider } from "./index9.js";
 import { ChatOpenAI } from "@langchain/openai";
-import OpenAI from "openai";
 import { ChatAnthropic } from "@langchain/anthropic";
 import { SystemMessage, HumanMessage, AIMessage } from "@langchain/core/messages";
 import { HCS10Plugin } from "./index2.js";
 import { HCS2Plugin } from "./index3.js";
 import { InscribePlugin } from "./index4.js";
+import { getWalletBridgeProvider } from "./index36.js";
+import { OpenConvaiState, InscriberBuilder, SignerProviderRegistry } from "@hashgraphonline/standards-agent-kit";
 import { HbarPlugin } from "./index5.js";
-import { OpenConvaiState } from "@hashgraphonline/standards-agent-kit";
-import { getSystemMessage } from "./index38.js";
+import { WebBrowserPlugin } from "./index40.js";
+import { getSystemMessage } from "./index41.js";
 import { ContentStoreManager } from "./index24.js";
 import { SmartMemoryManager } from "./index18.js";
 import "./index19.js";
@@ -19,7 +21,14 @@ import "./index20.js";
 import "./index21.js";
 import "crypto";
 import { createEntityTools } from "./index34.js";
+import { ParameterService } from "./index29.js";
+import { FormatConverterRegistry } from "./index25.js";
+import { TopicIdToHrlConverter } from "./index27.js";
+import { StringNormalizationConverter } from "./index28.js";
 const DEFAULT_MODEL_NAME = "gpt-4o";
+const DEFAULT_OPENAI_MODEL = "gpt-4o-mini";
+const DEFAULT_OPENROUTER_MODEL = "openai/gpt-4o-mini";
+const DEFAULT_CLAUDE_MODEL = "claude-3-7-sonnet-latest";
 const DEFAULT_TEMPERATURE = 0.1;
 const DEFAULT_NETWORK = "testnet";
 const DEFAULT_OPERATIONAL_MODE = "autonomous";
@@ -31,6 +40,7 @@ const _ConversationalAgent = 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
@@ -46,7 +56,16 @@ const _ConversationalAgent = class _ConversationalAgent {
       );
       this.logger.info("Entity memory initialized");
       const provider = options.entityMemoryProvider || options.llmProvider || "openai";
-      const modelName = options.entityMemoryModelName || (provider === "anthropic" ? "claude-3-7-sonnet-latest" : provider === "openrouter" ? "openai/gpt-4o-mini" : "gpt-4o-mini");
+      let modelName = options.entityMemoryModelName;
+      if (!modelName) {
+        if (provider === "anthropic") {
+          modelName = DEFAULT_CLAUDE_MODEL;
+        } else if (provider === "openrouter") {
+          modelName = DEFAULT_OPENROUTER_MODEL;
+        } else {
+          modelName = DEFAULT_OPENAI_MODEL;
+        }
+      }
       let resolverLLM;
       if (provider === "anthropic") {
         resolverLLM = new ChatAnthropic({
@@ -57,19 +76,17 @@ const _ConversationalAgent = class _ConversationalAgent {
       } else if (provider === "openrouter") {
         const baseURL = options.openRouterBaseURL || "https://openrouter.ai/api/v1";
         const apiKey = options.openRouterApiKey || options.openAIApiKey;
-        const client = new OpenAI({
-          apiKey,
-          baseURL,
-          defaultHeaders: {
-            Referer: process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
-          }
-        });
         resolverLLM = new ChatOpenAI({
-          client,
+          apiKey,
           model: modelName,
-          temperature: 0
+          temperature: 0,
+          configuration: {
+            baseURL,
+            defaultHeaders: {
+              "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
+              "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
+            }
+          }
         });
       } else {
         resolverLLM = new ChatOpenAI({
@@ -98,41 +115,142 @@ const _ConversationalAgent = class _ConversationalAgent {
     } = this.options;
     this.validateOptions(accountId, privateKey);
     try {
-      const serverSigner = new ServerSigner(
-        accountId,
-        privateKey,
-        network
-      );
+      const opMode = this.options.operationalMode || DEFAULT_OPERATIONAL_MODE;
+      const bytesMode = opMode !== "autonomous";
+      let signer;
+      try {
+        const IB = InscriberBuilder;
+        if (typeof IB.setPreferWalletOnly === "function") {
+          IB.setPreferWalletOnly(false);
+        }
+      } catch (e) {
+        this.logger.warn("Failed to set wallet-only preference", e);
+      }
+      if (!bytesMode) {
+        signer = new ServerSigner(
+          accountId,
+          privateKey,
+          network
+        );
+      } else {
+        const chain = String(network || "testnet") === "mainnet" ? "mainnet" : "testnet";
+        const effectiveAccount = this.options.userAccountId || accountId;
+        signer = new BrowserSigner(
+          effectiveAccount,
+          chain,
+          this.options.walletExecutor
+        );
+      }
+      this.logger.info("Signer configured", {
+        operationalMode: opMode,
+        bytesMode,
+        signerClass: Object.getPrototypeOf(signer)?.constructor?.name || "unknown"
+      });
+      try {
+        const bridge = getWalletBridgeProvider();
+        if (bridge) {
+          const IB = InscriberBuilder;
+          if (typeof IB.setWalletInfoResolver === "function") {
+            IB.setWalletInfoResolver(async () => {
+              const status = await bridge.status();
+              if (status.connected && status.accountId && status.network) {
+                return { accountId: status.accountId, network: status.network };
+              }
+              return null;
+            });
+          }
+          if (typeof IB.setWalletExecutor === "function") {
+            IB.setWalletExecutor(
+              async (base64, network2) => {
+                return await bridge.executeBytes(base64, network2);
+              }
+            );
+          }
+          if (typeof IB.setStartInscriptionDelegate === "function" && bridge.startInscription) {
+            IB.setStartInscriptionDelegate(
+              async (request, network2) => {
+                return await bridge.startInscription(request, network2);
+              }
+            );
+          }
+          try {
+            const status = await bridge.status();
+            const enforceWallet = !!(bytesMode && status.connected);
+            SignerProviderRegistry.setWalletInfoResolver(async () => {
+              const s = await bridge.status();
+              if (s.connected && s.accountId && s.network) {
+                return {
+                  accountId: s.accountId,
+                  network: s.network
+                };
+              }
+              return null;
+            });
+            SignerProviderRegistry.setWalletExecutor(
+              async (base64, network2) => {
+                return await bridge.executeBytes(base64, network2);
+              }
+            );
+            const extended = bridge;
+            if (typeof extended?.startHCS === "function") {
+              SignerProviderRegistry.setStartHCSDelegate(
+                async (op, request, network2) => {
+                  return await extended.startHCS(
+                    op,
+                    request,
+                    network2
+                  );
+                }
+              );
+            } else {
+              SignerProviderRegistry.setStartHCSDelegate(null);
+            }
+            SignerProviderRegistry.setPreferWalletOnly(enforceWallet);
+            const IB2 = InscriberBuilder;
+            if (typeof IB2.setPreferWalletOnly === "function") {
+              IB2.setPreferWalletOnly(enforceWallet);
+            }
+          } catch (sakWireErr) {
+            this.logger.warn(
+              "Failed to wire SAK SignerProviderRegistry wallet delegates",
+              sakWireErr
+            );
+          }
+        }
+      } catch (e) {
+        this.logger.warn(
+          "Failed to register wallet bridge providers",
+          e
+        );
+      }
       let llm;
       let providerInfo = { provider: llmProvider };
       if (llmProvider === "anthropic") {
         llm = new ChatAnthropic({
           apiKey: openAIApiKey,
-          model: openAIModelName || "claude-3-7-sonnet-latest",
+          model: openAIModelName || DEFAULT_CLAUDE_MODEL,
           temperature: DEFAULT_TEMPERATURE
         });
         providerInfo = {
           ...providerInfo,
-          model: openAIModelName || "claude-3-7-sonnet-latest",
+          model: openAIModelName || DEFAULT_CLAUDE_MODEL,
           keyPresent: !!openAIApiKey
         };
       } else if (llmProvider === "openrouter") {
         const baseURL = this.options.openRouterBaseURL || "https://openrouter.ai/api/v1";
         const apiKey = this.options.openRouterApiKey || openAIApiKey;
         const modelName = openAIModelName || "anthropic/claude-3-haiku-20240307";
-        const client = new OpenAI({
-          apiKey,
-          baseURL,
-          defaultHeaders: {
-            Referer: process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
-            "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
-          }
-        });
         llm = new ChatOpenAI({
-          client,
+          apiKey,
           model: modelName,
-          temperature: DEFAULT_TEMPERATURE
+          temperature: DEFAULT_TEMPERATURE,
+          configuration: {
+            baseURL,
+            defaultHeaders: {
+              "HTTP-Referer": process.env.OPENROUTER_REFERRER || "https://hashgraphonline.com",
+              "X-Title": process.env.OPENROUTER_TITLE || "Hashgraph Online Conversational Agent"
+            }
+          }
         });
         providerInfo = {
           ...providerInfo,
@@ -141,16 +259,16 @@ const _ConversationalAgent = class _ConversationalAgent {
           keyPresent: !!apiKey
         };
       } else {
-        const modelName = openAIModelName || "gpt-4o-mini";
-        const isGPT5Model = modelName.toLowerCase().includes("gpt-5") || modelName.toLowerCase().includes("gpt5");
+        const modelName2 = openAIModelName || DEFAULT_OPENAI_MODEL;
+        const isGPT5Model = modelName2.toLowerCase().includes("gpt-5") || modelName2.toLowerCase().includes("gpt5");
         llm = new ChatOpenAI({
           apiKey: openAIApiKey,
-          model: modelName,
+          model: modelName2,
           ...isGPT5Model ? { temperature: 1 } : { temperature: DEFAULT_TEMPERATURE }
         });
         providerInfo = {
           ...providerInfo,
-          model: modelName,
+          model: modelName2,
           keyPresent: !!openAIApiKey
         };
       }
@@ -158,7 +276,11 @@ const _ConversationalAgent = class _ConversationalAgent {
       this.logger.info("Preparing plugins...");
       const allPlugins = this.preparePlugins();
       this.logger.info("Creating agent config...");
-      const agentConfig = this.createAgentConfig(serverSigner, llm, allPlugins);
+      const agentConfig = this.createAgentConfig(
+        signer,
+        llm,
+        allPlugins
+      );
       this.logger.info("Creating agent...");
       this.agent = createAgent(agentConfig);
       this.logger.info("Agent created");
@@ -176,6 +298,26 @@ const _ConversationalAgent = class _ConversationalAgent {
       this.logger.info("agent.boot() completed");
       this.logger.info("🔥 agent.boot() completed");
       if (this.agent) {
+        try {
+          const registry = new FormatConverterRegistry();
+          registry.register(new TopicIdToHrlConverter());
+          registry.register(new StringNormalizationConverter());
+          const paramService = new ParameterService(
+            registry,
+            this.options.network || "testnet"
+          );
+          paramService.attachToAgent(this.agent, {
+            getEntities: async () => this.memoryManager?.getEntityAssociations() || []
+          });
+          this.logger.info(
+            "Parameter preprocessing callback attached (internal)"
+          );
+        } catch (e) {
+          this.logger.warn(
+            "Failed to attach internal parameter preprocessing callback",
+            e
+          );
+        }
         const cfg = agentConfig;
         cfg.filtering = cfg.filtering || {};
         const originalPredicate = cfg.filtering.toolPredicate;
@@ -302,22 +444,27 @@ const _ConversationalAgent = class _ConversationalAgent {
    * @throws {Error} If required fields are missing
    */
   validateOptions(accountId, privateKey) {
-    if (!accountId || !privateKey) {
-      throw new Error("Account ID and private key are required");
+    const opMode = this.options.operationalMode || DEFAULT_OPERATIONAL_MODE;
+    const bytesMode = opMode !== "autonomous";
+    if (!accountId) {
+      throw new Error("Account ID is required");
+    }
+    if (!privateKey && !bytesMode) {
+      throw new Error("Private key is required in autonomous mode");
     }
     if (typeof accountId !== "string") {
       throw new Error(
         `Account ID must be a string, received ${typeof accountId}`
       );
     }
-    if (typeof privateKey !== "string") {
+    if (!bytesMode && typeof privateKey !== "string") {
       throw new Error(
         `Private key must be a string, received ${typeof privateKey}: ${JSON.stringify(
           privateKey
         )}`
       );
     }
-    if (privateKey.length < 10) {
+    if (!bytesMode && typeof privateKey === "string" && privateKey.length < 10) {
       throw new Error("Private key appears to be invalid (too short)");
     }
   }
@@ -327,32 +474,36 @@ const _ConversationalAgent = class _ConversationalAgent {
    * @returns Array of plugins to initialize with the agent
    */
   preparePlugins() {
-    const { additionalPlugins = [], enabledPlugins } = this.options;
+    const { additionalPlugins = [], enabledPlugins, disabledPlugins } = this.options;
     const standardPlugins = [
       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];
   }
   /**
    * Creates the agent configuration object.
    *
-   * @param serverSigner - The server signer instance
+   * @param signer - The signer instance
    * @param llm - The language model instance
    * @param allPlugins - Array of plugins to use
    * @returns Configuration object for creating the agent
    */
-  createAgentConfig(serverSigner, llm, allPlugins) {
+  createAgentConfig(signer, llm, allPlugins) {
     const {
       operationalMode = DEFAULT_OPERATIONAL_MODE,
       userAccountId,
@@ -366,7 +517,7 @@ const _ConversationalAgent = class _ConversationalAgent {
     } = this.options;
     return {
       framework: "langchain",
-      signer: serverSigner,
+      signer,
       execution: {
         mode: operationalMode === "autonomous" ? "direct" : "bytes",
         operationalMode,
@@ -579,7 +730,7 @@ const _ConversationalAgent = class _ConversationalAgent {
       }
       if (typeof response === "string") {
         const match = response.match(
-          /transaction[\s\w]*ID[\s:"]*([0-9a-fA-F@\.\-]+)/i
+          /transaction[\s\w]*ID[\s:"]*([0-9a-fA-F@._-]+)/i
         );
         return match ? match[1] : void 0;
       }
@@ -649,6 +800,34 @@ const _ConversationalAgent = class _ConversationalAgent {
       this.logger.error("Error during cleanup:", error);
     }
   }
+  /**
+   * Switch operational mode
+   */
+  switchMode(mode) {
+    if (this.agent?.switchMode) {
+      this.agent.switchMode(mode || "autonomous");
+    }
+  }
+  /**
+   * Get usage statistics
+   */
+  getUsageStats() {
+    return this.agent?.getUsageStats?.() ?? {};
+  }
+  /**
+   * Clear usage statistics
+   */
+  clearUsageStats() {
+    if (this.agent?.clearUsageStats) {
+      this.agent.clearUsageStats();
+    }
+  }
+  /**
+   * Shutdown the agent
+   */
+  shutdown() {
+    return this.agent?.shutdown?.() ?? Promise.resolve();
+  }
   extractResponseText(response) {
     if (typeof response === "string") {
       return response;