@mastra/client-js 1.7.3 → 1.8.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @mastra/client-js
 
+## 1.8.0-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`866cc2c`](https://github.com/mastra-ai/mastra/commit/866cc2cb1f0e3b314afab5194f69477fada745d1), [`6bcbf8a`](https://github.com/mastra-ai/mastra/commit/6bcbf8a6774d5a53b21d61db8a45ce2593ca1616), [`18c3a90`](https://github.com/mastra-ai/mastra/commit/18c3a90c9e48cf69500e308affeb8eba5860b2af), [`f35487b`](https://github.com/mastra-ai/mastra/commit/f35487bb2d46c636e22aa71d90025613ae38235a), [`6dc2192`](https://github.com/mastra-ai/mastra/commit/6dc21921aef0f0efab15cd0805fa3d18f277a76f), [`eeb3a3f`](https://github.com/mastra-ai/mastra/commit/eeb3a3f43aca10cf49479eed2a84b7d9ecea02ba), [`05f8d90`](https://github.com/mastra-ai/mastra/commit/05f8d9009290ce6aa03428b3add635268615db85), [`4b8da97`](https://github.com/mastra-ai/mastra/commit/4b8da97a5ce306e97869df6c39535d9069e563db), [`256df35`](https://github.com/mastra-ai/mastra/commit/256df3571d62beb3ad4971faa432927cc140e603)]:
+  - @mastra/core@1.11.0-alpha.1
+
+## 1.8.0-alpha.0
+
+### Minor Changes
+
+- Added `requestContext` field to dataset item API endpoints and `requestContextSchema` to dataset CRUD endpoints. Added `requestContext` option to the experiment trigger endpoint, which gets forwarded to agent execution during experiments. ([#13938](https://github.com/mastra-ai/mastra/pull/13938))
+
+  **Usage with `@mastra/client-js`:**
+
+  ```ts
+  // Create a dataset with a request context schema
+  await client.createDataset({
+    name: 'my-dataset',
+    requestContextSchema: {
+      type: 'object',
+      properties: { region: { type: 'string' } },
+    },
+  });
+
+  // Add an item with request context
+  await client.addDatasetItem({
+    datasetId: 'my-dataset',
+    input: { prompt: 'Hello' },
+    requestContext: { region: 'us-east-1' },
+  });
+
+  // Trigger an experiment with request context forwarded to agent
+  await client.triggerDatasetExperiment({
+    datasetId: 'my-dataset',
+    agentId: 'my-agent',
+    requestContext: { region: 'eu-west-1' },
+  });
+  ```
+
+### Patch Changes
+
+- Fixed @mastra/client-js streaming APIs to expose standard Web Streams types in public declarations for browser consumers. ([#14079](https://github.com/mastra-ai/mastra/pull/14079))
+
+- Updated dependencies [[`4f71b43`](https://github.com/mastra-ai/mastra/commit/4f71b436a4a6b8839842d8da47b57b84509af56c), [`a070277`](https://github.com/mastra-ai/mastra/commit/a07027766ce195ba74d0783116d894cbab25d44c), [`b628b91`](https://github.com/mastra-ai/mastra/commit/b628b9128b372c0f54214d902b07279f03443900), [`332c014`](https://github.com/mastra-ai/mastra/commit/332c014e076b81edf7fe45b58205882726415e90), [`6b63153`](https://github.com/mastra-ai/mastra/commit/6b63153878ea841c0f4ce632ba66bb33e57e9c1b), [`4246e34`](https://github.com/mastra-ai/mastra/commit/4246e34cec9c26636d0965942268e6d07c346671), [`b8837ee`](https://github.com/mastra-ai/mastra/commit/b8837ee77e2e84197609762bfabd8b3da326d30c), [`fb58ce1`](https://github.com/mastra-ai/mastra/commit/fb58ce1de85d57f142005c4b3b7559f909167a3f), [`5d950f7`](https://github.com/mastra-ai/mastra/commit/5d950f7bf426a215a1808f0abef7de5c8336ba1c), [`28c85b1`](https://github.com/mastra-ai/mastra/commit/28c85b184fc32b40f7f160483c982da6d388ecbd), [`e9a08fb`](https://github.com/mastra-ai/mastra/commit/e9a08fbef1ada7e50e961e2f54f55e8c10b4a45c), [`631ffd8`](https://github.com/mastra-ai/mastra/commit/631ffd82fed108648b448b28e6a90e38c5f53bf5), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`aa61f29`](https://github.com/mastra-ai/mastra/commit/aa61f29ff8095ce46a4ae16e46c4d8c79b2b685b), [`7ff3714`](https://github.com/mastra-ai/mastra/commit/7ff37148515439bb3be009a60e02c3e363299760), [`41d79a1`](https://github.com/mastra-ai/mastra/commit/41d79a14bd8cb6de1e2565fd0a04786bae2f211b), [`e673376`](https://github.com/mastra-ai/mastra/commit/e6733763ad1321aa7e5ae15096b9c2104f93b1f3), [`b2204c9`](https://github.com/mastra-ai/mastra/commit/b2204c98a42848bbfb6f0440f005dc2b6354f1cd), [`a1bf1e3`](https://github.com/mastra-ai/mastra/commit/a1bf1e385ed4c0ef6f11b56c5887442970d127f2), [`b6f647a`](https://github.com/mastra-ai/mastra/commit/b6f647ae2388e091f366581595feb957e37d5b40), [`0c57b8b`](https://github.com/mastra-ai/mastra/commit/0c57b8b0a69a97b5a4ae3f79be6c610f29f3cf7b), [`b081f27`](https://github.com/mastra-ai/mastra/commit/b081f272cf411716e1d6bd72ceac4bcee2657b19), [`0c09eac`](https://github.com/mastra-ai/mastra/commit/0c09eacb1926f64cfdc9ae5c6d63385cf8c9f72c), [`6b9b93d`](https://github.com/mastra-ai/mastra/commit/6b9b93d6f459d1ba6e36f163abf62a085ddb3d64), [`31b6067`](https://github.com/mastra-ai/mastra/commit/31b6067d0cc3ab10e1b29c36147f3b5266bc714a), [`797ac42`](https://github.com/mastra-ai/mastra/commit/797ac4276de231ad2d694d9aeca75980f6cd0419), [`aae2295`](https://github.com/mastra-ai/mastra/commit/aae2295838a2d329ad6640829e87934790ffe5b8), [`0bc289e`](https://github.com/mastra-ai/mastra/commit/0bc289e2d476bf46c5b91c21969e8d0c6864691c), [`9b75a06`](https://github.com/mastra-ai/mastra/commit/9b75a06e53ebb0b950ba7c1e83a0142047185f46), [`4c3a1b1`](https://github.com/mastra-ai/mastra/commit/4c3a1b122ea083e003d71092f30f3b31680b01c0), [`85cc3b3`](https://github.com/mastra-ai/mastra/commit/85cc3b3b6f32ae4b083c26498f50d5b250ba944b), [`97ea28c`](https://github.com/mastra-ai/mastra/commit/97ea28c746e9e4147d56047bbb1c4a92417a3fec), [`d567299`](https://github.com/mastra-ai/mastra/commit/d567299cf81e02bd9d5221d4bc05967d6c224161), [`716ffe6`](https://github.com/mastra-ai/mastra/commit/716ffe68bed81f7c2690bc8581b9e140f7bf1c3d), [`8296332`](https://github.com/mastra-ai/mastra/commit/8296332de21c16e3dfc3d0b2d615720a6dc88f2f), [`4df2116`](https://github.com/mastra-ai/mastra/commit/4df211619dd922c047d396ca41cd7027c8c4c8e7), [`2219c1a`](https://github.com/mastra-ai/mastra/commit/2219c1acbd21da116da877f0036ffb985a9dd5a3), [`17c4145`](https://github.com/mastra-ai/mastra/commit/17c4145166099354545582335b5252bdfdfd908b)]:
+  - @mastra/core@1.11.0-alpha.0
+  - @mastra/schema-compat@1.2.0-alpha.0
+
 ## 1.7.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.7.3"
+  version: "1.8.0-alpha.1"
 ---
 
 ## When to use
@@ -16,13 +16,13 @@ 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.
-- [Mastra Client SDK](references/docs-server-mastra-client.md) - Learn how to set up and use the Mastra Client SDK
+- [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.
+- [Mastra client SDK](references/docs-server-mastra-client.md) - Learn how to set up and use the Mastra Client SDK
 
 ### Reference
 
@@ -30,9 +30,9 @@ Read the individual reference documents for detailed explanations and code examp
 - [Reference: toAISdkV4Messages()](references/reference-ai-sdk-to-ai-sdk-v4-messages.md) - API reference for toAISdkV4Messages(), a function to convert Mastra messages to AI SDK v4 UI messages.
 - [Reference: toAISdkV5Messages()](references/reference-ai-sdk-to-ai-sdk-v5-messages.md) - API reference for toAISdkV5Messages(), a function to convert Mastra messages to AI SDK v5 UI messages.
 - [Reference: Agents API](references/reference-client-js-agents.md) - Learn how to interact with Mastra AI agents, including generating responses, streaming interactions, and managing agent tools using the client-js SDK.
-- [Reference: Error Handling](references/reference-client-js-error-handling.md) - Learn about the built-in retry mechanism and error handling capabilities in the Mastra client-js SDK.
+- [Reference: Error handling](references/reference-client-js-error-handling.md) - Learn about the built-in retry mechanism and error handling capabilities in the Mastra client-js SDK.
 - [Reference: Logs API](references/reference-client-js-logs.md) - Learn how to access and query system logs and debugging information in Mastra using the client-js SDK.
-- [Reference: Mastra Client SDK](references/reference-client-js-mastra-client.md) - Learn how to interact with Mastra using the client-js SDK.
+- [Reference: Mastra client SDK](references/reference-client-js-mastra-client.md) - Learn how to interact with Mastra using the client-js SDK.
 - [Reference: Memory API](references/reference-client-js-memory.md) - Learn how to manage conversation threads and message history in Mastra using the client-js SDK.
 - [Reference: Observability API](references/reference-client-js-observability.md) - Learn how to retrieve traces, monitor application performance, and score traces using the client-js SDK.
 - [Reference: Telemetry API](references/reference-client-js-telemetry.md) - Learn how to retrieve and analyze traces from your Mastra application for monitoring and debugging using the client-js SDK.

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.7.3",
+  "version": "1.8.0-alpha.1",
   "package": "@mastra/client-js",
   "exports": {},
   "modules": {}

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

@@ -1,4 +1,4 @@
-# MastraAuthAuth0 Class
+# MastraAuthAuth0 class
 
 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.
 
@@ -66,7 +66,7 @@ export const mastra = new Mastra({
 By default, `MastraAuthAuth0` allows all authenticated users who have valid Auth0 tokens for the specified audience. The token verification ensures that:
 
 1. The token is properly signed by Auth0
-2. The token is not expired
+2. The token isn't expired
 3. The token audience matches your configured audience
 4. The token issuer matches your Auth0 domain
 

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

@@ -1,4 +1,4 @@
-# MastraAuthClerk Class
+# MastraAuthClerk class
 
 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.
 

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

@@ -1,4 +1,4 @@
-# MastraAuthFirebase Class
+# MastraAuthFirebase class
 
 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.
 
@@ -66,12 +66,12 @@ export const mastra = new Mastra({
 
 The `MastraAuthFirebase` class can be configured through constructor options or environment variables.
 
-### Environment Variables
+### Environment variables
 
 - `FIREBASE_SERVICE_ACCOUNT`: Path to Firebase service account JSON file
 - `FIRESTORE_DATABASE_ID` or `FIREBASE_DATABASE_ID`: Firestore database ID
 
-> **Note:** When constructor options are not provided, the class automatically reads these environment variables. This means you can simply call `new MastraAuthFirebase()` without any arguments if your environment variables are properly configured.
+> **Note:** When constructor options aren't provided, the class automatically reads these environment variables. This means you can call `new MastraAuthFirebase()` without any arguments if your environment variables are properly configured.
 
 ### User Authorization
 

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

@@ -1,4 +1,4 @@
-# MastraJwtAuth Class
+# MastraJwtAuth class
 
 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.
 

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

@@ -1,4 +1,4 @@
-# MastraAuthSupabase Class
+# MastraAuthSupabase class
 
 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.
 

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

@@ -1,4 +1,4 @@
-# MastraAuthWorkos Class
+# MastraAuthWorkos class
 
 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.
 

package/dist/docs/references/docs-server-mastra-client.md

@@ -1,6 +1,6 @@
-# Mastra Client SDK
+# Mastra client SDK
 
-The Mastra Client SDK provides a simple and type-safe interface for interacting with your [Mastra Server](https://mastra.ai/docs/server/mastra-server) from your client environment.
+The Mastra Client SDK provides a concise and type-safe interface for interacting with your [Mastra Server](https://mastra.ai/docs/server/mastra-server) from your client environment.
 
 ## Prerequisites
 

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

@@ -152,7 +152,7 @@ export async function POST(req: Request) {
 }
 ```
 
-### Using messageMetadata
+### Using `messageMetadata`
 
 ```typescript
 import { mastra } from '../../mastra'

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

@@ -57,7 +57,7 @@ Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
 
 ## Examples
 
-### Converting simple text messages
+### Converting text messages
 
 ```typescript
 import { toAISdkV4Messages } from '@mastra/ai-sdk'

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

@@ -54,7 +54,7 @@ Returns an array of AI SDK V5+ `UIMessage` objects with the following structure:
 
 ## Examples
 
-### Converting simple text messages
+### Converting text messages
 
 ```typescript
 import { toAISdkV5Messages } from '@mastra/ai-sdk/ui'

package/dist/docs/references/reference-client-js-agents.md

@@ -2,7 +2,7 @@
 
 The Agents API provides methods to interact with Mastra AI agents, including generating responses, streaming interactions, and managing agent tools.
 
-## Getting All Agents
+## Getting all agents
 
 Retrieve a list of all available agents:
 
@@ -12,7 +12,7 @@ const agents = await mastraClient.listAgents()
 
 Returns a record of agent IDs to their serialized agent configurations.
 
-## Working with a Specific Agent
+## Working with a specific agent
 
 Get an instance of a specific agent by its ID:
 
@@ -26,9 +26,9 @@ export const myAgent = new Agent({
 const agent = mastraClient.getAgent('my-agent')
 ```
 
-## Agent Methods
+## Agent methods
 
-### details()
+### `details()`
 
 Retrieve detailed information about an agent:
 
@@ -36,7 +36,7 @@ Retrieve detailed information about an agent:
 const details = await agent.details()
 ```
 
-### generate()
+### `generate()`
 
 Generate a response from the agent:
 
@@ -69,7 +69,7 @@ const response = await agent.generate('Hello, how are you?', {
 })
 ```
 
-### stream()
+### `stream()`
 
 Stream responses from the agent for real-time interactions:
 
@@ -151,7 +151,7 @@ for await (const part of uiMessageStream) {
 }
 ```
 
-### getTool()
+### `getTool()`
 
 Retrieve information about a specific tool available to the agent:
 
@@ -159,7 +159,7 @@ Retrieve information about a specific tool available to the agent:
 const tool = await agent.getTool('tool-id')
 ```
 
-### executeTool()
+### `executeTool()`
 
 Execute a specific tool for the agent:
 
@@ -169,7 +169,7 @@ const result = await agent.executeTool('tool-id', {
 })
 ```
 
-### network()
+### `network()`
 
 Stream responses from an agent network for multi-agent interactions:
 
@@ -183,7 +183,7 @@ response.processDataStream({
 })
 ```
 
-### approveToolCall()
+### `approveToolCall()`
 
 Approve a pending tool call that requires human confirmation:
 
@@ -200,7 +200,7 @@ response.processDataStream({
 })
 ```
 
-### declineToolCall()
+### `declineToolCall()`
 
 Decline a pending tool call that requires human confirmation:
 
@@ -217,7 +217,7 @@ response.processDataStream({
 })
 ```
 
-### approveToolCallGenerate()
+### `approveToolCallGenerate()`
 
 Approve a pending tool call when using `generate()` (non-streaming). Returns the complete response:
 
@@ -236,7 +236,7 @@ if (output.finishReason === 'suspended') {
 }
 ```
 
-### declineToolCallGenerate()
+### `declineToolCallGenerate()`
 
 Decline a pending tool call when using `generate()` (non-streaming). Returns the complete response:
 
@@ -255,7 +255,7 @@ if (output.finishReason === 'suspended') {
 }
 ```
 
-## Client Tools
+## Client tools
 
 Client-side tools allow you to execute custom functions on the client side when the agent requests them.
 
@@ -306,11 +306,11 @@ response.processDataStream({
 })
 ```
 
-## Stored Agents
+## Stored agents
 
 Stored agents are agent configurations stored in a database that can be created, updated, and deleted at runtime. They reference primitives (tools, workflows, other agents, memory, scorers) by key, which are resolved from the Mastra registry when the agent is instantiated.
 
-### listStoredAgents()
+### `listStoredAgents()`
 
 Retrieve a paginated list of all stored agents:
 
@@ -333,7 +333,7 @@ const result = await mastraClient.listStoredAgents({
 })
 ```
 
-### createStoredAgent()
+### `createStoredAgent()`
 
 Create a new stored agent:
 
@@ -380,7 +380,7 @@ const agent = await mastraClient.createStoredAgent({
 })
 ```
 
-### getStoredAgent()
+### `getStoredAgent()`
 
 Get an instance of a specific stored agent:
 
@@ -388,9 +388,9 @@ Get an instance of a specific stored agent:
 const storedAgent = mastraClient.getStoredAgent('my-agent')
 ```
 
-## Stored Agent Methods
+## Stored agent methods
 
-### details()
+### `details()`
 
 Retrieve the stored agent configuration:
 
@@ -401,7 +401,7 @@ console.log(details.instructions)
 console.log(details.model)
 ```
 
-### update()
+### `update()`
 
 Update specific fields of a stored agent. All fields are optional:
 
@@ -427,7 +427,7 @@ await storedAgent.update({
 })
 ```
 
-### delete()
+### `delete()`
 
 Delete a stored agent:
 

package/dist/docs/references/reference-client-js-error-handling.md

@@ -1,8 +1,8 @@
-# Error Handling
+# Error handling
 
 The Mastra Client SDK includes built-in retry mechanism and error handling capabilities.
 
-## Error Handling
+## Error handling
 
 All API methods can throw errors that you can catch and handle:
 

package/dist/docs/references/reference-client-js-logs.md

@@ -2,7 +2,7 @@
 
 The Logs API provides methods to access and query system logs and debugging information in Mastra.
 
-## Getting Logs
+## Getting logs
 
 Retrieve system logs with optional filtering:
 
@@ -12,7 +12,7 @@ const logs = await mastraClient.listLogs({
 })
 ```
 
-## Getting Logs for a Specific Run
+## Getting logs for a specific run
 
 Retrieve logs for a specific execution run:
 

package/dist/docs/references/reference-client-js-mastra-client.md

@@ -1,6 +1,6 @@
-# Mastra Client SDK
+# Mastra client SDK
 
-The Mastra Client SDK provides a simple and type-safe interface for interacting with your [Mastra Server](https://mastra.ai/docs/deployment/mastra-server) from your client environment.
+The Mastra Client SDK provides a type-safe interface for interacting with your [Mastra Server](https://mastra.ai/docs/deployment/mastra-server) from your client environment.
 
 ## Usage example
 

package/dist/docs/references/reference-client-js-memory.md

@@ -2,7 +2,7 @@
 
 The Memory API provides methods to manage conversation threads and message history in Mastra.
 
-## Get All Threads
+## Get all threads
 
 Retrieve all memory threads for a specific resource:
 
@@ -15,7 +15,7 @@ const threads = await mastraClient.getMemoryThreads({
 
 When `agentId` is omitted and storage is configured on the server, threads will be retrieved using storage directly. This is useful when multiple agents share the same threads (e.g., in workflows with multiple agent steps).
 
-## Create a New Thread
+## Create a new thread
 
 Create a new memory thread:
 
@@ -28,7 +28,7 @@ const thread = await mastraClient.createMemoryThread({
 })
 ```
 
-## Working with a Specific Thread
+## Working with a specific thread
 
 Get an instance of a specific memory thread:
 
@@ -36,7 +36,7 @@ Get an instance of a specific memory thread:
 const thread = mastraClient.getMemoryThread({ threadId: 'thread-id', agentId: 'agent-id' })
 ```
 
-## Thread Methods
+## Thread methods
 
 ### Get Thread Details
 
@@ -105,7 +105,7 @@ The clone response includes:
 - `thread`: The newly created cloned thread with clone metadata
 - `clonedMessages`: Array of the cloned messages with new IDs
 
-## Message Operations
+## Message operations
 
 ### Save Messages
 
@@ -168,7 +168,7 @@ const result = await thread.deleteMessages(['message-1', 'message-2', 'message-3
 // Returns: { success: true, message: "Message deleted successfully" }
 ```
 
-## Working Memory
+## Working memory
 
 Working memory allows agents to maintain persistent information about users across interactions. It can be scoped to either a specific thread or across all threads for a resource (user).
 

package/dist/docs/references/reference-client-js-observability.md

@@ -2,7 +2,7 @@
 
 The Observability API provides methods to retrieve traces, monitor your application's performance, and score traces for evaluation. This helps you understand how your AI agents and workflows are performing.
 
-## Getting a Specific Trace
+## Getting a specific trace
 
 Retrieve a specific trace by its ID, including all its spans and details:
 
@@ -10,7 +10,7 @@ Retrieve a specific trace by its ID, including all its spans and details:
 const trace = await mastraClient.getTrace('trace-id-123')
 ```
 
-## Getting Traces with Filtering
+## Getting traces with filtering
 
 Retrieve a paginated list of trace root spans with optional filtering:
 
@@ -39,7 +39,7 @@ console.log(`Total pages: ${traces.pagination.totalPages}`)
 const completeTrace = await mastraClient.getTrace(traces.spans[0].traceId)
 ```
 
-## Scoring Traces
+## Scoring traces
 
 Score specific traces using registered scorers for evaluation:
 
@@ -53,7 +53,7 @@ const result = await mastraClient.score({
 })
 ```
 
-## Getting Scores by Span
+## Getting scores by span
 
 Retrieve scores for a specific span within a trace:
 

package/dist/docs/references/reference-client-js-telemetry.md

@@ -2,7 +2,7 @@
 
 The Telemetry API provides methods to retrieve and analyze traces from your Mastra application. This helps you monitor and debug your application's behavior and performance.
 
-## Getting Traces
+## Getting traces
 
 Retrieve traces with optional filtering and pagination:
 

package/dist/docs/references/reference-client-js-tools.md

@@ -2,7 +2,7 @@
 
 The Tools API provides methods to interact with and execute tools available in the Mastra platform.
 
-## Getting All Tools
+## Getting all tools
 
 Retrieve a list of all available tools:
 
@@ -10,7 +10,7 @@ Retrieve a list of all available tools:
 const tools = await mastraClient.listTools()
 ```
 
-## Working with a Specific Tool
+## Working with a specific tool
 
 Get an instance of a specific tool:
 
@@ -18,7 +18,7 @@ Get an instance of a specific tool:
 const tool = mastraClient.getTool('tool-id')
 ```
 
-## Tool Methods
+## Tool methods
 
 ### Get Tool Details
 

package/dist/docs/references/reference-client-js-vectors.md

@@ -2,7 +2,7 @@
 
 The Vectors API provides methods to work with vector embeddings for semantic search and similarity matching in Mastra.
 
-## Working with Vectors
+## Working with vectors
 
 Get an instance of a vector store:
 
@@ -10,7 +10,7 @@ Get an instance of a vector store:
 const vector = mastraClient.getVector('vector-name')
 ```
 
-## Vector Methods
+## Vector methods
 
 ### Get Vector Index Details