@mastra/client-js 1.8.0-alpha.0 → 1.8.0-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/client-js
 
+## 1.8.0-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`1d0a8a8`](https://github.com/mastra-ai/mastra/commit/1d0a8a8acf33203d5744fc429b090ad8598aa8ed)]:
+  - @mastra/core@1.11.0-alpha.2
+
+## 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

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.8.0-alpha.0"
+  version: "1.8.0-alpha.2"
 ---
 
 ## 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.8.0-alpha.0",
+  "version": "1.8.0-alpha.2",
   "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.
 

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,7 +66,7 @@ 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

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,4 +1,4 @@
-# Mastra Client SDK
+# Mastra client SDK
 
 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.
 

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-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,4 +1,4 @@
-# Mastra Client SDK
+# Mastra client SDK
 
 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.
 

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
 

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

@@ -2,7 +2,7 @@
 
 The Workflows API provides methods to interact with and execute automated workflows in Mastra.
 
-## Getting All Workflows
+## Getting all workflows
 
 Retrieve a list of all available workflows:
 
@@ -10,7 +10,7 @@ Retrieve a list of all available workflows:
 const workflows = await mastraClient.listWorkflows()
 ```
 
-## Working with a Specific Workflow
+## Working with a specific workflow
 
 Get an instance of a specific workflow by its ID:
 
@@ -24,9 +24,9 @@ export const testWorkflow = createWorkflow({
 const workflow = mastraClient.getWorkflow('city-workflow')
 ```
 
-## Workflow Methods
+## Workflow methods
 
-### details()
+### `details()`
 
 Retrieve detailed information about a workflow:
 
@@ -34,7 +34,7 @@ Retrieve detailed information about a workflow:
 const details = await workflow.details()
 ```
 
-### createRun()
+### `createRun()`
 
 Create a new workflow run instance:
 
@@ -53,7 +53,7 @@ const run = await workflow.createRun({
 
 The `resourceId` parameter associates the workflow run with a specific resource (e.g., user ID, tenant ID). This value is persisted with the run and can be used for filtering and querying runs later.
 
-### startAsync()
+### `startAsync()`
 
 Start a workflow run and await the full result:
 
@@ -95,7 +95,7 @@ const result = await run.startAsync({
 })
 ```
 
-### start()
+### `start()`
 
 Start a workflow run without waiting for completion:
 
@@ -114,7 +114,7 @@ const result = await workflow.runById(run.runId)
 
 This is useful for long-running workflows where you want to start execution and check results later.
 
-### resumeAsync()
+### `resumeAsync()`
 
 Resume a suspended workflow step and await the full result:
 
@@ -127,7 +127,7 @@ const result = await run.resumeAsync({
 })
 ```
 
-### resume()
+### `resume()`
 
 Resume a suspended workflow step without waiting for completion:
 
@@ -140,7 +140,7 @@ await run.resume({
 })
 ```
 
-### cancel()
+### `cancel()`
 
 Cancel a running workflow:
 
@@ -155,7 +155,7 @@ This method stops any running steps and prevents subsequent steps from executing
 
 See the [Run.cancel()](https://mastra.ai/reference/workflows/run-methods/cancel) reference for detailed information about how cancellation works and how to write steps that respond to cancellation.
 
-### stream()
+### `stream()`
 
 Stream workflow execution for real-time updates:
 
@@ -173,7 +173,7 @@ for await (const chunk of stream) {
 }
 ```
 
-### runById()
+### `runById()`
 
 Get the execution result for a workflow run:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/client-js",
-  "version": "1.8.0-alpha.0",
+  "version": "1.8.0-alpha.2",
   "description": "The official TypeScript library for the Mastra Client API",
   "author": "",
   "type": "module",
@@ -36,8 +36,8 @@
   "dependencies": {
     "@lukeed/uuid": "^2.0.1",
     "json-schema": "^0.4.0",
-    "@mastra/schema-compat": "1.2.0-alpha.0",
-    "@mastra/core": "1.11.0-alpha.0"
+    "@mastra/core": "1.11.0-alpha.2",
+    "@mastra/schema-compat": "1.2.0-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.13",
     "@internal/lint": "0.0.66",
-    "@internal/types-builder": "0.0.41",
-    "@internal/ai-sdk-v4": "0.0.13"
+    "@internal/ai-sdk-v4": "0.0.13",
+    "@internal/ai-sdk-v5": "0.0.13",
+    "@internal/types-builder": "0.0.41"
   },
   "engines": {
     "node": ">=22.13.0"