@mastra/deployer 0.18.0 → 0.19.0-alpha.1

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAuB5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD,KAAK,QAAQ,GAAG,EAAE,CAAC;AAEnB,KAAK,SAAS,GAAG;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC;QAAE,UAAU,EAAE,+BAA+B,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,wCAmB/D;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAER;cAGgC,QAAQ;eAAa,SAAS;2CAogBhE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAmC,mDAoDlG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAuB5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAGnD,KAAK,QAAQ,GAAG,EAAE,CAAC;AAEnB,KAAK,SAAS,GAAG;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC;QAAE,UAAU,EAAE,+BAA+B,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,qBAAqB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,wCAmB/D;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAER;cAGgC,QAAQ;eAAa,SAAS;2CAsgBhE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAmC,mDAoDlG"}

package/dist/server/index.js

@@ -22,6 +22,7 @@ import { getAgentCardByIdHandler as getAgentCardByIdHandler$1, getAgentExecution
 import { stream } from 'hono/streaming';
 import { bodyLimit } from 'hono/body-limit';
 import { getAgentBuilderActionsHandler as getAgentBuilderActionsHandler$1, getAgentBuilderActionByIdHandler as getAgentBuilderActionByIdHandler$1, getAgentBuilderActionRunsHandler as getAgentBuilderActionRunsHandler$1, getAgentBuilderActionRunExecutionResultHandler as getAgentBuilderActionRunExecutionResultHandler$1, getAgentBuilderActionRunByIdHandler as getAgentBuilderActionRunByIdHandler$1, resumeAgentBuilderActionHandler as resumeAgentBuilderActionHandler$1, resumeAsyncAgentBuilderActionHandler as resumeAsyncAgentBuilderActionHandler$1, streamAgentBuilderActionHandler as streamAgentBuilderActionHandler$1, streamVNextAgentBuilderActionHandler as streamVNextAgentBuilderActionHandler$1, createAgentBuilderActionRunHandler as createAgentBuilderActionRunHandler$1, startAsyncAgentBuilderActionHandler as startAsyncAgentBuilderActionHandler$1, startAgentBuilderActionRunHandler as startAgentBuilderActionRunHandler$1, watchAgentBuilderActionHandler as watchAgentBuilderActionHandler$1, cancelAgentBuilderActionRunHandler as cancelAgentBuilderActionRunHandler$1, sendAgentBuilderActionRunEventHandler as sendAgentBuilderActionRunEventHandler$1 } from '@mastra/server/handlers/agent-builder';
+import { MastraError, ErrorCategory, ErrorDomain } from '@mastra/core/error';
 import { getAgentsHandler as getAgentsHandler$1, getAgentByIdHandler as getAgentByIdHandler$1, getEvalsByAgentIdHandler as getEvalsByAgentIdHandler$1, getLiveEvalsByAgentIdHandler as getLiveEvalsByAgentIdHandler$1, generateLegacyHandler as generateLegacyHandler$1, generateHandler as generateHandler$1, streamNetworkHandler as streamNetworkHandler$1, generateVNextHandler as generateVNextHandler$1, streamVNextGenerateHandler as streamVNextGenerateHandler$1, streamGenerateLegacyHandler as streamGenerateLegacyHandler$1, streamGenerateHandler as streamGenerateHandler$1, streamVNextUIMessageHandler as streamVNextUIMessageHandler$1, updateAgentModelHandler as updateAgentModelHandler$1, reorderAgentModelListHandler as reorderAgentModelListHandler$1, updateAgentModelInModelListHandler as updateAgentModelInModelListHandler$1 } from '@mastra/server/handlers/agents';
 import { Agent } from '@mastra/core/agent';
 import { z } from 'zod';
@@ -33,7 +34,7 @@ import { Buffer as Buffer$1 } from 'buffer';
 import { getMemoryStatusHandler as getMemoryStatusHandler$1, getThreadsHandler as getThreadsHandler$1, getThreadByIdHandler as getThreadByIdHandler$1, getMessagesHandler as getMessagesHandler$1, createThreadHandler as createThreadHandler$1, updateThreadHandler as updateThreadHandler$1, deleteThreadHandler as deleteThreadHandler$1, saveMessagesHandler as saveMessagesHandler$1, deleteMessagesHandler as deleteMessagesHandler$1, getMemoryConfigHandler as getMemoryConfigHandler$1, getThreadsPaginatedHandler as getThreadsPaginatedHandler$1, getMessagesPaginatedHandler as getMessagesPaginatedHandler$1, searchMemoryHandler as searchMemoryHandler$1, getWorkingMemoryHandler as getWorkingMemoryHandler$1, updateWorkingMemoryHandler as updateWorkingMemoryHandler$1 } from '@mastra/server/handlers/memory';
 import { getVNextNetworksHandler as getVNextNetworksHandler$1, getVNextNetworkByIdHandler as getVNextNetworkByIdHandler$1, generateVNextNetworkHandler as generateVNextNetworkHandler$1, loopVNextNetworkHandler as loopVNextNetworkHandler$1, loopStreamVNextNetworkHandler as loopStreamVNextNetworkHandler$1, streamGenerateVNextNetworkHandler as streamGenerateVNextNetworkHandler$1 } from '@mastra/server/handlers/vNextNetwork';
 import { AISpanType } from '@mastra/core/ai-tracing';
-import { getAITracesPaginatedHandler as getAITracesPaginatedHandler$1, getAITraceHandler as getAITraceHandler$1, scoreTracesHandler } from '@mastra/server/handlers/observability';
+import { getAITracesPaginatedHandler as getAITracesPaginatedHandler$1, getAITraceHandler as getAITraceHandler$1, getScoresBySpan as getScoresBySpan$1, scoreTracesHandler } from '@mastra/server/handlers/observability';
 import { getScorersHandler as getScorersHandler$1, getScorerHandler as getScorerHandler$1, getScoresByRunIdHandler as getScoresByRunIdHandler$1, getScoresByScorerIdHandler as getScoresByScorerIdHandler$1, getScoresByEntityIdHandler as getScoresByEntityIdHandler$1, saveScoreHandler as saveScoreHandler$1 } from '@mastra/server/handlers/scores';
 import { getTelemetryHandler as getTelemetryHandler$1, storeTelemetryHandler as storeTelemetryHandler$1 } from '@mastra/server/handlers/telemetry';
 import { upsertVectors as upsertVectors$1, createIndex as createIndex$1, queryVectors as queryVectors$1, listIndexes as listIndexes$1, describeIndex as describeIndex$1, deleteIndex as deleteIndex$1 } from '@mastra/server/handlers/vector';
@@ -292,12 +293,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) {
@@ -2356,6 +2361,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) {
@@ -2540,6 +2556,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 MastraError({
+        id: "AGENT_NOT_FOUND",
+        domain: ErrorDomain.AGENT,
+        category: ErrorCategory.USER,
+        text: "Agent not found"
+      });
+    }
+    const memory = await agent.getMemory({ runtimeContext });
+    if (!memory) {
+      throw new MastraError({
+        id: "AGENT_NETWORK_MEMORY_REQUIRED",
+        domain: ErrorDomain.AGENT_NETWORK,
+        category: 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 stream(
       c2,
@@ -3078,7 +3115,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"]
             }
@@ -3129,7 +3177,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"]
             }
@@ -3283,7 +3342,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"]
             }
@@ -3334,7 +3404,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"]
             }
@@ -3400,6 +3481,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"]
@@ -8828,6 +8920,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 getScoresBySpan$1({
+      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() {
@@ -8920,6 +9031,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({
@@ -9835,14 +9989,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 startAsyncWorkflowHandler$1({
       mastra,
       runtimeContext,
       workflowId,
       runId,
-      inputData
+      inputData,
+      tracingOptions
     });
     return c2.json(result);
   } catch (error) {
@@ -9854,14 +10009,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 startWorkflowRunHandler$1({
       mastra,
       runtimeContext,
       workflowId,
       runId,
-      inputData
+      inputData,
+      tracingOptions
     });
     return c2.json({ message: "Workflow run started" });
   } catch (e2) {
@@ -9913,7 +10069,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 stream(
@@ -9925,7 +10081,8 @@ async function streamWorkflowHandler(c2) {
             workflowId,
             runId,
             inputData,
-            runtimeContext
+            runtimeContext,
+            tracingOptions
           });
           const reader = result.stream.getReader();
           stream7.onAbort(() => {
@@ -9994,7 +10151,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 stream(
@@ -10007,7 +10164,8 @@ async function streamVNextWorkflowHandler(c2) {
             runId,
             inputData,
             runtimeContext,
-            closeOnSuspend
+            closeOnSuspend,
+            tracingOptions
           });
           const reader = result.getReader();
           stream7.onAbort(() => {
@@ -10035,7 +10193,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 stream(
@@ -10047,7 +10205,8 @@ async function resumeStreamWorkflowHandler(c2) {
             workflowId,
             runId,
             body: { step, resumeData },
-            runtimeContext
+            runtimeContext,
+            tracingOptions
           });
           const reader = result.getReader();
           stream7.onAbort(() => {
@@ -10075,7 +10234,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(400, { message: "runId required to resume workflow" });
     }
@@ -10084,7 +10243,8 @@ async function resumeAsyncWorkflowHandler(c2) {
       runtimeContext,
       workflowId,
       runId,
-      body: { step, resumeData }
+      body: { step, resumeData },
+      tracingOptions
     });
     return c2.json(result);
   } catch (error) {
@@ -10097,7 +10257,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(400, { message: "runId required to resume workflow" });
     }
@@ -10106,7 +10266,8 @@ async function resumeWorkflowHandler(c2) {
       runtimeContext,
       workflowId,
       runId,
-      body: { step, resumeData }
+      body: { step, resumeData },
+      tracingOptions
     });
     return c2.json({ message: "Workflow run resumed" });
   } catch (error) {
@@ -10467,7 +10628,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
+                    }
+                  }
+                }
               }
             }
           }
@@ -10504,7 +10676,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
+                    }
+                  }
+                }
               }
             }
           }
@@ -10853,6 +11036,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"]
@@ -10936,6 +11130,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
+                    }
+                  }
                 }
               }
             }
@@ -11017,6 +11222,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
+                    }
+                  }
                 }
               }
             }
@@ -11094,6 +11310,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
+                    }
+                  }
                 }
               }
             }
@@ -11114,7 +11341,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: [
         {
@@ -11141,6 +11368,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
+                    }
+                  }
                 }
               }
             }
@@ -11784,9 +12022,11 @@ async function createHonoServer(mastra, options = {
       );
       const serverOptions = mastra.getServer();
       const port = serverOptions?.port ?? (Number(process.env.PORT) || 4111);
+      const hideCloudCta = process.env.MASTRA_HIDE_CLOUD_CTA === "true";
       const host = serverOptions?.host ?? "localhost";
       indexHtml = indexHtml.replace(`'%%MASTRA_SERVER_HOST%%'`, `'${host}'`);
       indexHtml = indexHtml.replace(`'%%MASTRA_SERVER_PORT%%'`, `'${port}'`);
+      indexHtml = indexHtml.replace(`'%%MASTRA_HIDE_CLOUD_CTA%%'`, `'${hideCloudCta}'`);
       return c2.newResponse(indexHtml, 200, { "Content-Type": "text/html" });
     }
     return c2.newResponse(html2, 200, { "Content-Type": "text/html" });