@hashgraphonline/conversational-agent 0.0.3 → 0.1.1

package/dist/esm/index6.js

@@ -1,16 +1,298 @@
-const getSystemMessage = (accountId) => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, and content inscription.
-
-You have access to tools for:
-- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages
-- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents
-- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions
-
-*** IMPORTANT CONTEXT ***
-You are currently operating as agent: ${accountId} on the Hashgraph Online network
-When users ask about "my profile", "my account", "my connections", etc., use this account ID: ${accountId}
-
-Remember the connection numbers when listing connections, as users might refer to them.`;
+import { ServerSigner, getAllHederaCorePlugins } from "hedera-agent-kit";
+import { Logger, HederaMirrorNode } from "@hashgraphonline/standards-sdk";
+import { createAgent } from "./index9.js";
+import { LangChainProvider } from "./index10.js";
+import { ChatOpenAI } from "@langchain/openai";
+import { HumanMessage, AIMessage } from "@langchain/core/messages";
+import { HCS10Plugin } from "./index2.js";
+import { HCS2Plugin } from "./index3.js";
+import { InscribePlugin } from "./index4.js";
+import { HbarTransferPlugin } from "./index5.js";
+import { OpenConvaiState } from "@hashgraphonline/standards-agent-kit";
+import { PrivateKey } from "@hashgraph/sdk";
+import { getSystemMessage } from "./index13.js";
+const DEFAULT_MODEL_NAME = "gpt-4o";
+const DEFAULT_TEMPERATURE = 0.1;
+const DEFAULT_NETWORK = "testnet";
+const DEFAULT_OPERATIONAL_MODE = "autonomous";
+class ConversationalAgent {
+  constructor(options) {
+    this.options = options;
+    this.stateManager = options.stateManager || new OpenConvaiState();
+    this.hcs10Plugin = new HCS10Plugin();
+    this.hcs2Plugin = new HCS2Plugin();
+    this.inscribePlugin = new InscribePlugin();
+    this.hbarTransferPlugin = new HbarTransferPlugin();
+    this.logger = new Logger({
+      module: "ConversationalAgent",
+      silent: options.disableLogging || false
+    });
+  }
+  /**
+   * Initialize the conversational agent with Hedera network connection and AI configuration
+   * @throws {Error} If account ID or private key is missing
+   * @throws {Error} If initialization fails
+   */
+  async initialize() {
+    const {
+      accountId,
+      privateKey,
+      network = DEFAULT_NETWORK,
+      openAIApiKey,
+      openAIModelName = DEFAULT_MODEL_NAME,
+      verbose = false,
+      operationalMode = DEFAULT_OPERATIONAL_MODE,
+      userAccountId,
+      customSystemMessagePreamble,
+      customSystemMessagePostamble,
+      additionalPlugins = [],
+      mirrorNodeConfig,
+      disableLogging,
+      scheduleUserTransactionsInBytesMode
+    } = this.options;
+    if (!accountId || !privateKey) {
+      throw new Error("Account ID and private key are required");
+    }
+    try {
+      const privateKeyInstance = await this.detectPrivateKeyType(
+        accountId,
+        privateKey,
+        network
+      );
+      const serverSigner = new ServerSigner(
+        accountId,
+        privateKeyInstance,
+        network
+      );
+      const standardPlugins = [
+        this.hcs10Plugin,
+        this.hcs2Plugin,
+        this.inscribePlugin,
+        this.hbarTransferPlugin
+      ];
+      const corePlugins = getAllHederaCorePlugins();
+      let allPlugins;
+      if (this.options.enabledPlugins) {
+        const enabledSet = new Set(this.options.enabledPlugins);
+        const filteredPlugins = [...standardPlugins, ...corePlugins].filter(
+          (plugin) => enabledSet.has(plugin.id)
+        );
+        allPlugins = [...filteredPlugins, ...additionalPlugins];
+      } else {
+        allPlugins = [...standardPlugins, ...corePlugins, ...additionalPlugins];
+      }
+      const llm = new ChatOpenAI({
+        apiKey: openAIApiKey,
+        modelName: openAIModelName,
+        temperature: DEFAULT_TEMPERATURE
+      });
+      this.agent = createAgent({
+        framework: "langchain",
+        signer: serverSigner,
+        execution: {
+          mode: operationalMode === "autonomous" ? "direct" : "bytes",
+          operationalMode,
+          ...userAccountId && { userAccountId },
+          ...scheduleUserTransactionsInBytesMode !== void 0 && {
+            scheduleUserTransactions: scheduleUserTransactionsInBytesMode
+          }
+        },
+        ai: {
+          provider: new LangChainProvider(llm),
+          temperature: DEFAULT_TEMPERATURE
+        },
+        filtering: {
+          toolPredicate: (tool) => {
+            if (tool.name === "hedera-account-transfer-hbar") return false;
+            if (this.options.toolFilter && !this.options.toolFilter(tool)) {
+              return false;
+            }
+            return true;
+          }
+        },
+        messaging: {
+          systemPreamble: customSystemMessagePreamble || getSystemMessage(accountId),
+          ...customSystemMessagePostamble && { systemPostamble: customSystemMessagePostamble },
+          conciseMode: true
+        },
+        extensions: {
+          plugins: allPlugins,
+          ...mirrorNodeConfig && {
+            mirrorConfig: mirrorNodeConfig
+          }
+        },
+        ...this.options.mcpServers && {
+          mcp: {
+            servers: this.options.mcpServers,
+            autoConnect: true
+          }
+        },
+        debug: {
+          verbose,
+          silent: disableLogging ?? false
+        }
+      });
+      const hcs10 = allPlugins.find((p) => p.id === "hcs-10");
+      if (hcs10) {
+        hcs10.appConfig = {
+          stateManager: this.stateManager
+        };
+      }
+      await this.agent.boot();
+    } catch (error) {
+      this.logger.error("Failed to initialize ConversationalAgent:", error);
+      throw error;
+    }
+  }
+  /**
+   * Get the HCS-10 plugin instance
+   * @returns {HCS10Plugin} The HCS-10 plugin instance
+   */
+  getPlugin() {
+    return this.hcs10Plugin;
+  }
+  /**
+   * Get the state manager instance
+   * @returns {IStateManager} The state manager instance
+   */
+  getStateManager() {
+    return this.stateManager;
+  }
+  /**
+   * Get the underlying agent instance
+   * @returns {ReturnType<typeof createAgent>} The agent instance
+   * @throws {Error} If agent is not initialized
+   */
+  getAgent() {
+    if (!this.agent) {
+      throw new Error("Agent not initialized. Call initialize() first.");
+    }
+    return this.agent;
+  }
+  /**
+   * Get the conversational agent instance (alias for getAgent)
+   * @returns {ReturnType<typeof createAgent>} The agent instance
+   * @throws {Error} If agent is not initialized
+   */
+  getConversationalAgent() {
+    return this.getAgent();
+  }
+  /**
+   * Process a message through the conversational agent
+   * @param {string} message - The message to process
+   * @param {Array<{type: 'human' | 'ai'; content: string}>} chatHistory - Previous chat history
+   * @returns {Promise<ChatResponse>} The agent's response
+   * @throws {Error} If agent is not initialized
+   */
+  async processMessage(message, chatHistory = []) {
+    if (!this.agent) {
+      throw new Error("Agent not initialized. Call initialize() first.");
+    }
+    const messages = chatHistory.map(
+      (msg) => msg.type === "human" ? new HumanMessage(msg.content) : new AIMessage(msg.content)
+    );
+    const context = {
+      messages
+    };
+    return this.agent.chat(message, context);
+  }
+  /**
+   * Create a ConversationalAgent with specific plugins enabled
+   */
+  static withPlugins(options, plugins) {
+    return new ConversationalAgent({
+      ...options,
+      enabledPlugins: plugins
+    });
+  }
+  /**
+   * Create a ConversationalAgent with only HTS (Hedera Token Service) tools enabled
+   */
+  static withHTS(options) {
+    return this.withPlugins(options, ["hts-token"]);
+  }
+  /**
+   * Create a ConversationalAgent with only HCS-2 tools enabled
+   */
+  static withHCS2(options) {
+    return this.withPlugins(options, ["hcs-2"]);
+  }
+  /**
+   * Create a ConversationalAgent with only HCS-10 tools enabled
+   */
+  static withHCS10(options) {
+    return this.withPlugins(options, ["hcs-10"]);
+  }
+  /**
+   * Create a ConversationalAgent with only inscription tools enabled
+   */
+  static withInscribe(options) {
+    return this.withPlugins(options, ["inscribe"]);
+  }
+  /**
+   * Create a ConversationalAgent with only account management tools enabled
+   */
+  static withAccount(options) {
+    return this.withPlugins(options, ["account"]);
+  }
+  /**
+   * Create a ConversationalAgent with only file service tools enabled
+   */
+  static withFileService(options) {
+    return this.withPlugins(options, ["file-service"]);
+  }
+  /**
+   * Create a ConversationalAgent with only consensus service tools enabled
+   */
+  static withConsensusService(options) {
+    return this.withPlugins(options, ["consensus-service"]);
+  }
+  /**
+   * Create a ConversationalAgent with only smart contract tools enabled
+   */
+  static withSmartContract(options) {
+    return this.withPlugins(options, ["smart-contract"]);
+  }
+  /**
+   * Create a ConversationalAgent with all HCS standards plugins
+   */
+  static withAllStandards(options) {
+    return this.withPlugins(options, ["hcs-10", "hcs-2", "inscribe"]);
+  }
+  /**
+   * Create a ConversationalAgent with minimal Hedera tools (no HCS standards)
+   */
+  static minimal(options) {
+    return this.withPlugins(options, []);
+  }
+  /**
+   * Create a ConversationalAgent with MCP servers configured
+   */
+  static withMCP(options, mcpServers) {
+    return new ConversationalAgent({
+      ...options,
+      mcpServers
+    });
+  }
+  /**
+   * Detect the private key type by querying the account info from mirror node
+   * @param {string} accountId - The Hedera account ID
+   * @param {string} privateKey - The private key string
+   * @param {NetworkType} network - The Hedera network
+   * @returns {Promise<PrivateKey>} The appropriate PrivateKey instance
+   */
+  async detectPrivateKeyType(accountId, privateKey, network) {
+    const mirrorNode = new HederaMirrorNode(network);
+    const accountInfo = await mirrorNode.requestAccount(accountId);
+    const keyType = accountInfo?.key?._type || "";
+    if (keyType?.toLowerCase()?.includes("ecdsa")) {
+      return PrivateKey.fromStringECDSA(privateKey);
+    } else {
+      return PrivateKey.fromStringED25519(privateKey);
+    }
+  }
+}
 export {
-  getSystemMessage
+  ConversationalAgent
 };
 //# sourceMappingURL=index6.js.map

package/dist/esm/index6.js.map

@@ -1 +1 @@
-{"version":3,"file":"index6.js","sources":["../../src/config/system-message.ts"],"sourcesContent":["export const getSystemMessage = (accountId: string): string => `You are a helpful assistant managing Hashgraph Online HCS-10 connections, messages, HCS-2 registries, and content inscription.\n\nYou have access to tools for:\n- HCS-10: registering agents, finding registered agents, initiating connections, listing active connections, sending messages over connections, and checking for new messages\n- HCS-2: creating registries, registering entries, updating entries, deleting entries, migrating registries, and querying registry contents\n- Inscription: inscribing content from URLs, files, or buffers, creating Hashinal NFTs, and retrieving inscriptions\n\n*** IMPORTANT CONTEXT ***\nYou are currently operating as agent: ${accountId} on the Hashgraph Online network\nWhen users ask about \"my profile\", \"my account\", \"my connections\", etc., use this account ID: ${accountId}\n\nRemember the connection numbers when listing connections, as users might refer to them.`"],"names":[],"mappings":"AAAO,MAAM,mBAAmB,CAAC,cAA8B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wCAQvB,SAAS;AAAA,gGAC+C,SAAS;AAAA;AAAA;"}
+{"version":3,"file":"index6.js","sources":["../../src/conversational-agent.ts"],"sourcesContent":["import {\n  ServerSigner,\n  getAllHederaCorePlugins,\n  BasePlugin,\n} from 'hedera-agent-kit';\nimport {\n  HederaMirrorNode,\n  Logger,\n  type NetworkType,\n} from '@hashgraphonline/standards-sdk';\nimport { createAgent } from './agent-factory';\nimport { LangChainProvider } from './providers';\nimport type { ChatResponse, ConversationContext } from './base-agent';\nimport { ChatOpenAI } from '@langchain/openai';\nimport { HumanMessage, AIMessage } 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 { HbarTransferPlugin } from './plugins/hbar-transfer/HbarTransferPlugin';\nimport { OpenConvaiState } from '@hashgraphonline/standards-agent-kit';\nimport type { IStateManager } from '@hashgraphonline/standards-agent-kit';\nimport { PrivateKey } from '@hashgraph/sdk';\nimport { getSystemMessage } from './config/system-message';\nimport type { MCPServerConfig } from './mcp/types';\n\nconst DEFAULT_MODEL_NAME = 'gpt-4o';\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  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}\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 agent?: ReturnType<typeof createAgent>;\n  public hcs10Plugin: HCS10Plugin;\n  public hcs2Plugin: HCS2Plugin;\n  public inscribePlugin: InscribePlugin;\n  public hbarTransferPlugin: HbarTransferPlugin;\n  public stateManager: IStateManager;\n  private options: ConversationalAgentOptions;\n  private logger: Logger;\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.hbarTransferPlugin = new HbarTransferPlugin();\n    this.logger = new Logger({\n      module: 'ConversationalAgent',\n      silent: options.disableLogging || false,\n    });\n  }\n\n  /**\n   * Initialize the conversational agent with Hedera network 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      verbose = false,\n      operationalMode = DEFAULT_OPERATIONAL_MODE,\n      userAccountId,\n      customSystemMessagePreamble,\n      customSystemMessagePostamble,\n      additionalPlugins = [],\n      mirrorNodeConfig,\n      disableLogging,\n      scheduleUserTransactionsInBytesMode,\n    } = this.options;\n\n    if (!accountId || !privateKey) {\n      throw new Error('Account ID and private key are required');\n    }\n\n    try {\n      const privateKeyInstance = await this.detectPrivateKeyType(\n        accountId,\n        privateKey,\n        network\n      );\n\n      const serverSigner = new ServerSigner(\n        accountId,\n        privateKeyInstance,\n        network as 'testnet' | 'mainnet' | 'previewnet'\n      );\n\n      const standardPlugins = [\n        this.hcs10Plugin,\n        this.hcs2Plugin,\n        this.inscribePlugin,\n        this.hbarTransferPlugin,\n      ];\n\n      const corePlugins = getAllHederaCorePlugins();\n\n      let allPlugins: BasePlugin[];\n\n      if (this.options.enabledPlugins) {\n        const enabledSet = new Set(this.options.enabledPlugins);\n        const filteredPlugins = [...standardPlugins, ...corePlugins].filter(\n          (plugin) => enabledSet.has(plugin.id)\n        );\n        allPlugins = [...filteredPlugins, ...additionalPlugins];\n      } else {\n        allPlugins = [...standardPlugins, ...corePlugins, ...additionalPlugins];\n      }\n\n      const llm = new ChatOpenAI({\n        apiKey: openAIApiKey,\n        modelName: openAIModelName,\n        temperature: DEFAULT_TEMPERATURE,\n      });\n\n      this.agent = createAgent({\n        framework: 'langchain',\n        signer: serverSigner,\n        execution: {\n          mode: operationalMode === 'autonomous' ? 'direct' : 'bytes',\n          operationalMode: operationalMode,\n          ...(userAccountId && { userAccountId }),\n          ...(scheduleUserTransactionsInBytesMode !== undefined && {\n            scheduleUserTransactions: scheduleUserTransactionsInBytesMode,\n          }),\n        },\n        ai: {\n          provider: new LangChainProvider(llm),\n          temperature: DEFAULT_TEMPERATURE,\n        },\n        filtering: {\n          toolPredicate: (tool) => {\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 && { systemPostamble: customSystemMessagePostamble }),\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: true,\n          },\n        }),\n        debug: {\n          verbose,\n          silent: disableLogging ?? false,\n        },\n      });\n\n      const hcs10 = allPlugins.find((p) => p.id === 'hcs-10');\n      if (hcs10) {\n        (hcs10 as { appConfig?: Record<string, unknown> }).appConfig = {\n          stateManager: this.stateManager,\n        };\n      }\n\n      await this.agent.boot();\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('Agent not initialized. Call initialize() first.');\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: {\n      type: 'human' | 'ai';\n      content: string;\n    }[] = []\n  ): Promise<ChatResponse> {\n    if (!this.agent) {\n      throw new Error('Agent not initialized. Call initialize() first.');\n    }\n\n    const messages = chatHistory.map((msg) =>\n      msg.type === 'human'\n        ? new HumanMessage(msg.content)\n        : new AIMessage(msg.content)\n    );\n\n    const context: ConversationContext = {\n      messages,\n    };\n\n    return this.agent.chat(message, context);\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   * Detect the private key type by querying the account info from mirror node\n   * @param {string} accountId - The Hedera account ID\n   * @param {string} privateKey - The private key string\n   * @param {NetworkType} network - The Hedera network\n   * @returns {Promise<PrivateKey>} The appropriate PrivateKey instance\n   */\n  private async detectPrivateKeyType(\n    accountId: string,\n    privateKey: string,\n    network: NetworkType\n  ): Promise<PrivateKey> {\n    const mirrorNode = new HederaMirrorNode(network as 'testnet' | 'mainnet');\n    const accountInfo = await mirrorNode.requestAccount(accountId);\n\n    const keyType = accountInfo?.key?._type || '';\n\n    if (keyType?.toLowerCase()?.includes('ecdsa')) {\n      return PrivateKey.fromStringECDSA(privateKey);\n    } else {\n      return PrivateKey.fromStringED25519(privateKey);\n    }\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AA0BA,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAC5B,MAAM,kBAAkB;AACxB,MAAM,2BAAiD;AAgChD,MAAM,oBAAoB;AAAA,EAU/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,qBAAqB,IAAI,mBAAA;AAC9B,SAAK,SAAS,IAAI,OAAO;AAAA,MACvB,QAAQ;AAAA,MACR,QAAQ,QAAQ,kBAAkB;AAAA,IAAA,CACnC;AAAA,EACH;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,UAAU;AAAA,MACV,kBAAkB;AAAA,MAClB;AAAA,MACA;AAAA,MACA;AAAA,MACA,oBAAoB,CAAA;AAAA,MACpB;AAAA,MACA;AAAA,MACA;AAAA,IAAA,IACE,KAAK;AAET,QAAI,CAAC,aAAa,CAAC,YAAY;AAC7B,YAAM,IAAI,MAAM,yCAAyC;AAAA,IAC3D;AAEA,QAAI;AACF,YAAM,qBAAqB,MAAM,KAAK;AAAA,QACpC;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,eAAe,IAAI;AAAA,QACvB;AAAA,QACA;AAAA,QACA;AAAA,MAAA;AAGF,YAAM,kBAAkB;AAAA,QACtB,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,QACL,KAAK;AAAA,MAAA;AAGP,YAAM,cAAc,wBAAA;AAEpB,UAAI;AAEJ,UAAI,KAAK,QAAQ,gBAAgB;AAC/B,cAAM,aAAa,IAAI,IAAI,KAAK,QAAQ,cAAc;AACtD,cAAM,kBAAkB,CAAC,GAAG,iBAAiB,GAAG,WAAW,EAAE;AAAA,UAC3D,CAAC,WAAW,WAAW,IAAI,OAAO,EAAE;AAAA,QAAA;AAEtC,qBAAa,CAAC,GAAG,iBAAiB,GAAG,iBAAiB;AAAA,MACxD,OAAO;AACL,qBAAa,CAAC,GAAG,iBAAiB,GAAG,aAAa,GAAG,iBAAiB;AAAA,MACxE;AAEA,YAAM,MAAM,IAAI,WAAW;AAAA,QACzB,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,aAAa;AAAA,MAAA,CACd;AAED,WAAK,QAAQ,YAAY;AAAA,QACvB,WAAW;AAAA,QACX,QAAQ;AAAA,QACR,WAAW;AAAA,UACT,MAAM,oBAAoB,eAAe,WAAW;AAAA,UACpD;AAAA,UACA,GAAI,iBAAiB,EAAE,cAAA;AAAA,UACvB,GAAI,wCAAwC,UAAa;AAAA,YACvD,0BAA0B;AAAA,UAAA;AAAA,QAC5B;AAAA,QAEF,IAAI;AAAA,UACF,UAAU,IAAI,kBAAkB,GAAG;AAAA,UACnC,aAAa;AAAA,QAAA;AAAA,QAEf,WAAW;AAAA,UACT,eAAe,CAAC,SAAS;AACvB,gBAAI,KAAK,SAAS,+BAAgC,QAAO;AACzD,gBAAI,KAAK,QAAQ,cAAc,CAAC,KAAK,QAAQ,WAAW,IAAI,GAAG;AAC7D,qBAAO;AAAA,YACT;AACA,mBAAO;AAAA,UACT;AAAA,QAAA;AAAA,QAEF,WAAW;AAAA,UACT,gBACE,+BAA+B,iBAAiB,SAAS;AAAA,UAC3D,GAAI,gCAAgC,EAAE,iBAAiB,6BAAA;AAAA,UACvD,aAAa;AAAA,QAAA;AAAA,QAEf,YAAY;AAAA,UACV,SAAS;AAAA,UACT,GAAI,oBAAoB;AAAA,YACtB,cAAc;AAAA,UAAA;AAAA,QAChB;AAAA,QAEF,GAAI,KAAK,QAAQ,cAAc;AAAA,UAC7B,KAAK;AAAA,YACH,SAAS,KAAK,QAAQ;AAAA,YACtB,aAAa;AAAA,UAAA;AAAA,QACf;AAAA,QAEF,OAAO;AAAA,UACL;AAAA,UACA,QAAQ,kBAAkB;AAAA,QAAA;AAAA,MAC5B,CACD;AAED,YAAM,QAAQ,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,QAAQ;AACtD,UAAI,OAAO;AACR,cAAkD,YAAY;AAAA,UAC7D,cAAc,KAAK;AAAA,QAAA;AAAA,MAEvB;AAEA,YAAM,KAAK,MAAM,KAAA;AAAA,IACnB,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,iDAAiD;AAAA,IACnE;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,cAGM,IACiB;AACvB,QAAI,CAAC,KAAK,OAAO;AACf,YAAM,IAAI,MAAM,iDAAiD;AAAA,IACnE;AAEA,UAAM,WAAW,YAAY;AAAA,MAAI,CAAC,QAChC,IAAI,SAAS,UACT,IAAI,aAAa,IAAI,OAAO,IAC5B,IAAI,UAAU,IAAI,OAAO;AAAA,IAAA;AAG/B,UAAM,UAA+B;AAAA,MACnC;AAAA,IAAA;AAGF,WAAO,KAAK,MAAM,KAAK,SAAS,OAAO;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,OAAe,YACb,SACA,SACqB;AACrB,WAAO,IAAI,oBAAoB;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,oBAAoB;AAAA,MAC7B,GAAG;AAAA,MACH;AAAA,IAAA,CACD;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAc,qBACZ,WACA,YACA,SACqB;AACrB,UAAM,aAAa,IAAI,iBAAiB,OAAgC;AACxE,UAAM,cAAc,MAAM,WAAW,eAAe,SAAS;AAE7D,UAAM,UAAU,aAAa,KAAK,SAAS;AAE3C,QAAI,SAAS,YAAA,GAAe,SAAS,OAAO,GAAG;AAC7C,aAAO,WAAW,gBAAgB,UAAU;AAAA,IAC9C,OAAO;AACL,aAAO,WAAW,kBAAkB,UAAU;AAAA,IAChD;AAAA,EACF;AACF;"}

package/dist/esm/index7.js

@@ -0,0 +1,87 @@
+import { Logger } from "@hashgraphonline/standards-sdk";
+class BaseAgent {
+  constructor(config) {
+    this.config = config;
+    this.tools = [];
+    this.initialized = false;
+    this.logger = new Logger({
+      module: "BaseAgent",
+      silent: config.debug?.silent || false
+    });
+  }
+  getCore() {
+    return this.agentKit;
+  }
+  filterTools(tools) {
+    let filtered = [...tools];
+    const filter = this.config.filtering;
+    if (!filter) return filtered;
+    if (filter.namespaceWhitelist?.length) {
+      filtered = filtered.filter((tool) => {
+        const namespace = tool.namespace;
+        return !namespace || filter.namespaceWhitelist.includes(namespace);
+      });
+    }
+    if (filter.toolBlacklist?.length) {
+      filtered = filtered.filter(
+        (tool) => !filter.toolBlacklist.includes(tool.name)
+      );
+    }
+    if (filter.toolPredicate) {
+      filtered = filtered.filter(filter.toolPredicate);
+    }
+    this.logger.debug(`Filtered tools: ${tools.length} → ${filtered.length}`);
+    return filtered;
+  }
+  buildSystemPrompt() {
+    const parts = [];
+    const operatorId = this.config.signer.getAccountId().toString();
+    const userAccId = this.config.execution?.userAccountId;
+    if (this.config.messaging?.systemPreamble) {
+      parts.push(this.config.messaging.systemPreamble);
+    }
+    parts.push(
+      `You are a helpful Hedera assistant. Your primary operator account is ${operatorId}. You have tools to interact with the Hedera network. When using any tool, provide all necessary parameters as defined by that tool's schema and description.`
+    );
+    if (userAccId) {
+      parts.push(
+        `The user you are assisting has a personal Hedera account ID: ${userAccId}. IMPORTANT: When the user says things like "I want to send HBAR" or "transfer my tokens", you MUST use ${userAccId} as the sender/from account. For example, if user says "I want to send 2 HBAR to 0.0.800", you must set up a transfer where ${userAccId} sends the HBAR, not your operator account.`
+      );
+    }
+    const operationalMode = this.config.execution?.operationalMode || "returnBytes";
+    if (operationalMode === "autonomous") {
+      parts.push(
+        `
+OPERATIONAL MODE: 'autonomous'. Your goal is to execute transactions directly using your tools. Your account ${operatorId} will be the payer for these transactions. Even if the user's account (${userAccId || "a specified account"}) is the actor in the transaction body (e.g., sender of HBAR), you (the agent with operator ${operatorId}) are still executing and paying. For HBAR transfers, ensure the amounts in the 'transfers' array sum to zero (as per tool schema), balancing with your operator account if necessary.`
+      );
+    } else {
+      if (this.config.execution?.scheduleUserTransactionsInBytesMode && userAccId) {
+        parts.push(
+          `
+OPERATIONAL MODE: 'returnBytes' with scheduled transactions for user actions. When a user asks for a transaction to be prepared (e.g., creating a token, topic, transferring assets for them to sign, etc), you MUST default to creating a Scheduled Transaction using the appropriate tool with the metaOption 'schedule: true'. The user (with account ID ${userAccId}) will be the one to ultimately pay for and (if needed) sign the inner transaction. Your operator account (${operatorId}) will pay for creating the schedule entity itself. You MUST return the ScheduleId and details of the scheduled operation in a structured JSON format with these fields: success, op, schedule_id, description, payer_account_id_scheduled_tx, and scheduled_transaction_details.`
+        );
+      } else {
+        parts.push(
+          `
+OPERATIONAL MODE: 'returnBytes'. Your goal is to provide transaction bytes directly. When a user asks for a transaction to be prepared (e.g., for them to sign, or for scheduling without the default scheduling flow), you MUST call the appropriate tool. If you want raw bytes for the user to sign for their own account ${userAccId || "if specified"}, ensure the tool constructs the transaction body accordingly and use metaOption 'returnBytes: true' if available, or ensure the builder is configured for the user.`
+        );
+      }
+    }
+    if (this.config.messaging?.conciseMode !== false) {
+      parts.push(
+        "\nAlways be concise. If the tool provides a JSON string as its primary output (especially in returnBytes mode), make your accompanying text brief. If the tool does not provide JSON output or an error occurs, your narrative becomes primary; if notes were generated by the tool in such cases, append them to your textual response."
+      );
+    }
+    if (this.config.messaging?.systemPostamble) {
+      parts.push(this.config.messaging.systemPostamble);
+    }
+    return parts.join("\n");
+  }
+  isReady() {
+    return this.initialized;
+  }
+}
+export {
+  BaseAgent
+};
+//# sourceMappingURL=index7.js.map

package/dist/esm/index7.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index7.js","sources":["../../src/base-agent.ts"],"sourcesContent":["import type { BaseMessage } from '@langchain/core/messages';\nimport type { StructuredTool } from '@langchain/core/tools';\nimport type { TransactionReceipt } from '@hashgraph/sdk';\nimport {\n  HederaAgentKit,\n  ServerSigner,\n  TokenUsageCallbackHandler,\n  TokenUsage,\n  BasePlugin,\n} from 'hedera-agent-kit';\nimport type { CostCalculation } from 'hedera-agent-kit';\nimport type { AIProvider, VercelAIProvider, BAMLProvider } from './providers';\nimport { Logger } from '@hashgraphonline/standards-sdk';\nimport type { MCPServerConfig } from './mcp/types';\n\nexport interface ToolFilterConfig {\n  namespaceWhitelist?: string[];\n  toolBlacklist?: string[];\n  toolPredicate?: (tool: StructuredTool) => boolean;\n}\n\nexport type ExecutionMode = 'direct' | 'bytes';\nexport type OperationalMode = 'autonomous' | 'returnBytes';\n\nexport interface HederaAgentConfiguration {\n  signer: ServerSigner;\n  execution?: {\n    mode?: ExecutionMode;\n    operationalMode?: OperationalMode;\n    userAccountId?: string;\n    scheduleUserTransactions?: boolean;\n    scheduleUserTransactionsInBytesMode?: boolean;\n  };\n  ai?: {\n    provider?: AIProvider;\n    llm?: unknown;\n    apiKey?: string;\n    modelName?: string;\n    temperature?: number;\n  };\n  filtering?: ToolFilterConfig;\n  messaging?: {\n    systemPreamble?: string;\n    systemPostamble?: string;\n    conciseMode?: boolean;\n  };\n  extensions?: {\n    plugins?: BasePlugin[];\n    mirrorConfig?: Record<string, unknown>;\n    modelCapability?: string;\n  };\n  mcp?: {\n    servers?: MCPServerConfig[];\n    autoConnect?: boolean;\n  };\n  debug?: {\n    verbose?: boolean;\n    silent?: boolean;\n  };\n}\n\nexport interface ConversationContext {\n  messages: BaseMessage[];\n  metadata?: Record<string, unknown>;\n}\n\nexport interface ChatResponse {\n  output: string;\n  message?: string;\n  transactionBytes?: string;\n  receipt?: TransactionReceipt | object;\n  scheduleId?: string;\n  transactionId?: string;\n  notes?: string[];\n  error?: string;\n  intermediateSteps?: unknown;\n  rawToolOutput?: unknown;\n  tokenUsage?: TokenUsage;\n  cost?: CostCalculation;\n  metadata?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\nexport interface UsageStats extends TokenUsage {\n  cost: CostCalculation;\n}\n\nexport abstract class BaseAgent {\n  protected logger: Logger;\n  protected agentKit: HederaAgentKit | undefined;\n  protected tools: StructuredTool[] = [];\n  protected initialized = false;\n  protected tokenTracker: TokenUsageCallbackHandler | undefined;\n\n  constructor(protected config: HederaAgentConfiguration) {\n    this.logger = new Logger({\n      module: 'BaseAgent',\n      silent: config.debug?.silent || false,\n    });\n  }\n\n  abstract boot(): Promise<void>;\n  abstract chat(\n    message: string,\n    context?: ConversationContext\n  ): Promise<ChatResponse>;\n  abstract shutdown(): Promise<void>;\n  abstract switchMode(mode: OperationalMode): void;\n  abstract getUsageStats(): UsageStats;\n  abstract getUsageLog(): UsageStats[];\n  abstract clearUsageStats(): void;\n\n  getCore(): HederaAgentKit | undefined {\n    return this.agentKit;\n  }\n\n  protected filterTools(\n    tools: StructuredTool[]\n  ): StructuredTool[] {\n    let filtered = [...tools];\n    const filter = this.config.filtering;\n    if (!filter) return filtered;\n\n    if (filter.namespaceWhitelist?.length) {\n      filtered = filtered.filter((tool) => {\n        const namespace = (tool as StructuredTool & { namespace?: string })\n          .namespace;\n        return !namespace || filter.namespaceWhitelist!.includes(namespace);\n      });\n    }\n\n    if (filter.toolBlacklist?.length) {\n      filtered = filtered.filter(\n        (tool) => !filter.toolBlacklist!.includes(tool.name)\n      );\n    }\n\n    if (filter.toolPredicate) {\n      filtered = filtered.filter(filter.toolPredicate);\n    }\n\n    this.logger.debug(`Filtered tools: ${tools.length} → ${filtered.length}`);\n    return filtered;\n  }\n\n  protected buildSystemPrompt(): string {\n    const parts: string[] = [];\n    const operatorId = this.config.signer.getAccountId().toString();\n    const userAccId = this.config.execution?.userAccountId;\n\n    if (this.config.messaging?.systemPreamble) {\n      parts.push(this.config.messaging.systemPreamble);\n    }\n\n    parts.push(\n      `You are a helpful Hedera assistant. Your primary operator account is ${operatorId}. ` +\n        `You have tools to interact with the Hedera network. ` +\n        `When using any tool, provide all necessary parameters as defined by that tool's schema and description.`\n    );\n\n    if (userAccId) {\n      parts.push(\n        `The user you are assisting has a personal Hedera account ID: ${userAccId}. ` +\n          `IMPORTANT: When the user says things like \"I want to send HBAR\" or \"transfer my tokens\", you MUST use ${userAccId} as the sender/from account. ` +\n          `For example, if user says \"I want to send 2 HBAR to 0.0.800\", you must set up a transfer where ${userAccId} sends the HBAR, not your operator account.`\n      );\n    }\n\n    const operationalMode =\n      this.config.execution?.operationalMode || 'returnBytes';\n    if (operationalMode === 'autonomous') {\n      parts.push(\n        `\\nOPERATIONAL MODE: 'autonomous'. Your goal is to execute transactions directly using your tools. ` +\n          `Your account ${operatorId} will be the payer for these transactions. ` +\n          `Even if the user's account (${\n            userAccId || 'a specified account'\n          }) is the actor in the transaction body (e.g., sender of HBAR), ` +\n          `you (the agent with operator ${operatorId}) are still executing and paying. For HBAR transfers, ensure the amounts in the 'transfers' array sum to zero (as per tool schema), balancing with your operator account if necessary.`\n      );\n    } else {\n      if (\n        this.config.execution?.scheduleUserTransactionsInBytesMode &&\n        userAccId\n      ) {\n        parts.push(\n          `\\nOPERATIONAL MODE: 'returnBytes' with scheduled transactions for user actions. ` +\n            `When a user asks for a transaction to be prepared (e.g., creating a token, topic, transferring assets for them to sign, etc), ` +\n            `you MUST default to creating a Scheduled Transaction using the appropriate tool with the metaOption 'schedule: true'. ` +\n            `The user (with account ID ${userAccId}) will be the one to ultimately pay for and (if needed) sign the inner transaction. ` +\n            `Your operator account (${operatorId}) will pay for creating the schedule entity itself. ` +\n            `You MUST return the ScheduleId and details of the scheduled operation in a structured JSON format with these fields: success, op, schedule_id, description, payer_account_id_scheduled_tx, and scheduled_transaction_details.`\n        );\n      } else {\n        parts.push(\n          `\\nOPERATIONAL MODE: 'returnBytes'. Your goal is to provide transaction bytes directly. ` +\n            `When a user asks for a transaction to be prepared (e.g., for them to sign, or for scheduling without the default scheduling flow), ` +\n            `you MUST call the appropriate tool. If you want raw bytes for the user to sign for their own account ${\n              userAccId || 'if specified'\n            }, ensure the tool constructs the transaction body accordingly and use metaOption 'returnBytes: true' if available, or ensure the builder is configured for the user.`\n        );\n      }\n    }\n\n    if (this.config.messaging?.conciseMode !== false) {\n      parts.push(\n        '\\nAlways be concise. If the tool provides a JSON string as its primary output (especially in returnBytes mode), make your accompanying text brief. If the tool does not provide JSON output or an error occurs, your narrative becomes primary; if notes were generated by the tool in such cases, append them to your textual response.'\n      );\n    }\n\n    if (this.config.messaging?.systemPostamble) {\n      parts.push(this.config.messaging.systemPostamble);\n    }\n\n    return parts.join('\\n');\n  }\n\n  isReady(): boolean {\n    return this.initialized;\n  }\n}\n\nexport type { AIProvider, VercelAIProvider, BAMLProvider };\n"],"names":[],"mappings":";AAuFO,MAAe,UAAU;AAAA,EAO9B,YAAsB,QAAkC;AAAlC,SAAA,SAAA;AAJtB,SAAU,QAA0B,CAAA;AACpC,SAAU,cAAc;AAItB,SAAK,SAAS,IAAI,OAAO;AAAA,MACvB,QAAQ;AAAA,MACR,QAAQ,OAAO,OAAO,UAAU;AAAA,IAAA,CACjC;AAAA,EACH;AAAA,EAaA,UAAsC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA,EAEU,YACR,OACkB;AAClB,QAAI,WAAW,CAAC,GAAG,KAAK;AACxB,UAAM,SAAS,KAAK,OAAO;AAC3B,QAAI,CAAC,OAAQ,QAAO;AAEpB,QAAI,OAAO,oBAAoB,QAAQ;AACrC,iBAAW,SAAS,OAAO,CAAC,SAAS;AACnC,cAAM,YAAa,KAChB;AACH,eAAO,CAAC,aAAa,OAAO,mBAAoB,SAAS,SAAS;AAAA,MACpE,CAAC;AAAA,IACH;AAEA,QAAI,OAAO,eAAe,QAAQ;AAChC,iBAAW,SAAS;AAAA,QAClB,CAAC,SAAS,CAAC,OAAO,cAAe,SAAS,KAAK,IAAI;AAAA,MAAA;AAAA,IAEvD;AAEA,QAAI,OAAO,eAAe;AACxB,iBAAW,SAAS,OAAO,OAAO,aAAa;AAAA,IACjD;AAEA,SAAK,OAAO,MAAM,mBAAmB,MAAM,MAAM,MAAM,SAAS,MAAM,EAAE;AACxE,WAAO;AAAA,EACT;AAAA,EAEU,oBAA4B;AACpC,UAAM,QAAkB,CAAA;AACxB,UAAM,aAAa,KAAK,OAAO,OAAO,aAAA,EAAe,SAAA;AACrD,UAAM,YAAY,KAAK,OAAO,WAAW;AAEzC,QAAI,KAAK,OAAO,WAAW,gBAAgB;AACzC,YAAM,KAAK,KAAK,OAAO,UAAU,cAAc;AAAA,IACjD;AAEA,UAAM;AAAA,MACJ,wEAAwE,UAAU;AAAA,IAAA;AAKpF,QAAI,WAAW;AACb,YAAM;AAAA,QACJ,gEAAgE,SAAS,2GACkC,SAAS,+HAChB,SAAS;AAAA,MAAA;AAAA,IAEjH;AAEA,UAAM,kBACJ,KAAK,OAAO,WAAW,mBAAmB;AAC5C,QAAI,oBAAoB,cAAc;AACpC,YAAM;AAAA,QACJ;AAAA,+GACkB,UAAU,0EAExB,aAAa,qBACf,+FACgC,UAAU;AAAA,MAAA;AAAA,IAEhD,OAAO;AACL,UACE,KAAK,OAAO,WAAW,uCACvB,WACA;AACA,cAAM;AAAA,UACJ;AAAA,8VAG+B,SAAS,8GACZ,UAAU;AAAA,QAAA;AAAA,MAG1C,OAAO;AACL,cAAM;AAAA,UACJ;AAAA,+TAGI,aAAa,cACf;AAAA,QAAA;AAAA,MAEN;AAAA,IACF;AAEA,QAAI,KAAK,OAAO,WAAW,gBAAgB,OAAO;AAChD,YAAM;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,KAAK,OAAO,WAAW,iBAAiB;AAC1C,YAAM,KAAK,KAAK,OAAO,UAAU,eAAe;AAAA,IAClD;AAEA,WAAO,MAAM,KAAK,IAAI;AAAA,EACxB;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AACF;"}