@mastra/ai-sdk 0.0.0-dynamic-model-router-20251010230835 → 0.0.0-extract-tool-ui-inp-playground-ui-20251023135343

package/dist/index.js

@@ -3,6 +3,13 @@ import { createUIMessageStream, createUIMessageStreamResponse } from 'ai';
 import { DefaultGeneratedFile, DefaultGeneratedFileWithType } from '@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-");
+};
+
+// src/helpers.ts
 function convertMastraChunkToAISDKv5({
   chunk,
   mode = "stream"
@@ -208,6 +215,9 @@ function convertMastraChunkToAISDKv5({
           ...chunk.payload || {}
         };
       }
+      if ("type" in chunk && chunk.type?.startsWith("data-")) {
+        return chunk;
+      }
       return;
   }
 }
@@ -221,7 +231,7 @@ function convertFullStreamChunkToUIMessageStream({
   sendFinish,
   responseMessageId
 }) {
-  const partType = part.type;
+  const partType = part?.type;
   switch (partType) {
     case "text-start": {
       return {
@@ -378,8 +388,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;
     }
   }
 }
@@ -390,24 +408,35 @@ function WorkflowStreamToAISDKTransformer() {
   return new TransformStream({
     start(controller) {
       controller.enqueue({
-        data: JSON.stringify({
-          type: "start",
-          messageId: "1"
-        })
+        type: "start"
       });
     },
     flush(controller) {
       controller.enqueue({
-        data: JSON.stringify({
-          type: "finish"
-        })
+        type: "finish"
       });
+    },
+    transform(chunk, controller) {
+      const transformed = transformWorkflow(chunk, bufferedWorkflows);
+      if (transformed) controller.enqueue(transformed);
+    }
+  });
+}
+function AgentNetworkToAISDKTransformer() {
+  const bufferedNetworks = /* @__PURE__ */ new Map();
+  return new TransformStream({
+    start(controller) {
       controller.enqueue({
-        data: "[DONE]"
+        type: "start"
+      });
+    },
+    flush(controller) {
+      controller.enqueue({
+        type: "finish"
       });
     },
     transform(chunk, controller) {
-      const transformed = transformWorkflow(chunk, bufferedWorkflows);
+      const transformed = transformNetwork(chunk, bufferedNetworks);
       if (transformed) controller.enqueue(transformed);
     }
   });
@@ -435,11 +464,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);
@@ -584,7 +613,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, {
@@ -592,7 +621,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,
@@ -611,7 +640,7 @@ function transformWorkflow(payload, bufferedWorkflows) {
       };
       bufferedWorkflows.set(payload.runId, current);
       return {
-        type: "data-workflow",
+        type: isNested ? "data-tool-workflow" : "data-workflow",
         id: payload.runId,
         data: {
           name: current.name,
@@ -630,7 +659,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,
@@ -644,7 +673,7 @@ function transformWorkflow(payload, bufferedWorkflows) {
       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,
@@ -654,19 +683,31 @@ 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": {
-      bufferedNetworks.set(payload.payload.runId, {
-        name: payload.payload.agentId,
-        steps: []
-      });
+      if (!bufferedNetworks.has(payload.payload.runId)) {
+        bufferedNetworks.set(payload.payload.runId, {
+          name: payload.payload.agentId,
+          steps: []
+        });
+      }
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.payload.runId,
         data: {
           name: bufferedNetworks.get(payload.payload.runId).name,
@@ -676,6 +717,23 @@ function transformNetwork(payload, bufferedNetworks) {
         }
       };
     }
+    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: [] };
       current.steps.push({
@@ -686,7 +744,7 @@ function transformNetwork(payload, bufferedNetworks) {
       });
       bufferedNetworks.set(payload.payload.runId, current);
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.payload.runId,
         data: {
           name: current.name,
@@ -706,7 +764,7 @@ function transformNetwork(payload, bufferedNetworks) {
       });
       bufferedNetworks.set(payload.payload.runId, current);
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.payload.runId,
         data: {
           name: current.name,
@@ -726,7 +784,7 @@ function transformNetwork(payload, bufferedNetworks) {
       });
       bufferedNetworks.set(payload.payload.runId, current);
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.payload.runId,
         data: {
           name: current.name,
@@ -736,32 +794,63 @@ function transformNetwork(payload, bufferedNetworks) {
         }
       };
     }
-    case "agent-execution-end":
+    case "agent-execution-end": {
+      const current = bufferedNetworks.get(payload.runId);
+      if (!current) return null;
+      current.steps.push({
+        name: payload.payload.agentId,
+        status: "success",
+        input: null,
+        output: payload.payload.result
+      });
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          output: payload.payload.result ?? null
+        }
+      };
+    }
     case "tool-execution-end": {
       const current = bufferedNetworks.get(payload.runId);
       if (!current) return null;
+      current.steps.push({
+        name: payload.payload.toolName,
+        status: "success",
+        input: null,
+        output: payload.payload.result
+      });
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.runId,
         data: {
           name: current.name,
           status: "running",
           steps: current.steps,
-          output: null
+          output: payload.payload.result ?? null
         }
       };
     }
     case "workflow-execution-end": {
       const current = bufferedNetworks.get(payload.runId);
       if (!current) return null;
+      current.steps.push({
+        name: payload.payload.name,
+        status: "success",
+        input: null,
+        output: payload.payload.result
+      });
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.runId,
         data: {
           name: current.name,
           status: "running",
           steps: current.steps,
-          output: null
+          output: payload.payload.result ?? null
         }
       };
     }
@@ -769,7 +858,7 @@ function transformNetwork(payload, bufferedNetworks) {
       const current = bufferedNetworks.get(payload.payload.runId);
       if (!current) return null;
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.payload.runId,
         data: {
           name: current.name,
@@ -783,7 +872,7 @@ function transformNetwork(payload, bufferedNetworks) {
       const current = bufferedNetworks.get(payload.payload.runId);
       if (!current) return null;
       return {
-        type: "data-network",
+        type: isNested ? "data-tool-network" : "data-network",
         id: payload.payload.runId,
         data: {
           name: current.name,
@@ -797,7 +886,7 @@ 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,
@@ -807,14 +896,32 @@ function transformNetwork(payload, bufferedNetworks) {
         }
       };
     }
-    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;
+    }
   }
 }
 
 // src/to-ai-sdk-format.ts
-function toAISdkFormat(stream) {
-  return stream.fullStream.pipeThrough(AgentStreamToAISDKTransformer());
+function toAISdkFormat(stream, options = { from: "agent" }) {
+  const from = options?.from;
+  if (from === "workflow") {
+    return stream.pipeThrough(WorkflowStreamToAISDKTransformer());
+  }
+  if (from === "network") {
+    return stream.pipeThrough(AgentNetworkToAISDKTransformer());
+  }
+  const agentReadable = "fullStream" in stream ? stream.fullStream : stream;
+  return agentReadable.pipeThrough(AgentStreamToAISDKTransformer());
 }
 
 // src/chat-route.ts
@@ -949,8 +1056,9 @@ function chatRoute({
         runtimeContext: runtimeContext || defaultOptions?.runtimeContext
       });
       const uiMessageStream = createUIMessageStream({
+        originalMessages: messages,
         execute: async ({ writer }) => {
-          for await (const part of toAISdkFormat(result)) {
+          for await (const part of toAISdkFormat(result, { from: "agent" })) {
             writer.write(part);
           }
         }
@@ -961,7 +1069,183 @@ function chatRoute({
     }
   });
 }
+function workflowRoute({
+  path = "/api/workflows/:workflowId/stream",
+  workflow
+}) {
+  if (!workflow && !path.includes("/:workflowId")) {
+    throw new Error("Path must include :workflowId to route to the correct workflow or pass the workflow explicitly");
+  }
+  return registerApiRoute(path, {
+    method: "POST",
+    openapi: {
+      summary: "Stream a workflow in AI SDK format",
+      description: "Starts a workflow run and streams events as AI SDK UIMessage chunks",
+      tags: ["ai-sdk"],
+      parameters: [
+        {
+          name: "workflowId",
+          in: "path",
+          required: true,
+          description: "The ID of the workflow to stream",
+          schema: { type: "string" }
+        }
+      ],
+      requestBody: {
+        required: true,
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                inputData: { type: "object", additionalProperties: true },
+                runtimeContext: { type: "object", additionalProperties: true },
+                tracingOptions: { type: "object", additionalProperties: true }
+              }
+            }
+          }
+        }
+      },
+      responses: {
+        "200": {
+          description: "Workflow UIMessage event stream",
+          content: {
+            "text/plain": {
+              schema: { type: "string", description: "SSE stream" }
+            }
+          }
+        }
+      }
+    },
+    handler: async (c) => {
+      const { inputData, ...rest } = await c.req.json();
+      const mastra = c.get("mastra");
+      let workflowToUse = workflow;
+      if (!workflow) {
+        const workflowId = c.req.param("workflowId");
+        workflowToUse = workflowId;
+      }
+      if (c.req.param("workflowId") && workflow) {
+        mastra.getLogger()?.warn(
+          `Fixed workflow ID was set together with a workflowId path parameter. This can lead to unexpected behavior.`
+        );
+      }
+      if (!workflowToUse) {
+        throw new Error("Workflow ID is required");
+      }
+      const workflowObj = mastra.getWorkflow(workflowToUse);
+      if (!workflowObj) {
+        throw new Error(`Workflow ${workflowToUse} not found`);
+      }
+      const run = await workflowObj.createRunAsync();
+      const stream = run.streamVNext({ inputData, ...rest });
+      const uiMessageStream = createUIMessageStream({
+        execute: async ({ writer }) => {
+          for await (const part of toAISdkFormat(stream, { from: "workflow" })) {
+            writer.write(part);
+          }
+        }
+      });
+      return createUIMessageStreamResponse({ stream: uiMessageStream });
+    }
+  });
+}
+function networkRoute({
+  path = "/network/:agentId",
+  agent,
+  defaultOptions
+}) {
+  if (!agent && !path.includes("/:agentId")) {
+    throw new Error("Path must include :agentId to route to the correct agent or pass the agent explicitly");
+  }
+  return registerApiRoute(path, {
+    method: "POST",
+    openapi: {
+      summary: "Execute an agent network and stream AI SDK events",
+      description: "Routes a request to an agent network and streams UIMessage chunks in AI SDK format",
+      tags: ["ai-sdk"],
+      parameters: [
+        {
+          name: "agentId",
+          in: "path",
+          required: true,
+          description: "The ID of the routing agent to execute as a network",
+          schema: { type: "string" }
+        }
+      ],
+      requestBody: {
+        required: true,
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                messages: { type: "array", items: { type: "object" } },
+                runtimeContext: { 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"]
+            }
+          }
+        }
+      },
+      responses: {
+        "200": {
+          description: "Streaming AI SDK UIMessage event stream for the agent network",
+          content: { "text/plain": { schema: { type: "string", description: "SSE stream" } } }
+        },
+        "404": {
+          description: "Agent not found",
+          content: {
+            "application/json": {
+              schema: { type: "object", properties: { error: { type: "string" } } }
+            }
+          }
+        }
+      }
+    },
+    handler: async (c) => {
+      const { messages, ...rest } = await c.req.json();
+      const mastra = c.get("mastra");
+      let agentToUse = agent;
+      if (!agent) {
+        const agentId = c.req.param("agentId");
+        agentToUse = agentId;
+      }
+      if (c.req.param("agentId") && agent) {
+        mastra.getLogger()?.warn(
+          `Fixed agent ID was set together with an agentId path parameter. This can lead to unexpected behavior.`
+        );
+      }
+      if (!agentToUse) {
+        throw new Error("Agent ID is required");
+      }
+      const agentObj = mastra.getAgent(agentToUse);
+      if (!agentObj) {
+        throw new Error(`Agent ${agentToUse} not found`);
+      }
+      const result = await agentObj.network(messages, {
+        ...defaultOptions,
+        ...rest
+      });
+      const uiMessageStream = createUIMessageStream({
+        execute: async ({ writer }) => {
+          for await (const part of toAISdkFormat(result, { from: "network" })) {
+            writer.write(part);
+          }
+        }
+      });
+      return createUIMessageStreamResponse({ stream: uiMessageStream });
+    }
+  });
+}
 
-export { WorkflowStreamToAISDKTransformer, chatRoute, toAISdkFormat };
+export { chatRoute, networkRoute, toAISdkFormat, workflowRoute };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map