@mastra/server 1.0.4-alpha.2 → 1.1.0-alpha.0

package/dist/chunk-ED6NQBHF.js

@@ -0,0 +1,190 @@
+import { stringify } from './chunk-LFNP3ACE.js';
+import { zodToJsonSchema } from '@mastra/core/utils/zod-to-json';
+
+function normalizeRoutePath(path) {
+  let normalized = path.trim();
+  if (normalized.includes("..") || normalized.includes("?") || normalized.includes("#")) {
+    throw new Error(`Invalid route path: "${path}". Path cannot contain '..', '?', or '#'`);
+  }
+  normalized = normalized.replace(/\/+/g, "/");
+  if (normalized === "/" || normalized === "") {
+    return "";
+  }
+  if (normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  if (!normalized.startsWith("/")) {
+    normalized = `/${normalized}`;
+  }
+  return normalized;
+}
+function looksLikeProcessorStepSchema(schema) {
+  if (!schema) return false;
+  try {
+    const jsonSchema = zodToJsonSchema(schema);
+    const variants = jsonSchema.anyOf || jsonSchema.oneOf;
+    if (!variants || !Array.isArray(variants)) return false;
+    const processorPhases = /* @__PURE__ */ new Set(["input", "inputStep", "outputStream", "outputResult", "outputStep"]);
+    for (const variant of variants) {
+      const properties = variant.properties;
+      if (!properties?.phase) return false;
+      const phaseSchema = properties.phase;
+      const phaseConst = phaseSchema?.const;
+      const phaseEnum = Array.isArray(phaseSchema?.enum) ? phaseSchema.enum : [];
+      const phaseValues = phaseConst ? [phaseConst] : phaseEnum;
+      if (!phaseValues.length || phaseValues.some((phase) => !processorPhases.has(phase))) {
+        return false;
+      }
+    }
+    return variants.length > 0;
+  } catch {
+    return false;
+  }
+}
+function getSteps(steps, path) {
+  return Object.entries(steps).reduce((acc, [key, step]) => {
+    const fullKey = path ? `${path}.${key}` : key;
+    acc[fullKey] = {
+      id: step.id,
+      description: step.description,
+      inputSchema: step.inputSchema ? stringify(zodToJsonSchema(step.inputSchema)) : void 0,
+      outputSchema: step.outputSchema ? stringify(zodToJsonSchema(step.outputSchema)) : void 0,
+      resumeSchema: step.resumeSchema ? stringify(zodToJsonSchema(step.resumeSchema)) : void 0,
+      suspendSchema: step.suspendSchema ? stringify(zodToJsonSchema(step.suspendSchema)) : void 0,
+      stateSchema: step.stateSchema ? stringify(zodToJsonSchema(step.stateSchema)) : void 0,
+      isWorkflow: step.component === "WORKFLOW",
+      component: step.component
+    };
+    if (step.component === "WORKFLOW" && step.steps) {
+      const nestedSteps = getSteps(step.steps, fullKey) || {};
+      acc = { ...acc, ...nestedSteps };
+    }
+    return acc;
+  }, {});
+}
+function getWorkflowInfo(workflow, partial = false) {
+  if (partial) {
+    return {
+      name: workflow.name,
+      description: workflow.description,
+      stepCount: Object.keys(workflow.steps).length,
+      stepGraph: workflow.serializedStepGraph,
+      options: workflow.options,
+      steps: {},
+      allSteps: {},
+      inputSchema: void 0,
+      outputSchema: void 0,
+      stateSchema: void 0
+    };
+  }
+  return {
+    name: workflow.name,
+    description: workflow.description,
+    steps: Object.entries(workflow.steps).reduce((acc, [key, step]) => {
+      acc[key] = {
+        id: step.id,
+        description: step.description,
+        inputSchema: step.inputSchema ? stringify(zodToJsonSchema(step.inputSchema)) : void 0,
+        outputSchema: step.outputSchema ? stringify(zodToJsonSchema(step.outputSchema)) : void 0,
+        resumeSchema: step.resumeSchema ? stringify(zodToJsonSchema(step.resumeSchema)) : void 0,
+        suspendSchema: step.suspendSchema ? stringify(zodToJsonSchema(step.suspendSchema)) : void 0,
+        stateSchema: step.stateSchema ? stringify(zodToJsonSchema(step.stateSchema)) : void 0,
+        requestContextSchema: step.requestContextSchema ? stringify(zodToJsonSchema(step.requestContextSchema)) : void 0,
+        component: step.component
+      };
+      return acc;
+    }, {}),
+    allSteps: getSteps(workflow.steps) || {},
+    stepGraph: workflow.serializedStepGraph,
+    inputSchema: workflow.inputSchema ? stringify(zodToJsonSchema(workflow.inputSchema)) : void 0,
+    outputSchema: workflow.outputSchema ? stringify(zodToJsonSchema(workflow.outputSchema)) : void 0,
+    stateSchema: workflow.stateSchema ? stringify(zodToJsonSchema(workflow.stateSchema)) : void 0,
+    requestContextSchema: workflow.requestContextSchema ? stringify(zodToJsonSchema(workflow.requestContextSchema)) : void 0,
+    options: workflow.options,
+    isProcessorWorkflow: workflow.type === "processor" || looksLikeProcessorStepSchema(workflow.inputSchema)
+  };
+}
+var WorkflowRegistry = class {
+  static additionalWorkflows = {};
+  /**
+   * Register a workflow temporarily
+   */
+  static registerTemporaryWorkflow(id, workflow) {
+    this.additionalWorkflows[id] = workflow;
+  }
+  /**
+   * Register all workflows from map
+   */
+  static registerTemporaryWorkflows(workflows, mastra) {
+    for (const [id, workflow] of Object.entries(workflows)) {
+      if (mastra) {
+        workflow.__registerMastra(mastra);
+        workflow.__registerPrimitives({
+          logger: mastra.getLogger(),
+          storage: mastra.getStorage(),
+          agents: mastra.listAgents(),
+          tts: mastra.getTTS(),
+          vectors: mastra.listVectors()
+        });
+      }
+      this.additionalWorkflows[id] = workflow;
+    }
+  }
+  /**
+   * Get a workflow by ID from the registry (returns undefined if not found)
+   */
+  static getWorkflow(workflowId) {
+    return this.additionalWorkflows[workflowId];
+  }
+  /**
+   * Get all workflows from the registry
+   */
+  static getAllWorkflows() {
+    return { ...this.additionalWorkflows };
+  }
+  /**
+   * Clean up a temporary workflow
+   */
+  static cleanupTemporaryWorkflow(workflowId) {
+    delete this.additionalWorkflows[workflowId];
+  }
+  /**
+   * Clean up all registered workflows
+   */
+  static cleanup() {
+    this.additionalWorkflows = {};
+  }
+  /**
+   * Check if a workflow ID is a valid agent-builder workflow
+   */
+  static isAgentBuilderWorkflow(workflowId) {
+    return workflowId in this.additionalWorkflows;
+  }
+  /**
+   * Get all registered temporary workflow IDs (for debugging)
+   */
+  static getRegisteredWorkflowIds() {
+    return Object.keys(this.additionalWorkflows);
+  }
+};
+function convertInstructionsToString(message) {
+  if (!message) {
+    return "";
+  }
+  if (typeof message === "string") {
+    return message;
+  }
+  if (Array.isArray(message)) {
+    return message.map((m) => {
+      if (typeof m === "string") {
+        return m;
+      }
+      return typeof m.content === "string" ? m.content : "";
+    }).filter((content) => content).join("\n");
+  }
+  return typeof message.content === "string" ? message.content : "";
+}
+
+export { WorkflowRegistry, convertInstructionsToString, getWorkflowInfo, normalizeRoutePath };
+//# sourceMappingURL=chunk-ED6NQBHF.js.map
+//# sourceMappingURL=chunk-ED6NQBHF.js.map

package/dist/chunk-ED6NQBHF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/utils.ts"],"names":[],"mappings":"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","file":"chunk-ED6NQBHF.js","sourcesContent":["import type { Mastra } from '@mastra/core';\nimport type { SystemMessage } from '@mastra/core/llm';\nimport { zodToJsonSchema } from '@mastra/core/utils/zod-to-json';\nimport type { StepWithComponent, Workflow, WorkflowInfo } from '@mastra/core/workflows';\nimport { stringify } from 'superjson';\nimport type { ZodType } from 'zod';\nimport type { z as zv4 } from 'zod/v4';\n\n/**\n * Normalizes a route path to ensure consistent formatting.\n * - Removes leading/trailing whitespace\n * - Validates no path traversal (..), query strings (?), or fragments (#)\n * - Collapses multiple consecutive slashes\n * - Removes trailing slashes\n * - Ensures leading slash (unless empty)\n *\n * @param path - The route path to normalize\n * @returns The normalized path (empty string for root paths)\n * @throws Error if path contains invalid characters\n */\nexport function normalizeRoutePath(path: string): string {\n  let normalized = path.trim();\n  if (normalized.includes('..') || normalized.includes('?') || normalized.includes('#')) {\n    throw new Error(`Invalid route path: \"${path}\". Path cannot contain '..', '?', or '#'`);\n  }\n  normalized = normalized.replace(/\\/+/g, '/');\n  if (normalized === '/' || normalized === '') {\n    return '';\n  }\n  if (normalized.endsWith('/')) {\n    normalized = normalized.slice(0, -1);\n  }\n  if (!normalized.startsWith('/')) {\n    normalized = `/${normalized}`;\n  }\n  return normalized;\n}\n\n/**\n * Check if a schema looks like a processor step schema.\n * Processor step schemas are discriminated unions on 'phase' with specific values.\n */\nfunction looksLikeProcessorStepSchema(schema: ZodType | zv4.ZodType<any, any> | undefined): boolean {\n  if (!schema) return false;\n\n  try {\n    const jsonSchema = zodToJsonSchema(schema) as Record<string, unknown>;\n\n    // Check for discriminated union pattern: anyOf/oneOf with phase discriminator\n    const variants = (jsonSchema.anyOf || jsonSchema.oneOf) as Array<Record<string, unknown>> | undefined;\n    if (!variants || !Array.isArray(variants)) return false;\n\n    // Check if all variants have a 'phase' property with processor phase values\n    const processorPhases = new Set(['input', 'inputStep', 'outputStream', 'outputResult', 'outputStep']);\n\n    for (const variant of variants) {\n      const properties = variant.properties as Record<string, unknown> | undefined;\n      if (!properties?.phase) return false;\n\n      const phaseSchema = properties.phase as Record<string, unknown>;\n      const phaseConst = phaseSchema?.const as string | undefined;\n      const phaseEnum = Array.isArray(phaseSchema?.enum) ? (phaseSchema.enum as string[]) : [];\n      const phaseValues = phaseConst ? [phaseConst] : phaseEnum;\n\n      if (!phaseValues.length || phaseValues.some(phase => !processorPhases.has(phase))) {\n        return false;\n      }\n    }\n\n    return variants.length > 0;\n  } catch {\n    return false;\n  }\n}\n\nfunction getSteps(steps: Record<string, StepWithComponent>, path?: string) {\n  return Object.entries(steps).reduce<any>((acc, [key, step]) => {\n    const fullKey = path ? `${path}.${key}` : key;\n    acc[fullKey] = {\n      id: step.id,\n      description: step.description,\n      inputSchema: step.inputSchema ? stringify(zodToJsonSchema(step.inputSchema)) : undefined,\n      outputSchema: step.outputSchema ? stringify(zodToJsonSchema(step.outputSchema)) : undefined,\n      resumeSchema: step.resumeSchema ? stringify(zodToJsonSchema(step.resumeSchema)) : undefined,\n      suspendSchema: step.suspendSchema ? stringify(zodToJsonSchema(step.suspendSchema)) : undefined,\n      stateSchema: step.stateSchema ? stringify(zodToJsonSchema(step.stateSchema)) : undefined,\n      isWorkflow: step.component === 'WORKFLOW',\n      component: step.component,\n    };\n\n    if (step.component === 'WORKFLOW' && step.steps) {\n      const nestedSteps = getSteps(step.steps, fullKey) || {};\n      acc = { ...acc, ...nestedSteps };\n    }\n\n    return acc;\n  }, {});\n}\n\nexport function getWorkflowInfo(workflow: Workflow, partial: boolean = false): WorkflowInfo {\n  if (partial) {\n    // Return minimal info in partial mode\n    return {\n      name: workflow.name,\n      description: workflow.description,\n      stepCount: Object.keys(workflow.steps).length,\n      stepGraph: workflow.serializedStepGraph,\n      options: workflow.options,\n      steps: {},\n      allSteps: {},\n      inputSchema: undefined,\n      outputSchema: undefined,\n      stateSchema: undefined,\n    } as WorkflowInfo;\n  }\n\n  return {\n    name: workflow.name,\n    description: workflow.description,\n    steps: Object.entries(workflow.steps).reduce<any>((acc, [key, step]) => {\n      acc[key] = {\n        id: step.id,\n        description: step.description,\n        inputSchema: step.inputSchema ? stringify(zodToJsonSchema(step.inputSchema)) : undefined,\n        outputSchema: step.outputSchema ? stringify(zodToJsonSchema(step.outputSchema)) : undefined,\n        resumeSchema: step.resumeSchema ? stringify(zodToJsonSchema(step.resumeSchema)) : undefined,\n        suspendSchema: step.suspendSchema ? stringify(zodToJsonSchema(step.suspendSchema)) : undefined,\n        stateSchema: step.stateSchema ? stringify(zodToJsonSchema(step.stateSchema)) : undefined,\n        requestContextSchema: step.requestContextSchema\n          ? stringify(zodToJsonSchema(step.requestContextSchema))\n          : undefined,\n        component: step.component,\n      };\n      return acc;\n    }, {}),\n    allSteps: getSteps(workflow.steps) || {},\n    stepGraph: workflow.serializedStepGraph,\n    inputSchema: workflow.inputSchema ? stringify(zodToJsonSchema(workflow.inputSchema)) : undefined,\n    outputSchema: workflow.outputSchema ? stringify(zodToJsonSchema(workflow.outputSchema)) : undefined,\n    stateSchema: workflow.stateSchema ? stringify(zodToJsonSchema(workflow.stateSchema)) : undefined,\n    requestContextSchema: workflow.requestContextSchema\n      ? stringify(zodToJsonSchema(workflow.requestContextSchema))\n      : undefined,\n    options: workflow.options,\n    isProcessorWorkflow: workflow.type === 'processor' || looksLikeProcessorStepSchema(workflow.inputSchema),\n  };\n}\n\n/**\n * Workflow Registry for temporarily registering additional workflows\n * that are not part of the user's Mastra instance (e.g., internal template workflows)\n */\nexport class WorkflowRegistry {\n  private static additionalWorkflows: Record<string, Workflow> = {};\n\n  /**\n   * Register a workflow temporarily\n   */\n  static registerTemporaryWorkflow(id: string, workflow: Workflow): void {\n    this.additionalWorkflows[id] = workflow;\n  }\n\n  /**\n   * Register all workflows from map\n   */\n  static registerTemporaryWorkflows(\n    workflows: Record<string, Workflow>,\n    mastra?: Mastra<any, any, any, any, any, any, any, any, any>,\n  ): void {\n    for (const [id, workflow] of Object.entries(workflows)) {\n      // Register Mastra instance with the workflow if provided\n      if (mastra) {\n        workflow.__registerMastra(mastra);\n        workflow.__registerPrimitives({\n          logger: mastra.getLogger(),\n          storage: mastra.getStorage(),\n          agents: mastra.listAgents(),\n          tts: mastra.getTTS(),\n          vectors: mastra.listVectors(),\n        });\n      }\n      this.additionalWorkflows[id] = workflow;\n    }\n  }\n\n  /**\n   * Get a workflow by ID from the registry (returns undefined if not found)\n   */\n  static getWorkflow(workflowId: string): Workflow | undefined {\n    return this.additionalWorkflows[workflowId];\n  }\n\n  /**\n   * Get all workflows from the registry\n   */\n  static getAllWorkflows(): Record<string, Workflow> {\n    return { ...this.additionalWorkflows };\n  }\n\n  /**\n   * Clean up a temporary workflow\n   */\n  static cleanupTemporaryWorkflow(workflowId: string): void {\n    delete this.additionalWorkflows[workflowId];\n  }\n  /**\n   * Clean up all registered workflows\n   */\n  static cleanup(): void {\n    // Clear all workflows (since we register all agent-builder workflows each time)\n    this.additionalWorkflows = {};\n  }\n\n  /**\n   * Check if a workflow ID is a valid agent-builder workflow\n   */\n  static isAgentBuilderWorkflow(workflowId: string): boolean {\n    return workflowId in this.additionalWorkflows;\n  }\n\n  /**\n   * Get all registered temporary workflow IDs (for debugging)\n   */\n  static getRegisteredWorkflowIds(): string[] {\n    return Object.keys(this.additionalWorkflows);\n  }\n}\n\nexport function convertInstructionsToString(message: SystemMessage): string {\n  if (!message) {\n    return '';\n  }\n\n  if (typeof message === 'string') {\n    return message;\n  }\n\n  if (Array.isArray(message)) {\n    return message\n      .map(m => {\n        if (typeof m === 'string') {\n          return m;\n        }\n        // Safely extract content from message objects\n        return typeof m.content === 'string' ? m.content : '';\n      })\n      .filter(content => content) // Remove empty strings\n      .join('\\n');\n  }\n\n  // Handle single message object - safely extract content\n  return typeof message.content === 'string' ? message.content : '';\n}\n"]}