@mastra/ai-sdk 0.0.1-alpha.0

package/.turbo/turbo-build.log

@@ -0,0 +1,18 @@
+
+> @mastra/ai-sdk@0.0.1-alpha.0 build /home/runner/work/mastra/mastra/client-sdks/ai-sdk
+> tsup --config tsup.config.ts
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.0
+CLI Using tsup config: /home/runner/work/mastra/mastra/client-sdks/ai-sdk/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+CJS Build start
+CJS dist/index.cjs     3.77 KB
+CJS dist/index.cjs.map 7.61 KB
+CJS ⚡️ Build success in 542ms
+ESM dist/index.js     3.75 KB
+ESM dist/index.js.map 7.59 KB
+ESM ⚡️ Build success in 543ms

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @mastra/ai-sdk
+
+## 0.0.1-alpha.0
+
+### Patch Changes
+
+- [#7263](https://github.com/mastra-ai/mastra/pull/7263) [`9beaeff`](https://github.com/mastra-ai/mastra/commit/9beaeffa4a97b1d5fd01a7f8af8708b16067f67c) Thanks [@wardpeet](https://github.com/wardpeet)! - Create new `@mastra/ai-sdk` package to better support `useChat()`
+
+- Updated dependencies [[`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715), [`ff89505`](https://github.com/mastra-ai/mastra/commit/ff895057c8c7e91a5535faef46c5e5391085ddfa), [`183dc95`](https://github.com/mastra-ai/mastra/commit/183dc95596f391b977bd1a2c050b8498dac74891), [`a1111e2`](https://github.com/mastra-ai/mastra/commit/a1111e24e705488adfe5e0a6f20c53bddf26cb22), [`61debef`](https://github.com/mastra-ai/mastra/commit/61debefd80ad3a7ed5737e19df6a23d40091689a), [`9beaeff`](https://github.com/mastra-ai/mastra/commit/9beaeffa4a97b1d5fd01a7f8af8708b16067f67c), [`9eee594`](https://github.com/mastra-ai/mastra/commit/9eee594e35e0ca2a650fcc33fa82009a142b9ed0), [`979912c`](https://github.com/mastra-ai/mastra/commit/979912cfd180aad53287cda08af771df26454e2c), [`7dcf4c0`](https://github.com/mastra-ai/mastra/commit/7dcf4c04f44d9345b1f8bc5d41eae3f11ac61611), [`ad78bfc`](https://github.com/mastra-ai/mastra/commit/ad78bfc4ea6a1fff140432bf4f638e01af7af668), [`0ce418a`](https://github.com/mastra-ai/mastra/commit/0ce418a1ccaa5e125d4483a9651b635046152569), [`8387952`](https://github.com/mastra-ai/mastra/commit/838795227b4edf758c84a2adf6f7fba206c27719), [`5eca5d2`](https://github.com/mastra-ai/mastra/commit/5eca5d2655788863ea0442a46c9ef5d3c6dbe0a8)]:
+  - @mastra/core@0.15.3-alpha.4

package/LICENSE.md

@@ -0,0 +1,15 @@
+# Apache License 2.0
+
+Copyright (c) 2025 Kepler Software, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,55 @@
+# @mastra/ai-sdk
+
+`@mastra/ai-sdk` helps you setup custom API routes to more easily support [`useChat()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat).
+
+## Installation
+
+```bash
+npm install @mastra/ai-sdk
+```
+
+## Usage
+
+If you want to use dynamic agents you can use a path with `:agentId`.
+
+```typescript
+import { chatRoute } from '@mastra/ai-sdk';
+
+export const mastra = new Mastra({
+  server: {
+    apiRoutes: [
+      chatRoute({
+        path: '/chat/:agentId',
+      }),
+    ],
+  },
+});
+```
+
+Or you can create a fixed route (i.e. `/chat`):
+
+```typescript
+import { chatRoute } from '@mastra/ai-sdk';
+
+export const mastra = new Mastra({
+  server: {
+    apiRoutes: [
+      chatRoute({
+        path: '/chat',
+        agent: 'weatherAgent',
+      }),
+    ],
+  },
+});
+```
+
+After defining a dynamic route with `:agentId` you can use the `useChat()` hook like so:
+
+```typescript
+type MyMessage = {};
+const { error, status, sendMessage, messages, regenerate, stop } = useChat<MyMessage>({
+  transport: new DefaultChatTransport({
+    api: 'http://localhost:4111/chat/weatherAgent',
+  }),
+});
+```

package/dist/index.cjs

@@ -0,0 +1,139 @@
+'use strict';
+
+var server = require('@mastra/core/server');
+
+// src/index.ts
+function chatRoute({
+  path = "/chat/: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: "Chat with an agent",
+      description: "Send messages to an agent and stream the response in the AI SDK format",
+      tags: ["ai-sdk"],
+      parameters: [
+        {
+          name: "agentId",
+          in: "path",
+          required: true,
+          description: "The ID of the agent to chat with",
+          schema: {
+            type: "string"
+          }
+        }
+      ],
+      requestBody: {
+        required: true,
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                messages: {
+                  type: "array",
+                  description: "Array of messages in the conversation",
+                  items: {
+                    type: "object",
+                    properties: {
+                      role: {
+                        type: "string",
+                        enum: ["user", "assistant", "system"],
+                        description: "The role of the message sender"
+                      },
+                      content: {
+                        type: "string",
+                        description: "The content of the message"
+                      }
+                    },
+                    required: ["role", "content"]
+                  }
+                }
+              },
+              required: ["messages"]
+            }
+          }
+        }
+      },
+      responses: {
+        "200": {
+          description: "Streaming response from the agent",
+          content: {
+            "text/plain": {
+              schema: {
+                type: "string",
+                description: "Server-sent events stream containing the agent response"
+              }
+            }
+          }
+        },
+        "400": {
+          description: "Bad request - invalid input",
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  error: {
+                    type: "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "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.streamVNext(messages, {
+        ...defaultOptions,
+        ...rest,
+        format: "aisdk"
+      });
+      return result.toUIMessageStreamResponse();
+    }
+  });
+}
+
+exports.chatRoute = chatRoute;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["registerApiRoute"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { AgentExecutionOptions } from '@mastra/core/agent';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { OutputSchema } from '@mastra/core/stream';\nimport type { JSONSchema7 } from 'json-schema';\nimport type { ZodSchema } from 'zod/v3';\nimport type { ZodAny } from 'zod/v4';\n\nexport type chatRouteOptions<\n  OUTPUT extends OutputSchema | undefined = undefined,\n  STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined,\n> = {\n  defaultOptions?: AgentExecutionOptions<OUTPUT, STRUCTURED_OUTPUT, 'aisdk'>;\n} & (\n  | {\n      path: `${string}:agentId${string}`;\n      agent?: never;\n    }\n  | {\n      path: string;\n      agent: string;\n    }\n);\n\nexport function chatRoute<\n  OUTPUT extends OutputSchema | undefined = undefined,\n  STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined,\n>({\n  path = '/chat/:agentId',\n  agent,\n  defaultOptions,\n}: chatRouteOptions<OUTPUT, STRUCTURED_OUTPUT>): ReturnType<typeof registerApiRoute> {\n  if (!agent && !path.includes('/:agentId')) {\n    throw new Error('Path must include :agentId to route to the correct agent or pass the agent explicitly');\n  }\n\n  return registerApiRoute(path, {\n    method: 'POST',\n    openapi: {\n      summary: 'Chat with an agent',\n      description: 'Send messages to an agent and stream the response in the AI SDK format',\n      tags: ['ai-sdk'],\n      parameters: [\n        {\n          name: 'agentId',\n          in: 'path',\n          required: true,\n          description: 'The ID of the agent to chat with',\n          schema: {\n            type: 'string',\n          },\n        },\n      ],\n      requestBody: {\n        required: true,\n        content: {\n          'application/json': {\n            schema: {\n              type: 'object',\n              properties: {\n                messages: {\n                  type: 'array',\n                  description: 'Array of messages in the conversation',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      role: {\n                        type: 'string',\n                        enum: ['user', 'assistant', 'system'],\n                        description: 'The role of the message sender',\n                      },\n                      content: {\n                        type: 'string',\n                        description: 'The content of the message',\n                      },\n                    },\n                    required: ['role', 'content'],\n                  },\n                },\n              },\n              required: ['messages'],\n            },\n          },\n        },\n      },\n      responses: {\n        '200': {\n          description: 'Streaming response from the agent',\n          content: {\n            'text/plain': {\n              schema: {\n                type: 'string',\n                description: 'Server-sent events stream containing the agent response',\n              },\n            },\n          },\n        },\n        '400': {\n          description: 'Bad request - invalid input',\n          content: {\n            'application/json': {\n              schema: {\n                type: 'object',\n                properties: {\n                  error: {\n                    type: 'string',\n                  },\n                },\n              },\n            },\n          },\n        },\n        '404': {\n          description: 'Agent not found',\n          content: {\n            'application/json': {\n              schema: {\n                type: 'object',\n                properties: {\n                  error: {\n                    type: 'string',\n                  },\n                },\n              },\n            },\n          },\n        },\n      },\n    },\n    handler: async c => {\n      const { messages, ...rest } = await c.req.json();\n      const mastra = c.get('mastra');\n\n      let agentToUse: string | undefined = agent;\n      if (!agent) {\n        const agentId = c.req.param('agentId');\n        agentToUse = agentId;\n      }\n\n      if (c.req.param('agentId') && agent) {\n        mastra\n          .getLogger()\n          ?.warn(\n            `Fixed agent ID was set together with an agentId path parameter. This can lead to unexpected behavior.`,\n          );\n      }\n\n      if (!agentToUse) {\n        throw new Error('Agent ID is required');\n      }\n\n      const agentObj = mastra.getAgent(agentToUse);\n      if (!agentObj) {\n        throw new Error(`Agent ${agentToUse} not found`);\n      }\n\n      const result = await agentObj.streamVNext<any, any, 'aisdk'>(messages, {\n        ...defaultOptions,\n        ...rest,\n        format: 'aisdk',\n      });\n\n      return result.toUIMessageStreamResponse();\n    },\n  });\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { AgentExecutionOptions } from '@mastra/core/agent';
+import { registerApiRoute } from '@mastra/core/server';
+import type { OutputSchema } from '@mastra/core/stream';
+import type { JSONSchema7 } from 'json-schema';
+import type { ZodSchema } from 'zod/v3';
+import type { ZodAny } from 'zod/v4';
+export type chatRouteOptions<OUTPUT extends OutputSchema | undefined = undefined, STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined> = {
+    defaultOptions?: AgentExecutionOptions<OUTPUT, STRUCTURED_OUTPUT, 'aisdk'>;
+} & ({
+    path: `${string}:agentId${string}`;
+    agent?: never;
+} | {
+    path: string;
+    agent: string;
+});
+export declare function chatRoute<OUTPUT extends OutputSchema | undefined = undefined, STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined>({ path, agent, defaultOptions, }: chatRouteOptions<OUTPUT, STRUCTURED_OUTPUT>): ReturnType<typeof registerApiRoute>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,MAAM,gBAAgB,CAC1B,MAAM,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EACnD,iBAAiB,SAAS,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,IAChF;IACF,cAAc,CAAC,EAAE,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;CAC5E,GAAG,CACA;IACE,IAAI,EAAE,GAAG,MAAM,WAAW,MAAM,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GACD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CACJ,CAAC;AAEF,wBAAgB,SAAS,CACvB,MAAM,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EACnD,iBAAiB,SAAS,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,EAClF,EACA,IAAuB,EACvB,KAAK,EACL,cAAc,GACf,EAAE,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAsInF"}

package/dist/index.js

@@ -0,0 +1,137 @@
+import { registerApiRoute } from '@mastra/core/server';
+
+// src/index.ts
+function chatRoute({
+  path = "/chat/: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: "Chat with an agent",
+      description: "Send messages to an agent and stream the response in the AI SDK format",
+      tags: ["ai-sdk"],
+      parameters: [
+        {
+          name: "agentId",
+          in: "path",
+          required: true,
+          description: "The ID of the agent to chat with",
+          schema: {
+            type: "string"
+          }
+        }
+      ],
+      requestBody: {
+        required: true,
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                messages: {
+                  type: "array",
+                  description: "Array of messages in the conversation",
+                  items: {
+                    type: "object",
+                    properties: {
+                      role: {
+                        type: "string",
+                        enum: ["user", "assistant", "system"],
+                        description: "The role of the message sender"
+                      },
+                      content: {
+                        type: "string",
+                        description: "The content of the message"
+                      }
+                    },
+                    required: ["role", "content"]
+                  }
+                }
+              },
+              required: ["messages"]
+            }
+          }
+        }
+      },
+      responses: {
+        "200": {
+          description: "Streaming response from the agent",
+          content: {
+            "text/plain": {
+              schema: {
+                type: "string",
+                description: "Server-sent events stream containing the agent response"
+              }
+            }
+          }
+        },
+        "400": {
+          description: "Bad request - invalid input",
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  error: {
+                    type: "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "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.streamVNext(messages, {
+        ...defaultOptions,
+        ...rest,
+        format: "aisdk"
+      });
+      return result.toUIMessageStreamResponse();
+    }
+  });
+}
+
+export { chatRoute };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { AgentExecutionOptions } from '@mastra/core/agent';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { OutputSchema } from '@mastra/core/stream';\nimport type { JSONSchema7 } from 'json-schema';\nimport type { ZodSchema } from 'zod/v3';\nimport type { ZodAny } from 'zod/v4';\n\nexport type chatRouteOptions<\n  OUTPUT extends OutputSchema | undefined = undefined,\n  STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined,\n> = {\n  defaultOptions?: AgentExecutionOptions<OUTPUT, STRUCTURED_OUTPUT, 'aisdk'>;\n} & (\n  | {\n      path: `${string}:agentId${string}`;\n      agent?: never;\n    }\n  | {\n      path: string;\n      agent: string;\n    }\n);\n\nexport function chatRoute<\n  OUTPUT extends OutputSchema | undefined = undefined,\n  STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined,\n>({\n  path = '/chat/:agentId',\n  agent,\n  defaultOptions,\n}: chatRouteOptions<OUTPUT, STRUCTURED_OUTPUT>): ReturnType<typeof registerApiRoute> {\n  if (!agent && !path.includes('/:agentId')) {\n    throw new Error('Path must include :agentId to route to the correct agent or pass the agent explicitly');\n  }\n\n  return registerApiRoute(path, {\n    method: 'POST',\n    openapi: {\n      summary: 'Chat with an agent',\n      description: 'Send messages to an agent and stream the response in the AI SDK format',\n      tags: ['ai-sdk'],\n      parameters: [\n        {\n          name: 'agentId',\n          in: 'path',\n          required: true,\n          description: 'The ID of the agent to chat with',\n          schema: {\n            type: 'string',\n          },\n        },\n      ],\n      requestBody: {\n        required: true,\n        content: {\n          'application/json': {\n            schema: {\n              type: 'object',\n              properties: {\n                messages: {\n                  type: 'array',\n                  description: 'Array of messages in the conversation',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      role: {\n                        type: 'string',\n                        enum: ['user', 'assistant', 'system'],\n                        description: 'The role of the message sender',\n                      },\n                      content: {\n                        type: 'string',\n                        description: 'The content of the message',\n                      },\n                    },\n                    required: ['role', 'content'],\n                  },\n                },\n              },\n              required: ['messages'],\n            },\n          },\n        },\n      },\n      responses: {\n        '200': {\n          description: 'Streaming response from the agent',\n          content: {\n            'text/plain': {\n              schema: {\n                type: 'string',\n                description: 'Server-sent events stream containing the agent response',\n              },\n            },\n          },\n        },\n        '400': {\n          description: 'Bad request - invalid input',\n          content: {\n            'application/json': {\n              schema: {\n                type: 'object',\n                properties: {\n                  error: {\n                    type: 'string',\n                  },\n                },\n              },\n            },\n          },\n        },\n        '404': {\n          description: 'Agent not found',\n          content: {\n            'application/json': {\n              schema: {\n                type: 'object',\n                properties: {\n                  error: {\n                    type: 'string',\n                  },\n                },\n              },\n            },\n          },\n        },\n      },\n    },\n    handler: async c => {\n      const { messages, ...rest } = await c.req.json();\n      const mastra = c.get('mastra');\n\n      let agentToUse: string | undefined = agent;\n      if (!agent) {\n        const agentId = c.req.param('agentId');\n        agentToUse = agentId;\n      }\n\n      if (c.req.param('agentId') && agent) {\n        mastra\n          .getLogger()\n          ?.warn(\n            `Fixed agent ID was set together with an agentId path parameter. This can lead to unexpected behavior.`,\n          );\n      }\n\n      if (!agentToUse) {\n        throw new Error('Agent ID is required');\n      }\n\n      const agentObj = mastra.getAgent(agentToUse);\n      if (!agentObj) {\n        throw new Error(`Agent ${agentToUse} not found`);\n      }\n\n      const result = await agentObj.streamVNext<any, any, 'aisdk'>(messages, {\n        ...defaultOptions,\n        ...rest,\n        format: 'aisdk',\n      });\n\n      return result.toUIMessageStreamResponse();\n    },\n  });\n}\n"]}

package/eslint.config.js

@@ -0,0 +1,6 @@
+import { createConfig } from '@internal/lint/eslint';
+
+const config = await createConfig();
+
+/** @type {import("eslint").Linter.Config[]} */
+export default [...config.map(conf => ({ ...conf, ignores: [...(conf.ignores || []), '**/vitest.perf.config.ts'] }))];

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@mastra/ai-sdk",
+  "version": "0.0.1-alpha.0",
+  "description": "Adds custom API routes to be compatible with the AI SDK UI parts",
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=0.15.3-0 <0.16.0-0",
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "devDependencies": {
+    "@types/json-schema": "^7.0.15",
+    "eslint": "^9.34.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4",
+    "zod": "^3.25.67",
+    "@internal/lint": "0.0.34",
+    "@internal/types-builder": "0.0.9",
+    "@mastra/core": "0.15.3-alpha.4"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "Apache-2.0",
+  "scripts": {
+    "lint": "eslint .",
+    "build": "tsup --config tsup.config.ts",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,165 @@
+import type { AgentExecutionOptions } from '@mastra/core/agent';
+import { registerApiRoute } from '@mastra/core/server';
+import type { OutputSchema } from '@mastra/core/stream';
+import type { JSONSchema7 } from 'json-schema';
+import type { ZodSchema } from 'zod/v3';
+import type { ZodAny } from 'zod/v4';
+
+export type chatRouteOptions<
+  OUTPUT extends OutputSchema | undefined = undefined,
+  STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined,
+> = {
+  defaultOptions?: AgentExecutionOptions<OUTPUT, STRUCTURED_OUTPUT, 'aisdk'>;
+} & (
+  | {
+      path: `${string}:agentId${string}`;
+      agent?: never;
+    }
+  | {
+      path: string;
+      agent: string;
+    }
+);
+
+export function chatRoute<
+  OUTPUT extends OutputSchema | undefined = undefined,
+  STRUCTURED_OUTPUT extends ZodSchema | ZodAny | JSONSchema7 | undefined = undefined,
+>({
+  path = '/chat/:agentId',
+  agent,
+  defaultOptions,
+}: chatRouteOptions<OUTPUT, STRUCTURED_OUTPUT>): ReturnType<typeof registerApiRoute> {
+  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: 'Chat with an agent',
+      description: 'Send messages to an agent and stream the response in the AI SDK format',
+      tags: ['ai-sdk'],
+      parameters: [
+        {
+          name: 'agentId',
+          in: 'path',
+          required: true,
+          description: 'The ID of the agent to chat with',
+          schema: {
+            type: 'string',
+          },
+        },
+      ],
+      requestBody: {
+        required: true,
+        content: {
+          'application/json': {
+            schema: {
+              type: 'object',
+              properties: {
+                messages: {
+                  type: 'array',
+                  description: 'Array of messages in the conversation',
+                  items: {
+                    type: 'object',
+                    properties: {
+                      role: {
+                        type: 'string',
+                        enum: ['user', 'assistant', 'system'],
+                        description: 'The role of the message sender',
+                      },
+                      content: {
+                        type: 'string',
+                        description: 'The content of the message',
+                      },
+                    },
+                    required: ['role', 'content'],
+                  },
+                },
+              },
+              required: ['messages'],
+            },
+          },
+        },
+      },
+      responses: {
+        '200': {
+          description: 'Streaming response from the agent',
+          content: {
+            'text/plain': {
+              schema: {
+                type: 'string',
+                description: 'Server-sent events stream containing the agent response',
+              },
+            },
+          },
+        },
+        '400': {
+          description: 'Bad request - invalid input',
+          content: {
+            'application/json': {
+              schema: {
+                type: 'object',
+                properties: {
+                  error: {
+                    type: 'string',
+                  },
+                },
+              },
+            },
+          },
+        },
+        '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: string | undefined = 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.streamVNext<any, any, 'aisdk'>(messages, {
+        ...defaultOptions,
+        ...rest,
+        format: 'aisdk',
+      });
+
+      return result.toUIMessageStreamResponse();
+    },
+  });
+}

package/tsconfig.build.json

@@ -0,0 +1,9 @@
+{
+  "extends": ["./tsconfig.json", "../../tsconfig.build.json"],
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "**/*.test.ts", "src/**/*.mock.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "../../tsconfig.node.json",
+  "include": ["src/**/*", "tsup.config.ts", "integration-tests/**/*"],
+  "exclude": ["node_modules", "integration-tests/node_modules", "src/example.ts", "**/*.test.ts"]
+}

package/tsup.config.ts

@@ -0,0 +1,17 @@
+import { generateTypes } from '@internal/types-builder';
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm', 'cjs'],
+  clean: true,
+  dts: false,
+  splitting: true,
+  treeshake: {
+    preset: 'smallest',
+  },
+  sourcemap: true,
+  onSuccess: async () => {
+    await generateTypes(process.cwd());
+  },
+});

package/vitest.config.js

@@ -0,0 +1,8 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+    include: ['src/**/*.test.ts'],
+  },
+});