@scoutqa/mastra-core 0.24.6-fork.1

package/dist/mastra/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mastra/index.ts"],"names":[],"mappings":"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"}

package/dist/mastra/index.js

@@ -0,0 +1,3 @@
+export { Mastra } from '../chunk-YFKTLS32.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/mastra/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/mcp/index.cjs

@@ -0,0 +1,112 @@
+'use strict';
+
+var chunk6VOPKVYH_cjs = require('../chunk-6VOPKVYH.cjs');
+var chunkA5KDVZDL_cjs = require('../chunk-A5KDVZDL.cjs');
+var crypto = require('crypto');
+var slugify = require('@sindresorhus/slugify');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var slugify__default = /*#__PURE__*/_interopDefault(slugify);
+
+var MCPServerBase = class extends chunk6VOPKVYH_cjs.MastraBase {
+  /** Tracks if the server ID has been definitively set. */
+  idWasSet = false;
+  /** The display name of the MCP server. */
+  name;
+  /** The semantic version of the MCP server. */
+  version;
+  /** Internal storage for the server's unique ID. */
+  _id;
+  /** A description of what the MCP server does. */
+  description;
+  /** Repository information for the server's source code. */
+  repository;
+  /** The release date of this server version (ISO 8601 string). */
+  releaseDate;
+  /** Indicates if this version is the latest available. */
+  isLatest;
+  /** The canonical packaging format (e.g., "npm", "docker"), if applicable. */
+  packageCanonical;
+  /** Information about installable packages for this server. */
+  packages;
+  /** Information about remote access points for this server. */
+  remotes;
+  /** The tools registered with and converted by this MCP server. */
+  convertedTools;
+  /** Reference to the Mastra instance if this server is registered with one. */
+  mastra;
+  /** Agents to be exposed as tools. */
+  agents;
+  /** Workflows to be exposed as tools. */
+  workflows;
+  /** Original tools configuration for re-conversion when Mastra instance is registered. */
+  originalTools;
+  /**
+   * Public getter for the server's unique ID.
+   * The ID is set at construction or by Mastra and is read-only afterwards.
+   */
+  get id() {
+    return this._id;
+  }
+  /**
+   * Gets a read-only view of the registered tools.
+   * @returns A readonly record of converted tools.
+   */
+  tools() {
+    return this.convertedTools;
+  }
+  /**
+   * Sets the server's unique ID. This method is typically called by Mastra when
+   * registering the server, using the key provided in the Mastra configuration.
+   * It ensures the ID is set only once.
+   * If an ID was already provided in the MCPServerConfig, this method will be a no-op.
+   * @param id The unique ID to assign to the server.
+   */
+  setId(id) {
+    if (this.idWasSet) {
+      return;
+    }
+    this._id = id;
+    this.idWasSet = true;
+  }
+  /**
+   * Internal method used by Mastra to register itself with the server.
+   * @param mastra The Mastra instance.
+   * @internal
+   */
+  __registerMastra(mastra) {
+    this.mastra = mastra;
+    this.convertedTools = this.convertTools(this.originalTools, this.agents, this.workflows);
+  }
+  /**
+   * Constructor for the MCPServerBase.
+   * @param config Configuration options for the MCP server, including metadata.
+   */
+  constructor(config) {
+    super({ component: chunkA5KDVZDL_cjs.RegisteredLogger.MCP_SERVER, name: config.name });
+    this.name = config.name;
+    this.version = config.version;
+    if (config.id) {
+      this._id = slugify__default.default(config.id);
+      this.idWasSet = true;
+    } else {
+      this._id = this.mastra?.generateId() || crypto.randomUUID();
+    }
+    this.description = config.description;
+    this.repository = config.repository;
+    this.releaseDate = config.releaseDate || (/* @__PURE__ */ new Date()).toISOString();
+    this.isLatest = config.isLatest === void 0 ? true : config.isLatest;
+    this.packageCanonical = config.packageCanonical;
+    this.packages = config.packages;
+    this.remotes = config.remotes;
+    this.agents = config.agents;
+    this.workflows = config.workflows;
+    this.originalTools = config.tools;
+    this.convertedTools = this.convertTools(config.tools, config.agents, config.workflows);
+  }
+};
+
+exports.MCPServerBase = MCPServerBase;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/mcp/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/index.ts"],"names":["MastraBase","RegisteredLogger","slugify","randomUUID"],"mappings":";;;;;;;;;;;AA0BO,IAAe,aAAA,GAAf,cAAqCA,4BAAA,CAAW;AAAA;AAAA,EAE7C,QAAA,GAAW,KAAA;AAAA;AAAA,EAEH,IAAA;AAAA;AAAA,EAEA,OAAA;AAAA;AAAA,EAER,GAAA;AAAA;AAAA,EAEQ,WAAA;AAAA;AAAA,EAEA,UAAA;AAAA;AAAA,EAEA,WAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,gBAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,OAAA;AAAA;AAAA,EAET,cAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEY,MAAA;AAAA;AAAA,EAEA,SAAA;AAAA;AAAA,EAEA,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnB,IAAW,EAAA,GAAa;AACtB,IAAA,OAAO,IAAA,CAAK,GAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAA,GAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,EAAA,EAAY;AAChB,IAAA,IAAI,KAAK,QAAA,EAAU;AACjB,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,GAAA,GAAM,EAAA;AACX,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,iBAAiB,MAAA,EAAsB;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAEd,IAAA,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,IAAA,CAAK,eAAe,IAAA,CAAK,MAAA,EAAQ,KAAK,SAAS,CAAA;AAAA,EACzF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAY,MAAA,EAAyB;AACnC,IAAA,KAAA,CAAM,EAAE,SAAA,EAAWC,kCAAA,CAAiB,YAAY,IAAA,EAAM,MAAA,CAAO,MAAM,CAAA;AACnE,IAAA,IAAA,CAAK,OAAO,MAAA,CAAO,IAAA;AACnB,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,OAAA;AAItB,IAAA,IAAI,OAAO,EAAA,EAAI;AACb,MAAA,IAAA,CAAK,GAAA,GAAMC,wBAAA,CAAQ,MAAA,CAAO,EAAE,CAAA;AAC5B,MAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAAA,IAClB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,GAAA,GAAM,IAAA,CAAK,MAAA,EAAQ,UAAA,MAAgBC,iBAAA,EAAW;AAAA,IACrD;AAEA,IAAA,IAAA,CAAK,cAAc,MAAA,CAAO,WAAA;AAC1B,IAAA,IAAA,CAAK,aAAa,MAAA,CAAO,UAAA;AACzB,IAAA,IAAA,CAAK,cAAc,MAAA,CAAO,WAAA,IAAA,iBAAe,IAAI,IAAA,IAAO,WAAA,EAAY;AAChE,IAAA,IAAA,CAAK,QAAA,GAAW,MAAA,CAAO,QAAA,KAAa,MAAA,GAAY,OAAO,MAAA,CAAO,QAAA;AAC9D,IAAA,IAAA,CAAK,mBAAmB,MAAA,CAAO,gBAAA;AAC/B,IAAA,IAAA,CAAK,WAAW,MAAA,CAAO,QAAA;AACvB,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,OAAA;AACtB,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA;AACrB,IAAA,IAAA,CAAK,YAAY,MAAA,CAAO,SAAA;AACxB,IAAA,IAAA,CAAK,gBAAgB,MAAA,CAAO,KAAA;AAC5B,IAAA,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,MAAA,CAAO,OAAO,MAAA,CAAO,MAAA,EAAQ,OAAO,SAAS,CAAA;AAAA,EACvF;AA6EF","file":"index.cjs","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport slugify from '@sindresorhus/slugify';\nimport type { ToolsInput } from '../agent';\nimport { MastraBase } from '../base';\nimport { RegisteredLogger } from '../logger';\nimport type { Mastra } from '../mastra';\nimport type {\n  ConvertedTool,\n  MCPServerConfig,\n  MCPServerHonoSSEOptions,\n  MCPServerHTTPOptions,\n  MCPServerSSEOptions,\n  MCPToolType,\n  PackageInfo,\n  RemoteInfo,\n  Repository,\n  ServerDetailInfo,\n  ServerInfo,\n} from './types';\nexport * from './types';\n\n/**\n * Abstract base class for MCP server implementations.\n * This provides a common interface and shared functionality for all MCP servers\n * that can be registered with Mastra, including handling of server metadata.\n */\nexport abstract class MCPServerBase extends MastraBase {\n  /** Tracks if the server ID has been definitively set. */\n  private idWasSet = false;\n  /** The display name of the MCP server. */\n  public readonly name: string;\n  /** The semantic version of the MCP server. */\n  public readonly version: string;\n  /** Internal storage for the server's unique ID. */\n  private _id: string;\n  /** A description of what the MCP server does. */\n  public readonly description?: string;\n  /** Repository information for the server's source code. */\n  public readonly repository?: Repository;\n  /** The release date of this server version (ISO 8601 string). */\n  public readonly releaseDate: string;\n  /** Indicates if this version is the latest available. */\n  public readonly isLatest: boolean;\n  /** The canonical packaging format (e.g., \"npm\", \"docker\"), if applicable. */\n  public readonly packageCanonical?: MCPServerConfig['packageCanonical'];\n  /** Information about installable packages for this server. */\n  public readonly packages?: PackageInfo[];\n  /** Information about remote access points for this server. */\n  public readonly remotes?: RemoteInfo[];\n  /** The tools registered with and converted by this MCP server. */\n  public convertedTools: Record<string, ConvertedTool>;\n  /** Reference to the Mastra instance if this server is registered with one. */\n  public mastra: Mastra | undefined;\n  /** Agents to be exposed as tools. */\n  protected readonly agents?: MCPServerConfig['agents'];\n  /** Workflows to be exposed as tools. */\n  protected readonly workflows?: MCPServerConfig['workflows'];\n  /** Original tools configuration for re-conversion when Mastra instance is registered. */\n  protected readonly originalTools: ToolsInput;\n\n  /**\n   * Public getter for the server's unique ID.\n   * The ID is set at construction or by Mastra and is read-only afterwards.\n   */\n  public get id(): string {\n    return this._id;\n  }\n\n  /**\n   * Gets a read-only view of the registered tools.\n   * @returns A readonly record of converted tools.\n   */\n  tools(): Readonly<Record<string, ConvertedTool>> {\n    return this.convertedTools;\n  }\n\n  /**\n   * Sets the server's unique ID. This method is typically called by Mastra when\n   * registering the server, using the key provided in the Mastra configuration.\n   * It ensures the ID is set only once.\n   * If an ID was already provided in the MCPServerConfig, this method will be a no-op.\n   * @param id The unique ID to assign to the server.\n   */\n  setId(id: string) {\n    if (this.idWasSet) {\n      return;\n    }\n    this._id = id;\n    this.idWasSet = true;\n  }\n\n  /**\n   * Abstract method to convert and validate tool definitions provided to the server.\n   * This method will also handle agents passed in the config.\n   * @param tools Tool definitions to convert.\n   * @param agents Agent definitions to convert to tools.\n   * @param workflows Workflow definitions to convert to tools.\n   * @returns A record of converted and validated tools.\n   */\n  public abstract convertTools(\n    tools: ToolsInput,\n    agents?: MCPServerConfig['agents'],\n    workflows?: MCPServerConfig['workflows'],\n  ): Record<string, ConvertedTool>;\n\n  /**\n   * Internal method used by Mastra to register itself with the server.\n   * @param mastra The Mastra instance.\n   * @internal\n   */\n  __registerMastra(mastra: Mastra): void {\n    this.mastra = mastra;\n    // Re-convert tools now that we have the Mastra instance to populate MCP tools execute with mastra instance\n    this.convertedTools = this.convertTools(this.originalTools, this.agents, this.workflows);\n  }\n\n  /**\n   * Constructor for the MCPServerBase.\n   * @param config Configuration options for the MCP server, including metadata.\n   */\n  constructor(config: MCPServerConfig) {\n    super({ component: RegisteredLogger.MCP_SERVER, name: config.name });\n    this.name = config.name;\n    this.version = config.version;\n\n    // If user does not provide an ID, we will use the key from the Mastra config, but if user does not pass MCPServer\n    // to Mastra, we will generate a random UUID as a backup.\n    if (config.id) {\n      this._id = slugify(config.id);\n      this.idWasSet = true;\n    } else {\n      this._id = this.mastra?.generateId() || randomUUID();\n    }\n\n    this.description = config.description;\n    this.repository = config.repository;\n    this.releaseDate = config.releaseDate || new Date().toISOString();\n    this.isLatest = config.isLatest === undefined ? true : config.isLatest;\n    this.packageCanonical = config.packageCanonical;\n    this.packages = config.packages;\n    this.remotes = config.remotes;\n    this.agents = config.agents;\n    this.workflows = config.workflows;\n    this.originalTools = config.tools;\n    this.convertedTools = this.convertTools(config.tools, config.agents, config.workflows);\n  }\n\n  /**\n   * Start the MCP server using stdio transport\n   * This is typically used for Windsurf integration\n   */\n  public abstract startStdio(): Promise<void>;\n\n  /**\n   * Start the MCP server using SSE transport\n   * This is typically used for web integration\n   * @param options Options for the SSE transport\n   */\n  public abstract startSSE(options: MCPServerSSEOptions): Promise<void>;\n\n  /**\n   * Start the MCP server using Hono SSE transport\n   * Used for Hono servers\n   * @param options Options for the SSE transport\n   */\n  public abstract startHonoSSE(options: MCPServerHonoSSEOptions): Promise<Response | undefined>;\n\n  /**\n   * Start the MCP server using HTTP transport\n   * @param options Options for the HTTP transport\n   */\n  public abstract startHTTP(options: MCPServerHTTPOptions): Promise<void>;\n\n  /**\n   * Close the MCP server and all its connections\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Gets the basic information about the server, conforming to the MCP Registry 'Server' schema.\n   * This information is suitable for listing multiple servers.\n   * @returns ServerInfo object containing basic server metadata.\n   */\n  public abstract getServerInfo(): ServerInfo;\n\n  /**\n   * Gets detailed information about the server, conforming to the MCP Registry 'ServerDetail' schema.\n   * This includes all information from `getServerInfo` plus package and remote details.\n   * @returns ServerDetailInfo object containing comprehensive server metadata.\n   */\n  public abstract getServerDetail(): ServerDetailInfo;\n\n  /**\n   * Gets a list of tools provided by this MCP server, including their schemas.\n   * @returns An object containing an array of tool information.\n   */\n  public abstract getToolListInfo(): {\n    tools: Array<{ name: string; description?: string; inputSchema: any; outputSchema?: any; toolType?: MCPToolType }>;\n  };\n\n  /**\n   * Gets information for a specific tool provided by this MCP server.\n   * @param toolId The ID/name of the tool to retrieve.\n   * @returns Tool information (name, description, inputSchema) or undefined if not found.\n   */\n  public abstract getToolInfo(\n    toolId: string,\n  ): { name: string; description?: string; inputSchema: any; outputSchema?: any; toolType?: MCPToolType } | undefined;\n\n  /**\n   * Executes a specific tool provided by this MCP server.\n   * @param toolId The ID/name of the tool to execute.\n   * @param args The arguments to pass to the tool's execute function.\n   * @param executionContext Optional context for the tool execution (e.g., messages, toolCallId).\n   * @returns A promise that resolves to the result of the tool execution.\n   * @throws Error if the tool is not found, or if execution fails.\n   */\n  public abstract executeTool(\n    toolId: string,\n    args: any,\n    executionContext?: { messages?: any[]; toolCallId?: string },\n  ): Promise<any>;\n}\n"]}

package/dist/mcp/index.d.ts

@@ -0,0 +1,158 @@
+import type { ToolsInput } from '../agent/index.js';
+import { MastraBase } from '../base.js';
+import type { Mastra } from '../mastra/index.js';
+import type { ConvertedTool, MCPServerConfig, MCPServerHonoSSEOptions, MCPServerHTTPOptions, MCPServerSSEOptions, MCPToolType, PackageInfo, RemoteInfo, Repository, ServerDetailInfo, ServerInfo } from './types.js';
+export * from './types.js';
+/**
+ * Abstract base class for MCP server implementations.
+ * This provides a common interface and shared functionality for all MCP servers
+ * that can be registered with Mastra, including handling of server metadata.
+ */
+export declare abstract class MCPServerBase extends MastraBase {
+    /** Tracks if the server ID has been definitively set. */
+    private idWasSet;
+    /** The display name of the MCP server. */
+    readonly name: string;
+    /** The semantic version of the MCP server. */
+    readonly version: string;
+    /** Internal storage for the server's unique ID. */
+    private _id;
+    /** A description of what the MCP server does. */
+    readonly description?: string;
+    /** Repository information for the server's source code. */
+    readonly repository?: Repository;
+    /** The release date of this server version (ISO 8601 string). */
+    readonly releaseDate: string;
+    /** Indicates if this version is the latest available. */
+    readonly isLatest: boolean;
+    /** The canonical packaging format (e.g., "npm", "docker"), if applicable. */
+    readonly packageCanonical?: MCPServerConfig['packageCanonical'];
+    /** Information about installable packages for this server. */
+    readonly packages?: PackageInfo[];
+    /** Information about remote access points for this server. */
+    readonly remotes?: RemoteInfo[];
+    /** The tools registered with and converted by this MCP server. */
+    convertedTools: Record<string, ConvertedTool>;
+    /** Reference to the Mastra instance if this server is registered with one. */
+    mastra: Mastra | undefined;
+    /** Agents to be exposed as tools. */
+    protected readonly agents?: MCPServerConfig['agents'];
+    /** Workflows to be exposed as tools. */
+    protected readonly workflows?: MCPServerConfig['workflows'];
+    /** Original tools configuration for re-conversion when Mastra instance is registered. */
+    protected readonly originalTools: ToolsInput;
+    /**
+     * Public getter for the server's unique ID.
+     * The ID is set at construction or by Mastra and is read-only afterwards.
+     */
+    get id(): string;
+    /**
+     * Gets a read-only view of the registered tools.
+     * @returns A readonly record of converted tools.
+     */
+    tools(): Readonly<Record<string, ConvertedTool>>;
+    /**
+     * Sets the server's unique ID. This method is typically called by Mastra when
+     * registering the server, using the key provided in the Mastra configuration.
+     * It ensures the ID is set only once.
+     * If an ID was already provided in the MCPServerConfig, this method will be a no-op.
+     * @param id The unique ID to assign to the server.
+     */
+    setId(id: string): void;
+    /**
+     * Abstract method to convert and validate tool definitions provided to the server.
+     * This method will also handle agents passed in the config.
+     * @param tools Tool definitions to convert.
+     * @param agents Agent definitions to convert to tools.
+     * @param workflows Workflow definitions to convert to tools.
+     * @returns A record of converted and validated tools.
+     */
+    abstract convertTools(tools: ToolsInput, agents?: MCPServerConfig['agents'], workflows?: MCPServerConfig['workflows']): Record<string, ConvertedTool>;
+    /**
+     * Internal method used by Mastra to register itself with the server.
+     * @param mastra The Mastra instance.
+     * @internal
+     */
+    __registerMastra(mastra: Mastra): void;
+    /**
+     * Constructor for the MCPServerBase.
+     * @param config Configuration options for the MCP server, including metadata.
+     */
+    constructor(config: MCPServerConfig);
+    /**
+     * Start the MCP server using stdio transport
+     * This is typically used for Windsurf integration
+     */
+    abstract startStdio(): Promise<void>;
+    /**
+     * Start the MCP server using SSE transport
+     * This is typically used for web integration
+     * @param options Options for the SSE transport
+     */
+    abstract startSSE(options: MCPServerSSEOptions): Promise<void>;
+    /**
+     * Start the MCP server using Hono SSE transport
+     * Used for Hono servers
+     * @param options Options for the SSE transport
+     */
+    abstract startHonoSSE(options: MCPServerHonoSSEOptions): Promise<Response | undefined>;
+    /**
+     * Start the MCP server using HTTP transport
+     * @param options Options for the HTTP transport
+     */
+    abstract startHTTP(options: MCPServerHTTPOptions): Promise<void>;
+    /**
+     * Close the MCP server and all its connections
+     */
+    abstract close(): Promise<void>;
+    /**
+     * Gets the basic information about the server, conforming to the MCP Registry 'Server' schema.
+     * This information is suitable for listing multiple servers.
+     * @returns ServerInfo object containing basic server metadata.
+     */
+    abstract getServerInfo(): ServerInfo;
+    /**
+     * Gets detailed information about the server, conforming to the MCP Registry 'ServerDetail' schema.
+     * This includes all information from `getServerInfo` plus package and remote details.
+     * @returns ServerDetailInfo object containing comprehensive server metadata.
+     */
+    abstract getServerDetail(): ServerDetailInfo;
+    /**
+     * Gets a list of tools provided by this MCP server, including their schemas.
+     * @returns An object containing an array of tool information.
+     */
+    abstract getToolListInfo(): {
+        tools: Array<{
+            name: string;
+            description?: string;
+            inputSchema: any;
+            outputSchema?: any;
+            toolType?: MCPToolType;
+        }>;
+    };
+    /**
+     * Gets information for a specific tool provided by this MCP server.
+     * @param toolId The ID/name of the tool to retrieve.
+     * @returns Tool information (name, description, inputSchema) or undefined if not found.
+     */
+    abstract getToolInfo(toolId: string): {
+        name: string;
+        description?: string;
+        inputSchema: any;
+        outputSchema?: any;
+        toolType?: MCPToolType;
+    } | undefined;
+    /**
+     * Executes a specific tool provided by this MCP server.
+     * @param toolId The ID/name of the tool to execute.
+     * @param args The arguments to pass to the tool's execute function.
+     * @param executionContext Optional context for the tool execution (e.g., messages, toolCallId).
+     * @returns A promise that resolves to the result of the tool execution.
+     * @throws Error if the tool is not found, or if execution fails.
+     */
+    abstract executeTool(toolId: string, args: any, executionContext?: {
+        messages?: any[];
+        toolCallId?: string;
+    }): Promise<any>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.js

@@ -0,0 +1,106 @@
+import { MastraBase } from '../chunk-VQASQG5D.js';
+import { RegisteredLogger } from '../chunk-UXG7PYML.js';
+import { randomUUID } from 'crypto';
+import slugify from '@sindresorhus/slugify';
+
+var MCPServerBase = class extends MastraBase {
+  /** Tracks if the server ID has been definitively set. */
+  idWasSet = false;
+  /** The display name of the MCP server. */
+  name;
+  /** The semantic version of the MCP server. */
+  version;
+  /** Internal storage for the server's unique ID. */
+  _id;
+  /** A description of what the MCP server does. */
+  description;
+  /** Repository information for the server's source code. */
+  repository;
+  /** The release date of this server version (ISO 8601 string). */
+  releaseDate;
+  /** Indicates if this version is the latest available. */
+  isLatest;
+  /** The canonical packaging format (e.g., "npm", "docker"), if applicable. */
+  packageCanonical;
+  /** Information about installable packages for this server. */
+  packages;
+  /** Information about remote access points for this server. */
+  remotes;
+  /** The tools registered with and converted by this MCP server. */
+  convertedTools;
+  /** Reference to the Mastra instance if this server is registered with one. */
+  mastra;
+  /** Agents to be exposed as tools. */
+  agents;
+  /** Workflows to be exposed as tools. */
+  workflows;
+  /** Original tools configuration for re-conversion when Mastra instance is registered. */
+  originalTools;
+  /**
+   * Public getter for the server's unique ID.
+   * The ID is set at construction or by Mastra and is read-only afterwards.
+   */
+  get id() {
+    return this._id;
+  }
+  /**
+   * Gets a read-only view of the registered tools.
+   * @returns A readonly record of converted tools.
+   */
+  tools() {
+    return this.convertedTools;
+  }
+  /**
+   * Sets the server's unique ID. This method is typically called by Mastra when
+   * registering the server, using the key provided in the Mastra configuration.
+   * It ensures the ID is set only once.
+   * If an ID was already provided in the MCPServerConfig, this method will be a no-op.
+   * @param id The unique ID to assign to the server.
+   */
+  setId(id) {
+    if (this.idWasSet) {
+      return;
+    }
+    this._id = id;
+    this.idWasSet = true;
+  }
+  /**
+   * Internal method used by Mastra to register itself with the server.
+   * @param mastra The Mastra instance.
+   * @internal
+   */
+  __registerMastra(mastra) {
+    this.mastra = mastra;
+    this.convertedTools = this.convertTools(this.originalTools, this.agents, this.workflows);
+  }
+  /**
+   * Constructor for the MCPServerBase.
+   * @param config Configuration options for the MCP server, including metadata.
+   */
+  constructor(config) {
+    super({ component: RegisteredLogger.MCP_SERVER, name: config.name });
+    this.name = config.name;
+    this.version = config.version;
+    if (config.id) {
+      this._id = slugify(config.id);
+      this.idWasSet = true;
+    } else {
+      this._id = this.mastra?.generateId() || randomUUID();
+    }
+    this.description = config.description;
+    this.repository = config.repository;
+    this.releaseDate = config.releaseDate || (/* @__PURE__ */ new Date()).toISOString();
+    this.isLatest = config.isLatest === void 0 ? true : config.isLatest;
+    this.packageCanonical = config.packageCanonical;
+    this.packages = config.packages;
+    this.remotes = config.remotes;
+    this.agents = config.agents;
+    this.workflows = config.workflows;
+    this.originalTools = config.tools;
+    this.convertedTools = this.convertTools(config.tools, config.agents, config.workflows);
+  }
+};
+
+export { MCPServerBase };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/index.ts"],"names":[],"mappings":";;;;;AA0BO,IAAe,aAAA,GAAf,cAAqC,UAAA,CAAW;AAAA;AAAA,EAE7C,QAAA,GAAW,KAAA;AAAA;AAAA,EAEH,IAAA;AAAA;AAAA,EAEA,OAAA;AAAA;AAAA,EAER,GAAA;AAAA;AAAA,EAEQ,WAAA;AAAA;AAAA,EAEA,UAAA;AAAA;AAAA,EAEA,WAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,gBAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,OAAA;AAAA;AAAA,EAET,cAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA,EAEY,MAAA;AAAA;AAAA,EAEA,SAAA;AAAA;AAAA,EAEA,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnB,IAAW,EAAA,GAAa;AACtB,IAAA,OAAO,IAAA,CAAK,GAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAA,GAAiD;AAC/C,IAAA,OAAO,IAAA,CAAK,cAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,EAAA,EAAY;AAChB,IAAA,IAAI,KAAK,QAAA,EAAU;AACjB,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,GAAA,GAAM,EAAA;AACX,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAqBA,iBAAiB,MAAA,EAAsB;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAEd,IAAA,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,IAAA,CAAK,eAAe,IAAA,CAAK,MAAA,EAAQ,KAAK,SAAS,CAAA;AAAA,EACzF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAY,MAAA,EAAyB;AACnC,IAAA,KAAA,CAAM,EAAE,SAAA,EAAW,gBAAA,CAAiB,YAAY,IAAA,EAAM,MAAA,CAAO,MAAM,CAAA;AACnE,IAAA,IAAA,CAAK,OAAO,MAAA,CAAO,IAAA;AACnB,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,OAAA;AAItB,IAAA,IAAI,OAAO,EAAA,EAAI;AACb,MAAA,IAAA,CAAK,GAAA,GAAM,OAAA,CAAQ,MAAA,CAAO,EAAE,CAAA;AAC5B,MAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAAA,IAClB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,GAAA,GAAM,IAAA,CAAK,MAAA,EAAQ,UAAA,MAAgB,UAAA,EAAW;AAAA,IACrD;AAEA,IAAA,IAAA,CAAK,cAAc,MAAA,CAAO,WAAA;AAC1B,IAAA,IAAA,CAAK,aAAa,MAAA,CAAO,UAAA;AACzB,IAAA,IAAA,CAAK,cAAc,MAAA,CAAO,WAAA,IAAA,iBAAe,IAAI,IAAA,IAAO,WAAA,EAAY;AAChE,IAAA,IAAA,CAAK,QAAA,GAAW,MAAA,CAAO,QAAA,KAAa,MAAA,GAAY,OAAO,MAAA,CAAO,QAAA;AAC9D,IAAA,IAAA,CAAK,mBAAmB,MAAA,CAAO,gBAAA;AAC/B,IAAA,IAAA,CAAK,WAAW,MAAA,CAAO,QAAA;AACvB,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,OAAA;AACtB,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA;AACrB,IAAA,IAAA,CAAK,YAAY,MAAA,CAAO,SAAA;AACxB,IAAA,IAAA,CAAK,gBAAgB,MAAA,CAAO,KAAA;AAC5B,IAAA,IAAA,CAAK,cAAA,GAAiB,KAAK,YAAA,CAAa,MAAA,CAAO,OAAO,MAAA,CAAO,MAAA,EAAQ,OAAO,SAAS,CAAA;AAAA,EACvF;AA6EF","file":"index.js","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport slugify from '@sindresorhus/slugify';\nimport type { ToolsInput } from '../agent';\nimport { MastraBase } from '../base';\nimport { RegisteredLogger } from '../logger';\nimport type { Mastra } from '../mastra';\nimport type {\n  ConvertedTool,\n  MCPServerConfig,\n  MCPServerHonoSSEOptions,\n  MCPServerHTTPOptions,\n  MCPServerSSEOptions,\n  MCPToolType,\n  PackageInfo,\n  RemoteInfo,\n  Repository,\n  ServerDetailInfo,\n  ServerInfo,\n} from './types';\nexport * from './types';\n\n/**\n * Abstract base class for MCP server implementations.\n * This provides a common interface and shared functionality for all MCP servers\n * that can be registered with Mastra, including handling of server metadata.\n */\nexport abstract class MCPServerBase extends MastraBase {\n  /** Tracks if the server ID has been definitively set. */\n  private idWasSet = false;\n  /** The display name of the MCP server. */\n  public readonly name: string;\n  /** The semantic version of the MCP server. */\n  public readonly version: string;\n  /** Internal storage for the server's unique ID. */\n  private _id: string;\n  /** A description of what the MCP server does. */\n  public readonly description?: string;\n  /** Repository information for the server's source code. */\n  public readonly repository?: Repository;\n  /** The release date of this server version (ISO 8601 string). */\n  public readonly releaseDate: string;\n  /** Indicates if this version is the latest available. */\n  public readonly isLatest: boolean;\n  /** The canonical packaging format (e.g., \"npm\", \"docker\"), if applicable. */\n  public readonly packageCanonical?: MCPServerConfig['packageCanonical'];\n  /** Information about installable packages for this server. */\n  public readonly packages?: PackageInfo[];\n  /** Information about remote access points for this server. */\n  public readonly remotes?: RemoteInfo[];\n  /** The tools registered with and converted by this MCP server. */\n  public convertedTools: Record<string, ConvertedTool>;\n  /** Reference to the Mastra instance if this server is registered with one. */\n  public mastra: Mastra | undefined;\n  /** Agents to be exposed as tools. */\n  protected readonly agents?: MCPServerConfig['agents'];\n  /** Workflows to be exposed as tools. */\n  protected readonly workflows?: MCPServerConfig['workflows'];\n  /** Original tools configuration for re-conversion when Mastra instance is registered. */\n  protected readonly originalTools: ToolsInput;\n\n  /**\n   * Public getter for the server's unique ID.\n   * The ID is set at construction or by Mastra and is read-only afterwards.\n   */\n  public get id(): string {\n    return this._id;\n  }\n\n  /**\n   * Gets a read-only view of the registered tools.\n   * @returns A readonly record of converted tools.\n   */\n  tools(): Readonly<Record<string, ConvertedTool>> {\n    return this.convertedTools;\n  }\n\n  /**\n   * Sets the server's unique ID. This method is typically called by Mastra when\n   * registering the server, using the key provided in the Mastra configuration.\n   * It ensures the ID is set only once.\n   * If an ID was already provided in the MCPServerConfig, this method will be a no-op.\n   * @param id The unique ID to assign to the server.\n   */\n  setId(id: string) {\n    if (this.idWasSet) {\n      return;\n    }\n    this._id = id;\n    this.idWasSet = true;\n  }\n\n  /**\n   * Abstract method to convert and validate tool definitions provided to the server.\n   * This method will also handle agents passed in the config.\n   * @param tools Tool definitions to convert.\n   * @param agents Agent definitions to convert to tools.\n   * @param workflows Workflow definitions to convert to tools.\n   * @returns A record of converted and validated tools.\n   */\n  public abstract convertTools(\n    tools: ToolsInput,\n    agents?: MCPServerConfig['agents'],\n    workflows?: MCPServerConfig['workflows'],\n  ): Record<string, ConvertedTool>;\n\n  /**\n   * Internal method used by Mastra to register itself with the server.\n   * @param mastra The Mastra instance.\n   * @internal\n   */\n  __registerMastra(mastra: Mastra): void {\n    this.mastra = mastra;\n    // Re-convert tools now that we have the Mastra instance to populate MCP tools execute with mastra instance\n    this.convertedTools = this.convertTools(this.originalTools, this.agents, this.workflows);\n  }\n\n  /**\n   * Constructor for the MCPServerBase.\n   * @param config Configuration options for the MCP server, including metadata.\n   */\n  constructor(config: MCPServerConfig) {\n    super({ component: RegisteredLogger.MCP_SERVER, name: config.name });\n    this.name = config.name;\n    this.version = config.version;\n\n    // If user does not provide an ID, we will use the key from the Mastra config, but if user does not pass MCPServer\n    // to Mastra, we will generate a random UUID as a backup.\n    if (config.id) {\n      this._id = slugify(config.id);\n      this.idWasSet = true;\n    } else {\n      this._id = this.mastra?.generateId() || randomUUID();\n    }\n\n    this.description = config.description;\n    this.repository = config.repository;\n    this.releaseDate = config.releaseDate || new Date().toISOString();\n    this.isLatest = config.isLatest === undefined ? true : config.isLatest;\n    this.packageCanonical = config.packageCanonical;\n    this.packages = config.packages;\n    this.remotes = config.remotes;\n    this.agents = config.agents;\n    this.workflows = config.workflows;\n    this.originalTools = config.tools;\n    this.convertedTools = this.convertTools(config.tools, config.agents, config.workflows);\n  }\n\n  /**\n   * Start the MCP server using stdio transport\n   * This is typically used for Windsurf integration\n   */\n  public abstract startStdio(): Promise<void>;\n\n  /**\n   * Start the MCP server using SSE transport\n   * This is typically used for web integration\n   * @param options Options for the SSE transport\n   */\n  public abstract startSSE(options: MCPServerSSEOptions): Promise<void>;\n\n  /**\n   * Start the MCP server using Hono SSE transport\n   * Used for Hono servers\n   * @param options Options for the SSE transport\n   */\n  public abstract startHonoSSE(options: MCPServerHonoSSEOptions): Promise<Response | undefined>;\n\n  /**\n   * Start the MCP server using HTTP transport\n   * @param options Options for the HTTP transport\n   */\n  public abstract startHTTP(options: MCPServerHTTPOptions): Promise<void>;\n\n  /**\n   * Close the MCP server and all its connections\n   */\n  public abstract close(): Promise<void>;\n\n  /**\n   * Gets the basic information about the server, conforming to the MCP Registry 'Server' schema.\n   * This information is suitable for listing multiple servers.\n   * @returns ServerInfo object containing basic server metadata.\n   */\n  public abstract getServerInfo(): ServerInfo;\n\n  /**\n   * Gets detailed information about the server, conforming to the MCP Registry 'ServerDetail' schema.\n   * This includes all information from `getServerInfo` plus package and remote details.\n   * @returns ServerDetailInfo object containing comprehensive server metadata.\n   */\n  public abstract getServerDetail(): ServerDetailInfo;\n\n  /**\n   * Gets a list of tools provided by this MCP server, including their schemas.\n   * @returns An object containing an array of tool information.\n   */\n  public abstract getToolListInfo(): {\n    tools: Array<{ name: string; description?: string; inputSchema: any; outputSchema?: any; toolType?: MCPToolType }>;\n  };\n\n  /**\n   * Gets information for a specific tool provided by this MCP server.\n   * @param toolId The ID/name of the tool to retrieve.\n   * @returns Tool information (name, description, inputSchema) or undefined if not found.\n   */\n  public abstract getToolInfo(\n    toolId: string,\n  ): { name: string; description?: string; inputSchema: any; outputSchema?: any; toolType?: MCPToolType } | undefined;\n\n  /**\n   * Executes a specific tool provided by this MCP server.\n   * @param toolId The ID/name of the tool to execute.\n   * @param args The arguments to pass to the tool's execute function.\n   * @param executionContext Optional context for the tool execution (e.g., messages, toolCallId).\n   * @returns A promise that resolves to the result of the tool execution.\n   * @throws Error if the tool is not found, or if execution fails.\n   */\n  public abstract executeTool(\n    toolId: string,\n    args: any,\n    executionContext?: { messages?: any[]; toolCallId?: string },\n  ): Promise<any>;\n}\n"]}