@mastra/client-js 1.9.0-alpha.3 → 1.9.1-alpha.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mastra/client-js
 
+## 1.9.1-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`cb611a1`](https://github.com/mastra-ai/mastra/commit/cb611a1e89a4f4cf74c97b57e0c27bb56f2eceb5), [`b71bce1`](https://github.com/mastra-ai/mastra/commit/b71bce144912ed33f76c52a94e594988a649c3e1), [`62d1d3c`](https://github.com/mastra-ai/mastra/commit/62d1d3cc08fe8182e7080237fd975de862ec8c91), [`8681ecb`](https://github.com/mastra-ai/mastra/commit/8681ecb86184d5907267000e4576cc442a9a83fc), [`28d0249`](https://github.com/mastra-ai/mastra/commit/28d0249295782277040ad1e0d243e695b7ab1ce4), [`bb0f09d`](https://github.com/mastra-ai/mastra/commit/bb0f09dbac58401b36069f483acf5673202db5b5), [`5f7e9d0`](https://github.com/mastra-ai/mastra/commit/5f7e9d0db664020e1f3d97d7d18c6b0b9d4843d0)]:
+  - @mastra/core@1.15.0-alpha.0
+  - @mastra/schema-compat@1.2.6-alpha.0
+
+## 1.9.0
+
+### Minor Changes
+
+- Added new observability API endpoints and client methods for logs, scores, feedback, metrics (aggregate, breakdown, time series, percentiles), and discovery (metric names, label keys/values, entity types/names, service names, environments, tags) ([#14270](https://github.com/mastra-ai/mastra/pull/14270))
+
+### Patch Changes
+
+- Updated dependencies [[`51970b3`](https://github.com/mastra-ai/mastra/commit/51970b3828494d59a8dd4df143b194d37d31e3f5), [`4444280`](https://github.com/mastra-ai/mastra/commit/444428094253e916ec077e66284e685fde67021e), [`4a7ce05`](https://github.com/mastra-ai/mastra/commit/4a7ce05125b8d3d260f68f1fc4a6c6866d22ba24), [`085e371`](https://github.com/mastra-ai/mastra/commit/085e3718a7d0fe9a210fe7dd1c867b9bdfe8d16b), [`b77aa19`](https://github.com/mastra-ai/mastra/commit/b77aa1981361c021f2c881bee8f0c703687f00da), [`dbb879a`](https://github.com/mastra-ai/mastra/commit/dbb879af0b809c668e9b3a9d8bac97d806caa267), [`8b4ce84`](https://github.com/mastra-ai/mastra/commit/8b4ce84aed0808b9805cc4fd7147c1f8a2ef7a36), [`8d4cfe6`](https://github.com/mastra-ai/mastra/commit/8d4cfe6b9a7157d3876206227ec9f04cde6dbc4a), [`dd6ca1c`](https://github.com/mastra-ai/mastra/commit/dd6ca1cdea3b8b6182f4cf61df41070ba0cc0deb), [`ce26fe2`](https://github.com/mastra-ai/mastra/commit/ce26fe2166dd90254f8bee5776e55977143e97de), [`68a019d`](https://github.com/mastra-ai/mastra/commit/68a019d30d22251ddd628a2947d60215c03c350a), [`4cb4edf`](https://github.com/mastra-ai/mastra/commit/4cb4edf3c909d197ec356c1790d13270514ffef6), [`8de3555`](https://github.com/mastra-ai/mastra/commit/8de355572c6fd838f863a3e7e6fe24d0947b774f), [`b26307f`](https://github.com/mastra-ai/mastra/commit/b26307f050df39629511b0e831b8fc26973ce8b1), [`68a019d`](https://github.com/mastra-ai/mastra/commit/68a019d30d22251ddd628a2947d60215c03c350a)]:
+  - @mastra/core@1.14.0
+  - @mastra/schema-compat@1.2.5
+
 ## 1.9.0-alpha.3
 
 ### Patch Changes

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-client-js
 description: Documentation for @mastra/client-js. Use when working with @mastra/client-js APIs, configuration, or implementation.
 metadata:
   package: "@mastra/client-js"
-  version: "1.9.0-alpha.3"
+  version: "1.9.1-alpha.0"
 ---
 
 ## When to use
@@ -16,12 +16,12 @@ Read the individual reference documents for detailed explanations and code examp
 
 ### Docs
 
-- [MastraAuthAuth0 class](references/docs-server-auth-auth0.md) - Documentation for the MastraAuthAuth0 class, which authenticates Mastra applications using Auth0 authentication.
-- [MastraAuthClerk class](references/docs-server-auth-clerk.md) - Documentation for the MastraAuthClerk class, which authenticates Mastra applications using Clerk authentication.
-- [MastraAuthFirebase class](references/docs-server-auth-firebase.md) - Documentation for the MastraAuthFirebase class, which authenticates Mastra applications using Firebase Authentication.
-- [MastraJwtAuth class](references/docs-server-auth-jwt.md) - Documentation for the MastraJwtAuth class, which authenticates Mastra applications using JSON Web Tokens.
-- [MastraAuthSupabase class](references/docs-server-auth-supabase.md) - Documentation for the MastraAuthSupabase class, which authenticates Mastra applications using Supabase Auth.
-- [MastraAuthWorkos class](references/docs-server-auth-workos.md) - Documentation for the MastraAuthWorkos class, which authenticates Mastra applications using WorkOS authentication.
+- [Auth0](references/docs-server-auth-auth0.md) - Documentation for the @mastra/auth-auth0 package, which authenticates Mastra applications using Auth0 authentication.
+- [Clerk](references/docs-server-auth-clerk.md) - Documentation for the `@mastra/auth-clerk` package, which authenticates Mastra applications using Clerk authentication.
+- [Firebase](references/docs-server-auth-firebase.md) - Documentation for the `@mastra/auth-firebase` package, which authenticates Mastra applications using Firebase Authentication.
+- [JSON Web Token](references/docs-server-auth-jwt.md) - Documentation for JSON Web Token usage inside Mastra.
+- [Supabase](references/docs-server-auth-supabase.md) - Documentation for the `@mastra/auth-supabase` package, which authenticates Mastra applications using Supabase Auth.
+- [WorkOS](references/docs-server-auth-workos.md) - Documentation for the `@mastra/auth-workos` package, which authenticates Mastra applications using WorkOS authentication.
 - [Mastra client SDK](references/docs-server-mastra-client.md) - Learn how to set up and use the Mastra Client SDK
 
 ### Reference

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.9.0-alpha.3",
+  "version": "1.9.1-alpha.0",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-server-auth-auth0.md

@@ -1,6 +1,6 @@
-# MastraAuthAuth0 class
+# Auth0
 
-The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `auth` option.
+The `@mastra/auth-auth0` package provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -24,10 +24,30 @@ AUTH0_AUDIENCE=your-api-identifier
 
 Before you can use the `MastraAuthAuth0` class you have to install the `@mastra/auth-auth0` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-auth0@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-auth0@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-auth0@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-auth0@latest
+```
+
 ## Usage examples
 
 ### Basic usage with environment variables
@@ -93,10 +113,30 @@ When using Auth0 auth, you'll need to set up the Auth0 React SDK, authenticate u
 
 First, install and configure the Auth0 React SDK in your application:
 
+**npm**:
+
 ```bash
 npm install @auth0/auth0-react
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @auth0/auth0-react
+```
+
+**Yarn**:
+
+```bash
+yarn add @auth0/auth0-react
+```
+
+**Bun**:
+
+```bash
+bun add @auth0/auth0-react
+```
+
 ```typescript
 import React from 'react'
 import { Auth0Provider } from '@auth0/auth0-react'

package/dist/docs/references/docs-server-auth-clerk.md

@@ -1,6 +1,6 @@
-# MastraAuthClerk class
+# Clerk
 
-The `MastraAuthClerk` class provides authentication for Mastra using Clerk. It verifies incoming requests using Clerk's authentication system and integrates with the Mastra server using the `auth` option.
+The `@mastra/auth-clerk` package provides authentication for Mastra using Clerk. It verifies incoming requests using Clerk's authentication system and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -18,10 +18,30 @@ CLERK_JWKS_URI=https://your-clerk-domain.clerk.accounts.dev/.well-known/jwks.jso
 
 Before you can use the `MastraAuthClerk` class you have to install the `@mastra/auth-clerk` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-clerk@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-clerk@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-clerk@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-clerk@latest
+```
+
 ## Usage example
 
 ```typescript

package/dist/docs/references/docs-server-auth-firebase.md

@@ -1,6 +1,6 @@
-# MastraAuthFirebase class
+# Firebase
 
-The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `auth` option.
+The `@mastra/auth-firebase` package provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -24,10 +24,30 @@ FIRESTORE_DATABASE_ID=(default)
 
 Before you can use the `MastraAuthFirebase` class you have to install the `@mastra/auth-firebase` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-firebase@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-firebase@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-firebase@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-firebase@latest
+```
+
 ## Usage examples
 
 ### Basic usage with environment variables

package/dist/docs/references/docs-server-auth-jwt.md

@@ -1,4 +1,4 @@
-# MastraJwtAuth class
+# JSON Web Token
 
 The `MastraJwtAuth` class provides a lightweight authentication mechanism for Mastra using JSON Web Tokens (JWTs). It verifies incoming requests based on a shared secret and integrates with the Mastra server using the `auth` option.
 
@@ -30,8 +30,22 @@ yarn add @mastra/auth@latest
 bun add @mastra/auth@latest
 ```
 
+## Creating a JWT
+
+To authenticate requests to your Mastra server, you'll need a valid JSON Web Token (JWT) signed with your `MASTRA_JWT_SECRET`.
+
+The easiest way to generate one is using [jwt.io](https://www.jwt.io/):
+
+1. Select **JWT Encoder**.
+2. Scroll down to the **Sign JWT: Secret** section.
+3. Enter your secret (for example: `supersecretdevkeythatishs256safe!`).
+4. Click **Generate example** to create a valid JWT.
+5. Copy the generated token and set it as `MASTRA_JWT_TOKEN` in your `.env` file.
+
 ## Usage example
 
+Take your generated JWT and use it to configure `MastraJwtAuth` in your Mastra server:
+
 ```typescript
 import { Mastra } from '@mastra/core'
 import { MastraJwtAuth } from '@mastra/auth'
@@ -47,6 +61,8 @@ export const mastra = new Mastra({
 
 > **Info:** Visit [MastraJwtAuth](https://mastra.ai/reference/auth/jwt) for all available configuration options.
 
+Inside [Studio](https://mastra.ai/docs/getting-started/studio), go to **Settings** and under **Headers** select the **"Add Header"** button. Enter `Authorization` as the header name and `Bearer <your-jwt>` as the value.
+
 ## Configuring `MastraClient`
 
 When `auth` is enabled, all requests made with `MastraClient` must include a valid JWT in the `Authorization` header:
@@ -95,16 +111,4 @@ curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
   -d '{
     "messages": "Weather in London"
   }'
-```
-
-## Creating a JWT
-
-To authenticate requests to your Mastra server, you'll need a valid JSON Web Token (JWT) signed with your `MASTRA_JWT_SECRET`.
-
-The easiest way to generate one is using [jwt.io](https://www.jwt.io/):
-
-1. Select **JWT Encoder**.
-2. Scroll down to the **Sign JWT: Secret** section.
-3. Enter your secret (for example: `supersecretdevkeythatishs256safe!`).
-4. Click **Generate example** to create a valid JWT.
-5. Copy the generated token and set it as `MASTRA_JWT_TOKEN` in your `.env` file.
+```

package/dist/docs/references/docs-server-auth-supabase.md

@@ -1,6 +1,6 @@
-# MastraAuthSupabase class
+# Supabase
 
-The `MastraAuthSupabase` class provides authentication for Mastra using Supabase Auth. It verifies incoming requests using Supabase's authentication system and integrates with the Mastra server using the `auth` option.
+The `@mastra/auth-supabase` package provides authentication for Mastra using Supabase Auth. It verifies incoming requests using Supabase's authentication system and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -17,10 +17,30 @@ SUPABASE_ANON_KEY=your-anon-key
 
 Before you can use the `MastraAuthSupabase` class you have to install the `@mastra/auth-supabase` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-supabase@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-supabase@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-supabase@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-supabase@latest
+```
+
 ## Usage example
 
 ```typescript

package/dist/docs/references/docs-server-auth-workos.md

@@ -1,6 +1,6 @@
-# MastraAuthWorkos class
+# WorkOS
 
-The `MastraAuthWorkos` class provides authentication for Mastra using WorkOS. It verifies incoming requests using WorkOS access tokens and integrates with the Mastra server using the `auth` option.
+The `@mastra/auth-workos` package provides authentication for Mastra using WorkOS. It verifies incoming requests using WorkOS access tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -24,10 +24,30 @@ WORKOS_CLIENT_ID=client_...
 
 Before you can use the `MastraAuthWorkos` class you have to install the `@mastra/auth-workos` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-workos@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-workos@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-workos@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-workos@latest
+```
+
 ## Usage examples
 
 ### Basic usage with environment variables
@@ -94,10 +114,30 @@ When using WorkOS auth, you'll need to implement the WorkOS authentication flow
 
 First, install the WorkOS SDK in your application:
 
+**npm**:
+
 ```bash
 npm install @workos-inc/node
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @workos-inc/node
+```
+
+**Yarn**:
+
+```bash
+yarn add @workos-inc/node
+```
+
+**Bun**:
+
+```bash
+bun add @workos-inc/node
+```
+
 ### Exchanging code for access token
 
 After users complete the WorkOS authentication flow and return with an authorization code, exchange it for an access token:

package/dist/docs/references/reference-ai-sdk-to-ai-sdk-stream.md

@@ -4,6 +4,8 @@ Converts Mastra streams (agent, network, or workflow) to AI SDK-compatible strea
 
 This is useful when building custom streaming endpoints outside Mastra's provided route helpers such as [`chatRoute()`](https://mastra.ai/reference/ai-sdk/chat-route) or [`workflowRoute()`](https://mastra.ai/reference/ai-sdk/workflow-route).
 
+`toAISdkStream()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'` in the options object.
+
 ## Usage example
 
 Next.js App Router example:
@@ -45,6 +47,8 @@ The first parameter is the Mastra stream to convert. It can be one of:
 
 The second parameter is an options object:
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **from** (`'agent' | 'network' | 'workflow'`): The type of Mastra stream being converted. (Default: `'agent'`)
 
 **lastMessageId** (`string`): (Agent only) The ID of the last message in the conversation.
@@ -152,6 +156,36 @@ export async function POST(req: Request) {
 }
 ```
 
+### Converting an agent stream for AI SDK v6
+
+```typescript
+import { mastra } from '../../mastra'
+import { createUIMessageStream, createUIMessageStreamResponse } from 'ai'
+import { toAISdkStream } from '@mastra/ai-sdk'
+
+export async function POST(req: Request) {
+  const { messages } = await req.json()
+  const myAgent = mastra.getAgent('weatherAgent')
+  const stream = await myAgent.stream(messages)
+
+  const uiMessageStream = createUIMessageStream({
+    originalMessages: messages,
+    execute: async ({ writer }) => {
+      for await (const part of toAISdkStream(stream, {
+        from: 'agent',
+        version: 'v6',
+      })) {
+        await writer.write(part)
+      }
+    },
+  })
+
+  return createUIMessageStreamResponse({
+    stream: uiMessageStream,
+  })
+}
+```
+
 ### Using `messageMetadata`
 
 ```typescript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "1.9.0-alpha.3",
+  "version": "1.9.1-alpha.0",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -37,8 +37,8 @@
     "@ai-sdk/ui-utils": "^1.2.11",
     "@lukeed/uuid": "^2.0.1",
     "json-schema": "^0.4.0",
-    "@mastra/core": "1.14.0-alpha.3",
-    "@mastra/schema-compat": "1.2.5-alpha.0"
+    "@mastra/core": "1.15.0-alpha.0",
+    "@mastra/schema-compat": "1.2.6-alpha.0"
   },
   "peerDependencies": {
     "zod": "^3.25.0 || ^4.0.0"
@@ -53,10 +53,10 @@
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
     "zod": "^4.3.6",
-    "@internal/ai-sdk-v5": "0.0.18",
-    "@internal/ai-sdk-v4": "0.0.18",
-    "@internal/types-builder": "0.0.46",
-    "@internal/lint": "0.0.71"
+    "@internal/ai-sdk-v4": "0.0.19",
+    "@internal/ai-sdk-v5": "0.0.19",
+    "@internal/lint": "0.0.72",
+    "@internal/types-builder": "0.0.47"
   },
   "engines": {
     "node": ">=22.13.0"