@mastra/server 1.0.4-alpha.1 → 1.0.4

package/dist/server/server-adapter/index.d.ts

@@ -0,0 +1,109 @@
+import type { ToolsInput } from '@mastra/core/agent';
+import type { Mastra } from '@mastra/core/mastra';
+import { RequestContext } from '@mastra/core/request-context';
+import { MastraServerBase } from '@mastra/core/server';
+import type { InMemoryTaskStore } from '../a2a/store.js';
+import type { ServerRoute } from './routes/index.js';
+export * from './routes/index.js';
+export { redactStreamChunk } from './redact.js';
+export { WorkflowRegistry } from '../utils.js';
+export interface OpenAPIConfig {
+    title?: string;
+    version?: string;
+    description?: string;
+    path?: string;
+}
+export interface BodyLimitOptions {
+    maxSize: number;
+    onError: (error: unknown) => unknown;
+}
+export interface StreamOptions {
+    /**
+     * When true (default), redacts sensitive data from stream chunks
+     * (system prompts, tool definitions, API keys) before sending to clients.
+     *
+     * Set to false to include full request data in stream chunks (useful for
+     * debugging or internal services that need access to this data).
+     *
+     * @default true
+     */
+    redact?: boolean;
+}
+/**
+ * Query parameter values parsed from HTTP requests.
+ * Supports both single values and arrays (for repeated query params like ?tag=a&tag=b).
+ */
+export type QueryParamValue = string | string[];
+/**
+ * Parsed request parameters returned by getParams().
+ */
+export interface ParsedRequestParams {
+    urlParams: Record<string, string>;
+    queryParams: Record<string, QueryParamValue>;
+    body: unknown;
+}
+/**
+ * Normalizes query parameters from various HTTP framework formats to a consistent structure.
+ * Handles both single string values and arrays (for repeated query params like ?tag=a&tag=b).
+ * Filters out non-string values that some frameworks may include.
+ *
+ * @param rawQuery - Raw query parameters from the HTTP framework (may contain strings, arrays, or nested objects)
+ * @returns Normalized query parameters as Record<string, string | string[]>
+ */
+export declare function normalizeQueryParams(rawQuery: Record<string, unknown>): Record<string, QueryParamValue>;
+/**
+ * Abstract base class for server adapters that handle HTTP requests.
+ *
+ * This class extends `MastraServerBase` to inherit app storage functionality
+ * and provides the framework for registering routes, middleware, and handling requests.
+ *
+ * Framework-specific adapters in @mastra/hono and @mastra/express extend this class
+ * (both named `MastraServer` in their respective packages) and implement the abstract
+ * methods for their specific framework.
+ *
+ * @template TApp - The type of the server app (e.g., Hono, Express Application)
+ * @template TRequest - The type of the request object
+ * @template TResponse - The type of the response object
+ */
+export declare abstract class MastraServer<TApp, TRequest, TResponse> extends MastraServerBase<TApp> {
+    protected mastra: Mastra;
+    protected bodyLimitOptions?: BodyLimitOptions;
+    protected tools?: ToolsInput;
+    protected prefix?: string;
+    protected openapiPath?: string;
+    protected taskStore?: InMemoryTaskStore;
+    protected customRouteAuthConfig?: Map<string, boolean>;
+    protected streamOptions: StreamOptions;
+    constructor({ app, mastra, bodyLimitOptions, tools, prefix, openapiPath, taskStore, customRouteAuthConfig, streamOptions, }: {
+        app: TApp;
+        mastra: Mastra;
+        bodyLimitOptions?: BodyLimitOptions;
+        tools?: ToolsInput;
+        prefix?: string;
+        openapiPath?: string;
+        taskStore?: InMemoryTaskStore;
+        customRouteAuthConfig?: Map<string, boolean>;
+        streamOptions?: StreamOptions;
+    });
+    protected mergeRequestContext({ paramsRequestContext, bodyRequestContext, }: {
+        paramsRequestContext?: Record<string, any>;
+        bodyRequestContext?: Record<string, any>;
+    }): RequestContext;
+    abstract stream(route: ServerRoute, response: TResponse, result: unknown): Promise<unknown>;
+    abstract getParams(route: ServerRoute, request: TRequest): Promise<ParsedRequestParams>;
+    abstract sendResponse(route: ServerRoute, response: TResponse, result: unknown): Promise<unknown>;
+    abstract registerRoute(app: TApp, route: ServerRoute, { prefix }: {
+        prefix?: string;
+    }): Promise<void>;
+    abstract registerContextMiddleware(): void;
+    abstract registerAuthMiddleware(): void;
+    init(): Promise<void>;
+    registerOpenAPIRoute(app: TApp, config: OpenAPIConfig | undefined, { prefix }: {
+        prefix?: string;
+    }): Promise<void>;
+    registerRoutes(): Promise<void>;
+    parsePathParams(route: ServerRoute, params: Record<string, string>): Promise<Record<string, any>>;
+    parseQueryParams(route: ServerRoute, params: Record<string, QueryParamValue>): Promise<Record<string, any>>;
+    parseBody(route: ServerRoute, body: unknown): Promise<unknown>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/server/server-adapter/index.d.ts.map

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

package/dist/server/server-adapter/index.js

@@ -0,0 +1,495 @@
+import { LIST_PROCESSORS_ROUTE, GET_PROCESSOR_BY_ID_ROUTE, EXECUTE_PROCESSOR_ROUTE } from '../../chunk-I27H7BEB.js';
+import { LIST_STORED_AGENTS_ROUTE, GET_STORED_AGENT_ROUTE, CREATE_STORED_AGENT_ROUTE, UPDATE_STORED_AGENT_ROUTE, DELETE_STORED_AGENT_ROUTE } from '../../chunk-CGIGPJRU.js';
+import { GET_SYSTEM_PACKAGES_ROUTE } from '../../chunk-5VDI75UV.js';
+import { EXECUTE_AGENT_TOOL_ROUTE, GET_AGENT_TOOL_ROUTE, LIST_TOOLS_ROUTE, GET_TOOL_BY_ID_ROUTE, EXECUTE_TOOL_ROUTE } from '../../chunk-IVGQTL3T.js';
+import { UPSERT_VECTORS_ROUTE, CREATE_INDEX_ROUTE, QUERY_VECTORS_ROUTE, LIST_INDEXES_ROUTE, DESCRIBE_INDEX_ROUTE, DELETE_INDEX_ROUTE } from '../../chunk-XB27LCKO.js';
+import { GET_SPEAKERS_ROUTE, GET_SPEAKERS_DEPRECATED_ROUTE, GENERATE_SPEECH_ROUTE, GENERATE_SPEECH_DEPRECATED_ROUTE, TRANSCRIBE_SPEECH_ROUTE, TRANSCRIBE_SPEECH_DEPRECATED_ROUTE, GET_LISTENER_ROUTE } from '../../chunk-H34VRYSF.js';
+import { LIST_LOG_TRANSPORTS_ROUTE, LIST_LOGS_ROUTE, LIST_LOGS_BY_RUN_ID_ROUTE } from '../../chunk-3FEYUHHJ.js';
+import { LIST_MCP_SERVERS_ROUTE, GET_MCP_SERVER_DETAIL_ROUTE, LIST_MCP_SERVER_TOOLS_ROUTE, GET_MCP_SERVER_TOOL_DETAIL_ROUTE, EXECUTE_MCP_SERVER_TOOL_ROUTE, MCP_HTTP_TRANSPORT_ROUTE, MCP_SSE_TRANSPORT_ROUTE, MCP_SSE_MESSAGES_ROUTE } from '../../chunk-TMS4LS2J.js';
+import { GET_MEMORY_STATUS_ROUTE, GET_MEMORY_CONFIG_ROUTE, LIST_THREADS_ROUTE, GET_THREAD_BY_ID_ROUTE, LIST_MESSAGES_ROUTE, GET_WORKING_MEMORY_ROUTE, SAVE_MESSAGES_ROUTE, CREATE_THREAD_ROUTE, UPDATE_THREAD_ROUTE, DELETE_THREAD_ROUTE, CLONE_THREAD_ROUTE, UPDATE_WORKING_MEMORY_ROUTE, DELETE_MESSAGES_ROUTE, SEARCH_MEMORY_ROUTE, GET_MEMORY_STATUS_NETWORK_ROUTE, LIST_THREADS_NETWORK_ROUTE, GET_THREAD_BY_ID_NETWORK_ROUTE, LIST_MESSAGES_NETWORK_ROUTE, SAVE_MESSAGES_NETWORK_ROUTE, CREATE_THREAD_NETWORK_ROUTE, UPDATE_THREAD_NETWORK_ROUTE, DELETE_THREAD_NETWORK_ROUTE, DELETE_MESSAGES_NETWORK_ROUTE } from '../../chunk-2CYGIE3E.js';
+import { LIST_TRACES_ROUTE, GET_TRACE_ROUTE, SCORE_TRACES_ROUTE, LIST_SCORES_BY_SPAN_ROUTE } from '../../chunk-N4EIZSG2.js';
+import { LIST_SCORERS_ROUTE, GET_SCORER_ROUTE, LIST_SCORES_BY_RUN_ID_ROUTE, LIST_SCORES_BY_SCORER_ID_ROUTE, LIST_SCORES_BY_ENTITY_ID_ROUTE, SAVE_SCORE_ROUTE } from '../../chunk-KKY4MSZO.js';
+import { GET_AGENT_CARD_ROUTE, AGENT_EXECUTION_ROUTE } from '../../chunk-YN3FWKVQ.js';
+import { LIST_AGENT_BUILDER_ACTIONS_ROUTE, GET_AGENT_BUILDER_ACTION_BY_ID_ROUTE, LIST_AGENT_BUILDER_ACTION_RUNS_ROUTE, GET_AGENT_BUILDER_ACTION_RUN_BY_ID_ROUTE, CREATE_AGENT_BUILDER_ACTION_RUN_ROUTE, STREAM_AGENT_BUILDER_ACTION_ROUTE, START_ASYNC_AGENT_BUILDER_ACTION_ROUTE, START_AGENT_BUILDER_ACTION_RUN_ROUTE, OBSERVE_STREAM_AGENT_BUILDER_ACTION_ROUTE, RESUME_ASYNC_AGENT_BUILDER_ACTION_ROUTE, RESUME_AGENT_BUILDER_ACTION_ROUTE, RESUME_STREAM_AGENT_BUILDER_ACTION_ROUTE, CANCEL_AGENT_BUILDER_ACTION_RUN_ROUTE, STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE, OBSERVE_STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE } from '../../chunk-GHQZIEPS.js';
+import { LIST_WORKFLOWS_ROUTE, GET_WORKFLOW_BY_ID_ROUTE, LIST_WORKFLOW_RUNS_ROUTE, GET_WORKFLOW_RUN_BY_ID_ROUTE, DELETE_WORKFLOW_RUN_BY_ID_ROUTE, CREATE_WORKFLOW_RUN_ROUTE, STREAM_WORKFLOW_ROUTE, RESUME_STREAM_WORKFLOW_ROUTE, START_ASYNC_WORKFLOW_ROUTE, START_WORKFLOW_RUN_ROUTE, OBSERVE_STREAM_WORKFLOW_ROUTE, RESUME_ASYNC_WORKFLOW_ROUTE, RESUME_WORKFLOW_ROUTE, CANCEL_WORKFLOW_RUN_ROUTE, TIME_TRAVEL_WORKFLOW_ROUTE, TIME_TRAVEL_ASYNC_WORKFLOW_ROUTE, TIME_TRAVEL_STREAM_WORKFLOW_ROUTE, RESTART_WORKFLOW_ROUTE, RESTART_ASYNC_WORKFLOW_ROUTE, RESTART_ALL_ACTIVE_WORKFLOW_RUNS_ROUTE, RESTART_ALL_ACTIVE_WORKFLOW_RUNS_ASYNC_ROUTE, STREAM_LEGACY_WORKFLOW_ROUTE, OBSERVE_STREAM_LEGACY_WORKFLOW_ROUTE } from '../../chunk-4R2Z655M.js';
+export { WorkflowRegistry } from '../../chunk-GNCALVLC.js';
+import { LIST_AGENTS_ROUTE, GET_PROVIDERS_ROUTE, GET_AGENT_BY_ID_ROUTE, GENERATE_AGENT_ROUTE, GENERATE_AGENT_VNEXT_ROUTE, STREAM_GENERATE_ROUTE, STREAM_GENERATE_VNEXT_DEPRECATED_ROUTE, APPROVE_TOOL_CALL_ROUTE, DECLINE_TOOL_CALL_ROUTE, APPROVE_TOOL_CALL_GENERATE_ROUTE, DECLINE_TOOL_CALL_GENERATE_ROUTE, APPROVE_NETWORK_TOOL_CALL_ROUTE, DECLINE_NETWORK_TOOL_CALL_ROUTE, STREAM_NETWORK_ROUTE, UPDATE_AGENT_MODEL_ROUTE, RESET_AGENT_MODEL_ROUTE, REORDER_AGENT_MODEL_LIST_ROUTE, UPDATE_AGENT_MODEL_IN_MODEL_LIST_ROUTE, ENHANCE_INSTRUCTIONS_ROUTE, STREAM_VNEXT_DEPRECATED_ROUTE, STREAM_UI_MESSAGE_VNEXT_DEPRECATED_ROUTE, STREAM_UI_MESSAGE_DEPRECATED_ROUTE, GENERATE_LEGACY_ROUTE, STREAM_GENERATE_LEGACY_ROUTE } from '../../chunk-2CLS2PYJ.js';
+import { generateOpenAPIDocument } from '../../chunk-7S7ALPCY.js';
+export { createRoute, generateOpenAPIDocument, jsonQueryParam, pickParams, wrapSchemaForQueryParams } from '../../chunk-7S7ALPCY.js';
+import { RequestContext } from '@mastra/core/request-context';
+import { MastraServerBase } from '@mastra/core/server';
+
+// src/server/server-adapter/routes/a2a.ts
+var A2A_ROUTES = [GET_AGENT_CARD_ROUTE, AGENT_EXECUTION_ROUTE];
+
+// src/server/server-adapter/routes/agent-builder.ts
+var AGENT_BUILDER_ROUTES = [
+  LIST_AGENT_BUILDER_ACTIONS_ROUTE,
+  GET_AGENT_BUILDER_ACTION_BY_ID_ROUTE,
+  LIST_AGENT_BUILDER_ACTION_RUNS_ROUTE,
+  GET_AGENT_BUILDER_ACTION_RUN_BY_ID_ROUTE,
+  CREATE_AGENT_BUILDER_ACTION_RUN_ROUTE,
+  STREAM_AGENT_BUILDER_ACTION_ROUTE,
+  START_ASYNC_AGENT_BUILDER_ACTION_ROUTE,
+  START_AGENT_BUILDER_ACTION_RUN_ROUTE,
+  OBSERVE_STREAM_AGENT_BUILDER_ACTION_ROUTE,
+  RESUME_ASYNC_AGENT_BUILDER_ACTION_ROUTE,
+  RESUME_AGENT_BUILDER_ACTION_ROUTE,
+  RESUME_STREAM_AGENT_BUILDER_ACTION_ROUTE,
+  CANCEL_AGENT_BUILDER_ACTION_RUN_ROUTE
+];
+
+// src/server/server-adapter/routes/agents.ts
+var AGENTS_ROUTES = [
+  // ============================================================================
+  // Agent Core Routes
+  // ============================================================================
+  LIST_AGENTS_ROUTE,
+  GET_PROVIDERS_ROUTE,
+  GET_AGENT_BY_ID_ROUTE,
+  // ============================================================================
+  // Voice Routes
+  // ============================================================================
+  GET_SPEAKERS_ROUTE,
+  GET_SPEAKERS_DEPRECATED_ROUTE,
+  // ============================================================================
+  // Agent Execution Routes
+  // ============================================================================
+  GENERATE_AGENT_ROUTE,
+  GENERATE_AGENT_VNEXT_ROUTE,
+  STREAM_GENERATE_ROUTE,
+  STREAM_GENERATE_VNEXT_DEPRECATED_ROUTE,
+  // ============================================================================
+  // Tool Routes
+  // ============================================================================
+  EXECUTE_AGENT_TOOL_ROUTE,
+  APPROVE_TOOL_CALL_ROUTE,
+  DECLINE_TOOL_CALL_ROUTE,
+  APPROVE_TOOL_CALL_GENERATE_ROUTE,
+  DECLINE_TOOL_CALL_GENERATE_ROUTE,
+  APPROVE_NETWORK_TOOL_CALL_ROUTE,
+  DECLINE_NETWORK_TOOL_CALL_ROUTE,
+  // ============================================================================
+  // Network Routes
+  // ============================================================================
+  STREAM_NETWORK_ROUTE,
+  // ============================================================================
+  // Model Management Routes
+  // ============================================================================
+  UPDATE_AGENT_MODEL_ROUTE,
+  RESET_AGENT_MODEL_ROUTE,
+  REORDER_AGENT_MODEL_LIST_ROUTE,
+  UPDATE_AGENT_MODEL_IN_MODEL_LIST_ROUTE,
+  // ============================================================================
+  // Instruction Enhancement Routes
+  // ============================================================================
+  ENHANCE_INSTRUCTIONS_ROUTE,
+  // ============================================================================
+  // Agent Tool Routes
+  // ============================================================================
+  GET_AGENT_TOOL_ROUTE,
+  // ============================================================================
+  // Voice/Speech Routes
+  // ============================================================================
+  GENERATE_SPEECH_ROUTE,
+  GENERATE_SPEECH_DEPRECATED_ROUTE,
+  TRANSCRIBE_SPEECH_ROUTE,
+  TRANSCRIBE_SPEECH_DEPRECATED_ROUTE,
+  GET_LISTENER_ROUTE,
+  // ============================================================================
+  // Deprecated Routes
+  // ============================================================================
+  STREAM_VNEXT_DEPRECATED_ROUTE,
+  STREAM_UI_MESSAGE_VNEXT_DEPRECATED_ROUTE,
+  STREAM_UI_MESSAGE_DEPRECATED_ROUTE
+];
+
+// src/server/server-adapter/routes/legacy.ts
+var LEGACY_ROUTES = [
+  // ============================================================================
+  // Legacy Agent Routes
+  // ============================================================================
+  GENERATE_LEGACY_ROUTE,
+  STREAM_GENERATE_LEGACY_ROUTE,
+  // ============================================================================
+  // Legacy Workflow Routes
+  // ============================================================================
+  STREAM_LEGACY_WORKFLOW_ROUTE,
+  OBSERVE_STREAM_LEGACY_WORKFLOW_ROUTE,
+  // ============================================================================
+  // Legacy Agent Builder Routes
+  // ============================================================================
+  STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE,
+  OBSERVE_STREAM_LEGACY_AGENT_BUILDER_ACTION_ROUTE
+];
+
+// src/server/server-adapter/routes/logs.ts
+var LOGS_ROUTES = [
+  LIST_LOG_TRANSPORTS_ROUTE,
+  LIST_LOGS_ROUTE,
+  LIST_LOGS_BY_RUN_ID_ROUTE
+];
+
+// src/server/server-adapter/routes/mcp.ts
+var MCP_ROUTES = [
+  // ============================================================================
+  // MCP Server Registry Routes
+  // ============================================================================
+  LIST_MCP_SERVERS_ROUTE,
+  GET_MCP_SERVER_DETAIL_ROUTE,
+  // ============================================================================
+  // MCP Server Tool Routes
+  // ============================================================================
+  LIST_MCP_SERVER_TOOLS_ROUTE,
+  GET_MCP_SERVER_TOOL_DETAIL_ROUTE,
+  EXECUTE_MCP_SERVER_TOOL_ROUTE,
+  // ============================================================================
+  // MCP Transport Routes (handled by adapters)
+  // ============================================================================
+  MCP_HTTP_TRANSPORT_ROUTE,
+  MCP_SSE_TRANSPORT_ROUTE,
+  MCP_SSE_MESSAGES_ROUTE
+];
+
+// src/server/server-adapter/routes/memory.ts
+var MEMORY_ROUTES = [
+  GET_MEMORY_STATUS_ROUTE,
+  GET_MEMORY_CONFIG_ROUTE,
+  LIST_THREADS_ROUTE,
+  GET_THREAD_BY_ID_ROUTE,
+  LIST_MESSAGES_ROUTE,
+  GET_WORKING_MEMORY_ROUTE,
+  SAVE_MESSAGES_ROUTE,
+  CREATE_THREAD_ROUTE,
+  UPDATE_THREAD_ROUTE,
+  DELETE_THREAD_ROUTE,
+  CLONE_THREAD_ROUTE,
+  UPDATE_WORKING_MEMORY_ROUTE,
+  DELETE_MESSAGES_ROUTE,
+  SEARCH_MEMORY_ROUTE,
+  GET_MEMORY_STATUS_NETWORK_ROUTE,
+  LIST_THREADS_NETWORK_ROUTE,
+  GET_THREAD_BY_ID_NETWORK_ROUTE,
+  LIST_MESSAGES_NETWORK_ROUTE,
+  SAVE_MESSAGES_NETWORK_ROUTE,
+  CREATE_THREAD_NETWORK_ROUTE,
+  UPDATE_THREAD_NETWORK_ROUTE,
+  DELETE_THREAD_NETWORK_ROUTE,
+  DELETE_MESSAGES_NETWORK_ROUTE
+];
+
+// src/server/server-adapter/routes/observability.ts
+var OBSERVABILITY_ROUTES = [
+  LIST_TRACES_ROUTE,
+  GET_TRACE_ROUTE,
+  SCORE_TRACES_ROUTE,
+  LIST_SCORES_BY_SPAN_ROUTE
+];
+
+// src/server/server-adapter/routes/processors.ts
+var PROCESSORS_ROUTES = [
+  LIST_PROCESSORS_ROUTE,
+  GET_PROCESSOR_BY_ID_ROUTE,
+  EXECUTE_PROCESSOR_ROUTE
+];
+
+// src/server/server-adapter/routes/scorers.ts
+var SCORES_ROUTES = [
+  LIST_SCORERS_ROUTE,
+  GET_SCORER_ROUTE,
+  LIST_SCORES_BY_RUN_ID_ROUTE,
+  LIST_SCORES_BY_SCORER_ID_ROUTE,
+  LIST_SCORES_BY_ENTITY_ID_ROUTE,
+  SAVE_SCORE_ROUTE
+];
+
+// src/server/server-adapter/routes/stored-agents.ts
+var STORED_AGENTS_ROUTES = [
+  // ============================================================================
+  // Stored Agents CRUD Routes
+  // ============================================================================
+  LIST_STORED_AGENTS_ROUTE,
+  GET_STORED_AGENT_ROUTE,
+  CREATE_STORED_AGENT_ROUTE,
+  UPDATE_STORED_AGENT_ROUTE,
+  DELETE_STORED_AGENT_ROUTE
+];
+
+// src/server/server-adapter/routes/system.ts
+var SYSTEM_ROUTES = [GET_SYSTEM_PACKAGES_ROUTE];
+
+// src/server/server-adapter/routes/tools.ts
+var TOOLS_ROUTES = [LIST_TOOLS_ROUTE, GET_TOOL_BY_ID_ROUTE, EXECUTE_TOOL_ROUTE];
+
+// src/server/server-adapter/routes/vectors.ts
+var VECTORS_ROUTES = [
+  UPSERT_VECTORS_ROUTE,
+  CREATE_INDEX_ROUTE,
+  QUERY_VECTORS_ROUTE,
+  LIST_INDEXES_ROUTE,
+  DESCRIBE_INDEX_ROUTE,
+  DELETE_INDEX_ROUTE
+];
+
+// src/server/server-adapter/routes/workflows.ts
+var WORKFLOWS_ROUTES = [
+  LIST_WORKFLOWS_ROUTE,
+  GET_WORKFLOW_BY_ID_ROUTE,
+  LIST_WORKFLOW_RUNS_ROUTE,
+  GET_WORKFLOW_RUN_BY_ID_ROUTE,
+  DELETE_WORKFLOW_RUN_BY_ID_ROUTE,
+  CREATE_WORKFLOW_RUN_ROUTE,
+  STREAM_WORKFLOW_ROUTE,
+  RESUME_STREAM_WORKFLOW_ROUTE,
+  START_ASYNC_WORKFLOW_ROUTE,
+  START_WORKFLOW_RUN_ROUTE,
+  OBSERVE_STREAM_WORKFLOW_ROUTE,
+  RESUME_ASYNC_WORKFLOW_ROUTE,
+  RESUME_WORKFLOW_ROUTE,
+  CANCEL_WORKFLOW_RUN_ROUTE,
+  TIME_TRAVEL_WORKFLOW_ROUTE,
+  TIME_TRAVEL_ASYNC_WORKFLOW_ROUTE,
+  TIME_TRAVEL_STREAM_WORKFLOW_ROUTE,
+  RESTART_WORKFLOW_ROUTE,
+  RESTART_ASYNC_WORKFLOW_ROUTE,
+  RESTART_ALL_ACTIVE_WORKFLOW_RUNS_ROUTE,
+  RESTART_ALL_ACTIVE_WORKFLOW_RUNS_ASYNC_ROUTE
+];
+
+// src/server/server-adapter/routes/index.ts
+var SERVER_ROUTES = [
+  ...AGENTS_ROUTES,
+  ...WORKFLOWS_ROUTES,
+  ...TOOLS_ROUTES,
+  ...PROCESSORS_ROUTES,
+  ...MEMORY_ROUTES,
+  ...SCORES_ROUTES,
+  ...OBSERVABILITY_ROUTES,
+  ...LOGS_ROUTES,
+  ...VECTORS_ROUTES,
+  ...A2A_ROUTES,
+  ...AGENT_BUILDER_ROUTES,
+  ...LEGACY_ROUTES,
+  ...MCP_ROUTES,
+  ...STORED_AGENTS_ROUTES,
+  ...SYSTEM_ROUTES
+];
+
+// src/server/server-adapter/redact.ts
+function redactV2Payload(payload) {
+  const redactedPayload = { ...payload };
+  if (redactedPayload.metadata && typeof redactedPayload.metadata === "object") {
+    const { request, ...metadataRest } = redactedPayload.metadata;
+    redactedPayload.metadata = metadataRest;
+  }
+  if (redactedPayload.output && typeof redactedPayload.output === "object") {
+    const output = { ...redactedPayload.output };
+    if (Array.isArray(output.steps)) {
+      output.steps = output.steps.map((step) => {
+        if (step && typeof step === "object") {
+          const { request, ...stepRest } = step;
+          return stepRest;
+        }
+        return step;
+      });
+    }
+    redactedPayload.output = output;
+  }
+  return redactedPayload;
+}
+function redactStreamChunk(chunk) {
+  if (!chunk || typeof chunk !== "object") {
+    return chunk;
+  }
+  const typedChunk = chunk;
+  switch (chunk.type) {
+    case "step-start": {
+      if ("payload" in typedChunk && typedChunk.payload && typeof typedChunk.payload === "object") {
+        const { payload, ...rest } = typedChunk;
+        const { request, ...payloadRest } = payload;
+        return {
+          ...rest,
+          type: "step-start",
+          payload: {
+            ...payloadRest,
+            // Keep an empty request object to maintain structure but remove body
+            request: {}
+          }
+        };
+      } else if ("request" in typedChunk) {
+        const { request, ...rest } = typedChunk;
+        return {
+          ...rest,
+          type: "step-start",
+          // Keep an empty request object to maintain structure
+          request: {}
+        };
+      }
+      return chunk;
+    }
+    case "step-finish": {
+      if ("payload" in typedChunk && typedChunk.payload && typeof typedChunk.payload === "object") {
+        const { payload, ...rest } = typedChunk;
+        return {
+          ...rest,
+          type: "step-finish",
+          payload: redactV2Payload(payload)
+        };
+      } else if ("request" in typedChunk) {
+        const { request, ...rest } = typedChunk;
+        return {
+          ...rest,
+          type: "step-finish"
+        };
+      }
+      return chunk;
+    }
+    case "finish": {
+      if ("payload" in typedChunk && typedChunk.payload && typeof typedChunk.payload === "object") {
+        const { payload, ...rest } = typedChunk;
+        return {
+          ...rest,
+          type: "finish",
+          payload: redactV2Payload(payload)
+        };
+      } else if ("request" in typedChunk) {
+        const { request, ...rest } = typedChunk;
+        return {
+          ...rest,
+          type: "finish"
+        };
+      }
+      return chunk;
+    }
+    default:
+      return chunk;
+  }
+}
+
+// src/server/server-adapter/index.ts
+function normalizeQueryParams(rawQuery) {
+  const queryParams = {};
+  for (const [key, value] of Object.entries(rawQuery)) {
+    if (typeof value === "string") {
+      queryParams[key] = value;
+    } else if (Array.isArray(value)) {
+      const stringValues = value.filter((v) => typeof v === "string");
+      queryParams[key] = stringValues.length === 1 ? stringValues[0] : stringValues;
+    }
+  }
+  return queryParams;
+}
+var MastraServer = class extends MastraServerBase {
+  mastra;
+  bodyLimitOptions;
+  tools;
+  prefix;
+  openapiPath;
+  taskStore;
+  customRouteAuthConfig;
+  streamOptions;
+  constructor({
+    app,
+    mastra,
+    bodyLimitOptions,
+    tools,
+    prefix = "",
+    openapiPath = "",
+    taskStore,
+    customRouteAuthConfig,
+    streamOptions
+  }) {
+    super({ app, name: "MastraServer" });
+    this.mastra = mastra;
+    this.bodyLimitOptions = bodyLimitOptions;
+    this.tools = tools;
+    this.prefix = prefix;
+    this.openapiPath = openapiPath;
+    this.taskStore = taskStore;
+    this.customRouteAuthConfig = customRouteAuthConfig;
+    this.streamOptions = { redact: true, ...streamOptions };
+    mastra.setMastraServer(this);
+  }
+  mergeRequestContext({
+    paramsRequestContext,
+    bodyRequestContext
+  }) {
+    const requestContext = new RequestContext();
+    if (bodyRequestContext) {
+      for (const [key, value] of Object.entries(bodyRequestContext)) {
+        requestContext.set(key, value);
+      }
+    }
+    if (paramsRequestContext) {
+      for (const [key, value] of Object.entries(paramsRequestContext)) {
+        requestContext.set(key, value);
+      }
+    }
+    return requestContext;
+  }
+  async init() {
+    this.registerContextMiddleware();
+    this.registerAuthMiddleware();
+    await this.registerRoutes();
+  }
+  async registerOpenAPIRoute(app, config = {}, { prefix }) {
+    const {
+      title = "Mastra API",
+      version = "1.0.0",
+      description = "Mastra Server API",
+      path = "/openapi.json"
+    } = config;
+    const openApiSpec = generateOpenAPIDocument(SERVER_ROUTES, {
+      title,
+      version,
+      description
+    });
+    const openApiRoute = {
+      method: "GET",
+      path,
+      responseType: "json",
+      handler: async () => openApiSpec
+    };
+    await this.registerRoute(app, openApiRoute, { prefix });
+  }
+  async registerRoutes() {
+    await Promise.all(SERVER_ROUTES.map((route) => this.registerRoute(this.app, route, { prefix: this.prefix })));
+    if (this.openapiPath) {
+      await this.registerOpenAPIRoute(
+        this.app,
+        {
+          title: "Mastra API",
+          version: "1.0.0",
+          description: "Mastra Server API",
+          path: this.openapiPath
+        },
+        { prefix: this.prefix }
+      );
+    }
+  }
+  async parsePathParams(route, params) {
+    const pathParamSchema = route.pathParamSchema;
+    if (!pathParamSchema) {
+      return params;
+    }
+    return pathParamSchema.parseAsync(params);
+  }
+  async parseQueryParams(route, params) {
+    const queryParamSchema = route.queryParamSchema;
+    if (!queryParamSchema) {
+      return params;
+    }
+    return queryParamSchema.parseAsync(params);
+  }
+  async parseBody(route, body) {
+    const bodySchema = route.bodySchema;
+    if (!bodySchema) {
+      return body;
+    }
+    return bodySchema.parseAsync(body);
+  }
+};
+
+export { MastraServer, SERVER_ROUTES, normalizeQueryParams, redactStreamChunk };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map