@elizaos/plugin-mcp 1.0.8 → 1.3.0

package/dist/cjs/index.cjs

@@ -0,0 +1,2214 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/tool-compatibility/providers/openai.ts
+var exports_openai = {};
+__export(exports_openai, {
+  OpenAIReasoningMcpCompatibility: () => OpenAIReasoningMcpCompatibility,
+  OpenAIMcpCompatibility: () => OpenAIMcpCompatibility2
+});
+var OpenAIMcpCompatibility2, OpenAIReasoningMcpCompatibility;
+var init_openai = __esm(() => {
+  OpenAIMcpCompatibility2 = class OpenAIMcpCompatibility2 extends McpToolCompatibility {
+    constructor(modelInfo2) {
+      super(modelInfo2);
+    }
+    shouldApply() {
+      return this.modelInfo.provider === "openai" && (!this.modelInfo.supportsStructuredOutputs || this.modelInfo.isReasoningModel === true);
+    }
+    getUnsupportedStringProperties() {
+      const baseUnsupported = ["format"];
+      if (this.modelInfo.isReasoningModel === true) {
+        return [...baseUnsupported, "pattern"];
+      }
+      if (this.modelInfo.modelId.includes("gpt-3.5") || this.modelInfo.modelId.includes("davinci")) {
+        return [...baseUnsupported, "pattern"];
+      }
+      return baseUnsupported;
+    }
+    getUnsupportedNumberProperties() {
+      if (this.modelInfo.isReasoningModel === true) {
+        return ["exclusiveMinimum", "exclusiveMaximum", "multipleOf"];
+      }
+      return [];
+    }
+    getUnsupportedArrayProperties() {
+      if (this.modelInfo.isReasoningModel === true) {
+        return ["uniqueItems"];
+      }
+      return [];
+    }
+    getUnsupportedObjectProperties() {
+      return ["minProperties", "maxProperties"];
+    }
+  };
+  OpenAIReasoningMcpCompatibility = class OpenAIReasoningMcpCompatibility extends McpToolCompatibility {
+    constructor(modelInfo2) {
+      super(modelInfo2);
+    }
+    shouldApply() {
+      return this.modelInfo.provider === "openai" && this.modelInfo.isReasoningModel === true;
+    }
+    getUnsupportedStringProperties() {
+      return ["format", "pattern", "minLength", "maxLength"];
+    }
+    getUnsupportedNumberProperties() {
+      return ["exclusiveMinimum", "exclusiveMaximum", "multipleOf"];
+    }
+    getUnsupportedArrayProperties() {
+      return ["uniqueItems", "minItems", "maxItems"];
+    }
+    getUnsupportedObjectProperties() {
+      return ["minProperties", "maxProperties", "additionalProperties"];
+    }
+    mergeDescription(originalDescription, constraints) {
+      const constraintText = this.formatConstraintsForReasoningModel(constraints);
+      if (originalDescription) {
+        return `${originalDescription}
+
+IMPORTANT: ${constraintText}`;
+      }
+      return `IMPORTANT: ${constraintText}`;
+    }
+    formatConstraintsForReasoningModel(constraints) {
+      const rules = [];
+      if (constraints.minLength) {
+        rules.push(`minimum ${constraints.minLength} characters`);
+      }
+      if (constraints.maxLength) {
+        rules.push(`maximum ${constraints.maxLength} characters`);
+      }
+      if (constraints.minimum !== undefined) {
+        rules.push(`must be >= ${constraints.minimum}`);
+      }
+      if (constraints.maximum !== undefined) {
+        rules.push(`must be <= ${constraints.maximum}`);
+      }
+      if (constraints.format === "email") {
+        rules.push(`must be a valid email address`);
+      }
+      if (constraints.format === "uri" || constraints.format === "url") {
+        rules.push(`must be a valid URL`);
+      }
+      if (constraints.format === "uuid") {
+        rules.push(`must be a valid UUID`);
+      }
+      if (constraints.pattern) {
+        rules.push(`must match pattern: ${constraints.pattern}`);
+      }
+      if (constraints.enum) {
+        rules.push(`must be one of: ${constraints.enum.join(", ")}`);
+      }
+      if (constraints.minItems) {
+        rules.push(`array must have at least ${constraints.minItems} items`);
+      }
+      if (constraints.maxItems) {
+        rules.push(`array must have at most ${constraints.maxItems} items`);
+      }
+      return rules.length > 0 ? rules.join(", ") : JSON.stringify(constraints);
+    }
+  };
+});
+
+// src/tool-compatibility/providers/anthropic.ts
+var exports_anthropic = {};
+__export(exports_anthropic, {
+  AnthropicMcpCompatibility: () => AnthropicMcpCompatibility2
+});
+var AnthropicMcpCompatibility2;
+var init_anthropic = __esm(() => {
+  AnthropicMcpCompatibility2 = class AnthropicMcpCompatibility2 extends McpToolCompatibility {
+    constructor(modelInfo2) {
+      super(modelInfo2);
+    }
+    shouldApply() {
+      return this.modelInfo.provider === "anthropic";
+    }
+    getUnsupportedStringProperties() {
+      return [];
+    }
+    getUnsupportedNumberProperties() {
+      return [];
+    }
+    getUnsupportedArrayProperties() {
+      return [];
+    }
+    getUnsupportedObjectProperties() {
+      return ["additionalProperties"];
+    }
+    mergeDescription(originalDescription, constraints) {
+      const constraintHints = this.formatConstraintsForAnthropic(constraints);
+      if (originalDescription && constraintHints) {
+        return `${originalDescription}. ${constraintHints}`;
+      } else if (constraintHints) {
+        return constraintHints;
+      }
+      return originalDescription || "";
+    }
+    formatConstraintsForAnthropic(constraints) {
+      const hints = [];
+      if (constraints.additionalProperties === false) {
+        hints.push("Only use the specified properties");
+      }
+      if (constraints.format === "date-time") {
+        hints.push("Use ISO 8601 date-time format");
+      }
+      if (constraints.pattern) {
+        hints.push(`Must match the pattern: ${constraints.pattern}`);
+      }
+      return hints.join(". ");
+    }
+  };
+});
+
+// src/tool-compatibility/providers/google.ts
+var exports_google = {};
+__export(exports_google, {
+  GoogleMcpCompatibility: () => GoogleMcpCompatibility2
+});
+var GoogleMcpCompatibility2;
+var init_google = __esm(() => {
+  GoogleMcpCompatibility2 = class GoogleMcpCompatibility2 extends McpToolCompatibility {
+    constructor(modelInfo2) {
+      super(modelInfo2);
+    }
+    shouldApply() {
+      return this.modelInfo.provider === "google";
+    }
+    getUnsupportedStringProperties() {
+      return ["minLength", "maxLength", "pattern", "format"];
+    }
+    getUnsupportedNumberProperties() {
+      return ["minimum", "maximum", "exclusiveMinimum", "exclusiveMaximum", "multipleOf"];
+    }
+    getUnsupportedArrayProperties() {
+      return ["minItems", "maxItems", "uniqueItems"];
+    }
+    getUnsupportedObjectProperties() {
+      return ["minProperties", "maxProperties", "additionalProperties"];
+    }
+    mergeDescription(originalDescription, constraints) {
+      const constraintText = this.formatConstraintsForGoogle(constraints);
+      if (originalDescription && constraintText) {
+        return `${originalDescription}
+
+Constraints: ${constraintText}`;
+      } else if (constraintText) {
+        return `Constraints: ${constraintText}`;
+      }
+      return originalDescription || "";
+    }
+    formatConstraintsForGoogle(constraints) {
+      const rules = [];
+      if (constraints.minLength) {
+        rules.push(`text must be at least ${constraints.minLength} characters long`);
+      }
+      if (constraints.maxLength) {
+        rules.push(`text must be no more than ${constraints.maxLength} characters long`);
+      }
+      if (constraints.minimum !== undefined) {
+        rules.push(`number must be at least ${constraints.minimum}`);
+      }
+      if (constraints.maximum !== undefined) {
+        rules.push(`number must be no more than ${constraints.maximum}`);
+      }
+      if (constraints.exclusiveMinimum !== undefined) {
+        rules.push(`number must be greater than ${constraints.exclusiveMinimum}`);
+      }
+      if (constraints.exclusiveMaximum !== undefined) {
+        rules.push(`number must be less than ${constraints.exclusiveMaximum}`);
+      }
+      if (constraints.multipleOf) {
+        rules.push(`number must be a multiple of ${constraints.multipleOf}`);
+      }
+      if (constraints.format === "email") {
+        rules.push(`must be a valid email address`);
+      }
+      if (constraints.format === "uri" || constraints.format === "url") {
+        rules.push(`must be a valid URL starting with http:// or https://`);
+      }
+      if (constraints.format === "uuid") {
+        rules.push(`must be a valid UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`);
+      }
+      if (constraints.format === "date-time") {
+        rules.push(`must be a valid ISO 8601 date-time (e.g., 2023-12-25T10:30:00Z)`);
+      }
+      if (constraints.pattern) {
+        rules.push(`must match the regular expression pattern: ${constraints.pattern}`);
+      }
+      if (constraints.enum && Array.isArray(constraints.enum)) {
+        rules.push(`must be exactly one of these values: ${constraints.enum.join(", ")}`);
+      }
+      if (constraints.minItems) {
+        rules.push(`array must contain at least ${constraints.minItems} items`);
+      }
+      if (constraints.maxItems) {
+        rules.push(`array must contain no more than ${constraints.maxItems} items`);
+      }
+      if (constraints.uniqueItems === true) {
+        rules.push(`array items must all be unique (no duplicates)`);
+      }
+      if (constraints.minProperties) {
+        rules.push(`object must have at least ${constraints.minProperties} properties`);
+      }
+      if (constraints.maxProperties) {
+        rules.push(`object must have no more than ${constraints.maxProperties} properties`);
+      }
+      if (constraints.additionalProperties === false) {
+        rules.push(`object must only contain the specified properties, no additional properties allowed`);
+      }
+      return rules.join("; ");
+    }
+  };
+});
+
+// src/tool-compatibility/index.ts
+class McpToolCompatibility {
+  modelInfo;
+  constructor(modelInfo2) {
+    this.modelInfo = modelInfo2;
+  }
+  transformToolSchema(toolSchema) {
+    if (!this.shouldApply()) {
+      return toolSchema;
+    }
+    return this.processSchema(toolSchema);
+  }
+  processSchema(schema) {
+    const processed = { ...schema };
+    switch (processed.type) {
+      case "string":
+        return this.processStringSchema(processed);
+      case "number":
+      case "integer":
+        return this.processNumberSchema(processed);
+      case "array":
+        return this.processArraySchema(processed);
+      case "object":
+        return this.processObjectSchema(processed);
+      default:
+        return this.processGenericSchema(processed);
+    }
+  }
+  processStringSchema(schema) {
+    const constraints = {};
+    const processed = { ...schema };
+    if (typeof schema.minLength === "number") {
+      constraints.minLength = schema.minLength;
+    }
+    if (typeof schema.maxLength === "number") {
+      constraints.maxLength = schema.maxLength;
+    }
+    if (typeof schema.pattern === "string") {
+      constraints.pattern = schema.pattern;
+    }
+    if (typeof schema.format === "string") {
+      constraints.format = schema.format;
+    }
+    if (Array.isArray(schema.enum)) {
+      constraints.enum = schema.enum;
+    }
+    const unsupportedProps = this.getUnsupportedStringProperties();
+    for (const prop of unsupportedProps) {
+      if (prop in processed) {
+        delete processed[prop];
+      }
+    }
+    if (Object.keys(constraints).length > 0) {
+      processed.description = this.mergeDescription(schema.description, constraints);
+    }
+    return processed;
+  }
+  processNumberSchema(schema) {
+    const constraints = {};
+    const processed = { ...schema };
+    if (typeof schema.minimum === "number") {
+      constraints.minimum = schema.minimum;
+    }
+    if (typeof schema.maximum === "number") {
+      constraints.maximum = schema.maximum;
+    }
+    if (typeof schema.exclusiveMinimum === "number") {
+      constraints.exclusiveMinimum = schema.exclusiveMinimum;
+    }
+    if (typeof schema.exclusiveMaximum === "number") {
+      constraints.exclusiveMaximum = schema.exclusiveMaximum;
+    }
+    if (typeof schema.multipleOf === "number") {
+      constraints.multipleOf = schema.multipleOf;
+    }
+    const unsupportedProps = this.getUnsupportedNumberProperties();
+    for (const prop of unsupportedProps) {
+      if (prop in processed) {
+        delete processed[prop];
+      }
+    }
+    if (Object.keys(constraints).length > 0) {
+      processed.description = this.mergeDescription(schema.description, constraints);
+    }
+    return processed;
+  }
+  processArraySchema(schema) {
+    const constraints = {};
+    const processed = { ...schema };
+    if (typeof schema.minItems === "number") {
+      constraints.minItems = schema.minItems;
+    }
+    if (typeof schema.maxItems === "number") {
+      constraints.maxItems = schema.maxItems;
+    }
+    if (typeof schema.uniqueItems === "boolean") {
+      constraints.uniqueItems = schema.uniqueItems;
+    }
+    if (schema.items && typeof schema.items === "object" && !Array.isArray(schema.items)) {
+      processed.items = this.processSchema(schema.items);
+    }
+    const unsupportedProps = this.getUnsupportedArrayProperties();
+    for (const prop of unsupportedProps) {
+      if (prop in processed) {
+        delete processed[prop];
+      }
+    }
+    if (Object.keys(constraints).length > 0) {
+      processed.description = this.mergeDescription(schema.description, constraints);
+    }
+    return processed;
+  }
+  processObjectSchema(schema) {
+    const constraints = {};
+    const processed = { ...schema };
+    if (typeof schema.minProperties === "number") {
+      constraints.minProperties = schema.minProperties;
+    }
+    if (typeof schema.maxProperties === "number") {
+      constraints.maxProperties = schema.maxProperties;
+    }
+    if (typeof schema.additionalProperties === "boolean") {
+      constraints.additionalProperties = schema.additionalProperties;
+    }
+    if (schema.properties && typeof schema.properties === "object") {
+      processed.properties = {};
+      for (const [key, prop] of Object.entries(schema.properties)) {
+        if (typeof prop === "object" && !Array.isArray(prop)) {
+          processed.properties[key] = this.processSchema(prop);
+        } else {
+          processed.properties[key] = prop;
+        }
+      }
+    }
+    const unsupportedProps = this.getUnsupportedObjectProperties();
+    for (const prop of unsupportedProps) {
+      if (prop in processed) {
+        delete processed[prop];
+      }
+    }
+    if (Object.keys(constraints).length > 0) {
+      processed.description = this.mergeDescription(schema.description, constraints);
+    }
+    return processed;
+  }
+  processGenericSchema(schema) {
+    const processed = { ...schema };
+    if (Array.isArray(schema.oneOf)) {
+      processed.oneOf = schema.oneOf.map((s) => typeof s === "object" ? this.processSchema(s) : s);
+    }
+    if (Array.isArray(schema.anyOf)) {
+      processed.anyOf = schema.anyOf.map((s) => typeof s === "object" ? this.processSchema(s) : s);
+    }
+    if (Array.isArray(schema.allOf)) {
+      processed.allOf = schema.allOf.map((s) => typeof s === "object" ? this.processSchema(s) : s);
+    }
+    return processed;
+  }
+  mergeDescription(originalDescription, constraints) {
+    const constraintJson = JSON.stringify(constraints);
+    if (originalDescription) {
+      return `${originalDescription}
+${constraintJson}`;
+    }
+    return constraintJson;
+  }
+}
+function detectModelProvider(runtime2) {
+  const modelString = runtime2?.modelProvider || runtime2?.model || "";
+  const modelId = String(modelString).toLowerCase();
+  let provider2 = "unknown";
+  let supportsStructuredOutputs = false;
+  let isReasoningModel = false;
+  if (modelId.includes("openai") || modelId.includes("gpt-") || modelId.includes("o1-") || modelId.includes("o3-")) {
+    provider2 = "openai";
+    supportsStructuredOutputs = modelId.includes("gpt-4") || modelId.includes("o1") || modelId.includes("o3");
+    isReasoningModel = modelId.includes("o1") || modelId.includes("o3");
+  } else if (modelId.includes("anthropic") || modelId.includes("claude")) {
+    provider2 = "anthropic";
+    supportsStructuredOutputs = true;
+  } else if (modelId.includes("google") || modelId.includes("gemini")) {
+    provider2 = "google";
+    supportsStructuredOutputs = true;
+  } else if (modelId.includes("openrouter")) {
+    provider2 = "openrouter";
+    supportsStructuredOutputs = false;
+  }
+  return {
+    provider: provider2,
+    modelId,
+    supportsStructuredOutputs,
+    isReasoningModel
+  };
+}
+async function createMcpToolCompatibility(runtime2) {
+  const modelInfo2 = detectModelProvider(runtime2);
+  try {
+    switch (modelInfo2.provider) {
+      case "openai":
+        const { OpenAIMcpCompatibility: OpenAIMcpCompatibility3 } = await Promise.resolve().then(() => (init_openai(), exports_openai));
+        return new OpenAIMcpCompatibility3(modelInfo2);
+      case "anthropic":
+        const { AnthropicMcpCompatibility: AnthropicMcpCompatibility3 } = await Promise.resolve().then(() => (init_anthropic(), exports_anthropic));
+        return new AnthropicMcpCompatibility3(modelInfo2);
+      case "google":
+        const { GoogleMcpCompatibility: GoogleMcpCompatibility3 } = await Promise.resolve().then(() => (init_google(), exports_google));
+        return new GoogleMcpCompatibility3(modelInfo2);
+      default:
+        return null;
+    }
+  } catch (error) {
+    console.warn("Failed to load compatibility provider:", error);
+    return null;
+  }
+}
+function createMcpToolCompatibilitySync(runtime) {
+  const modelInfo = detectModelProvider(runtime);
+  try {
+    switch (modelInfo.provider) {
+      case "openai":
+        const OpenAIModule = eval("require")("./providers/openai");
+        const { OpenAIMcpCompatibility } = OpenAIModule;
+        return new OpenAIMcpCompatibility(modelInfo);
+      case "anthropic":
+        const AnthropicModule = eval("require")("./providers/anthropic");
+        const { AnthropicMcpCompatibility } = AnthropicModule;
+        return new AnthropicMcpCompatibility(modelInfo);
+      case "google":
+        const GoogleModule = eval("require")("./providers/google");
+        const { GoogleMcpCompatibility } = GoogleModule;
+        return new GoogleMcpCompatibility(modelInfo);
+      default:
+        return null;
+    }
+  } catch (error) {
+    console.warn("Failed to load compatibility provider:", error);
+    return null;
+  }
+}
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  detectModelProvider: () => detectModelProvider,
+  default: () => src_default,
+  createMcpToolCompatibilitySync: () => createMcpToolCompatibilitySync,
+  createMcpToolCompatibility: () => createMcpToolCompatibility,
+  ToolSelectionSchema: () => ToolSelectionSchema,
+  ResourceSelectionSchema: () => ResourceSelectionSchema,
+  McpToolCompatibility: () => McpToolCompatibility,
+  McpService: () => McpService,
+  MIN_MCP_TIMEOUT_SECONDS: () => MIN_MCP_TIMEOUT_SECONDS,
+  MCP_SERVICE_NAME: () => MCP_SERVICE_NAME,
+  MAX_RECONNECT_ATTEMPTS: () => MAX_RECONNECT_ATTEMPTS,
+  INITIAL_RETRY_DELAY: () => INITIAL_RETRY_DELAY,
+  DEFAULT_PING_CONFIG: () => DEFAULT_PING_CONFIG,
+  DEFAULT_MCP_TIMEOUT_SECONDS: () => DEFAULT_MCP_TIMEOUT_SECONDS,
+  DEFAULT_MAX_RETRIES: () => DEFAULT_MAX_RETRIES,
+  BACKOFF_MULTIPLIER: () => BACKOFF_MULTIPLIER
+});
+module.exports = __toCommonJS(exports_src);
+var import_core9 = require("@elizaos/core");
+
+// src/actions/callToolAction.ts
+var import_core6 = require("@elizaos/core");
+
+// src/types.ts
+var MCP_SERVICE_NAME = "mcp";
+var DEFAULT_MCP_TIMEOUT_SECONDS = 60000;
+var MIN_MCP_TIMEOUT_SECONDS = 1;
+var DEFAULT_MAX_RETRIES = 2;
+var ToolSelectionSchema = {
+  type: "object",
+  required: ["serverName", "toolName", "arguments"],
+  properties: {
+    serverName: {
+      type: "string",
+      minLength: 1,
+      errorMessage: "serverName must not be empty"
+    },
+    toolName: {
+      type: "string",
+      minLength: 1,
+      errorMessage: "toolName must not be empty"
+    },
+    arguments: {
+      type: "object"
+    },
+    reasoning: {
+      type: "string"
+    },
+    noToolAvailable: {
+      type: "boolean"
+    }
+  }
+};
+var ResourceSelectionSchema = {
+  type: "object",
+  required: ["serverName", "uri"],
+  properties: {
+    serverName: {
+      type: "string",
+      minLength: 1,
+      errorMessage: "serverName must not be empty"
+    },
+    uri: {
+      type: "string",
+      minLength: 1,
+      errorMessage: "uri must not be empty"
+    },
+    reasoning: {
+      type: "string"
+    },
+    noResourceAvailable: {
+      type: "boolean"
+    }
+  }
+};
+var DEFAULT_PING_CONFIG = {
+  enabled: true,
+  intervalMs: 1e4,
+  timeoutMs: 5000,
+  failuresBeforeDisconnect: 3
+};
+var MAX_RECONNECT_ATTEMPTS = 5;
+var BACKOFF_MULTIPLIER = 2;
+var INITIAL_RETRY_DELAY = 2000;
+
+// src/utils/error.ts
+var import_core = require("@elizaos/core");
+
+// src/templates/errorAnalysisPrompt.ts
+var errorAnalysisPrompt = `
+{{{mcpProvider.text}}}
+
+{{{recentMessages}}}
+
+# Prompt
+
+You're an assistant helping a user, but there was an error accessing the resource you tried to use.
+
+User request: "{{{userMessage}}}"
+Error message: {{{error}}}
+
+Create a helpful response that:
+1. Acknowledges the issue in user-friendly terms
+2. Offers alternative approaches to help if possible
+3. Doesn't expose technical error details unless they're truly helpful
+4. Maintains a helpful, conversational tone
+
+Your response:
+`;
+
+// src/utils/error.ts
+async function handleMcpError(state, mcpProvider, error, runtime2, message, type, callback) {
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  import_core.logger.error({ error, mcpType: type }, `Error executing MCP ${type}: ${errorMessage}`);
+  let responseText = `I'm sorry, I wasn't able to get the information you requested. There seems to be an issue with the ${type} right now. Is there something else I can help you with?`;
+  let thoughtText = `Error calling MCP ${type} and failed to generate a custom response. Providing a generic fallback response.`;
+  if (callback) {
+    const enhancedState = {
+      ...state,
+      values: {
+        ...state.values,
+        mcpProvider,
+        userMessage: message.content.text || "",
+        error: errorMessage
+      }
+    };
+    const prompt = import_core.composePromptFromState({
+      state: enhancedState,
+      template: errorAnalysisPrompt
+    });
+    try {
+      const errorResponse = await runtime2.useModel(import_core.ModelType.TEXT_SMALL, {
+        prompt
+      });
+      responseText = errorResponse;
+      thoughtText = `Error calling MCP ${type}: ${errorMessage}. Providing a helpful response to the user.`;
+      await callback({
+        thought: thoughtText,
+        text: responseText,
+        actions: ["REPLY"]
+      });
+    } catch (modelError) {
+      import_core.logger.error({ error: modelError instanceof Error ? modelError.message : String(modelError) }, "Failed to generate error response");
+      await callback({
+        thought: thoughtText,
+        text: responseText,
+        actions: ["REPLY"]
+      });
+    }
+  }
+  return {
+    text: `Failed to execute MCP ${type}`,
+    values: {
+      success: false,
+      error: errorMessage,
+      errorType: type
+    },
+    data: {
+      actionName: type === "tool" ? "CALL_MCP_TOOL" : "READ_MCP_RESOURCE",
+      error: errorMessage,
+      mcpType: type
+    },
+    success: false,
+    error: error instanceof Error ? error : new Error(errorMessage)
+  };
+}
+
+// src/utils/processing.ts
+var import_core2 = require("@elizaos/core");
+var import_core3 = require("@elizaos/core");
+
+// src/templates/resourceAnalysisTemplate.ts
+var resourceAnalysisTemplate = `
+{{{mcpProvider.text}}}
+
+{{{recentMessages}}}
+
+# Prompt
+
+You are a helpful assistant responding to a user's request. You've just accessed the resource "{{{uri}}}" to help answer this request.
+
+Original user request: "{{{userMessage}}}"
+
+Resource metadata: 
+{{{resourceMeta}}
+
+Resource content: 
+{{{resourceContent}}
+
+Instructions:
+1. Analyze how well the resource's content addresses the user's specific question or need
+2. Identify the most relevant information from the resource
+3. Create a natural, conversational response that incorporates this information
+4. If the resource content is insufficient, acknowledge its limitations and explain what you can determine
+5. Do not start with phrases like "According to the resource" or "Here's what I found" - instead, integrate the information naturally
+6. Maintain your helpful, intelligent assistant personality while presenting the information
+
+Your response (written as if directly to the user):
+`;
+
+// src/templates/toolReasoningTemplate.ts
+var toolReasoningTemplate = `
+{{{mcpProvider.text}}}
+
+{{{recentMessages}}}
+
+# Prompt
+
+You are a helpful assistant responding to a user's request. You've just used the "{{{toolName}}}" tool from the "{{{serverName}}}" server to help answer this request.
+
+Original user request: "{{{userMessage}}}"
+
+Tool response:
+{{{toolOutput}}}
+
+{{#if hasAttachments}}
+The tool also returned images or other media that will be shared with the user.
+{{/if}}
+
+Instructions:
+1. Analyze how well the tool's response addresses the user's specific question or need
+2. Identify the most relevant information from the tool's output
+3. Create a natural, conversational response that incorporates this information
+4. If the tool's response is insufficient, acknowledge its limitations and explain what you can determine
+5. Do not start with phrases like "I used the X tool" or "Here's what I found" - instead, integrate the information naturally
+6. Maintain your helpful, intelligent assistant personality while presenting the information
+
+Your response (written as if directly to the user):
+`;
+
+// src/utils/mcp.ts
+async function createMcpMemory(runtime2, message, type, serverName, content, metadata) {
+  const memory = await runtime2.addEmbeddingToMemory({
+    entityId: message.entityId,
+    agentId: runtime2.agentId,
+    roomId: message.roomId,
+    content: {
+      text: `Used the "${type}" from "${serverName}" server. 
+        Content: ${content}`,
+      metadata: {
+        ...metadata,
+        serverName
+      }
+    }
+  });
+  await runtime2.createMemory(memory, type === "resource" ? "resources" : "tools", true);
+}
+function buildMcpProviderData(servers) {
+  const mcpData = {};
+  let textContent = "";
+  if (servers.length === 0) {
+    return {
+      values: { mcp: {} },
+      data: { mcp: {} },
+      text: "No MCP servers are currently connected."
+    };
+  }
+  for (const server of servers) {
+    mcpData[server.name] = {
+      status: server.status,
+      tools: {},
+      resources: {}
+    };
+    textContent += `## Server: ${server.name} (${server.status})
+
+`;
+    if (server.tools && server.tools.length > 0) {
+      textContent += `### Tools:
+
+`;
+      for (const tool of server.tools) {
+        mcpData[server.name].tools[tool.name] = {
+          description: tool.description || "No description available",
+          inputSchema: tool.inputSchema || {}
+        };
+        textContent += `- **${tool.name}**: ${tool.description || "No description available"}
+`;
+      }
+      textContent += `
+`;
+    }
+    if (server.resources && server.resources.length > 0) {
+      textContent += `### Resources:
+
+`;
+      for (const resource of server.resources) {
+        mcpData[server.name].resources[resource.uri] = {
+          name: resource.name,
+          description: resource.description || "No description available",
+          mimeType: resource.mimeType
+        };
+        textContent += `- **${resource.name}** (${resource.uri}): ${resource.description || "No description available"}
+`;
+      }
+      textContent += `
+`;
+    }
+  }
+  return {
+    values: { mcp: mcpData },
+    data: { mcp: mcpData },
+    text: `# MCP Configuration
+
+${textContent}`
+  };
+}
+
+// src/utils/processing.ts
+function getMimeTypeToContentType(mimeType) {
+  if (!mimeType)
+    return;
+  if (mimeType.startsWith("image/"))
+    return import_core2.ContentType.IMAGE;
+  if (mimeType.startsWith("video/"))
+    return import_core2.ContentType.VIDEO;
+  if (mimeType.startsWith("audio/"))
+    return import_core2.ContentType.AUDIO;
+  if (mimeType.includes("pdf") || mimeType.includes("document"))
+    return import_core2.ContentType.DOCUMENT;
+  return;
+}
+function processResourceResult(result, uri) {
+  let resourceContent = "";
+  let resourceMeta = "";
+  for (const content of result.contents) {
+    if (content.text) {
+      resourceContent += content.text;
+    } else if (content.blob) {
+      resourceContent += `[Binary data - ${content.mimeType || "unknown type"}]`;
+    }
+    resourceMeta += `Resource: ${content.uri || uri}
+`;
+    if (content.mimeType) {
+      resourceMeta += `Type: ${content.mimeType}
+`;
+    }
+  }
+  return { resourceContent, resourceMeta };
+}
+function processToolResult(result, serverName, toolName, runtime2, messageEntityId) {
+  let toolOutput = "";
+  let hasAttachments = false;
+  const attachments = [];
+  for (const content of result.content) {
+    if (content.type === "text") {
+      toolOutput += content.text;
+    } else if (content.type === "image") {
+      hasAttachments = true;
+      attachments.push({
+        contentType: getMimeTypeToContentType(content.mimeType),
+        url: `data:${content.mimeType};base64,${content.data}`,
+        id: import_core2.createUniqueUuid(runtime2, messageEntityId),
+        title: "Generated image",
+        source: `${serverName}/${toolName}`,
+        description: "Tool-generated image",
+        text: "Generated image"
+      });
+    } else if (content.type === "resource") {
+      const resource = content.resource;
+      if (resource && "text" in resource) {
+        toolOutput += `
+
+Resource (${resource.uri}):
+${resource.text}`;
+      } else if (resource && "blob" in resource) {
+        toolOutput += `
+
+Resource (${resource.uri}): [Binary data]`;
+      }
+    }
+  }
+  return { toolOutput, hasAttachments, attachments };
+}
+async function handleResourceAnalysis(runtime2, message, uri, serverName, resourceContent, resourceMeta, callback) {
+  await createMcpMemory(runtime2, message, "resource", serverName, resourceContent, {
+    uri,
+    isResourceAccess: true
+  });
+  const analysisPrompt = createAnalysisPrompt(uri, message.content.text || "", resourceContent, resourceMeta);
+  const analyzedResponse = await runtime2.useModel(import_core2.ModelType.TEXT_SMALL, {
+    prompt: analysisPrompt
+  });
+  if (callback) {
+    await callback({
+      text: analyzedResponse,
+      thought: `I analyzed the content from the ${uri} resource on ${serverName} and crafted a thoughtful response that addresses the user's request while maintaining my conversational style.`,
+      actions: ["READ_MCP_RESOURCE"]
+    });
+  }
+}
+async function handleToolResponse(runtime2, message, serverName, toolName, toolArgs, toolOutput, hasAttachments, attachments, state, mcpProvider, callback) {
+  await createMcpMemory(runtime2, message, "tool", serverName, toolOutput, {
+    toolName,
+    arguments: toolArgs,
+    isToolCall: true
+  });
+  const reasoningPrompt = createReasoningPrompt(state, mcpProvider, toolName, serverName, message.content.text || "", toolOutput, hasAttachments);
+  import_core2.logger.info({ reasoningPrompt }, "reasoning prompt");
+  const reasonedResponse = await runtime2.useModel(import_core2.ModelType.TEXT_SMALL, {
+    prompt: reasoningPrompt
+  });
+  const agentId = message.agentId || runtime2.agentId;
+  const replyMemory = {
+    entityId: agentId,
+    roomId: message.roomId,
+    worldId: message.worldId,
+    content: {
+      text: reasonedResponse,
+      thought: `I analyzed the output from the ${toolName} tool on ${serverName} and crafted a thoughtful response that addresses the user's request while maintaining my conversational style.`,
+      actions: ["CALL_MCP_TOOL"],
+      attachments: hasAttachments && attachments.length > 0 ? attachments : undefined
+    }
+  };
+  await runtime2.createMemory(replyMemory, "messages");
+  if (callback) {
+    await callback({
+      text: reasonedResponse,
+      thought: `I analyzed the output from the ${toolName} tool on ${serverName} and crafted a thoughtful response that addresses the user's request while maintaining my conversational style.`,
+      actions: ["CALL_MCP_TOOL"],
+      attachments: hasAttachments && attachments.length > 0 ? attachments : undefined
+    });
+  }
+}
+async function sendInitialResponse(callback) {
+  if (callback) {
+    const responseContent = {
+      thought: "The user is asking for information that can be found in an MCP resource. I will retrieve and analyze the appropriate resource.",
+      text: "I'll retrieve that information for you. Let me access the resource...",
+      actions: ["READ_MCP_RESOURCE"]
+    };
+    await callback(responseContent);
+  }
+}
+function createAnalysisPrompt(uri, userMessage, resourceContent, resourceMeta) {
+  const enhancedState = {
+    data: {},
+    text: "",
+    values: {
+      uri,
+      userMessage,
+      resourceContent,
+      resourceMeta
+    }
+  };
+  return import_core3.composePromptFromState({
+    state: enhancedState,
+    template: resourceAnalysisTemplate
+  });
+}
+function createReasoningPrompt(state, mcpProvider, toolName, serverName, userMessage, toolOutput, hasAttachments) {
+  const enhancedState = {
+    ...state,
+    values: {
+      ...state.values,
+      mcpProvider,
+      toolName,
+      serverName,
+      userMessage,
+      toolOutput,
+      hasAttachments
+    }
+  };
+  return import_core3.composePromptFromState({
+    state: enhancedState,
+    template: toolReasoningTemplate
+  });
+}
+
+// src/utils/selection.ts
+var import_core5 = require("@elizaos/core");
+
+// src/utils/json.ts
+var import_ajv = __toESM(require("ajv"));
+var import_json5 = __toESM(require("json5"));
+function parseJSON(input) {
+  let cleanedInput = input.replace(/^```(?:json)?\s*|\s*```$/g, "").trim();
+  const firstBrace = cleanedInput.indexOf("{");
+  const lastBrace = cleanedInput.lastIndexOf("}");
+  if (firstBrace !== -1 && lastBrace !== -1 && lastBrace > firstBrace) {
+    cleanedInput = cleanedInput.substring(firstBrace, lastBrace + 1);
+  }
+  return import_json5.default.parse(cleanedInput);
+}
+var ajv = new import_ajv.default({
+  allErrors: true,
+  strict: false
+});
+function validateJsonSchema(data, schema) {
+  try {
+    const validate = ajv.compile(schema);
+    const valid = validate(data);
+    if (!valid) {
+      const errors = (validate.errors || []).map((err) => {
+        const path = err.instancePath ? `${err.instancePath.replace(/^\//, "")}` : "value";
+        return `${path}: ${err.message}`;
+      });
+      return { success: false, error: errors.join(", ") };
+    }
+    return { success: true, data };
+  } catch (error) {
+    return {
+      success: false,
+      error: `Schema validation error: ${error instanceof Error ? error.message : String(error)}`
+    };
+  }
+}
+
+// src/utils/wrapper.ts
+var import_core4 = require("@elizaos/core");
+async function withModelRetry({
+  runtime: runtime2,
+  message,
+  state,
+  callback,
+  input,
+  validationFn,
+  createFeedbackPromptFn,
+  failureMsg,
+  retryCount = 0
+}) {
+  const maxRetries = getMaxRetries(runtime2);
+  try {
+    import_core4.logger.info(`[WITH-MODEL-RETRY] Raw selection input:
+${input}`);
+    const parsedJson = typeof input === "string" ? parseJSON(input) : input;
+    import_core4.logger.debug(`[WITH-MODEL-RETRY] Parsed selection input:
+${JSON.stringify(parsedJson, null, 2)}`);
+    const validationResult = validationFn(parsedJson);
+    if (validationResult.success === false) {
+      throw new Error(validationResult.error);
+    }
+    return validationResult.data;
+  } catch (parseError) {
+    const errorMessage = parseError instanceof Error ? parseError.message : "Unknown parsing error";
+    import_core4.logger.error({ errorMessage }, `[WITH-MODEL-RETRY] Failed to parse response: ${errorMessage}`);
+    if (retryCount < maxRetries) {
+      import_core4.logger.debug(`[WITH-MODEL-RETRY] Retrying (attempt ${retryCount + 1}/${maxRetries})`);
+      const feedbackPrompt = createFeedbackPromptFn(input, errorMessage, state, message.content.text || "");
+      const retrySelection = await runtime2.useModel(import_core4.ModelType.OBJECT_LARGE, {
+        prompt: feedbackPrompt
+      });
+      return withModelRetry({
+        runtime: runtime2,
+        input: retrySelection,
+        validationFn,
+        message,
+        state,
+        createFeedbackPromptFn,
+        callback,
+        failureMsg,
+        retryCount: retryCount + 1
+      });
+    }
+    if (callback && failureMsg) {
+      await callback({
+        text: failureMsg,
+        thought: "Failed to parse response after multiple retries. Requesting clarification from user.",
+        actions: ["REPLY"]
+      });
+    }
+    return null;
+  }
+}
+function getMaxRetries(runtime2) {
+  try {
+    const settings = runtime2.getSetting("mcp");
+    if (settings && "maxRetries" in settings && settings.maxRetries !== undefined) {
+      const configValue = Number(settings.maxRetries);
+      if (!Number.isNaN(configValue) && configValue >= 0) {
+        import_core4.logger.debug(`[WITH-MODEL-RETRY] Using configured selection retries: ${configValue}`);
+        return configValue;
+      }
+    }
+  } catch (error) {
+    import_core4.logger.debug({ error: error instanceof Error ? error.message : String(error) }, "[WITH-MODEL-RETRY] Error reading selection retries config");
+  }
+  return DEFAULT_MAX_RETRIES;
+}
+
+// src/templates/toolSelectionTemplate.ts
+var toolSelectionNameTemplate = `
+{{mcpProvider.text}}
+
+{{recentMessages}}
+
+# TASK: Select the Most Appropriate Tool and Server
+
+You must select the most appropriate tool from the list above to fulfill the user's request. Your response must be a valid JSON object with the required properties.
+
+## CRITICAL INSTRUCTIONS
+1. Provide both "serverName" and "toolName" from the options listed above.
+2. Each name must match EXACTLY as shown in the list:
+   - Example (correct): "serverName": "github"
+   - Example (incorrect): "serverName": "GitHub", "Github", or variations
+3. Extract ACTUAL parameter values from the conversation context.
+   - Do not invent or use placeholders like "octocat" or "Hello-World" unless the user said so.
+4. Include a "reasoning" field explaining why the selected tool fits the request.
+5. If no tool is appropriate, respond with:
+   {
+     "noToolAvailable": true
+   }
+
+!!! YOUR RESPONSE MUST BE A VALID JSON OBJECT ONLY !!! 
+
+CRITICAL: Your response must START with { and END with }. DO NOT include ANY text before or after the JSON.
+
+## STRICT FORMAT REQUIREMENTS
+- The response MUST be a single valid JSON object.
+- DO NOT wrap the JSON in triple backticks (\`\`\`), code blocks, or include any explanatory text.
+- DO NOT include comments (// or /* */) anywhere.
+- DO NOT use placeholders (e.g., "replace with...", "example", "your...", etc.)
+- ALL strings must use double quotes.
+
+## CRITICAL NOTES
+- All values must be fully grounded in user input or inferred contextually.
+- No missing fields unless they are explicitly optional in the schema.
+- All types must match the schema (strings, numbers, booleans).
+
+## JSON OBJECT STRUCTURE
+Your response MUST contain ONLY these top-level keys:
+1. "serverName" — The name of the server (e.g., "github", "notion")
+2. "toolName" — The name of the tool (e.g., "get_file_contents", "search")
+3. "reasoning" — A string explaining how the values were inferred from the conversation.
+4. "noToolAvailable" — A boolean indicating if no tool is available (true/false)
+
+## EXAMPLE RESPONSE
+{
+  "serverName": "github",
+  "toolName": "get_file_contents",
+  "reasoning": "The user wants to retrieve the README from the facebook/react repository.",
+  "noToolAvailable": false
+}
+
+## REMINDERS
+- Use "github" as serverName for GitHub tools.
+- Use "notion" as serverName for Notion tools.
+- For search and knowledge-based tasks, MCP tools are often appropriate.
+
+REMEMBER: This output will be parsed directly as JSON. If the format is incorrect, the operation will fail.
+`;
+var toolSelectionArgumentTemplate = `
+{{recentMessages}}
+
+# TASK: Generate a Strictly Valid JSON Object for Tool Execution
+
+You have chosen the "{{toolSelectionName.toolName}}" tool from the "{{toolSelectionName.serverName}}" server to address the user's request.
+The reasoning behind this selection is: "{{toolSelectionName.reasoning}}"
+
+## CRITICAL INSTRUCTIONS
+1. Ensure the "toolArguments" object strictly adheres to the structure and requirements defined in the schema.
+2. All parameter values must be extracted from the conversation context and must be concrete, usable values.
+3. Avoid placeholders or generic terms unless explicitly provided by the user.
+
+!!! YOUR RESPONSE MUST BE A VALID JSON OBJECT ONLY !!! 
+
+## STRICT FORMAT REQUIREMENTS
+- The response MUST be a single valid JSON object.
+- DO NOT wrap the JSON in triple backticks (\`\`\`), code blocks, or include any explanatory text.
+- DO NOT include comments (// or /* */) anywhere.
+- DO NOT use placeholders (e.g., "replace with...", "example", "your...", etc.)
+- ALL strings must use double quotes
+
+## CRITICAL NOTES
+- All values must be fully grounded in user input or inferred contextually.
+- No missing fields unless they are explicitly optional in the schema.
+- All types must match the schema (strings, numbers, booleans).
+
+## JSON OBJECT STRUCTURE
+Your response MUST contain ONLY these two top-level keys:
+1. "toolArguments" — An object matching the input schema: {{toolInputSchema}}
+2. "reasoning" — A string explaining how the values were inferred from the conversation.
+
+## EXAMPLE RESPONSE
+{
+  "toolArguments": {
+    "owner": "facebook",
+    "repo": "react",
+    "path": "README.md",
+    "branch": "main"
+  },
+  "reasoning": "The user wants to see the README from the facebook/react repository based on our conversation."
+}
+
+REMEMBER: Your response will be parsed directly as JSON. If it fails to parse, the operation will fail completely.
+`;
+
+// src/utils/schemas.ts
+var toolSelectionNameSchema = {
+  type: "object",
+  required: ["serverName", "toolName"],
+  properties: {
+    serverName: {
+      type: "string",
+      minLength: 1,
+      errorMessage: "serverName must not be empty"
+    },
+    toolName: {
+      type: "string",
+      minLength: 1,
+      errorMessage: "toolName must not be empty"
+    },
+    reasoning: {
+      type: "string"
+    },
+    noToolAvailable: {
+      type: "boolean"
+    }
+  }
+};
+var toolSelectionArgumentSchema = {
+  type: "object",
+  required: ["toolArguments"],
+  properties: {
+    toolArguments: {
+      type: "object"
+    }
+  }
+};
+
+// src/utils/validation.ts
+function validateToolSelectionName(parsed, state) {
+  const basicResult = validateJsonSchema(parsed, toolSelectionNameSchema);
+  if (basicResult.success === false) {
+    return { success: false, error: basicResult.error };
+  }
+  const data = basicResult.data;
+  const mcpData = state.values.mcp || {};
+  const server = mcpData[data.serverName];
+  if (!server || server.status !== "connected") {
+    return {
+      success: false,
+      error: `Server "${data.serverName}" not found or not connected`
+    };
+  }
+  const toolInfo = server.tools?.[data.toolName];
+  if (!toolInfo) {
+    return {
+      success: false,
+      error: `Tool "${data.toolName}" not found on server "${data.serverName}"`
+    };
+  }
+  return { success: true, data };
+}
+function validateToolSelectionArgument(parsed, toolInputSchema) {
+  const basicResult = validateJsonSchema(parsed, toolSelectionArgumentSchema);
+  if (basicResult.success === false) {
+    return { success: false, error: basicResult.error };
+  }
+  const data = basicResult.data;
+  const validationResult = validateJsonSchema(data.toolArguments, toolInputSchema);
+  if (validationResult.success === false) {
+    return {
+      success: false,
+      error: `Invalid arguments: ${validationResult.error}`
+    };
+  }
+  return { success: true, data };
+}
+function validateResourceSelection(selection) {
+  return validateJsonSchema(selection, ResourceSelectionSchema);
+}
+function createResourceSelectionFeedbackPrompt(originalResponse, errorMessage, composedState, userMessage) {
+  let resourcesDescription = "";
+  for (const [serverName, server] of Object.entries(composedState.values.mcp || {})) {
+    if (server.status !== "connected")
+      continue;
+    for (const [uri, resource] of Object.entries(server.resources || {})) {
+      resourcesDescription += `Resource: ${uri} (Server: ${serverName})
+`;
+      resourcesDescription += `Name: ${resource.name || "No name available"}
+`;
+      resourcesDescription += `Description: ${resource.description || "No description available"}
+
+`;
+    }
+  }
+  return createFeedbackPrompt(originalResponse, errorMessage, "resource", resourcesDescription, userMessage);
+}
+function createFeedbackPrompt(originalResponse, errorMessage, itemType, itemsDescription, userMessage) {
+  return `Error parsing JSON: ${errorMessage}
+
+Your original response:
+${originalResponse}
+
+Please try again with valid JSON for ${itemType} selection.
+Available ${itemType}s:
+${itemsDescription}
+
+User request: ${userMessage}`;
+}
+
+// src/utils/selection.ts
+async function createToolSelectionName({
+  runtime: runtime2,
+  state,
+  message,
+  callback,
+  mcpProvider
+}) {
+  const toolSelectionPrompt = import_core5.composePromptFromState({
+    state: { ...state, values: { ...state.values, mcpProvider } },
+    template: toolSelectionNameTemplate
+  });
+  import_core5.logger.debug(`[SELECTION] Tool Selection Name Prompt:
+${toolSelectionPrompt}`);
+  const toolSelectionName = await runtime2.useModel(import_core5.ModelType.TEXT_LARGE, {
+    prompt: toolSelectionPrompt
+  });
+  import_core5.logger.debug(`[SELECTION] Tool Selection Name Response:
+${toolSelectionName}`);
+  return await withModelRetry({
+    runtime: runtime2,
+    message,
+    state,
+    callback,
+    input: toolSelectionName,
+    validationFn: (parsed) => validateToolSelectionName(parsed, state),
+    createFeedbackPromptFn: (originalResponse, errorMessage, state2, userMessage) => createToolSelectionFeedbackPrompt(originalResponse, errorMessage, state2, userMessage),
+    failureMsg: "I'm having trouble figuring out the best way to help with your request."
+  });
+}
+async function createToolSelectionArgument({
+  runtime: runtime2,
+  state,
+  message,
+  callback,
+  mcpProvider,
+  toolSelectionName
+}) {
+  if (!toolSelectionName) {
+    import_core5.logger.warn("[SELECTION] Tool selection name is not provided. Cannot create tool selection argument.");
+    return null;
+  }
+  const { serverName, toolName } = toolSelectionName;
+  const toolInputSchema = mcpProvider.data.mcp[serverName].tools[toolName].inputSchema;
+  import_core5.logger.trace(`[SELECTION] Tool Input Schema:
+${JSON.stringify({ toolInputSchema }, null, 2)}`);
+  const toolSelectionArgumentPrompt = import_core5.composePromptFromState({
+    state: {
+      ...state,
+      values: {
+        ...state.values,
+        toolSelectionName,
+        toolInputSchema: JSON.stringify(toolInputSchema)
+      }
+    },
+    template: toolSelectionArgumentTemplate
+  });
+  import_core5.logger.debug(`[SELECTION] Tool Selection Prompt:
+${toolSelectionArgumentPrompt}`);
+  const toolSelectionArgument = await runtime2.useModel(import_core5.ModelType.TEXT_LARGE, {
+    prompt: toolSelectionArgumentPrompt
+  });
+  import_core5.logger.debug(`[SELECTION] Tool Selection Argument Response:
+${toolSelectionArgument}`);
+  return await withModelRetry({
+    runtime: runtime2,
+    message,
+    state,
+    callback,
+    input: toolSelectionArgument,
+    validationFn: (parsed) => validateToolSelectionArgument(parsed, state),
+    createFeedbackPromptFn: (originalResponse, errorMessage, state2, userMessage) => createToolSelectionFeedbackPrompt(originalResponse, errorMessage, state2, userMessage),
+    failureMsg: "I'm having trouble figuring out the best way to help with your request."
+  });
+}
+function createToolSelectionFeedbackPrompt(originalResponse, errorMessage, state, userMessage) {
+  let toolsDescription = "";
+  for (const [serverName, server] of Object.entries(state.values.mcp || {})) {
+    if (server.status !== "connected")
+      continue;
+    for (const [toolName, tool] of Object.entries(server.tools || {})) {
+      toolsDescription += `Tool: ${toolName} (Server: ${serverName})
+`;
+      toolsDescription += `Description: ${tool.description || "No description available"}
+
+`;
+    }
+  }
+  const feedbackPrompt = createFeedbackPrompt2(originalResponse, errorMessage, "tool", toolsDescription, userMessage);
+  import_core5.logger.debug(`[SELECTION] Tool Selection Feedback Prompt:
+${feedbackPrompt}`);
+  return feedbackPrompt;
+}
+function createFeedbackPrompt2(originalResponse, errorMessage, itemType, itemsDescription, userMessage) {
+  return `Error parsing JSON: ${errorMessage}
+  
+  Your original response:
+  ${originalResponse}
+  
+  Please try again with valid JSON for ${itemType} selection.
+  Available ${itemType}s:
+  ${itemsDescription}
+  
+  User request: ${userMessage}`;
+}
+
+// src/utils/handler.ts
+async function handleNoToolAvailable(callback, toolSelection) {
+  const responseText = "I don't have a specific tool that can help with that request. Let me try to assist you directly instead.";
+  const thoughtText = "No appropriate MCP tool available for this request. Falling back to direct assistance.";
+  if (callback && toolSelection?.noToolAvailable) {
+    await callback({
+      text: responseText,
+      thought: thoughtText,
+      actions: ["REPLY"]
+    });
+  }
+  return {
+    text: responseText,
+    values: {
+      success: true,
+      noToolAvailable: true,
+      fallbackToDirectAssistance: true
+    },
+    data: {
+      actionName: "CALL_MCP_TOOL",
+      noToolAvailable: true,
+      reason: toolSelection?.reasoning || "No appropriate tool available"
+    },
+    success: true
+  };
+}
+
+// src/actions/callToolAction.ts
+var callToolAction = {
+  name: "CALL_MCP_TOOL",
+  similes: [
+    "CALL_TOOL",
+    "CALL_MCP_TOOL",
+    "USE_TOOL",
+    "USE_MCP_TOOL",
+    "EXECUTE_TOOL",
+    "EXECUTE_MCP_TOOL",
+    "RUN_TOOL",
+    "RUN_MCP_TOOL",
+    "INVOKE_TOOL",
+    "INVOKE_MCP_TOOL"
+  ],
+  description: "Calls a tool from an MCP server to perform a specific task",
+  validate: async (runtime2, _message, _state) => {
+    const mcpService = runtime2.getService(MCP_SERVICE_NAME);
+    if (!mcpService)
+      return false;
+    const servers = mcpService.getServers();
+    return servers.length > 0 && servers.some((server) => server.status === "connected" && server.tools && server.tools.length > 0);
+  },
+  handler: async (runtime2, message, _state, _options, callback) => {
+    const composedState = await runtime2.composeState(message, ["RECENT_MESSAGES", "MCP"]);
+    const mcpService = runtime2.getService(MCP_SERVICE_NAME);
+    if (!mcpService) {
+      throw new Error("MCP service not available");
+    }
+    const mcpProvider = mcpService.getProviderData();
+    try {
+      const toolSelectionName = await createToolSelectionName({
+        runtime: runtime2,
+        state: composedState,
+        message,
+        callback,
+        mcpProvider
+      });
+      if (!toolSelectionName || toolSelectionName.noToolAvailable) {
+        import_core6.logger.warn("[NO_TOOL_AVAILABLE] No appropriate tool available for the request");
+        return await handleNoToolAvailable(callback, toolSelectionName);
+      }
+      const { serverName, toolName, reasoning } = toolSelectionName;
+      import_core6.logger.info(`[CALLING] Calling tool "${serverName}/${toolName}" on server with reasoning: "${reasoning}"`);
+      const toolSelectionArgument = await createToolSelectionArgument({
+        runtime: runtime2,
+        state: composedState,
+        message,
+        callback,
+        mcpProvider,
+        toolSelectionName
+      });
+      if (!toolSelectionArgument) {
+        import_core6.logger.warn("[NO_TOOL_SELECTION_ARGUMENT] No appropriate tool selection argument available");
+        return await handleNoToolAvailable(callback, toolSelectionName);
+      }
+      import_core6.logger.info(`[SELECTED] Tool Selection result:
+${JSON.stringify(toolSelectionArgument, null, 2)}`);
+      const result = await mcpService.callTool(serverName, toolName, toolSelectionArgument.toolArguments);
+      const { toolOutput, hasAttachments, attachments } = processToolResult(result, serverName, toolName, runtime2, message.entityId);
+      await handleToolResponse(runtime2, message, serverName, toolName, toolSelectionArgument.toolArguments, toolOutput, hasAttachments, attachments, composedState, mcpProvider, callback);
+      return {
+        text: `Successfully called tool: ${serverName}/${toolName}`,
+        values: {
+          success: true,
+          toolExecuted: true,
+          serverName,
+          toolName,
+          hasAttachments
+        },
+        data: {
+          actionName: "CALL_MCP_TOOL",
+          serverName,
+          toolName,
+          toolArguments: toolSelectionArgument.toolArguments,
+          reasoning: toolSelectionName.reasoning,
+          output: toolOutput,
+          attachments: attachments || []
+        },
+        success: true
+      };
+    } catch (error) {
+      return await handleMcpError(composedState, mcpProvider, error, runtime2, message, "tool", callback);
+    }
+  },
+  examples: [
+    [
+      {
+        name: "{{user}}",
+        content: {
+          text: "Can you search for information about climate change?"
+        }
+      },
+      {
+        name: "{{assistant}}",
+        content: {
+          text: "I'll help you with that request. Let me access the right tool...",
+          actions: ["CALL_MCP_TOOL"]
+        }
+      },
+      {
+        name: "{{assistant}}",
+        content: {
+          text: `I found the following information about climate change:
+
+Climate change refers to long-term shifts in temperatures and weather patterns. These shifts may be natural, but since the 1800s, human activities have been the main driver of climate change, primarily due to the burning of fossil fuels like coal, oil, and gas, which produces heat-trapping gases.`,
+          actions: ["CALL_MCP_TOOL"]
+        }
+      }
+    ]
+  ]
+};
+
+// src/actions/readResourceAction.ts
+var import_core7 = require("@elizaos/core");
+
+// src/templates/resourceSelectionTemplate.ts
+var resourceSelectionTemplate = `
+{{{mcpProvider.text}}}
+
+{{{recentMessages}}}
+
+# Prompt
+
+You are an intelligent assistant helping select the right resource to address a user's request.
+
+CRITICAL INSTRUCTIONS:
+1. You MUST specify both a valid serverName AND uri from the list above
+2. The serverName value should match EXACTLY the server name shown in parentheses (Server: X)
+   CORRECT: "serverName": "github"  (if the server is called "github") 
+   WRONG: "serverName": "GitHub" or "Github" or any other variation
+3. The uri value should match EXACTLY the resource uri listed
+   CORRECT: "uri": "weather://San Francisco/current"  (if that's the exact uri)
+   WRONG: "uri": "weather://sanfrancisco/current" or any variation
+4. Identify the user's information need from the conversation context
+5. Select the most appropriate resource based on its description and the request
+6. If no resource seems appropriate, output {"noResourceAvailable": true}
+
+!!! YOUR RESPONSE MUST BE A VALID JSON OBJECT ONLY !!! 
+
+STRICT FORMAT REQUIREMENTS:
+- NO code block formatting (NO backticks or \`\`\`)
+- NO comments (NO // or /* */)
+- NO placeholders like "replace with...", "example", "your...", "actual", etc.
+- Every parameter value must be a concrete, usable value (not instructions to replace)
+- Use proper JSON syntax with double quotes for strings
+- NO explanatory text before or after the JSON object
+
+EXAMPLE RESPONSE:
+{
+  "serverName": "weather-server",
+  "uri": "weather://San Francisco/current",
+  "reasoning": "Based on the conversation, the user is asking about current weather in San Francisco. This resource provides up-to-date weather information for that city."
+}
+
+REMEMBER: Your response will be parsed directly as JSON. If it fails to parse, the operation will fail completely!
+`;
+
+// src/actions/readResourceAction.ts
+function createResourceSelectionPrompt(composedState, userMessage) {
+  const mcpData = composedState.values.mcp || {};
+  const serverNames = Object.keys(mcpData);
+  let resourcesDescription = "";
+  for (const serverName of serverNames) {
+    const server = mcpData[serverName];
+    if (server.status !== "connected")
+      continue;
+    const resourceUris = Object.keys(server.resources || {});
+    for (const uri of resourceUris) {
+      const resource = server.resources[uri];
+      resourcesDescription += `Resource: ${uri} (Server: ${serverName})
+`;
+      resourcesDescription += `Name: ${resource.name || "No name available"}
+`;
+      resourcesDescription += `Description: ${resource.description || "No description available"}
+`;
+      resourcesDescription += `MIME Type: ${resource.mimeType || "Not specified"}
+
+`;
+    }
+  }
+  const enhancedState = {
+    ...composedState,
+    values: {
+      ...composedState.values,
+      resourcesDescription,
+      userMessage
+    }
+  };
+  return import_core7.composePromptFromState({
+    state: enhancedState,
+    template: resourceSelectionTemplate
+  });
+}
+var readResourceAction = {
+  name: "READ_MCP_RESOURCE",
+  similes: [
+    "READ_RESOURCE",
+    "READ_MCP_RESOURCE",
+    "GET_RESOURCE",
+    "GET_MCP_RESOURCE",
+    "FETCH_RESOURCE",
+    "FETCH_MCP_RESOURCE",
+    "ACCESS_RESOURCE",
+    "ACCESS_MCP_RESOURCE"
+  ],
+  description: "Reads a resource from an MCP server",
+  validate: async (runtime2, _message, _state) => {
+    const mcpService = runtime2.getService(MCP_SERVICE_NAME);
+    if (!mcpService)
+      return false;
+    const servers = mcpService.getServers();
+    return servers.length > 0 && servers.some((server) => server.status === "connected" && server.resources && server.resources.length > 0);
+  },
+  handler: async (runtime2, message, _state, _options, callback) => {
+    const composedState = await runtime2.composeState(message, ["RECENT_MESSAGES", "MCP"]);
+    const mcpService = runtime2.getService(MCP_SERVICE_NAME);
+    if (!mcpService) {
+      throw new Error("MCP service not available");
+    }
+    const mcpProvider = mcpService.getProviderData();
+    try {
+      await sendInitialResponse(callback);
+      const resourceSelectionPrompt = createResourceSelectionPrompt(composedState, message.content.text || "");
+      const resourceSelection = await runtime2.useModel(import_core7.ModelType.TEXT_SMALL, {
+        prompt: resourceSelectionPrompt
+      });
+      const parsedSelection = await withModelRetry({
+        runtime: runtime2,
+        state: composedState,
+        message,
+        callback,
+        input: resourceSelection,
+        validationFn: (data) => validateResourceSelection(data),
+        createFeedbackPromptFn: (originalResponse, errorMessage, state, userMessage) => createResourceSelectionFeedbackPrompt(originalResponse, errorMessage, state, userMessage),
+        failureMsg: `I'm having trouble finding the resource you're looking for. Could you provide more details about what you need?`,
+        retryCount: 0
+      });
+      if (!parsedSelection || parsedSelection.noResourceAvailable) {
+        const responseText = "I don't have a specific resource that contains the information you're looking for. Let me try to assist you directly instead.";
+        const thoughtText = "No appropriate MCP resource available for this request. Falling back to direct assistance.";
+        if (callback && parsedSelection?.noResourceAvailable) {
+          await callback({
+            text: responseText,
+            thought: thoughtText,
+            actions: ["REPLY"]
+          });
+        }
+        return {
+          text: responseText,
+          values: {
+            success: true,
+            noResourceAvailable: true,
+            fallbackToDirectAssistance: true
+          },
+          data: {
+            actionName: "READ_MCP_RESOURCE",
+            noResourceAvailable: true,
+            reason: parsedSelection?.reasoning || "No appropriate resource available"
+          },
+          success: true
+        };
+      }
+      const { serverName, uri, reasoning } = parsedSelection;
+      import_core7.logger.debug(`Selected resource "${uri}" on server "${serverName}" because: ${reasoning}`);
+      const result = await mcpService.readResource(serverName, uri);
+      import_core7.logger.debug(`Read resource ${uri} from server ${serverName}`);
+      const { resourceContent, resourceMeta } = processResourceResult(result, uri);
+      await handleResourceAnalysis(runtime2, message, uri, serverName, resourceContent, resourceMeta, callback);
+      return {
+        text: `Successfully read resource: ${uri}`,
+        values: {
+          success: true,
+          resourceRead: true,
+          serverName,
+          uri
+        },
+        data: {
+          actionName: "READ_MCP_RESOURCE",
+          serverName,
+          uri,
+          reasoning,
+          resourceMeta,
+          contentLength: resourceContent?.length || 0
+        },
+        success: true
+      };
+    } catch (error) {
+      return await handleMcpError(composedState, mcpProvider, error, runtime2, message, "resource", callback);
+    }
+  },
+  examples: [
+    [
+      {
+        name: "{{user}}",
+        content: {
+          text: "Can you get the documentation about installing ElizaOS?"
+        }
+      },
+      {
+        name: "{{assistant}}",
+        content: {
+          text: `I'll retrieve that information for you. Let me access the resource...`,
+          actions: ["READ_MCP_RESOURCE"]
+        }
+      },
+      {
+        name: "{{assistant}}",
+        content: {
+          text: `ElizaOS installation is straightforward. You'll need Node.js 23+ and Git installed. For Windows users, WSL 2 is required. The quickest way to get started is by cloning the ElizaOS starter repository with \`git clone https://github.com/elizaos/eliza-starter.git\`, then run \`cd eliza-starter && cp .env.example .env && bun i && bun run build && bun start\`. This will set up a development environment with the core features enabled. After starting, you can access the web interface at http://localhost:3000 to interact with your agent.`,
+          actions: ["READ_MCP_RESOURCE"]
+        }
+      }
+    ]
+  ]
+};
+
+// src/provider.ts
+var provider = {
+  name: "MCP",
+  description: "Information about connected MCP servers, tools, and resources",
+  get: async (runtime2, _message, _state) => {
+    const mcpService = runtime2.getService(MCP_SERVICE_NAME);
+    if (!mcpService) {
+      return {
+        values: { mcp: {} },
+        data: { mcp: {} },
+        text: "No MCP servers are available."
+      };
+    }
+    return mcpService.getProviderData();
+  }
+};
+
+// src/service.ts
+var import_core8 = require("@elizaos/core");
+var import_client = require("@modelcontextprotocol/sdk/client/index.js");
+var import_sse = require("@modelcontextprotocol/sdk/client/sse.js");
+var import_stdio = require("@modelcontextprotocol/sdk/client/stdio.js");
+class McpService extends import_core8.Service {
+  static serviceType = MCP_SERVICE_NAME;
+  capabilityDescription = "Enables the agent to interact with MCP (Model Context Protocol) servers";
+  connections = new Map;
+  connectionStates = new Map;
+  mcpProvider = {
+    values: { mcp: {} },
+    data: { mcp: {} },
+    text: ""
+  };
+  pingConfig = DEFAULT_PING_CONFIG;
+  toolCompatibility = null;
+  compatibilityInitialized = false;
+  constructor(runtime2) {
+    super(runtime2);
+    this.initializeMcpServers();
+  }
+  static async start(runtime2) {
+    const service = new McpService(runtime2);
+    return service;
+  }
+  async stop() {
+    for (const [name] of this.connections) {
+      await this.deleteConnection(name);
+    }
+    this.connections.clear();
+    for (const state of this.connectionStates.values()) {
+      if (state.pingInterval)
+        clearInterval(state.pingInterval);
+      if (state.reconnectTimeout)
+        clearTimeout(state.reconnectTimeout);
+    }
+    this.connectionStates.clear();
+  }
+  async initializeMcpServers() {
+    try {
+      const mcpSettings = this.getMcpSettings();
+      if (!mcpSettings || !mcpSettings.servers) {
+        import_core8.logger.info("No MCP servers configured.");
+        return;
+      }
+      await this.updateServerConnections(mcpSettings.servers);
+      const servers = this.getServers();
+      this.mcpProvider = buildMcpProviderData(servers);
+    } catch (error) {
+      import_core8.logger.error({ error: error instanceof Error ? error.message : String(error) }, "Failed to initialize MCP servers");
+    }
+  }
+  getMcpSettings() {
+    return this.runtime.getSetting("mcp");
+  }
+  async updateServerConnections(serverConfigs) {
+    const currentNames = new Set(this.connections.keys());
+    const newNames = new Set(Object.keys(serverConfigs));
+    for (const name of currentNames) {
+      if (!newNames.has(name)) {
+        await this.deleteConnection(name);
+        import_core8.logger.info(`Deleted MCP server: ${name}`);
+      }
+    }
+    for (const [name, config] of Object.entries(serverConfigs)) {
+      const currentConnection = this.connections.get(name);
+      if (!currentConnection) {
+        try {
+          await this.initializeConnection(name, config);
+        } catch (error) {
+          import_core8.logger.error({ error: error instanceof Error ? error.message : String(error), serverName: name }, `Failed to connect to new MCP server ${name}`);
+        }
+      } else if (JSON.stringify(config) !== currentConnection.server.config) {
+        try {
+          await this.deleteConnection(name);
+          await this.initializeConnection(name, config);
+          import_core8.logger.info(`Reconnected MCP server with updated config: ${name}`);
+        } catch (error) {
+          import_core8.logger.error({ error: error instanceof Error ? error.message : String(error), serverName: name }, `Failed to reconnect MCP server ${name}`);
+        }
+      }
+    }
+  }
+  async initializeConnection(name, config) {
+    await this.deleteConnection(name);
+    const state = {
+      status: "connecting",
+      reconnectAttempts: 0,
+      consecutivePingFailures: 0
+    };
+    this.connectionStates.set(name, state);
+    try {
+      const client = new import_client.Client({ name: "ElizaOS", version: "1.0.0" }, { capabilities: {} });
+      const transport = config.type === "stdio" ? await this.buildStdioClientTransport(name, config) : await this.buildHttpClientTransport(name, config);
+      const connection = {
+        server: {
+          name,
+          config: JSON.stringify(config),
+          status: "connecting"
+        },
+        client,
+        transport
+      };
+      this.connections.set(name, connection);
+      this.setupTransportHandlers(name, connection, state);
+      await client.connect(transport);
+      connection.server = {
+        status: "connected",
+        name,
+        config: JSON.stringify(config),
+        error: "",
+        tools: await this.fetchToolsList(name),
+        resources: await this.fetchResourcesList(name),
+        resourceTemplates: await this.fetchResourceTemplatesList(name)
+      };
+      state.status = "connected";
+      state.lastConnected = new Date;
+      state.reconnectAttempts = 0;
+      state.consecutivePingFailures = 0;
+      this.startPingMonitoring(name);
+      import_core8.logger.info(`Successfully connected to MCP server: ${name}`);
+    } catch (error) {
+      state.status = "disconnected";
+      state.lastError = error instanceof Error ? error : new Error(String(error));
+      this.handleDisconnection(name, error);
+      throw error;
+    }
+  }
+  setupTransportHandlers(name, connection, state) {
+    connection.transport.onerror = async (error) => {
+      import_core8.logger.error({ error, serverName: name }, `Transport error for "${name}"`);
+      connection.server.status = "disconnected";
+      this.appendErrorMessage(connection, error.message);
+      this.handleDisconnection(name, error);
+    };
+    connection.transport.onclose = async () => {
+      connection.server.status = "disconnected";
+      this.handleDisconnection(name, new Error("Transport closed"));
+    };
+  }
+  startPingMonitoring(name) {
+    const state = this.connectionStates.get(name);
+    if (!state || !this.pingConfig.enabled)
+      return;
+    if (state.pingInterval)
+      clearInterval(state.pingInterval);
+    state.pingInterval = setInterval(() => {
+      this.sendPing(name).catch((err) => {
+        import_core8.logger.warn({ error: err instanceof Error ? err.message : String(err), serverName: name }, `Ping failed for ${name}`);
+        this.handlePingFailure(name, err);
+      });
+    }, this.pingConfig.intervalMs);
+  }
+  async sendPing(name) {
+    const connection = this.connections.get(name);
+    if (!connection)
+      throw new Error(`No connection for ping: ${name}`);
+    await Promise.race([
+      connection.client.listTools(),
+      new Promise((_, reject) => setTimeout(() => reject(new Error("Ping timeout")), this.pingConfig.timeoutMs))
+    ]);
+    const state = this.connectionStates.get(name);
+    if (state)
+      state.consecutivePingFailures = 0;
+  }
+  handlePingFailure(name, error) {
+    const state = this.connectionStates.get(name);
+    if (!state)
+      return;
+    state.consecutivePingFailures++;
+    if (state.consecutivePingFailures >= this.pingConfig.failuresBeforeDisconnect) {
+      import_core8.logger.warn(`Ping failures exceeded for ${name}, disconnecting and attempting reconnect.`);
+      this.handleDisconnection(name, error);
+    }
+  }
+  handleDisconnection(name, error) {
+    const state = this.connectionStates.get(name);
+    if (!state)
+      return;
+    state.status = "disconnected";
+    state.lastError = error instanceof Error ? error : new Error(String(error));
+    if (state.pingInterval)
+      clearInterval(state.pingInterval);
+    if (state.reconnectTimeout)
+      clearTimeout(state.reconnectTimeout);
+    if (state.reconnectAttempts >= MAX_RECONNECT_ATTEMPTS) {
+      import_core8.logger.error(`Max reconnect attempts reached for ${name}. Giving up.`);
+      return;
+    }
+    const delay = INITIAL_RETRY_DELAY * Math.pow(BACKOFF_MULTIPLIER, state.reconnectAttempts);
+    state.reconnectTimeout = setTimeout(async () => {
+      state.reconnectAttempts++;
+      import_core8.logger.info(`Attempting to reconnect to ${name} (attempt ${state.reconnectAttempts})...`);
+      const config = this.connections.get(name)?.server.config;
+      if (config) {
+        try {
+          await this.initializeConnection(name, JSON.parse(config));
+        } catch (err) {
+          import_core8.logger.error({ error: err instanceof Error ? err.message : String(err), serverName: name }, `Reconnect attempt failed for ${name}`);
+          this.handleDisconnection(name, err);
+        }
+      }
+    }, delay);
+  }
+  async deleteConnection(name) {
+    const connection = this.connections.get(name);
+    if (connection) {
+      try {
+        await connection.transport.close();
+        await connection.client.close();
+      } catch (error) {
+        import_core8.logger.error({ error: error instanceof Error ? error.message : String(error), serverName: name }, `Failed to close transport for ${name}`);
+      }
+      this.connections.delete(name);
+    }
+    const state = this.connectionStates.get(name);
+    if (state) {
+      if (state.pingInterval)
+        clearInterval(state.pingInterval);
+      if (state.reconnectTimeout)
+        clearTimeout(state.reconnectTimeout);
+      this.connectionStates.delete(name);
+    }
+  }
+  getServerConnection(serverName) {
+    return this.connections.get(serverName);
+  }
+  async buildStdioClientTransport(name, config) {
+    if (!config.command) {
+      throw new Error(`Missing command for stdio MCP server ${name}`);
+    }
+    return new import_stdio.StdioClientTransport({
+      command: config.command,
+      args: config.args,
+      env: {
+        ...config.env,
+        ...process.env.PATH ? { PATH: process.env.PATH } : {}
+      },
+      stderr: "pipe",
+      cwd: config.cwd
+    });
+  }
+  async buildHttpClientTransport(name, config) {
+    if (!config.url) {
+      throw new Error(`Missing URL for HTTP MCP server ${name}`);
+    }
+    if (config.type === "sse") {
+      import_core8.logger.warn(`Server "${name}": "sse" transport type is deprecated. Use "streamable-http" or "http" instead for the modern Streamable HTTP transport.`);
+    }
+    return new import_sse.SSEClientTransport(new URL(config.url));
+  }
+  appendErrorMessage(connection, error) {
+    const newError = connection.server.error ? `${connection.server.error}
+${error}` : error;
+    connection.server.error = newError;
+  }
+  async fetchToolsList(serverName) {
+    try {
+      const connection = this.getServerConnection(serverName);
+      if (!connection) {
+        return [];
+      }
+      const response = await connection.client.listTools();
+      const tools = (response?.tools || []).map((tool) => {
+        let processedTool = { ...tool };
+        if (tool.inputSchema) {
+          try {
+            if (!this.compatibilityInitialized) {
+              this.initializeToolCompatibility();
+            }
+            processedTool.inputSchema = this.applyToolCompatibility(tool.inputSchema);
+            import_core8.logger.debug(`Applied tool compatibility for: ${tool.name} on server: ${serverName}`);
+          } catch (error) {
+            import_core8.logger.warn({ error, toolName: tool.name, serverName }, `Tool compatibility failed for ${tool.name} on ${serverName}`);
+          }
+        }
+        return processedTool;
+      });
+      import_core8.logger.info(`Fetched ${tools.length} tools for ${serverName}`);
+      for (const tool of tools) {
+        import_core8.logger.info(`[${serverName}] ${tool.name}: ${tool.description}`);
+      }
+      return tools;
+    } catch (error) {
+      import_core8.logger.error({ error: error instanceof Error ? error.message : String(error), serverName }, `Failed to fetch tools for ${serverName}`);
+      return [];
+    }
+  }
+  async fetchResourcesList(serverName) {
+    try {
+      const connection = this.getServerConnection(serverName);
+      if (!connection) {
+        return [];
+      }
+      const response = await connection.client.listResources();
+      return response?.resources || [];
+    } catch (error) {
+      import_core8.logger.warn({ error: error instanceof Error ? error.message : String(error), serverName }, `No resources found for ${serverName}`);
+      return [];
+    }
+  }
+  async fetchResourceTemplatesList(serverName) {
+    try {
+      const connection = this.getServerConnection(serverName);
+      if (!connection) {
+        return [];
+      }
+      const response = await connection.client.listResourceTemplates();
+      return response?.resourceTemplates || [];
+    } catch (error) {
+      import_core8.logger.warn({ error: error instanceof Error ? error.message : String(error), serverName }, `No resource templates found for ${serverName}`);
+      return [];
+    }
+  }
+  getServers() {
+    return Array.from(this.connections.values()).filter((conn) => !conn.server.disabled).map((conn) => conn.server);
+  }
+  getProviderData() {
+    return this.mcpProvider;
+  }
+  async callTool(serverName, toolName, toolArguments) {
+    const connection = this.connections.get(serverName);
+    if (!connection) {
+      throw new Error(`No connection found for server: ${serverName}`);
+    }
+    if (connection.server.disabled) {
+      throw new Error(`Server "${serverName}" is disabled`);
+    }
+    let timeout = DEFAULT_MCP_TIMEOUT_SECONDS;
+    try {
+      const config = JSON.parse(connection.server.config);
+      timeout = config.timeoutInMillis || DEFAULT_MCP_TIMEOUT_SECONDS;
+    } catch (error) {
+      import_core8.logger.error({ error: error instanceof Error ? error.message : String(error), serverName }, `Failed to parse timeout configuration for server ${serverName}`);
+    }
+    const result = await connection.client.callTool({ name: toolName, arguments: toolArguments }, undefined, { timeout });
+    if (!result.content) {
+      throw new Error("Invalid tool result: missing content array");
+    }
+    return result;
+  }
+  async readResource(serverName, uri) {
+    const connection = this.connections.get(serverName);
+    if (!connection) {
+      throw new Error(`No connection found for server: ${serverName}`);
+    }
+    if (connection.server.disabled) {
+      throw new Error(`Server "${serverName}" is disabled`);
+    }
+    return await connection.client.readResource({ uri });
+  }
+  async restartConnection(serverName) {
+    const connection = this.connections.get(serverName);
+    const config = connection?.server.config;
+    if (config) {
+      import_core8.logger.info(`Restarting ${serverName} MCP server...`);
+      connection.server.status = "connecting";
+      connection.server.error = "";
+      try {
+        await this.deleteConnection(serverName);
+        await this.initializeConnection(serverName, JSON.parse(config));
+        import_core8.logger.info(`${serverName} MCP server connected`);
+      } catch (error) {
+        import_core8.logger.error({ error: error instanceof Error ? error.message : String(error), serverName }, `Failed to restart connection for ${serverName}`);
+        throw new Error(`Failed to connect to ${serverName} MCP server`);
+      }
+    }
+  }
+  initializeToolCompatibility() {
+    if (this.compatibilityInitialized)
+      return;
+    this.toolCompatibility = createMcpToolCompatibilitySync(this.runtime);
+    this.compatibilityInitialized = true;
+    if (this.toolCompatibility) {
+      import_core8.logger.info(`Tool compatibility enabled`);
+    } else {
+      import_core8.logger.info(`No tool compatibility needed`);
+    }
+  }
+  applyToolCompatibility(toolSchema) {
+    if (!this.compatibilityInitialized) {
+      this.initializeToolCompatibility();
+    }
+    if (!this.toolCompatibility || !toolSchema) {
+      return toolSchema;
+    }
+    try {
+      return this.toolCompatibility.transformToolSchema(toolSchema);
+    } catch (error) {
+      import_core8.logger.warn({ error }, `Tool compatibility transformation failed`);
+      return toolSchema;
+    }
+  }
+}
+
+// src/index.ts
+var mcpPlugin = {
+  name: "mcp",
+  description: "Plugin for connecting to MCP (Model Context Protocol) servers",
+  init: async (_config, _runtime) => {
+    import_core9.logger.info("Initializing MCP plugin...");
+  },
+  services: [McpService],
+  actions: [callToolAction, readResourceAction],
+  providers: [provider]
+};
+var src_default = mcpPlugin;
+
+//# debugId=8A51CB12924419AD64756E2164756E21