@mastra/ai-sdk 0.0.0-ai-sdk-workflow-route-20251010135341 → 0.0.0-allow-to-pass-a-mastra-url-instance-20251105224938

package/dist/index.cjs

@@ -5,6 +5,33 @@ var ai = require('ai');
 var stream = require('@mastra/core/stream');
 
 // src/chat-route.ts
+
+// src/utils.ts
+var isDataChunkType = (chunk) => {
+  return chunk && typeof chunk === "object" && "type" in chunk && chunk.type?.startsWith("data-");
+};
+function safeParseErrorObject(obj) {
+  if (typeof obj !== "object" || obj === null) {
+    return String(obj);
+  }
+  try {
+    const stringified = JSON.stringify(obj);
+    if (stringified === "{}") {
+      return String(obj);
+    }
+    return stringified;
+  } catch {
+    return String(obj);
+  }
+}
+var isAgentExecutionDataChunkType = (chunk) => {
+  return chunk && typeof chunk === "object" && "type" in chunk && chunk.type?.startsWith("agent-execution-event-") && "payload" in chunk && typeof chunk.payload === "object" && "type" in chunk.payload && chunk.payload.type?.startsWith("data-");
+};
+var isWorkflowExecutionDataChunkType = (chunk) => {
+  return chunk && typeof chunk === "object" && "type" in chunk && chunk.type?.startsWith("workflow-execution-event-") && "payload" in chunk && typeof chunk.payload === "object" && "type" in chunk.payload && chunk.payload.type?.startsWith("data-");
+};
+
+// src/helpers.ts
 function convertMastraChunkToAISDKv5({
   chunk,
   mode = "stream"
@@ -210,6 +237,9 @@ function convertMastraChunkToAISDKv5({
           ...chunk.payload || {}
         };
       }
+      if ("type" in chunk && chunk.type?.startsWith("data-")) {
+        return chunk;
+      }
       return;
   }
 }
@@ -223,7 +253,7 @@ function convertFullStreamChunkToUIMessageStream({
   sendFinish,
   responseMessageId
 }) {
-  const partType = part.type;
+  const partType = part?.type;
   switch (partType) {
     case "text-start": {
       return {
@@ -380,8 +410,16 @@ function convertFullStreamChunkToUIMessageStream({
       return;
     }
     default: {
-      const exhaustiveCheck = partType;
-      throw new Error(`Unknown chunk type: ${exhaustiveCheck}`);
+      if (isDataChunkType(part)) {
+        if (!("data" in part)) {
+          throw new Error(
+            `UI Messages require a data property when using data- prefixed chunks 
+ ${JSON.stringify(part)}`
+          );
+        }
+        return part;
+      }
+      return;
     }
   }
 }
@@ -425,7 +463,7 @@ function AgentNetworkToAISDKTransformer() {
     }
   });
 }
-function AgentStreamToAISDKTransformer() {
+function AgentStreamToAISDKTransformer(lastMessageId) {
   let bufferedSteps = /* @__PURE__ */ new Map();
   return new TransformStream({
     transform(chunk, controller) {
@@ -436,9 +474,9 @@ function AgentStreamToAISDKTransformer() {
         sendSources: false,
         sendStart: true,
         sendFinish: true,
-        responseMessageId: chunk.runId,
-        onError() {
-          return "Error";
+        responseMessageId: lastMessageId,
+        onError(error) {
+          return safeParseErrorObject(error);
         }
       });
       if (transformedChunk) {
@@ -448,11 +486,11 @@ function AgentStreamToAISDKTransformer() {
           if (agentTransformed) controller.enqueue(agentTransformed);
         } else if (transformedChunk.type === "tool-workflow") {
           const payload = transformedChunk.payload;
-          const workflowChunk = transformWorkflow(payload, bufferedSteps);
+          const workflowChunk = transformWorkflow(payload, bufferedSteps, true);
           if (workflowChunk) controller.enqueue(workflowChunk);
         } else if (transformedChunk.type === "tool-network") {
           const payload = transformedChunk.payload;
-          const networkChunk = transformNetwork(payload, bufferedSteps);
+          const networkChunk = transformNetwork(payload, bufferedSteps, true);
           if (networkChunk) controller.enqueue(networkChunk);
         } else {
           controller.enqueue(transformedChunk);
@@ -597,7 +635,7 @@ function transformAgent(payload, bufferedSteps) {
   }
   return null;
 }
-function transformWorkflow(payload, bufferedWorkflows) {
+function transformWorkflow(payload, bufferedWorkflows, isNested) {
   switch (payload.type) {
     case "workflow-start":
       bufferedWorkflows.set(payload.runId, {
@@ -605,7 +643,7 @@ function transformWorkflow(payload, bufferedWorkflows) {
         steps: {}
       });
       return {
-        type: "data-workflow",
+        type: isNested ? "data-tool-workflow" : "data-workflow",
         id: payload.runId,
         data: {
           name: bufferedWorkflows.get(payload.runId).name,
@@ -620,11 +658,13 @@ function transformWorkflow(payload, bufferedWorkflows) {
         name: payload.payload.id,
         status: payload.payload.status,
         input: payload.payload.payload ?? null,
-        output: null
+        output: null,
+        suspendPayload: null,
+        resumePayload: null
       };
       bufferedWorkflows.set(payload.runId, current);
       return {
-        type: "data-workflow",
+        type: isNested ? "data-tool-workflow" : "data-workflow",
         id: payload.runId,
         data: {
           name: current.name,
@@ -643,7 +683,7 @@ function transformWorkflow(payload, bufferedWorkflows) {
         output: payload.payload.output ?? null
       };
       return {
-        type: "data-workflow",
+        type: isNested ? "data-tool-workflow" : "data-workflow",
         id: payload.runId,
         data: {
           name: current.name,
@@ -653,11 +693,32 @@ function transformWorkflow(payload, bufferedWorkflows) {
         }
       };
     }
+    case "workflow-step-suspended": {
+      const current = bufferedWorkflows.get(payload.runId);
+      if (!current) return null;
+      current.steps[payload.payload.id] = {
+        ...current.steps[payload.payload.id],
+        status: payload.payload.status,
+        suspendPayload: payload.payload.suspendPayload ?? null,
+        resumePayload: payload.payload.resumePayload ?? null,
+        output: null
+      };
+      return {
+        type: isNested ? "data-tool-workflow" : "data-workflow",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          status: "suspended",
+          steps: current.steps,
+          output: null
+        }
+      };
+    }
     case "workflow-finish": {
       const current = bufferedWorkflows.get(payload.runId);
       if (!current) return null;
       return {
-        type: "data-workflow",
+        type: isNested ? "data-tool-workflow" : "data-workflow",
         id: payload.runId,
         data: {
           name: current.name,
@@ -667,87 +728,117 @@ function transformWorkflow(payload, bufferedWorkflows) {
         }
       };
     }
-    default:
+    default: {
+      if (isDataChunkType(payload)) {
+        if (!("data" in payload)) {
+          throw new Error(
+            `UI Messages require a data property when using data- prefixed chunks 
+ ${JSON.stringify(payload)}`
+          );
+        }
+        return payload;
+      }
       return null;
+    }
   }
 }
-function transformNetwork(payload, bufferedNetworks) {
+function transformNetwork(payload, bufferedNetworks, isNested) {
   switch (payload.type) {
     case "routing-agent-start": {
-      if (!bufferedNetworks.has(payload.payload.runId)) {
-        bufferedNetworks.set(payload.payload.runId, {
+      if (!bufferedNetworks.has(payload.runId)) {
+        bufferedNetworks.set(payload.runId, {
           name: payload.payload.agentId,
-          steps: []
+          steps: [],
+          usage: null,
+          output: null
         });
       }
       return {
-        type: "data-network",
-        id: payload.payload.runId,
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
         data: {
-          name: bufferedNetworks.get(payload.payload.runId).name,
+          name: bufferedNetworks.get(payload.runId).name,
           status: "running",
-          steps: bufferedNetworks.get(payload.payload.runId).steps,
+          usage: null,
+          steps: bufferedNetworks.get(payload.runId).steps,
           output: null
         }
       };
     }
+    case "routing-agent-text-start": {
+      const current = bufferedNetworks.get(payload.runId);
+      if (!current) return null;
+      return {
+        type: "text-start",
+        id: payload.runId
+      };
+    }
+    case "routing-agent-text-delta": {
+      const current = bufferedNetworks.get(payload.runId);
+      if (!current) return null;
+      return {
+        type: "text-delta",
+        id: payload.runId,
+        delta: payload.payload.text
+      };
+    }
     case "agent-execution-start": {
-      const current = bufferedNetworks.get(payload.payload.runId) || { name: "", steps: [] };
+      const current = bufferedNetworks.get(payload.runId) || { name: "", steps: [], usage: null, output: null };
       current.steps.push({
         name: payload.payload.agentId,
         status: "running",
         input: payload.payload.args || null,
-        output: null
+        output: null,
+        suspendPayload: null,
+        resumePayload: null
       });
-      bufferedNetworks.set(payload.payload.runId, current);
+      bufferedNetworks.set(payload.runId, current);
       return {
-        type: "data-network",
-        id: payload.payload.runId,
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
         data: {
-          name: current.name,
-          status: "running",
-          steps: current.steps,
-          output: null
+          ...current,
+          status: "running"
         }
       };
     }
     case "workflow-execution-start": {
-      const current = bufferedNetworks.get(payload.payload.runId) || { name: "", steps: [] };
+      const current = bufferedNetworks.get(payload.runId) || { name: "", steps: [], usage: null, output: null };
       current.steps.push({
         name: payload.payload.name,
         status: "running",
         input: payload.payload.args || null,
-        output: null
+        output: null,
+        suspendPayload: null,
+        resumePayload: null
       });
-      bufferedNetworks.set(payload.payload.runId, current);
+      bufferedNetworks.set(payload.runId, current);
       return {
-        type: "data-network",
-        id: payload.payload.runId,
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
         data: {
-          name: current.name,
-          status: "running",
-          steps: current.steps,
-          output: null
+          ...current,
+          status: "running"
         }
       };
     }
     case "tool-execution-start": {
-      const current = bufferedNetworks.get(payload.payload.runId) || { name: "", steps: [] };
+      const current = bufferedNetworks.get(payload.runId) || { name: "", steps: [], usage: null, output: null };
       current.steps.push({
         name: payload.payload.args?.toolName,
         status: "running",
         input: payload.payload.args?.args || null,
-        output: null
+        output: null,
+        suspendPayload: null,
+        resumePayload: null
       });
-      bufferedNetworks.set(payload.payload.runId, current);
+      bufferedNetworks.set(payload.runId, current);
       return {
-        type: "data-network",
-        id: payload.payload.runId,
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
         data: {
-          name: current.name,
-          status: "running",
-          steps: current.steps,
-          output: null
+          ...current,
+          status: "running"
         }
       };
     }
@@ -758,16 +849,18 @@ function transformNetwork(payload, bufferedNetworks) {
         name: payload.payload.agentId,
         status: "success",
         input: null,
-        output: payload.payload.result
+        output: payload.payload.result,
+        suspendPayload: null,
+        resumePayload: null
       });
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.runId,
         data: {
-          name: current.name,
+          ...current,
+          usage: payload.payload?.usage ?? current.usage,
           status: "running",
-          steps: current.steps,
-          output: payload.payload.result ?? null
+          output: payload.payload.result ?? current.output
         }
       };
     }
@@ -778,16 +871,17 @@ function transformNetwork(payload, bufferedNetworks) {
         name: payload.payload.toolName,
         status: "success",
         input: null,
-        output: payload.payload.result
+        output: payload.payload.result,
+        suspendPayload: null,
+        resumePayload: null
       });
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.runId,
         data: {
-          name: current.name,
+          ...current,
           status: "running",
-          steps: current.steps,
-          output: payload.payload.result ?? null
+          output: payload.payload.result ?? current.output
         }
       };
     }
@@ -798,44 +892,45 @@ function transformNetwork(payload, bufferedNetworks) {
         name: payload.payload.name,
         status: "success",
         input: null,
-        output: payload.payload.result
+        output: payload.payload.result,
+        suspendPayload: null,
+        resumePayload: null
       });
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.runId,
         data: {
-          name: current.name,
+          ...current,
+          usage: payload.payload?.usage ?? current.usage,
           status: "running",
-          steps: current.steps,
-          output: payload.payload.result ?? null
+          output: payload.payload.result ?? current.output
         }
       };
     }
     case "routing-agent-end": {
-      const current = bufferedNetworks.get(payload.payload.runId);
+      const current = bufferedNetworks.get(payload.runId);
       if (!current) return null;
       return {
-        type: "data-network",
-        id: payload.payload.runId,
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
         data: {
-          name: current.name,
+          ...current,
           status: "finished",
-          steps: current.steps,
-          output: payload.payload?.result ?? null
+          usage: payload.payload?.usage ?? current.usage,
+          output: payload.payload?.result ?? current.output
         }
       };
     }
     case "network-execution-event-step-finish": {
-      const current = bufferedNetworks.get(payload.payload.runId);
+      const current = bufferedNetworks.get(payload.runId);
       if (!current) return null;
       return {
-        type: "data-network",
-        id: payload.payload.runId,
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
         data: {
-          name: current.name,
+          ...current,
           status: "finished",
-          steps: current.steps,
-          output: payload.payload?.result ?? null
+          output: payload.payload?.result ?? current.output
         }
       };
     }
@@ -843,23 +938,51 @@ function transformNetwork(payload, bufferedNetworks) {
       const current = bufferedNetworks.get(payload.runId);
       if (!current) return null;
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.runId,
         data: {
-          name: current.name,
+          ...current,
+          usage: payload.payload?.usage ?? current.usage,
           status: "finished",
-          steps: current.steps,
-          output: payload.payload?.result ?? null
+          output: payload.payload?.result ?? current.output
         }
       };
     }
-    default:
+    default: {
+      if (isDataChunkType(payload)) {
+        if (!("data" in payload)) {
+          throw new Error(
+            `UI Messages require a data property when using data- prefixed chunks 
+ ${JSON.stringify(payload)}`
+          );
+        }
+        return payload;
+      }
+      if (isAgentExecutionDataChunkType(payload)) {
+        if (!("data" in payload.payload)) {
+          throw new Error(
+            `UI Messages require a data property when using data- prefixed chunks 
+ ${JSON.stringify(payload)}`
+          );
+        }
+        return payload.payload;
+      }
+      if (isWorkflowExecutionDataChunkType(payload)) {
+        if (!("data" in payload.payload)) {
+          throw new Error(
+            `UI Messages require a data property when using data- prefixed chunks 
+ ${JSON.stringify(payload)}`
+          );
+        }
+        return payload.payload;
+      }
       return null;
+    }
   }
 }
 
-// src/to-ai-sdk-format.ts
-function toAISdkFormat(stream, options = { from: "agent" }) {
+// src/convert-streams.ts
+function toAISdkV5Stream(stream, options = { from: "agent" }) {
   const from = options?.from;
   if (from === "workflow") {
     return stream.pipeThrough(WorkflowStreamToAISDKTransformer());
@@ -868,7 +991,7 @@ function toAISdkFormat(stream, options = { from: "agent" }) {
     return stream.pipeThrough(AgentNetworkToAISDKTransformer());
   }
   const agentReadable = "fullStream" in stream ? stream.fullStream : stream;
-  return agentReadable.pipeThrough(AgentStreamToAISDKTransformer());
+  return agentReadable.pipeThrough(AgentStreamToAISDKTransformer(options?.lastMessageId));
 }
 
 // src/chat-route.ts
@@ -976,6 +1099,7 @@ function chatRoute({
     handler: async (c) => {
       const { messages, ...rest } = await c.req.json();
       const mastra = c.get("mastra");
+      const requestContext = c.get("requestContext");
       let agentToUse = agent;
       if (!agent) {
         const agentId = c.req.param("agentId");
@@ -986,6 +1110,9 @@ function chatRoute({
           `Fixed agent ID was set together with an agentId path parameter. This can lead to unexpected behavior.`
         );
       }
+      if (requestContext && defaultOptions?.requestContext) {
+        mastra.getLogger()?.warn(`"requestContext" set in the route options will be overridden by the request's "requestContext".`);
+      }
       if (!agentToUse) {
         throw new Error("Agent ID is required");
       }
@@ -995,11 +1122,17 @@ function chatRoute({
       }
       const result = await agentObj.stream(messages, {
         ...defaultOptions,
-        ...rest
+        ...rest,
+        requestContext: requestContext || defaultOptions?.requestContext
       });
+      let lastMessageId;
+      if (messages.length > 0 && messages[messages.length - 1].role === "assistant") {
+        lastMessageId = messages[messages.length - 1].id;
+      }
       const uiMessageStream = ai.createUIMessageStream({
+        originalMessages: messages,
         execute: async ({ writer }) => {
-          for await (const part of toAISdkFormat(result, { from: "agent" })) {
+          for await (const part of toAISdkV5Stream(result, { from: "agent", lastMessageId })) {
             writer.write(part);
           }
         }
@@ -1040,7 +1173,7 @@ function workflowRoute({
               type: "object",
               properties: {
                 inputData: { type: "object", additionalProperties: true },
-                runtimeContext: { type: "object", additionalProperties: true },
+                requestContext: { type: "object", additionalProperties: true },
                 tracingOptions: { type: "object", additionalProperties: true }
               }
             }
@@ -1059,7 +1192,7 @@ function workflowRoute({
       }
     },
     handler: async (c) => {
-      const { inputData, ...rest } = await c.req.json();
+      const { inputData, resumeData, ...rest } = await c.req.json();
       const mastra = c.get("mastra");
       let workflowToUse = workflow;
       if (!workflow) {
@@ -1078,11 +1211,11 @@ function workflowRoute({
       if (!workflowObj) {
         throw new Error(`Workflow ${workflowToUse} not found`);
       }
-      const run = await workflowObj.createRunAsync();
-      const stream = run.streamVNext({ inputData, ...rest });
+      const run = await workflowObj.createRun();
+      const stream = resumeData ? run.resumeStream({ resumeData, ...rest }) : run.stream({ inputData, ...rest });
       const uiMessageStream = ai.createUIMessageStream({
         execute: async ({ writer }) => {
-          for await (const part of toAISdkFormat(stream, { from: "workflow" })) {
+          for await (const part of toAISdkV5Stream(stream, { from: "workflow" })) {
             writer.write(part);
           }
         }
@@ -1122,13 +1255,12 @@ function networkRoute({
               type: "object",
               properties: {
                 messages: { type: "array", items: { type: "object" } },
-                runtimeContext: { type: "object", additionalProperties: true },
+                requestContext: { type: "object", additionalProperties: true },
                 runId: { type: "string" },
                 maxSteps: { type: "number" },
                 threadId: { type: "string" },
                 resourceId: { type: "string" },
                 modelSettings: { type: "object", additionalProperties: true },
-                telemetry: { type: "object", additionalProperties: true },
                 tools: { type: "array", items: { type: "object" } }
               },
               required: ["messages"]
@@ -1177,7 +1309,7 @@ function networkRoute({
       });
       const uiMessageStream = ai.createUIMessageStream({
         execute: async ({ writer }) => {
-          for await (const part of toAISdkFormat(result, { from: "network" })) {
+          for await (const part of toAISdkV5Stream(result, { from: "network" })) {
             writer.write(part);
           }
         }
@@ -1187,9 +1319,17 @@ function networkRoute({
   });
 }
 
+// src/to-ai-sdk-format.ts
+function toAISdkFormat() {
+  throw new Error(
+    'toAISdkFormat() has been deprecated. Please use toAISdkStream() instead.\n\nMigration:\n  import { toAISdkFormat } from "@mastra/ai-sdk";\n  // Change to:\n  import { toAISdkStream } from "@mastra/ai-sdk";\n\nThe function signature remains the same.'
+  );
+}
+
 exports.chatRoute = chatRoute;
 exports.networkRoute = networkRoute;
 exports.toAISdkFormat = toAISdkFormat;
+exports.toAISdkStream = toAISdkV5Stream;
 exports.workflowRoute = workflowRoute;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map