@mastra/ai-sdk 1.3.3 → 1.4.0-alpha.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { chatRoute, handleChatStream } from './chat-route.js';
-export type { chatRouteOptions, ChatStreamHandlerParams, ChatStreamHandlerOptions } from './chat-route.js';
+export type { chatRouteOptions, ChatStreamHandlerParams, ChatStreamHandlerOptions, AgentVersionOptions, } from './chat-route.js';
 export { workflowRoute, handleWorkflowStream } from './workflow-route.js';
 export type { WorkflowRouteOptions, WorkflowStreamHandlerParams, WorkflowStreamHandlerOptions } from './workflow-route.js';
 export type { WorkflowDataPart } from './transformers.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACxH,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACpH,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAGhH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC3D,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACxH,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACpH,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAGhH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -11975,6 +11975,9 @@ function convertFullStreamChunkToUIMessageStream({
       };
     }
     case "reasoning-start": {
+      if (!sendReasoning) {
+        return;
+      }
       return {
         type: "reasoning-start",
         id: part.id,
@@ -11993,6 +11996,9 @@ function convertFullStreamChunkToUIMessageStream({
       return;
     }
     case "reasoning-end": {
+      if (!sendReasoning) {
+        return;
+      }
       return {
         type: "reasoning-end",
         id: part.id,
@@ -13149,6 +13155,7 @@ function toAISdkStream(stream, options = {
 async function handleChatStream({
   mastra,
   agentId,
+  agentVersion,
   params,
   defaultOptions: defaultOptions3,
   version = "v5",
@@ -13163,7 +13170,7 @@ async function handleChatStream({
   if (resumeData && !runId) {
     throw new Error("runId is required when resumeData is provided");
   }
-  const agentObj = mastra.getAgentById(agentId);
+  const agentObj = agentVersion ? await mastra.getAgentById(agentId, agentVersion) : mastra.getAgentById(agentId);
   if (!agentObj) {
     throw new Error(`Agent ${agentId} not found`);
   }
@@ -13239,6 +13246,7 @@ function chatRoute({
   agent,
   defaultOptions: defaultOptions3,
   version = "v5",
+  agentVersion,
   sendStart = true,
   sendFinish = true,
   sendReasoning = false,
@@ -13262,6 +13270,25 @@ function chatRoute({
           schema: {
             type: "string"
           }
+        },
+        {
+          name: "versionId",
+          in: "query",
+          required: false,
+          description: "Specific agent version ID to use. Mutually exclusive with status.",
+          schema: {
+            type: "string"
+          }
+        },
+        {
+          name: "status",
+          in: "query",
+          required: false,
+          description: "Which stored config version to resolve: draft (latest) or published (active version). Mutually exclusive with versionId.",
+          schema: {
+            type: "string",
+            enum: ["draft", "published"]
+          }
         }
       ],
       requestBody: {
@@ -13369,9 +13396,20 @@ function chatRoute({
       if (!agentToUse) {
         throw new Error("Agent ID is required");
       }
+      const queryVersionId = c.req.query("versionId");
+      const rawStatus = c.req.query("status");
+      if (queryVersionId && rawStatus) {
+        throw new Error('Query parameters "versionId" and "status" are mutually exclusive');
+      }
+      if (rawStatus && rawStatus !== "draft" && rawStatus !== "published") {
+        throw new Error('Query parameter "status" must be "draft" or "published"');
+      }
+      const queryStatus = rawStatus;
+      const effectiveAgentVersion = queryVersionId ? { versionId: queryVersionId } : queryStatus ? { status: queryStatus } : agentVersion;
       const handlerOptions = {
         mastra,
         agentId: agentToUse,
+        agentVersion: effectiveAgentVersion,
         params: {
           ...params,
           requestContext: effectiveRequestContext,
@@ -13543,12 +13581,13 @@ function workflowRoute({
 async function handleNetworkStream({
   mastra,
   agentId,
+  agentVersion,
   params,
   defaultOptions: defaultOptions3,
   version = "v5"
 }) {
   const { messages, ...rest } = params;
-  const agentObj = mastra.getAgentById(agentId);
+  const agentObj = agentVersion ? await mastra.getAgentById(agentId, agentVersion) : mastra.getAgentById(agentId);
   if (!agentObj) {
     throw new Error(`Agent ${agentId} not found`);
   }
@@ -13585,7 +13624,8 @@ function networkRoute({
   path = "/network/:agentId",
   agent,
   defaultOptions: defaultOptions3,
-  version = "v5"
+  version = "v5",
+  agentVersion
 }) {
   if (!agent && !path.includes("/:agentId")) {
     throw new Error("Path must include :agentId to route to the correct agent or pass the agent explicitly");
@@ -13603,6 +13643,20 @@ function networkRoute({
           required: true,
           description: "The ID of the routing agent to execute as a network",
           schema: { type: "string" }
+        },
+        {
+          name: "versionId",
+          in: "query",
+          required: false,
+          description: "Specific agent version ID to use. Mutually exclusive with status.",
+          schema: { type: "string" }
+        },
+        {
+          name: "status",
+          in: "query",
+          required: false,
+          description: "Which stored config version to resolve: draft (latest) or published (active version). Mutually exclusive with versionId.",
+          schema: { type: "string", enum: ["draft", "published"] }
         }
       ],
       requestBody: {
@@ -13631,6 +13685,14 @@ function networkRoute({
           description: "Streaming AI SDK UIMessage event stream for the agent network",
           content: { "text/plain": { schema: { type: "string", description: "SSE stream" } } }
         },
+        "400": {
+          description: "Bad request - invalid input",
+          content: {
+            "application/json": {
+              schema: { type: "object", properties: { error: { type: "string" } } }
+            }
+          }
+        },
         "404": {
           description: "Agent not found",
           content: {
@@ -13662,9 +13724,20 @@ function networkRoute({
       if (!agentToUse) {
         throw new Error("Agent ID is required");
       }
+      const queryVersionId = c.req.query("versionId");
+      const rawStatus = c.req.query("status");
+      if (queryVersionId && rawStatus) {
+        throw new Error('Query parameters "versionId" and "status" are mutually exclusive');
+      }
+      if (rawStatus && rawStatus !== "draft" && rawStatus !== "published") {
+        throw new Error('Query parameter "status" must be "draft" or "published"');
+      }
+      const queryStatus = rawStatus;
+      const effectiveAgentVersion = queryVersionId ? { versionId: queryVersionId } : queryStatus ? { status: queryStatus } : agentVersion;
       const handlerOptions = {
         mastra,
         agentId: agentToUse,
+        agentVersion: effectiveAgentVersion,
         params: {
           ...params,
           requestContext: effectiveRequestContext