@mastra/deployer 0.18.1-alpha.0 → 0.19.0-alpha.1

package/dist/server/index.cjs

@@ -24,6 +24,7 @@ var a2a = require('@mastra/server/handlers/a2a');
 var streaming = require('hono/streaming');
 var bodyLimit = require('hono/body-limit');
 var agentBuilder = require('@mastra/server/handlers/agent-builder');
+var error = require('@mastra/core/error');
 var agents = require('@mastra/server/handlers/agents');
 var agent = require('@mastra/core/agent');
 var zod = require('zod');
@@ -318,12 +319,16 @@ async function readWithoutBlocking(readPromise) {
   return Promise.race([readPromise, Promise.resolve().then(() => Promise.resolve(void 0))]);
 }
 function writeFromReadableStreamDefaultReader(reader, writable, currentReadPromise) {
-  const handleError2 = () => {
+  const cancel = (error) => {
+    reader.cancel(error).catch(() => {
+    });
   };
-  writable.on("error", handleError2);
+  writable.on("close", cancel);
+  writable.on("error", cancel);
   (currentReadPromise ?? reader.read()).then(flow, handleStreamError);
   return reader.closed.finally(() => {
-    writable.off("error", handleError2);
+    writable.off("close", cancel);
+    writable.off("error", cancel);
   });
   function handleStreamError(error) {
     if (error) {
@@ -2382,6 +2387,17 @@ var vNextBodyOptions = {
     description: "Controls how tools are selected during generation"
   },
   format: { type: "string", enum: ["mastra", "aisdk"], description: "Response format" },
+  tracingOptions: {
+    type: "object",
+    description: "Tracing options for the agent execution",
+    properties: {
+      metadata: {
+        type: "object",
+        description: "Custom metadata to attach to the trace",
+        additionalProperties: true
+      }
+    }
+  },
   ...sharedBodyOptions
 };
 async function getAgentsHandler(c2) {
@@ -2566,6 +2582,27 @@ async function streamNetworkHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const body = await c2.req.json();
     const logger2 = mastra.getLogger();
+    const agent = mastra.getAgent(agentId);
+    if (!agent) {
+      throw new error.MastraError({
+        id: "AGENT_NOT_FOUND",
+        domain: error.ErrorDomain.AGENT,
+        category: error.ErrorCategory.USER,
+        text: "Agent not found"
+      });
+    }
+    const memory = await agent.getMemory({ runtimeContext });
+    if (!memory) {
+      throw new error.MastraError({
+        id: "AGENT_NETWORK_MEMORY_REQUIRED",
+        domain: error.ErrorDomain.AGENT_NETWORK,
+        category: error.ErrorCategory.USER,
+        text: "Memory is required for the agent network to function properly. Please configure memory for the agent.",
+        details: {
+          status: 400
+        }
+      });
+    }
     c2.header("Transfer-Encoding", "chunked");
     return streaming.stream(
       c2,
@@ -3104,7 +3141,18 @@ function agentsRouter(bodyLimitOptions) {
                   deprecated: true
                 },
                 runId: { type: "string" },
-                output: { type: "object" }
+                output: { type: "object" },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the agent execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
+                }
               },
               required: ["messages"]
             }
@@ -3155,7 +3203,18 @@ function agentsRouter(bodyLimitOptions) {
                   deprecated: true
                 },
                 runId: { type: "string" },
-                output: { type: "object" }
+                output: { type: "object" },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the agent execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
+                }
               },
               required: ["messages"]
             }
@@ -3309,7 +3368,18 @@ function agentsRouter(bodyLimitOptions) {
                   deprecated: true
                 },
                 runId: { type: "string" },
-                output: { type: "object" }
+                output: { type: "object" },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the agent execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
+                }
               },
               required: ["messages"]
             }
@@ -3360,7 +3430,18 @@ function agentsRouter(bodyLimitOptions) {
                   deprecated: true
                 },
                 runId: { type: "string" },
-                output: { type: "object" }
+                output: { type: "object" },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the agent execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
+                }
               },
               required: ["messages"]
             }
@@ -3426,6 +3507,17 @@ function agentsRouter(bodyLimitOptions) {
                     { type: "string", enum: ["auto", "none", "required"] },
                     { type: "object", properties: { type: { type: "string" }, toolName: { type: "string" } } }
                   ]
+                },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the agent execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
                 }
               },
               required: ["messages"]
@@ -8854,6 +8946,25 @@ async function processTraceScoringHandler(c2) {
     return handleError(error, "Error processing trace scoring");
   }
 }
+async function getScoresBySpan(c2) {
+  const mastra = c2.get("mastra");
+  const traceId = c2.req.param("traceId");
+  const spanId = c2.req.param("spanId");
+  const page = parseInt(c2.req.query("page") || "0");
+  const perPage = parseInt(c2.req.query("perPage") || "10");
+  const pagination = { page, perPage };
+  try {
+    const scores = await observability.getScoresBySpan({
+      mastra,
+      traceId,
+      spanId,
+      pagination
+    });
+    return c2.json(scores);
+  } catch (error) {
+    return handleError(error, "Error getting scores by span");
+  }
+}
 
 // src/server/handlers/routes/observability/router.ts
 function observabilityRouter() {
@@ -8946,6 +9057,49 @@ function observabilityRouter() {
     }),
     getAITraceHandler
   );
+  router.get(
+    "/traces/:traceId/:spanId/scores",
+    w({
+      description: "Get scores by trace ID and span ID",
+      tags: ["scores"],
+      parameters: [
+        {
+          name: "traceId",
+          in: "path",
+          required: true,
+          schema: { type: "string" },
+          description: "Trace ID"
+        },
+        {
+          name: "spanId",
+          in: "path",
+          required: true,
+          schema: { type: "string" },
+          description: "Span ID"
+        },
+        {
+          name: "page",
+          in: "query",
+          required: false,
+          schema: { type: "number" },
+          description: "Page number for pagination (default: 0)"
+        },
+        {
+          name: "perPage",
+          in: "query",
+          required: false,
+          schema: { type: "number" },
+          description: "Number of items per page (default: 10)"
+        }
+      ],
+      responses: {
+        200: {
+          description: "Paginated list of scores for span"
+        }
+      }
+    }),
+    getScoresBySpan
+  );
   router.post(
     "/traces/score",
     w({
@@ -9861,14 +10015,15 @@ async function startAsyncWorkflowHandler(c2) {
     const mastra = c2.get("mastra");
     const runtimeContext = c2.get("runtimeContext");
     const workflowId = c2.req.param("workflowId");
-    const { inputData } = await c2.req.json();
+    const { inputData, tracingOptions } = await c2.req.json();
     const runId = c2.req.query("runId");
     const result = await workflows.startAsyncWorkflowHandler({
       mastra,
       runtimeContext,
       workflowId,
       runId,
-      inputData
+      inputData,
+      tracingOptions
     });
     return c2.json(result);
   } catch (error) {
@@ -9880,14 +10035,15 @@ async function startWorkflowRunHandler(c2) {
     const mastra = c2.get("mastra");
     const runtimeContext = c2.get("runtimeContext");
     const workflowId = c2.req.param("workflowId");
-    const { inputData } = await c2.req.json();
+    const { inputData, tracingOptions } = await c2.req.json();
     const runId = c2.req.query("runId");
     await workflows.startWorkflowRunHandler({
       mastra,
       runtimeContext,
       workflowId,
       runId,
-      inputData
+      inputData,
+      tracingOptions
     });
     return c2.json({ message: "Workflow run started" });
   } catch (e2) {
@@ -9939,7 +10095,7 @@ async function streamWorkflowHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const logger2 = mastra.getLogger();
     const workflowId = c2.req.param("workflowId");
-    const { inputData } = await c2.req.json();
+    const { inputData, tracingOptions } = await c2.req.json();
     const runId = c2.req.query("runId");
     c2.header("Transfer-Encoding", "chunked");
     return streaming.stream(
@@ -9951,7 +10107,8 @@ async function streamWorkflowHandler(c2) {
             workflowId,
             runId,
             inputData,
-            runtimeContext
+            runtimeContext,
+            tracingOptions
           });
           const reader = result.stream.getReader();
           stream7.onAbort(() => {
@@ -10020,7 +10177,7 @@ async function streamVNextWorkflowHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const logger2 = mastra.getLogger();
     const workflowId = c2.req.param("workflowId");
-    const { inputData, closeOnSuspend } = await c2.req.json();
+    const { inputData, closeOnSuspend, tracingOptions } = await c2.req.json();
     const runId = c2.req.query("runId");
     c2.header("Transfer-Encoding", "chunked");
     return streaming.stream(
@@ -10033,7 +10190,8 @@ async function streamVNextWorkflowHandler(c2) {
             runId,
             inputData,
             runtimeContext,
-            closeOnSuspend
+            closeOnSuspend,
+            tracingOptions
           });
           const reader = result.getReader();
           stream7.onAbort(() => {
@@ -10061,7 +10219,7 @@ async function resumeStreamWorkflowHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const logger2 = mastra.getLogger();
     const workflowId = c2.req.param("workflowId");
-    const { step, resumeData } = await c2.req.json();
+    const { step, resumeData, tracingOptions } = await c2.req.json();
     const runId = c2.req.query("runId");
     c2.header("Transfer-Encoding", "chunked");
     return streaming.stream(
@@ -10073,7 +10231,8 @@ async function resumeStreamWorkflowHandler(c2) {
             workflowId,
             runId,
             body: { step, resumeData },
-            runtimeContext
+            runtimeContext,
+            tracingOptions
           });
           const reader = result.getReader();
           stream7.onAbort(() => {
@@ -10101,7 +10260,7 @@ async function resumeAsyncWorkflowHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const workflowId = c2.req.param("workflowId");
     const runId = c2.req.query("runId");
-    const { step, resumeData } = await c2.req.json();
+    const { step, resumeData, tracingOptions } = await c2.req.json();
     if (!runId) {
       throw new httpException.HTTPException(400, { message: "runId required to resume workflow" });
     }
@@ -10110,7 +10269,8 @@ async function resumeAsyncWorkflowHandler(c2) {
       runtimeContext,
       workflowId,
       runId,
-      body: { step, resumeData }
+      body: { step, resumeData },
+      tracingOptions
     });
     return c2.json(result);
   } catch (error) {
@@ -10123,7 +10283,7 @@ async function resumeWorkflowHandler(c2) {
     const runtimeContext = c2.get("runtimeContext");
     const workflowId = c2.req.param("workflowId");
     const runId = c2.req.query("runId");
-    const { step, resumeData } = await c2.req.json();
+    const { step, resumeData, tracingOptions } = await c2.req.json();
     if (!runId) {
       throw new httpException.HTTPException(400, { message: "runId required to resume workflow" });
     }
@@ -10132,7 +10292,8 @@ async function resumeWorkflowHandler(c2) {
       runtimeContext,
       workflowId,
       runId,
-      body: { step, resumeData }
+      body: { step, resumeData },
+      tracingOptions
     });
     return c2.json({ message: "Workflow run resumed" });
   } catch (error) {
@@ -10493,7 +10654,18 @@ function workflowsRouter(bodyLimitOptions) {
               type: "object",
               properties: {
                 stepId: { type: "string" },
-                context: { type: "object" }
+                context: { type: "object" },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the workflow execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
+                }
               }
             }
           }
@@ -10530,7 +10702,18 @@ function workflowsRouter(bodyLimitOptions) {
               type: "object",
               properties: {
                 stepId: { type: "string" },
-                context: { type: "object" }
+                context: { type: "object" },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the workflow execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
+                }
               }
             }
           }
@@ -10879,6 +11062,17 @@ function workflowsRouter(bodyLimitOptions) {
                 runtimeContext: {
                   type: "object",
                   description: "Runtime context for the workflow execution"
+                },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the workflow execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
                 }
               },
               required: ["step"]
@@ -10962,6 +11156,17 @@ function workflowsRouter(bodyLimitOptions) {
                 runtimeContext: {
                   type: "object",
                   description: "Runtime context for the workflow execution"
+                },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the workflow execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
                 }
               }
             }
@@ -11043,6 +11248,17 @@ function workflowsRouter(bodyLimitOptions) {
                 closeOnSuspend: {
                   type: "boolean",
                   description: "Close the stream on suspend"
+                },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the workflow execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
                 }
               }
             }
@@ -11120,6 +11336,17 @@ function workflowsRouter(bodyLimitOptions) {
                 runtimeContext: {
                   type: "object",
                   description: "Runtime context for the workflow execution"
+                },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the workflow execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
                 }
               }
             }
@@ -11140,7 +11367,7 @@ function workflowsRouter(bodyLimitOptions) {
   router.post(
     "/:workflowId/start",
     w({
-      description: "Create and start a new workflow run",
+      description: "Start an existing workflow run",
       tags: ["workflows"],
       parameters: [
         {
@@ -11167,6 +11394,17 @@ function workflowsRouter(bodyLimitOptions) {
                 runtimeContext: {
                   type: "object",
                   description: "Runtime context for the workflow execution"
+                },
+                tracingOptions: {
+                  type: "object",
+                  description: "Tracing options for the workflow execution",
+                  properties: {
+                    metadata: {
+                      type: "object",
+                      description: "Custom metadata to attach to the trace",
+                      additionalProperties: true
+                    }
+                  }
                 }
               }
             }