@hashgraphonline/conversational-agent 0.1.205 → 0.1.206

package/dist/esm/index7.js.map

@@ -1 +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;"}
+{"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  tool_calls?: Array<{\n    id: string;\n    name: string;\n    args: Record<string, unknown>;\n    output?: string;\n  }>;\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":";AA6FO,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;"}

package/dist/esm/index8.js

@@ -3,8 +3,9 @@ import { ChatPromptTemplate, MessagesPlaceholder } from "@langchain/core/prompts
 import { ChatOpenAI } from "@langchain/openai";
 import { TokenUsageCallbackHandler, calculateTokenCostSync, getAllHederaCorePlugins, HederaAgentKit } from "hedera-agent-kit";
 import { BaseAgent } from "./index7.js";
-import { MCPClientManager } from "./index14.js";
-import { convertMCPToolToLangChain } from "./index15.js";
+import { MCPClientManager } from "./index15.js";
+import { convertMCPToolToLangChain } from "./index16.js";
+import { SmartMemoryManager } from "./index17.js";
 class LangChainAgent extends BaseAgent {
   constructor() {
     super(...arguments);
@@ -25,7 +26,20 @@ class LangChainAgent extends BaseAgent {
       if (this.config.mcp?.servers && this.config.mcp.servers.length > 0) {
         await this.initializeMCP();
       }
+      this.smartMemory = new SmartMemoryManager({
+        modelName,
+        maxTokens: 9e4,
+        reserveTokens: 1e4,
+        storageLimit: 1e3
+      });
+      this.logger.info("SmartMemoryManager initialized:", {
+        modelName,
+        toolsCount: this.tools.length,
+        maxTokens: 9e4,
+        reserveTokens: 1e4
+      });
       this.systemMessage = this.buildSystemPrompt();
+      this.smartMemory.setSystemPrompt(this.systemMessage);
       await this.createExecutor();
       this.initialized = true;
       this.logger.info("LangChain Hedera agent initialized");
@@ -35,19 +49,49 @@ class LangChainAgent extends BaseAgent {
     }
   }
   async chat(message, context) {
-    if (!this.initialized || !this.executor) {
+    if (!this.initialized || !this.executor || !this.smartMemory) {
       throw new Error("Agent not initialized. Call boot() first.");
     }
     try {
+      this.logger.info("LangChainAgent.chat called with:", { message, contextLength: context?.messages?.length || 0 });
+      if (context?.messages && context.messages.length > 0) {
+        this.smartMemory.clear();
+        for (const msg of context.messages) {
+          this.smartMemory.addMessage(msg);
+        }
+      }
+      const { HumanMessage } = await import("@langchain/core/messages");
+      this.smartMemory.addMessage(new HumanMessage(message));
+      const memoryStats = this.smartMemory.getMemoryStats();
+      this.logger.info("Memory stats before execution:", {
+        totalMessages: memoryStats.totalActiveMessages,
+        currentTokens: memoryStats.currentTokenCount,
+        maxTokens: memoryStats.maxTokens,
+        usagePercentage: memoryStats.usagePercentage,
+        toolsCount: this.tools.length
+      });
       const result = await this.executor.invoke({
         input: message,
-        chat_history: context?.messages || []
+        chat_history: this.smartMemory.getMessages()
       });
+      this.logger.info("LangChainAgent executor result:", result);
       let response = {
         output: result.output || "",
         message: result.output || "",
-        notes: []
+        notes: [],
+        intermediateSteps: result.intermediateSteps
       };
+      if (result.intermediateSteps && Array.isArray(result.intermediateSteps)) {
+        const toolCalls = result.intermediateSteps.map((step, index) => ({
+          id: `call_${index}`,
+          name: step.action?.tool || "unknown",
+          args: step.action?.toolInput || {},
+          output: typeof step.observation === "string" ? step.observation : JSON.stringify(step.observation)
+        }));
+        if (toolCalls.length > 0) {
+          response.tool_calls = toolCalls;
+        }
+      }
       const parsedSteps = result?.intermediateSteps?.[0]?.observation;
       if (parsedSteps && typeof parsedSteps === "string" && this.isJSON(parsedSteps)) {
         try {
@@ -60,6 +104,10 @@ class LangChainAgent extends BaseAgent {
       if (!response.output || response.output.trim() === "") {
         response.output = "Agent action complete.";
       }
+      if (response.output) {
+        const { AIMessage } = await import("@langchain/core/messages");
+        this.smartMemory.addMessage(new AIMessage(response.output));
+      }
       if (this.tokenTracker) {
         const tokenUsage = this.tokenTracker.getLatestTokenUsage();
         if (tokenUsage) {
@@ -67,8 +115,20 @@ class LangChainAgent extends BaseAgent {
           response.cost = calculateTokenCostSync(tokenUsage);
         }
       }
+      const finalMemoryStats = this.smartMemory.getMemoryStats();
+      response.metadata = {
+        ...response.metadata,
+        memoryStats: {
+          activeMessages: finalMemoryStats.totalActiveMessages,
+          tokenUsage: finalMemoryStats.currentTokenCount,
+          maxTokens: finalMemoryStats.maxTokens,
+          usagePercentage: finalMemoryStats.usagePercentage
+        }
+      };
+      this.logger.info("LangChainAgent.chat returning response:", response);
       return response;
     } catch (error) {
+      this.logger.error("LangChainAgent.chat error:", error);
       return this.handleError(error);
     }
   }
@@ -76,6 +136,10 @@ class LangChainAgent extends BaseAgent {
     if (this.mcpManager) {
       await this.mcpManager.disconnectAll();
     }
+    if (this.smartMemory) {
+      this.smartMemory.dispose();
+      this.smartMemory = void 0;
+    }
     this.executor = void 0;
     this.agentKit = void 0;
     this.tools = [];

package/dist/esm/index8.js.map

@@ -1 +1 @@
-{"version":3,"file":"index8.js","sources":["../../src/langchain-agent.ts"],"sourcesContent":["import type { BaseChatModel } from '@langchain/core/language_models/chat_models';\nimport type { StructuredTool } from '@langchain/core/tools';\nimport { createOpenAIToolsAgent, AgentExecutor } from 'langchain/agents';\nimport {\n  ChatPromptTemplate,\n  MessagesPlaceholder,\n} from '@langchain/core/prompts';\nimport { ChatOpenAI } from '@langchain/openai';\nimport {\n  calculateTokenCostSync,\n  getAllHederaCorePlugins,\n  HederaAgentKit,\n  TokenUsageCallbackHandler,\n} from 'hedera-agent-kit';\nimport type { TokenUsage, CostCalculation } from 'hedera-agent-kit';\nimport {\n  BaseAgent,\n  type ConversationContext,\n  type ChatResponse,\n  type OperationalMode,\n  type UsageStats,\n} from './base-agent';\nimport { MCPClientManager } from './mcp/MCPClientManager';\nimport { convertMCPToolToLangChain } from './mcp/adapters/langchain';\n\nexport class LangChainAgent extends BaseAgent {\n  private executor: AgentExecutor | undefined;\n  private systemMessage = '';\n  private mcpManager?: MCPClientManager;\n\n  async boot(): Promise<void> {\n    if (this.initialized) {\n      this.logger.warn('Agent already initialized');\n      return;\n    }\n\n    try {\n      this.agentKit = await this.createAgentKit();\n      await this.agentKit.initialize();\n\n      const modelName =\n        this.config.ai?.modelName ||\n        process.env.OPENAI_MODEL_NAME ||\n        'gpt-4o-mini';\n      this.tokenTracker = new TokenUsageCallbackHandler(modelName);\n\n      const allTools = this.agentKit.getAggregatedLangChainTools();\n      this.tools = this.filterTools(allTools);\n\n      if (this.config.mcp?.servers && this.config.mcp.servers.length > 0) {\n        await this.initializeMCP();\n      }\n\n      this.systemMessage = this.buildSystemPrompt();\n\n      await this.createExecutor();\n\n      this.initialized = true;\n      this.logger.info('LangChain Hedera agent initialized');\n    } catch (error) {\n      this.logger.error('Failed to initialize agent:', error);\n      throw error;\n    }\n  }\n\n  async chat(\n    message: string,\n    context?: ConversationContext\n  ): Promise<ChatResponse> {\n    if (!this.initialized || !this.executor) {\n      throw new Error('Agent not initialized. Call boot() first.');\n    }\n\n    try {\n      const result = await this.executor.invoke({\n        input: message,\n        chat_history: context?.messages || [],\n      });\n\n      let response: ChatResponse = {\n        output: result.output || '',\n        message: result.output || '',\n        notes: [],\n      };\n\n      const parsedSteps = result?.intermediateSteps?.[0]?.observation;\n      if (\n        parsedSteps &&\n        typeof parsedSteps === 'string' &&\n        this.isJSON(parsedSteps)\n      ) {\n        try {\n          const parsed = JSON.parse(parsedSteps);\n          response = { ...response, ...parsed };\n        } catch (error) {\n          this.logger.error('Error parsing intermediate steps:', error);\n        }\n      }\n\n      if (!response.output || response.output.trim() === '') {\n        response.output = 'Agent action complete.';\n      }\n\n      if (this.tokenTracker) {\n        const tokenUsage = this.tokenTracker.getLatestTokenUsage();\n        if (tokenUsage) {\n          response.tokenUsage = tokenUsage;\n          response.cost = calculateTokenCostSync(tokenUsage);\n        }\n      }\n\n      return response;\n    } catch (error) {\n      return this.handleError(error);\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.mcpManager) {\n      await this.mcpManager.disconnectAll();\n    }\n\n    this.executor = undefined;\n    this.agentKit = undefined;\n    this.tools = [];\n    this.initialized = false;\n    this.logger.info('Agent cleaned up');\n  }\n\n  switchMode(mode: OperationalMode): void {\n    if (this.config.execution) {\n      this.config.execution.operationalMode = mode;\n    } else {\n      this.config.execution = { operationalMode: mode };\n    }\n\n    if (this.agentKit) {\n      this.agentKit.operationalMode = mode;\n    }\n\n    this.systemMessage = this.buildSystemPrompt();\n    this.logger.info(`Operational mode switched to: ${mode}`);\n  }\n\n  getUsageStats(): UsageStats {\n    if (!this.tokenTracker) {\n      return {\n        promptTokens: 0,\n        completionTokens: 0,\n        totalTokens: 0,\n        cost: { totalCost: 0 } as CostCalculation,\n      };\n    }\n\n    const usage = this.tokenTracker.getTotalTokenUsage();\n    const cost = calculateTokenCostSync(usage);\n    return { ...usage, cost };\n  }\n\n  getUsageLog(): UsageStats[] {\n    if (!this.tokenTracker) {\n      return [];\n    }\n\n    return this.tokenTracker.getTokenUsageHistory().map((usage) => ({\n      ...usage,\n      cost: calculateTokenCostSync(usage),\n    }));\n  }\n\n  clearUsageStats(): void {\n    if (this.tokenTracker) {\n      this.tokenTracker.reset();\n      this.logger.info('Usage statistics cleared');\n    }\n  }\n\n  private async createAgentKit(): Promise<HederaAgentKit> {\n    const corePlugins = getAllHederaCorePlugins();\n    const extensionPlugins = this.config.extensions?.plugins || [];\n    const plugins = [...corePlugins, ...extensionPlugins];\n\n    const operationalMode =\n      this.config.execution?.operationalMode || 'returnBytes';\n    const modelName = this.config.ai?.modelName || 'gpt-4o';\n\n    return new HederaAgentKit(\n      this.config.signer,\n      { plugins },\n      operationalMode,\n      this.config.execution?.userAccountId,\n      this.config.execution?.scheduleUserTransactionsInBytesMode ?? true,\n      undefined,\n      modelName,\n      this.config.extensions?.mirrorConfig,\n      this.config.debug?.silent ?? false\n    );\n  }\n\n  private async createExecutor(): Promise<void> {\n    let llm: BaseChatModel;\n    if (this.config.ai?.provider && this.config.ai.provider.getModel) {\n      llm = this.config.ai.provider.getModel() as BaseChatModel;\n    } else if (this.config.ai?.llm) {\n      llm = this.config.ai.llm as BaseChatModel;\n    } else {\n      const apiKey = this.config.ai?.apiKey || process.env.OPENAI_API_KEY;\n      if (!apiKey) {\n        throw new Error('OpenAI API key required');\n      }\n\n      llm = new ChatOpenAI({\n        apiKey,\n        modelName: this.config.ai?.modelName || 'gpt-4o-mini',\n        temperature: this.config.ai?.temperature ?? 0.1,\n        callbacks: this.tokenTracker ? [this.tokenTracker] : [],\n      });\n    }\n\n    const prompt = ChatPromptTemplate.fromMessages([\n      ['system', this.systemMessage],\n      new MessagesPlaceholder('chat_history'),\n      ['human', '{input}'],\n      new MessagesPlaceholder('agent_scratchpad'),\n    ]);\n\n    const langchainTools = this.tools as unknown as StructuredTool[];\n\n    const agent = await createOpenAIToolsAgent({\n      llm,\n      tools: langchainTools,\n      prompt,\n    });\n\n    this.executor = new AgentExecutor({\n      agent,\n      tools: langchainTools,\n      verbose: this.config.debug?.verbose ?? false,\n      returnIntermediateSteps: true,\n    });\n  }\n\n  private handleError(error: unknown): ChatResponse {\n    const errorMessage =\n      error instanceof Error ? error.message : 'Unknown error';\n    this.logger.error('Chat error:', error);\n\n    let tokenUsage: TokenUsage | undefined;\n    let cost: CostCalculation | undefined;\n\n    if (this.tokenTracker) {\n      tokenUsage = this.tokenTracker.getLatestTokenUsage();\n      if (tokenUsage) {\n        cost = calculateTokenCostSync(tokenUsage);\n      }\n    }\n\n    const errorResponse: ChatResponse = {\n      output: 'Sorry, I encountered an error processing your request.',\n      message: 'Error processing request.',\n      error: errorMessage,\n      notes: [],\n    };\n\n    if (tokenUsage) {\n      errorResponse.tokenUsage = tokenUsage;\n    }\n\n    if (cost) {\n      errorResponse.cost = cost;\n    }\n\n    return errorResponse;\n  }\n\n  private async initializeMCP(): Promise<void> {\n    this.mcpManager = new MCPClientManager(this.logger);\n\n    for (const serverConfig of this.config.mcp!.servers!) {\n      if (serverConfig.autoConnect === false) {\n        this.logger.info(\n          `Skipping MCP server ${serverConfig.name} (autoConnect=false)`\n        );\n        continue;\n      }\n\n      const status = await this.mcpManager.connectServer(serverConfig);\n\n      if (status.connected) {\n        this.logger.info(\n          `Connected to MCP server ${status.serverName} with ${status.tools.length} tools`\n        );\n\n        for (const mcpTool of status.tools) {\n          const langchainTool = convertMCPToolToLangChain(\n            mcpTool,\n            this.mcpManager,\n            serverConfig\n          );\n          this.tools.push(langchainTool);\n        }\n      } else {\n        this.logger.error(\n          `Failed to connect to MCP server ${status.serverName}: ${status.error}`\n        );\n      }\n    }\n  }\n\n  /**\n   * Check if a string is valid JSON\n   */\n  private isJSON(str: string): boolean {\n    if (typeof str !== 'string') return false;\n\n    const trimmed = str.trim();\n    if (!trimmed) return false;\n\n    if (\n      !(trimmed.startsWith('{') && trimmed.endsWith('}')) &&\n      !(trimmed.startsWith('[') && trimmed.endsWith(']'))\n    ) {\n      return false;\n    }\n\n    try {\n      JSON.parse(trimmed);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"],"names":[],"mappings":";;;;;;;AAyBO,MAAM,uBAAuB,UAAU;AAAA,EAAvC,cAAA;AAAA,UAAA,GAAA,SAAA;AAEL,SAAQ,gBAAgB;AAAA,EAAA;AAAA,EAGxB,MAAM,OAAsB;AAC1B,QAAI,KAAK,aAAa;AACpB,WAAK,OAAO,KAAK,2BAA2B;AAC5C;AAAA,IACF;AAEA,QAAI;AACF,WAAK,WAAW,MAAM,KAAK,eAAA;AAC3B,YAAM,KAAK,SAAS,WAAA;AAEpB,YAAM,YACJ,KAAK,OAAO,IAAI,aAChB,QAAQ,IAAI,qBACZ;AACF,WAAK,eAAe,IAAI,0BAA0B,SAAS;AAE3D,YAAM,WAAW,KAAK,SAAS,4BAAA;AAC/B,WAAK,QAAQ,KAAK,YAAY,QAAQ;AAEtC,UAAI,KAAK,OAAO,KAAK,WAAW,KAAK,OAAO,IAAI,QAAQ,SAAS,GAAG;AAClE,cAAM,KAAK,cAAA;AAAA,MACb;AAEA,WAAK,gBAAgB,KAAK,kBAAA;AAE1B,YAAM,KAAK,eAAA;AAEX,WAAK,cAAc;AACnB,WAAK,OAAO,KAAK,oCAAoC;AAAA,IACvD,SAAS,OAAO;AACd,WAAK,OAAO,MAAM,+BAA+B,KAAK;AACtD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,KACJ,SACA,SACuB;AACvB,QAAI,CAAC,KAAK,eAAe,CAAC,KAAK,UAAU;AACvC,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,SAAS,OAAO;AAAA,QACxC,OAAO;AAAA,QACP,cAAc,SAAS,YAAY,CAAA;AAAA,MAAC,CACrC;AAED,UAAI,WAAyB;AAAA,QAC3B,QAAQ,OAAO,UAAU;AAAA,QACzB,SAAS,OAAO,UAAU;AAAA,QAC1B,OAAO,CAAA;AAAA,MAAC;AAGV,YAAM,cAAc,QAAQ,oBAAoB,CAAC,GAAG;AACpD,UACE,eACA,OAAO,gBAAgB,YACvB,KAAK,OAAO,WAAW,GACvB;AACA,YAAI;AACF,gBAAM,SAAS,KAAK,MAAM,WAAW;AACrC,qBAAW,EAAE,GAAG,UAAU,GAAG,OAAA;AAAA,QAC/B,SAAS,OAAO;AACd,eAAK,OAAO,MAAM,qCAAqC,KAAK;AAAA,QAC9D;AAAA,MACF;AAEA,UAAI,CAAC,SAAS,UAAU,SAAS,OAAO,KAAA,MAAW,IAAI;AACrD,iBAAS,SAAS;AAAA,MACpB;AAEA,UAAI,KAAK,cAAc;AACrB,cAAM,aAAa,KAAK,aAAa,oBAAA;AACrC,YAAI,YAAY;AACd,mBAAS,aAAa;AACtB,mBAAS,OAAO,uBAAuB,UAAU;AAAA,QACnD;AAAA,MACF;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,aAAO,KAAK,YAAY,KAAK;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,WAA0B;AAC9B,QAAI,KAAK,YAAY;AACnB,YAAM,KAAK,WAAW,cAAA;AAAA,IACxB;AAEA,SAAK,WAAW;AAChB,SAAK,WAAW;AAChB,SAAK,QAAQ,CAAA;AACb,SAAK,cAAc;AACnB,SAAK,OAAO,KAAK,kBAAkB;AAAA,EACrC;AAAA,EAEA,WAAW,MAA6B;AACtC,QAAI,KAAK,OAAO,WAAW;AACzB,WAAK,OAAO,UAAU,kBAAkB;AAAA,IAC1C,OAAO;AACL,WAAK,OAAO,YAAY,EAAE,iBAAiB,KAAA;AAAA,IAC7C;AAEA,QAAI,KAAK,UAAU;AACjB,WAAK,SAAS,kBAAkB;AAAA,IAClC;AAEA,SAAK,gBAAgB,KAAK,kBAAA;AAC1B,SAAK,OAAO,KAAK,iCAAiC,IAAI,EAAE;AAAA,EAC1D;AAAA,EAEA,gBAA4B;AAC1B,QAAI,CAAC,KAAK,cAAc;AACtB,aAAO;AAAA,QACL,cAAc;AAAA,QACd,kBAAkB;AAAA,QAClB,aAAa;AAAA,QACb,MAAM,EAAE,WAAW,EAAA;AAAA,MAAE;AAAA,IAEzB;AAEA,UAAM,QAAQ,KAAK,aAAa,mBAAA;AAChC,UAAM,OAAO,uBAAuB,KAAK;AACzC,WAAO,EAAE,GAAG,OAAO,KAAA;AAAA,EACrB;AAAA,EAEA,cAA4B;AAC1B,QAAI,CAAC,KAAK,cAAc;AACtB,aAAO,CAAA;AAAA,IACT;AAEA,WAAO,KAAK,aAAa,qBAAA,EAAuB,IAAI,CAAC,WAAW;AAAA,MAC9D,GAAG;AAAA,MACH,MAAM,uBAAuB,KAAK;AAAA,IAAA,EAClC;AAAA,EACJ;AAAA,EAEA,kBAAwB;AACtB,QAAI,KAAK,cAAc;AACrB,WAAK,aAAa,MAAA;AAClB,WAAK,OAAO,KAAK,0BAA0B;AAAA,IAC7C;AAAA,EACF;AAAA,EAEA,MAAc,iBAA0C;AACtD,UAAM,cAAc,wBAAA;AACpB,UAAM,mBAAmB,KAAK,OAAO,YAAY,WAAW,CAAA;AAC5D,UAAM,UAAU,CAAC,GAAG,aAAa,GAAG,gBAAgB;AAEpD,UAAM,kBACJ,KAAK,OAAO,WAAW,mBAAmB;AAC5C,UAAM,YAAY,KAAK,OAAO,IAAI,aAAa;AAE/C,WAAO,IAAI;AAAA,MACT,KAAK,OAAO;AAAA,MACZ,EAAE,QAAA;AAAA,MACF;AAAA,MACA,KAAK,OAAO,WAAW;AAAA,MACvB,KAAK,OAAO,WAAW,uCAAuC;AAAA,MAC9D;AAAA,MACA;AAAA,MACA,KAAK,OAAO,YAAY;AAAA,MACxB,KAAK,OAAO,OAAO,UAAU;AAAA,IAAA;AAAA,EAEjC;AAAA,EAEA,MAAc,iBAAgC;AAC5C,QAAI;AACJ,QAAI,KAAK,OAAO,IAAI,YAAY,KAAK,OAAO,GAAG,SAAS,UAAU;AAChE,YAAM,KAAK,OAAO,GAAG,SAAS,SAAA;AAAA,IAChC,WAAW,KAAK,OAAO,IAAI,KAAK;AAC9B,YAAM,KAAK,OAAO,GAAG;AAAA,IACvB,OAAO;AACL,YAAM,SAAS,KAAK,OAAO,IAAI,UAAU,QAAQ,IAAI;AACrD,UAAI,CAAC,QAAQ;AACX,cAAM,IAAI,MAAM,yBAAyB;AAAA,MAC3C;AAEA,YAAM,IAAI,WAAW;AAAA,QACnB;AAAA,QACA,WAAW,KAAK,OAAO,IAAI,aAAa;AAAA,QACxC,aAAa,KAAK,OAAO,IAAI,eAAe;AAAA,QAC5C,WAAW,KAAK,eAAe,CAAC,KAAK,YAAY,IAAI,CAAA;AAAA,MAAC,CACvD;AAAA,IACH;AAEA,UAAM,SAAS,mBAAmB,aAAa;AAAA,MAC7C,CAAC,UAAU,KAAK,aAAa;AAAA,MAC7B,IAAI,oBAAoB,cAAc;AAAA,MACtC,CAAC,SAAS,SAAS;AAAA,MACnB,IAAI,oBAAoB,kBAAkB;AAAA,IAAA,CAC3C;AAED,UAAM,iBAAiB,KAAK;AAE5B,UAAM,QAAQ,MAAM,uBAAuB;AAAA,MACzC;AAAA,MACA,OAAO;AAAA,MACP;AAAA,IAAA,CACD;AAED,SAAK,WAAW,IAAI,cAAc;AAAA,MAChC;AAAA,MACA,OAAO;AAAA,MACP,SAAS,KAAK,OAAO,OAAO,WAAW;AAAA,MACvC,yBAAyB;AAAA,IAAA,CAC1B;AAAA,EACH;AAAA,EAEQ,YAAY,OAA8B;AAChD,UAAM,eACJ,iBAAiB,QAAQ,MAAM,UAAU;AAC3C,SAAK,OAAO,MAAM,eAAe,KAAK;AAEtC,QAAI;AACJ,QAAI;AAEJ,QAAI,KAAK,cAAc;AACrB,mBAAa,KAAK,aAAa,oBAAA;AAC/B,UAAI,YAAY;AACd,eAAO,uBAAuB,UAAU;AAAA,MAC1C;AAAA,IACF;AAEA,UAAM,gBAA8B;AAAA,MAClC,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,OAAO;AAAA,MACP,OAAO,CAAA;AAAA,IAAC;AAGV,QAAI,YAAY;AACd,oBAAc,aAAa;AAAA,IAC7B;AAEA,QAAI,MAAM;AACR,oBAAc,OAAO;AAAA,IACvB;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,gBAA+B;AAC3C,SAAK,aAAa,IAAI,iBAAiB,KAAK,MAAM;AAElD,eAAW,gBAAgB,KAAK,OAAO,IAAK,SAAU;AACpD,UAAI,aAAa,gBAAgB,OAAO;AACtC,aAAK,OAAO;AAAA,UACV,uBAAuB,aAAa,IAAI;AAAA,QAAA;AAE1C;AAAA,MACF;AAEA,YAAM,SAAS,MAAM,KAAK,WAAW,cAAc,YAAY;AAE/D,UAAI,OAAO,WAAW;AACpB,aAAK,OAAO;AAAA,UACV,2BAA2B,OAAO,UAAU,SAAS,OAAO,MAAM,MAAM;AAAA,QAAA;AAG1E,mBAAW,WAAW,OAAO,OAAO;AAClC,gBAAM,gBAAgB;AAAA,YACpB;AAAA,YACA,KAAK;AAAA,YACL;AAAA,UAAA;AAEF,eAAK,MAAM,KAAK,aAAa;AAAA,QAC/B;AAAA,MACF,OAAO;AACL,aAAK,OAAO;AAAA,UACV,mCAAmC,OAAO,UAAU,KAAK,OAAO,KAAK;AAAA,QAAA;AAAA,MAEzE;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,OAAO,KAAsB;AACnC,QAAI,OAAO,QAAQ,SAAU,QAAO;AAEpC,UAAM,UAAU,IAAI,KAAA;AACpB,QAAI,CAAC,QAAS,QAAO;AAErB,QACE,EAAE,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,MACjD,EAAE,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,IACjD;AACA,aAAO;AAAA,IACT;AAEA,QAAI;AACF,WAAK,MAAM,OAAO;AAClB,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACF;"}
+{"version":3,"file":"index8.js","sources":["../../src/langchain-agent.ts"],"sourcesContent":["import type { BaseChatModel } from '@langchain/core/language_models/chat_models';\nimport type { StructuredTool } from '@langchain/core/tools';\nimport { createOpenAIToolsAgent, AgentExecutor } from 'langchain/agents';\nimport {\n  ChatPromptTemplate,\n  MessagesPlaceholder,\n} from '@langchain/core/prompts';\nimport { ChatOpenAI } from '@langchain/openai';\nimport {\n  calculateTokenCostSync,\n  getAllHederaCorePlugins,\n  HederaAgentKit,\n  TokenUsageCallbackHandler,\n} from 'hedera-agent-kit';\nimport type { TokenUsage, CostCalculation } from 'hedera-agent-kit';\nimport {\n  BaseAgent,\n  type ConversationContext,\n  type ChatResponse,\n  type OperationalMode,\n  type UsageStats,\n} from './base-agent';\nimport { MCPClientManager } from './mcp/MCPClientManager';\nimport { convertMCPToolToLangChain } from './mcp/adapters/langchain';\nimport { SmartMemoryManager } from './memory/SmartMemoryManager';\n\nexport class LangChainAgent extends BaseAgent {\n  private executor: AgentExecutor | undefined;\n  private systemMessage = '';\n  private mcpManager?: MCPClientManager;\n  private smartMemory: SmartMemoryManager | undefined;\n\n  async boot(): Promise<void> {\n    if (this.initialized) {\n      this.logger.warn('Agent already initialized');\n      return;\n    }\n\n    try {\n      this.agentKit = await this.createAgentKit();\n      await this.agentKit.initialize();\n\n      const modelName =\n        this.config.ai?.modelName ||\n        process.env.OPENAI_MODEL_NAME ||\n        'gpt-4o-mini';\n      this.tokenTracker = new TokenUsageCallbackHandler(modelName);\n\n      const allTools = this.agentKit.getAggregatedLangChainTools();\n      this.tools = this.filterTools(allTools);\n\n      if (this.config.mcp?.servers && this.config.mcp.servers.length > 0) {\n        await this.initializeMCP();\n      }\n\n      this.smartMemory = new SmartMemoryManager({\n        modelName,\n        maxTokens: 90000,\n        reserveTokens: 10000,\n        storageLimit: 1000\n      });\n      \n      this.logger.info('SmartMemoryManager initialized:', {\n        modelName,\n        toolsCount: this.tools.length,\n        maxTokens: 90000,\n        reserveTokens: 10000\n      });\n\n      this.systemMessage = this.buildSystemPrompt();\n      \n      // Set the system prompt in smart memory\n      this.smartMemory.setSystemPrompt(this.systemMessage);\n\n      await this.createExecutor();\n\n      this.initialized = true;\n      this.logger.info('LangChain Hedera agent initialized');\n    } catch (error) {\n      this.logger.error('Failed to initialize agent:', error);\n      throw error;\n    }\n  }\n\n  async chat(\n    message: string,\n    context?: ConversationContext\n  ): Promise<ChatResponse> {\n    if (!this.initialized || !this.executor || !this.smartMemory) {\n      throw new Error('Agent not initialized. Call boot() first.');\n    }\n\n    try {\n      this.logger.info('LangChainAgent.chat called with:', { message, contextLength: context?.messages?.length || 0 });\n      \n      // If context is provided, populate smart memory with previous messages\n      if (context?.messages && context.messages.length > 0) {\n        // Clear existing memory and add messages from context\n        this.smartMemory.clear();\n        \n        for (const msg of context.messages) {\n          this.smartMemory.addMessage(msg);\n        }\n      }\n      \n      // Add the current user message to memory\n      const { HumanMessage } = await import('@langchain/core/messages');\n      this.smartMemory.addMessage(new HumanMessage(message));\n      \n      const memoryStats = this.smartMemory.getMemoryStats();\n      this.logger.info('Memory stats before execution:', {\n        totalMessages: memoryStats.totalActiveMessages,\n        currentTokens: memoryStats.currentTokenCount,\n        maxTokens: memoryStats.maxTokens,\n        usagePercentage: memoryStats.usagePercentage,\n        toolsCount: this.tools.length\n      });\n      \n      const result = await this.executor.invoke({\n        input: message,\n        chat_history: this.smartMemory.getMessages(),\n      });\n\n      this.logger.info('LangChainAgent executor result:', result);\n\n      let response: ChatResponse = {\n        output: result.output || '',\n        message: result.output || '',\n        notes: [],\n        intermediateSteps: result.intermediateSteps,\n      };\n\n      // Extract tool calls from intermediate steps\n      if (result.intermediateSteps && Array.isArray(result.intermediateSteps)) {\n        const toolCalls = result.intermediateSteps.map((step: any, index: number) => ({\n          id: `call_${index}`,\n          name: step.action?.tool || 'unknown',\n          args: step.action?.toolInput || {},\n          output: typeof step.observation === 'string' ? step.observation : JSON.stringify(step.observation)\n        }));\n        \n        if (toolCalls.length > 0) {\n          response.tool_calls = toolCalls;\n        }\n      }\n\n      const parsedSteps = result?.intermediateSteps?.[0]?.observation;\n      if (\n        parsedSteps &&\n        typeof parsedSteps === 'string' &&\n        this.isJSON(parsedSteps)\n      ) {\n        try {\n          const parsed = JSON.parse(parsedSteps);\n          response = { ...response, ...parsed };\n        } catch (error) {\n          this.logger.error('Error parsing intermediate steps:', error);\n        }\n      }\n\n      if (!response.output || response.output.trim() === '') {\n        response.output = 'Agent action complete.';\n      }\n\n      // Add the AI response to memory\n      if (response.output) {\n        const { AIMessage } = await import('@langchain/core/messages');\n        this.smartMemory.addMessage(new AIMessage(response.output));\n      }\n\n      if (this.tokenTracker) {\n        const tokenUsage = this.tokenTracker.getLatestTokenUsage();\n        if (tokenUsage) {\n          response.tokenUsage = tokenUsage;\n          response.cost = calculateTokenCostSync(tokenUsage);\n        }\n      }\n\n      const finalMemoryStats = this.smartMemory.getMemoryStats();\n      response.metadata = {\n        ...response.metadata,\n        memoryStats: {\n          activeMessages: finalMemoryStats.totalActiveMessages,\n          tokenUsage: finalMemoryStats.currentTokenCount,\n          maxTokens: finalMemoryStats.maxTokens,\n          usagePercentage: finalMemoryStats.usagePercentage\n        }\n      };\n\n      this.logger.info('LangChainAgent.chat returning response:', response);\n      return response;\n    } catch (error) {\n      this.logger.error('LangChainAgent.chat error:', error);\n      return this.handleError(error);\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.mcpManager) {\n      await this.mcpManager.disconnectAll();\n    }\n\n    if (this.smartMemory) {\n      this.smartMemory.dispose();\n      this.smartMemory = undefined;\n    }\n\n    this.executor = undefined;\n    this.agentKit = undefined;\n    this.tools = [];\n    this.initialized = false;\n    this.logger.info('Agent cleaned up');\n  }\n\n  switchMode(mode: OperationalMode): void {\n    if (this.config.execution) {\n      this.config.execution.operationalMode = mode;\n    } else {\n      this.config.execution = { operationalMode: mode };\n    }\n\n    if (this.agentKit) {\n      this.agentKit.operationalMode = mode;\n    }\n\n    this.systemMessage = this.buildSystemPrompt();\n    this.logger.info(`Operational mode switched to: ${mode}`);\n  }\n\n  getUsageStats(): UsageStats {\n    if (!this.tokenTracker) {\n      return {\n        promptTokens: 0,\n        completionTokens: 0,\n        totalTokens: 0,\n        cost: { totalCost: 0 } as CostCalculation,\n      };\n    }\n\n    const usage = this.tokenTracker.getTotalTokenUsage();\n    const cost = calculateTokenCostSync(usage);\n    return { ...usage, cost };\n  }\n\n  getUsageLog(): UsageStats[] {\n    if (!this.tokenTracker) {\n      return [];\n    }\n\n    return this.tokenTracker.getTokenUsageHistory().map((usage) => ({\n      ...usage,\n      cost: calculateTokenCostSync(usage),\n    }));\n  }\n\n  clearUsageStats(): void {\n    if (this.tokenTracker) {\n      this.tokenTracker.reset();\n      this.logger.info('Usage statistics cleared');\n    }\n  }\n\n\n  private async createAgentKit(): Promise<HederaAgentKit> {\n    const corePlugins = getAllHederaCorePlugins();\n    const extensionPlugins = this.config.extensions?.plugins || [];\n    const plugins = [...corePlugins, ...extensionPlugins];\n\n    const operationalMode =\n      this.config.execution?.operationalMode || 'returnBytes';\n    const modelName = this.config.ai?.modelName || 'gpt-4o';\n\n    return new HederaAgentKit(\n      this.config.signer,\n      { plugins },\n      operationalMode,\n      this.config.execution?.userAccountId,\n      this.config.execution?.scheduleUserTransactionsInBytesMode ?? true,\n      undefined,\n      modelName,\n      this.config.extensions?.mirrorConfig,\n      this.config.debug?.silent ?? false\n    );\n  }\n\n  private async createExecutor(): Promise<void> {\n    let llm: BaseChatModel;\n    if (this.config.ai?.provider && this.config.ai.provider.getModel) {\n      llm = this.config.ai.provider.getModel() as BaseChatModel;\n    } else if (this.config.ai?.llm) {\n      llm = this.config.ai.llm as BaseChatModel;\n    } else {\n      const apiKey = this.config.ai?.apiKey || process.env.OPENAI_API_KEY;\n      if (!apiKey) {\n        throw new Error('OpenAI API key required');\n      }\n\n      llm = new ChatOpenAI({\n        apiKey,\n        modelName: this.config.ai?.modelName || 'gpt-4o-mini',\n        temperature: this.config.ai?.temperature ?? 0.1,\n        callbacks: this.tokenTracker ? [this.tokenTracker] : [],\n      });\n    }\n\n    const prompt = ChatPromptTemplate.fromMessages([\n      ['system', this.systemMessage],\n      new MessagesPlaceholder('chat_history'),\n      ['human', '{input}'],\n      new MessagesPlaceholder('agent_scratchpad'),\n    ]);\n\n    const langchainTools = this.tools as unknown as StructuredTool[];\n\n    const agent = await createOpenAIToolsAgent({\n      llm,\n      tools: langchainTools,\n      prompt,\n    });\n\n    // Create executor without memory - we handle memory manually with SmartMemoryManager\n    this.executor = new AgentExecutor({\n      agent,\n      tools: langchainTools,\n      verbose: this.config.debug?.verbose ?? false,\n      returnIntermediateSteps: true,\n    });\n  }\n\n  private handleError(error: unknown): ChatResponse {\n    const errorMessage =\n      error instanceof Error ? error.message : 'Unknown error';\n    this.logger.error('Chat error:', error);\n\n    let tokenUsage: TokenUsage | undefined;\n    let cost: CostCalculation | undefined;\n\n    if (this.tokenTracker) {\n      tokenUsage = this.tokenTracker.getLatestTokenUsage();\n      if (tokenUsage) {\n        cost = calculateTokenCostSync(tokenUsage);\n      }\n    }\n\n    const errorResponse: ChatResponse = {\n      output: 'Sorry, I encountered an error processing your request.',\n      message: 'Error processing request.',\n      error: errorMessage,\n      notes: [],\n    };\n\n    if (tokenUsage) {\n      errorResponse.tokenUsage = tokenUsage;\n    }\n\n    if (cost) {\n      errorResponse.cost = cost;\n    }\n\n    return errorResponse;\n  }\n\n  private async initializeMCP(): Promise<void> {\n    this.mcpManager = new MCPClientManager(this.logger);\n\n    for (const serverConfig of this.config.mcp!.servers!) {\n      if (serverConfig.autoConnect === false) {\n        this.logger.info(\n          `Skipping MCP server ${serverConfig.name} (autoConnect=false)`\n        );\n        continue;\n      }\n\n      const status = await this.mcpManager.connectServer(serverConfig);\n\n      if (status.connected) {\n        this.logger.info(\n          `Connected to MCP server ${status.serverName} with ${status.tools.length} tools`\n        );\n\n        for (const mcpTool of status.tools) {\n          const langchainTool = convertMCPToolToLangChain(\n            mcpTool,\n            this.mcpManager,\n            serverConfig\n          );\n          this.tools.push(langchainTool);\n        }\n      } else {\n        this.logger.error(\n          `Failed to connect to MCP server ${status.serverName}: ${status.error}`\n        );\n      }\n    }\n  }\n\n  /**\n   * Check if a string is valid JSON\n   */\n  private isJSON(str: string): boolean {\n    if (typeof str !== 'string') return false;\n\n    const trimmed = str.trim();\n    if (!trimmed) return false;\n\n    if (\n      !(trimmed.startsWith('{') && trimmed.endsWith('}')) &&\n      !(trimmed.startsWith('[') && trimmed.endsWith(']'))\n    ) {\n      return false;\n    }\n\n    try {\n      JSON.parse(trimmed);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -67,6 +67,12 @@ export interface ChatResponse {
     tokenUsage?: TokenUsage;
     cost?: CostCalculation;
     metadata?: Record<string, unknown>;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+        output?: string;
+    }>;
     [key: string]: unknown;
 }
 export interface UsageStats extends TokenUsage {

package/dist/types/context/ReferenceContextManager.d.ts

@@ -0,0 +1,84 @@
+import { ContentReference, ReferenceId } from '../types/content-reference';
+import { ContentStorage } from '../memory/ContentStorage';
+import { Logger } from '@hashgraphonline/standards-sdk';
+
+export interface ReferenceContext {
+    reference: ContentReference;
+    displayedAt: Date;
+    lastAccessedAt: Date;
+    contextId: string;
+    conversationTurn: number;
+}
+export interface ReferenceDisplayOptions {
+    maxPreviewLength?: number;
+    showMetadata?: boolean;
+    showSize?: boolean;
+    includeActions?: boolean;
+    format?: 'inline' | 'card' | 'compact';
+}
+export interface DisplayResult {
+    displayText: string;
+    hasValidReference: boolean;
+    contextId?: string;
+    suggestedActions?: string[];
+}
+/**
+ * Manages content references within agent conversation context
+ * Tracks reference usage, provides display formatting, and handles reference validation
+ */
+export declare class ReferenceContextManager {
+    private activeReferences;
+    private contentStorage;
+    private logger;
+    private conversationTurn;
+    constructor(contentStorage: ContentStorage, logger: Logger);
+    /**
+     * Add a reference to the current conversation context
+     */
+    addReference(reference: ContentReference): string;
+    /**
+     * Generate display text for a content reference
+     */
+    displayReference(reference: ContentReference, options?: ReferenceDisplayOptions): Promise<DisplayResult>;
+    /**
+     * Get the most recent reference for "inscribe it" commands
+     */
+    getMostRecentReference(): ContentReference | null;
+    /**
+     * Get reference by context ID
+     */
+    getReferenceByContextId(contextId: string): ContentReference | null;
+    /**
+     * Validate all active references and remove invalid ones
+     */
+    validateReferences(): Promise<{
+        valid: number;
+        invalid: number;
+        removed: ReferenceId[];
+    }>;
+    /**
+     * Clear old references based on age and usage
+     */
+    cleanupOldReferences(maxAgeMs?: number): number;
+    /**
+     * Get current context statistics
+     */
+    getContextStats(): {
+        activeReferences: number;
+        conversationTurn: number;
+        oldestReference: number | null;
+        mostRecentReference: number | null;
+    };
+    /**
+     * Clear all references from context
+     */
+    clear(): void;
+    private formatCardReference;
+    private formatInlineReference;
+    private formatCompactReference;
+    private formatInvalidReference;
+    private formatErrorReference;
+    private truncateText;
+    private getOldestReferenceAge;
+    private getMostRecentReferenceAge;
+}

package/dist/types/context/ReferenceResponseProcessor.d.ts

@@ -0,0 +1,76 @@
+import { ContentReference, ReferenceId } from '../types/content-reference';
+import { ReferenceContextManager, ReferenceDisplayOptions } from './ReferenceContextManager';
+import { Logger } from '@hashgraphonline/standards-sdk';
+
+export interface ResponseProcessingOptions {
+    autoDisplayReferences?: boolean;
+    displayOptions?: ReferenceDisplayOptions;
+    includeReferenceInstructions?: boolean;
+    contextualizeReferences?: boolean;
+}
+export interface ProcessedResponse {
+    content: string;
+    hasReferences: boolean;
+    referenceCount: number;
+    contextIds: string[];
+    suggestedActions: string[];
+}
+export interface ReferenceDetectionResult {
+    hasReferences: boolean;
+    references: Array<{
+        reference: ContentReference;
+        position: number;
+        originalText: string;
+    }>;
+    plainReferences: Array<{
+        referenceId: ReferenceId;
+        position: number;
+        originalText: string;
+    }>;
+}
+/**
+ * Processes agent responses to detect and display content references
+ * Handles both structured references and plain reference IDs
+ */
+export declare class ReferenceResponseProcessor {
+    private contextManager;
+    private logger;
+    constructor(contextManager: ReferenceContextManager, logger: Logger);
+    /**
+     * Process an agent response to handle content references
+     */
+    processResponse(responseContent: string, options?: ResponseProcessingOptions): Promise<ProcessedResponse>;
+    /**
+     * Detect references in response content
+     */
+    private detectReferences;
+    /**
+     * Create a preview from content buffer
+     */
+    private createPreviewFromContent;
+    /**
+     * Validate reference ID format
+     */
+    private isValidReferenceId;
+    /**
+     * Get reference context statistics
+     */
+    getContextStats(): {
+        activeReferences: number;
+        conversationTurn: number;
+        oldestReference: number | null;
+        mostRecentReference: number | null;
+    };
+    /**
+     * Validate all references in context
+     */
+    validateAllReferences(): Promise<{
+        valid: number;
+        invalid: number;
+        removed: ReferenceId[];
+    }>;
+    /**
+     * Clean up old references
+     */
+    cleanupOldReferences(maxAgeMs?: number): number;
+}

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

@@ -50,6 +50,7 @@ export declare class ConversationalAgent {
     stateManager: IStateManager;
     private options;
     private logger;
+    private contentStoreManager?;
     constructor(options: ConversationalAgentOptions);
     /**
      * Initialize the conversational agent with Hedera network connection and AI configuration
@@ -90,6 +91,35 @@ export declare class ConversationalAgent {
         type: 'human' | 'ai';
         content: string;
     }[]): Promise<ChatResponse>;
+    /**
+     * Validates initialization options and throws if required fields are missing.
+     *
+     * @param accountId - The Hedera account ID
+     * @param privateKey - The private key for the account
+     * @throws {Error} If required fields are missing
+     */
+    private validateOptions;
+    /**
+     * Prepares the list of plugins to use based on configuration.
+     *
+     * @returns Array of plugins to initialize with the agent
+     */
+    private preparePlugins;
+    /**
+     * Creates the agent configuration object.
+     *
+     * @param serverSigner - The server signer instance
+     * @param llm - The language model instance
+     * @param allPlugins - Array of plugins to use
+     * @returns Configuration object for creating the agent
+     */
+    private createAgentConfig;
+    /**
+     * Configures the HCS-10 plugin with the state manager.
+     *
+     * @param allPlugins - Array of all plugins
+     */
+    private configureHCS10Plugin;
     /**
      * Create a ConversationalAgent with specific plugins enabled
      */
@@ -146,4 +176,8 @@ export declare class ConversationalAgent {
      * @returns {Promise<PrivateKey>} The appropriate PrivateKey instance
      */
     private detectPrivateKeyType;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
 }

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

@@ -4,6 +4,7 @@ export declare class LangChainAgent extends BaseAgent {
     private executor;
     private systemMessage;
     private mcpManager?;
+    private smartMemory;
     boot(): Promise<void>;
     chat(message: string, context?: ConversationContext): Promise<ChatResponse>;
     shutdown(): Promise<void>;

package/dist/types/mcp/ContentProcessor.d.ts

@@ -0,0 +1,37 @@
+import { ContentStorage } from '../memory/ContentStorage';
+import { Logger } from '@hashgraphonline/standards-sdk';
+
+export interface MCPResponseContent {
+    content: unknown;
+    type: 'text' | 'image' | 'resource' | 'text[]' | 'image[]';
+    sizeBytes: number;
+    mimeType?: string;
+}
+export interface ProcessedResponse {
+    content: unknown;
+    wasProcessed: boolean;
+    referenceCreated?: boolean;
+    referenceId?: string;
+    originalSize?: number;
+    errors?: string[];
+}
+export interface ContentAnalysis {
+    shouldProcess: boolean;
+    contents: MCPResponseContent[];
+    totalSize: number;
+    largestContentSize: number;
+}
+export declare class MCPContentProcessor {
+    private contentStorage;
+    private logger;
+    constructor(contentStorage: ContentStorage, logger: Logger);
+    analyzeResponse(response: unknown): ContentAnalysis;
+    processResponse(response: unknown, serverName: string, toolName: string): Promise<ProcessedResponse>;
+    private extractContentFromResponse;
+    private createReferencedResponse;
+    private createLightweightReference;
+    private replaceContentInResponse;
+    private detectMimeType;
+    private mapMimeTypeToContentType;
+    private deepClone;
+}

package/dist/types/mcp/MCPClientManager.d.ts

@@ -1,5 +1,6 @@
 import { MCPServerConfig, MCPToolInfo, MCPConnectionStatus } from './types';
 import { Logger } from '@hashgraphonline/standards-sdk';
+import { ContentStorage } from '../memory/ContentStorage';
 
 /**
  * Manages connections to MCP servers and tool discovery
@@ -8,7 +9,8 @@ export declare class MCPClientManager {
     private clients;
     private tools;
     private logger;
-    constructor(logger: Logger);
+    private contentProcessor?;
+    constructor(logger: Logger, contentStorage?: ContentStorage);
     /**
      * Connect to an MCP server and discover its tools
      */
@@ -37,4 +39,20 @@ export declare class MCPClientManager {
      * Get list of connected server names
      */
     getConnectedServers(): string[];
+    /**
+     * Enable content processing with content storage
+     */
+    enableContentProcessing(contentStorage: ContentStorage): void;
+    /**
+     * Disable content processing
+     */
+    disableContentProcessing(): void;
+    /**
+     * Check if content processing is enabled
+     */
+    isContentProcessingEnabled(): boolean;
+    /**
+     * Analyze a response without processing it (for testing/debugging)
+     */
+    analyzeResponseContent(response: unknown): unknown;
 }