@mastra/ai-sdk 0.1.1 → 0.2.0-alpha.1

package/dist/index.cjs

@@ -317,6 +317,18 @@ function convertFullStreamChunkToUIMessageStream({
           toolCallId: part.toolCallId,
           payload: part.output
         };
+      } else if (part.output.from === "WORKFLOW") {
+        return {
+          type: "tool-workflow",
+          toolCallId: part.toolCallId,
+          payload: part.output
+        };
+      } else if (part.output.from === "NETWORK") {
+        return {
+          type: "tool-network",
+          toolCallId: part.toolCallId,
+          payload: part.output
+        };
       }
       return;
     }
@@ -374,96 +386,42 @@ function convertFullStreamChunkToUIMessageStream({
   }
 }
 
-// src/to-ai-sdk-format.ts
+// src/transformers.ts
 function WorkflowStreamToAISDKTransformer() {
-  const steps = {};
+  const bufferedWorkflows = /* @__PURE__ */ new Map();
   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) {
-      let workflowName = "";
-      if (chunk.type === "workflow-start") {
-        workflowName = chunk.payload.workflowId;
-        controller.enqueue({
-          data: JSON.stringify({
-            type: "data-workflow",
-            id: chunk.runId,
-            data: {
-              name: workflowName,
-              status: "running",
-              steps: {},
-              output: null
-            }
-          })
-        });
-      } else if (chunk.type === "workflow-step-start") {
-        steps[chunk.payload.id] = {
-          // TODO swap with name
-          name: chunk.payload.id,
-          status: chunk.payload.status,
-          input: chunk.payload.payload ?? null,
-          output: null
-        };
-        controller.enqueue({
-          data: JSON.stringify({
-            type: "data-workflow",
-            id: chunk.runId,
-            data: {
-              name: workflowName,
-              status: "running",
-              steps,
-              output: null
-            }
-          })
-        });
-      } else if (chunk.type === "workflow-step-result") {
-        steps[chunk.payload.id] = {
-          ...steps[chunk.payload.id],
-          status: chunk.payload.status,
-          output: chunk.payload.output ?? null
-        };
-        controller.enqueue({
-          data: JSON.stringify({
-            type: "data-workflow",
-            id: chunk.runId,
-            data: {
-              name: workflowName,
-              status: "running",
-              steps,
-              output: null
-            }
-          })
-        });
-      } else if (chunk.type === "workflow-finish") {
-        controller.enqueue({
-          data: JSON.stringify({
-            type: "data-workflow",
-            id: chunk.runId,
-            data: {
-              name: workflowName,
-              steps,
-              output: chunk.payload.output ?? null,
-              status: chunk.payload.workflowStatus
-            }
-          })
-        });
-      }
+      const transformed = transformNetwork(chunk, bufferedNetworks);
+      if (transformed) controller.enqueue(transformed);
     }
   });
 }
@@ -488,6 +446,14 @@ function AgentStreamToAISDKTransformer() {
           const payload = transformedChunk.payload;
           const agentTransformed = transformAgent(payload, bufferedSteps);
           if (agentTransformed) controller.enqueue(agentTransformed);
+        } else if (transformedChunk.type === "tool-workflow") {
+          const payload = transformedChunk.payload;
+          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, true);
+          if (networkChunk) controller.enqueue(networkChunk);
         } else {
           controller.enqueue(transformedChunk);
         }
@@ -631,8 +597,278 @@ function transformAgent(payload, bufferedSteps) {
   }
   return null;
 }
-function toAISdkFormat(stream) {
-  return stream.fullStream.pipeThrough(AgentStreamToAISDKTransformer());
+function transformWorkflow(payload, bufferedWorkflows, isNested) {
+  switch (payload.type) {
+    case "workflow-start":
+      bufferedWorkflows.set(payload.runId, {
+        name: payload.payload.workflowId,
+        steps: {}
+      });
+      return {
+        type: isNested ? "data-tool-workflow" : "data-workflow",
+        id: payload.runId,
+        data: {
+          name: bufferedWorkflows.get(payload.runId).name,
+          status: "running",
+          steps: bufferedWorkflows.get(payload.runId).steps,
+          output: null
+        }
+      };
+    case "workflow-step-start": {
+      const current = bufferedWorkflows.get(payload.runId) || { name: "", steps: {} };
+      current.steps[payload.payload.id] = {
+        name: payload.payload.id,
+        status: payload.payload.status,
+        input: payload.payload.payload ?? null,
+        output: null
+      };
+      bufferedWorkflows.set(payload.runId, current);
+      return {
+        type: isNested ? "data-tool-workflow" : "data-workflow",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          output: null
+        }
+      };
+    }
+    case "workflow-step-result": {
+      const current = bufferedWorkflows.get(payload.runId);
+      if (!current) return null;
+      current.steps[payload.payload.id] = {
+        ...current.steps[payload.payload.id],
+        status: payload.payload.status,
+        output: payload.payload.output ?? null
+      };
+      return {
+        type: isNested ? "data-tool-workflow" : "data-workflow",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          output: null
+        }
+      };
+    }
+    case "workflow-finish": {
+      const current = bufferedWorkflows.get(payload.runId);
+      if (!current) return null;
+      return {
+        type: isNested ? "data-tool-workflow" : "data-workflow",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          steps: current.steps,
+          output: payload.payload.output ?? null,
+          status: payload.payload.workflowStatus
+        }
+      };
+    }
+    default:
+      return null;
+  }
+}
+function transformNetwork(payload, bufferedNetworks, isNested) {
+  switch (payload.type) {
+    case "routing-agent-start": {
+      if (!bufferedNetworks.has(payload.payload.runId)) {
+        bufferedNetworks.set(payload.payload.runId, {
+          name: payload.payload.agentId,
+          steps: []
+        });
+      }
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.payload.runId,
+        data: {
+          name: bufferedNetworks.get(payload.payload.runId).name,
+          status: "running",
+          steps: bufferedNetworks.get(payload.payload.runId).steps,
+          output: null
+        }
+      };
+    }
+    case "agent-execution-start": {
+      const current = bufferedNetworks.get(payload.payload.runId) || { name: "", steps: [] };
+      current.steps.push({
+        name: payload.payload.agentId,
+        status: "running",
+        input: payload.payload.args || null,
+        output: null
+      });
+      bufferedNetworks.set(payload.payload.runId, current);
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          output: null
+        }
+      };
+    }
+    case "workflow-execution-start": {
+      const current = bufferedNetworks.get(payload.payload.runId) || { name: "", steps: [] };
+      current.steps.push({
+        name: payload.payload.name,
+        status: "running",
+        input: payload.payload.args || null,
+        output: null
+      });
+      bufferedNetworks.set(payload.payload.runId, current);
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          output: null
+        }
+      };
+    }
+    case "tool-execution-start": {
+      const current = bufferedNetworks.get(payload.payload.runId) || { name: "", steps: [] };
+      current.steps.push({
+        name: payload.payload.args?.toolName,
+        status: "running",
+        input: payload.payload.args?.args || null,
+        output: null
+      });
+      bufferedNetworks.set(payload.payload.runId, current);
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          output: null
+        }
+      };
+    }
+    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: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          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: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          status: "running",
+          steps: current.steps,
+          output: payload.payload.result ?? null
+        }
+      };
+    }
+    case "routing-agent-end": {
+      const current = bufferedNetworks.get(payload.payload.runId);
+      if (!current) return null;
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.payload.runId,
+        data: {
+          name: current.name,
+          status: "finished",
+          steps: current.steps,
+          output: payload.payload?.result ?? null
+        }
+      };
+    }
+    case "network-execution-event-step-finish": {
+      const current = bufferedNetworks.get(payload.payload.runId);
+      if (!current) return null;
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.payload.runId,
+        data: {
+          name: current.name,
+          status: "finished",
+          steps: current.steps,
+          output: payload.payload?.result ?? null
+        }
+      };
+    }
+    case "network-execution-event-finish": {
+      const current = bufferedNetworks.get(payload.runId);
+      if (!current) return null;
+      return {
+        type: isNested ? "data-tool-network" : "data-network",
+        id: payload.runId,
+        data: {
+          name: current.name,
+          status: "finished",
+          steps: current.steps,
+          output: payload.payload?.result ?? null
+        }
+      };
+    }
+    default:
+      return null;
+  }
+}
+
+// src/to-ai-sdk-format.ts
+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
@@ -740,6 +976,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");
@@ -750,6 +987,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");
       }
@@ -759,11 +999,12 @@ function chatRoute({
       }
       const result = await agentObj.stream(messages, {
         ...defaultOptions,
-        ...rest
+        ...rest,
+        runtimeContext: runtimeContext || defaultOptions?.runtimeContext
       });
       const uiMessageStream = ai.createUIMessageStream({
         execute: async ({ writer }) => {
-          for await (const part of toAISdkFormat(result)) {
+          for await (const part of toAISdkFormat(result, { from: "agent" })) {
             writer.write(part);
           }
         }
@@ -774,9 +1015,186 @@ 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 server.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 = ai.createUIMessageStream({
+        execute: async ({ writer }) => {
+          for await (const part of toAISdkFormat(stream, { from: "workflow" })) {
+            writer.write(part);
+          }
+        }
+      });
+      return ai.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 server.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 = ai.createUIMessageStream({
+        execute: async ({ writer }) => {
+          for await (const part of toAISdkFormat(result, { from: "network" })) {
+            writer.write(part);
+          }
+        }
+      });
+      return ai.createUIMessageStreamResponse({ stream: uiMessageStream });
+    }
+  });
+}
 
-exports.WorkflowStreamToAISDKTransformer = WorkflowStreamToAISDKTransformer;
 exports.chatRoute = chatRoute;
+exports.networkRoute = networkRoute;
 exports.toAISdkFormat = toAISdkFormat;
+exports.workflowRoute = workflowRoute;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map