@hashgraphonline/conversational-agent 0.1.218 → 0.1.220

package/dist/esm/index30.js

@@ -1,1282 +1,251 @@
-import { createOpenAIToolsAgent } from "langchain/agents";
-import { FormAwareAgentExecutor } from "./index29.js";
-import { ChatPromptTemplate, MessagesPlaceholder } from "@langchain/core/prompts";
-import { ChatOpenAI } from "@langchain/openai";
-import { calculateTokenCostSync, TokenUsageCallbackHandler, getAllHederaCorePlugins, HederaAgentKit } from "hedera-agent-kit";
-import { BaseAgent } from "./index7.js";
-import { MCPClientManager } from "./index15.js";
-import { convertMCPToolToLangChain } from "./index17.js";
-import { SmartMemoryManager } from "./index18.js";
-import { ResponseFormatter } from "./index32.js";
-import { ERROR_MESSAGES } from "./index38.js";
-import "./index36.js";
-import { SystemMessage, AIMessage, HumanMessage } from "@langchain/core/messages";
-import { ToolRegistry } from "./index39.js";
-import { ExecutionPipeline } from "./index40.js";
-import { FormEngine } from "./index11.js";
-function hasHashLinkBlock(metadata) {
-  if (!metadata || typeof metadata !== "object") {
-    return false;
-  }
-  const meta = metadata;
-  if (!("hashLinkBlock" in meta) || !meta.hashLinkBlock || typeof meta.hashLinkBlock !== "object") {
-    return false;
-  }
-  const block = meta.hashLinkBlock;
-  return "blockId" in block && "hashLink" in block && "template" in block && "attributes" in block && typeof block.blockId === "string" && typeof block.hashLink === "string" && typeof block.template === "string" && typeof block.attributes === "object";
-}
-class LangChainAgent extends BaseAgent {
-  constructor() {
-    super(...arguments);
-    this.systemMessage = "";
-    this.mcpConnectionStatus = /* @__PURE__ */ new Map();
-  }
-  addToolRawToMemory(name, payload) {
-    try {
-      const content = `[tool-raw:${name}] ${payload}`;
-      this.smartMemory.addMessage(new SystemMessage(content));
-    } catch {
-    }
-  }
-  persistToolRaw(toolName, output) {
-    try {
-      let payload = "";
-      if (typeof output === "string") {
-        payload = this.isJSON(output) ? output : JSON.stringify({ output });
-      } else if (output !== void 0) {
-        try {
-          payload = JSON.stringify(output);
-        } catch {
-          payload = String(output);
-        }
-      } else {
-        payload = JSON.stringify({ observation: null });
-      }
-      this.addToolRawToMemory(toolName, payload);
-    } catch {
-    }
-  }
-  persistIntermediateSteps(steps) {
-    if (!steps || !Array.isArray(steps)) {
-      return;
-    }
-    try {
-      for (const step of steps) {
-        const name = step?.action?.tool || "unknown";
-        const obs = step?.observation;
-        this.persistToolRaw(name, obs);
-      }
-    } catch {
-    }
+import { StructuredTool } from "@langchain/core/tools";
+import { z } from "zod";
+import { Logger } from "@hashgraphonline/standards-sdk";
+import { isFormValidatable } from "@hashgraphonline/standards-agent-kit";
+class FormValidatingToolWrapper extends StructuredTool {
+  constructor(originalTool, formGenerator, config = {}) {
+    super();
+    this.originalTool = originalTool;
+    this.formGenerator = formGenerator;
+    this.validationConfig = config;
+    this.logger = new Logger({ module: "FormValidatingToolWrapper" });
+    this.name = originalTool.name;
+    this.description = originalTool.description;
+    this.schema = originalTool.schema;
+    this.logger.info(`🔧 FormValidatingToolWrapper created for tool: ${this.name}`, {
+      originalToolName: originalTool.name,
+      originalToolType: originalTool.constructor.name,
+      wrapperType: this.constructor.name
+    });
   }
   /**
-   * Get inscription tool by capability instead of hardcoded name
+   * Validate the input against the schema
    */
-  getInscriptionTool() {
-    const criticalTools = this.toolRegistry.getToolsByCapability(
-      "priority",
-      "critical"
-    );
-    for (const entry of criticalTools) {
-      const tool = entry.tool;
-      const name = tool.name.toLowerCase();
-      const desc = tool.description?.toLowerCase() || "";
-      if (name.includes("inscribe") || name.includes("hashinal") || desc.includes("inscribe") || desc.includes("hashinal")) {
-        return tool;
-      }
-    }
-    const allTools = this.toolRegistry.getAllRegistryEntries();
-    for (const entry of allTools) {
-      const tool = entry.tool;
-      const name = tool.name.toLowerCase();
-      const desc = tool.description?.toLowerCase() || "";
-      if (name.includes("inscribe") || name.includes("hashinal") || desc.includes("inscribe") || desc.includes("hashinal")) {
-        return tool;
+  validateInput(input) {
+    try {
+      this.schema.parse(input);
+      return { isValid: true };
+    } catch (error) {
+      if (error instanceof z.ZodError) {
+        const errors = error.errors.filter((err) => {
+          const fieldName = err.path[0];
+          return !this.validationConfig.skipFields?.includes(fieldName);
+        }).map((err) => `${err.path.join(".")}: ${err.message}`);
+        return { isValid: false, errors };
       }
+      return { isValid: false, errors: ["Validation failed"] };
     }
-    return null;
   }
   /**
-   * Execute a tool directly with parameters, optionally using ExecutionPipeline
+   * Gets the shape keys from the schema if it's a ZodObject
    */
-  async executeToolDirect(toolName, parameters, useExecutionPipeline = false) {
-    if (useExecutionPipeline && this.executionPipeline && this.smartMemory) {
-      const sessionContext = {
-        sessionId: `session-${Date.now()}`,
-        timestamp: Date.now()
-      };
-      const result = await this.executionPipeline.execute(
-        toolName,
-        parameters,
-        sessionContext
-      );
-      if (!result.success) {
-        throw new Error(result.error || "Pipeline execution failed");
-      }
-      return result.output;
-    }
-    const entry = this.toolRegistry.getTool(toolName);
-    if (!entry) {
-      throw new Error(`Tool not found: ${toolName}`);
+  getSchemaShape() {
+    if (this.isZodObject(this.schema)) {
+      return Object.keys(this.schema.shape);
     }
-    let processedParameters = { ...parameters };
-    if (this.pendingParameterPreprocessingCallback) {
-      this.logger.info(
-        "Applying parameter preprocessing in executeToolDirect",
-        {
-          toolName,
-          hasCallback: true,
-          parameterKeys: Object.keys(parameters)
-        }
-      );
-      try {
-        processedParameters = await this.pendingParameterPreprocessingCallback(
-          toolName,
-          parameters
-        );
-        if (JSON.stringify(processedParameters) !== JSON.stringify(parameters)) {
-          this.logger.info("Parameters preprocessed successfully", {
-            toolName,
-            originalKeys: Object.keys(parameters),
-            processedKeys: Object.keys(processedParameters),
-            changes: Object.keys(processedParameters).filter(
-              (key) => processedParameters[key] !== parameters[key]
-            )
-          });
-        }
-      } catch (error) {
-        this.logger.warn(
-          "Parameter preprocessing failed, using original parameters",
-          {
-            toolName,
-            error: error instanceof Error ? error.message : "Unknown error"
-          }
-        );
-        processedParameters = parameters;
-      }
-    }
-    const mergedArgs = { ...processedParameters, renderForm: false };
-    if (entry.wrapper) {
-      const maybeWrapper = entry.tool;
-      if (maybeWrapper.originalTool?.call) {
-        return await maybeWrapper.originalTool.call(mergedArgs);
-      }
-    }
-    return await entry.tool.call(mergedArgs);
-  }
-  /**
-   * Create a standard ChatResponse from tool output
-   */
-  createToolResponse(toolOutput) {
-    return {
-      output: toolOutput,
-      message: toolOutput,
-      notes: []
-    };
+    return [];
   }
   /**
-   * Handle TOOL_EXECUTION format messages
+   * Executes the wrapped tool's original implementation directly, bypassing wrapper logic.
    */
-  async handleToolExecution(message, context) {
-    let isToolExecution = false;
-    let toolExecutionData = null;
-    try {
-      if (message.includes("TOOL_EXECUTION")) {
-        const parsed = JSON.parse(message);
-        if (parsed.type === "TOOL_EXECUTION") {
-          isToolExecution = true;
-          toolExecutionData = parsed;
-        }
-      }
-    } catch {
+  async executeOriginal(input, runManager) {
+    const tool = this.originalTool;
+    if ("_call" in tool && typeof tool._call === "function") {
+      return tool._call(input, runManager);
     }
-    if (!isToolExecution || !toolExecutionData?.formId) {
-      return null;
+    if ("call" in tool && typeof tool.call === "function") {
+      return tool.call(input, runManager);
     }
-    try {
-      const params = toolExecutionData.parameters || {};
-      const toolName = toolExecutionData.toolName;
-      if (toolName) {
-        const toolOutput = await this.executeToolDirect(toolName, params);
-        try {
-          const payload = this.isJSON(toolOutput) ? toolOutput : JSON.stringify({ output: toolOutput });
-          this.addToolRawToMemory(toolName, payload);
-        } catch {
-        }
-        return this.createToolResponse(toolOutput);
-      }
-    } catch {
-    }
-    const formSubmission = {
-      formId: toolExecutionData.formId,
-      toolName: toolExecutionData.toolName || "",
-      parameters: toolExecutionData.parameters || {},
-      timestamp: Date.now()
-    };
-    if (this.executor && "processFormSubmission" in this.executor && typeof this.executor.processFormSubmission === "function") {
-      return this.processFormSubmission(formSubmission, context);
-    }
-    return null;
+    throw new Error("Original tool has no callable implementation");
   }
   /**
-   * Handle direct tool execution commands
+   * Provides access to the wrapped tool instance for executors that want to bypass the wrapper.
    */
-  async handleDirectToolExecution(message) {
-    if (typeof message !== "string" || !message.includes("Please execute the following tool:")) {
-      return null;
-    }
-    try {
-      const toolLineMatch = message.match(/Tool:\s*(.+)/);
-      const argsLineIndex = message.indexOf("Arguments:");
-      if (toolLineMatch && argsLineIndex !== -1) {
-        const toolName = toolLineMatch[1].trim();
-        const argsText = message.slice(argsLineIndex + "Arguments:".length).trim();
-        let args = {};
-        try {
-          args = JSON.parse(argsText);
-        } catch {
-        }
-        const toolOutput = await this.executeToolDirect(toolName, args);
-        try {
-          const payload = this.isJSON(toolOutput) ? toolOutput : JSON.stringify({ output: toolOutput });
-          this.addToolRawToMemory(toolName, payload);
-        } catch {
-        }
-        return this.createToolResponse(toolOutput);
-      }
-    } catch {
-    }
-    return null;
+  getOriginalTool() {
+    return this.originalTool;
   }
   /**
-   * Handle JSON format tool calls and form submissions
+   * Checks if tool implements FormValidatable method
    */
-  async handleJsonToolCalls(message, context) {
-    if (typeof message !== "string") {
-      return null;
-    }
-    try {
-      const trimmed = message.trim();
-      if (!(trimmed.startsWith("{") && trimmed.endsWith("}")) && !(trimmed.startsWith("[") && trimmed.endsWith("]"))) {
-        return null;
-      }
-      const obj = JSON.parse(trimmed);
-      const formId = obj["formId"];
-      const toolName = obj["toolName"] || "";
-      const parameters = obj["parameters"] || {};
-      if (formId && this.executor && "processFormSubmission" in this.executor && typeof this.executor.processFormSubmission === "function") {
-        return this.processFormSubmission(
-          { formId, toolName, parameters, timestamp: Date.now() },
-          context
-        );
-      }
-      if (toolName) {
-        const toolOutput = await this.executeToolDirect(toolName, parameters);
-        try {
-          const payload = this.isJSON(toolOutput) ? toolOutput : JSON.stringify({ output: toolOutput });
-          this.addToolRawToMemory(toolName, payload);
-        } catch {
-        }
-        return this.createToolResponse(toolOutput);
-      }
-    } catch {
-    }
-    return null;
+  hasFormValidatableMethod(tool, methodName) {
+    return tool !== null && typeof tool === "object" && methodName in tool && typeof tool[methodName] === "function";
   }
   /**
-   * Handle content-ref messages for inscription tools
+   * Expose FormValidatable methods by delegating to the underlying tool when available.
    */
-  async handleContentRefMessages(message) {
-    if (typeof message !== "string" || !message.includes("content-ref:")) {
-      return null;
-    }
-    try {
-      const tool = this.getInscriptionTool();
-      if (!tool) {
-        return null;
-      }
-      const idMatch = message.match(/content-ref:([A-Za-z0-9_\-]+)/i) || message.match(/content-ref:([^\s)]+)/i);
-      const contentRef = idMatch && idMatch[1] ? `content-ref:${idMatch[1]}` : message.match(/content-ref:[^\s)]+/i)?.[0] || void 0;
-      const args = contentRef ? { contentRef, renderForm: true, withHashLinkBlocks: true } : { renderForm: true, withHashLinkBlocks: true };
-      const toolOutput = await tool.call(args);
-      let parsed;
-      try {
-        parsed = typeof toolOutput === "string" ? JSON.parse(toolOutput) : toolOutput;
-      } catch {
-      }
-      if (parsed && parsed["requiresForm"] && parsed["formMessage"]) {
-        const pending = /* @__PURE__ */ new Map();
-        const originalInput = {
-          input: message,
-          chat_history: this.smartMemory.getMessages()
-        };
-        const formMessage = parsed["formMessage"];
-        pending.set(formMessage.id, {
-          toolName: tool.name,
-          originalInput,
-          originalToolInput: args,
-          schema: null
-        });
-        const maybeRestore = this.executor;
-        if (typeof maybeRestore.restorePendingForms === "function") {
-          maybeRestore.restorePendingForms(pending);
-        }
-        const outputMsg = parsed["message"] || "Please complete the form to continue.";
-        return {
-          output: outputMsg,
-          message: outputMsg,
-          notes: [],
-          requiresForm: true,
-          formMessage
-        };
-      }
-    } catch {
+  getFormSchema() {
+    if (this.hasFormValidatableMethod(this.originalTool, "getFormSchema")) {
+      return this.originalTool.getFormSchema();
     }
-    return null;
+    return this.schema;
   }
-  /**
-   * Process executor result and format response
-   */
-  async processExecutorResult(result) {
-    let outputStr = "";
-    if (typeof result.output === "string") {
-      outputStr = result.output;
-    } else if (result.output) {
-      try {
-        outputStr = JSON.stringify(result.output);
-      } catch {
-        outputStr = String(result.output);
-      }
-    }
-    let response = {
-      output: outputStr,
-      message: outputStr,
-      notes: [],
-      intermediateSteps: result.intermediateSteps
-    };
-    if (result.requiresForm && result.formMessage) {
-      response.formMessage = result.formMessage;
-      response.requiresForm = true;
-    }
-    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;
-      }
-      this.persistIntermediateSteps(
-        result.intermediateSteps
-      );
-    }
-    const parsedSteps = result?.intermediateSteps?.[0]?.observation;
-    if (parsedSteps && typeof parsedSteps === "string" && this.isJSON(parsedSteps)) {
-      try {
-        const parsed = JSON.parse(parsedSteps);
-        if (ResponseFormatter.isInscriptionResponse(parsed)) {
-          const formattedMessage = ResponseFormatter.formatInscriptionResponse(parsed);
-          response.output = formattedMessage;
-          response.message = formattedMessage;
-          if (parsed.inscription) {
-            response.inscription = parsed.inscription;
-          }
-          if (parsed.metadata) {
-            response.metadata = {
-              ...response.metadata,
-              ...parsed.metadata
-            };
-          }
-        } else {
-          response = { ...response, ...parsed };
-        }
-        const blockMetadata = this.processHashLinkBlocks(parsed);
-        if (blockMetadata.hashLinkBlock) {
-          response.metadata = {
-            ...response.metadata,
-            ...blockMetadata
-          };
-        }
-      } catch (error) {
-        this.logger.error("Error parsing intermediate steps:", error);
-      }
+  getEssentialFields() {
+    if (this.hasFormValidatableMethod(this.originalTool, "getEssentialFields")) {
+      return this.originalTool.getEssentialFields();
     }
-    if (!response.output || response.output.trim() === "") {
-      response.output = "Agent action complete.";
+    return [];
+  }
+  isFieldEmpty(fieldName, value) {
+    if (this.hasFormValidatableMethod(this.originalTool, "isFieldEmpty")) {
+      return this.originalTool.isFieldEmpty(fieldName, value);
     }
-    if (response.output) {
-      this.smartMemory.addMessage(new AIMessage(response.output));
+    if (value === void 0 || value === null || value === "") {
+      return true;
     }
-    if (this.tokenTracker) {
-      const tokenUsage = this.tokenTracker.getLatestTokenUsage();
-      if (tokenUsage) {
-        response.tokenUsage = tokenUsage;
-        response.cost = calculateTokenCostSync(tokenUsage);
-      }
+    if (Array.isArray(value) && value.length === 0) {
+      return true;
     }
-    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;
+    return false;
   }
   /**
-   * Normalize context messages into LangChain message instances and load into memory
-   */
-  /**
-   * Loads context messages into memory, merging with existing messages
+   * Calculates which fields are missing from the input
    */
-  loadContextMessages(context) {
-    if (!this.smartMemory || !context?.messages || context.messages.length === 0) {
-      return;
-    }
-    const existingMessages = this.smartMemory.getMessages();
-    const existingContent = new Set(
-      existingMessages.map((m) => `${m.constructor.name}:${m.content}`)
-    );
-    for (const msg of context.messages) {
-      let messageClass;
-      let content;
-      if (msg instanceof HumanMessage || msg instanceof AIMessage || msg instanceof SystemMessage) {
-        messageClass = msg.constructor;
-        content = msg.content;
-      } else if (msg && typeof msg === "object" && "content" in msg && "type" in msg) {
-        content = String(msg.content);
-        const type = String(msg.type);
-        if (type === "human") messageClass = HumanMessage;
-        else if (type === "ai") messageClass = AIMessage;
-        else if (type === "system") messageClass = SystemMessage;
-        else continue;
-      } else {
-        continue;
-      }
-      const key = `${messageClass.name}:${content}`;
-      if (!existingContent.has(key)) {
-        this.smartMemory.addMessage(new messageClass(content));
-        existingContent.add(key);
-      }
-    }
-  }
-  async boot() {
-    this.logger.info("🚨🚨🚨 LANGCHAIN AGENT BOOT METHOD CALLED 🚨🚨🚨");
-    if (this.initialized) {
-      this.logger.warn("Agent already initialized");
-      return;
+  calculateMissingFields(input, isCustom) {
+    const missingFields = /* @__PURE__ */ new Set();
+    if (!isCustom) {
+      return missingFields;
     }
-    try {
-      this.agentKit = await this.createAgentKit();
-      await this.agentKit.initialize();
-      const modelName = this.config.ai?.modelName || process.env.OPENAI_MODEL_NAME || "gpt-4o-mini";
-      this.tokenTracker = new TokenUsageCallbackHandler(modelName);
-      this.toolRegistry = new ToolRegistry(this.logger);
-      const allTools = this.agentKit.getAggregatedLangChainTools();
-      this.logger.info("=== TOOL REGISTRATION START ===");
-      this.logger.info(
-        "All tools from agentKit:",
-        allTools.map((t) => t.name)
-      );
-      const filteredTools = this.filterTools(allTools);
-      this.logger.info(
-        "Filtered tools for registration:",
-        filteredTools.map((t) => t.name)
-      );
-      for (const tool of filteredTools) {
-        this.logger.info(`🔧 Registering tool: ${tool.name}`);
-        const options = {};
-        const name = tool.name.toLowerCase();
-        const desc = tool.description?.toLowerCase() || "";
-        if (tool.name === "hedera-hts-mint-nft") {
-          const originalCall = tool.call.bind(tool);
-          tool.call = async (args) => {
-            if (args.metaOptions && typeof args.metaOptions === "object") {
-              const metaOptions = args.metaOptions;
-              if (metaOptions.transactionMemo) {
-                console.warn(
-                  "🚨 WORKAROUND: Stripping transactionMemo from hedera-hts-mint-nft to avoid bug",
-                  { originalMemo: metaOptions.transactionMemo }
-                );
-                delete metaOptions.transactionMemo;
-              }
-            }
-            return originalCall(args);
-          };
-        }
-        if (name.includes("inscribe") || name.includes("hashinal") || desc.includes("inscribe") || desc.includes("hashinal")) {
-          options.forceWrapper = true;
-          options.metadata = {
-            category: "core",
-            version: "1.0.0",
-            dependencies: []
-          };
-          this.logger.info(`🎯 CRITICAL TOOL DEBUG - ${tool.name} schema:`, {
-            hasSchema: !!tool.schema,
-            schemaType: tool.schema?.constructor?.name,
-            hasRenderConfig: !!tool.schema?._renderConfig,
-            renderConfig: tool.schema?._renderConfig
-          });
-        }
-        this.toolRegistry.registerTool(tool, options);
-      }
-      this.tools = this.toolRegistry.getAllTools();
-      this.logger.info(`🚀 TOOLS REGISTERED: ${this.tools.length} tools`);
-      const stats = this.toolRegistry.getStatistics();
-      this.logger.info("📊 Tool Registry Statistics:", {
-        total: stats.totalTools,
-        wrapped: stats.wrappedTools,
-        unwrapped: stats.unwrappedTools,
-        categories: stats.categoryCounts,
-        priorities: stats.priorityCounts
-      });
-      const inscriptionTool = this.getInscriptionTool();
-      if (inscriptionTool) {
-        const entry = this.toolRegistry.getTool(inscriptionTool.name);
-        if (entry) {
-          this.logger.info(
-            `✅ Inscription tool registered: ${inscriptionTool.name}`
-          );
-        }
-      }
-      const toolNames = this.toolRegistry.getToolNames();
-      const uniqueNames = new Set(toolNames);
-      if (toolNames.length !== uniqueNames.size) {
-        this.logger.error("DUPLICATE TOOL NAMES DETECTED in registry!");
-        const duplicates = toolNames.filter(
-          (name, index) => toolNames.indexOf(name) !== index
-        );
-        throw new Error(
-          `Duplicate tool names detected: ${duplicates.join(", ")}`
-        );
-      }
-      if (this.config.mcp?.servers && this.config.mcp.servers.length > 0) {
-        if (this.config.mcp.autoConnect !== false) {
-          await this.initializeMCP();
-        } else {
-          this.logger.info(
-            "MCP servers configured but autoConnect=false, skipping synchronous connection"
-          );
-          this.mcpManager = new MCPClientManager(this.logger);
-        }
-      }
-      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.formEngine = new FormEngine(this.logger);
-      this.executionPipeline = new ExecutionPipeline(
-        this.toolRegistry,
-        this.formEngine,
-        this.smartMemory,
-        this.logger
-      );
-      this.systemMessage = this.buildSystemPrompt();
-      this.smartMemory.setSystemPrompt(this.systemMessage);
-      await this.createExecutor();
-      this.initialized = true;
-      this.logger.info("LangChain Hedera agent initialized with ToolRegistry");
-    } catch (error) {
-      this.logger.error("Failed to initialize agent:", error);
-      throw error;
-    }
-  }
-  async chat(message, context) {
-    if (!this.initialized || !this.executor || !this.smartMemory) {
-      throw new Error("Agent not initialized. Call boot() first.");
-    }
-    try {
-      const toolExecutionResult = await this.handleToolExecution(
-        message,
-        context
-      );
-      if (toolExecutionResult) {
-        return toolExecutionResult;
+    const essentialFields = this.getEssentialFields();
+    for (const fieldName of essentialFields) {
+      const value = input[fieldName];
+      if (this.isFieldEmpty(fieldName, value)) {
+        missingFields.add(fieldName);
       }
-      const directToolResult = await this.handleDirectToolExecution(message);
-      if (directToolResult) {
-        return directToolResult;
-      }
-      const jsonToolResult = await this.handleJsonToolCalls(message, context);
-      if (jsonToolResult) {
-        return jsonToolResult;
-      }
-      const contentRefResult = await this.handleContentRefMessages(message);
-      if (contentRefResult) {
-        return contentRefResult;
-      }
-      this.logger.info("LangChainAgent.chat called with:", {
-        message,
-        contextLength: context?.messages?.length || 0
-      });
-      this.loadContextMessages(context);
-      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 currentMessages = this.smartMemory.getMessages();
-      this.logger.info("Current messages in memory:", {
-        count: currentMessages.length
-      });
-      try {
-        const instr = currentMessages.map((m) => String(m.content || "")).filter(
-          (c) => typeof c === "string" && (c.includes("[instruction:") || c.includes("[tool-next-steps:"))
-        );
-        if (instr.length > 0) {
-          this.logger.info("Instruction/next-steps messages in memory:", {
-            messages: instr
-          });
-        }
-      } catch {
-      }
-      const result = await this.executor.invoke({
-        input: message,
-        chat_history: currentMessages
-      });
-      this.logger.info("LangChainAgent executor result:", result);
-      return this.processExecutorResult(result);
-    } catch (error) {
-      this.logger.error("LangChainAgent.chat error:", error);
-      return this.handleError(error);
     }
-  }
-  async shutdown() {
-    if (this.mcpManager) {
-      await this.mcpManager.disconnectAll();
-    }
-    if (this.smartMemory) {
-      this.smartMemory.dispose();
-      this.smartMemory = void 0;
-    }
-    if (this.toolRegistry) {
-      this.toolRegistry.clear();
-    }
-    this.executor = void 0;
-    this.agentKit = void 0;
-    this.tools = [];
-    this.initialized = false;
-    this.logger.info("Agent cleaned up");
-  }
-  switchMode(mode) {
-    if (this.config.execution) {
-      this.config.execution.operationalMode = mode;
-    } else {
-      this.config.execution = { operationalMode: mode };
-    }
-    if (this.agentKit) {
-      this.agentKit.operationalMode = mode;
-    }
-    this.systemMessage = this.buildSystemPrompt();
-    this.logger.info(`Operational mode switched to: ${mode}`);
-  }
-  getUsageStats() {
-    if (!this.tokenTracker) {
-      return {
-        promptTokens: 0,
-        completionTokens: 0,
-        totalTokens: 0,
-        cost: { totalCost: 0 }
-      };
-    }
-    const usage = this.tokenTracker.getTotalTokenUsage();
-    const cost = calculateTokenCostSync(usage);
-    return { ...usage, cost };
-  }
-  getUsageLog() {
-    if (!this.tokenTracker) {
-      return [];
-    }
-    return this.tokenTracker.getTokenUsageHistory().map((usage) => ({
-      ...usage,
-      cost: calculateTokenCostSync(usage)
-    }));
-  }
-  clearUsageStats() {
-    if (this.tokenTracker) {
-      this.tokenTracker.reset();
-      this.logger.info("Usage statistics cleared");
-    }
-  }
-  getMCPConnectionStatus() {
-    return new Map(this.mcpConnectionStatus);
+    return missingFields;
   }
   /**
-   * Processes form submission and continues with tool execution
+   * Creates a form message with optional JSON schema
    */
-  async processFormSubmission(submission, context) {
-    this.logger.info("🔥 LangChainAgent.processFormSubmission START");
-    if (!this.initialized || !this.executor || !this.smartMemory) {
-      this.logger.error(
-        "🔥 LangChainAgent.processFormSubmission - Agent not initialized"
-      );
-      throw new Error("Agent not initialized. Call boot() first.");
-    }
-    this.logger.info(
-      "🔥 LangChainAgent.processFormSubmission - After initialization check"
+  async createFormMessage(schema, input, missingFields) {
+    let formMessage = await this.formGenerator.generateFormFromSchema(
+      schema,
+      input,
+      {
+        toolName: this.name,
+        toolDescription: this.description
+      },
+      missingFields
     );
-    try {
-      this.logger.info(
-        "🔥 LangChainAgent.processFormSubmission - About to log submission info"
-      );
-      this.logger.info("Processing form submission:", {
-        formId: submission.formId,
-        toolName: submission.toolName,
-        parameterKeys: Object.keys(submission.parameters || {}),
-        hasParameters: !!submission.parameters,
-        parametersType: typeof submission.parameters,
-        parametersIsNull: submission.parameters === null,
-        parametersIsUndefined: submission.parameters === void 0,
-        hasContext: !!submission.context
-      });
-      this.logger.info(
-        "🔥 LangChainAgent.processFormSubmission - After submission info logged"
-      );
-      if (!submission.parameters || typeof submission.parameters !== "object") {
-        this.logger.error("Invalid form submission parameters:", {
-          parameters: submission.parameters,
-          type: typeof submission.parameters
-        });
-        const errorInfo = JSON.stringify(submission, null, 2);
-        return this.handleError(
-          new Error(`Invalid form submission parameters: ${errorInfo}`)
-        );
-      }
-      this.logger.info(
-        "🔥 LangChainAgent.processFormSubmission - Parameters validated"
-      );
-      this.loadContextMessages(context);
-      this.logger.info(
-        "🔥 LangChainAgent.processFormSubmission - Context loaded"
-      );
+    if (this.isZodObject(schema)) {
       try {
-        const currentMessages = this.smartMemory.getMessages();
-        this.logger.info("Current messages in memory (form path):", {
-          count: currentMessages.length,
-          messages: currentMessages.map((m) => m.content)
-        });
-      } catch {
-      }
-      const safeSubmission = {
-        ...submission,
-        parameters: submission.parameters || {}
-      };
-      this.logger.info(
-        "🔥 LangChainAgent.processFormSubmission - Safe submission created"
-      );
-      this.logger.info("About to call executor.processFormSubmission with:", {
-        formId: safeSubmission.formId,
-        toolName: safeSubmission.toolName,
-        parameterKeys: Object.keys(safeSubmission.parameters),
-        parameterCount: Object.keys(safeSubmission.parameters).length
-      });
-      const result = await this.executor.processFormSubmission(safeSubmission);
-      this.logger.info("🔍 DEBUG: Raw result from FormAwareAgentExecutor:", {
-        hasResult: !!result,
-        resultKeys: result ? Object.keys(result) : [],
-        hasMetadata: !!result?.metadata,
-        metadataKeys: result?.metadata ? Object.keys(result.metadata) : [],
-        hasHashLinkBlock: hasHashLinkBlock(result?.metadata),
-        hashLinkBlockContent: hasHashLinkBlock(result?.metadata) ? result.metadata.hashLinkBlock : void 0
-      });
-      if (result?.metadata) {
-        this.logger.info(
-          "🔍 DEBUG: Full metadata from executor:",
-          JSON.stringify(result.metadata)
-        );
-      }
-      const preservedMetadata = result?.metadata ? { ...result.metadata } : {};
-      this.logger.info("Executor processFormSubmission result:", {
-        hasResult: !!result,
-        hasOutput: !!result.output,
-        hasError: !!result.error,
-        hasMetadata: !!result.metadata,
-        outputType: typeof result.output
-      });
-      try {
-        const maybeRaw = result.rawToolOutput;
-        const toolName = result.toolName || "unknown";
-        if (typeof maybeRaw === "string" && maybeRaw.trim().length > 0) {
-          const payload = this.isJSON(maybeRaw) ? maybeRaw : JSON.stringify({ output: maybeRaw });
-          this.addToolRawToMemory(toolName, payload);
-        }
-      } catch {
-      }
-      let outputMessage = "Form processed successfully.";
-      if (typeof result.output === "string") {
-        outputMessage = result.output;
-      } else if (result.output) {
-        try {
-          outputMessage = JSON.stringify(result.output);
-        } catch {
-          outputMessage = String(result.output);
-        }
-      }
-      let response = {
-        output: outputMessage,
-        message: outputMessage,
-        notes: [],
-        intermediateSteps: result.intermediateSteps
-      };
-      if (result.metadata) {
-        response.metadata = {
-          ...response.metadata,
-          ...result.metadata
+        const { jsonSchema, uiSchema } = this.formGenerator.generateJsonSchemaForm(
+          schema,
+          input,
+          missingFields
+        );
+        formMessage = {
+          ...formMessage,
+          jsonSchema,
+          uiSchema
         };
-        this.logger.info("🔍 DEBUG: Metadata after merge from result:", {
-          hasMetadata: !!response.metadata,
-          metadataKeys: response.metadata ? Object.keys(response.metadata) : [],
-          hasHashLinkBlock: hasHashLinkBlock(response.metadata),
-          hashLinkBlockContent: hasHashLinkBlock(response.metadata) ? response.metadata.hashLinkBlock : void 0
-        });
-      }
-      if (result.requiresForm && result.formMessage) {
-        response.formMessage = result.formMessage;
-        response.requiresForm = true;
-      }
-      if (result.intermediateSteps && Array.isArray(result.intermediateSteps)) {
-        const toolCalls = result.intermediateSteps.map(
-          (step, index) => {
-            const name = step?.action?.tool || "unknown";
-            const args = step?.action?.toolInput || {};
-            const obs = step?.observation;
-            let output = "";
-            if (typeof obs === "string") {
-              output = obs;
-            } else if (obs && typeof obs === "object") {
-              try {
-                output = JSON.stringify(obs);
-              } catch {
-                output = String(obs);
-              }
-            } else if (obs !== void 0) {
-              output = String(obs);
-            }
-            return { id: `call_${index}`, name, args, output };
-          }
-        );
-        if (toolCalls.length > 0) {
-          response.tool_calls = toolCalls;
-        }
-        this.persistIntermediateSteps(
-          result.intermediateSteps
-        );
-      }
-      const parsedSteps = result?.intermediateSteps?.[0]?.observation;
-      if (parsedSteps && typeof parsedSteps === "string" && this.isJSON(parsedSteps)) {
-        try {
-          const parsed = JSON.parse(parsedSteps);
-          response = { ...response, ...parsed };
-          const blockMetadata = this.processHashLinkBlocks(parsed);
-          if (blockMetadata.hashLinkBlock) {
-            response.metadata = {
-              ...response.metadata,
-              ...blockMetadata
-            };
-          }
-        } catch (error) {
-          this.logger.error("Error parsing intermediate steps:", error);
-        }
-      }
-      if (response.output) {
-        this.smartMemory.addMessage(new AIMessage(response.output));
-      }
-      if (this.tokenTracker) {
-        const tokenUsage = this.tokenTracker.getLatestTokenUsage();
-        if (tokenUsage) {
-          response.tokenUsage = tokenUsage;
-          response.cost = calculateTokenCostSync(tokenUsage);
-        }
-      }
-      const finalMemoryStats = this.smartMemory.getMemoryStats();
-      this.logger.info("🔍 DEBUG: Metadata before memoryStats merge:", {
-        hasMetadata: !!response.metadata,
-        metadataKeys: response.metadata ? Object.keys(response.metadata) : [],
-        hasHashLinkBlock: hasHashLinkBlock(response.metadata)
-      });
-      response.metadata = {
-        ...preservedMetadata,
-        ...response.metadata,
-        memoryStats: {
-          activeMessages: finalMemoryStats.totalActiveMessages,
-          tokenUsage: finalMemoryStats.currentTokenCount,
-          maxTokens: finalMemoryStats.maxTokens,
-          usagePercentage: finalMemoryStats.usagePercentage
-        }
-      };
-      this.logger.info("🔍 DEBUG: Final response metadata before return:", {
-        hasMetadata: !!response.metadata,
-        metadataKeys: response.metadata ? Object.keys(response.metadata) : [],
-        hasHashLinkBlock: hasHashLinkBlock(response.metadata),
-        fullMetadata: response.metadata
-      });
-      if (hasHashLinkBlock(preservedMetadata) && !hasHashLinkBlock(response.metadata)) {
-        this.logger.error(
-          "❌ CRITICAL: HashLink metadata was lost during processing!"
-        );
-        this.logger.error(
-          "Original metadata had hashLinkBlock:",
-          preservedMetadata.hashLinkBlock
-        );
-        this.logger.error("Final metadata missing hashLinkBlock");
+      } catch (error) {
+        this.logger.warn("Failed to generate JSON Schema for RJSF:", error);
       }
-      return response;
-    } catch (error) {
-      this.logger.error("Form submission processing error:", error);
-      return this.handleError(error);
     }
+    formMessage.partialInput = input;
+    return formMessage;
   }
   /**
-   * Check if the agent has pending forms that need to be completed
+   * Type guard to check if a schema is a ZodObject
    */
-  hasPendingForms() {
-    return this.executor ? this.executor.hasPendingForms() : false;
+  isZodObject(schema) {
+    const def = schema._def;
+    return !!(def && def.typeName === "ZodObject");
   }
   /**
-   * Get information about pending forms
+   * Check if we should generate a form for this tool invocation
    */
-  getPendingFormsInfo() {
-    return this.executor ? this.executor.getPendingFormsInfo() : [];
-  }
-  async createAgentKit() {
-    const corePlugins = getAllHederaCorePlugins();
-    const extensionPlugins = this.config.extensions?.plugins || [];
-    const plugins = [...corePlugins, ...extensionPlugins];
-    const operationalMode = this.config.execution?.operationalMode || "returnBytes";
-    const modelName = this.config.ai?.modelName || "gpt-4o";
-    return new HederaAgentKit(
-      this.config.signer,
-      { plugins },
-      operationalMode,
-      this.config.execution?.userAccountId,
-      this.config.execution?.scheduleUserTransactionsInBytesMode ?? false,
-      void 0,
-      modelName,
-      this.config.extensions?.mirrorConfig,
-      this.config.debug?.silent ?? false
-    );
-  }
-  async createExecutor() {
-    const existingPendingForms = this.executor?.getPendingForms() || /* @__PURE__ */ new Map();
-    let llm;
-    if (this.config.ai?.provider && this.config.ai.provider.getModel) {
-      llm = this.config.ai.provider.getModel();
-    } else if (this.config.ai?.llm) {
-      llm = this.config.ai.llm;
-    } else {
-      const apiKey = this.config.ai?.apiKey || process.env.OPENAI_API_KEY;
-      if (!apiKey) {
-        throw new Error("OpenAI API key required");
-      }
-      const modelName = this.config.ai?.modelName || "gpt-4o-mini";
-      const isGPT5Model = modelName.toLowerCase().includes("gpt-5") || modelName.toLowerCase().includes("gpt5");
-      llm = new ChatOpenAI({
-        apiKey,
-        modelName,
-        callbacks: this.tokenTracker ? [this.tokenTracker] : [],
-        ...isGPT5Model ? { temperature: 1 } : {}
-      });
-    }
-    const prompt = ChatPromptTemplate.fromMessages([
-      ["system", this.systemMessage],
-      new MessagesPlaceholder("chat_history"),
-      ["human", "{input}"],
-      new MessagesPlaceholder("agent_scratchpad")
-    ]);
-    const langchainTools = this.tools;
-    const inscriptionTool = this.getInscriptionTool();
-    if (inscriptionTool) {
-      const entry = this.toolRegistry.getTool(inscriptionTool.name);
-      if (entry) {
-        this.logger.info(
-          `✅ Inscription tool registered: ${inscriptionTool.name}`
-        );
-      }
-    }
-    const stats = this.toolRegistry.getStatistics();
-    this.logger.info("🛡️ TOOL SECURITY REPORT:", {
-      totalTools: stats.totalTools,
-      wrappedTools: stats.wrappedTools,
-      unwrappedTools: stats.unwrappedTools,
-      categories: stats.categoryCounts,
-      priorities: stats.priorityCounts
+  shouldGenerateForm(input) {
+    this.logger.info(`shouldGenerateForm called for ${this.name}/${this.originalTool.name}`, {
+      input,
+      hasCustomValidation: !!this.validationConfig.customValidation
     });
-    this.logger.info(
-      `📊 Tool Security Summary: ${stats.wrappedTools} wrapped, ${stats.unwrappedTools} unwrapped`
-    );
-    const agent = await createOpenAIToolsAgent({
-      llm,
-      tools: langchainTools,
-      prompt
-    });
-    this.executor = new FormAwareAgentExecutor({
-      agent,
-      tools: langchainTools,
-      verbose: this.config.debug?.verbose ?? false,
-      returnIntermediateSteps: true
+    if (this.validationConfig.customValidation) {
+      const result = !this.validationConfig.customValidation(input);
+      this.logger.info(`Custom validation result: ${result}`);
+      return result;
+    }
+    if (isFormValidatable(this.originalTool)) {
+      this.logger.info(`Tool ${this.originalTool.name} implements FormValidatable, using custom logic`);
+      return this.originalTool.shouldGenerateForm(input);
+    }
+    this.logger.info(`Tool ${this.originalTool.name} using schema validation only`);
+    const validation = this.validateInput(input);
+    this.logger.info(`Schema validation for ${this.originalTool.name}:`, {
+      isValid: validation.isValid,
+      errors: validation.errors
     });
-    if (this.pendingParameterPreprocessingCallback) {
-      this.executor.setParameterPreprocessingCallback(
-        this.pendingParameterPreprocessingCallback
-      );
-      this.logger.info(
-        "Parameter preprocessing callback re-applied to new executor",
-        { hasCallback: true }
-      );
-    }
-    if (existingPendingForms.size > 0) {
-      this.logger.info(
-        `Restoring ${existingPendingForms.size} pending forms to new executor`
-      );
-      this.executor.restorePendingForms(existingPendingForms);
-    }
-    this.logger.info("FormAwareAgentExecutor initialization complete");
+    return !validation.isValid;
   }
   /**
-   * Set parameter preprocessing callback for tool parameter format conversion
+   * Checks if input has bypass flags that skip form generation
    */
-  setParameterPreprocessingCallback(callback) {
-    this.pendingParameterPreprocessingCallback = callback;
-    if (this.executor) {
-      this.executor.setParameterPreprocessingCallback(callback);
-      this.logger.info("Parameter preprocessing callback configured", {
-        hasCallback: !!callback
-      });
-    } else {
-      this.logger.warn(
-        "Cannot set parameter preprocessing callback: executor not initialized"
-      );
-    }
-  }
-  handleError(error) {
-    const errorMessage = error instanceof Error ? error.message : "Unknown error";
-    this.logger.error("Chat error:", error);
-    let tokenUsage;
-    let cost;
-    if (this.tokenTracker) {
-      tokenUsage = this.tokenTracker.getLatestTokenUsage();
-      if (tokenUsage) {
-        cost = calculateTokenCostSync(tokenUsage);
-      }
-    }
-    let userFriendlyMessage = errorMessage;
-    let userFriendlyOutput = errorMessage;
-    if (errorMessage.includes("429")) {
-      if (errorMessage.includes("quota")) {
-        userFriendlyMessage = "API quota exceeded. Please check your OpenAI billing and usage limits.";
-        userFriendlyOutput = "I'm currently unable to respond because the API quota has been exceeded. Please check your OpenAI account billing and usage limits, then try again.";
-      } else {
-        userFriendlyMessage = ERROR_MESSAGES.TOO_MANY_REQUESTS;
-        userFriendlyOutput = ERROR_MESSAGES.RATE_LIMITED;
-      }
-    } else if (errorMessage.includes("401") || errorMessage.includes("unauthorized")) {
-      userFriendlyMessage = "API authentication failed. Please check your API key configuration.";
-      userFriendlyOutput = "There's an issue with the API authentication. Please check your OpenAI API key configuration in settings.";
-    } else if (errorMessage.includes("timeout")) {
-      userFriendlyMessage = "Request timed out. Please try again.";
-      userFriendlyOutput = "The request took too long to process. Please try again.";
-    } else if (errorMessage.includes("network") || errorMessage.includes("fetch")) {
-      userFriendlyMessage = "Network error. Please check your internet connection and try again.";
-      userFriendlyOutput = "There was a network error. Please check your internet connection and try again.";
-    } else if (errorMessage.includes("400")) {
-      userFriendlyMessage = errorMessage;
-      userFriendlyOutput = errorMessage;
-    }
-    const errorResponse = {
-      output: userFriendlyOutput,
-      message: userFriendlyMessage,
-      error: errorMessage,
-      notes: []
-    };
-    if (tokenUsage) {
-      errorResponse.tokenUsage = tokenUsage;
-    }
-    if (cost) {
-      errorResponse.cost = cost;
-    }
-    return errorResponse;
-  }
-  async initializeMCP() {
-    this.mcpManager = new MCPClientManager(this.logger);
-    for (const serverConfig of this.config.mcp.servers) {
-      if (serverConfig.autoConnect === false) {
-        this.logger.info(
-          `Skipping MCP server ${serverConfig.name} (autoConnect=false)`
-        );
-        continue;
-      }
-      const status = await this.mcpManager.connectServer(serverConfig);
-      if (status.connected) {
-        this.logger.info(
-          `Connected to MCP server ${status.serverName} with ${status.tools.length} tools`
-        );
-        for (const mcpTool of status.tools) {
-          const langchainTool = convertMCPToolToLangChain(
-            mcpTool,
-            this.mcpManager,
-            serverConfig
-          );
-          this.toolRegistry.registerTool(langchainTool, {
-            metadata: {
-              category: "mcp",
-              version: "1.0.0",
-              dependencies: [serverConfig.name]
-            }
-          });
-        }
-        this.tools = this.toolRegistry.getAllTools();
-      } else {
-        this.logger.error(
-          `Failed to connect to MCP server ${status.serverName}: ${status.error}`
-        );
-      }
-    }
+  hasFormBypassFlags(input) {
+    return input.__fromForm === true || input.renderForm === false;
   }
   /**
-   * Connect to MCP servers asynchronously after agent boot with background timeout pattern
+   * Override _call to intercept tool execution
    */
-  async connectMCPServers() {
-    if (!this.config.mcp?.servers || this.config.mcp.servers.length === 0) {
-      return;
-    }
-    if (!this.mcpManager) {
-      this.mcpManager = new MCPClientManager(this.logger);
-    }
-    this.logger.info(
-      `Starting background MCP server connections for ${this.config.mcp.servers.length} servers...`
-    );
-    this.config.mcp.servers.forEach((serverConfig) => {
-      this.connectServerInBackground(serverConfig);
+  async _call(input, runManager) {
+    this.logger.info(`🚨🚨🚨 FormValidatingToolWrapper._call INTERCEPTING ${this.name} 🚨🚨🚨`, {
+      input,
+      inputKeys: Object.keys(input),
+      schemaShape: this.getSchemaShape(),
+      stackTrace: new Error().stack?.split("\n").slice(0, 5)
     });
-    this.logger.info("MCP server connections initiated in background");
-  }
-  /**
-   * Connect to a single MCP server in background with timeout
-   */
-  connectServerInBackground(serverConfig) {
-    const serverName = serverConfig.name;
-    setTimeout(async () => {
+    const inputRecord = input;
+    if (this.hasFormBypassFlags(inputRecord)) {
+      this.logger.info("Bypassing form generation and executing original tool due to submission flags");
+      return this.executeOriginal(inputRecord, runManager);
+    }
+    const shouldGenerate = this.shouldGenerateForm(input);
+    this.logger.info(`FormValidatingToolWrapper decision for ${this.name}:`, {
+      shouldGenerateForm: shouldGenerate,
+      toolName: this.name,
+      originalToolName: this.originalTool.name
+    });
+    if (shouldGenerate) {
+      this.logger.info(`Generating form for incomplete input in ${this.name}`);
       try {
-        this.logger.info(`Background connecting to MCP server: ${serverName}`);
-        const status = await this.mcpManager.connectServer(serverConfig);
-        this.mcpConnectionStatus.set(serverName, status);
-        if (status.connected) {
-          this.logger.info(
-            `Successfully connected to MCP server ${status.serverName} with ${status.tools.length} tools`
-          );
-          for (const mcpTool of status.tools) {
-            const langchainTool = convertMCPToolToLangChain(
-              mcpTool,
-              this.mcpManager,
-              serverConfig
-            );
-            this.toolRegistry.registerTool(langchainTool, {
-              metadata: {
-                category: "mcp",
-                version: "1.0.0",
-                dependencies: [serverConfig.name]
-              }
-            });
-          }
-          this.tools = this.toolRegistry.getAllTools();
-          if (this.initialized && this.executor) {
-            this.logger.info(
-              `Recreating executor with ${this.tools.length} total tools`
-            );
-            await this.createExecutor();
-          }
-        } else {
-          this.logger.error(
-            `Failed to connect to MCP server ${status.serverName}: ${status.error}`
-          );
-        }
-      } catch (error) {
-        this.logger.error(
-          `Background connection failed for MCP server ${serverName}:`,
-          error
-        );
-        this.mcpConnectionStatus.set(serverName, {
-          connected: false,
-          serverName,
-          tools: [],
-          error: error instanceof Error ? error.message : "Connection failed"
+        const isCustom = isFormValidatable(this.originalTool);
+        const schemaToUse = isCustom ? this.getFormSchema() : this.schema;
+        const missingFields = this.calculateMissingFields(
+          input,
+          isCustom
+        );
+        const schemaFields = this.isZodObject(schemaToUse) ? Object.keys(schemaToUse.shape) : [];
+        this.logger.info(`Using ${isCustom ? "CUSTOM" : "DEFAULT"} schema for form generation`, {
+          toolName: this.originalTool.name,
+          schemaType: schemaToUse.constructor?.name,
+          schemaFields,
+          isCustomSchema: isCustom
         });
+        const formMessage = await this.createFormMessage(
+          schemaToUse,
+          input,
+          missingFields
+        );
+        const result = {
+          requiresForm: true,
+          formMessage,
+          message: `Please complete the form to provide the required information for ${this.name}.`
+        };
+        this.logger.info(`FormValidatingToolWrapper returning form result for ${this.name}`);
+        return JSON.stringify(result);
+      } catch (error) {
+        this.logger.error("Failed to generate form:", error);
       }
-    }, 1e3);
-  }
-  /**
-   * Detects and processes HashLink blocks from tool responses
-   * @param parsedResponse - The parsed JSON response from a tool
-   * @returns Metadata object containing hashLinkBlock if detected
-   */
-  processHashLinkBlocks(parsedResponse) {
-    try {
-      const responseRecord = parsedResponse;
-      if (parsedResponse && typeof parsedResponse === "object" && responseRecord.hashLinkBlock && typeof responseRecord.hashLinkBlock === "object") {
-        const block = responseRecord.hashLinkBlock;
-        if (block.blockId && block.hashLink && block.template && block.attributes && typeof block.blockId === "string" && typeof block.hashLink === "string" && typeof block.template === "string" && typeof block.attributes === "object") {
-          this.logger.info("HashLink block detected:", {
-            blockId: block.blockId,
-            hashLink: block.hashLink,
-            template: block.template,
-            attributeKeys: Object.keys(block.attributes)
-          });
-          return {
-            hashLinkBlock: {
-              blockId: block.blockId,
-              hashLink: block.hashLink,
-              template: block.template,
-              attributes: block.attributes
-            }
-          };
-        } else {
-          this.logger.warn("Invalid HashLink block structure detected:", block);
-        }
-      }
-    } catch (error) {
-      this.logger.error("Error processing HashLink blocks:", error);
-    }
-    return {};
-  }
-  /**
-   * Check if a string is valid JSON
-   */
-  isJSON(str) {
-    if (typeof str !== "string") return false;
-    const trimmed = str.trim();
-    if (!trimmed) return false;
-    if (!(trimmed.startsWith("{") && trimmed.endsWith("}")) && !(trimmed.startsWith("[") && trimmed.endsWith("]"))) {
-      return false;
-    }
-    try {
-      JSON.parse(trimmed);
-      return true;
-    } catch {
-      return false;
     }
+    this.logger.info(`FormValidatingToolWrapper passing through to original tool ${this.name}`);
+    return this.executeOriginal(input, runManager);
   }
 }
+function wrapToolWithFormValidation(tool, formGenerator, config = {}) {
+  return new FormValidatingToolWrapper(tool, formGenerator, config);
+}
 export {
-  LangChainAgent
+  FormValidatingToolWrapper,
+  wrapToolWithFormValidation
 };
 //# sourceMappingURL=index30.js.map