@mastra/client-js 1.57.0-alpha.2 → 1.57.0-alpha.4

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.57.0-alpha.2"
+  version: "1.57.0-alpha.4"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/docs/references/docs-harness-schedules.md

@@ -162,6 +162,9 @@ The same operations are available from `@mastra/client-js` over the `/api/schedu
 Hooks let you run code at key points in an agent schedule's lifecycle, for example to compute fire-time parameters or react to the outcome. Configure them on the `Mastra` constructor under `schedules`. The hooks are a single flat bundle that runs for every agent's schedules; each hook context carries the firing `agentId`, so branch on it when you need per-agent behavior. Hooks live at the `Mastra` level so they apply to both code-defined and stored agents.
 
 ```typescript
+import { Mastra } from '@mastra/core'
+import { LibSQLStore } from '@mastra/libsql'
+
 const mastra = new Mastra({
   agents: { pinger },
   storage: new LibSQLStore({ id: 'mastra-storage', url: 'file:./mastra.db' }),

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

@@ -55,7 +55,7 @@ Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
 
 **toolInvocations** (`ToolInvocation[]`): Array of tool invocations for assistant messages.
 
-**experimental\_attachments** (`Attachment[]`): File attachments on the message.
+**experimental_attachments** (`Attachment[]`): File attachments on the message.
 
 **metadata** (`Record<string, unknown>`): Custom metadata attached to the message.
 

package/dist/docs/references/reference-client-js-agent-controller.md

@@ -46,6 +46,9 @@ Each entry's `id` is the key the controller is registered under in `new Mastra({
 Get an instance of an agent controller by the key it's registered under in `new Mastra({ agentControllers })`. The key can differ from the controller's `id`. In this example, pass `'coding'`, not `'coding-controller'`:
 
 ```typescript
+import { Mastra } from '@mastra/core'
+import { AgentController } from '@mastra/core/agent-controller'
+
 const codingController = new AgentController({ id: 'coding-controller', agent, modes })
 
 export const mastra = new Mastra({

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

@@ -21,6 +21,8 @@ Returns a record of agent IDs to their serialized agent configurations.
 Get an instance of a specific agent by its ID:
 
 ```typescript
+import { Agent } from '@mastra/core/agent'
+
 export const myAgent = new Agent({
   id: 'my-agent',
 })

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

@@ -126,11 +126,11 @@ console.log(items.data)
 
 ## Parameters
 
-**agent\_id** (`string`): Required. The registered Mastra agent that owns the conversation memory.
+**agent_id** (`string`): Required. The registered Mastra agent that owns the conversation memory.
 
-**conversation\_id** (`string`): Optional conversation ID to use as the raw thread ID.
+**conversation_id** (`string`): Optional conversation ID to use as the raw thread ID.
 
-**resource\_id** (`string`): Optional resource ID to associate with the conversation thread.
+**resource_id** (`string`): Optional resource ID to associate with the conversation thread.
 
 **title** (`string`): Optional thread title stored with the conversation.
 

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

@@ -198,7 +198,7 @@ The returned response object includes:
 
 ## Parameters
 
-**agent\_id** (`string`): Required on initial requests. Selects the Mastra agent that executes the request. Stored follow-up turns can omit it when continuing with previous\_response\_id.
+**agent_id** (`string`): Required on initial requests. Selects the Mastra agent that executes the request. Stored follow-up turns can omit it when continuing with previous_response_id.
 
 **model** (`string`): Optional model override for this request, such as openai/gpt-5. If omitted, Mastra uses the model configured on the selected agent.
 
@@ -206,7 +206,7 @@ The returned response object includes:
 
 **instructions** (`string`): Optional instruction override for this request.
 
-**text** (`{ format: { type: 'json_object' } | { type: 'json_schema'; name: string; schema: Record<string, unknown>; description?: string; strict?: boolean } }`): Optional text output format. Use json\_object for JSON mode or json\_schema for schema-constrained structured output.
+**text** (`{ format: { type: 'json_object' } | { type: 'json_schema'; name: string; schema: Record<string, unknown>; description?: string; strict?: boolean } }`): Optional text output format. Use json_object for JSON mode or json_schema for schema-constrained structured output.
 
 **providerOptions** (`Record<string, Record<string, unknown> | undefined>`): Optional provider-specific options passed through to the underlying model call.
 
@@ -214,8 +214,8 @@ The returned response object includes:
 
 **store** (`boolean`): When true, persists the response through the selected agent memory.
 
-**conversation\_id** (`string`): Optional conversation identifier. In Mastra, this is the raw memory thread ID.
+**conversation_id** (`string`): Optional conversation identifier. In Mastra, this is the raw memory thread ID.
 
-**previous\_response\_id** (`string`): Continues a stored response chain from a previous stored response.
+**previous_response_id** (`string`): Continues a stored response chain from a previous stored response.
 
 **requestContext** (`RequestContext | Record<string, any>`): Optional request context forwarded to the Mastra server.

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

@@ -32,6 +32,8 @@ The server may cache the counts for a few seconds between requests. Servers that
 Get an instance of a specific workflow by its ID:
 
 ```typescript
+import { createWorkflow } from '@mastra/core/workflows'
+
 export const testWorkflow = createWorkflow({
   id: 'city-workflow',
 })

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -20,7 +20,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let _lukeed_uuid = require("@lukeed/uuid");
 let _mastra_core_error = require("@mastra/core/error");
 let _mastra_core_request_context = require("@mastra/core/request-context");
@@ -31,7 +30,7 @@ let _mastra_core_a2a_v1 = require("@mastra/core/a2a/v1");
 let canonicalize = require("canonicalize");
 canonicalize = __toESM(canonicalize, 1);
 let jose = require("jose");
-//#region src/observability/collector.ts
+// src/observability/collector.ts
 const TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
 const ZERO_TRACE_ID = "00000000000000000000000000000000";
 const ZERO_SPAN_ID = "0000000000000000";
@@ -230,8 +229,7 @@ var ObservabilityCollectorImpl = class {
 * `@mastra/client-js/observability` subpath.
 */
 const createObservabilityCollector = (parentContext) => new ObservabilityCollectorImpl(parentContext);
-//#endregion
-//#region src/utils/index.ts
+// src/utils/index.ts
 /**
 * Normalizes a route path to ensure consistent formatting.
 * - Removes leading/trailing whitespace
@@ -419,8 +417,7 @@ function isTerminalReconnectError(error) {
 	const status = error?.status;
 	return isTerminalHttpError(error) && status !== 408 && status !== 429;
 }
-//#endregion
-//#region src/utils/ai-sdk-v4/data-stream-parts.ts
+// src/utils/ai-sdk-v4/data-stream-parts.ts
 const dataStreamParts = [
 	{
 		code: "0",
@@ -633,8 +630,7 @@ const parseDataStreamPart = (line) => {
 	const jsonValue = JSON.parse(textValue);
 	return dataStreamPartsByCode[code].parse(jsonValue);
 };
-//#endregion
-//#region src/utils/ai-sdk-v4/fix-json.ts
+// src/utils/ai-sdk-v4/fix-json.ts
 function fixJson(input) {
 	const stack = ["ROOT"];
 	let lastValidIndex = -1;
@@ -870,8 +866,7 @@ function fixJson(input) {
 	}
 	return result;
 }
-//#endregion
-//#region src/utils/ai-sdk-v4/parse-partial-json.ts
+// src/utils/ai-sdk-v4/parse-partial-json.ts
 function tryParse(text) {
 	try {
 		return {
@@ -902,8 +897,7 @@ function parsePartialJson(jsonText) {
 		state: "failed-parse"
 	};
 }
-//#endregion
-//#region src/utils/ai-sdk-v4/process-data-stream.ts
+// src/utils/ai-sdk-v4/process-data-stream.ts
 const NEWLINE = "\n".charCodeAt(0);
 function concatChunks(chunks, totalLength) {
 	const concatenatedChunks = new Uint8Array(totalLength);
@@ -984,8 +978,7 @@ async function processDataStream({ stream, onTextPart, onReasoningPart, onReason
 		}
 	}
 }
-//#endregion
-//#region src/utils/client-tool-model-output.ts
+// src/utils/client-tool-model-output.ts
 /**
 * Normalize modelOutput from toModelOutput() to the AI SDK V2 tool result
 * content shape. Mirrors `normalizeModelOutput` in @mastra/core's
@@ -1044,8 +1037,7 @@ async function getClientToolModelOutput(clientTool, result) {
 	const modelOutput = await toModelOutput(result);
 	return modelOutput == null ? void 0 : normalizeModelOutput(modelOutput);
 }
-//#endregion
-//#region src/utils/zod-to-json-schema.ts
+// src/utils/zod-to-json-schema.ts
 /**
 * Check if a value is a Zod schema type.
 * This is a simple check that doesn't require any Node.js dependencies.
@@ -1065,8 +1057,7 @@ function zodToJsonSchema(zodSchema) {
 	if (!isZodType(zodSchema)) return zodSchema;
 	return (0, _mastra_schema_compat_zod_to_json.zodToJsonSchema)(zodSchema);
 }
-//#endregion
-//#region src/utils/process-client-tools.ts
+// src/utils/process-client-tools.ts
 function processClientTools(clientTools) {
 	if (!clientTools) return;
 	return Object.fromEntries(Object.entries(clientTools).map(([key, value]) => {
@@ -1079,8 +1070,7 @@ function processClientTools(clientTools) {
 		}];
 	}));
 }
-//#endregion
-//#region src/utils/sse-event-splitter.ts
+// src/utils/sse-event-splitter.ts
 /** Split SSE events without rescanning or copying an unfinished event on each read. */
 function createSseEventSplitter() {
 	let parts = [];
@@ -1119,8 +1109,7 @@ function createSseEventSplitter() {
 		return events;
 	};
 }
-//#endregion
-//#region src/utils/process-mastra-stream.ts
+// src/utils/process-mastra-stream.ts
 async function sharedProcessMastraStream({ stream, onChunk, signal }) {
 	const reader = stream.getReader();
 	const decoder = new TextDecoder();
@@ -1165,8 +1154,7 @@ async function processMastraStream({ stream, onChunk, signal }) {
 		signal
 	});
 }
-//#endregion
-//#region src/types.ts
+// src/types.ts
 /**
 * HTTP error thrown by the Mastra client.
 * Extends Error with additional properties for better error handling.
@@ -1199,8 +1187,7 @@ var MastraClientError = class extends Error {
 		this.body = body;
 	}
 };
-//#endregion
-//#region src/resources/base.ts
+// src/resources/base.ts
 var BaseResource = class {
 	options;
 	apiPrefix;
@@ -1274,8 +1261,7 @@ var BaseResource = class {
 		throw lastError || /* @__PURE__ */ new Error("Request failed");
 	}
 };
-//#endregion
-//#region src/resources/agent.ts
+// src/resources/agent.ts
 const SIGNAL_RUNTIME_OPTIONS_TTL_MS = 3e5;
 const signalRuntimeOptionsByRunId = /* @__PURE__ */ new Map();
 /**
@@ -3662,8 +3648,7 @@ var Agent = class extends BaseResource {
 		});
 	}
 };
-//#endregion
-//#region src/resources/memory-thread.ts
+// src/resources/memory-thread.ts
 /**
 * Serializes the message-listing filters both memory message routes accept. The network route
 * takes the same filters under a different path, so the two callers share one serializer.
@@ -3832,8 +3817,7 @@ function normalizeWriteOpts(opts) {
 	if (Object.keys(opts).length === 0) return {};
 	return { requestContext: opts };
 }
-//#endregion
-//#region src/resources/vector.ts
+// src/resources/vector.ts
 var Vector = class extends BaseResource {
 	vectorName;
 	constructor(options, vectorName) {
@@ -3899,8 +3883,7 @@ var Vector = class extends BaseResource {
 		});
 	}
 };
-//#endregion
-//#region src/resources/tool.ts
+// src/resources/tool.ts
 var Tool = class extends BaseResource {
 	toolId;
 	constructor(options, toolId) {
@@ -3933,8 +3916,7 @@ var Tool = class extends BaseResource {
 		});
 	}
 };
-//#endregion
-//#region src/resources/processor.ts
+// src/resources/processor.ts
 var Processor = class extends BaseResource {
 	processorId;
 	constructor(options, processorId) {
@@ -3967,8 +3949,7 @@ var Processor = class extends BaseResource {
 		});
 	}
 };
-//#endregion
-//#region src/resources/conversations.ts
+// src/resources/conversations.ts
 var ConversationItems = class extends BaseResource {
 	constructor(options) {
 		super(options);
@@ -3997,8 +3978,7 @@ var Conversations = class extends BaseResource {
 		return this.request(`/v1/conversations/${encodeURIComponent(conversationId)}${requestContextQueryString(requestContext)}`, { method: "DELETE" });
 	}
 };
-//#endregion
-//#region src/utils/stream-transforms.ts
+// src/utils/stream-transforms.ts
 const RECORD_SEPARATOR$1 = "";
 const SSE_FRAME_SEPARATOR = /\r?\n\r?\n/;
 /**
@@ -4066,8 +4046,7 @@ function createSseJsonTransform() {
 		}
 	});
 }
-//#endregion
-//#region src/resources/run.ts
+// src/resources/run.ts
 /**
 * Deserializes the error property in a workflow result back to an Error instance.
 * Server sends SerializedError (plain object), client converts to Error for instanceof checks.
@@ -4436,8 +4415,7 @@ var Run = class extends BaseResource {
 		return response.body.pipeThrough(this.createChunkTransformStream());
 	}
 };
-//#endregion
-//#region src/resources/workflow.ts
+// src/resources/workflow.ts
 const RECORD_SEPARATOR = "";
 var Workflow = class extends BaseResource {
 	workflowId;
@@ -4554,8 +4532,7 @@ var Workflow = class extends BaseResource {
 		} });
 	}
 };
-//#endregion
-//#region src/utils/process-a2a-stream.ts
+// src/utils/process-a2a-stream.ts
 function splitNextEvent(buffer) {
 	const normalizedBuffer = buffer.replace(/\x1E/g, "\n\n");
 	const match = normalizedBuffer.match(/\r?\n\r?\n/);
@@ -4609,8 +4586,7 @@ async function* processA2AStream(stream) {
 		reader.releaseLock();
 	}
 }
-//#endregion
-//#region src/utils/verify-agent-card-signature.ts
+// src/utils/verify-agent-card-signature.ts
 const DEFAULT_AGENT_CARD_SIGNATURE_ALGORITHMS = [
 	"ES256",
 	"ES384",
@@ -4679,8 +4655,7 @@ async function verifyAgentCardSignatureIfPresent(agentCard, options) {
 	}
 	throw new MastraClientError(200, "OK", `A2A Agent Card signature verification failed: ${verificationErrors.join("; ")}`);
 }
-//#endregion
-//#region src/resources/a2a.ts
+// src/resources/a2a.ts
 function createA2AJsonRpcError(response) {
 	const error = response.error;
 	const message = error?.message ?? "Unknown A2A JSON-RPC error";
@@ -4992,8 +4967,7 @@ var A2AV1 = class extends BaseResource {
 		for await (const event of processA2AStream(await requireResponseBody(response, "tasks/resubscribe"))) yield _mastra_core_a2a_v1.StreamResponse.fromJSON(event);
 	}
 };
-//#endregion
-//#region src/resources/mcp-tool.ts
+// src/resources/mcp-tool.ts
 /**
 * Represents a specific tool available on a specific MCP server.
 * Provides methods to get details and execute the tool.
@@ -5030,8 +5004,7 @@ var MCPTool = class extends BaseResource {
 		});
 	}
 };
-//#endregion
-//#region src/resources/agent-builder.ts
+// src/resources/agent-builder.ts
 /**
 * Agent Builder resource: operations related to agent-builder workflows via server endpoints.
 */
@@ -5290,8 +5263,7 @@ var AgentBuilder = class extends BaseResource {
 		return this.request(url, { method: "POST" });
 	}
 };
-//#endregion
-//#region src/resources/observability.ts
+// src/resources/observability.ts
 /** Client resource for interacting with the Mastra observability API (traces, logs, scores, feedback, and metrics). */
 var Observability = class extends BaseResource {
 	constructor(options) {
@@ -5787,8 +5759,7 @@ var Observability = class extends BaseResource {
 		return this.request("/observability/capabilities");
 	}
 };
-//#endregion
-//#region src/resources/stored-agent.ts
+// src/resources/stored-agent.ts
 /**
 * Resource for interacting with a specific stored agent
 */
@@ -5956,8 +5927,7 @@ var StoredAgent = class extends BaseResource {
 		return this.request(`/stored/agents/${encodeURIComponent(this.storedAgentId)}/versions/compare?${queryParams.toString()}${contextString ? `&${contextString.slice(1)}` : ""}`);
 	}
 };
-//#endregion
-//#region src/resources/dynamic-workflow.ts
+// src/resources/dynamic-workflow.ts
 /** Resource for interacting with a specific dynamic workflow definition. */
 var DynamicWorkflow = class extends BaseResource {
 	dynamicWorkflowId;
@@ -5980,8 +5950,7 @@ var DynamicWorkflow = class extends BaseResource {
 		return this.request(`/stored/workflows/${encodeURIComponent(this.dynamicWorkflowId)}`, { method: "DELETE" });
 	}
 };
-//#endregion
-//#region src/resources/stored-prompt-block.ts
+// src/resources/stored-prompt-block.ts
 /**
 * Resource for interacting with a specific stored prompt block
 */
@@ -6104,8 +6073,7 @@ var StoredPromptBlock = class extends BaseResource {
 		return this.request(`/stored/prompt-blocks/${encodeURIComponent(this.storedPromptBlockId)}/versions/compare?${queryParams.toString()}${contextString}`);
 	}
 };
-//#endregion
-//#region src/resources/stored-mcp-client.ts
+// src/resources/stored-mcp-client.ts
 /**
 * Resource for interacting with a specific stored MCP client
 */
@@ -6144,8 +6112,7 @@ var StoredMCPClient = class extends BaseResource {
 		return this.request(`/stored/mcp-clients/${encodeURIComponent(this.storedMCPClientId)}${requestContextQueryString(requestContext)}`, { method: "DELETE" });
 	}
 };
-//#endregion
-//#region src/resources/stored-scorer.ts
+// src/resources/stored-scorer.ts
 /**
 * Resource for interacting with a specific stored scorer definition
 */
@@ -6269,8 +6236,7 @@ var StoredScorer = class extends BaseResource {
 		return this.request(`/stored/scorers/${encodeURIComponent(this.storedScorerId)}/versions/compare?${queryParams.toString()}${contextString ? `&${contextString.slice(1)}` : ""}`);
 	}
 };
-//#endregion
-//#region src/resources/tool-provider.ts
+// src/resources/tool-provider.ts
 /**
 * Resource for interacting with a specific tool provider.
 *
@@ -6405,8 +6371,7 @@ var ToolProvider = class extends BaseResource {
 		return this.request(`/tool-providers/${encodeURIComponent(this.providerId)}/health`);
 	}
 };
-//#endregion
-//#region src/resources/processor-provider.ts
+// src/resources/processor-provider.ts
 /**
 * Resource for interacting with a specific processor provider
 */
@@ -6424,8 +6389,7 @@ var ProcessorProvider = class extends BaseResource {
 		return this.request(`/processor-providers/${encodeURIComponent(this.providerId)}`);
 	}
 };
-//#endregion
-//#region src/resources/workspace.ts
+// src/resources/workspace.ts
 /**
 * Resource for interacting with a specific skill via the workspace API
 */
@@ -6695,8 +6659,7 @@ var Workspace = class extends BaseResource {
 		});
 	}
 };
-//#endregion
-//#region src/resources/stored-skill.ts
+// src/resources/stored-skill.ts
 /**
 * Resource for interacting with a specific stored skill
 */
@@ -6749,8 +6712,7 @@ var StoredSkill = class extends BaseResource {
 		return this.request(`/stored/skills/${encodeURIComponent(this.storedSkillId)}/favorite${requestContextQueryString(requestContext)}`, { method: "DELETE" });
 	}
 };
-//#endregion
-//#region src/resources/responses.ts
+// src/resources/responses.ts
 function getOutputText(output) {
 	return output.flatMap((item) => item.type === "message" ? item.content : []).map((part) => typeof part?.text === "string" ? part.text : "").filter(Boolean).join("");
 }
@@ -6855,8 +6817,7 @@ var Responses = class extends BaseResource {
 		return this.request(`/v1/responses/${encodeURIComponent(responseId)}${requestContextQueryString(requestContext)}`, { method: "DELETE" });
 	}
 };
-//#endregion
-//#region src/resources/channels.ts
+// src/resources/channels.ts
 var Channels = class extends BaseResource {
 	constructor(options) {
 		super(options);
@@ -6916,8 +6877,7 @@ var Channels = class extends BaseResource {
 		return this.request(`/channels/${platform}/${agentId}/disconnect`, { method: "POST" });
 	}
 };
-//#endregion
-//#region src/resources/agent-controller.ts
+// src/resources/agent-controller.ts
 const KNOWN_AGENT_CONTROLLER_EVENT_TYPES = new Set(Object.keys({
 	agent_start: true,
 	agent_end: true,
@@ -7617,8 +7577,7 @@ var AgentController = class extends BaseResource {
 function agentControllerMessageText(message) {
 	return message.content.parts.filter((p) => p.type === "text" && typeof p.text === "string").map((p) => p.text).join("");
 }
-//#endregion
-//#region src/client.ts
+// src/client.ts
 /**
 * Provides typed access to agents, workflows, and other APIs on a running Mastra server.
 * Point `baseUrl` at your server and configure authentication when required.
@@ -9388,8 +9347,7 @@ var MastraClient = class extends BaseResource {
 		return this.request(`/schedules/${encodeURIComponent(scheduleId)}/resume`, { method: "POST" });
 	}
 };
-//#endregion
-//#region src/tools.ts
+// src/tools.ts
 var ClientTool = class {
 	id;
 	description;
@@ -9407,7 +9365,6 @@ var ClientTool = class {
 function createTool(opts) {
 	return new ClientTool(opts);
 }
-//#endregion
 exports.ClientTool = ClientTool;
 exports.MastraClient = MastraClient;
 exports.MastraClientError = MastraClientError;