@mastra/ai-sdk 0.2.0-alpha.0 → 0.2.0-alpha.2

package/dist/index.js

@@ -390,24 +390,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({
+        type: "start"
       });
+    },
+    flush(controller) {
       controller.enqueue({
-        data: "[DONE]"
+        type: "finish"
       });
     },
     transform(chunk, controller) {
-      const transformed = transformWorkflow(chunk, bufferedWorkflows);
+      const transformed = transformNetwork(chunk, bufferedNetworks);
       if (transformed) controller.enqueue(transformed);
     }
   });
@@ -435,11 +446,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 +595,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 +603,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 +622,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 +641,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 +655,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,
@@ -658,15 +669,17 @@ function transformWorkflow(payload, bufferedWorkflows) {
       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,
@@ -686,7 +699,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 +719,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 +739,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 +749,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 +813,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 +827,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 +841,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,
@@ -813,8 +857,16 @@ function transformNetwork(payload, bufferedNetworks) {
 }
 
 // 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
@@ -922,6 +974,7 @@ function chatRoute({
     handler: async (c) => {
       const { messages, ...rest } = await c.req.json();
       const mastra = c.get("mastra");
+      const runtimeContext = c.get("runtimeContext");
       let agentToUse = agent;
       if (!agent) {
         const agentId = c.req.param("agentId");
@@ -932,6 +985,9 @@ function chatRoute({
           `Fixed agent ID was set together with an agentId path parameter. This can lead to unexpected behavior.`
         );
       }
+      if (runtimeContext && defaultOptions?.runtimeContext) {
+        mastra.getLogger()?.warn(`"runtimeContext" set in the route options will be overridden by the request's "runtimeContext".`);
+      }
       if (!agentToUse) {
         throw new Error("Agent ID is required");
       }
@@ -941,11 +997,12 @@ function chatRoute({
       }
       const result = await agentObj.stream(messages, {
         ...defaultOptions,
-        ...rest
+        ...rest,
+        runtimeContext: runtimeContext || defaultOptions?.runtimeContext
       });
       const uiMessageStream = createUIMessageStream({
         execute: async ({ writer }) => {
-          for await (const part of toAISdkFormat(result)) {
+          for await (const part of toAISdkFormat(result, { from: "agent" })) {
             writer.write(part);
           }
         }
@@ -956,7 +1013,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